@rixl/media-core 1.0.2 → 1.1.1

package/dist/lib/hls-setup.js

@@ -1,144 +0,0 @@
-import { isHlsStream } from "./hls-utils.js";
-import { playerStateStore } from "../store/player-store.js";
-import { MAX_MEDIA_RECOVERIES, MAX_NETWORK_RETRIES, createHlsErrorRecoveryState, decideHlsErrorAction } from "./hls-error-recovery.js";
-import { loadHls } from "./hls-loader.js";
-import { setupHlsEventHandlers } from "./hls-event-handlers.js";
-import { createSeekingHandler } from "./hls-buffer-flush.js";
-
-// src/lib/hls-setup.ts
-function createHlsConfig(isPreloading) {
-	return {
-		debug: false,
-		enableWorker: true,
-		lowLatencyMode: false,
-		backBufferLength: 10,
-		maxBufferLength: isPreloading ? 10 : 30,
-		maxMaxBufferLength: isPreloading ? 20 : 60,
-		maxBufferSize: 6e7,
-		maxBufferHole: .3,
-		manifestLoadingTimeOut: 1e4,
-		fragLoadingTimeOut: 2e4,
-		startFragPrefetch: true,
-		highBufferWatchdogPeriod: 2,
-		nudgeOffset: .2,
-		nudgeMaxRetry: 5,
-		testBandwidth: true,
-		progressive: false,
-		abrEwmaDefaultEstimate: 5e6,
-		abrMaxWithRealBitrate: true
-	};
-}
-function tryAttachNativeSource(HlsClass, videoElement, videoUrl) {
-	if (!HlsClass.isSupported() && videoElement.canPlayType("application/vnd.apple.mpegurl")) {
-		videoElement.src = videoUrl;
-		return true;
-	}
-	return false;
-}
-function bindErrorHandler(hlsInstance, events, onError) {
-	const recoveryState = createHlsErrorRecoveryState();
-	hlsInstance.on(events.ERROR, (_event, data) => {
-		const action = decideHlsErrorAction(data, recoveryState);
-		if (!action) return;
-		switch (action.kind) {
-			case "retry-network":
-				hlsInstance.startLoad();
-				return;
-			case "recover-media":
-				hlsInstance.recoverMediaError();
-				return;
-			case "give-up":
-				onError?.(action.payload);
-				return;
-		}
-	});
-}
-function buildController(opts) {
-	const { hlsInstance, videoElement, playerId, handleSeeking, state } = opts;
-	return {
-		hls: hlsInstance,
-		get levels() {
-			return state.levels;
-		},
-		get currentLevel() {
-			return state.currentLevel;
-		},
-		get isAuto() {
-			return state.isAuto;
-		},
-		setQuality: (index) => {
-			if (index === -1) {
-				hlsInstance.loadLevel = -1;
-				state.isAuto = true;
-			} else {
-				hlsInstance.loadLevel = index;
-				state.isAuto = false;
-			}
-		},
-		destroy: () => {
-			videoElement.removeEventListener("seeking", handleSeeking);
-			hlsInstance.destroy();
-			playerStateStore.setHlsInstance(playerId, null);
-		}
-	};
-}
-/**
-* Set up HLS streaming on a video element, resolving to a controller for
-* quality/audio switching and teardown.
-*
-* - For non-HLS URLs: sets `videoElement.src` directly and resolves to `null`
-*   without loading hls.js.
-* - For HLS URLs on Safari (no `Hls.isSupported()` but native canPlayType):
-*   sets `videoElement.src` and returns `null` (UI features that depend on
-*   the HLS controller — quality switching, audio tracks — won't be available
-*   in native mode).
-* - Otherwise: instantiates HLS.js, attaches the media, wires events
-*   (including error recovery), and returns the controller.
-*/
-async function setupHls(opts) {
-	const { videoElement, videoUrl, playerId, isPreloading, onError, onLevelsChange, onLevelSwitch } = opts;
-	if (!isHlsStream(videoUrl)) {
-		videoElement.src = videoUrl;
-		return null;
-	}
-	const HlsClass = await loadHls();
-	if (tryAttachNativeSource(HlsClass, videoElement, videoUrl)) return null;
-	const hlsInstance = new HlsClass(createHlsConfig(isPreloading));
-	const state = {
-		levels: [],
-		currentLevel: -1,
-		isAuto: true
-	};
-	const handleSeeking = createSeekingHandler({
-		hlsInstance,
-		events: HlsClass.Events,
-		videoElement
-	});
-	videoElement.addEventListener("seeking", handleSeeking);
-	playerStateStore.setHlsInstance(playerId, hlsInstance);
-	hlsInstance.attachMedia(videoElement);
-	setupHlsEventHandlers({
-		hlsInstance,
-		events: HlsClass.Events,
-		playerId,
-		videoUrl,
-		onLevelsChange: (levels) => {
-			state.levels = levels;
-			onLevelsChange?.(levels);
-		},
-		onLevelSwitch: (level) => {
-			state.currentLevel = level;
-			onLevelSwitch?.(level);
-		}
-	});
-	bindErrorHandler(hlsInstance, HlsClass.Events, onError);
-	return buildController({
-		hlsInstance,
-		videoElement,
-		playerId,
-		handleSeeking,
-		state
-	});
-}
-
-export { MAX_MEDIA_RECOVERIES, MAX_NETWORK_RETRIES, createHlsConfig, createHlsErrorRecoveryState, decideHlsErrorAction, setupHls };

