@remotion/player 3.3.41 → 3.3.43

package/dist/PlayerUI.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import type { PlayerRef } from './player-methods';
+import type { RenderFullscreenButton, RenderPlayPauseButton } from './PlayerControls';
+export declare type ErrorFallback = (info: {
+    error: Error;
+}) => React.ReactNode;
+export declare type RenderLoading = (canvas: {
+    height: number;
+    width: number;
+}) => React.ReactNode;
+export declare type RenderPoster = RenderLoading;
+declare const _default: React.ForwardRefExoticComponent<{
+    controls: boolean;
+    loop: boolean;
+    autoPlay: boolean;
+    allowFullscreen: boolean;
+    inputProps: unknown;
+    showVolumeControls: boolean;
+    style?: React.CSSProperties | undefined;
+    clickToPlay: boolean;
+    doubleClickToFullscreen: boolean;
+    spaceKeyToPlayOrPause: boolean;
+    errorFallback: ErrorFallback;
+    playbackRate: number;
+    renderLoading: RenderLoading | undefined;
+    renderPoster: RenderLoading | undefined;
+    className: string | undefined;
+    moveToBeginningWhenEnded: boolean;
+    showPosterWhenPaused: boolean;
+    showPosterWhenEnded: boolean;
+    showPosterWhenUnplayed: boolean;
+    inFrame: number | null;
+    outFrame: number | null;
+    initiallyShowControls: number | boolean;
+    renderPlayPauseButton: RenderPlayPauseButton | null;
+    renderFullscreen: RenderFullscreenButton | null;
+} & React.RefAttributes<PlayerRef>>;
+export default _default;

package/dist/PlayerUI.js

