remotion 4.0.0-webhook.26 → 4.0.0

package/dist/cjs/ResolveCompositionConfig.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useResolvedVideoConfig = exports.needsResolution = exports.ResolveCompositionConfig = exports.resolveCompositionsRef = exports.ResolveCompositionContext = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const CompositionManagerContext_js_1 = require("./CompositionManagerContext.js");
+const input_props_js_1 = require("./config/input-props.js");
+const EditorProps_js_1 = require("./EditorProps.js");
+const get_environment_js_1 = require("./get-environment.js");
+const resolve_video_config_js_1 = require("./resolve-video-config.js");
+exports.ResolveCompositionContext = (0, react_1.createContext)(null);
+exports.resolveCompositionsRef = (0, react_1.createRef)();
+const ResolveCompositionConfig = ({ children }) => {
+    const [currentRenderModalComposition, setCurrentRenderModalComposition] = (0, react_1.useState)(null);
+    const { compositions, currentComposition, currentCompositionMetadata } = (0, react_1.useContext)(CompositionManagerContext_js_1.CompositionManager);
+    const selectedComposition = compositions.find((c) => c.id === currentComposition);
+    const renderModalComposition = compositions.find((c) => c.id === currentRenderModalComposition);
+    const { props: allEditorProps } = (0, react_1.useContext)(EditorProps_js_1.EditorPropsContext);
+    const [resolvedConfigs, setResolvedConfigs] = (0, react_1.useState)({});
+    const selectedEditorProps = (0, react_1.useMemo)(() => {
+        var _a;
+        return selectedComposition
+            ? (_a = allEditorProps[selectedComposition.id]) !== null && _a !== void 0 ? _a : {}
+            : {};
+    }, [allEditorProps, selectedComposition]);
+    const renderModalProps = (0, react_1.useMemo)(() => {
+        var _a;
+        return renderModalComposition
+            ? (_a = allEditorProps[renderModalComposition.id]) !== null && _a !== void 0 ? _a : {}
+            : {};
+    }, [allEditorProps, renderModalComposition]);
+    const doResolution = (0, react_1.useCallback)((composition, editorProps) => {
+        const controller = new AbortController();
+        if (currentCompositionMetadata) {
+            return controller;
+        }
+        const { signal } = controller;
+        const promOrNot = (0, resolve_video_config_js_1.resolveVideoConfig)({ composition, editorProps, signal });
+        if (typeof promOrNot === 'object' && 'then' in promOrNot) {
+            setResolvedConfigs((r) => ({
+                ...r,
+                [composition.id]: {
+                    type: 'loading',
+                },
+            }));
+            promOrNot
+                .then((c) => {
+                if (controller.signal.aborted) {
+                    return;
+                }
+                setResolvedConfigs((r) => ({
+                    ...r,
+                    [composition.id]: {
+                        type: 'success',
+                        result: c,
+                    },
+                }));
+            })
+                .catch((err) => {
+                if (controller.signal.aborted) {
+                    return;
+                }
+                setResolvedConfigs((r) => ({
+                    ...r,
+                    [composition.id]: {
+                        type: 'error',
+                        error: err,
+                    },
+                }));
+            });
+        }
+        else {
+            setResolvedConfigs((r) => ({
+                ...r,
+                [composition.id]: {
+                    type: 'success',
+                    result: promOrNot,
+                },
+            }));
+        }
+        return controller;
+    }, [currentCompositionMetadata]);
+    (0, react_1.useImperativeHandle)(exports.resolveCompositionsRef, () => {
+        return {
+            setCurrentRenderModalComposition: (id) => {
+                setCurrentRenderModalComposition(id);
+            },
+            reloadCurrentlySelectedComposition: () => {
+                var _a;
+                if (!currentComposition) {
+                    return;
+                }
+                const composition = compositions.find((c) => c.id === currentComposition);
+                if (!composition) {
+                    throw new Error(`Could not find composition with id ${currentComposition}`);
+                }
+                const editorProps = (_a = allEditorProps[currentComposition]) !== null && _a !== void 0 ? _a : {};
+                doResolution(composition, editorProps);
+            },
+        };
+    }, [allEditorProps, compositions, currentComposition, doResolution]);
+    const isTheSame = (selectedComposition === null || selectedComposition === void 0 ? void 0 : selectedComposition.id) === (renderModalComposition === null || renderModalComposition === void 0 ? void 0 : renderModalComposition.id);
+    (0, react_1.useEffect)(() => {
+        if (selectedComposition && (0, exports.needsResolution)(selectedComposition)) {
+            const controller = doResolution(selectedComposition, selectedEditorProps);
+            return () => {
+                controller.abort();
+            };
+        }
+    }, [doResolution, selectedComposition, selectedEditorProps]);
+    (0, react_1.useEffect)(() => {
+        if (renderModalComposition && !isTheSame) {
+            const controller = doResolution(renderModalComposition, renderModalProps);
+            return () => {
+                controller.abort();
+            };
+        }
+    }, [doResolution, isTheSame, renderModalComposition, renderModalProps]);
+    const resolvedConfigsIncludingStaticOnes = (0, react_1.useMemo)(() => {
+        const staticComps = compositions.filter((c) => {
+            return c.calculateMetadata === null;
+        });
+        return {
+            ...resolvedConfigs,
+            ...staticComps.reduce((acc, curr) => {
+                var _a;
+                return {
+                    ...acc,
+                    [curr.id]: {
+                        type: 'success',
+                        result: { ...curr, defaultProps: (_a = curr.defaultProps) !== null && _a !== void 0 ? _a : {} },
+                    },
+                };
+            }, {}),
+        };
+    }, [compositions, resolvedConfigs]);
+    return ((0, jsx_runtime_1.jsx)(exports.ResolveCompositionContext.Provider, { value: resolvedConfigsIncludingStaticOnes, children: children }));
+};
+exports.ResolveCompositionConfig = ResolveCompositionConfig;
+const needsResolution = (composition) => {
+    return Boolean(composition.calculateMetadata);
+};
+exports.needsResolution = needsResolution;
+const useResolvedVideoConfig = (preferredCompositionId) => {
+    const context = (0, react_1.useContext)(exports.ResolveCompositionContext);
+    const { props: allEditorProps } = (0, react_1.useContext)(EditorProps_js_1.EditorPropsContext);
+    const { compositions, currentComposition, currentCompositionMetadata } = (0, react_1.useContext)(CompositionManagerContext_js_1.CompositionManager);
+    const compositionId = preferredCompositionId !== null && preferredCompositionId !== void 0 ? preferredCompositionId : currentComposition;
+    const composition = compositions.find((c) => c.id === compositionId);
+    const selectedEditorProps = (0, react_1.useMemo)(() => {
+        var _a;
+        return composition ? (_a = allEditorProps[composition.id]) !== null && _a !== void 0 ? _a : {} : {};
+    }, [allEditorProps, composition]);
+    return (0, react_1.useMemo)(() => {
+        var _a, _b, _c, _d;
+        if (!composition) {
+            return null;
+        }
+        if (currentCompositionMetadata) {
+            return {
+                type: 'success',
+                result: {
+                    ...currentCompositionMetadata,
+                    id: composition.id,
+                    props: currentCompositionMetadata.props,
+                    defaultProps: (_a = composition.defaultProps) !== null && _a !== void 0 ? _a : {},
+                },
+            };
+        }
+        if (!(0, exports.needsResolution)(composition)) {
+            return {
+                type: 'success',
+                result: {
+                    width: composition.width,
+                    height: composition.height,
+                    fps: composition.fps,
+                    id: composition.id,
+                    durationInFrames: composition.durationInFrames,
+                    defaultProps: (_b = composition.defaultProps) !== null && _b !== void 0 ? _b : {},
+                    props: {
+                        ...((_c = composition.defaultProps) !== null && _c !== void 0 ? _c : {}),
+                        ...(selectedEditorProps !== null && selectedEditorProps !== void 0 ? selectedEditorProps : {}),
+                        ...(typeof window === 'undefined' ||
+                            (0, get_environment_js_1.getRemotionEnvironment)() === 'player-development' ||
+                            (0, get_environment_js_1.getRemotionEnvironment)() === 'player-production'
+                            ? {}
+                            : (_d = (0, input_props_js_1.getInputProps)()) !== null && _d !== void 0 ? _d : {}),
+                    },
+                },
+            };
+        }
+        if (!context[composition.id]) {
+            return null;
+        }
+        return context[composition.id];
+    }, [composition, context, currentCompositionMetadata, selectedEditorProps]);
+};
+exports.useResolvedVideoConfig = useResolvedVideoConfig;

