@rixl/media-core 1.0.1 → 1.1.0

package/dist/lib/loading-debounce.js

@@ -1,38 +0,0 @@
-// src/lib/loading-debounce.ts
-/**
-* Delay in milliseconds before showing the loading spinner
-* This prevents flash-of-spinner for brief buffering moments
-*/
-const LOADING_SPINNER_DELAY_MS = 300;
-/**
-* Create initial loading debounce state
-*/
-function createLoadingDebounceState() {
-	return { timerId: null };
-}
-/**
-* Update loading state with debounce
-*/
-function updateLoadingState(options) {
-	const { state, shouldShow, onShow, onHide } = options;
-	if (state.timerId !== null) {
-		clearTimeout(state.timerId);
-		state.timerId = null;
-	}
-	if (shouldShow) state.timerId = setTimeout(() => {
-		state.timerId = null;
-		onShow();
-	}, 300);
-	else onHide();
-}
-/**
-* Clean up loading debounce state (clear any pending timers)
-*/
-function cleanupLoadingDebounce(state) {
-	if (state.timerId !== null) {
-		clearTimeout(state.timerId);
-		state.timerId = null;
-	}
-}
-
-export { LOADING_SPINNER_DELAY_MS, cleanupLoadingDebounce, createLoadingDebounceState, updateLoadingState };

package/dist/lib/numbers.d.ts

@@ -1,6 +0,0 @@
-/**
- * Clamp a value between min and max bounds
- */
-export declare function clamp(value: number, min: number, max: number): number;
-export declare function formatNumber(number: number): string;
-export declare function formatNumberSm(number: number): string;

package/dist/lib/numbers.js

@@ -1,36 +0,0 @@
-// src/lib/numbers.ts
-/**
-* Clamp a value between min and max bounds
-*/
-function clamp(value, min, max) {
-	return Math.max(min, Math.min(max, value));
-}
-function formatNumber(number) {
-	if (number < 1e4) return number.toString();
-	const units = [
-		"",
-		"k",
-		"M",
-		"B"
-	];
-	const logBase1000 = Math.log10(number) / 3 | 0;
-	const scaledNumber = number / 1e3 ** logBase1000;
-	let strNumber = (Math.floor(scaledNumber * 10) / 10).toString();
-	if (strNumber.includes(".")) strNumber = strNumber.replace(/\.0$/, "");
-	return strNumber + units[logBase1000];
-}
-function formatNumberSm(number) {
-	const units = [
-		"",
-		"k",
-		"M",
-		"B"
-	];
-	const logBase1000 = Math.log10(number) / 3 | 0;
-	const scaledNumber = number / 1e3 ** logBase1000;
-	let strNumber = (Math.floor(scaledNumber * 10) / 10).toString();
-	if (strNumber.includes(".")) strNumber = strNumber.replace(/\.0$/, "");
-	return strNumber + units[logBase1000];
-}
-
-export { clamp, formatNumber, formatNumberSm };

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

@@ -1,16 +0,0 @@
-/**
- * Utility functions for Picture-in-Picture logic
- */
-/**
- * Check if a video element is currently in Picture-in-Picture mode.
- *
- * Browsers disagree for a video inside shadow DOM: by the spec,
- * `document.pictureInPictureElement` is retargeted to the shadow host and the
- * owning ShadowRoot reports the video, but Chromium reports the video on the
- * document and nothing on the ShadowRoot. Either match counts.
- */
-export declare function isVideoPictureInPicture(video: HTMLVideoElement | null): boolean;
-/**
- * Helper to toggle PIP mode safely
- */
-export declare function togglePictureInPicture(video: HTMLVideoElement | null): Promise<void>;

package/dist/lib/pip-utils.js

@@ -1,32 +0,0 @@
-// src/lib/pip-utils.ts
-/**
-* Utility functions for Picture-in-Picture logic
-*/
-/**
-* Check if a video element is currently in Picture-in-Picture mode.
-*
-* Browsers disagree for a video inside shadow DOM: by the spec,
-* `document.pictureInPictureElement` is retargeted to the shadow host and the
-* owning ShadowRoot reports the video, but Chromium reports the video on the
-* document and nothing on the ShadowRoot. Either match counts.
-*/
-function isVideoPictureInPicture(video) {
-	if (!video) return false;
-	if (document.pictureInPictureElement === video) return true;
-	const root = video.getRootNode();
-	return root instanceof ShadowRoot && root.pictureInPictureElement === video;
-}
-/**
-* Helper to toggle PIP mode safely
-*/
-async function togglePictureInPicture(video) {
-	if (!video) return;
-	try {
-		if (isVideoPictureInPicture(video)) await document.exitPictureInPicture();
-		else await video.requestPictureInPicture();
-	} catch (err) {
-		console.error("Error toggling PIP:", err);
-	}
-}
-
-export { isVideoPictureInPicture, togglePictureInPicture };

