remotion 3.3.45 → 3.3.52

package/dist/esm/Img.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback, useImperativeHandle, useLayoutEffect, useRef, } from 'react';
+import { continueRender, delayRender } from './delay-render.js';
+import { useRemotionEnvironment } from './get-environment.js';
+import { usePreload } from './prefetch.js';
+const ImgRefForwarding = ({ onError, src, ...props }, ref) => {
+    const imageRef = useRef(null);
+    const environment = useRemotionEnvironment();
+    useImperativeHandle(ref, () => {
+        return imageRef.current;
+    }, []);
+    const actualSrc = usePreload(src);
+    const didGetError = useCallback((e) => {
+        var _a;
+        if (onError) {
+            onError(e);
+        }
+        else {
+            console.error('Error loading image with src:', (_a = imageRef.current) === null || _a === void 0 ? void 0 : _a.src, e, 'Handle the event using the onError() prop to make this message disappear.');
+        }
+    }, [onError]);
+    // If image source switches, make new handle
+    if (environment === 'rendering') {
+        // eslint-disable-next-line react-hooks/rules-of-hooks
+        useLayoutEffect(() => {
+            if (process.env.NODE_ENV === 'test') {
+                return;
+            }
+            const newHandle = delayRender('Loading <Img> with src=' + src);
+            const { current } = imageRef;
+            const didLoad = () => {
+                continueRender(newHandle);
+            };
+            if (current === null || current === void 0 ? void 0 : current.complete) {
+                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);
+                continueRender(newHandle);
+            };
+        }, [src]);
+    }
+    return (_jsx("img", { ...props, ref: imageRef, src: actualSrc, onError: didGetError }));
+};
+export const Img = forwardRef(ImgRefForwarding);

package/dist/esm/NativeLayers.d.ts

@@ -0,0 +1,13 @@
+import type { PropsWithChildren } from 'react';
+export declare type ClipRegion = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | 'hide';
+export declare type TNativeLayersContext = {
+    clipRegion: ClipRegion | null;
+    setClipRegion: React.Dispatch<React.SetStateAction<ClipRegion | null>>;
+};
+export declare const NativeLayersContext: import("react").Context<TNativeLayersContext>;
+export declare const NativeLayersProvider: React.FC<PropsWithChildren>;

package/dist/esm/NativeLayers.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useLayoutEffect, useMemo, useState } from 'react';
+export const NativeLayersContext = createContext({
+    setClipRegion: () => {
+        throw new Error('NativeLayers not set');
+    },
+    clipRegion: null,
+});
+export const NativeLayersProvider = ({ children, }) => {
+    const [clipRegion, setClipRegion] = useState(null);
+    const context = useMemo(() => {
+        return {
+            setClipRegion,
+            clipRegion,
+        };
+    }, [clipRegion, setClipRegion]);
+    useLayoutEffect(() => {
+        if (typeof window !== 'undefined') {
+            window.remotion_getClipRegion = () => {
+                return clipRegion;
+            };
+        }
+    }, [clipRegion, setClipRegion]);
+    return (_jsx(NativeLayersContext.Provider, { value: context, children: children }));
+};

package/dist/esm/Null.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="react" />
+export declare const Null: React.FC;

package/dist/esm/Null.js

@@ -0,0 +1,21 @@
+import { useContext, useEffect } from 'react';
+import { NativeLayersContext } from './NativeLayers.js';
+export const Null = () => {
+    const { setClipRegion } = useContext(NativeLayersContext);
+    useEffect(() => {
+        setClipRegion((c) => {
+            if (c === null) {
+                return 'hide';
+            }
+            // Rendering multiple <Null> is fine, because they are all hidden
+            if (c === 'hide') {
+                return 'hide';
+            }
+            throw new Error('Cannot render <Null>, because another component clipping the region was already rendered (most likely <Clipper>)');
+        });
+        return () => {
+            setClipRegion(null);
+        };
+    }, [setClipRegion]);
+    return null;
+};

package/dist/esm/RemotionRoot.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare const RemotionRoot: React.FC<{
+    children: React.ReactNode;
+    numberOfAudioTags: number;
+}>;

