remotion 3.3.51 → 3.3.52

package/dist/audio/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Audio';
+export * from './props';

package/dist/audio/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Audio"), exports);
+__exportStar(require("./props"), exports);

package/dist/audio/props.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import type { VolumeProp } from '../volume-prop';
+export declare type RemotionMainAudioProps = {
+    startFrom?: number;
+    endAt?: number;
+};
+export declare type RemotionAudioProps = Omit<React.DetailedHTMLProps<React.AudioHTMLAttributes<HTMLAudioElement>, HTMLAudioElement>, 'autoPlay' | 'controls' | 'onEnded' | 'nonce' | 'onResize' | 'onResizeCapture'> & {
+    volume?: VolumeProp;
+    playbackRate?: number;
+    acceptableTimeShiftInSeconds?: number;
+    allowAmplificationDuringRender?: boolean;
+};

package/dist/audio/props.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/audio/shared-audio-tags.d.ts

@@ -0,0 +1,37 @@
+import React from 'react';
+import type { RemotionAudioProps } from './props';
+/**
+ * This functionality of Remotion will keep a certain amount
+ * of <audio> tags pre-mounted and by default filled with an empty audio track.
+ * If the user interacts, the empty audio will be played.
+ * If one of Remotions <Audio /> tags get mounted, the audio will not be rendered at this location, but into one of the prerendered audio tags.
+ *
+ * This helps with autoplay issues on iOS Safari and soon other browsers,
+ * which only allow audio playback upon user interaction.
+ *
+ * The behavior can be disabled by passing `0` as the number of shared audio tracks.
+ */
+declare type AudioElem = {
+    id: number;
+    props: RemotionAudioProps;
+    el: React.RefObject<HTMLAudioElement>;
+    audioId: string;
+};
+declare type SharedContext = {
+    registerAudio: (aud: RemotionAudioProps, audioId: string) => AudioElem;
+    unregisterAudio: (id: number) => void;
+    updateAudio: (options: {
+        id: number;
+        aud: RemotionAudioProps;
+        audioId: string;
+    }) => void;
+    playAllAudios: () => void;
+    numberOfAudioTags: number;
+};
+export declare const SharedAudioContext: React.Context<SharedContext | null>;
+export declare const SharedAudioContextProvider: React.FC<{
+    numberOfAudioTags: number;
+    children: React.ReactNode;
+}>;
+export declare const useSharedAudio: (aud: RemotionAudioProps, audioId: string) => AudioElem;
+export {};

package/dist/audio/shared-audio-tags.js