@@ -0,0 +1,308 @@
+"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 });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const remotion_1 = require("remotion");
+const calculate_scale_1 = require("./calculate-scale");
+const error_boundary_1 = require("./error-boundary");
+const player_css_classname_1 = require("./player-css-classname");
+const PlayerControls_1 = require("./PlayerControls");
+const use_hover_state_1 = require("./use-hover-state");
+const use_playback_1 = require("./use-playback");
+const use_player_1 = require("./use-player");
+const is_node_1 = require("./utils/is-node");
+const use_click_prevention_on_double_click_1 = require("./utils/use-click-prevention-on-double-click");
+const use_element_size_1 = require("./utils/use-element-size");
+const reactVersion = react_1.default.version.split('.')[0];
+if (reactVersion === '0') {
+    throw new Error(`Version ${reactVersion} of "react" is not supported by Remotion`);
+}
+const doesReactVersionSupportSuspense = parseInt(reactVersion, 10) >= 18;
+const PlayerUI = ({ controls, style, loop, autoPlay, allowFullscreen, inputProps, clickToPlay, showVolumeControls, doubleClickToFullscreen, spaceKeyToPlayOrPause, errorFallback, playbackRate, renderLoading, renderPoster, className, moveToBeginningWhenEnded, showPosterWhenUnplayed, showPosterWhenEnded, showPosterWhenPaused, inFrame, outFrame, initiallyShowControls, renderFullscreen: renderFullscreenButton, renderPlayPauseButton, }, ref) => {
+    var _a, _b, _c, _d, _e;
+    const config = remotion_1.Internals.useUnsafeVideoConfig();
+    const video = remotion_1.Internals.useVideo();
+    const container = (0, react_1.useRef)(null);
+    const hovered = (0, use_hover_state_1.useHoverState)(container);
+    const canvasSize = (0, use_element_size_1.useElementSize)(container, {
+        triggerOnWindowResize: false,
+        shouldApplyCssTransforms: false,
+    });
+    const [hasPausedToResume, setHasPausedToResume] = (0, react_1.useState)(false);
+    const [shouldAutoplay, setShouldAutoPlay] = (0, react_1.useState)(autoPlay);
+    const [isFullscreen, setIsFullscreen] = (0, react_1.useState)(() => false);
+    const [seeking, setSeeking] = (0, react_1.useState)(false);
+    (0, use_playback_1.usePlayback)({
+        loop,
+        playbackRate,
+        moveToBeginningWhenEnded,
+        inFrame,
+        outFrame,
+    });
+    const player = (0, use_player_1.usePlayer)();
+    (0, react_1.useEffect)(() => {
+        if (hasPausedToResume && !player.playing) {
+            setHasPausedToResume(false);
+            player.play();
+        }
+    }, [hasPausedToResume, player]);
+    (0, react_1.useEffect)(() => {
+        const { current } = container;
+        if (!current) {
+            return;
+        }
+        const onFullscreenChange = () => {
+            setIsFullscreen(document.fullscreenElement === current ||
+                document.webkitFullscreenElement === current);
+        };
+        document.addEventListener('fullscreenchange', onFullscreenChange);
+        document.addEventListener('webkitfullscreenchange', onFullscreenChange);
+        return () => {
+            document.removeEventListener('fullscreenchange', onFullscreenChange);
+            document.removeEventListener('webkitfullscreenchange', onFullscreenChange);
+        };
+    }, []);
+    const toggle = (0, react_1.useCallback)((e) => {
+        if (player.isPlaying()) {
+            player.pause();
+        }
+        else {
+            player.play(e);
+        }
+    }, [player]);
+    const requestFullscreen = (0, react_1.useCallback)(() => {
+        if (!allowFullscreen) {
+            throw new Error('allowFullscreen is false');
+        }
+        const supportsFullScreen = document.fullscreenEnabled || document.webkitFullscreenEnabled;
+        if (!supportsFullScreen) {
+            throw new Error('Browser doesnt support fullscreen');
+        }
+        if (!container.current) {
+            throw new Error('No player ref found');
+        }
+        if (container.current.webkitRequestFullScreen) {
+            container.current.webkitRequestFullScreen();
+        }
+        else {
+            container.current.requestFullscreen();
+        }
+    }, [allowFullscreen]);
+    const exitFullscreen = (0, react_1.useCallback)(() => {
+        if (document.webkitExitFullscreen) {
+            document.webkitExitFullscreen();
+        }
+        else {
+            document.exitFullscreen();
+        }
+    }, []);
+    (0, react_1.useEffect)(() => {
+        const { current } = container;
+        if (!current) {
+            return;
+        }
+        const fullscreenChange = () => {
+            var _a;
+            const element = (_a = document.webkitFullscreenElement) !== null && _a !== void 0 ? _a : document.fullscreenElement;
+            if (element && element === container.current) {
+                player.emitter.dispatchFullscreenChangeUpdate({
+                    isFullscreen: true,
+                });
+            }
+            else {
+                player.emitter.dispatchFullscreenChangeUpdate({
+                    isFullscreen: false,
+                });
+            }
+        };
+        current.addEventListener('webkitfullscreenchange', fullscreenChange);
+        current.addEventListener('fullscreenchange', fullscreenChange);
+        return () => {
+            current.removeEventListener('webkitfullscreenchange', fullscreenChange);
+            current.removeEventListener('fullscreenchange', fullscreenChange);
+        };
+    }, [player.emitter]);
+    const durationInFrames = (_a = config === null || config === void 0 ? void 0 : config.durationInFrames) !== null && _a !== void 0 ? _a : 1;
+    const layout = (0, react_1.useMemo)(() => {
+        if (!config || !canvasSize) {
+            return null;
+        }
+        return (0, calculate_scale_1.calculateCanvasTransformation)({
+            canvasSize,
+            compositionHeight: config.height,
+            compositionWidth: config.width,
+            previewSize: 'auto',
+        });
+    }, [canvasSize, config]);
+    const scale = (_b = layout === null || layout === void 0 ? void 0 : layout.scale) !== null && _b !== void 0 ? _b : 1;
+    const { setMediaVolume, setMediaMuted } = (0, react_1.useContext)(remotion_1.Internals.SetMediaVolumeContext);
+    const { mediaMuted, mediaVolume } = (0, react_1.useContext)(remotion_1.Internals.MediaVolumeContext);
+    (0, react_1.useImperativeHandle)(ref, () => {
+        const methods = {
+            play: player.play,
+            pause: player.pause,
+            toggle,
+            getContainerNode: () => container.current,
+            getCurrentFrame: player.getCurrentFrame,
+            isPlaying: () => player.playing,
+            seekTo: (f) => {
+                const lastFrame = durationInFrames - 1;
+                const frameToSeekTo = Math.max(0, Math.min(lastFrame, f));
+                if (player.isPlaying()) {
+                    const pauseToResume = frameToSeekTo !== lastFrame || loop;
+                    setHasPausedToResume(pauseToResume);
+                    player.pause();
+                }
+                if (frameToSeekTo === lastFrame && !loop) {
+                    player.emitter.dispatchEnded();
+                }
+                player.seek(frameToSeekTo);
+            },
+            isFullscreen: () => isFullscreen,
+            requestFullscreen,
+            exitFullscreen,
+            getVolume: () => {
+                if (mediaMuted) {
+                    return 0;
+                }
+                return mediaVolume;
+            },
+            setVolume: (vol) => {
+                if (typeof vol !== 'number') {
+                    throw new TypeError(`setVolume() takes a number, got value of type ${typeof vol}`);
+                }
+                if (isNaN(vol)) {
+                    throw new TypeError(`setVolume() got a number that is NaN. Volume must be between 0 and 1.`);
+                }
+                if (vol < 0 || vol > 1) {
+                    throw new TypeError(`setVolume() got a number that is out of range. Must be between 0 and 1, got ${typeof vol}`);
+                }
+                setMediaVolume(vol);
+            },
+            isMuted: () => mediaMuted || mediaVolume === 0,
+            mute: () => {
+                setMediaMuted(true);
+            },
+            unmute: () => {
+                setMediaMuted(false);
+            },
+            getScale: () => scale,
+        };
+        return Object.assign(player.emitter, methods);
+    }, [
+        durationInFrames,
+        exitFullscreen,
+        isFullscreen,
+        loop,
+        mediaMuted,
+        mediaVolume,
+        player,
+        requestFullscreen,
+        setMediaMuted,
+        setMediaVolume,
+        toggle,
+        scale,
+    ]);
+    const VideoComponent = video ? video.component : null;
+    const outerStyle = (0, react_1.useMemo)(() => {
+        return (0, calculate_scale_1.calculateOuterStyle)({ canvasSize, config, style });
+    }, [canvasSize, config, style]);
+    const outer = (0, react_1.useMemo)(() => {
+        return (0, calculate_scale_1.calculateOuter)({ config, layout, scale });
+    }, [config, layout, scale]);
+    const containerStyle = (0, react_1.useMemo)(() => {
+        return (0, calculate_scale_1.calculateContainerStyle)({ canvasSize, config, layout, scale });
+    }, [canvasSize, config, layout, scale]);
+    const onError = (0, react_1.useCallback)((error) => {
+        player.pause();
+        // Pay attention to `this context`
+        player.emitter.dispatchError(error);
+    }, [player]);
+    const onFullscreenButtonClick = (0, react_1.useCallback)((e) => {
+        e.stopPropagation();
+        requestFullscreen();
+    }, [requestFullscreen]);
+    const onExitFullscreenButtonClick = (0, react_1.useCallback)((e) => {
+        e.stopPropagation();
+        exitFullscreen();
+    }, [exitFullscreen]);
+    const onSingleClick = (0, react_1.useCallback)((e) => {
+        toggle(e);
+    }, [toggle]);
+    const onSeekStart = (0, react_1.useCallback)(() => {
+        setSeeking(true);
+    }, []);
+    const onSeekEnd = (0, react_1.useCallback)(() => {
+        setSeeking(false);
+    }, []);
+    const onDoubleClick = (0, react_1.useCallback)(() => {
+        if (isFullscreen) {
+            exitFullscreen();
+        }
+        else {
+            requestFullscreen();
+        }
+    }, [exitFullscreen, isFullscreen, requestFullscreen]);
+    const [handleClick, handleDoubleClick] = (0, use_click_prevention_on_double_click_1.useClickPreventionOnDoubleClick)(onSingleClick, onDoubleClick, doubleClickToFullscreen);
+    (0, react_1.useEffect)(() => {
+        if (shouldAutoplay) {
+            player.play();
+            setShouldAutoPlay(false);
+        }
+    }, [shouldAutoplay, player]);
+    const loadingMarkup = (0, react_1.useMemo)(() => {
+        return renderLoading
+            ? renderLoading({
+                height: outerStyle.height,
+                width: outerStyle.width,
+            })
+            : null;
+    }, [outerStyle.height, outerStyle.width, renderLoading]);
+    if (!config) {
+        return null;
+    }
+    const poster = renderPoster
+        ? renderPoster({
+            height: outerStyle.height,
+            width: outerStyle.width,
+        })
+        : null;
+    if (poster === undefined) {
+        throw new TypeError('renderPoster() must return a React element, but undefined was returned');
+    }
+    const shouldShowPoster = poster &&
+        [
+            showPosterWhenPaused && !player.isPlaying() && !seeking,
+            showPosterWhenEnded && player.isLastFrame && !player.isPlaying(),
+            showPosterWhenUnplayed && !player.hasPlayed && !player.isPlaying(),
+        ].some(Boolean);
+    const content = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("div", { style: outer, onClick: clickToPlay ? handleClick : undefined, onDoubleClick: doubleClickToFullscreen ? handleDoubleClick : undefined, children: (0, jsx_runtime_1.jsx)("div", { style: containerStyle, className: player_css_classname_1.PLAYER_CSS_CLASSNAME, children: VideoComponent ? ((0, jsx_runtime_1.jsx)(error_boundary_1.ErrorBoundary, { onError: onError, errorFallback: errorFallback, children: (0, jsx_runtime_1.jsx)(VideoComponent, { ...((_c = video === null || video === void 0 ? void 0 : video.defaultProps) !== null && _c !== void 0 ? _c : {}), ...((_d = inputProps) !== null && _d !== void 0 ? _d : {}) }) })) : null }) }), shouldShowPoster ? ((0, jsx_runtime_1.jsx)("div", { style: outer, onClick: clickToPlay ? handleClick : undefined, onDoubleClick: doubleClickToFullscreen ? handleDoubleClick : undefined, children: poster })) : null, controls ? ((0, jsx_runtime_1.jsx)(PlayerControls_1.Controls, { fps: config.fps, durationInFrames: config.durationInFrames, hovered: hovered, player: player, onFullscreenButtonClick: onFullscreenButtonClick, isFullscreen: isFullscreen, allowFullscreen: allowFullscreen, showVolumeControls: showVolumeControls, onExitFullscreenButtonClick: onExitFullscreenButtonClick, spaceKeyToPlayOrPause: spaceKeyToPlayOrPause, onSeekEnd: onSeekEnd, onSeekStart: onSeekStart, inFrame: inFrame, outFrame: outFrame, initiallyShowControls: initiallyShowControls, playerWidth: (_e = canvasSize === null || canvasSize === void 0 ? void 0 : canvasSize.width) !== null && _e !== void 0 ? _e : 0, renderFullscreenButton: renderFullscreenButton, renderPlayPauseButton: renderPlayPauseButton })) : null] }));
+    if (is_node_1.IS_NODE && !doesReactVersionSupportSuspense) {
+        return ((0, jsx_runtime_1.jsx)("div", { ref: container, style: outerStyle, className: className, children: content }));
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { ref: container, style: outerStyle, className: className, children: (0, jsx_runtime_1.jsx)(react_1.Suspense, { fallback: loadingMarkup, children: content }) }));
+};
+exports.default = (0, react_1.forwardRef)(PlayerUI);