package/dist/esm/RemotionRoot.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
+import { SharedAudioContextProvider } from './audio/shared-audio-tags.js';
+import { CompositionManagerProvider } from './CompositionManager.js';
+import { continueRender, delayRender } from './delay-render.js';
+import { NativeLayersProvider } from './NativeLayers.js';
+import { NonceContext } from './nonce.js';
+import { PrefetchProvider } from './prefetch-state.js';
+import { random } from './random.js';
+import { SetTimelineContext, TimelineContext } from './timeline-position-state.js';
+import { DurationsContextProvider } from './video/duration-state.js';
+export const RemotionRoot = ({ children, numberOfAudioTags }) => {
+    var _a;
+    const [remotionRootId] = useState(() => String(random(null)));
+    const [frame, setFrame] = useState((_a = window.remotion_initialFrame) !== null && _a !== void 0 ? _a : 0);
+    const [playing, setPlaying] = useState(false);
+    const imperativePlaying = useRef(false);
+    const [fastRefreshes, setFastRefreshes] = useState(0);
+    const [playbackRate, setPlaybackRate] = useState(1);
+    const audioAndVideoTags = useRef([]);
+    useLayoutEffect(() => {
+        if (typeof window !== 'undefined') {
+            window.remotion_setFrame = (f) => {
+                const id = delayRender(`Setting the current frame to ${f}`);
+                setFrame(f);
+                requestAnimationFrame(() => continueRender(id));
+            };
+            window.remotion_isPlayer = false;
+        }
+    }, []);
+    const timelineContextValue = useMemo(() => {
+        return {
+            frame,
+            playing,
+            imperativePlaying,
+            rootId: remotionRootId,
+            playbackRate,
+            setPlaybackRate,
+            audioAndVideoTags,
+        };
+    }, [frame, playbackRate, playing, remotionRootId]);
+    const setTimelineContextValue = useMemo(() => {
+        return {
+            setFrame,
+            setPlaying,
+        };
+    }, []);
+    const nonceContext = useMemo(() => {
+        let counter = 0;
+        return {
+            getNonce: () => counter++,
+            fastRefreshes,
+        };
+    }, [fastRefreshes]);
+    useEffect(() => {
+        if (module.hot) {
+            module.hot.addStatusHandler((status) => {
+                if (status === 'idle') {
+                    setFastRefreshes((i) => i + 1);
+                }
+            });
+        }
+    }, []);
+    return (_jsx(NonceContext.Provider, { value: nonceContext, children: _jsx(TimelineContext.Provider, { value: timelineContextValue, children: _jsx(SetTimelineContext.Provider, { value: setTimelineContextValue, children: _jsx(PrefetchProvider, { children: _jsx(NativeLayersProvider, { children: _jsx(CompositionManagerProvider, { children: _jsx(DurationsContextProvider, { children: _jsx(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: numberOfAudioTags, children: children }) }) }) }) }) }) }) }));
+};

package/dist/esm/Sequence.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export declare type SequenceContextType = {
+    cumulatedFrom: number;
+    relativeFrom: number;
+    parentFrom: number;
+    durationInFrames: number;
+    id: string;
+};
+export declare const SequenceContext: React.Context<SequenceContextType | null>;
+export declare type LayoutAndStyle = {
+    layout: 'none';
+} | {
+    layout?: 'absolute-fill';
+    style?: React.CSSProperties;
+    className?: string;
+};
+export declare type SequenceProps = {
+    children: React.ReactNode;
+    from?: number;
+    durationInFrames?: number;
+    name?: string;
+    showInTimeline?: boolean;
+    showLoopTimesInTimeline?: number;
+} & LayoutAndStyle;
+/**
+ * A component that time-shifts its children and wraps them in an absolutely positioned <div>.
+ * @link https://www.remotion.dev/docs/sequence
+ */
+export declare const Sequence: React.ForwardRefExoticComponent<SequenceProps & React.RefAttributes<HTMLDivElement>>;