package/dist/lib/hls-utils.d.ts

@@ -1,31 +0,0 @@
-import { MediaPlaylist } from "hls.js";
-export interface QualityLevel {
-  height: number;
-  width: number;
-  bitrate: number;
-  name: string;
-  index: number;
-}
-export interface AudioTrack {
-  index: number;
-  label: string;
-  language: string;
-  kind: string;
-  /** The raw Hls.js MediaPlaylist object for this audio track. */
-  track: MediaPlaylist;
-}
-export declare const sortLevelsByQuality: (levels: QualityLevel[]) => QualityLevel[];
-export declare const isHlsStream: (url: string) => boolean;
-export declare const generateLevelName: (level: {
-  height: number;
-  width: number;
-  bitrate: number;
-}) => string;
-interface QualityLabelParams {
-  resolution: number;
-  levels: QualityLevel[];
-  currentLevel: number;
-  autoText: string;
-}
-export declare const getQualityLabel: ({ resolution, levels, currentLevel, autoText }: QualityLabelParams) => string;
-export {};

package/dist/lib/hls-utils.js

@@ -1,34 +0,0 @@
-// src/lib/hls-utils.ts
-const sortLevelsByQuality = (levels) => {
-	return [...levels].sort((a, b) => {
-		if (a.height > 0 && b.height > 0) return b.height - a.height;
-		else if (a.height > 0) return -1;
-		else if (b.height > 0) return 1;
-		else return b.bitrate - a.bitrate;
-	});
-};
-const isHlsStream = (url) => {
-	return url.includes(".m3u8") || url.includes("application/vnd.apple.mpegurl") || url.includes("manifest(format=m3u8") || url.toLowerCase().includes("m3u8");
-};
-const generateLevelName = (level) => {
-	if (level.height > 0 && level.width > 0) return `${Math.min(level.height, level.width)}p`;
-	else if (level.height > 0) return `${level.height}p`;
-	else if (level.width > 0) return `${level.width}p`;
-	else {
-		const bitrateKbps = Math.round(level.bitrate / 1e3);
-		if (bitrateKbps >= 3e3) return "1080p";
-		else if (bitrateKbps >= 2e3) return "720p";
-		else if (bitrateKbps >= 1e3) return "480p";
-		else if (bitrateKbps >= 500) return "360p";
-		else if (bitrateKbps >= 250) return "240p";
-		else return "144p";
-	}
-};
-const getQualityLabel = ({ resolution, levels, currentLevel, autoText }) => {
-	const isAutoSelected = resolution === -1;
-	if (isAutoSelected && levels.length > 0 && currentLevel >= 0 && levels[currentLevel]) return `${autoText} (${levels[currentLevel].name})`;
-	else if (!isAutoSelected && resolution >= 0 && levels[resolution]) return levels[resolution].name;
-	return autoText;
-};
-
-export { generateLevelName, getQualityLabel, isHlsStream, sortLevelsByQuality };