package/dist/cjs/Sequence.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+import type { LoopDisplay } from './CompositionManager.js';
+export type LayoutAndStyle = {
+    layout: 'none';
+} | {
+    layout?: 'absolute-fill';
+    style?: React.CSSProperties;
+    className?: string;
+};
+export type SequenceProps = {
+    children: React.ReactNode;
+    from?: number;
+    durationInFrames?: number;
+    name?: string;
+    showInTimeline?: boolean;
+    loopDisplay?: LoopDisplay;
+} & LayoutAndStyle;
+/**
+ * @description A component that time-shifts its children and wraps them in an absolutely positioned <div>.
+ * @see [Documentation](https://www.remotion.dev/docs/sequence]
+ */
+export declare const Sequence: React.ForwardRefExoticComponent<SequenceProps & React.RefAttributes<HTMLDivElement>>;

package/dist/{Sequence.js → cjs/Sequence.js}

@@ -1,25 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sequence = exports.SequenceContext = void 0;
+exports.Sequence = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
-const AbsoluteFill_1 = require("./AbsoluteFill");
-const CompositionManager_1 = require("./CompositionManager");
-const get_environment_1 = require("./get-environment");
-const get_timeline_clip_name_1 = require("./get-timeline-clip-name");
-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 AbsoluteFill_js_1 = require("./AbsoluteFill.js");
+const get_environment_js_1 = require("./get-environment.js");
+const get_timeline_clip_name_js_1 = require("./get-timeline-clip-name.js");
+const nonce_js_1 = require("./nonce.js");
+const SequenceContext_js_1 = require("./SequenceContext.js");
+const SequenceManager_js_1 = require("./SequenceManager.js");
+const timeline_position_state_js_1 = require("./timeline-position-state.js");
+const use_video_config_js_1 = require("./use-video-config.js");
+const SequenceRefForwardingFunction = ({ from = 0, durationInFrames = Infinity, children, name, showInTimeline = true, loopDisplay, ...other }, ref) => {
     const { layout = 'absolute-fill' } = other;
     const [id] = (0, react_1.useState)(() => String(Math.random()));
-    const parentSequence = (0, react_1.useContext)(exports.SequenceContext);
-    const { rootId } = (0, react_1.useContext)(timeline_position_state_1.TimelineContext);
+    const parentSequence = (0, react_1.useContext)(SequenceContext_js_1.SequenceContext);
+    const { rootId } = (0, react_1.useContext)(timeline_position_state_js_1.TimelineContext);
     const cumulatedFrom = parentSequence
         ? parentSequence.cumulatedFrom + parentSequence.relativeFrom
         : 0;
-    const nonce = (0, nonce_1.useNonce)();
+    const nonce = (0, nonce_js_1.useNonce)();
+    const environment = (0, get_environment_js_1.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}`);
     }
@@ -33,23 +34,19 @@ const SequenceRefForwardingFunction = ({ from, durationInFrames = Infinity, chil
     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}.`);