package/dist/esm/Sequence.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, forwardRef, useContext, useEffect, useMemo, useState, } from 'react';
+import { AbsoluteFill } from './AbsoluteFill.js';
+import { CompositionManager } from './CompositionManager.js';
+import { useRemotionEnvironment } from './get-environment.js';
+import { getTimelineClipName } from './get-timeline-clip-name.js';
+import { useNonce } from './nonce.js';
+import { TimelineContext, useTimelinePosition } from './timeline-position-state.js';
+import { useVideoConfig } from './use-video-config.js';
+export const SequenceContext = createContext(null);
+const SequenceRefForwardingFunction = ({ from = 0, durationInFrames = Infinity, children, name, showInTimeline = true, showLoopTimesInTimeline, ...other }, ref) => {
+    const { layout = 'absolute-fill' } = other;
+    const [id] = useState(() => String(Math.random()));
+    const parentSequence = useContext(SequenceContext);
+    const { rootId } = useContext(TimelineContext);
+    const cumulatedFrom = parentSequence
+        ? parentSequence.cumulatedFrom + parentSequence.relativeFrom
+        : 0;
+    const nonce = useNonce();
+    const environment = useRemotionEnvironment();
+    if (layout !== 'absolute-fill' && layout !== 'none') {
+        throw new TypeError(`The layout prop of <Sequence /> expects either "absolute-fill" or "none", but you passed: ${layout}`);
+    }
+    // @ts-expect-error
+    if (layout === 'none' && typeof other.style !== 'undefined') {
+        throw new TypeError('If layout="none", you may not pass a style.');
+    }
+    if (typeof durationInFrames !== 'number') {
+        throw new TypeError(`You passed to durationInFrames an argument of type ${typeof durationInFrames}, but it must be a number.`);
+    }
+    if (durationInFrames <= 0) {
+        throw new TypeError(`durationInFrames must be positive, but got ${durationInFrames}`);
+    }
+    // Infinity is non-integer but allowed!
+    if (durationInFrames % 1 !== 0 && Number.isFinite(durationInFrames)) {
+        throw new TypeError(`The "durationInFrames" of a sequence must be an integer, but got ${durationInFrames}.`);
+    }
+    if (typeof from !== 'number') {
+        throw new TypeError(`You passed to the "from" props of your <Sequence> an argument of type ${typeof from}, but it must be a number.`);
+    }
+    if (from % 1 !== 0) {
+        throw new TypeError(`The "from" prop of a sequence must be an integer, but got ${from}.`);
+    }
+    const absoluteFrame = useTimelinePosition();
+    const videoConfig = useVideoConfig();
+    const parentSequenceDuration = parentSequence
+        ? Math.min(parentSequence.durationInFrames - from, durationInFrames)
+        : durationInFrames;
+    const actualDurationInFrames = Math.max(0, Math.min(videoConfig.durationInFrames - from, parentSequenceDuration));
+    const { registerSequence, unregisterSequence } = useContext(CompositionManager);
+    const contextValue = useMemo(() => {
+        var _a;
+        return {
+            cumulatedFrom,
+            relativeFrom: from,
+            durationInFrames: actualDurationInFrames,
+            parentFrom: (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.relativeFrom) !== null && _a !== void 0 ? _a : 0,
+            id,
+        };
+    }, [
+        cumulatedFrom,
+        from,
+        actualDurationInFrames,
+        parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.relativeFrom,
+        id,
+    ]);
+    const timelineClipName = useMemo(() => {
+        return name !== null && name !== void 0 ? name : getTimelineClipName(children);
+    }, [children, name]);
+    useEffect(() => {
+        var _a;
+        if (environment !== 'preview') {
+            return;
+        }
+        registerSequence({
+            from,
+            duration: actualDurationInFrames,
+            id,
+            displayName: timelineClipName,
+            parent: (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.id) !== null && _a !== void 0 ? _a : null,
+            type: 'sequence',
+            rootId,
+            showInTimeline,
+            nonce,
+            showLoopTimesInTimeline,
+        });
+        return () => {
+            unregisterSequence(id);
+        };
+    }, [
+        durationInFrames,
+        id,
+        name,
+        registerSequence,
+        timelineClipName,
+        unregisterSequence,
+        parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.id,
+        actualDurationInFrames,
+        rootId,
+        from,
+        showInTimeline,
+        nonce,
+        showLoopTimesInTimeline,
+        environment,
+    ]);
+    const endThreshold = cumulatedFrom + from + durationInFrames - 1;
+    const content = absoluteFrame < cumulatedFrom + from
+        ? null
+        : absoluteFrame > endThreshold
+            ? null
+            : children;
+    const styleIfThere = other.layout === 'none' ? undefined : other.style;
+    const defaultStyle = useMemo(() => {
+        return {
+            flexDirection: undefined,
+            ...(styleIfThere !== null && styleIfThere !== void 0 ? styleIfThere : {}),
+        };
+    }, [styleIfThere]);
+    if (ref !== null && layout === 'none') {
+        throw new TypeError('It is not supported to pass both a `ref` and `layout="none"` to <Sequence />.');
+    }
+    return (_jsx(SequenceContext.Provider, { value: contextValue, children: content === null ? null : other.layout === 'none' ? (content) : (_jsx(AbsoluteFill, { ref: ref, style: defaultStyle, className: other.className, children: content })) }));
+};
+/**
+ * A component that time-shifts its children and wraps them in an absolutely positioned <div>.
+ * @link https://www.remotion.dev/docs/sequence
+ */
+export const Sequence = forwardRef(SequenceRefForwardingFunction);

