feat: allow configurable fetchPriority for poster image

src/components/players/background-player.tsx

@@ -10,7 +10,7 @@ import type { MediaProps } from './media/index.js';
 
 const BackgroundPlayer = forwardRef<HTMLVideoElement, Omit<MediaProps, 'ref'> & PlayerProps>(
   (allProps, forwardedRef) => {
-    let { style, className, children, asset, poster, blurDataURL, onPlaying, onLoadStart, ...rest } = allProps;
+    let { style, className, children, asset, poster, posterFetchPriority="auto", blurDataURL, onPlaying, onLoadStart, ...rest } = allProps;
 
     const slottedPoster = Children.toArray(children).find((child) => {
       return typeof child === 'object' && 'type' in child && (child.props as any).slot === 'poster';
@@ -137,6 +137,7 @@ const BackgroundPlayer = forwardRef<HTMLVideoElement, Omit<MediaProps, 'ref'> &
                 hidden={posterHidden}
                 decoding="async"
                 aria-hidden="true"
+                fetchPriority={posterFetchPriority}
               />
             )}
             <div className="next-video-bg-text">{children}</div>

src/components/players/default-player.tsx

@@ -16,6 +16,7 @@ const DefaultPlayer = forwardRef<HTMLVideoElement, Omit<MediaProps, 'ref'> & Pla
     asset,
     controls = true,
     poster,
+    posterFetchPriority = 'auto',
     blurDataURL,
     theme: Theme = Sutro,
     ...rest
@@ -96,6 +97,7 @@ const DefaultPlayer = forwardRef<HTMLVideoElement, Omit<MediaProps, 'ref'> & Pla
           style={imgStyleProps}
           decoding="async"
           aria-hidden="true"
+          fetchPriority={posterFetchPriority}
         />
       );
       poster = '';

src/components/types.ts

@@ -132,6 +132,11 @@ export type PlayerProps = {
    */
   poster?: StaticImageData | string;
 
+  /**
+   * The poster image fetch priority for the video.
+   */
+  posterFetchPriority?: 'high' | 'low' | 'auto';
+
   /**
    * Set a manual data URL to be used as a placeholder image before the poster image successfully loads.
    * For imported videos this will be automatically generated.