package/dist/SharedPlayerContext.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentType, LazyExoticComponent } from 'react';
+import React from 'react';
+import type { TimelineContextValue } from 'remotion';
+export declare const SharedPlayerContexts: React.FC<{
+    children: React.ReactNode;
+    timelineContext: TimelineContextValue;
+    inputProps?: unknown;
+    fps: number;
+    compositionWidth: number;
+    compositionHeight: number;
+    durationInFrames: number;
+    component: LazyExoticComponent<ComponentType<unknown>>;
+    numberOfSharedAudioTags: number;
+}>;

package/dist/SharedPlayerContext.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedPlayerContexts = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const remotion_1 = require("remotion");
+const volume_persistance_1 = require("./volume-persistance");
+const SharedPlayerContexts = ({ children, timelineContext, inputProps, fps, compositionHeight, compositionWidth, durationInFrames, component, numberOfSharedAudioTags, }) => {
+    const compositionManagerContext = (0, react_1.useMemo)(() => {
+        return {
+            compositions: [
+                {
+                    component: component,
+                    durationInFrames,
+                    height: compositionHeight,
+                    width: compositionWidth,
+                    fps,
+                    id: 'player-comp',
+                    props: inputProps,
+                    nonce: 777,
+                    scale: 1,
+                    folderName: null,
+                    defaultProps: undefined,
+                    parentFolderName: null,
+                },
+            ],
+            folders: [],
+            registerFolder: () => undefined,
+            unregisterFolder: () => undefined,
+            currentComposition: 'player-comp',
+            registerComposition: () => undefined,
+            registerSequence: () => undefined,
+            sequences: [],
+            setCurrentComposition: () => undefined,
+            unregisterComposition: () => undefined,
+            unregisterSequence: () => undefined,
+            registerAsset: () => undefined,
+            unregisterAsset: () => undefined,
+            currentCompositionMetadata: null,
+            setCurrentCompositionMetadata: () => undefined,
+            assets: [],
+            setClipRegion: () => undefined,
+        };
+    }, [
+        component,
+        durationInFrames,
+        compositionHeight,
+        compositionWidth,
+        fps,
+        inputProps,
+    ]);
+    const [mediaMuted, setMediaMuted] = (0, react_1.useState)(false);
+    const [mediaVolume, setMediaVolume] = (0, react_1.useState)((0, volume_persistance_1.getPreferredVolume)());
+    const mediaVolumeContextValue = (0, react_1.useMemo)(() => {
+        return {
+            mediaMuted,
+            mediaVolume,
+        };
+    }, [mediaMuted, mediaVolume]);
+    const setMediaVolumeAndPersist = (0, react_1.useCallback)((vol) => {
+        setMediaVolume(vol);
+        (0, volume_persistance_1.persistVolume)(vol);
+    }, []);
+    const setMediaVolumeContextValue = (0, react_1.useMemo)(() => {
+        return {
+            setMediaMuted,
+            setMediaVolume: setMediaVolumeAndPersist,
+        };
+    }, [setMediaVolumeAndPersist]);
+    return ((0, jsx_runtime_1.jsx)(remotion_1.Internals.CanUseRemotionHooksProvider, { children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.Timeline.TimelineContext.Provider, { value: timelineContext, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.CompositionManager.Provider, { value: compositionManagerContext, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.PrefetchProvider, { children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.DurationsContextProvider, { children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.MediaVolumeContext.Provider, { value: mediaVolumeContextValue, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.SetMediaVolumeContext.Provider, { value: setMediaVolumeContextValue, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.SharedAudioContextProvider, { numberOfAudioTags: numberOfSharedAudioTags, children: children }) }) }) }) }) }) }) }));
+};
+exports.SharedPlayerContexts = SharedPlayerContexts;

