@remotion/player 3.3.45 → 3.3.52

package/dist/use-playback.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePlayback = void 0;
+const react_1 = require("react");
+const remotion_1 = require("remotion");
+const calculate_next_frame_1 = require("./calculate-next-frame");
+const use_player_1 = require("./use-player");
+const usePlayback = ({ loop, playbackRate, moveToBeginningWhenEnded, inFrame, outFrame, }) => {
+    const frame = remotion_1.Internals.Timeline.useTimelinePosition();
+    const config = remotion_1.Internals.useUnsafeVideoConfig();
+    const { playing, pause, emitter } = (0, use_player_1.usePlayer)();
+    const setFrame = remotion_1.Internals.Timeline.useTimelineSetFrame();
+    const frameRef = (0, react_1.useRef)(frame);
+    frameRef.current = frame;
+    const lastTimeUpdateEvent = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        if (!config) {
+            return;
+        }
+        if (!playing) {
+            return;
+        }
+        let hasBeenStopped = false;
+        let reqAnimFrameCall = null;
+        const startedTime = performance.now();
+        let framesAdvanced = 0;
+        const stop = () => {
+            hasBeenStopped = true;
+            if (reqAnimFrameCall !== null) {
+                cancelAnimationFrame(reqAnimFrameCall);
+            }
+        };
+        const callback = () => {
+            const time = performance.now() - startedTime;
+            const actualLastFrame = outFrame !== null && outFrame !== void 0 ? outFrame : config.durationInFrames - 1;
+            const actualFirstFrame = inFrame !== null && inFrame !== void 0 ? inFrame : 0;
+            const { nextFrame, framesToAdvance, hasEnded } = (0, calculate_next_frame_1.calculateNextFrame)({
+                time,
+                currentFrame: frameRef.current,
+                playbackSpeed: playbackRate,
+                fps: config.fps,
+                actualFirstFrame,
+                actualLastFrame,
+                framesAdvanced,
+                shouldLoop: loop,
+            });
+            framesAdvanced += framesToAdvance;
+            if (nextFrame !== frameRef.current &&
+                (!hasEnded || moveToBeginningWhenEnded)) {
+                setFrame(nextFrame);
+            }
+            if (hasEnded) {
+                stop();
+                pause();
+                emitter.dispatchEnded();
+                return;
+            }
+            if (!hasBeenStopped) {
+                reqAnimFrameCall = requestAnimationFrame(callback);
+            }
+        };
+        reqAnimFrameCall = requestAnimationFrame(callback);
+        return () => {
+            stop();
+        };
+    }, [
+        config,
+        loop,
+        pause,
+        playing,
+        setFrame,
+        emitter,
+        playbackRate,
+        inFrame,
+        outFrame,
+        moveToBeginningWhenEnded,
+    ]);
+    (0, react_1.useEffect)(() => {
+        const interval = setInterval(() => {
+            if (lastTimeUpdateEvent.current === frameRef.current) {
+                return;
+            }
+            emitter.dispatchTimeUpdate({ frame: frameRef.current });
+            lastTimeUpdateEvent.current = frameRef.current;
+        }, 250);
+        return () => clearInterval(interval);
+    }, [emitter]);
+    (0, react_1.useEffect)(() => {
+        emitter.dispatchFrameUpdate({ frame });
+    }, [emitter, frame]);
+};
+exports.usePlayback = usePlayback;

package/dist/use-player.d.ts

@@ -0,0 +1,19 @@
+import type { SyntheticEvent } from 'react';
+import type { PlayerEmitter } from './event-emitter';
+declare type UsePlayerMethods = {
+    frameBack: (frames: number) => void;
+    frameForward: (frames: number) => void;
+    isLastFrame: boolean;
+    isFirstFrame: boolean;
+    emitter: PlayerEmitter;
+    playing: boolean;
+    play: (e?: SyntheticEvent) => void;
+    pause: () => void;
+    pauseAndReturnToPlayStart: () => void;
+    seek: (newFrame: number) => void;
+    getCurrentFrame: () => number;
+    isPlaying: () => boolean;
+    hasPlayed: boolean;
+};
+export declare const usePlayer: () => UsePlayerMethods;
+export {};