package/dist/lib/image-render.d.ts

@@ -1,29 +0,0 @@
-export type CSSProperties = Record<string, string | number | null | undefined>;
-export interface ImageRenderState {
-  isLoading: boolean;
-  isVisible: boolean;
-  aspectRatio: number;
-}
-export type ImageRenderAction = {
-  type: "reset";
-  aspectRatio?: number;
-} | {
-  type: "loaded";
-} | {
-  type: "visible";
-} | {
-  type: "set_aspect_ratio";
-  aspectRatio: number;
-};
-export declare const DEFAULT_IMAGE_ASPECT_RATIO = .5;
-export declare const IMAGE_ASPECT_RATIO_THRESHOLD = .7;
-export declare const initialImageRenderState: ImageRenderState;
-export interface ImageContainerStyleParams {
-  aspectRatio: number;
-  isVisible: boolean;
-  thumbhashUrl?: string;
-}
-export declare function imageRenderReducer(state: ImageRenderState, action: ImageRenderAction): ImageRenderState;
-export declare function getImageAspectRatio(width?: number, height?: number): number | undefined;
-export declare function getImageContainerStyle({ aspectRatio, isVisible, thumbhashUrl }: ImageContainerStyleParams): CSSProperties;
-export declare function getImageStyle(aspectRatio: number, isLoading: boolean): CSSProperties;

package/dist/lib/image-render.js

@@ -1,63 +0,0 @@
-// src/lib/image-render.ts
-const DEFAULT_IMAGE_ASPECT_RATIO = .5;
-const IMAGE_ASPECT_RATIO_THRESHOLD = .7;
-const initialImageRenderState = {
-	isLoading: true,
-	isVisible: false,
-	aspectRatio: DEFAULT_IMAGE_ASPECT_RATIO
-};
-function imageRenderReducer(state, action) {
-	switch (action.type) {
-		case "reset": return {
-			isLoading: true,
-			isVisible: false,
-			aspectRatio: action.aspectRatio ?? state.aspectRatio
-		};
-		case "loaded": return {
-			...state,
-			isLoading: false
-		};
-		case "visible": return {
-			...state,
-			isVisible: true
-		};
-		case "set_aspect_ratio": return {
-			...state,
-			aspectRatio: action.aspectRatio
-		};
-		default: return state;
-	}
-}
-function getImageAspectRatio(width, height) {
-	if (!width || !height) return void 0;
-	return width / height;
-}
-function getImageContainerStyle({ aspectRatio, isVisible, thumbhashUrl }) {
-	const style = {
-		display: "block",
-		width: "100%",
-		aspectRatio,
-		position: "relative"
-	};
-	if (!isVisible) {
-		style.backgroundImage = `url(${thumbhashUrl})`;
-		style.backgroundSize = aspectRatio >= .7 ? "contain" : "cover";
-		style.backgroundPosition = "center";
-		style.backgroundRepeat = "no-repeat";
-	}
-	return style;
-}
-function getImageStyle(aspectRatio, isLoading) {
-	return {
-		position: "absolute",
-		top: 0,
-		left: 0,
-		width: "100%",
-		height: "100%",
-		objectFit: aspectRatio >= .7 ? "contain" : "cover",
-		opacity: isLoading ? 0 : 1,
-		transition: "opacity 300ms ease"
-	};
-}
-
-export { DEFAULT_IMAGE_ASPECT_RATIO, IMAGE_ASPECT_RATIO_THRESHOLD, getImageAspectRatio, getImageContainerStyle, getImageStyle, imageRenderReducer, initialImageRenderState };

package/dist/lib/keyboard-config.d.ts