package/dist/Thumbnail.d.ts

@@ -0,0 +1,20 @@
+import type { CSSProperties, MutableRefObject } from 'react';
+import type { CompProps } from 'remotion';
+import type { ThumbnailMethods } from './player-methods';
+import type { ErrorFallback, RenderLoading } from './PlayerUI';
+import type { PropsIfHasProps } from './utils/props-if-has-props';
+declare type ThumbnailProps<T> = PropsIfHasProps<T> & CompProps<T> & {
+    frameToDisplay: number;
+    style?: CSSProperties;
+    durationInFrames: number;
+    compositionWidth: number;
+    compositionHeight: number;
+    inputProps?: unknown;
+    fps: number;
+    errorFallback?: ErrorFallback;
+    renderLoading?: RenderLoading;
+    className?: string;
+};
+export declare const ThumbnailFn: <T>({ frameToDisplay, style, inputProps, compositionHeight, compositionWidth, durationInFrames, fps, className, errorFallback, renderLoading, ...componentProps }: ThumbnailProps<T>, ref: MutableRefObject<ThumbnailMethods>) => JSX.Element;
+export declare const Thumbnail: <T>(props: ThumbnailProps<T> & import("react").RefAttributes<ThumbnailMethods>) => React.ReactElement | null;
+export {};

