@therealtinhtute/baroiplayer 1.0.0

package/src/index.ts

@@ -0,0 +1,216 @@
+// ========================================
+// 🎯 BaroiPlayer - Primary Components
+// ========================================
+// Main media player components - use these for most cases
+
+// Primary All-in-One Players (Recommended)
+export { MediaPlayer } from "./components/media-player"
+export { VideoPlayer } from "./components/video-player"
+export { AudioPlayer } from "./components/audio-player"
+
+// Modern Compound Components (Advanced)
+export { MediaPlayerRoot } from "./components/media-player-root"
+export type { MediaPlayerRootProps } from "./components/media-player-root"
+
+// Enhanced Player (React 19 Optimized)
+export { EnhancedMediaPlayer } from "./components/enhanced/media-player-enhanced"
+
+// ========================================
+// 🎨 Component Variants
+// ========================================
+// Specialized player variants for different use cases
+
+// Minimal Player (Clean & Simple)
+export {
+	MinimalMediaPlayer,
+	SimpleMinimalPlayer
+} from "./components/variants/minimal"
+export type { MinimalMediaPlayerProps } from "./components/variants/minimal"
+
+// ========================================
+// 🛠️ Advanced Features
+// ========================================
+// Advanced components for specific requirements
+
+// HLS Streaming
+export { MediaPlayerHLS } from "./components/media-player-hls"
+
+// Enhanced Controls & Features
+export {
+	ChaptersPanel,
+	PictureInPictureButton,
+	PlaybackSpeedSelector,
+	QualitySelector,
+	SubtitleSelector
+} from "./components/enhanced/advanced-features"
+
+// Enhanced Controls
+export {
+	EnhancedPlayButton,
+	EnhancedSeekBar,
+	EnhancedTimeDisplay,
+	EnhancedVolumeControl,
+	EnhancedControlBar
+} from "./components/enhanced/enhanced-controls"
+
+// React 19 Concurrent Features
+export {
+	ConcurrentMedia,
+	MediaSuspense,
+	MediaLoading,
+	MediaErrorBoundary,
+	useDeferredMediaLoading
+} from "./components/media-suspense"
+
+// ========================================
+// 🎣 Core Hooks
+// ========================================
+// React hooks for media player functionality
+
+// Core Hooks (Most Used)
+export { useMediaPlayer } from "./hooks/use-media-player"
+export { useMediaState } from "./hooks/use-media-state"
+export { useMediaControls } from "./hooks/useMediaControls"
+
+// React 19 Enhanced Hooks
+export { useEnhancedMediaPlayer } from "./hooks/use-enhanced-media-player"
+export { useMediaActions } from "./hooks/use-media-actions"
+export { useMediaActionState } from "./hooks/use-media-actions"
+
+// Performance & Optimization Hooks
+export {
+	useIntelligentPreloading
+} from "./hooks/use-intelligent-preloading"
+
+// Specialized Hooks
+export {
+	useKeyboardControls
+} from "./hooks/use-keyboard-controls"
+
+export {
+	useTouchGestures
+} from "./hooks/use-touch-gestures"
+
+export { useScreenshot } from "./hooks/useScreenshot"
+export { useSubtitles } from "./hooks/useSubtitles"
+
+// ========================================
+// 🔧 Utilities & Types
+// ========================================
+// Utilities, types, and helper functions
+
+// Core Utilities
+export { formatTime, parseTime } from "./lib/format-time"
+export { cn } from "./lib/utils"
+
+// Media Type Detection
+export {
+	getMediaTypeFromUrl,
+	getMimeTypeFromUrl,
+	SUPPORTED_AUDIO_FORMATS,
+	SUPPORTED_VIDEO_FORMATS,
+	AUDIO_MIME_TYPES,
+	VIDEO_MIME_TYPES
+} from "./types"
+
+// Performance Monitoring
+export {
+	PerformanceMonitor
+} from "./core/performance"
+
+// ========================================
+// 📚 Context & State
+// ========================================
+// React context and state management
+
+// Media Context
+export {
+	MediaProvider
+} from "./context/media-provider"
+
+export {
+	useMediaContext,
+	useMediaDispatch,
+	useMediaSelector,
+	useOptimisticMediaSelector
+} from "./context/media-context"
+
+// Enhanced State Management (React 19)
+export {
+	createEnhancedMediaStore
+} from "./context/media-store"
+
+// ========================================
+// 🎨 Icons & Styling
+// ========================================
+// Icon components and styling utilities
+
+// Icon Sets
+export {
+	defaultMinimalIcons,
+	MinimalPlayIcon,
+	MinimalPauseIcon,
+	MinimalVolumeIcon,
+	MinimalFullscreenIcon
+} from "./components/icons"
+export type { IconProps, IconSet } from "./components/icons"
+
+// ========================================
+// ⚠️ Legacy Exports (Deprecated)
+// ========================================
+// These will be removed in v2.0 - migrate to the APIs above
+// Each usage will show a deprecation warning in the console
+
+// Legacy Components (with deprecation warnings)
+export {
+	ModernMediaPlayer,
+	SimpleVideoPlayer,
+	LegacyPlayButton as PlayButton,
+	LegacySeekBar as SeekBar,
+	LegacyTimeDisplay as TimeDisplay,
+	LegacyVolumeControl as VolumeControl,
+	LegacyFullscreenButton as FullscreenButton
+} from "./components/legacy"
+
+// Legacy Hooks (with deprecation warnings)
+export {
+	useVideoPlayer,
+	useEnhancedSubtitles
+} from "./hooks/legacy"
+
+// ========================================
+// 🔒 Development Tools
+// ========================================
+// Development and debugging tools (dev only)
+
+export { DebugPanel } from "./components/enhanced/debug-panel"
+export { MediaResourcePreloader } from "./components/ui/media-resource-preloader"
+
+// ========================================
+// 📖 Type Exports
+// ========================================
+// Complete type definitions
+
+export type {
+	// Core Media Types
+	MediaSource,
+	MediaFormat,
+	MediaPlayerConfig,
+	MediaPlayerState,
+	MediaCapabilities,
+
+	// Event Types
+	MediaEventMap,
+	MediaEventType,
+	MediaErrorEvent,
+	MediaProgressEvent,
+	MediaTimeUpdateEvent,
+	MediaVolumeChangeEvent,
+
+	// Component Props
+	VideoFormat,
+	AudioFormat,
+	VideoMimeType,
+	AudioMimeType,
+
+	} from "./types"

