@remotion/player 3.2.40 → 3.2.42

package/LICENSE.md

@@ -36,6 +36,6 @@ Support is provided on a best-we-can-do basis via GitHub Issues and Discord.
 
 ## Company license
 
-You are required to obtain a company license to use Remotion if you are not within the group of entities eligible for a free license. This license will enable you to use Remotion for the allowed use cases specified in the free license, and give you access to prioritized support.
+You are required to obtain a company license to use Remotion if you are not within the group of entities eligible for a free license. This license will enable you to use Remotion for the allowed use cases specified in the free license, and give you access to prioritized support (read the [Support Policy](/docs/support)).
 
 Visit [companies.remotion.dev](https://companies.remotion.dev) for pricing and to buy a license.

package/README.md

@@ -83,4 +83,4 @@ The most important props accepted:
 | compositionWidth  | The width of the composition in pixels   |
 | fps               | The frame rate of the video              |
 
-For a complete reference of the available props, refer to [@remotion/player API](https://www.remotion.dev/docs/player/api).
+For a complete reference of the available props, refer to [@remotion/player API](https://www.remotion.dev/docs/player/player).

package/dist/Player.d.ts

@@ -1,14 +1,10 @@
-import type { ComponentType, MutableRefObject } from 'react';
+import type { ComponentType } from 'react';
 import React from 'react';
 import type { CompProps } from 'remotion';
 import type { PlayerRef } from './player-methods';
 import type { RenderFullscreenButton, RenderPlayPauseButton } from './PlayerControls';
 import type { RenderLoading, RenderPoster } from './PlayerUI';
-declare type PropsIfHasProps<Props> = {} extends Props ? {
-    inputProps?: Props;
-} : {
-    inputProps: Props;
-};
+import type { PropsIfHasProps } from './utils/props-if-has-props';
 export declare type ErrorFallback = (info: {
     error: Error;
 }) => React.ReactNode;
@@ -44,9 +40,7 @@ export declare type PlayerProps<T> = {
     renderFullscreenButton?: RenderFullscreenButton;
 } & PropsIfHasProps<T> & CompProps<T>;
 export declare const componentOrNullIfLazy: <T>(props: CompProps<T>) => ComponentType<T> | null;
-export declare const PlayerFn: <T>({ durationInFrames, compositionHeight, compositionWidth, fps, inputProps, style, controls, loop, autoPlay, showVolumeControls, allowFullscreen, clickToPlay, doubleClickToFullscreen, spaceKeyToPlayOrPause, moveToBeginningWhenEnded, numberOfSharedAudioTags, errorFallback, playbackRate, renderLoading, className, showPosterWhenUnplayed, showPosterWhenEnded, showPosterWhenPaused, initialFrame, renderPoster, inFrame, outFrame, initiallyShowControls, renderFullscreenButton, renderPlayPauseButton, ...componentProps }: PlayerProps<T>, ref: MutableRefObject<PlayerRef>) => JSX.Element;
 declare module 'react' {
     function forwardRef<T, P = {}>(render: (props: P, ref: React.MutableRefObject<T>) => React.ReactElement | null): (props: P & React.RefAttributes<T>) => React.ReactElement | null;
 }
-export declare const Player: <T>(props: PlayerProps<T> & React.RefAttributes<PlayerRef>) => React.ReactElement | null;
-export {};
+export declare const Player: <T>(props: PlayerProps<T> & React.RefAttributes<PlayerRef>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;

package/dist/Player.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Player = exports.PlayerFn = exports.componentOrNullIfLazy = void 0;
+exports.Player = exports.componentOrNullIfLazy = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const remotion_1 = require("remotion");
@@ -11,10 +11,10 @@ const emitter_context_1 = require("./emitter-context");
 const event_emitter_1 = require("./event-emitter");
 const player_css_classname_1 = require("./player-css-classname");
 const PlayerUI_1 = __importDefault(require("./PlayerUI"));
+const SharedPlayerContext_1 = require("./SharedPlayerContext");
 const validate_in_out_frame_1 = require("./utils/validate-in-out-frame");
 const validate_initial_frame_1 = require("./utils/validate-initial-frame");
 const validate_playbackrate_1 = require("./utils/validate-playbackrate");
-const volume_persistance_1 = require("./volume-persistance");
 const componentOrNullIfLazy = (props) => {
     if ('component' in props) {
         return props.component;
@@ -48,8 +48,6 @@ const PlayerFn = ({ durationInFrames, compositionHeight, compositionWidth, fps,
     const [rootId] = (0, react_1.useState)('player-comp');
     const [emitter] = (0, react_1.useState)(() => new event_emitter_1.PlayerEmitter());
     const rootRef = (0, react_1.useRef)(null);
-    const [mediaMuted, setMediaMuted] = (0, react_1.useState)(false);
-    const [mediaVolume, setMediaVolume] = (0, react_1.useState)((0, volume_persistance_1.getPreferredVolume)());
     const audioAndVideoTags = (0, react_1.useRef)([]);
     const imperativePlaying = (0, react_1.useRef)(false);
     if (typeof compositionHeight !== 'number') {
@@ -106,10 +104,6 @@ const PlayerFn = ({ durationInFrames, compositionHeight, compositionWidth, fps,
     (0, react_1.useEffect)(() => {
         emitter.dispatchRatechange(playbackRate);
     }, [emitter, playbackRate]);
-    const setMediaVolumeAndPersist = (0, react_1.useCallback)((vol) => {
-        setMediaVolume(vol);
-        (0, volume_persistance_1.persistVolume)(vol);
-    }, []);
     (0, react_1.useImperativeHandle)(ref, () => rootRef.current, []);
     const timelineContextValue = (0, react_1.useMemo)(() => {
         return {
@@ -131,60 +125,6 @@ const PlayerFn = ({ durationInFrames, compositionHeight, compositionWidth, fps,
             setPlaying,
         };
     }, [setFrame]);
-    const mediaVolumeContextValue = (0, react_1.useMemo)(() => {
-        return {
-            mediaMuted,
-            mediaVolume,
-        };
-    }, [mediaMuted, mediaVolume]);
-    const setMediaVolumeContextValue = (0, react_1.useMemo)(() => {
-        return {
-            setMediaMuted,
-            setMediaVolume: setMediaVolumeAndPersist,
-        };
-    }, [setMediaVolumeAndPersist]);
-    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: [],
-        };
-    }, [
-        component,
-        durationInFrames,
-        compositionHeight,
-        compositionWidth,
-        fps,
-        inputProps,
-    ]);
     const passedInputProps = (0, react_1.useMemo)(() => {
         return inputProps !== null && inputProps !== void 0 ? inputProps : {};
     }, [inputProps]);
@@ -195,9 +135,6 @@ const PlayerFn = ({ durationInFrames, compositionHeight, compositionWidth, fps,
             remotion_1.Internals.CSSUtils.injectCSS(remotion_1.Internals.CSSUtils.makeDefaultCSS(`.${player_css_classname_1.PLAYER_CSS_CLASSNAME}`, '#fff'));
         }, []);
     }
-    return ((0, jsx_runtime_1.jsx)(remotion_1.Internals.CanUseRemotionHooksProvider, { children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.Timeline.TimelineContext.Provider, { value: timelineContextValue, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.Timeline.SetTimelineContext.Provider, { value: setTimelineContextValue, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.CompositionManager.Provider, { value: compositionManagerContext, 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: (0, jsx_runtime_1.jsx)(emitter_context_1.PlayerEventEmitterContext.Provider, { value: emitter, 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)(PlayerUI_1.default, { ref: rootRef, renderLoading: renderLoading, autoPlay: Boolean(autoPlay), loop: Boolean(loop), controls: Boolean(controls), errorFallback: errorFallback, style: style, inputProps: passedInputProps, allowFullscreen: Boolean(allowFullscreen), moveToBeginningWhenEnded: Boolean(moveToBeginningWhenEnded), clickToPlay: typeof clickToPlay === 'boolean'
-                                                    ? clickToPlay
-                                                    : Boolean(controls), showVolumeControls: Boolean(showVolumeControls), setMediaVolume: setMediaVolumeAndPersist, mediaVolume: mediaVolume, mediaMuted: mediaMuted, doubleClickToFullscreen: Boolean(doubleClickToFullscreen), setMediaMuted: setMediaMuted, spaceKeyToPlayOrPause: Boolean(spaceKeyToPlayOrPause), playbackRate: playbackRate, className: className !== null && className !== void 0 ? className : undefined, showPosterWhenUnplayed: Boolean(showPosterWhenUnplayed), showPosterWhenEnded: Boolean(showPosterWhenEnded), showPosterWhenPaused: Boolean(showPosterWhenPaused), renderPoster: renderPoster, inFrame: inFrame !== null && inFrame !== void 0 ? inFrame : null, outFrame: outFrame !== null && outFrame !== void 0 ? outFrame : null, initiallyShowControls: initiallyShowControls !== null && initiallyShowControls !== void 0 ? initiallyShowControls : true, renderFullscreen: renderFullscreenButton !== null && renderFullscreenButton !== void 0 ? renderFullscreenButton : null, renderPlayPauseButton: renderPlayPauseButton !== null && renderPlayPauseButton !== void 0 ? renderPlayPauseButton : null }) }) }) }) }) }) }) }) }) }) }));
+    return ((0, jsx_runtime_1.jsx)(SharedPlayerContext_1.SharedPlayerContexts, { timelineContext: timelineContextValue, component: component, compositionHeight: compositionHeight, compositionWidth: compositionWidth, durationInFrames: durationInFrames, fps: fps, inputProps: inputProps, numberOfSharedAudioTags: numberOfSharedAudioTags, children: (0, jsx_runtime_1.jsx)(remotion_1.Internals.Timeline.SetTimelineContext.Provider, { value: setTimelineContextValue, children: (0, jsx_runtime_1.jsx)(emitter_context_1.PlayerEventEmitterContext.Provider, { value: emitter, children: (0, jsx_runtime_1.jsx)(PlayerUI_1.default, { ref: rootRef, renderLoading: renderLoading, autoPlay: Boolean(autoPlay), loop: Boolean(loop), controls: Boolean(controls), errorFallback: errorFallback, style: style, inputProps: passedInputProps, allowFullscreen: Boolean(allowFullscreen), moveToBeginningWhenEnded: Boolean(moveToBeginningWhenEnded), clickToPlay: typeof clickToPlay === 'boolean' ? clickToPlay : Boolean(controls), showVolumeControls: Boolean(showVolumeControls), doubleClickToFullscreen: Boolean(doubleClickToFullscreen), spaceKeyToPlayOrPause: Boolean(spaceKeyToPlayOrPause), playbackRate: playbackRate, className: className !== null && className !== void 0 ? className : undefined, showPosterWhenUnplayed: Boolean(showPosterWhenUnplayed), showPosterWhenEnded: Boolean(showPosterWhenEnded), showPosterWhenPaused: Boolean(showPosterWhenPaused), renderPoster: renderPoster, inFrame: inFrame !== null && inFrame !== void 0 ? inFrame : null, outFrame: outFrame !== null && outFrame !== void 0 ? outFrame : null, initiallyShowControls: initiallyShowControls !== null && initiallyShowControls !== void 0 ? initiallyShowControls : true, renderFullscreen: renderFullscreenButton !== null && renderFullscreenButton !== void 0 ? renderFullscreenButton : null, renderPlayPauseButton: renderPlayPauseButton !== null && renderPlayPauseButton !== void 0 ? renderPlayPauseButton : null }) }) }) }));
 };