@@ -1,66 +0,0 @@
-/**
- * Media SDK video keyboard shortcuts configuration
- */
-export type VideoSdkKey = "Space" | "KeyK" | "KeyJ" | "KeyL" | "KeyI" | "KeyF" | "KeyM" | "KeyN" | "KeyP" | "ArrowUp" | "ArrowDown" | "ArrowLeft" | "ArrowRight" | "MediaPlay" | "MediaPause" | "MediaPlayPause" | "F1" | "F12" | "Digit0" | "Digit1" | "Digit2" | "Digit3" | "Digit4" | "Digit5" | "Digit6" | "Digit7" | "Digit8" | "Digit9";
-export declare const ShortcutAction: {
-  readonly PLAY_PAUSE: "play_pause";
-  readonly SEEK_10: "seek_10";
-  readonly SEEK_5: "seek_5";
-  readonly FULLSCREEN: "fullscreen";
-  readonly MINIPLAYER: "miniplayer";
-  readonly MUTE: "mute";
-  readonly VOLUME: "volume";
-};
-export type ShortcutAction = (typeof ShortcutAction)[keyof typeof ShortcutAction];
-export interface ShortcutDefinition {
-  action: ShortcutAction;
-  keys: VideoSdkKey[];
-  labelKey: string;
-}
-/**
- * Default keyboard shortcuts configuration
- */
-export declare const SHORTCUTS_CONFIG: ShortcutDefinition[];
-/**
- * Seek amounts in seconds
- */
-export declare const SEEK_SMALL_SECONDS = 5;
-export declare const SEEK_LARGE_SECONDS = 10;
-/**
- * Volume change delta (0-1 range)
- */
-export declare const VOLUME_DELTA = .1;
-export interface VideoKeyboardHandlers {
-  onPlayPause: () => void;
-  onSeek: (seconds: number) => void;
-  onFullscreen: () => void;
-  onMiniplayer: () => void;
-  onMute: () => void;
-  onVolume: (delta: number) => void;
-}
-/**
- * Get seek amount for a keyboard event
- * @returns number of seconds to seek (positive = forward, negative = backward)
- */
-export declare function getSeekAmount(keyCode: string, action: ShortcutAction): number;
-/**
- * Get volume delta for a keyboard event
- * @returns volume change amount (positive = increase, negative = decrease)
- */
-export declare function getVolumeDelta(keyCode: string): number;
-/**
- * Execute keyboard shortcut action
- */
-export declare function executeShortcutAction(action: ShortcutAction, keyCode: string, handlers: VideoKeyboardHandlers): void;
-/**
- * Full play/pause key set including media keys — mirrors React's
- * component-level PlayPauseShortcuts, which extends SHORTCUTS_CONFIG.
- */
-export declare const PLAY_PAUSE_KEYS: VideoSdkKey[];
-/** Resolve a KeyboardEvent.code to its shortcut action, or null when unmapped. */
-export declare function resolveShortcutAction(keyCode: string): ShortcutAction | null;
-/**
- * Digit0–Digit9 → 0–90 percent seek targets — mirrors React's
- * PercentageShortcuts table.
- */
-export declare function getSeekPercent(keyCode: string): number | null;

package/dist/lib/keyboard-config.js