package/dist/lib/playback-handlers.d.ts

@@ -1,33 +0,0 @@
-import { UUID } from "../types/uuid.js";
-import { VideoData } from "../types/video.js";
-/**
- * Calculate aspect ratio from video element dimensions
- * @returns aspect ratio (width/height) or undefined if dimensions not available
- */
-export declare function calculateAspectRatio(videoElement: HTMLVideoElement | null, videoData: VideoData | undefined): number | undefined;
-export interface PlaybackHandlerCallbacks {
-  onSegmentStart: () => void;
-  onSegmentEnd: () => void;
-  onRestartSegment: (isPaused?: boolean) => void;
-  onShowSpinner: (show: boolean) => void;
-}
-/**
- * Handle video play event
- */
-export declare function handleVideoPlay(playerId: UUID, callbacks: Pick<PlaybackHandlerCallbacks, "onSegmentStart">): void;
-/**
- * Handle video pause event
- */
-export declare function handleVideoPause(playerId: UUID, callbacks: Pick<PlaybackHandlerCallbacks, "onSegmentEnd">): void;
-/**
- * Handle video rate change event
- */
-export declare function handleVideoRateChange(playerId: UUID, videoElement: HTMLVideoElement | null, callbacks: Pick<PlaybackHandlerCallbacks, "onRestartSegment">): void;
-/**
- * Handle video error event
- */
-export declare function handleVideoError(playerId: UUID, callbacks: Pick<PlaybackHandlerCallbacks, "onShowSpinner">): void;
-/**
- * Update player loading state in store
- */
-export declare function updatePlayerLoadingState(playerId: UUID, isLoading: boolean): void;

package/dist/lib/playback-handlers.js

@@ -1,51 +0,0 @@
-import { playerStateStore } from "../store/player-store.js";
-
-// src/lib/playback-handlers.ts
-/**
-* Calculate aspect ratio from video element dimensions
-* @returns aspect ratio (width/height) or undefined if dimensions not available
-*/
-function calculateAspectRatio(videoElement, videoData) {
-	if (!videoElement || !videoData) return void 0;
-	if (videoElement.videoWidth === 0 || videoElement.videoHeight === 0) return void 0;
-	return videoElement.videoWidth / videoElement.videoHeight;
-}
-/**
-* Handle video play event
-*/
-function handleVideoPlay(playerId, callbacks) {
-	playerStateStore.setPaused(playerId, false);
-	playerStateStore.setEnded(playerId, false);
-	callbacks.onSegmentStart();
-}
-/**
-* Handle video pause event
-*/
-function handleVideoPause(playerId, callbacks) {
-	playerStateStore.setPaused(playerId, true);
-	callbacks.onSegmentEnd();
-}
-/**
-* Handle video rate change event
-*/
-function handleVideoRateChange(playerId, videoElement, callbacks) {
-	const playbackRate = videoElement?.playbackRate;
-	if (typeof playbackRate === "number") playerStateStore.setPlaybackRate(playerId, playbackRate);
-	callbacks.onRestartSegment();
-}
-/**
-* Handle video error event
-*/
-function handleVideoError(playerId, callbacks) {
-	playerStateStore.setPaused(playerId, true);
-	playerStateStore.setLoading(playerId, false);
-	callbacks.onShowSpinner(false);
-}
-/**
-* Update player loading state in store
-*/
-function updatePlayerLoadingState(playerId, isLoading) {
-	playerStateStore.setLoading(playerId, isLoading);
-}
-
-export { calculateAspectRatio, handleVideoError, handleVideoPause, handleVideoPlay, handleVideoRateChange, updatePlayerLoadingState };

package/dist/lib/playback-slider.d.ts

@@ -1,23 +0,0 @@
-/**
- * Fill percentage for the custom playback-speed slider. Piecewise on purpose:
- * normal speed (1.0x) sits at the visual middle of the track, with min–1.0
- * mapped to the lower half and 1.0–max to the upper half. Note the pointer
- * mapping below is linear — the same asymmetry the React slider ships with.
- */
-export declare function computePlaybackFillPercentage(value: number, min: number, max: number): number;
-export interface PlaybackPointerOptions {
-  rect: {
-    left: number;
-    width: number;
-  };
-  clientX: number;
-  min: number;
-  max: number;
-  step: number;
-}
-/**
- * Linear pointer-position → playback value: clamped to the track, snapped to
- * the step grid, formatted to two decimals (the value React persists via
- * settingsStore.setCustomPlayback).
- */
-export declare function computePlaybackValueFromPointer({ rect, clientX, min, max, step }: PlaybackPointerOptions): number;