-exports.PlayerFn = PlayerFn;
-exports.Player = (0, react_1.forwardRef)(exports.PlayerFn);
+exports.Player = (0, react_1.forwardRef)(PlayerFn);

package/dist/PlayerUI.d.ts

@@ -7,7 +7,7 @@ export declare type ErrorFallback = (info: {
 export declare type RenderLoading = (canvas: {
     height: number;
     width: number;
-}) => React.ReactChild;
+}) => React.ReactNode;
 export declare type RenderPoster = RenderLoading;
 declare const _default: (props: {
     controls: boolean;
@@ -16,14 +16,10 @@ declare const _default: (props: {
     allowFullscreen: boolean;
     inputProps: unknown;
     showVolumeControls: boolean;
-    mediaMuted: boolean;
     style?: React.CSSProperties | undefined;
     clickToPlay: boolean;
     doubleClickToFullscreen: boolean;
     spaceKeyToPlayOrPause: boolean;
-    setMediaVolume: (v: number) => void;
-    setMediaMuted: (v: boolean) => void;
-    mediaVolume: number;
     errorFallback: ErrorFallback;
     playbackRate: number;
     renderLoading: RenderLoading | undefined;

package/dist/PlayerUI.js

@@ -33,7 +33,6 @@ 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 calculate_player_size_1 = require("./utils/calculate-player-size");
 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");
@@ -42,7 +41,7 @@ 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, mediaVolume, mediaMuted, doubleClickToFullscreen, setMediaMuted, setMediaVolume, spaceKeyToPlayOrPause, errorFallback, playbackRate, renderLoading, renderPoster, className, moveToBeginningWhenEnded, showPosterWhenUnplayed, showPosterWhenEnded, showPosterWhenPaused, inFrame, outFrame, initiallyShowControls, renderFullscreen: renderFullscreenButton, renderPlayPauseButton, }, ref) => {
+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();
@@ -159,6 +158,8 @@ const PlayerUI = ({ controls, style, loop, autoPlay, allowFullscreen, inputProps
         });
     }, [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,
@@ -227,52 +228,13 @@ const PlayerUI = ({ controls, style, loop, autoPlay, allowFullscreen, inputProps
     ]);
     const VideoComponent = video ? video.component : null;
     const outerStyle = (0, react_1.useMemo)(() => {
-        if (!config) {
-            return {};
-        }
-        return {
-            position: 'relative',
-            overflow: 'hidden',
-            ...(0, calculate_player_size_1.calculatePlayerSize)({
-                compositionHeight: config.height,
-                compositionWidth: config.width,
-                currentSize: canvasSize,
-                height: style === null || style === void 0 ? void 0 : style.height,
-                width: style === null || style === void 0 ? void 0 : style.width,
-            }),
-            ...style,
-        };
+        return (0, calculate_scale_1.calculateOuterStyle)({ canvasSize, config, style });
     }, [canvasSize, config, style]);
     const outer = (0, react_1.useMemo)(() => {
-        if (!layout || !config) {
-            return {};
-        }
-        const { centerX, centerY } = layout;
-        return {
-            width: config.width * scale,
-            height: config.height * scale,
-            display: 'flex',
-            flexDirection: 'column',
-            position: 'absolute',
-            left: centerX,
-            top: centerY,
-            overflow: 'hidden',
-        };
+        return (0, calculate_scale_1.calculateOuter)({ config, layout, scale });
     }, [config, layout, scale]);
     const containerStyle = (0, react_1.useMemo)(() => {
-        if (!config || !canvasSize || !layout) {
-            return {};
-        }
-        return {
-            position: 'absolute',
-            width: config.width,
-            height: config.height,
-            display: 'flex',
-            transform: `scale(${scale})`,
-            marginLeft: layout.xCorrection,
-            marginTop: layout.yCorrection,
-            overflow: 'hidden',
-        };
+        return (0, calculate_scale_1.calculateContainerStyle)({ canvasSize, config, layout, scale });
     }, [canvasSize, config, layout, scale]);
     const onError = (0, react_1.useCallback)((error) => {
         player.pause();
@@ -311,6 +273,14 @@ const PlayerUI = ({ controls, style, loop, autoPlay, allowFullscreen, inputProps
             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;
     }
@@ -333,12 +303,6 @@ const PlayerUI = ({ controls, style, loop, autoPlay, allowFullscreen, inputProps
     if (is_node_1.IS_NODE && !doesReactVersionSupportSuspense) {
         return ((0, jsx_runtime_1.jsx)("div", { ref: container, style: outerStyle, className: className, children: content }));
     }
-    const loadingMarkup = renderLoading
-        ? renderLoading({
-            height: outerStyle.height,
-            width: outerStyle.width,
-        })
-        : null;
     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,71 @@
+"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: [],
+        };
+    }, [
+        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,23 @@
+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;
+declare module 'react' {
+    function forwardRef<T, P = {}>(render: (props: P, ref: React.MutableRefObject<T>) => React.ReactElement | null): (props: P & React.RefAttributes<T>) => React.ReactElement | null;
+}
+export declare const Thumbnail: <T>(props: ThumbnailProps<T> & import("react").RefAttributes<ThumbnailMethods>) => React.ReactElement | null;
+export {};

package/dist/Thumbnail.js

@@ -0,0 +1,41 @@
+"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;
+exports.Thumbnail = (0, react_1.forwardRef)(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: (props: {
+    inputProps: unknown;
+    style?: React.CSSProperties | undefined;
+    errorFallback: ErrorFallback;
+    renderLoading: RenderLoading | undefined;
+    className: string | undefined;
+} & React.RefAttributes<ThumbnailMethods | null>) => React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
+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/calc-style.d.ts

@@ -0,0 +1,7 @@
+import type { VideoConfig } from 'remotion';
+import type { Size } from './utils/use-element-size';
+export declare const calculateOuterStyle: ({ config, style, canvasSize, }: {
+    config: VideoConfig | null;
+    style: React.CSSProperties | undefined;
+    canvasSize: Size | null;
+}) => React.CSSProperties;

package/dist/calc-style.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateOuterStyle = void 0;
+const calculate_player_size_1 = require("./utils/calculate-player-size");
+const calculateOuterStyle = ({ config, style, canvasSize, }) => {
+    if (!config) {
+        return {};
+    }
+    return {
+        position: 'relative',
+        overflow: 'hidden',
+        ...(0, calculate_player_size_1.calculatePlayerSize)({
+            compositionHeight: config.height,
+            compositionWidth: config.width,
+            currentSize: canvasSize,
+            height: style === null || style === void 0 ? void 0 : style.height,
+            width: style === null || style === void 0 ? void 0 : style.width,
+        }),
+        ...style,
+    };
+};
+exports.calculateOuterStyle = calculateOuterStyle;

package/dist/calculate-scale.d.ts

@@ -1,3 +1,4 @@
+import type { VideoConfig } from 'remotion';
 import type { PreviewSize } from './utils/preview-size';
 import type { Size } from './utils/use-element-size';
 export declare const calculateScale: ({ canvasSize, compositionHeight, compositionWidth, previewSize, }: {
@@ -6,15 +7,33 @@ export declare const calculateScale: ({ canvasSize, compositionHeight, compositi
     compositionHeight: number;
     canvasSize: Size;
 }) => number;
-export declare const calculateCanvasTransformation: ({ previewSize, compositionWidth, compositionHeight, canvasSize, }: {
-    previewSize: PreviewSize['size'];
-    compositionWidth: number;
-    compositionHeight: number;
-    canvasSize: Size;
-}) => {
+declare type Layout = {
     centerX: number;
     centerY: number;
     xCorrection: number;
     yCorrection: number;
     scale: number;
 };
+export declare const calculateCanvasTransformation: ({ previewSize, compositionWidth, compositionHeight, canvasSize, }: {
+    previewSize: PreviewSize['size'];
+    compositionWidth: number;
+    compositionHeight: number;
+    canvasSize: Size;
+}) => Layout;
+export declare const calculateOuterStyle: ({ config, style, canvasSize, }: {
+    config: VideoConfig | null;
+    style: React.CSSProperties | undefined;
+    canvasSize: Size | null;
+}) => React.CSSProperties;
+export declare const calculateContainerStyle: ({ config, canvasSize, layout, scale, }: {
+    config: VideoConfig | null;
+    canvasSize: Size | null;
+    layout: Layout | null;
+    scale: number;
+}) => React.CSSProperties;
+export declare const calculateOuter: ({ layout, scale, config, }: {
+    layout: Layout | null;
+    scale: number;
+    config: VideoConfig | null;
+}) => React.CSSProperties;
+export {};

package/dist/calculate-scale.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.calculateCanvasTransformation = exports.calculateScale = void 0;
+exports.calculateOuter = exports.calculateContainerStyle = exports.calculateOuterStyle = exports.calculateCanvasTransformation = exports.calculateScale = void 0;
+const calculate_player_size_1 = require("./utils/calculate-player-size");
 const calculateScale = ({ canvasSize, compositionHeight, compositionWidth, previewSize, }) => {
     const heightRatio = canvasSize.height / compositionHeight;
     const widthRatio = canvasSize.width / compositionWidth;
@@ -31,3 +32,54 @@ const calculateCanvasTransformation = ({ previewSize, compositionWidth, composit
     };
 };
 exports.calculateCanvasTransformation = calculateCanvasTransformation;
+const calculateOuterStyle = ({ config, style, canvasSize, }) => {
+    if (!config) {
+        return {};
+    }
+    return {
+        position: 'relative',
+        overflow: 'hidden',
+        ...(0, calculate_player_size_1.calculatePlayerSize)({
+            compositionHeight: config.height,
+            compositionWidth: config.width,
+            currentSize: canvasSize,
+            height: style === null || style === void 0 ? void 0 : style.height,
+            width: style === null || style === void 0 ? void 0 : style.width,
+        }),
+        ...style,
+    };
+};
+exports.calculateOuterStyle = calculateOuterStyle;
+const calculateContainerStyle = ({ config, canvasSize, layout, scale, }) => {
+    if (!config || !canvasSize || !layout) {
+        return {};
+    }
+    return {
+        position: 'absolute',
+        width: config.width,
+        height: config.height,
+        display: 'flex',
+        transform: `scale(${scale})`,
+        marginLeft: layout.xCorrection,
+        marginTop: layout.yCorrection,
+        overflow: 'hidden',
+    };
+};
+exports.calculateContainerStyle = calculateContainerStyle;
+const calculateOuter = ({ layout, scale, config, }) => {
+    if (!layout || !config) {
+        return {};
+    }
+    const { centerX, centerY } = layout;
+    return {
+        width: config.width * scale,
+        height: config.height * scale,
+        display: 'flex',
+        flexDirection: 'column',
+        position: 'absolute',
+        left: centerX,
+        top: centerY,
+        overflow: 'hidden',
+    };
+};
+exports.calculateOuter = calculateOuter;

package/dist/calculate-style.d.ts

@@ -0,0 +1,19 @@
+import type React from 'react';
+import type { VideoConfig } from 'remotion';
+import type { Size } from './utils/use-element-size';
+export declare const calculateOuterStyle: ({ config, style, canvasSize, }: {
+    config: VideoConfig | null;
+    style: React.CSSProperties | undefined;
+    canvasSize: Size | null;
+}) => React.CSSProperties;
+export declare const calculateContainerStyle: ({ config, canvasSize, layout, scale, }: {
+    config: VideoConfig | null;
+    canvasSize: Size | null;
+    layout: unknown;
+    scale: number;
+}) => React.CSSProperties;
+export declare const calculateOuter: ({ layout, scale, config, }: {
+    layout: unknown;
+    scale: number;
+    config: VideoConfig | null;
+}) => React.CSSProperties;

package/dist/calculate-style.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateOuter = exports.calculateContainerStyle = exports.calculateOuterStyle = void 0;
+const calculate_player_size_1 = require("./utils/calculate-player-size");
+const calculateOuterStyle = ({ config, style, canvasSize, }) => {
+    if (!config) {
+        return {};
+    }
+    return {
+        position: 'relative',
+        overflow: 'hidden',
+        ...(0, calculate_player_size_1.calculatePlayerSize)({
+            compositionHeight: config.height,
+            compositionWidth: config.width,
+            currentSize: canvasSize,
+            height: style === null || style === void 0 ? void 0 : style.height,
+            width: style === null || style === void 0 ? void 0 : style.width,
+        }),
+        ...style,
+    };
+};
+exports.calculateOuterStyle = calculateOuterStyle;
+const calculateContainerStyle = ({ config, canvasSize, layout, scale, }) => {
+    if (!config || !canvasSize || !layout) {
+        return {};
+    }
+    return {
+        position: 'absolute',
+        width: config.width,
+        height: config.height,
+        display: 'flex',
+        transform: `scale(${scale})`,
+        marginLeft: layout.xCorrection,
+        marginTop: layout.yCorrection,
+        overflow: 'hidden',
+    };
+};
+exports.calculateContainerStyle = calculateContainerStyle;
+const calculateOuter = ({ layout, scale, config, }) => {
+    if (!layout || !config) {
+        return {};
+    }
+    const { centerX, centerY } = layout;
+    return {
+        width: config.width * scale,
+        height: config.height * scale,
+        display: 'flex',
+        flexDirection: 'column',
+        position: 'absolute',
+        left: centerX,
+        top: centerY,
+        overflow: 'hidden',
+    };
+};
+exports.calculateOuter = calculateOuter;

package/dist/emitter-context.d.ts

@@ -1,3 +1,4 @@
 import React from 'react';
-import type { PlayerEmitter } from './event-emitter';
+import type { PlayerEmitter, ThumbnailEmitter } from './event-emitter';
 export declare const PlayerEventEmitterContext: React.Context<PlayerEmitter | undefined>;
+export declare const ThumbnailEmitterContext: React.Context<ThumbnailEmitter | undefined>;

package/dist/emitter-context.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlayerEventEmitterContext = void 0;
+exports.ThumbnailEmitterContext = exports.PlayerEventEmitterContext = void 0;
 const react_1 = __importDefault(require("react"));
 exports.PlayerEventEmitterContext = react_1.default.createContext(undefined);
+exports.ThumbnailEmitterContext = react_1.default.createContext(undefined);

package/dist/event-emitter.d.ts

@@ -16,7 +16,7 @@ declare type RateChangeEventPayload = {
 declare type FullscreenChangeEventPayload = {
     isFullscreen: boolean;
 };
-declare type StateEventMap = {
+declare type PlayerStateEventMap = {
     seeked: SeekPayload;
     pause: undefined;
     play: undefined;
@@ -27,17 +27,24 @@ declare type StateEventMap = {
     frameupdate: FrameUpdateEventPayload;
     fullscreenchange: FullscreenChangeEventPayload;
 };
-export declare type EventTypes = keyof StateEventMap;
-export declare type CallbackListener<T extends EventTypes> = (data: {
-    detail: StateEventMap[T];
+declare type ThumbnailStateEventMap = {
+    error: ErrorPayload;
+};
+export declare type PlayerEventTypes = keyof PlayerStateEventMap;
+export declare type ThumbnailEventTypes = keyof ThumbnailStateEventMap;
+export declare type CallbackListener<T extends PlayerEventTypes> = (data: {
+    detail: PlayerStateEventMap[T];
 }) => void;
-declare type Listeners = {
-    [EventType in EventTypes]: CallbackListener<EventType>[];
+declare type PlayerListeners = {
+    [EventType in PlayerEventTypes]: CallbackListener<EventType>[];
+};
+declare type ThumbnailListeners = {
+    [EventType in ThumbnailEventTypes]: CallbackListener<EventType>[];
 };
 export declare class PlayerEmitter {
-    listeners: Listeners;
-    addEventListener<Q extends EventTypes>(name: Q, callback: CallbackListener<Q>): void;
-    removeEventListener<Q extends EventTypes>(name: Q, callback: CallbackListener<Q>): void;
+    listeners: PlayerListeners;
+    addEventListener<Q extends PlayerEventTypes>(name: Q, callback: CallbackListener<Q>): void;
+    removeEventListener<Q extends PlayerEventTypes>(name: Q, callback: CallbackListener<Q>): void;
     private dispatchEvent;
     dispatchSeek(frame: number): void;
     dispatchPause(): void;
@@ -49,4 +56,11 @@ export declare class PlayerEmitter {
     dispatchFrameUpdate(event: FrameUpdateEventPayload): void;
     dispatchFullscreenChangeUpdate(event: FullscreenChangeEventPayload): void;
 }
+export declare class ThumbnailEmitter {
+    listeners: ThumbnailListeners;
+    addEventListener<Q extends ThumbnailEventTypes>(name: Q, callback: CallbackListener<Q>): void;
+    removeEventListener<Q extends ThumbnailEventTypes>(name: Q, callback: CallbackListener<Q>): void;
+    private dispatchEvent;
+    dispatchError(error: Error): void;
+}
 export {};

package/dist/event-emitter.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlayerEmitter = void 0;
+exports.ThumbnailEmitter = exports.PlayerEmitter = void 0;
 class PlayerEmitter {
     constructor() {
         this.listeners = {
@@ -61,3 +61,27 @@ class PlayerEmitter {
     }
 }
 exports.PlayerEmitter = PlayerEmitter;
+class ThumbnailEmitter {
+    constructor() {
+        this.listeners = {
+            error: [],
+        };
+    }
+    addEventListener(name, callback) {
+        this.listeners[name].push(callback);
+    }
+    removeEventListener(name, callback) {
+        this.listeners[name] = this.listeners[name].filter((l) => l !== callback);
+    }
+    dispatchEvent(dispatchName, context) {
+        this.listeners[dispatchName].forEach((callback) => {
+            callback({ detail: context });
+        });
+    }
+    dispatchError(error) {
+        this.dispatchEvent('error', {
+            error,
+        });
+    }
+}
+exports.ThumbnailEmitter = ThumbnailEmitter;

package/dist/index.d.ts

@@ -1,13 +1,14 @@
 /// <reference types="react" />
-import type { CallbackListener, EventTypes } from './event-emitter';
+import type { CallbackListener, PlayerEventTypes } from './event-emitter';
 import { PlayerEmitter } from './event-emitter';
 export { Player, PlayerProps } from './Player';
-export { PlayerMethods, PlayerRef } from './player-methods';
+export { PlayerMethods, PlayerRef, ThumbnailMethods, ThumbnailRef, } from './player-methods';
 export type { RenderFullscreenButton, RenderPlayPauseButton, } from './PlayerControls';
 export type { ErrorFallback, RenderLoading, RenderPoster } from './PlayerUI';
+export { Thumbnail } from './Thumbnail';
 export { PreviewSize, Translation } from './utils/preview-size';
 export { Size } from './utils/use-element-size';
-export type { CallbackListener, EventTypes };
+export type { CallbackListener, PlayerEventTypes as EventTypes };
 export declare const PlayerInternals: {
     PlayerEventEmitterContext: import("react").Context<PlayerEmitter | undefined>;
     PlayerEmitter: typeof PlayerEmitter;

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlayerInternals = exports.Player = void 0;
+exports.PlayerInternals = exports.Thumbnail = exports.Player = void 0;
 const calculate_scale_1 = require("./calculate-scale");
 const emitter_context_1 = require("./emitter-context");
 const event_emitter_1 = require("./event-emitter");
@@ -10,6 +10,8 @@ const use_player_1 = require("./use-player");
 const use_element_size_1 = require("./utils/use-element-size");
 var Player_1 = require("./Player");
 Object.defineProperty(exports, "Player", { enumerable: true, get: function () { return Player_1.Player; } });
+var Thumbnail_1 = require("./Thumbnail");
+Object.defineProperty(exports, "Thumbnail", { enumerable: true, get: function () { return Thumbnail_1.Thumbnail; } });
 exports.PlayerInternals = {
     PlayerEventEmitterContext: emitter_context_1.PlayerEventEmitterContext,
     PlayerEmitter: event_emitter_1.PlayerEmitter,

package/dist/outer-style.d.ts

@@ -0,0 +1,7 @@
+import type { VideoConfig } from 'remotion';
+import type { Size } from './utils/use-element-size';
+export declare const calculateOuterStyle: ({ config, style, canvasSize, }: {
+    config: VideoConfig | null;
+    style: React.CSSProperties | undefined;
+    canvasSize: Size | null;
+}) => React.CSSProperties;

package/dist/outer-style.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateOuterStyle = void 0;
+const calculate_player_size_1 = require("./utils/calculate-player-size");
+const calculateOuterStyle = ({ config, style, canvasSize, }) => {
+    if (!config) {
+        return {};
+    }
+    return {
+        position: 'relative',
+        overflow: 'hidden',
+        ...(0, calculate_player_size_1.calculatePlayerSize)({
+            compositionHeight: config.height,
+            compositionWidth: config.width,
+            currentSize: canvasSize,
+            height: style === null || style === void 0 ? void 0 : style.height,
+            width: style === null || style === void 0 ? void 0 : style.width,
+        }),
+        ...style,
+    };
+};
+exports.calculateOuterStyle = calculateOuterStyle;

package/dist/player-methods.d.ts

@@ -1,11 +1,14 @@
 import type { SyntheticEvent } from 'react';
 import type { PlayerEmitter } from './event-emitter';
-export declare type PlayerMethods = {
+export declare type ThumbnailMethods = {
+    getContainerNode: () => HTMLDivElement | null;
+    getScale: () => number;
+};
+export declare type PlayerMethods = ThumbnailMethods & {
     play: (e?: SyntheticEvent) => void;
     pause: () => void;
     toggle: (e?: SyntheticEvent) => void;
     seekTo: (frame: number) => void;
-    getContainerNode: () => HTMLDivElement | null;
     getCurrentFrame: () => number;
     requestFullscreen: () => void;
     exitFullscreen: () => void;
@@ -16,6 +19,6 @@ export declare type PlayerMethods = {
     isPlaying: () => boolean;
     mute: () => void;
     unmute: () => void;
-    getScale: () => number;
 };
+export declare type ThumbnailRef = PlayerEmitter & ThumbnailMethods;
 export declare type PlayerRef = PlayerEmitter & PlayerMethods;

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/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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@remotion/player",
-	"version": "3.2.40",
+	"version": "3.2.42",
 	"description": "Remotion Player",
 	"main": "dist/index.js",
 	"sideEffects": false,
@@ -27,7 +27,7 @@
 	],
 	"license": "SEE LICENSE IN LICENSE.md",
 	"dependencies": {
-		"remotion": "3.2.40"
+		"remotion": "3.2.42"
 	},
 	"peerDependencies": {
 		"react": ">=16.8.0",
@@ -62,5 +62,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "dd204bb0a42d4c6c2988957d399c898e5eba4eba"
+	"gitHead": "d297af4ecea4d09948bbf05eeb66dfa701be3787"
 }