@@ -1,127 +0,0 @@
-// src/lib/keyboard-config.ts
-const ShortcutAction = {
-	PLAY_PAUSE: "play_pause",
-	SEEK_10: "seek_10",
-	SEEK_5: "seek_5",
-	FULLSCREEN: "fullscreen",
-	MINIPLAYER: "miniplayer",
-	MUTE: "mute",
-	VOLUME: "volume"
-};
-/**
-* Default keyboard shortcuts configuration
-*/
-const SHORTCUTS_CONFIG = [
-	{
-		action: ShortcutAction.PLAY_PAUSE,
-		keys: ["Space", "KeyK"],
-		labelKey: "shortcuts.play_pause"
-	},
-	{
-		action: ShortcutAction.SEEK_10,
-		keys: ["KeyJ", "KeyL"],
-		labelKey: "shortcuts.seek_10s"
-	},
-	{
-		action: ShortcutAction.SEEK_5,
-		keys: ["ArrowLeft", "ArrowRight"],
-		labelKey: "shortcuts.seek_5s"
-	},
-	{
-		action: ShortcutAction.FULLSCREEN,
-		keys: ["KeyF"],
-		labelKey: "shortcuts.fullscreen"
-	},
-	{
-		action: ShortcutAction.MINIPLAYER,
-		keys: ["KeyI"],
-		labelKey: "shortcuts.pip"
-	},
-	{
-		action: ShortcutAction.MUTE,
-		keys: ["KeyM"],
-		labelKey: "shortcuts.mute"
-	},
-	{
-		action: ShortcutAction.VOLUME,
-		keys: ["ArrowUp", "ArrowDown"],
-		labelKey: "shortcuts.volume"
-	}
-];
-/**
-* Seek amounts in seconds
-*/
-const SEEK_SMALL_SECONDS = 5;
-const SEEK_LARGE_SECONDS = 10;
-/**
-* Volume change delta (0-1 range)
-*/
-const VOLUME_DELTA = .1;
-/**
-* Get seek amount for a keyboard event
-* @returns number of seconds to seek (positive = forward, negative = backward)
-*/
-function getSeekAmount(keyCode, action) {
-	if (action === ShortcutAction.SEEK_10) return keyCode === "KeyL" ? 10 : -10;
-	if (action === ShortcutAction.SEEK_5) return keyCode === "ArrowRight" ? 5 : -5;
-	return 0;
-}
-/**
-* Get volume delta for a keyboard event
-* @returns volume change amount (positive = increase, negative = decrease)
-*/
-function getVolumeDelta(keyCode) {
-	return keyCode === "ArrowUp" ? VOLUME_DELTA : -.1;
-}
-/**
-* Execute keyboard shortcut action
-*/
-function executeShortcutAction(action, keyCode, handlers) {
-	switch (action) {
-		case ShortcutAction.PLAY_PAUSE:
-			handlers.onPlayPause();
-			break;
-		case ShortcutAction.SEEK_10:
-		case ShortcutAction.SEEK_5:
-			handlers.onSeek(getSeekAmount(keyCode, action));
-			break;
-		case ShortcutAction.FULLSCREEN:
-			handlers.onFullscreen();
-			break;
-		case ShortcutAction.MINIPLAYER:
-			handlers.onMiniplayer();
-			break;
-		case ShortcutAction.MUTE:
-			handlers.onMute();
-			break;
-		case ShortcutAction.VOLUME: handlers.onVolume(getVolumeDelta(keyCode));
-	}
-}
-/**
-* Full play/pause key set including media keys — mirrors React's
-* component-level PlayPauseShortcuts, which extends SHORTCUTS_CONFIG.
-*/
-const PLAY_PAUSE_KEYS = [
-	"Space",
-	"KeyK",
-	"F1",
-	"F12",
-	"MediaPlay",
-	"MediaPause",
-	"MediaPlayPause"
-];
-const KEY_ACTION_MAP = new Map([...SHORTCUTS_CONFIG.flatMap((config) => config.keys.map((key) => [key, config.action])), ...PLAY_PAUSE_KEYS.map((key) => [key, ShortcutAction.PLAY_PAUSE])]);
-/** Resolve a KeyboardEvent.code to its shortcut action, or null when unmapped. */
-function resolveShortcutAction(keyCode) {
-	return KEY_ACTION_MAP.get(keyCode) ?? null;
-}
-/**
-* Digit0–Digit9 → 0–90 percent seek targets — mirrors React's
-* PercentageShortcuts table.
-*/
-function getSeekPercent(keyCode) {
-	if (!/^Digit[0-9]$/.test(keyCode)) return null;
-	return Number(keyCode.slice(5)) * 10;
-}
-
-export { PLAY_PAUSE_KEYS, SEEK_LARGE_SECONDS, SEEK_SMALL_SECONDS, SHORTCUTS_CONFIG, ShortcutAction, VOLUME_DELTA, executeShortcutAction, getSeekAmount, getSeekPercent, getVolumeDelta, resolveShortcutAction };

package/dist/lib/keyboard-utils.d.ts

@@ -1,4 +0,0 @@
-/**
- * Check if keyboard event should be ignored (input fields, textareas, etc.)
- */
-export declare function shouldIgnoreKeyboardEvent(target: EventTarget | null): boolean;