package/dist/lib/playback-slider.js

@@ -1,24 +0,0 @@
-import { clamp } from "./numbers.js";
-
-// src/lib/playback-slider.ts
-/**
-* Fill percentage for the custom playback-speed slider. Piecewise on purpose:
-* normal speed (1.0x) sits at the visual middle of the track, with min–1.0
-* mapped to the lower half and 1.0–max to the upper half. Note the pointer
-* mapping below is linear — the same asymmetry the React slider ships with.
-*/
-function computePlaybackFillPercentage(value, min, max) {
-	return value >= 1 ? 50 + (value - 1) / (max - 1) * 50 : (value - min) / (1 - min) * 50;
-}
-/**
-* Linear pointer-position → playback value: clamped to the track, snapped to
-* the step grid, formatted to two decimals (the value React persists via
-* settingsStore.setCustomPlayback).
-*/
-function computePlaybackValueFromPointer({ rect, clientX, min, max, step }) {
-	const rawValue = min + clamp((clientX - rect.left) / rect.width, 0, 1) * (max - min);
-	const steppedValue = Math.round(rawValue / step) * step;
-	return Number(clamp(steppedValue, min, max).toFixed(2));
-}
-
-export { computePlaybackFillPercentage, computePlaybackValueFromPointer };

package/dist/lib/player-labels.d.ts

@@ -1,23 +0,0 @@
-export declare const PLAYER_LANGUAGES: readonly ["en", "de", "es", "fr", "it", "pl", "ru", "tr", "uk"];
-export type PlayerLanguage = (typeof PLAYER_LANGUAGES)[number];
-/**
- * Control-bar strings for the player UI. Values mirror the `controls.*` and
- * `captions.toggle` keys of packages/react/src/locales/<lang>.json — one
- * label per button regardless of state, keyboard hint included, same as the
- * React tooltips.
- */
-export interface PlayerControlLabels {
-  play: string;
-  pause: string;
-  replay: string;
-  mute: string;
-  unmute: string;
-  volume: string;
-  settings: string;
-  pip: string;
-  fullScreen: string;
-  captionsToggle: string;
-}
-/** Same semantics as the React resolveSupportedLanguage: lowercase exact match, fallback en. */
-export declare function resolvePlayerLanguage(code: string | null | undefined): PlayerLanguage;
-export declare function getPlayerControlLabels(code: string | null | undefined): PlayerControlLabels;

package/dist/lib/player-labels.js