package/dist/use-player.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePlayer = void 0;
+const react_1 = require("react");
+const remotion_1 = require("remotion");
+const emitter_context_1 = require("./emitter-context");
+const usePlayer = () => {
+    var _a;
+    const [playing, setPlaying, imperativePlaying] = remotion_1.Internals.Timeline.usePlayingState();
+    const [hasPlayed, setHasPlayed] = (0, react_1.useState)(false);
+    const frame = remotion_1.Internals.Timeline.useTimelinePosition();
+    const playStart = (0, react_1.useRef)(frame);
+    const setFrame = remotion_1.Internals.Timeline.useTimelineSetFrame();
+    const setTimelinePosition = remotion_1.Internals.Timeline.useTimelineSetFrame();
+    const audioContext = (0, react_1.useContext)(remotion_1.Internals.SharedAudioContext);
+    const { audioAndVideoTags } = (0, react_1.useContext)(remotion_1.Internals.Timeline.TimelineContext);
+    const frameRef = (0, react_1.useRef)();
+    frameRef.current = frame;
+    const video = remotion_1.Internals.useVideo();
+    const config = remotion_1.Internals.useUnsafeVideoConfig();
+    const emitter = (0, react_1.useContext)(emitter_context_1.PlayerEventEmitterContext);
+    const lastFrame = ((_a = config === null || config === void 0 ? void 0 : config.durationInFrames) !== null && _a !== void 0 ? _a : 1) - 1;
+    const isLastFrame = frame === lastFrame;
+    const isFirstFrame = frame === 0;
+    if (!emitter) {
+        throw new TypeError('Expected Player event emitter context');
+    }
+    const seek = (0, react_1.useCallback)((newFrame) => {
+        setTimelinePosition(newFrame);
+        emitter.dispatchSeek(newFrame);
+    }, [emitter, setTimelinePosition]);
+    const play = (0, react_1.useCallback)((e) => {
+        if (imperativePlaying.current) {
+            return;
+        }
+        setHasPlayed(true);
+        if (isLastFrame) {
+            seek(0);
+        }
+        /**
+         * Play silent audio tags to warm them up for autoplay
+         */
+        if (audioContext && audioContext.numberOfAudioTags > 0 && e) {
+            audioContext.playAllAudios();
+        }
+        /**
+         * Play audios and videos directly here so they can benefit from
+         * being triggered by a click
+         */
+        audioAndVideoTags.current.forEach((a) => a.play());
+        imperativePlaying.current = true;
+        setPlaying(true);
+        playStart.current = frameRef.current;
+        emitter.dispatchPlay();
+    }, [
+        imperativePlaying,
+        isLastFrame,
+        audioContext,
+        setPlaying,
+        emitter,
+        seek,
+        audioAndVideoTags,
+    ]);
+    const pause = (0, react_1.useCallback)(() => {
+        if (imperativePlaying.current) {
+            imperativePlaying.current = false;
+            setPlaying(false);
+            emitter.dispatchPause();
+        }
+    }, [emitter, imperativePlaying, setPlaying]);
+    const pauseAndReturnToPlayStart = (0, react_1.useCallback)(() => {
+        if (imperativePlaying.current) {
+            imperativePlaying.current = false;
+            setTimelinePosition(playStart.current);
+            setPlaying(false);
+            emitter.dispatchPause();
+        }
+    }, [emitter, imperativePlaying, setPlaying, setTimelinePosition]);
+    const hasVideo = Boolean(video);
+    const frameBack = (0, react_1.useCallback)((frames) => {
+        if (!hasVideo) {
+            return null;
+        }
+        if (imperativePlaying.current) {
+            return;
+        }
+        setFrame((f) => {
+            return Math.max(0, f - frames);
+        });
+    }, [hasVideo, imperativePlaying, setFrame]);
+    const frameForward = (0, react_1.useCallback)((frames) => {
+        if (!hasVideo) {
+            return null;
+        }
+        if (imperativePlaying.current) {
+            return;
+        }
+        setFrame((f) => Math.min(lastFrame, f + frames));
+    }, [hasVideo, imperativePlaying, lastFrame, setFrame]);
+    const returnValue = (0, react_1.useMemo)(() => {
+        return {
+            frameBack,
+            frameForward,
+            isLastFrame,
+            emitter,
+            playing,
+            play,
+            pause,
+            seek,
+            isFirstFrame,
+            getCurrentFrame: () => frameRef.current,
+            isPlaying: () => imperativePlaying.current,
+            pauseAndReturnToPlayStart,
+            hasPlayed,
+        };
+    }, [
+        frameBack,
+        frameForward,
+        isLastFrame,
+        emitter,
+        playing,
+        play,
+        pause,
+        seek,
+        isFirstFrame,
+        pauseAndReturnToPlayStart,
+        imperativePlaying,
+        hasPlayed,
+    ]);
+    return returnValue;
+};
+exports.usePlayer = usePlayer;