package/dist/Thumbnail.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Thumbnail = exports.ThumbnailFn = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const remotion_1 = require("remotion");
+const emitter_context_1 = require("./emitter-context");
+const event_emitter_1 = require("./event-emitter");
+const SharedPlayerContext_1 = require("./SharedPlayerContext");
+const ThumbnailUI_1 = __importDefault(require("./ThumbnailUI"));
+const ThumbnailFn = ({ frameToDisplay, style, inputProps, compositionHeight, compositionWidth, durationInFrames, fps, className, errorFallback = () => '⚠️', renderLoading, ...componentProps }, ref) => {
+    const [thumbnailId] = (0, react_1.useState)(() => String((0, remotion_1.random)(null)));
+    const rootRef = (0, react_1.useRef)(null);
+    const timelineState = (0, react_1.useMemo)(() => {
+        return {
+            playing: false,
+            frame: frameToDisplay,
+            rootId: thumbnailId,
+            imperativePlaying: {
+                current: false,
+            },
+            playbackRate: 1,
+            setPlaybackRate: () => {
+                throw new Error('thumbnail');
+            },
+            audioAndVideoTags: { current: [] },
+        };
+    }, [frameToDisplay, thumbnailId]);
+    (0, react_1.useImperativeHandle)(ref, () => rootRef.current, []);
+    const Component = remotion_1.Internals.useLazyComponent(componentProps);
+    const [emitter] = (0, react_1.useState)(() => new event_emitter_1.ThumbnailEmitter());
+    const passedInputProps = (0, react_1.useMemo)(() => {
+        return inputProps !== null && inputProps !== void 0 ? inputProps : {};
+    }, [inputProps]);
+    return ((0, jsx_runtime_1.jsx)(SharedPlayerContext_1.SharedPlayerContexts, { timelineContext: timelineState, component: Component, compositionHeight: compositionHeight, compositionWidth: compositionWidth, durationInFrames: durationInFrames, fps: fps, inputProps: inputProps, numberOfSharedAudioTags: 0, children: (0, jsx_runtime_1.jsx)(emitter_context_1.ThumbnailEmitterContext.Provider, { value: emitter, children: (0, jsx_runtime_1.jsx)(ThumbnailUI_1.default, { className: className, errorFallback: errorFallback, inputProps: passedInputProps, renderLoading: renderLoading, style: style }) }) }));
+};
+exports.ThumbnailFn = ThumbnailFn;
+const forward = react_1.forwardRef;
+exports.Thumbnail = forward(exports.ThumbnailFn);