@@ -1,132 +0,0 @@
-// src/lib/player-labels.ts
-const PLAYER_LANGUAGES = [
-	"en",
-	"de",
-	"es",
-	"fr",
-	"it",
-	"pl",
-	"ru",
-	"tr",
-	"uk"
-];
-const LABELS = {
-	en: {
-		play: "Play (k)",
-		pause: "Pause (k)",
-		replay: "Replay",
-		mute: "Mute (m)",
-		unmute: "Unmute (m)",
-		volume: "Volume",
-		settings: "Settings",
-		pip: "Miniplayer (i)",
-		fullScreen: "Full screen (f)",
-		captionsToggle: "Subtitles/close captions (c)"
-	},
-	de: {
-		play: "Wiedergabe (k)",
-		pause: "Pause (k)",
-		replay: "Wiederholen",
-		mute: "Stummschalten (m)",
-		unmute: "Stummschaltung aufheben (m)",
-		volume: "Lautstärke",
-		settings: "Einstellungen",
-		pip: "Bild-im-Bild (i)",
-		fullScreen: "Vollbild (f)",
-		captionsToggle: "Untertitel/CC (c)"
-	},
-	es: {
-		play: "Reproducir (k)",
-		pause: "Pausar (k)",
-		replay: "Repetir",
-		mute: "Silenciar (m)",
-		unmute: "Reactivar sonido (m)",
-		volume: "Volumen",
-		settings: "Configuración",
-		pip: "Minirreproductor (i)",
-		fullScreen: "Pantalla completa (f)",
-		captionsToggle: "Subtítulos (c)"
-	},
-	fr: {
-		play: "Lire (k)",
-		pause: "Pause (k)",
-		replay: "Rejouer",
-		mute: "Muet (m)",
-		unmute: "Réactiver le son (m)",
-		volume: "Volume",
-		settings: "Paramètres",
-		pip: "Mini-lecteur (i)",
-		fullScreen: "Plein écran (f)",
-		captionsToggle: "Sous-titres/CC (c)"
-	},
-	it: {
-		play: "Riproduci (k)",
-		pause: "Pausa (k)",
-		replay: "Rivedi",
-		mute: "Disattiva audio (m)",
-		unmute: "Riattiva audio (m)",
-		volume: "Volume",
-		settings: "Impostazioni",
-		pip: "Miniplayer (i)",
-		fullScreen: "Schermo intero (f)",
-		captionsToggle: "Sottotitoli (c)"
-	},
-	pl: {
-		play: "Odtwórz (k)",
-		pause: "Pauza (k)",
-		replay: "Odtwórz ponownie",
-		mute: "Wycisz (m)",
-		unmute: "Wyłącz wyciszenie (m)",
-		volume: "Głośność",
-		settings: "Ustawienia",
-		pip: "Mini-odtwarzacz (i)",
-		fullScreen: "Pełny ekran (f)",
-		captionsToggle: "Napisy (c)"
-	},
-	ru: {
-		play: "Воспроизвести (k)",
-		pause: "Пауза (k)",
-		replay: "Воспроизвести снова",
-		mute: "Выключить звук (m)",
-		unmute: "Включить звук (m)",
-		volume: "Громкость",
-		settings: "Настройки",
-		pip: "Мини-плеер (i)",
-		fullScreen: "Во весь экран (f)",
-		captionsToggle: "Субтитры (c)"
-	},
-	tr: {
-		play: "Oynat (k)",
-		pause: "Duraklat (k)",
-		replay: "Tekrar oyna",
-		mute: "Sessize al (m)",
-		unmute: "Sesi aç (m)",
-		volume: "Ses düzeyi",
-		settings: "Ayarlar",
-		pip: "Mini oynatıcı (i)",
-		fullScreen: "Tam ekran (f)",
-		captionsToggle: "Altyazılar (c)"
-	},
-	uk: {
-		play: "Відтворити (k)",
-		pause: "Пауза (k)",
-		replay: "Повторити",
-		mute: "Вимкнути звук (m)",
-		unmute: "Увімкнути звук (m)",
-		volume: "Гучність",
-		settings: "Налаштування",
-		pip: "Міні-плеєр (i)",
-		fullScreen: "На весь екран (f)",
-		captionsToggle: "Субтитри (c)"
-	}
-};
-/** Same semantics as the React resolveSupportedLanguage: lowercase exact match, fallback en. */
-function resolvePlayerLanguage(code) {
-	const normalized = (code ?? "").toLowerCase();
-	return PLAYER_LANGUAGES.find((lang) => lang === normalized) ?? "en";
-}
-function getPlayerControlLabels(code) {
-	return LABELS[resolvePlayerLanguage(code)];
-}
-
-export { PLAYER_LANGUAGES, getPlayerControlLabels, resolvePlayerLanguage };

package/dist/lib/player-menu-labels.d.ts

@@ -1,80 +0,0 @@
-import { FontFamilyKey } from "../store/settings/constants.js";
-/**
- * Settings-menu strings, mirroring the corresponding keys of
- * packages/react/src/locales/<lang>.json verbatim (quality.*, audio.*,
- * playback.*, captions.* and common.*). Edge-style options are keyed by the
- * EDGE_STYLES runtime values and font families by FontFamilyKey, so menus can
- * look labels up directly from the constants they render.
- *
- * Import this module from the lazy settings chunk only — it must not be
- * pulled into the initial player bundle.
- */
-export interface PlayerMenuLabels {
-  quality: {
-    title: string;
-    auto: string;
-  };
-  audio: {
-    title: string;
-    noTracks: string;
-  };
-  playback: {
-    speed: string;
-    custom: string;
-    normal: string;
-  };
-  captions: {
-    title: string;
-    off: string;
-    style: string;
-    font: string;
-    background: string;
-    window: string;
-    resetAll: string;
-    edgeStyle: {
-      title: string;
-      options: Record<string, string>;
-    };
-    fontFamilies: Record<FontFamilyKey, string>;
-  };
-  stats: {
-    title: string;
-    copyDebug: string;
-    videoId: string;
-    playerId: string;
-    viewport: string;
-    dropped: string;
-    resolution: string;
-    volume: string;
-    codecs: string;
-    color: string;
-    connectionSpeed: string;
-    bufferHealth: string;
-  };
-  shortcuts: {
-    title: string;
-    playPause: string;
-    seek10s: string;
-    seek5s: string;
-    pip: string;
-    fullscreen: string;
-    mute: string;
-    volume: string;
-  };
-  colors: Record<string, string>;
-  common: {
-    back: string;
-    family: string;
-    more: string;
-    less: string;
-    settings: string;
-    size: string;
-    opacity: string;
-    color: string;
-    reset: string;
-    custom: string;
-    options: string;
-    off: string;
-  };
-}
-export declare function getPlayerMenuLabels(code: string | null | undefined): PlayerMenuLabels;