package/dist/lib/keyboard-utils.js

@@ -1,11 +0,0 @@
-// src/lib/keyboard-utils.ts
-/**
-* Check if keyboard event should be ignored (input fields, textareas, etc.)
-*/
-function shouldIgnoreKeyboardEvent(target) {
-	if (!target || !(target instanceof HTMLElement)) return false;
-	const tagName = target.tagName;
-	return tagName === "INPUT" || tagName === "TEXTAREA" || target.contentEditable === "true";
-}
-
-export { shouldIgnoreKeyboardEvent };

package/dist/lib/lifecycle-effects.d.ts

@@ -1,67 +0,0 @@
-import { VideoLoadState } from "./video-preload-config.js";
-/**
- * Pure helpers and DOM-listener factories for player lifecycle effects:
- * playback rate sync, ended handling, preload state machine, reset-on-data
- * derivations, and feed playback gating.
- *
- * Framework-agnostic. React/Lit/Vue wrappers supply the store-update callbacks;
- * this module supplies the predicates, derivations, and listener factories.
- */
-/** Valid values for `<video preload>`. */
-export type VideoPreloadAttribute = "auto" | "metadata" | "none";
-/**
- * Map a feed virtualization `VideoLoadState` to the appropriate
- * `<video preload>` attribute value.
- *
- * - UNLOADED  → "none"     (slot is far from viewport; don't fetch anything)
- * - IDLE      → "metadata" (slot is reachable but not active; fetch headers only)
- * - PRELOADING / PLAYING → "auto" (slot is active or about to be; fetch segments)
- */
-export declare function getPreloadAttribute(loadState: VideoLoadState): VideoPreloadAttribute;
-/**
- * Bind a `loadeddata` listener that re-applies the playback rate after the
- * browser resets it (most browsers reset `playbackRate` to `1.0` on each
- * `<source>` change).
- *
- * Also writes the rate immediately so that callers don't have to do so
- * separately. Returns a teardown function.
- */
-export declare function bindPlaybackRateSync(videoElement: HTMLVideoElement | null, playbackRate: number): () => void;
-/**
- * Bind an `ended` listener that invokes `onEnded()` exactly once per native
- * `ended` event. Returns a teardown function.
- */
-export declare function bindEndedListener(videoElement: HTMLVideoElement | null, onEnded: () => void): () => void;
-export interface PosterDimensions {
-  width?: number;
-  height?: number;
-}
-/**
- * Compute the aspect ratio (width / height) from poster dimensions, returning
- * `null` when either dimension is missing or zero.
- *
- * Mirrors the conditional in `useResetOnDataChangeEffect`:
- *
- *   if (videoData?.poster?.width && videoData?.poster?.height) {
- *     setAspectRatio(videoData.poster.width / videoData.poster.height);
- *   }
- */
-export declare function getAspectRatioFromPoster(poster: PosterDimensions | undefined): number | null;
-export interface FeedPlaybackDecisionInput {
-  isFeed: boolean;
-  isCurrent: boolean;
-  loadState: VideoLoadState;
-  showSpinner: boolean;
-  videoReadyState: number;
-}
-export type FeedPlaybackAction = "play" | "pause" | "none";
-/**
- * Decide what a feed-virtualized player should do given the current slot state.
- *
- * - In a non-feed context, returns "none" (caller handles its own playback).
- * - If the slot is not current, returns "pause" so the off-screen player stops.
- * - If the slot is current, in PLAYING load state, not spinning, and the video
- *   has enough data (readyState >= 2), returns "play".
- * - Otherwise returns "none" (still loading / preloading; wait).
- */
-export declare function getFeedPlaybackAction({ isFeed, isCurrent, loadState, showSpinner, videoReadyState }: FeedPlaybackDecisionInput): FeedPlaybackAction;

package/dist/lib/lifecycle-effects.js