package/dist/ThumbnailUI.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ThumbnailMethods } from './player-methods';
+import type { ErrorFallback, RenderLoading } from './PlayerUI';
+declare const _default: React.ForwardRefExoticComponent<{
+    inputProps: unknown;
+    style?: React.CSSProperties | undefined;
+    errorFallback: ErrorFallback;
+    renderLoading: RenderLoading | undefined;
+    className: string | undefined;
+} & React.RefAttributes<ThumbnailMethods>>;
+export default _default;

package/dist/ThumbnailUI.js

@@ -0,0 +1,107 @@
+"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 });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const remotion_1 = require("remotion");
+const calculate_scale_1 = require("./calculate-scale");
+const error_boundary_1 = require("./error-boundary");
+const player_css_classname_1 = require("./player-css-classname");
+const use_thumbnail_1 = require("./use-thumbnail");
+const is_node_1 = require("./utils/is-node");
+const use_element_size_1 = require("./utils/use-element-size");
+const reactVersion = react_1.default.version.split('.')[0];
+if (reactVersion === '0') {
+    throw new Error(`Version ${reactVersion} of "react" is not supported by Remotion`);
+}
+const doesReactVersionSupportSuspense = parseInt(reactVersion, 10) >= 18;
+const ThumbnailUI = ({ style, inputProps, errorFallback, renderLoading, className }, ref) => {
+    var _a, _b, _c;
+    const config = remotion_1.Internals.useUnsafeVideoConfig();
+    const video = remotion_1.Internals.useVideo();
+    const container = (0, react_1.useRef)(null);
+    const canvasSize = (0, use_element_size_1.useElementSize)(container, {
+        triggerOnWindowResize: false,
+        shouldApplyCssTransforms: false,
+    });
+    const layout = (0, react_1.useMemo)(() => {
+        if (!config || !canvasSize) {
+            return null;
+        }
+        return (0, calculate_scale_1.calculateCanvasTransformation)({
+            canvasSize,
+            compositionHeight: config.height,
+            compositionWidth: config.width,
+            previewSize: 'auto',
+        });
+    }, [canvasSize, config]);
+    const scale = (_a = layout === null || layout === void 0 ? void 0 : layout.scale) !== null && _a !== void 0 ? _a : 1;
+    const thumbnail = (0, use_thumbnail_1.useThumbnail)();
+    (0, react_1.useImperativeHandle)(ref, () => {
+        const methods = {
+            getContainerNode: () => container.current,
+            getScale: () => scale,
+        };
+        return Object.assign(thumbnail.emitter, methods);
+    }, [scale, thumbnail.emitter]);
+    const VideoComponent = video ? video.component : null;
+    const outerStyle = (0, react_1.useMemo)(() => {
+        return (0, calculate_scale_1.calculateOuterStyle)({ config, style, canvasSize });
+    }, [canvasSize, config, style]);
+    const outer = (0, react_1.useMemo)(() => {
+        return (0, calculate_scale_1.calculateOuter)({ config, layout, scale });
+    }, [config, layout, scale]);
+    const containerStyle = (0, react_1.useMemo)(() => {
+        return (0, calculate_scale_1.calculateContainerStyle)({
+            canvasSize,
+            config,
+            layout,
+            scale,
+        });
+    }, [canvasSize, config, layout, scale]);
+    const onError = (0, react_1.useCallback)((error) => {
+        // Pay attention to `this context`
+        thumbnail.emitter.dispatchError(error);
+    }, [thumbnail.emitter]);
+    const rootRef = (0, react_1.useRef)(null);
+    (0, react_1.useImperativeHandle)(ref, () => rootRef.current, []);
+    const loadingMarkup = (0, react_1.useMemo)(() => {
+        return renderLoading
+            ? renderLoading({
+                height: outerStyle.height,
+                width: outerStyle.width,
+            })
+            : null;
+    }, [outerStyle.height, outerStyle.width, renderLoading]);
+    if (!config) {
+        return null;
+    }
+    const content = ((0, jsx_runtime_1.jsx)("div", { style: outer, children: (0, jsx_runtime_1.jsx)("div", { style: containerStyle, className: player_css_classname_1.PLAYER_CSS_CLASSNAME, children: VideoComponent ? ((0, jsx_runtime_1.jsx)(error_boundary_1.ErrorBoundary, { onError: onError, errorFallback: errorFallback, children: (0, jsx_runtime_1.jsx)(VideoComponent, { ...((_b = video === null || video === void 0 ? void 0 : video.defaultProps) !== null && _b !== void 0 ? _b : {}), ...((_c = inputProps) !== null && _c !== void 0 ? _c : {}) }) })) : null }) }));
+    if (is_node_1.IS_NODE && !doesReactVersionSupportSuspense) {
+        return ((0, jsx_runtime_1.jsx)("div", { ref: container, style: outerStyle, className: className, children: content }));
+    }
+    return ((0, jsx_runtime_1.jsx)("div", { ref: container, style: outerStyle, className: className, children: (0, jsx_runtime_1.jsx)(react_1.Suspense, { fallback: loadingMarkup, children: content }) }));
+};
+exports.default = (0, react_1.forwardRef)(ThumbnailUI);