package/dist/use-thumbnail.d.ts

@@ -0,0 +1,6 @@
+import type { ThumbnailEmitter } from './event-emitter';
+declare type UseThumbnailMethods = {
+    emitter: ThumbnailEmitter;
+};
+export declare const useThumbnail: () => UseThumbnailMethods;
+export {};

package/dist/use-thumbnail.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useThumbnail = void 0;
+const react_1 = require("react");
+const emitter_context_1 = require("./emitter-context");
+const useThumbnail = () => {
+    const emitter = (0, react_1.useContext)(emitter_context_1.ThumbnailEmitterContext);
+    if (!emitter) {
+        throw new TypeError('Expected Player event emitter context');
+    }
+    const returnValue = (0, react_1.useMemo)(() => {
+        return {
+            emitter,
+        };
+    }, [emitter]);
+    return returnValue;
+};
+exports.useThumbnail = useThumbnail;

package/dist/use-video-controls-resize.d.ts

@@ -0,0 +1,7 @@
+export declare const useVideoControlsResize: ({ allowFullscreen: allowFullScreen, playerWidth, }: {
+    allowFullscreen: boolean;
+    playerWidth: number;
+}) => {
+    maxTimeLabelWidth: number;
+    displayVerticalVolumeSlider: boolean;
+};

package/dist/use-video-controls-resize.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useVideoControlsResize = void 0;
+const react_1 = require("react");
+const icons_1 = require("./icons");
+const MediaVolumeSlider_1 = require("./MediaVolumeSlider");
+const PlayerControls_1 = require("./PlayerControls");
+const useVideoControlsResize = ({ allowFullscreen: allowFullScreen, playerWidth, }) => {
+    const resizeInfo = (0, react_1.useMemo)(() => {
+        const playPauseIconSize = icons_1.ICON_SIZE;
+        const volumeIconSize = icons_1.ICON_SIZE;
+        const _fullscreenIconSize = allowFullScreen ? icons_1.fullscreenIconSize : 0;
+        const elementsSize = volumeIconSize +
+            playPauseIconSize +
+            _fullscreenIconSize +
+            PlayerControls_1.X_PADDING * 2 +
+            PlayerControls_1.X_SPACER * 2;
+        const maxTimeLabelWidth = playerWidth - elementsSize;
+        const maxTimeLabelWidthWithoutNegativeValue = Math.max(maxTimeLabelWidth, 0);
+        const availableTimeLabelWidthIfVolumeOpen = maxTimeLabelWidthWithoutNegativeValue - MediaVolumeSlider_1.VOLUME_SLIDER_WIDTH;
+        // If max label width is lower than the volume width
+        // then it means we need to take it's width as the max label width
+        // otherwise we took the available width when volume open
+        const computedLabelWidth = availableTimeLabelWidthIfVolumeOpen < MediaVolumeSlider_1.VOLUME_SLIDER_WIDTH
+            ? maxTimeLabelWidthWithoutNegativeValue
+            : availableTimeLabelWidthIfVolumeOpen;
+        const minWidthForHorizontalDisplay = computedLabelWidth + elementsSize + MediaVolumeSlider_1.VOLUME_SLIDER_WIDTH;
+        const displayVerticalVolumeSlider = playerWidth < minWidthForHorizontalDisplay;
+        return {
+            maxTimeLabelWidth: maxTimeLabelWidthWithoutNegativeValue,
+            displayVerticalVolumeSlider,
+        };
+    }, [allowFullScreen, playerWidth]);
+    return resizeInfo;
+};
+exports.useVideoControlsResize = useVideoControlsResize;