package/src/lib/deprecation.ts

@@ -0,0 +1,51 @@
+/**
+ * Deprecation warning utility
+ * Shows console warnings for deprecated components and hooks
+ */
+
+const deprecationWarnings = new Set<string>()
+
+export function showDeprecationWarning(
+	itemName: string,
+	replacement: string,
+	version: string = "2.0"
+) {
+	const key = `${itemName}-${replacement}-${version}`
+
+	if (deprecationWarnings.has(key)) {
+		return // Already shown this warning
+	}
+
+	deprecationWarnings.add(key)
+
+	console.warn(
+		`⚠️ [BaroiPlayer] DEPRECATION WARNING: ${itemName} is deprecated and will be removed in v${version}.` +
+		`\n   Please replace it with: ${replacement}` +
+		`\n   See https://github.com/baroi/baroiplayer/blob/main/MIGRATION.md for migration guide.`
+	)
+}
+
+export function createDeprecatedComponent<T>(
+	ComponentName: string,
+	replacement: string,
+	component: T
+): T {
+	const DeprecatedComponent = component as any
+
+	// Add deprecation warning to the component
+	if (typeof DeprecatedComponent === 'function') {
+		const originalComponent = DeprecatedComponent
+		const WrappedComponent = function (props: any) {
+			showDeprecationWarning(ComponentName, replacement)
+			return originalComponent(props)
+		}
+
+		// Copy over displayName and other properties
+		Object.setPrototypeOf(WrappedComponent, originalComponent)
+		WrappedComponent.displayName = `Deprecated(${ComponentName})`
+
+		return WrappedComponent as T
+	}
+
+	return component
+}

package/src/lib/format-time.ts

@@ -0,0 +1,37 @@
+/**
+ * Formats time in seconds to a human-readable string (MM:SS or HH:MM:SS)
+ */
+export function formatTime(seconds: number): string {
+	if (isNaN(seconds) || !isFinite(seconds)) {
+		return "0:00"
+	}
+
+	const hours = Math.floor(seconds / 3600)
+	const minutes = Math.floor((seconds % 3600) / 60)
+	const secs = Math.floor(seconds % 60)
+
+	if (hours > 0) {
+		return `${hours}:${minutes.toString().padStart(2, "0")}:${secs.toString().padStart(2, "0")}`
+	}
+
+	return `${minutes}:${secs.toString().padStart(2, "0")}`
+}
+
+/**
+ * Parses a time string (MM:SS or HH:MM:SS) to seconds
+ */
+export function parseTime(timeString: string): number {
+	const parts = timeString.split(":").map(Number)
+
+	if (parts.length === 2) {
+		// MM:SS format
+		const [minutes = 0, seconds = 0] = parts
+		return minutes * 60 + seconds
+	} else if (parts.length === 3) {
+		// HH:MM:SS format
+		const [hours = 0, minutes = 0, seconds = 0] = parts
+		return hours * 3600 + minutes * 60 + seconds
+	}
+
+	return 0
+}

package/src/lib/index.ts

@@ -0,0 +1,3 @@
+// Utility functions
+export { formatTime, parseTime } from "./format-time";
+export { cn } from "./utils";

package/src/lib/utils.ts

@@ -0,0 +1,6 @@
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}