@xhub-reels/sdk 0.1.14 → 0.1.17

package/dist/index.d.cts

@@ -246,6 +246,16 @@ interface IVideoLoader {
     isPreloaded(videoId: string): boolean;
     getPreloadStatus(videoId: string): PreloadStatus;
     clearAll(): void;
+    /**
+     * Tier 4 cold prefetch — fetch HLS manifest vào HTTP browser cache.
+     * Fire-and-forget. Không download segment. Không cần DOM.
+     * Optional: nếu không implement, Tier 4 silently skipped.
+     *
+     * Implementation pattern:
+     *   fetch(url, { method: 'GET', headers: { Range: 'bytes=0-0' } })
+     *   // hoặc đơn giản: fetch(url)
+     */
+    preloadMetadata?(url: string): void;
 }
 interface CommentItem {
     id: string;
@@ -300,40 +310,53 @@ interface SlotActions {
     share: () => void;
     /** Current global mute state */
     isMuted: boolean;
-    /** Toggle global mute */
+    /** Toggle global mute — exposed via SlotActions for use in renderActions button */
     toggleMute: () => void;
-    /** Whether the active video is currently paused */
-    isPaused: boolean;
-    /** Toggle pause/play on the active video */
-    togglePause: () => void;
     /** Whether this slot is the active playing slot */
     isActive: boolean;
     /** Slot index in feed */
     index: number;
 }
+/**
+ * Actions provided to the pauseActionOverlay render callback.
+ * Extends SlotActions with play/pause control.
+ */
+interface PauseSlotActions extends SlotActions {
+    /** Whether the video is currently manually paused (user tapped to pause) */
+    isPaused: boolean;
+    /** Toggle play/pause for the current video */
+    togglePlayPause: () => void;
+}
 /** Props for the ReelsFeed component */
 interface ReelsFeedProps {
     /**
      * Custom overlay rendered on each video slot.
      * Receives the content item + actions. Return ReactNode.
-     * Positioned absolute bottom (bottom-0) left by SDK.
+     * Positioned absolute bottom-left by SDK.
      * If not provided, SDK uses DefaultOverlay showing author + title.
      */
     renderOverlay?: (item: ContentItem, actions: SlotActions) => ReactNode;
     /**
      * Custom action bar rendered on each video slot.
      * Receives the content item + actions. Return ReactNode.
-     * Positioned absolute bottom (bottom-0) right by SDK.
+     * Positioned absolute bottom-right by SDK.
      * If not provided, SDK uses DefaultActions showing like/comment/share emojis.
+     * NOTE: Mute/unmute button should live here — access via actions.toggleMute / actions.isMuted.
      */
     renderActions?: (item: ContentItem, actions: SlotActions) => ReactNode;
     /**
-     * Custom pause/play indicator rendered when user taps to pause/play.
-     * Receives isPaused state. Return ReactNode.
-     * Positioned absolute center by SDK.
-     * If not provided, SDK uses a default ▶️/⏸️ emoji indicator.
+     * Custom pause overlay rendered in the center of the video when it is manually paused.
+     * Only visible when the user taps to pause the active video.
+     * If not provided, SDK shows a default semi-transparent Play icon.
+     *
+     * Return null to suppress the overlay entirely.
+     *
+     * @example
+     * renderPauseAction={(item, actions) => (
+     *   <PlayIcon size={72} onPress={actions.togglePlayPause} />
+     * )}
      */
-    renderPauseIndicator?: (isPaused: boolean) => ReactNode;
+    renderPauseAction?: (item: ContentItem, actions: PauseSlotActions) => ReactNode;
     /**
      * Custom loading skeleton shown during initial feed load.
      * If not provided, SDK uses DefaultSkeleton with shimmer animation.
@@ -377,6 +400,25 @@ interface ReelsFeedProps {
         duration?: number;
         easing?: string;
     };
+    /**
+     * Initial mute state for video playback.
+     *
+     * - `true` (default): Videos start muted, satisfying all browser autoplay policies
+     * - `false`: SDK attempts unmuted autoplay. If browser blocks it, falls back to muted.
+     *
+     * Use `false` when you know the user has already interacted with the page
+     * (e.g., clicked a link to navigate to the reels page in Flutter WebView).
+     *
+     * @default true
+     */
+    initialMuted?: boolean;
+    /**
+     * Called when unmuted autoplay fails and SDK falls back to muted playback.
+     * Use this to show a "tap to unmute" UI hint to the user.
+     *
+     * Only fires when `initialMuted: false` and browser blocks unmuted autoplay.
+     */
+    onAutoplayBlocked?: () => void;
 }
 
 /**
@@ -600,6 +642,14 @@ declare class ResourceGovernor {
     isWarmAllocated(index: number): boolean;
     shouldRenderVideo(index: number): boolean;
     isPreloading(index: number): boolean;
+    /**
+     * Returns the buffer tier (1–4) for a given index.
+     * - 1: Active (playing, 10s buffer)
+     * - 2: Hot (±bufferWindow, 2s buffer, instant swap)
+     * - 3: Warm (manifest + 1 segment, ~300ms show)
+     * - 4: Cold (preload queue — manifest in HTTP cache, no DOM)
+     */
+    getTier(index: number): 1 | 2 | 3 | 4 | null;
     getActiveAllocations(): number[];
     getWarmAllocations(): number[];
     private recalculate;
@@ -667,6 +717,16 @@ interface PointerGestureConfig {
     onSnap?: (direction: 'forward' | 'backward') => void;
     /** Called when gesture ends without snap (bounce back) */
     onBounceBack?: () => void;
+    /**
+     * Called when drag gesture starts (pointerdown).
+     * Use for muting audio during drag to improve gesture performance.
+     */
+    onDragStart?: () => void;
+    /**
+     * Called when drag gesture ends (pointerup/pointercancel).
+     * Use for unmuting audio after drag completes.
+     */
+    onDragEnd?: () => void;
 }
 interface PointerGestureBind {
     onPointerDown: (e: React.PointerEvent) => void;
@@ -724,7 +784,7 @@ interface ReelsProviderProps {
 declare function ReelsProvider({ children, adapters, debug }: ReelsProviderProps): react_jsx_runtime.JSX.Element;
 declare function useSDK(): SDKContextValue;
 
-declare function ReelsFeed({ renderOverlay, renderActions, renderPauseIndicator, renderLoading, renderEmpty, renderError: _renderError, showFps, loadMoreThreshold, onSlotChange, gestureConfig, snapConfig, }: ReelsFeedProps): string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+declare function ReelsFeed({ renderOverlay, renderActions, renderPauseAction, renderLoading, renderEmpty, renderError: _renderError, showFps, loadMoreThreshold, onSlotChange, gestureConfig, snapConfig, initialMuted, onAutoplayBlocked, }: ReelsFeedProps): string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
 
 /**
  * useHls — React hook for hls.js lifecycle management (3-Tier buffer support)
@@ -775,12 +835,6 @@ interface UseHlsOptions {
 interface UseHlsReturn {
     /** Whether hls.js is being used (false = native HLS on Safari) */
     isHlsJs: boolean;
-    /**
-     * Whether the device uses native HLS (Safari / iOS WebView).
-     * When true, play-ahead (video.play() on non-active slots) must be skipped —
-     * iOS only allows one concurrently-playing video element at a time.
-     */
-    isNativeHls: boolean;
     /** Whether the video has buffered enough data to play without black flash */
     isReady: boolean;
     /** Destroy the HLS instance manually (also called automatically on unmount) */
@@ -797,12 +851,14 @@ interface VideoSlotProps {
     bufferTier: BufferTier;
     isMuted: boolean;
     onToggleMute: () => void;
+    /** Called when unmuted autoplay fails and SDK falls back to muted playback */
+    onAutoplayBlocked?: () => void;
     showFps?: boolean;
-    renderOverlay?: (item: ContentItem, actions: SlotActions) => ReactNode;
-    renderActions?: (item: ContentItem, actions: SlotActions) => ReactNode;
-    renderPauseIndicator?: (isPaused: boolean) => ReactNode;
+    renderOverlay?: (item: ContentItem, actions: SlotActions) => react.ReactNode;
+    renderActions?: (item: ContentItem, actions: SlotActions) => react.ReactNode;
+    renderPauseAction?: (item: ContentItem, actions: PauseSlotActions) => react.ReactNode;
 }
-declare function VideoSlot({ item, index, isActive, isPrefetch, isPreloaded, bufferTier, isMuted, onToggleMute, showFps, renderOverlay, renderActions, renderPauseIndicator, }: VideoSlotProps): react_jsx_runtime.JSX.Element;
+declare function VideoSlot({ item, index, isActive, isPrefetch, isPreloaded, bufferTier, isMuted, onToggleMute, onAutoplayBlocked, showFps, renderOverlay, renderActions, renderPauseAction, }: VideoSlotProps): react_jsx_runtime.JSX.Element;
 
 declare function DefaultOverlay({ item }: {
     item: ContentItem;
@@ -820,6 +876,16 @@ declare function DefaultActions({ item, actions }: {
  */
 declare function DefaultSkeleton(): react_jsx_runtime.JSX.Element;
 
+/**
+ * DefaultPauseAction — Default play icon shown when video is manually paused
+ *
+ * Renders a semi-transparent circular play button in the center of the slot.
+ * Fades in smoothly when isPaused = true. Matches TikTok / Instagram Reels UX.
+ *
+ * Used when host app does not provide renderPauseAction prop.
+ */
+declare function DefaultPauseAction(): react_jsx_runtime.JSX.Element;
+
 declare function useFeedSelector<T>(selector: (state: FeedState) => T): T;
 declare function useFeed(): {
     items: NonNullable<ContentItem | undefined>[];
@@ -882,6 +948,7 @@ declare function useResource(): {
     networkType: NetworkType;
     isActive: boolean;
     prefetchIndex: number | null;
+    preloadQueue: number[];
     setFocusedIndex: (i: number) => void;
     setFocusedIndexImmediate: (i: number) => void;
     setTotalItems: (n: number) => void;
@@ -889,6 +956,7 @@ declare function useResource(): {
     isAllocated: (i: number) => boolean;
     isWarmAllocated: (i: number) => boolean;
     setPrefetchIndex: (i: number | null) => void;
+    getTier: (index: number) => 3 | 1 | 2 | 4 | null;
 };
 
 /**
@@ -952,6 +1020,7 @@ declare class MockVideoLoader implements IVideoLoader {
     isPreloaded(videoId: string): boolean;
     getPreloadStatus(videoId: string): "idle" | "loading" | "loaded";
     clearAll(): void;
+    preloadMetadata(_url: string): void;
 }
 declare class MockDataSource implements IDataSource {
     private totalItems;
@@ -1090,4 +1159,4 @@ declare class HttpError extends Error {
     constructor(status: number, message: string, body?: string | undefined);
 }
 
-export { type Article, type ArticleImage, type Author, type BufferTier, type CommentItem, type CommentPage, type ContentItem, type ContentStats, DEFAULT_FEED_CONFIG, DEFAULT_PLAYER_CONFIG, DEFAULT_RESOURCE_CONFIG, DefaultActions, DefaultOverlay, DefaultSkeleton, type FeedConfig, type FeedError, FeedManager, type FeedPage, type FeedState, HttpDataSource, type HttpDataSourceConfig, HttpError, type IAnalytics, type ICommentAdapter, type IDataSource, type IInteraction, type ILogger, type INetworkAdapter, type ISessionStorage, type IVideoLoader, type InteractionState, type LogLevel, MockAnalytics, MockCommentAdapter, MockDataSource, MockInteraction, MockLogger, MockNetworkAdapter, MockSessionStorage, MockVideoLoader, type NetworkType, OptimisticManager, type PlayerConfig, PlayerEngine, type PlayerError, type PlayerEvent, type PlayerEventListener, type PlayerState, PlayerStatus, type PointerGestureConfig, type PreloadResult, type PreloadStatus, ReelsFeed, type ReelsFeedProps, ReelsProvider, type ReelsProviderProps, type ResourceConfig, ResourceGovernor, type ResourceState, type SDKAdapters, type SDKContextValue, type SlotActions, type SnapTarget, type UseHlsOptions, type UseHlsReturn, VALID_TRANSITIONS, type VideoItem, type VideoQuality, VideoSlot, type VideoSource, canPause, canPlay, canSeek, isArticle, isValidTransition, isVideoItem, useFeed, useFeedSelector, useHls, usePlayer, usePlayerSelector, usePointerGesture, useResource, useResourceSelector, useSDK, useSnapAnimation };
+export { type Article, type ArticleImage, type Author, type BufferTier, type CommentItem, type CommentPage, type ContentItem, type ContentStats, DEFAULT_FEED_CONFIG, DEFAULT_PLAYER_CONFIG, DEFAULT_RESOURCE_CONFIG, DefaultActions, DefaultOverlay, DefaultPauseAction, DefaultSkeleton, type FeedConfig, type FeedError, FeedManager, type FeedPage, type FeedState, HttpDataSource, type HttpDataSourceConfig, HttpError, type IAnalytics, type ICommentAdapter, type IDataSource, type IInteraction, type ILogger, type INetworkAdapter, type ISessionStorage, type IVideoLoader, type InteractionState, type LogLevel, MockAnalytics, MockCommentAdapter, MockDataSource, MockInteraction, MockLogger, MockNetworkAdapter, MockSessionStorage, MockVideoLoader, type NetworkType, OptimisticManager, type PauseSlotActions, type PlayerConfig, PlayerEngine, type PlayerError, type PlayerEvent, type PlayerEventListener, type PlayerState, PlayerStatus, type PointerGestureConfig, type PreloadResult, type PreloadStatus, ReelsFeed, type ReelsFeedProps, ReelsProvider, type ReelsProviderProps, type ResourceConfig, ResourceGovernor, type ResourceState, type SDKAdapters, type SDKContextValue, type SlotActions, type SnapTarget, type UseHlsOptions, type UseHlsReturn, VALID_TRANSITIONS, type VideoItem, type VideoQuality, VideoSlot, type VideoSource, canPause, canPlay, canSeek, isArticle, isValidTransition, isVideoItem, useFeed, useFeedSelector, useHls, usePlayer, usePlayerSelector, usePointerGesture, useResource, useResourceSelector, useSDK, useSnapAnimation };

package/dist/index.d.ts

@@ -246,6 +246,16 @@ interface IVideoLoader {
     isPreloaded(videoId: string): boolean;
     getPreloadStatus(videoId: string): PreloadStatus;
     clearAll(): void;
+    /**
+     * Tier 4 cold prefetch — fetch HLS manifest vào HTTP browser cache.
+     * Fire-and-forget. Không download segment. Không cần DOM.
+     * Optional: nếu không implement, Tier 4 silently skipped.
+     *
+     * Implementation pattern:
+     *   fetch(url, { method: 'GET', headers: { Range: 'bytes=0-0' } })
+     *   // hoặc đơn giản: fetch(url)
+     */
+    preloadMetadata?(url: string): void;
 }
 interface CommentItem {
     id: string;
@@ -300,40 +310,53 @@ interface SlotActions {
     share: () => void;
     /** Current global mute state */
     isMuted: boolean;
-    /** Toggle global mute */
+    /** Toggle global mute — exposed via SlotActions for use in renderActions button */
     toggleMute: () => void;
-    /** Whether the active video is currently paused */
-    isPaused: boolean;
-    /** Toggle pause/play on the active video */
-    togglePause: () => void;
     /** Whether this slot is the active playing slot */
     isActive: boolean;
     /** Slot index in feed */
     index: number;
 }
+/**
+ * Actions provided to the pauseActionOverlay render callback.
+ * Extends SlotActions with play/pause control.
+ */
+interface PauseSlotActions extends SlotActions {
+    /** Whether the video is currently manually paused (user tapped to pause) */
+    isPaused: boolean;
+    /** Toggle play/pause for the current video */
+    togglePlayPause: () => void;
+}
 /** Props for the ReelsFeed component */
 interface ReelsFeedProps {
     /**
      * Custom overlay rendered on each video slot.
      * Receives the content item + actions. Return ReactNode.
-     * Positioned absolute bottom (bottom-0) left by SDK.
+     * Positioned absolute bottom-left by SDK.
      * If not provided, SDK uses DefaultOverlay showing author + title.
      */
     renderOverlay?: (item: ContentItem, actions: SlotActions) => ReactNode;
     /**
      * Custom action bar rendered on each video slot.
      * Receives the content item + actions. Return ReactNode.
-     * Positioned absolute bottom (bottom-0) right by SDK.
+     * Positioned absolute bottom-right by SDK.
      * If not provided, SDK uses DefaultActions showing like/comment/share emojis.
+     * NOTE: Mute/unmute button should live here — access via actions.toggleMute / actions.isMuted.
      */
     renderActions?: (item: ContentItem, actions: SlotActions) => ReactNode;
     /**
-     * Custom pause/play indicator rendered when user taps to pause/play.
-     * Receives isPaused state. Return ReactNode.
-     * Positioned absolute center by SDK.
-     * If not provided, SDK uses a default ▶️/⏸️ emoji indicator.
+     * Custom pause overlay rendered in the center of the video when it is manually paused.
+     * Only visible when the user taps to pause the active video.
+     * If not provided, SDK shows a default semi-transparent Play icon.
+     *
+     * Return null to suppress the overlay entirely.
+     *
+     * @example
+     * renderPauseAction={(item, actions) => (
+     *   <PlayIcon size={72} onPress={actions.togglePlayPause} />
+     * )}
      */
-    renderPauseIndicator?: (isPaused: boolean) => ReactNode;
+    renderPauseAction?: (item: ContentItem, actions: PauseSlotActions) => ReactNode;
     /**
      * Custom loading skeleton shown during initial feed load.
      * If not provided, SDK uses DefaultSkeleton with shimmer animation.
@@ -377,6 +400,25 @@ interface ReelsFeedProps {
         duration?: number;
         easing?: string;
     };
+    /**
+     * Initial mute state for video playback.
+     *
+     * - `true` (default): Videos start muted, satisfying all browser autoplay policies
+     * - `false`: SDK attempts unmuted autoplay. If browser blocks it, falls back to muted.
+     *
+     * Use `false` when you know the user has already interacted with the page
+     * (e.g., clicked a link to navigate to the reels page in Flutter WebView).
+     *
+     * @default true
+     */
+    initialMuted?: boolean;
+    /**
+     * Called when unmuted autoplay fails and SDK falls back to muted playback.
+     * Use this to show a "tap to unmute" UI hint to the user.
+     *
+     * Only fires when `initialMuted: false` and browser blocks unmuted autoplay.
+     */
+    onAutoplayBlocked?: () => void;
 }
 
 /**
@@ -600,6 +642,14 @@ declare class ResourceGovernor {
     isWarmAllocated(index: number): boolean;
     shouldRenderVideo(index: number): boolean;
     isPreloading(index: number): boolean;
+    /**
+     * Returns the buffer tier (1–4) for a given index.
+     * - 1: Active (playing, 10s buffer)
+     * - 2: Hot (±bufferWindow, 2s buffer, instant swap)
+     * - 3: Warm (manifest + 1 segment, ~300ms show)
+     * - 4: Cold (preload queue — manifest in HTTP cache, no DOM)
+     */
+    getTier(index: number): 1 | 2 | 3 | 4 | null;
     getActiveAllocations(): number[];
     getWarmAllocations(): number[];
     private recalculate;
@@ -667,6 +717,16 @@ interface PointerGestureConfig {
     onSnap?: (direction: 'forward' | 'backward') => void;
     /** Called when gesture ends without snap (bounce back) */
     onBounceBack?: () => void;
+    /**
+     * Called when drag gesture starts (pointerdown).
+     * Use for muting audio during drag to improve gesture performance.
+     */
+    onDragStart?: () => void;
+    /**
+     * Called when drag gesture ends (pointerup/pointercancel).
+     * Use for unmuting audio after drag completes.
+     */
+    onDragEnd?: () => void;
 }
 interface PointerGestureBind {
     onPointerDown: (e: React.PointerEvent) => void;
@@ -724,7 +784,7 @@ interface ReelsProviderProps {
 declare function ReelsProvider({ children, adapters, debug }: ReelsProviderProps): react_jsx_runtime.JSX.Element;
 declare function useSDK(): SDKContextValue;
 
-declare function ReelsFeed({ renderOverlay, renderActions, renderPauseIndicator, renderLoading, renderEmpty, renderError: _renderError, showFps, loadMoreThreshold, onSlotChange, gestureConfig, snapConfig, }: ReelsFeedProps): string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
+declare function ReelsFeed({ renderOverlay, renderActions, renderPauseAction, renderLoading, renderEmpty, renderError: _renderError, showFps, loadMoreThreshold, onSlotChange, gestureConfig, snapConfig, initialMuted, onAutoplayBlocked, }: ReelsFeedProps): string | number | bigint | boolean | Iterable<react.ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined> | react_jsx_runtime.JSX.Element | null | undefined;
 
 /**
  * useHls — React hook for hls.js lifecycle management (3-Tier buffer support)
@@ -775,12 +835,6 @@ interface UseHlsOptions {
 interface UseHlsReturn {
     /** Whether hls.js is being used (false = native HLS on Safari) */
     isHlsJs: boolean;
-    /**
-     * Whether the device uses native HLS (Safari / iOS WebView).
-     * When true, play-ahead (video.play() on non-active slots) must be skipped —
-     * iOS only allows one concurrently-playing video element at a time.
-     */
-    isNativeHls: boolean;
     /** Whether the video has buffered enough data to play without black flash */
     isReady: boolean;
     /** Destroy the HLS instance manually (also called automatically on unmount) */
@@ -797,12 +851,14 @@ interface VideoSlotProps {
     bufferTier: BufferTier;
     isMuted: boolean;
     onToggleMute: () => void;
+    /** Called when unmuted autoplay fails and SDK falls back to muted playback */
+    onAutoplayBlocked?: () => void;
     showFps?: boolean;
-    renderOverlay?: (item: ContentItem, actions: SlotActions) => ReactNode;
-    renderActions?: (item: ContentItem, actions: SlotActions) => ReactNode;
-    renderPauseIndicator?: (isPaused: boolean) => ReactNode;
+    renderOverlay?: (item: ContentItem, actions: SlotActions) => react.ReactNode;
+    renderActions?: (item: ContentItem, actions: SlotActions) => react.ReactNode;
+    renderPauseAction?: (item: ContentItem, actions: PauseSlotActions) => react.ReactNode;
 }
-declare function VideoSlot({ item, index, isActive, isPrefetch, isPreloaded, bufferTier, isMuted, onToggleMute, showFps, renderOverlay, renderActions, renderPauseIndicator, }: VideoSlotProps): react_jsx_runtime.JSX.Element;
+declare function VideoSlot({ item, index, isActive, isPrefetch, isPreloaded, bufferTier, isMuted, onToggleMute, onAutoplayBlocked, showFps, renderOverlay, renderActions, renderPauseAction, }: VideoSlotProps): react_jsx_runtime.JSX.Element;
 
 declare function DefaultOverlay({ item }: {
     item: ContentItem;
@@ -820,6 +876,16 @@ declare function DefaultActions({ item, actions }: {
  */
 declare function DefaultSkeleton(): react_jsx_runtime.JSX.Element;
 
+/**
+ * DefaultPauseAction — Default play icon shown when video is manually paused
+ *
+ * Renders a semi-transparent circular play button in the center of the slot.
+ * Fades in smoothly when isPaused = true. Matches TikTok / Instagram Reels UX.
+ *
+ * Used when host app does not provide renderPauseAction prop.
+ */
+declare function DefaultPauseAction(): react_jsx_runtime.JSX.Element;
+
 declare function useFeedSelector<T>(selector: (state: FeedState) => T): T;
 declare function useFeed(): {
     items: NonNullable<ContentItem | undefined>[];
@@ -882,6 +948,7 @@ declare function useResource(): {
     networkType: NetworkType;
     isActive: boolean;
     prefetchIndex: number | null;
+    preloadQueue: number[];
     setFocusedIndex: (i: number) => void;
     setFocusedIndexImmediate: (i: number) => void;
     setTotalItems: (n: number) => void;
@@ -889,6 +956,7 @@ declare function useResource(): {
     isAllocated: (i: number) => boolean;
     isWarmAllocated: (i: number) => boolean;
     setPrefetchIndex: (i: number | null) => void;
+    getTier: (index: number) => 3 | 1 | 2 | 4 | null;
 };
 
 /**
@@ -952,6 +1020,7 @@ declare class MockVideoLoader implements IVideoLoader {
     isPreloaded(videoId: string): boolean;
     getPreloadStatus(videoId: string): "idle" | "loading" | "loaded";
     clearAll(): void;
+    preloadMetadata(_url: string): void;
 }
 declare class MockDataSource implements IDataSource {
     private totalItems;
@@ -1090,4 +1159,4 @@ declare class HttpError extends Error {
     constructor(status: number, message: string, body?: string | undefined);
 }
 
-export { type Article, type ArticleImage, type Author, type BufferTier, type CommentItem, type CommentPage, type ContentItem, type ContentStats, DEFAULT_FEED_CONFIG, DEFAULT_PLAYER_CONFIG, DEFAULT_RESOURCE_CONFIG, DefaultActions, DefaultOverlay, DefaultSkeleton, type FeedConfig, type FeedError, FeedManager, type FeedPage, type FeedState, HttpDataSource, type HttpDataSourceConfig, HttpError, type IAnalytics, type ICommentAdapter, type IDataSource, type IInteraction, type ILogger, type INetworkAdapter, type ISessionStorage, type IVideoLoader, type InteractionState, type LogLevel, MockAnalytics, MockCommentAdapter, MockDataSource, MockInteraction, MockLogger, MockNetworkAdapter, MockSessionStorage, MockVideoLoader, type NetworkType, OptimisticManager, type PlayerConfig, PlayerEngine, type PlayerError, type PlayerEvent, type PlayerEventListener, type PlayerState, PlayerStatus, type PointerGestureConfig, type PreloadResult, type PreloadStatus, ReelsFeed, type ReelsFeedProps, ReelsProvider, type ReelsProviderProps, type ResourceConfig, ResourceGovernor, type ResourceState, type SDKAdapters, type SDKContextValue, type SlotActions, type SnapTarget, type UseHlsOptions, type UseHlsReturn, VALID_TRANSITIONS, type VideoItem, type VideoQuality, VideoSlot, type VideoSource, canPause, canPlay, canSeek, isArticle, isValidTransition, isVideoItem, useFeed, useFeedSelector, useHls, usePlayer, usePlayerSelector, usePointerGesture, useResource, useResourceSelector, useSDK, useSnapAnimation };
+export { type Article, type ArticleImage, type Author, type BufferTier, type CommentItem, type CommentPage, type ContentItem, type ContentStats, DEFAULT_FEED_CONFIG, DEFAULT_PLAYER_CONFIG, DEFAULT_RESOURCE_CONFIG, DefaultActions, DefaultOverlay, DefaultPauseAction, DefaultSkeleton, type FeedConfig, type FeedError, FeedManager, type FeedPage, type FeedState, HttpDataSource, type HttpDataSourceConfig, HttpError, type IAnalytics, type ICommentAdapter, type IDataSource, type IInteraction, type ILogger, type INetworkAdapter, type ISessionStorage, type IVideoLoader, type InteractionState, type LogLevel, MockAnalytics, MockCommentAdapter, MockDataSource, MockInteraction, MockLogger, MockNetworkAdapter, MockSessionStorage, MockVideoLoader, type NetworkType, OptimisticManager, type PauseSlotActions, type PlayerConfig, PlayerEngine, type PlayerError, type PlayerEvent, type PlayerEventListener, type PlayerState, PlayerStatus, type PointerGestureConfig, type PreloadResult, type PreloadStatus, ReelsFeed, type ReelsFeedProps, ReelsProvider, type ReelsProviderProps, type ResourceConfig, ResourceGovernor, type ResourceState, type SDKAdapters, type SDKContextValue, type SlotActions, type SnapTarget, type UseHlsOptions, type UseHlsReturn, VALID_TRANSITIONS, type VideoItem, type VideoQuality, VideoSlot, type VideoSource, canPause, canPlay, canSeek, isArticle, isValidTransition, isVideoItem, useFeed, useFeedSelector, useHls, usePlayer, usePlayerSelector, usePointerGesture, useResource, useResourceSelector, useSDK, useSnapAnimation };