package/dist/utils/calculate-player-size.d.ts

@@ -0,0 +1,9 @@
+import type { StandardLonghandProperties } from 'csstype';
+import type { Size } from './use-element-size';
+export declare const calculatePlayerSize: ({ currentSize, width, height, compositionWidth, compositionHeight, }: {
+    currentSize: Size | null;
+    width: StandardLonghandProperties['width'] | undefined;
+    height: StandardLonghandProperties['height'] | undefined;
+    compositionWidth: number;
+    compositionHeight: number;
+}) => React.CSSProperties;

package/dist/utils/calculate-player-size.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculatePlayerSize = void 0;
+const calculatePlayerSize = ({ currentSize, width, height, compositionWidth, compositionHeight, }) => {
+    const aspectRatio = compositionWidth / compositionHeight;
+    if (!currentSize) {
+        return {
+            width: compositionWidth,
+            height: compositionHeight,
+        };
+    }
+    // If has width specified, but no height, specify a default height that satisfies the aspect ratio.
+    if (width !== undefined && height === undefined) {
+        return {
+            height: currentSize.width / aspectRatio,
+        };
+    }
+    // Opposite: If has height specified, evaluate the height and specify a default width.
+    if (height !== undefined && width === undefined) {
+        return {
+            width: currentSize.height * aspectRatio,
+        };
+    }
+    return {
+        width: compositionWidth,
+        height: compositionHeight,
+    };
+};
+exports.calculatePlayerSize = calculatePlayerSize;

package/dist/utils/cancellable-promise.d.ts

@@ -0,0 +1,5 @@
+export declare type CancellablePromise = {
+    promise: Promise<unknown>;
+    cancel: () => void;
+};
+export declare const cancellablePromise: (promise: Promise<unknown>) => CancellablePromise;

package/dist/utils/cancellable-promise.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancellablePromise = void 0;
+const cancellablePromise = (promise) => {
+    let isCanceled = false;
+    const wrappedPromise = new Promise((resolve, reject) => {
+        promise
+            .then((value) => {
+            if (isCanceled) {
+                reject({ isCanceled, value });
+                return;
+            }
+            resolve(value);
+        })
+            .catch((error) => {
+            reject({ isCanceled, error });
+        });
+    });
+    return {
+        promise: wrappedPromise,
+        cancel: () => {
+            isCanceled = true;
+        },
+    };
+};
+exports.cancellablePromise = cancellablePromise;

package/dist/utils/delay.d.ts

@@ -0,0 +1 @@
+export declare const delay: (n: number) => Promise<unknown>;

package/dist/utils/delay.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.delay = void 0;
+/* eslint-disable no-promise-executor-return */
+const delay = (n) => new Promise((resolve) => setTimeout(resolve, n));
+exports.delay = delay;

package/dist/utils/is-node.d.ts

@@ -0,0 +1 @@
+export declare const IS_NODE: boolean;

package/dist/utils/is-node.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IS_NODE = void 0;
+exports.IS_NODE = typeof document === 'undefined';

package/dist/utils/preview-size.d.ts

@@ -0,0 +1,8 @@
+export declare type Translation = {
+    x: number;
+    y: number;
+};
+export declare type PreviewSize = {
+    size: number | 'auto';
+    translation: Translation;
+};

package/dist/utils/preview-size.js

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