@@ -0,0 +1,222 @@
+"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.useSharedAudio = exports.SharedAudioContextProvider = exports.SharedAudioContext = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const EMPTY_AUDIO = 'data:audio/mp3;base64,/+MYxAAJcAV8AAgAABn//////+/gQ5BAMA+D4Pg+BAQBAEAwD4Pg+D4EBAEAQDAPg++hYBH///hUFQVBUFREDQNHmf///////+MYxBUGkAGIMAAAAP/29Xt6lUxBTUUzLjEwMFVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV/+MYxDUAAANIAAAAAFVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV';
+const compareProps = (obj1, obj2) => {
+    const keysA = Object.keys(obj1).sort();
+    const keysB = Object.keys(obj2).sort();
+    if (keysA.length !== keysB.length) {
+        return false;
+    }
+    for (let i = 0; i < keysA.length; i++) {
+        // Not the same keys
+        if (keysA[i] !== keysB[i]) {
+            return false;
+        }
+        // Not the same values
+        if (obj1[keysA[i]] !== obj2[keysB[i]]) {
+            return false;
+        }
+    }
+    return true;
+};
+const didPropChange = (key, newProp, prevProp) => {
+    // /music.mp3 and http://localhost:3000/music.mp3 are the same
+    if (key === 'src' &&
+        !prevProp.startsWith('data:') &&
+        !newProp.startsWith('data:')) {
+        return (new URL(prevProp, window.location.origin).toString() !==
+            new URL(newProp, window.location.origin).toString());
+    }
+    if (prevProp === newProp) {
+        return false;
+    }
+    return true;
+};
+exports.SharedAudioContext = (0, react_1.createContext)(null);
+const SharedAudioContextProvider = ({ children, numberOfAudioTags }) => {
+    const audios = (0, react_1.useRef)([]);
+    const [initialNumberOfAudioTags] = (0, react_1.useState)(numberOfAudioTags);
+    if (numberOfAudioTags !== initialNumberOfAudioTags) {
+        throw new Error('The number of shared audio tags has changed dynamically. Once you have set this property, you cannot change it afterwards.');
+    }
+    const refs = (0, react_1.useMemo)(() => {
+        return new Array(numberOfAudioTags).fill(true).map(() => {
+            return { id: Math.random(), ref: (0, react_1.createRef)() };
+        });
+    }, [numberOfAudioTags]);
+    const takenAudios = (0, react_1.useRef)(new Array(numberOfAudioTags).fill(false));
+    const rerenderAudios = (0, react_1.useCallback)(() => {
+        refs.forEach(({ ref, id }) => {
+            var _a;
+            const data = (_a = audios.current) === null || _a === void 0 ? void 0 : _a.find((a) => a.id === id);
+            const { current } = ref;
+            if (!current) {
+                // Whole player has been unmounted, the refs don't exist anymore.
+                // It is not an error anymore though
+                return;
+            }
+            if (data === undefined) {
+                current.src = EMPTY_AUDIO;
+                return;
+            }
+            if (!data) {
+                throw new TypeError('Expected audio data to be there');
+            }
+            Object.keys(data.props).forEach((key) => {
+                // @ts-expect-error
+                if (didPropChange(key, data.props[key], current[key])) {
+                    // @ts-expect-error
+                    current[key] = data.props[key];
+                }
+            });
+        });
+    }, [refs]);
+    const registerAudio = (0, react_1.useCallback)((aud, audioId) => {
+        var _a, _b;
+        const found = (_a = audios.current) === null || _a === void 0 ? void 0 : _a.find((a) => a.audioId === audioId);
+        if (found) {
+            return found;
+        }
+        const firstFreeAudio = takenAudios.current.findIndex((a) => a === false);
+        if (firstFreeAudio === -1) {
+            throw new Error(`Tried to simultaneously mount ${numberOfAudioTags + 1} <Audio /> tags at the same time. With the current settings, the maximum amount of <Audio /> tags is limited to ${numberOfAudioTags} at the same time. Remotion pre-mounts silent audio tags to help avoid browser autoplay restrictions. See https://remotion.dev/docs/player/autoplay#use-the-numberofsharedaudiotags-property for more information on how to increase this limit.`);
+        }
+        const { id, ref } = refs[firstFreeAudio];
+        const cloned = [...takenAudios.current];
+        cloned[firstFreeAudio] = id;
+        takenAudios.current = cloned;
+        const newElem = {
+            props: aud,
+            id,
+            el: ref,
+            audioId,
+        };
+        (_b = audios.current) === null || _b === void 0 ? void 0 : _b.push(newElem);
+        rerenderAudios();
+        return newElem;
+    }, [numberOfAudioTags, refs, rerenderAudios]);
+    const unregisterAudio = (0, react_1.useCallback)((id) => {
+        var _a;
+        const cloned = [...takenAudios.current];
+        const index = refs.findIndex((r) => r.id === id);
+        if (index === -1) {
+            throw new TypeError('Error occured in ');
+        }
+        cloned[index] = false;
+        takenAudios.current = cloned;
+        audios.current = (_a = audios.current) === null || _a === void 0 ? void 0 : _a.filter((a) => a.id !== id);
+        rerenderAudios();
+    }, [refs, rerenderAudios]);
+    const updateAudio = (0, react_1.useCallback)(({ aud, audioId, id, }) => {
+        var _a;
+        let changed = false;
+        audios.current = (_a = audios.current) === null || _a === void 0 ? void 0 : _a.map((prevA) => {
+            if (prevA.id === id) {
+                const isTheSame = compareProps(aud, prevA.props);
+                if (isTheSame) {
+                    return prevA;
+                }
+                changed = true;
+                return {
+                    ...prevA,
+                    props: aud,
+                    audioId,
+                };
+            }
+            return prevA;
+        });
+        if (changed) {
+            rerenderAudios();
+        }
+    }, [rerenderAudios]);
+    const playAllAudios = (0, react_1.useCallback)(() => {
+        refs.forEach((ref) => {
+            var _a;
+            (_a = ref.ref.current) === null || _a === void 0 ? void 0 : _a.play();
+        });
+    }, [refs]);
+    const value = (0, react_1.useMemo)(() => {
+        return {
+            registerAudio,
+            unregisterAudio,
+            updateAudio,
+            playAllAudios,
+            numberOfAudioTags,
+        };
+    }, [
+        numberOfAudioTags,
+        playAllAudios,
+        registerAudio,
+        unregisterAudio,
+        updateAudio,
+    ]);
+    return ((0, jsx_runtime_1.jsxs)(exports.SharedAudioContext.Provider, { value: value, children: [refs.map(({ id, ref }) => {
+                return (0, jsx_runtime_1.jsx)("audio", { ref: ref, src: EMPTY_AUDIO }, id);
+            }), children] }));
+};
+exports.SharedAudioContextProvider = SharedAudioContextProvider;
+const useSharedAudio = (aud, audioId) => {
+    const ctx = (0, react_1.useContext)(exports.SharedAudioContext);
+    /**
+     * We work around this in React 18 so an audio tag will only register itself once
+     */
+    const [elem] = (0, react_1.useState)(() => {
+        if (ctx && ctx.numberOfAudioTags > 0) {
+            return ctx.registerAudio(aud, audioId);
+        }
+        return {
+            el: react_1.default.createRef(),
+            id: Math.random(),
+            props: aud,
+            audioId,
+        };
+    });
+    /**
+     * Effects in React 18 fire twice, and we are looking for a way to only fire it once.
+     * - useInsertionEffect only fires once. If it's available we are in React 18.
+     * - useLayoutEffect only fires once in React 17.
+     */
+    const effectToUse = react_1.useInsertionEffect !== null && react_1.useInsertionEffect !== void 0 ? react_1.useInsertionEffect : react_1.useLayoutEffect;
+    if (typeof document !== 'undefined') {
+        effectToUse(() => {
+            if (ctx && ctx.numberOfAudioTags > 0) {
+                ctx.updateAudio({ id: elem.id, aud, audioId });
+            }
+        }, [aud, ctx, elem.id, audioId]);
+        effectToUse(() => {
+            return () => {
+                if (ctx && ctx.numberOfAudioTags > 0) {
+                    ctx.unregisterAudio(elem.id);
+                }
+            };
+        }, [ctx, elem.id]);
+    }
+    return elem;
+};
+exports.useSharedAudio = useSharedAudio;