package/dist/esm/Still.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import type { StillProps } from './Composition.js';
+export declare const Still: <T>(props: StillProps<T>) => JSX.Element;

package/dist/esm/Still.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Composition } from './Composition.js';
+export const Still = (props) => {
+    return _jsx(Composition, { fps: 1, durationInFrames: 1, ...props });
+};

package/dist/esm/absolute-src.d.ts

@@ -0,0 +1 @@
+export declare const getAbsoluteSrc: (relativeSrc: string) => string;

package/dist/esm/absolute-src.js

@@ -0,0 +1,3 @@
+export const getAbsoluteSrc = (relativeSrc) => {
+    return new URL(relativeSrc, window.location.origin).href;
+};

package/dist/esm/asset-types.d.ts

@@ -0,0 +1,50 @@
+declare module '*.webm' {
+    const src: string;
+    export default src;
+}
+declare module '*.png' {
+    const src: string;
+    export default src;
+}
+declare module '*.mp4' {
+    const src: string;
+    export default src;
+}
+declare module '*.mp3' {
+    const src: string;
+    export default src;
+}
+declare module '*.wav' {
+    const src: string;
+    export default src;
+}
+declare module '*.aac' {
+    const src: string;
+    export default src;
+}
+declare module '*.svg';
+declare module '*.jpg' {
+    const src: string;
+    export default src;
+}
+declare module '*.jpeg' {
+    const src: string;
+    export default src;
+}
+declare module '*.bmp' {
+    const src: string;
+    export default src;
+}
+declare module '*.gif' {
+    const src: string;
+    export default src;
+}
+declare module '*.woff' {
+    const src: string;
+    export default src;
+}
+declare module '*.woff2' {
+    const src: string;
+    export default src;
+}
+declare module '*.css';

package/dist/esm/asset-types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/esm/audio/Audio.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { RemotionMainAudioProps } from './props.js';
+export declare const Audio: React.ForwardRefExoticComponent<Pick<Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, "nonce" | "onEnded" | "onResize" | "onResizeCapture" | "autoPlay" | "controls"> & {
+    volume?: import("../volume-prop.js").VolumeProp | undefined;
+    playbackRate?: number | undefined;
+    acceptableTimeShiftInSeconds?: number | undefined;
+    allowAmplificationDuringRender?: boolean | 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" | "allowAmplificationDuringRender" | "controlsList" | "crossOrigin" | "loop" | "mediaGroup" | "muted" | "playsInline" | "preload" | "acceptableTimeShiftInSeconds" | keyof RemotionMainAudioProps> & React.RefAttributes<HTMLAudioElement>>;

package/dist/esm/audio/Audio.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback, useContext } from 'react';
+import { useRemotionEnvironment } from '../get-environment.js';
+import { Loop } from '../loop';
+import { Sequence } from '../Sequence.js';
+import { useVideoConfig } from '../use-video-config.js';
+import { validateMediaProps } from '../validate-media-props.js';
+import { validateStartFromProps } from '../validate-start-from-props.js';
+import { DurationsContext } from '../video/duration-state.js';
+import { AudioForDevelopment } from './AudioForDevelopment.js';
+import { AudioForRendering } from './AudioForRendering.js';
+import { SharedAudioContext } from './shared-audio-tags.js';
+const AudioRefForwardingFunction = (props, ref) => {
+    var _a;
+    const audioContext = useContext(SharedAudioContext);
+    const { startFrom, endAt, ...otherProps } = props;
+    const { loop, ...propsOtherThanLoop } = props;
+    const { fps } = useVideoConfig();
+    const environment = useRemotionEnvironment();
+    const { durations, setDurations } = useContext(DurationsContext);
+    if (typeof props.src !== 'string') {
+        throw new TypeError(`The \`<Audio>\` tag requires a string for \`src\`, but got ${JSON.stringify(props.src)} instead.`);
+    }
+    const onError = 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 = 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);
+        const playbackRate = (_a = props.playbackRate) !== null && _a !== void 0 ? _a : 1;
+        const actualDuration = duration / playbackRate;
+        return (_jsx(Loop, { layout: "none", durationInFrames: Math.floor(actualDuration), children: _jsx(Audio, { ...propsOtherThanLoop, ref: ref }) }));
+    }
+    if (typeof startFrom !== 'undefined' || typeof endAt !== 'undefined') {
+        validateStartFromProps(startFrom, endAt);
+        const startFromFrameNo = startFrom !== null && startFrom !== void 0 ? startFrom : 0;
+        const endAtFrameNo = endAt !== null && endAt !== void 0 ? endAt : Infinity;
+        return (_jsx(Sequence, { layout: "none", from: 0 - startFromFrameNo, showInTimeline: false, durationInFrames: endAtFrameNo, children: _jsx(Audio, { ...otherProps, ref: ref }) }));
+    }
+    validateMediaProps(props, 'Audio');
+    if (environment === 'rendering') {
+        return (_jsx(AudioForRendering, { onDuration: onDuration, ...props, ref: ref, onError: onError }));
+    }
+    return (_jsx(AudioForDevelopment, { shouldPreMountAudioTags: audioContext !== null && audioContext.numberOfAudioTags > 0, ...props, ref: ref, onError: onError, onDuration: onDuration }));
+};
+export const Audio = forwardRef(AudioRefForwardingFunction);