package/dist/utils/props-if-has-props.d.ts

@@ -0,0 +1,5 @@
+export declare type PropsIfHasProps<Props> = {} extends Props ? {
+    inputProps?: Props;
+} : {
+    inputProps: Props;
+};

package/dist/utils/props-if-has-props.js

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

package/dist/utils/use-cancellable-promises.d.ts

@@ -0,0 +1,7 @@
+import type { CancellablePromise } from './cancellable-promise';
+declare const useCancellablePromises: () => {
+    appendPendingPromise: (promise: CancellablePromise) => void;
+    removePendingPromise: (promise: CancellablePromise) => void;
+    clearPendingPromises: () => void[];
+};
+export { useCancellablePromises };

package/dist/utils/use-cancellable-promises.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCancellablePromises = void 0;
+const react_1 = require("react");
+const useCancellablePromises = () => {
+    const pendingPromises = (0, react_1.useRef)([]);
+    const appendPendingPromise = (0, react_1.useCallback)((promise) => {
+        pendingPromises.current = [...pendingPromises.current, promise];
+    }, []);
+    const removePendingPromise = (0, react_1.useCallback)((promise) => {
+        pendingPromises.current = pendingPromises.current.filter((p) => p !== promise);
+    }, []);
+    const clearPendingPromises = (0, react_1.useCallback)(() => pendingPromises.current.map((p) => p.cancel()), []);
+    const api = (0, react_1.useMemo)(() => ({
+        appendPendingPromise,
+        removePendingPromise,
+        clearPendingPromises,
+    }), [appendPendingPromise, clearPendingPromises, removePendingPromise]);
+    return api;
+};
+exports.useCancellablePromises = useCancellablePromises;

package/dist/utils/use-click-prevention-on-double-click.d.ts

@@ -0,0 +1,3 @@
+import type { SyntheticEvent } from 'react';
+declare const useClickPreventionOnDoubleClick: (onClick: (e: SyntheticEvent) => void, onDoubleClick: () => void, doubleClickToFullscreen: boolean) => [(e: SyntheticEvent) => void, () => void];
+export { useClickPreventionOnDoubleClick };

package/dist/utils/use-click-prevention-on-double-click.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useClickPreventionOnDoubleClick = void 0;
+const react_1 = require("react");
+const cancellable_promise_1 = require("./cancellable-promise");
+const delay_1 = require("./delay");
+const use_cancellable_promises_1 = require("./use-cancellable-promises");
+const useClickPreventionOnDoubleClick = (onClick, onDoubleClick, doubleClickToFullscreen) => {
+    const api = (0, use_cancellable_promises_1.useCancellablePromises)();
+    const handleClick = (0, react_1.useCallback)(async (e) => {
+        api.clearPendingPromises();
+        const waitForClick = (0, cancellable_promise_1.cancellablePromise)((0, delay_1.delay)(200));
+        api.appendPendingPromise(waitForClick);
+        try {
+            await waitForClick.promise;
+            api.removePendingPromise(waitForClick);
+            onClick(e);
+        }
+        catch (errorInfo) {
+            const info = errorInfo;
+            api.removePendingPromise(waitForClick);
+            if (!info.isCanceled) {
+                throw info.error;
+            }
+        }
+    }, [api, onClick]);
+    const handleDoubleClick = (0, react_1.useCallback)(() => {
+        api.clearPendingPromises();
+        onDoubleClick();
+    }, [api, onDoubleClick]);
+    const returnValue = (0, react_1.useMemo)(() => {
+        if (!doubleClickToFullscreen) {
+            return [onClick, onDoubleClick];
+        }
+        return [handleClick, handleDoubleClick];
+    }, [
+        doubleClickToFullscreen,
+        handleClick,
+        handleDoubleClick,
+        onClick,
+        onDoubleClick,
+    ]);
+    return returnValue;
+};
+exports.useClickPreventionOnDoubleClick = useClickPreventionOnDoubleClick;

package/dist/utils/use-element-size.d.ts