@@ -1,78 +0,0 @@
-import { VideoLoadState } from "./video-preload-config.js";
-
-// src/lib/lifecycle-effects.ts
-/**
-* Map a feed virtualization `VideoLoadState` to the appropriate
-* `<video preload>` attribute value.
-*
-* - UNLOADED  → "none"     (slot is far from viewport; don't fetch anything)
-* - IDLE      → "metadata" (slot is reachable but not active; fetch headers only)
-* - PRELOADING / PLAYING → "auto" (slot is active or about to be; fetch segments)
-*/
-function getPreloadAttribute(loadState) {
-	switch (loadState) {
-		case VideoLoadState.UNLOADED: return "none";
-		case VideoLoadState.IDLE: return "metadata";
-		case VideoLoadState.PRELOADING:
-		case VideoLoadState.PLAYING: return "auto";
-	}
-}
-/**
-* Bind a `loadeddata` listener that re-applies the playback rate after the
-* browser resets it (most browsers reset `playbackRate` to `1.0` on each
-* `<source>` change).
-*
-* Also writes the rate immediately so that callers don't have to do so
-* separately. Returns a teardown function.
-*/
-function bindPlaybackRateSync(videoElement, playbackRate) {
-	if (!videoElement) return () => void 0;
-	videoElement.playbackRate = playbackRate;
-	const handler = () => {
-		videoElement.playbackRate = playbackRate;
-	};
-	videoElement.addEventListener("loadeddata", handler);
-	return () => videoElement.removeEventListener("loadeddata", handler);
-}
-/**
-* Bind an `ended` listener that invokes `onEnded()` exactly once per native
-* `ended` event. Returns a teardown function.
-*/
-function bindEndedListener(videoElement, onEnded) {
-	if (!videoElement) return () => void 0;
-	videoElement.addEventListener("ended", onEnded);
-	return () => videoElement.removeEventListener("ended", onEnded);
-}
-/**
-* Compute the aspect ratio (width / height) from poster dimensions, returning
-* `null` when either dimension is missing or zero.
-*
-* Mirrors the conditional in `useResetOnDataChangeEffect`:
-*
-*   if (videoData?.poster?.width && videoData?.poster?.height) {
-*     setAspectRatio(videoData.poster.width / videoData.poster.height);
-*   }
-*/
-function getAspectRatioFromPoster(poster) {
-	if (!poster?.width || !poster?.height) return null;
-	return poster.width / poster.height;
-}
-/**
-* Decide what a feed-virtualized player should do given the current slot state.
-*
-* - In a non-feed context, returns "none" (caller handles its own playback).
-* - If the slot is not current, returns "pause" so the off-screen player stops.
-* - If the slot is current, in PLAYING load state, not spinning, and the video
-*   has enough data (readyState >= 2), returns "play".
-* - Otherwise returns "none" (still loading / preloading; wait).
-*/
-function getFeedPlaybackAction({ isFeed, isCurrent, loadState, showSpinner, videoReadyState }) {
-	if (!isFeed) return "none";
-	if (!isCurrent) return "pause";
-	if (loadState !== VideoLoadState.PLAYING) return "none";
-	if (showSpinner) return "none";
-	if (videoReadyState < 2) return "none";
-	return "play";
-}
-
-export { bindEndedListener, bindPlaybackRateSync, getAspectRatioFromPoster, getFeedPlaybackAction, getPreloadAttribute };

package/dist/lib/loading-debounce.d.ts

@@ -1,26 +0,0 @@
-/**
- * Delay in milliseconds before showing the loading spinner
- * This prevents flash-of-spinner for brief buffering moments
- */
-export declare const LOADING_SPINNER_DELAY_MS = 300;
-export interface LoadingDebounceState {
-  timerId: ReturnType<typeof setTimeout> | null;
-}
-export interface UpdateLoadingStateOptions {
-  state: LoadingDebounceState;
-  shouldShow: boolean;
-  onShow: () => void;
-  onHide: () => void;
-}
-/**
- * Create initial loading debounce state
- */
-export declare function createLoadingDebounceState(): LoadingDebounceState;
-/**
- * Update loading state with debounce
- */
-export declare function updateLoadingState(options: UpdateLoadingStateOptions): void;
-/**
- * Clean up loading debounce state (clear any pending timers)
- */
-export declare function cleanupLoadingDebounce(state: LoadingDebounceState): void;