package/dist/esm/audio/AudioForDevelopment.d.ts

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

package/dist/esm/audio/AudioForDevelopment.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useContext, useEffect, useImperativeHandle, useMemo, useRef, useState, } from 'react';
+import { usePreload } from '../prefetch.js';
+import { random } from '../random.js';
+import { SequenceContext } from '../Sequence.js';
+import { useMediaInTimeline } from '../use-media-in-timeline.js';
+import { DEFAULT_ACCEPTABLE_TIMESHIFT, useMediaPlayback, } from '../use-media-playback.js';
+import { useMediaTagVolume } from '../use-media-tag-volume.js';
+import { useSyncVolumeWithMediaTag } from '../use-sync-volume-with-media-tag.js';
+import { useMediaMutedState, useMediaVolumeState, } from '../volume-position-state.js';
+import { useSharedAudio } from './shared-audio-tags.js';
+import { useFrameForVolumeProp } from './use-audio-frame.js';
+const AudioForDevelopmentForwardRefFunction = (props, ref) => {
+    const [initialShouldPreMountAudioElements] = useState(props.shouldPreMountAudioTags);
+    if (props.shouldPreMountAudioTags !== initialShouldPreMountAudioElements) {
+        throw new Error('Cannot change the behavior for pre-mounting audio tags dynamically.');
+    }
+    const [mediaVolume] = useMediaVolumeState();
+    const [mediaMuted] = useMediaMutedState();
+    const volumePropFrame = useFrameForVolumeProp();
+    const { volume, muted, playbackRate, shouldPreMountAudioTags, src, onDuration, acceptableTimeShiftInSeconds, ...nativeProps } = props;
+    if (!src) {
+        throw new TypeError("No 'src' was passed to <Audio>.");
+    }
+    const preloadedSrc = usePreload(src);
+    const propsToPass = useMemo(() => {
+        return {
+            muted: muted || mediaMuted,
+            src: preloadedSrc,
+            ...nativeProps,
+        };
+    }, [mediaMuted, muted, nativeProps, preloadedSrc]);
+    const sequenceContext = useContext(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 = useMemo(() => `audio-${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 = useSharedAudio(propsToPass, id).el;
+    const actualVolume = useMediaTagVolume(audioRef);
+    useSyncVolumeWithMediaTag({
+        volumePropFrame,
+        actualVolume,
+        volume,
+        mediaVolume,
+        mediaRef: audioRef,
+    });
+    useMediaInTimeline({
+        volume,
+        mediaVolume,
+        mediaRef: audioRef,
+        src,
+        mediaType: 'audio',
+        playbackRate: playbackRate !== null && playbackRate !== void 0 ? playbackRate : 1,
+    });
+    useMediaPlayback({
+        mediaRef: audioRef,
+        src,
+        mediaType: 'audio',
+        playbackRate: playbackRate !== null && playbackRate !== void 0 ? playbackRate : 1,
+        onlyWarnForMediaSeekingError: false,
+        acceptableTimeshift: acceptableTimeShiftInSeconds !== null && acceptableTimeShiftInSeconds !== void 0 ? acceptableTimeShiftInSeconds : DEFAULT_ACCEPTABLE_TIMESHIFT,
+    });
+    useImperativeHandle(ref, () => {
+        return audioRef.current;
+    }, [audioRef]);
+    const currentOnDurationCallback = useRef();
+    currentOnDurationCallback.current = onDuration;
+    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;
+    }
+    return _jsx("audio", { ref: audioRef, ...propsToPass });
+};
+export const AudioForDevelopment = forwardRef(AudioForDevelopmentForwardRefFunction);

package/dist/esm/audio/AudioForRendering.d.ts

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