+    if (!Number.isFinite(from)) {
+        throw new TypeError(`The "from" prop of a sequence must be finite, but got ${from}.`);
     }
-    const absoluteFrame = (0, timeline_position_state_1.useTimelinePosition)();
-    const videoConfig = (0, use_video_config_1.useVideoConfig)();
+    const absoluteFrame = (0, timeline_position_state_js_1.useTimelinePosition)();
+    const videoConfig = (0, use_video_config_js_1.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 } = (0, react_1.useContext)(CompositionManager_1.CompositionManager);
+    const { registerSequence, unregisterSequence } = (0, react_1.useContext)(SequenceManager_js_1.SequenceManager);
     const contextValue = (0, react_1.useMemo)(() => {
         var _a;
         return {
@@ -67,11 +64,11 @@ const SequenceRefForwardingFunction = ({ from, durationInFrames = Infinity, chil
         id,
     ]);
     const timelineClipName = (0, react_1.useMemo)(() => {
-        return name !== null && name !== void 0 ? name : (0, get_timeline_clip_name_1.getTimelineClipName)(children);
+        return name !== null && name !== void 0 ? name : (0, get_timeline_clip_name_js_1.getTimelineClipName)(children);
     }, [children, name]);
     (0, react_1.useEffect)(() => {
         var _a;
-        if ((0, get_environment_1.getRemotionEnvironment)() !== 'preview') {
+        if (environment !== 'preview') {
             return;
         }
         registerSequence({
@@ -84,7 +81,7 @@ const SequenceRefForwardingFunction = ({ from, durationInFrames = Infinity, chil
             rootId,
             showInTimeline,
             nonce,
-            showLoopTimesInTimeline,
+            loopDisplay,
         });
         return () => {
             unregisterSequence(id);
@@ -102,7 +99,8 @@ const SequenceRefForwardingFunction = ({ from, durationInFrames = Infinity, chil
         from,
         showInTimeline,
         nonce,
-        showLoopTimesInTimeline,
+        loopDisplay,
+        environment,
     ]);
     const endThreshold = cumulatedFrom + from + durationInFrames - 1;
     const content = absoluteFrame < cumulatedFrom + from
@@ -120,10 +118,10 @@ const SequenceRefForwardingFunction = ({ from, durationInFrames = Infinity, chil
     if (ref !== null && layout === 'none') {
         throw new TypeError('It is not supported to pass both a `ref` and `layout="none"` to <Sequence />.');
     }
-    return ((0, jsx_runtime_1.jsx)(exports.SequenceContext.Provider, { value: contextValue, children: content === null ? null : layout === 'absolute-fill' ? ((0, jsx_runtime_1.jsx)(AbsoluteFill_1.AbsoluteFill, { ref: ref, style: defaultStyle, children: content })) : (content) }));
+    return ((0, jsx_runtime_1.jsx)(SequenceContext_js_1.SequenceContext.Provider, { value: contextValue, children: content === null ? null : other.layout === 'none' ? (content) : ((0, jsx_runtime_1.jsx)(AbsoluteFill_js_1.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
+ * @description A component that time-shifts its children and wraps them in an absolutely positioned <div>.
+ * @see [Documentation](https://www.remotion.dev/docs/sequence]
  */
 exports.Sequence = (0, react_1.forwardRef)(SequenceRefForwardingFunction);

package/dist/cjs/SequenceContext.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+export declare const SequenceContext: import("react").Context<SequenceContextType | null>;
+export type SequenceContextType = {
+    cumulatedFrom: number;
+    relativeFrom: number;
+    parentFrom: number;
+    durationInFrames: number;
+    id: string;
+};

package/dist/cjs/SequenceContext.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SequenceContext = void 0;
+const react_1 = require("react");
+exports.SequenceContext = (0, react_1.createContext)(null);

package/dist/cjs/SequenceManager.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { TSequence } from './CompositionManager.js';
+export type SequenceManagerContext = {
+    registerSequence: (seq: TSequence) => void;
+    unregisterSequence: (id: string) => void;
+    sequences: TSequence[];
+};
+export declare const SequenceManager: React.Context<SequenceManagerContext>;
+export declare const SequenceManagerProvider: React.FC<{
+    children: React.ReactNode;
+}>;

package/dist/cjs/SequenceManager.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SequenceManagerProvider = exports.SequenceManager = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+exports.SequenceManager = react_1.default.createContext({
+    registerSequence: () => {
+        throw new Error('SequenceManagerContext not initialized');
+    },
+    unregisterSequence: () => {
+        throw new Error('SequenceManagerContext not initialized');
+    },
+    sequences: [],
+});
+const SequenceManagerProvider = ({ children }) => {
+    const [sequences, setSequences] = (0, react_1.useState)([]);
+    const registerSequence = (0, react_1.useCallback)((seq) => {
+        setSequences((seqs) => {
+            return [...seqs, seq];
+        });
+    }, []);
+    const unregisterSequence = (0, react_1.useCallback)((seq) => {
+        setSequences((seqs) => seqs.filter((s) => s.id !== seq));
+    }, []);
+    const context = (0, react_1.useMemo)(() => {
+        return {
+            registerSequence,
+            sequences,
+            unregisterSequence,
+        };
+    }, [registerSequence, sequences, unregisterSequence]);
+    return ((0, jsx_runtime_1.jsx)(exports.SequenceManager.Provider, { value: context, children: children }));
+};
+exports.SequenceManagerProvider = SequenceManagerProvider;

package/dist/cjs/Still.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { AnyZodObject } from 'zod';
+import type { StillProps } from './Composition.js';
+/**
+ * @description A `<Still />` is a `<Composition />` that is only 1 frame long.
+ * @see [Documentation](https://www.remotion.dev/docs/still)
+ */
+export declare const Still: <Schema extends AnyZodObject, Props extends Record<string, unknown>>(props: StillProps<Schema, Props>) => React.DetailedReactHTMLElement<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>;

package/dist/cjs/Still.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Still = void 0;
+const react_1 = __importDefault(require("react"));
+const Composition_js_1 = require("./Composition.js");
+/**
+ * @description A `<Still />` is a `<Composition />` that is only 1 frame long.
+ * @see [Documentation](https://www.remotion.dev/docs/still)
+ */
+const Still = (props) => {
+    const newProps = {
+        ...props,
+        durationInFrames: 1,
+        fps: 1,
+    };
+    // @ts-expect-error TypeScript does not understand it, but should still fail on type mismatch
+    return react_1.default.createElement((Composition_js_1.Composition), newProps);
+};
+exports.Still = Still;

package/dist/{audio → cjs/audio}/Audio.d.ts

@@ -1,6 +1,12 @@
 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"> & {
-    volume?: import("../volume-prop").VolumeProp | undefined;
+import type { RemotionMainAudioProps } from './props.js';
+/**
+ * @description With this component, you can add audio to your video. All audio formats which are supported by Chromium are supported by the component.
+ * @see [Documentation](https://www.remotion.dev/docs/audio)
+ */
+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;
-} & 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;
+    allowAmplificationDuringRender?: boolean | undefined;
+} & RemotionMainAudioProps, "key" | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "id" | "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" | "volume" | "allowAmplificationDuringRender" | "controlsList" | "crossOrigin" | "loop" | "mediaGroup" | "muted" | "playsInline" | "preload" | "src" | "playbackRate" | "acceptableTimeShiftInSeconds" | keyof RemotionMainAudioProps> & React.RefAttributes<HTMLAudioElement>>;

package/dist/cjs/audio/Audio.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Audio = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const absolute_src_js_1 = require("../absolute-src.js");
+const cancel_render_js_1 = require("../cancel-render.js");
+const get_environment_js_1 = require("../get-environment.js");
+const index_js_1 = require("../loop/index.js");
+const Sequence_js_1 = require("../Sequence.js");
+const use_video_config_js_1 = require("../use-video-config.js");
+const validate_media_props_js_1 = require("../validate-media-props.js");
+const validate_start_from_props_js_1 = require("../validate-start-from-props.js");
+const duration_state_js_1 = require("../video/duration-state.js");
+const AudioForDevelopment_js_1 = require("./AudioForDevelopment.js");
+const AudioForRendering_js_1 = require("./AudioForRendering.js");
+const shared_audio_tags_js_1 = require("./shared-audio-tags.js");
+const AudioRefForwardingFunction = (props, ref) => {
+    var _a;
+    const audioContext = (0, react_1.useContext)(shared_audio_tags_js_1.SharedAudioContext);
+    const { startFrom, endAt, ...otherProps } = props;
+    const { loop, ...propsOtherThanLoop } = props;
+    const { fps } = (0, use_video_config_js_1.useVideoConfig)();
+    const environment = (0, get_environment_js_1.useRemotionEnvironment)();
+    const { durations, setDurations } = (0, react_1.useContext)(duration_state_js_1.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 = (0, react_1.useCallback)((e) => {
+        console.log(e.currentTarget.error);
+        (0, cancel_render_js_1.cancelRender)(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[(0, absolute_src_js_1.getAbsoluteSrc)(props.src)] !== undefined) {
+        const duration = Math.floor(durations[(0, absolute_src_js_1.getAbsoluteSrc)(props.src)] * fps);
+        const playbackRate = (_a = props.playbackRate) !== null && _a !== void 0 ? _a : 1;
+        const actualDuration = duration / playbackRate;
+        return ((0, jsx_runtime_1.jsx)(index_js_1.Loop, { layout: "none", durationInFrames: Math.floor(actualDuration), children: (0, jsx_runtime_1.jsx)(exports.Audio, { ...propsOtherThanLoop, ref: ref }) }));
+    }
+    if (typeof startFrom !== 'undefined' || typeof endAt !== 'undefined') {
+        (0, validate_start_from_props_js_1.validateStartFromProps)(startFrom, endAt);
+        const startFromFrameNo = startFrom !== null && startFrom !== void 0 ? startFrom : 0;
+        const endAtFrameNo = endAt !== null && endAt !== void 0 ? endAt : Infinity;
+        return ((0, jsx_runtime_1.jsx)(Sequence_js_1.Sequence, { layout: "none", from: 0 - startFromFrameNo, showInTimeline: false, durationInFrames: endAtFrameNo, children: (0, jsx_runtime_1.jsx)(exports.Audio, { ...otherProps, ref: ref }) }));
+    }
+    (0, validate_media_props_js_1.validateMediaProps)(props, 'Audio');
+    if (environment === 'rendering') {
+        return ((0, jsx_runtime_1.jsx)(AudioForRendering_js_1.AudioForRendering, { onDuration: onDuration, ...props, ref: ref, onError: onError }));
+    }
+    return ((0, jsx_runtime_1.jsx)(AudioForDevelopment_js_1.AudioForDevelopment, { shouldPreMountAudioTags: audioContext !== null && audioContext.numberOfAudioTags > 0, ...props, ref: ref, onError: onError, onDuration: onDuration }));
+};
+/**
+ * @description With this component, you can add audio to your video. All audio formats which are supported by Chromium are supported by the component.
+ * @see [Documentation](https://www.remotion.dev/docs/audio)
+ */
+exports.Audio = (0, react_1.forwardRef)(AudioRefForwardingFunction);

package/dist/cjs/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>>;