package/dist/audio/use-audio-frame.d.ts

@@ -0,0 +1,6 @@
+export declare const useMediaStartsAt: () => number;
+/**
+ * When passing a function as the prop for `volume`,
+ * we calculate the way more intuitive value for currentFrame
+ */
+export declare const useFrameForVolumeProp: () => number;

package/dist/audio/use-audio-frame.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFrameForVolumeProp = exports.useMediaStartsAt = void 0;
+const react_1 = require("react");
+const Sequence_1 = require("../Sequence");
+const use_current_frame_1 = require("../use-current-frame");
+const useMediaStartsAt = () => {
+    var _a;
+    const parentSequence = (0, react_1.useContext)(Sequence_1.SequenceContext);
+    const startsAt = Math.min(0, (_a = parentSequence === null || parentSequence === void 0 ? void 0 : parentSequence.relativeFrom) !== null && _a !== void 0 ? _a : 0);
+    return startsAt;
+};
+exports.useMediaStartsAt = useMediaStartsAt;
+/**
+ * When passing a function as the prop for `volume`,
+ * we calculate the way more intuitive value for currentFrame
+ */
+const useFrameForVolumeProp = () => {
+    const frame = (0, use_current_frame_1.useCurrentFrame)();
+    const startsAt = (0, exports.useMediaStartsAt)();
+    return frame + startsAt;
+};
+exports.useFrameForVolumeProp = useFrameForVolumeProp;

package/dist/bezier.d.ts