@@ -0,0 +1,16 @@
+export declare type Size = {
+    width: number;
+    height: number;
+    left: number;
+    top: number;
+    windowSize: {
+        width: number;
+        height: number;
+    };
+    refresh: () => void;
+};
+export declare const updateAllElementsSizes: () => void;
+export declare const useElementSize: (ref: React.RefObject<HTMLElement>, options: {
+    triggerOnWindowResize: boolean;
+    shouldApplyCssTransforms: boolean;
+}) => Size | null;

package/dist/utils/use-element-size.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useElementSize = exports.updateAllElementsSizes = void 0;
+const react_1 = require("react");
+let elementSizeHooks = [];
+const updateAllElementsSizes = () => {
+    for (const listener of elementSizeHooks) {
+        listener();
+    }
+};
+exports.updateAllElementsSizes = updateAllElementsSizes;
+const useElementSize = (ref, options) => {
+    const [size, setSize] = (0, react_1.useState)(null);
+    const observer = (0, react_1.useMemo)(() => {
+        if (typeof ResizeObserver === 'undefined') {
+            return null;
+        }
+        return new ResizeObserver((entries) => {
+            // The contentRect returns the width without any `scale()`'s being applied. The height is wrong
+            const { contentRect } = entries[0];
+            // The clientRect returns the size with `scale()` being applied.
+            const newSize = entries[0].target.getClientRects();
+            if (!newSize || !newSize[0]) {
+                setSize(null);
+                return;
+            }
+            const probableCssParentScale = newSize[0].width / contentRect.width;
+            const width = options.shouldApplyCssTransforms
+                ? newSize[0].width
+                : newSize[0].width * (1 / probableCssParentScale);
+            const height = options.shouldApplyCssTransforms
+                ? newSize[0].height
+                : newSize[0].height * (1 / probableCssParentScale);
+            setSize({
+                width,
+                height,
+                left: newSize[0].x,
+                top: newSize[0].y,
+                windowSize: {
+                    height: window.innerHeight,
+                    width: window.innerWidth,
+                },
+            });
+        });
+    }, [options.shouldApplyCssTransforms]);
+    const updateSize = (0, react_1.useCallback)(() => {
+        if (!ref.current) {
+            return;
+        }
+        const rect = ref.current.getClientRects();
+        if (!rect[0]) {
+            setSize(null);
+            return;
+        }
+        setSize({
+            width: rect[0].width,
+            height: rect[0].height,
+            left: rect[0].x,
+            top: rect[0].y,
+            windowSize: {
+                height: window.innerHeight,
+                width: window.innerWidth,
+            },
+        });
+    }, [ref]);
+    (0, react_1.useEffect)(() => {
+        if (!observer) {
+            return;
+        }
+        updateSize();
+        const { current } = ref;
+        if (ref.current) {
+            observer.observe(ref.current);
+        }
+        return () => {
+            if (current) {
+                observer.unobserve(current);
+            }
+        };
+    }, [observer, ref, updateSize]);
+    (0, react_1.useEffect)(() => {
+        if (!options.triggerOnWindowResize) {
+            return;
+        }
+        window.addEventListener('resize', updateSize);
+        return () => {
+            window.removeEventListener('resize', updateSize);
+        };
+    }, [options.triggerOnWindowResize, updateSize]);
+    (0, react_1.useEffect)(() => {
+        elementSizeHooks.push(updateSize);
+        return () => {
+            elementSizeHooks = elementSizeHooks.filter((e) => e !== updateSize);
+        };
+    }, [updateSize]);
+    return size ? { ...size, refresh: updateSize } : null;
+};
+exports.useElementSize = useElementSize;

package/dist/utils/validate-in-out-frame.d.ts

@@ -0,0 +1,6 @@
+export declare const validateSingleFrame: (frame: unknown, variableName: string) => number | null;
+export declare const validateInOutFrames: ({ inFrame, durationInFrames, outFrame, }: {
+    inFrame: unknown;
+    outFrame: unknown;
+    durationInFrames: number;
+}) => void;