package/dist/calculate-next-frame.d.ts

@@ -0,0 +1,14 @@
+export declare const calculateNextFrame: ({ time, currentFrame: startFrame, playbackSpeed, fps, actualLastFrame, actualFirstFrame, framesAdvanced, shouldLoop, }: {
+    time: number;
+    currentFrame: number;
+    playbackSpeed: number;
+    fps: number;
+    actualFirstFrame: number;
+    actualLastFrame: number;
+    framesAdvanced: number;
+    shouldLoop: boolean;
+}) => {
+    nextFrame: number;
+    framesToAdvance: number;
+    hasEnded: boolean;
+};

package/dist/calculate-next-frame.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateNextFrame = void 0;
+const calculateNextFrame = ({ time, currentFrame: startFrame, playbackSpeed, fps, actualLastFrame, actualFirstFrame, framesAdvanced, shouldLoop, }) => {
+    const op = playbackSpeed < 0 ? Math.ceil : Math.floor;
+    const framesToAdvance = op((time * playbackSpeed) / (1000 / fps)) - framesAdvanced;
+    const nextFrame = framesToAdvance + startFrame;
+    const isCurrentFrameOutside = startFrame > actualLastFrame || startFrame < actualFirstFrame;
+    const isNextFrameOutside = nextFrame > actualLastFrame || nextFrame < actualFirstFrame;
+    const hasEnded = !shouldLoop && isNextFrameOutside && !isCurrentFrameOutside;
+    if (playbackSpeed > 0) {
+        // Play forwards
+        if (isNextFrameOutside) {
+            return {
+                nextFrame: actualFirstFrame,
+                framesToAdvance,
+                hasEnded,
+            };
+        }
+        return { nextFrame, framesToAdvance, hasEnded };
+    }
+    // Reverse playback
+    if (isNextFrameOutside) {
+        return { nextFrame: actualLastFrame, framesToAdvance, hasEnded };
+    }
+    return { nextFrame, framesToAdvance, hasEnded };
+};
+exports.calculateNextFrame = calculateNextFrame;