@@ -0,0 +1 @@
+export declare function bezier(mX1: number, mY1: number, mX2: number, mY2: number): (x: number) => number;

package/dist/bezier.js

@@ -0,0 +1,114 @@
+"use strict";
+// Taken from https://github.com/facebook/react-native/blob/0b9ea60b4fee8cacc36e7160e31b91fc114dbc0d/Libraries/Animated/src/bezier.js
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bezier = void 0;
+const NEWTON_ITERATIONS = 4;
+const NEWTON_MIN_SLOPE = 0.001;
+const SUBDIVISION_PRECISION = 0.0000001;
+const SUBDIVISION_MAX_ITERATIONS = 10;
+const kSplineTableSize = 11;
+const kSampleStepSize = 1.0 / (kSplineTableSize - 1.0);
+const float32ArraySupported = typeof Float32Array === 'function';
+function a(aA1, aA2) {
+    return 1.0 - 3.0 * aA2 + 3.0 * aA1;
+}
+function b(aA1, aA2) {
+    return 3.0 * aA2 - 6.0 * aA1;
+}
+function c(aA1) {
+    return 3.0 * aA1;
+}
+// Returns x(t) given t, x1, and x2, or y(t) given t, y1, and y2.
+function calcBezier(aT, aA1, aA2) {
+    return ((a(aA1, aA2) * aT + b(aA1, aA2)) * aT + c(aA1)) * aT;
+}
+// Returns dx/dt given t, x1, and x2, or dy/dt given t, y1, and y2.
+function getSlope(aT, aA1, aA2) {
+    return 3.0 * a(aA1, aA2) * aT * aT + 2.0 * b(aA1, aA2) * aT + c(aA1);
+}
+function binarySubdivide({ aX, _aA, _aB, mX1, mX2, }) {
+    let currentX;
+    let currentT;
+    let i = 0;
+    let aA = _aA;
+    let aB = _aB;
+    do {
+        currentT = aA + (aB - aA) / 2.0;
+        currentX = calcBezier(currentT, mX1, mX2) - aX;
+        if (currentX > 0.0) {
+            aB = currentT;
+        }
+        else {
+            aA = currentT;
+        }
+    } while (Math.abs(currentX) > SUBDIVISION_PRECISION &&
+        ++i < SUBDIVISION_MAX_ITERATIONS);
+    return currentT;
+}
+function newtonRaphsonIterate(aX, _aGuessT, mX1, mX2) {
+    let aGuessT = _aGuessT;
+    for (let i = 0; i < NEWTON_ITERATIONS; ++i) {
+        const currentSlope = getSlope(aGuessT, mX1, mX2);
+        if (currentSlope === 0.0) {
+            return aGuessT;
+        }
+        const currentX = calcBezier(aGuessT, mX1, mX2) - aX;
+        aGuessT -= currentX / currentSlope;
+    }
+    return aGuessT;
+}
+function bezier(mX1, mY1, mX2, mY2) {
+    if (!(mX1 >= 0 && mX1 <= 1 && mX2 >= 0 && mX2 <= 1)) {
+        throw new Error('bezier x values must be in [0, 1] range');
+    }
+    // Precompute samples table
+    const sampleValues = float32ArraySupported
+        ? new Float32Array(kSplineTableSize)
+        : new Array(kSplineTableSize);
+    if (mX1 !== mY1 || mX2 !== mY2) {
+        for (let i = 0; i < kSplineTableSize; ++i) {
+            sampleValues[i] = calcBezier(i * kSampleStepSize, mX1, mX2);
+        }
+    }
+    function getTForX(aX) {
+        let intervalStart = 0.0;
+        let currentSample = 1;
+        const lastSample = kSplineTableSize - 1;
+        for (; currentSample !== lastSample && sampleValues[currentSample] <= aX; ++currentSample) {
+            intervalStart += kSampleStepSize;
+        }
+        --currentSample;
+        // Interpolate to provide an initial guess for t
+        const dist = (aX - sampleValues[currentSample]) /
+            (sampleValues[currentSample + 1] - sampleValues[currentSample]);
+        const guessForT = intervalStart + dist * kSampleStepSize;
+        const initialSlope = getSlope(guessForT, mX1, mX2);
+        if (initialSlope >= NEWTON_MIN_SLOPE) {
+            return newtonRaphsonIterate(aX, guessForT, mX1, mX2);
+        }
+        if (initialSlope === 0.0) {
+            return guessForT;
+        }
+        return binarySubdivide({
+            aX,
+            _aA: intervalStart,
+            _aB: intervalStart + kSampleStepSize,
+            mX1,
+            mX2,
+        });
+    }
+    return function (x) {
+        if (mX1 === mY1 && mX2 === mY2) {
+            return x; // linear
+        }
+        // Because JavaScript number are imprecise, we should guarantee the extremes are right.
+        if (x === 0) {
+            return 0;
+        }
+        if (x === 1) {
+            return 1;
+        }
+        return calcBezier(getTForX(x), mY1, mY2);
+    };
+}
+exports.bezier = bezier;

package/dist/cancel-render.d.ts

@@ -0,0 +1 @@
+export declare function cancelRender(err: unknown): never;

package/dist/cancel-render.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelRender = void 0;
+const isErrorLike = (err) => {
+    if (err === null) {
+        return false;
+    }
+    if (typeof err !== 'object') {
+        return false;
+    }
+    if (!('stack' in err)) {
+        return false;
+    }
+    // eslint-disable-next-line @typescript-eslint/prefer-ts-expect-error
+    // @ts-ignore we just asserted
+    if (typeof err.stack !== 'string') {
+        return false;
+    }
+    if (!('message' in err)) {
+        return false;
+    }
+    // eslint-disable-next-line @typescript-eslint/prefer-ts-expect-error
+    // @ts-ignore we just asserted
+    if (typeof err.message !== 'string') {
+        return false;
+    }
+    return true;
+};
+function cancelRender(err) {
+    let error;
+    if (isErrorLike(err)) {
+        error = err;
+    }
+    else if (typeof err === 'string') {
+        error = Error(err);
+    }
+    else {
+        error = Error('Rendering was cancelled');
+    }
+    window.remotion_cancelledError = error.stack;
+    throw error;
+}
+exports.cancelRender = cancelRender;

package/dist/cjs/series/index.js

@@ -15,7 +15,8 @@ const SeriesSequence = (0, react_1.forwardRef)(SeriesSequenceRefForwardingFuncti
 const Series = ({ children }) => {
     const childrenValue = (0, react_1.useMemo)(() => {
         let startFrame = 0;
-        return react_1.Children.map((0, flatten_children_js_1.flattenChildren)(children), (child, i) => {
+        const flattenedChildren = (0, flatten_children_js_1.flattenChildren)(children);
+        return react_1.Children.map(flattenedChildren, (child, i) => {
             var _a;
             const castedChild = child;
             if (typeof castedChild === 'string') {
@@ -34,7 +35,9 @@ const Series = ({ children }) => {
             }
             const durationInFramesProp = castedChild.props.durationInFrames;
             const { durationInFrames, children: _children, ...passedProps } = castedChild.props;
-            (0, validate_duration_in_frames_js_1.validateDurationInFrames)(durationInFramesProp, `of a <Series.Sequence /> component`);
+            if (i !== flattenedChildren.length - 1 || durationInFramesProp !== Infinity) {
+                (0, validate_duration_in_frames_js_1.validateDurationInFrames)(durationInFramesProp, `of a <Series.Sequence /> component`);
+            }
             const offset = (_a = castedChild.props.offset) !== null && _a !== void 0 ? _a : 0;
             if (Number.isNaN(offset)) {
                 throw new TypeError(`The "offset" property of a <Series.Sequence /> must not be NaN, but got NaN (${debugInfo}).`);

package/dist/cjs/test/series.test.js

@@ -1,11 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const jsx_runtime_1 = require("react/jsx-runtime");
-/**
- * @vitest-environment jsdom
- */
-/* eslint-disable react/jsx-no-constructed-context-values */
-const react_1 = require("@testing-library/react");
+const server_1 = require("react-dom/server");
 const vitest_1 = require("vitest");
 const CanUseRemotionHooks_js_1 = require("../CanUseRemotionHooks.js");
 const series_1 = require("../series");
@@ -25,7 +21,7 @@ const Third = () => {
     return (0, jsx_runtime_1.jsx)("div", { children: 'third ' + frame });
 };
 const renderForFrame = (frame, markup) => {
-    return (0, react_1.render)((0, jsx_runtime_1.jsx)(CanUseRemotionHooks_js_1.CanUseRemotionHooksProvider, { children: (0, jsx_runtime_1.jsx)(timeline_position_state_js_1.TimelineContext.Provider, { value: {
+    return (0, server_1.renderToString)((0, jsx_runtime_1.jsx)(CanUseRemotionHooks_js_1.CanUseRemotionHooksProvider, { children: (0, jsx_runtime_1.jsx)(timeline_position_state_js_1.TimelineContext.Provider, { value: {
                 rootId: '',
                 frame,
                 playing: false,
@@ -40,27 +36,27 @@ const renderForFrame = (frame, markup) => {
             }, children: markup }) }));
 };
 (0, vitest_1.test)('Basic series test', () => {
-    const { queryByText } = renderForFrame(10, (0, jsx_runtime_1.jsxs)(wrap_sequence_context_js_1.WrapSequenceContext, { children: [(0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }), ' '] }));
-    (0, vitest_1.expect)(queryByText(/^third\s0$/)).not.toBe(null);
+    const outerHTML = renderForFrame(10, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('<div style="position:absolute;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex"><div>third 0</div></div>');
 });
 (0, vitest_1.test)('Should support fragments', () => {
-    const { container } = renderForFrame(10, (0, jsx_runtime_1.jsxs)(wrap_sequence_context_js_1.WrapSequenceContext, { children: [(0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }, "0"), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) }, "1")] })] }), ' '] }));
-    (0, vitest_1.expect)(container.outerHTML).not.toBe(null);
+    const outerHtml = renderForFrame(10, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }, "0"), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) }, "1")] })] }) }));
+    (0, vitest_1.expect)(outerHtml).not.toBe('<div style="position:absolute;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex"><div>second 1</div></div>');
 });
 (0, vitest_1.test)('Should not allow foreign elements', () => {
     (0, vitest_1.expect)(() => {
-        (0, react_1.render)((0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(First, {}) }) }));
+        renderForFrame(0, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(First, {}) }) }));
     }).toThrow(/only accepts a/);
 });
 (0, vitest_1.test)('Should allow layout prop', () => {
-    const { container } = renderForFrame(0, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 1, children: (0, jsx_runtime_1.jsx)(First, {}) }) }) }));
-    (0, vitest_1.expect)(container.outerHTML).toBe('<div><div style="position: absolute; top: 0px; left: 0px; right: 0px; bottom: 0px; width: 100%; height: 100%; display: flex;"><div>first 0</div></div></div>');
-    const { container: withoutLayoutContainer } = renderForFrame(0, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 1, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }) }) }));
-    (0, vitest_1.expect)(withoutLayoutContainer.outerHTML).toBe('<div><div>first 0</div></div>');
+    const outerHTML = renderForFrame(0, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 1, children: (0, jsx_runtime_1.jsx)(First, {}) }) }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('<div style="position:absolute;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex"><div>first 0</div></div>');
+    const outerHTML2 = renderForFrame(0, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 1, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }) }) }));
+    (0, vitest_1.expect)(outerHTML2).toBe('<div>first 0</div>');
 });
 (0, vitest_1.test)('Should render nothing after the end', () => {
-    const { container } = renderForFrame(10, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 1, children: (0, jsx_runtime_1.jsx)(First, {}) }) }) }));
-    (0, vitest_1.expect)(container.outerHTML).toBe('<div></div>');
+    const outerHTML = renderForFrame(10, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsx)(series_1.Series, { children: (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 1, children: (0, jsx_runtime_1.jsx)(First, {}) }) }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('');
 });
 (0, vitest_1.test)('Should throw if invalid or no duration provided', () => {
     (0, vitest_1.expect)(() => {
@@ -71,19 +67,19 @@ const renderForFrame = (frame, markup) => {
     }).toThrow(/The "durationInFrames" prop of a <Series.Sequence \/> component must be a number, but you passed a value of type undefined/);
 });
 (0, vitest_1.test)('Should allow whitespace', () => {
-    const { queryByText } = renderForFrame(11, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 10, children: (0, jsx_runtime_1.jsx)(First, {}) }), ' ', (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 10, children: (0, jsx_runtime_1.jsx)(Second, {}) })] }) }));
-    (0, vitest_1.expect)(queryByText(/^second\s1$/g)).not.toBe(null);
+    const outerHtml = renderForFrame(11, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 10, children: (0, jsx_runtime_1.jsx)(First, {}) }), ' ', (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 10, children: (0, jsx_runtime_1.jsx)(Second, {}) })] }) }));
+    (0, vitest_1.expect)(outerHtml).toBe('<div style="position:absolute;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex"><div>second 1</div></div>');
 });
 (0, vitest_1.test)('Handle empty Series.Sequence', () => {
     (0, vitest_1.expect)(() => renderForFrame(11, (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 10, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 10 })] }))).toThrow(/A <Series.Sequence \/> component \(index = 1, duration = 10\) was detected to not have any children\. Delete it to fix this error\./);
 });
 (0, vitest_1.test)('Should allow negative overlap prop', () => {
-    const { container } = renderForFrame(4, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: -1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) })] }) }));
-    (0, vitest_1.expect)(container.outerHTML).toBe('<div><div>first 4</div><div>second 0</div></div>');
+    const outerHTML = renderForFrame(4, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: -1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) })] }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('<div>first 4</div><div>second 0</div>');
 });
 (0, vitest_1.test)('Should allow positive overlap prop', () => {
-    const { container } = renderForFrame(5, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: 1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) })] }) }));
-    (0, vitest_1.expect)(container.outerHTML).toBe('<div></div>');
+    const outerHTML = renderForFrame(5, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: 1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) })] }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('');
 });
 (0, vitest_1.test)('Should disallow NaN as offset prop', () => {
     (0, vitest_1.expect)(() => {
@@ -101,10 +97,19 @@ const renderForFrame = (frame, markup) => {
     }).toThrow(/The "offset" property of a <Series.Sequence \/> must be finite, but got 3.141592653589793 \(index = 0, duration = 5\)\./);
 });
 (0, vitest_1.test)('Should cascade negative offset props', () => {
-    const { container } = renderForFrame(9, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: -1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
-    (0, vitest_1.expect)(container.outerHTML).toBe('<div><div>third 0</div></div>');
+    const outerHTML = renderForFrame(9, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: -1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('<div>third 0</div>');
 });
 (0, vitest_1.test)('Should cascade positive offset props', () => {
-    const { container } = renderForFrame(11, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: 1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
-    (0, vitest_1.expect)(container.outerHTML).toBe('<div><div>third 0</div></div>');
+    const outerHTML = renderForFrame(11, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, layout: "none", children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { offset: 1, layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { layout: "none", durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('<div>third 0</div>');
+});
+(0, vitest_1.test)('Allow durationInFrames as Infinity for last Series.Sequence', () => {
+    const outerHTML = renderForFrame(10, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: Infinity, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
+    (0, vitest_1.expect)(outerHTML).toBe('<div style="position:absolute;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex"><div>third 0</div></div>');
+});
+(0, vitest_1.test)('Disallow durationInFrames as Infinity for first n-1 Series.Sequence', () => {
+    (0, vitest_1.expect)(() => {
+        renderForFrame(10, (0, jsx_runtime_1.jsx)(wrap_sequence_context_js_1.WrapSequenceContext, { children: (0, jsx_runtime_1.jsxs)(series_1.Series, { children: [(0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(First, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: Infinity, children: (0, jsx_runtime_1.jsx)(Second, {}) }), (0, jsx_runtime_1.jsx)(series_1.Series.Sequence, { durationInFrames: 5, children: (0, jsx_runtime_1.jsx)(Third, {}) })] }) }));
+    }).toThrow(/The "durationInFrames" prop of a <Series.Sequence \/> component must be an integer, but got Infinity\./);
 });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "3.3.51";
+export declare const VERSION = "3.3.52";