feat(casting): unify Chromecast and AirPlay into single casting interface

BREAKING CHANGE: Merged separate Chromecast and AirPlay implementations into unified casting system

- Created unified casting types and helpers (utils/casting/)
- Built useCasting hook that manages both protocols
- Single CastingMiniPlayer component works with both Chromecast and AirPlay
- Single casting-player modal for full-screen controls
- Protocol-aware UI: Red for Chromecast, Blue for AirPlay
- Shows device type icon (TV for Chromecast, Apple logo for AirPlay)
- Detects active protocol automatically
- Previous separate implementations (ChromecastMiniPlayer, AirPlayMiniPlayer) superseded

Benefits:
- Better UX: One cast button shows all available devices
- Cleaner architecture: Protocol differences abstracted
- Easier maintenance: Single UI codebase
- Protocol-specific logic isolated in adapters

utils/casting/helpers.ts

@@ -0,0 +1,130 @@
+/**
+ * Unified Casting Helper Functions
+ * Common utilities for both Chromecast and AirPlay
+ */
+
+import type { CastProtocol, ConnectionQuality } from "./types";
+
+/**
+ * Format milliseconds to HH:MM:SS or MM:SS
+ */
+export const formatTime = (ms: number): string => {
+  const totalSeconds = Math.floor(ms / 1000);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor((totalSeconds % 3600) / 60);
+  const seconds = totalSeconds % 60;
+
+  if (hours > 0) {
+    return `${hours}:${minutes.toString().padStart(2, "0")}:${seconds.toString().padStart(2, "0")}`;
+  }
+  return `${minutes}:${seconds.toString().padStart(2, "0")}`;
+};
+
+/**
+ * Calculate ending time based on current progress and duration
+ */
+export const calculateEndingTime = (
+  currentMs: number,
+  durationMs: number,
+): string => {
+  const remainingMs = durationMs - currentMs;
+  const endTime = new Date(Date.now() + remainingMs);
+  const hours = endTime.getHours();
+  const minutes = endTime.getMinutes();
+  const ampm = hours >= 12 ? "PM" : "AM";
+  const displayHours = hours % 12 || 12;
+
+  return `${displayHours}:${minutes.toString().padStart(2, "0")} ${ampm}`;
+};
+
+/**
+ * Determine connection quality based on bitrate
+ */
+export const getConnectionQuality = (bitrate?: number): ConnectionQuality => {
+  if (!bitrate) return "good";
+  const mbps = bitrate / 1000000;
+
+  if (mbps >= 15) return "excellent";
+  if (mbps >= 8) return "good";
+  if (mbps >= 4) return "fair";
+  return "poor";
+};
+
+/**
+ * Get poster URL for item with specified dimensions
+ */
+export const getPosterUrl = (
+  baseUrl: string | undefined,
+  itemId: string | undefined,
+  tag: string | undefined,
+  width: number,
+  height: number,
+): string | null => {
+  if (!baseUrl || !itemId) return null;
+
+  const params = new URLSearchParams({
+    maxWidth: width.toString(),
+    maxHeight: height.toString(),
+    quality: "90",
+    ...(tag && { tag }),
+  });
+
+  return `${baseUrl}/Items/${itemId}/Images/Primary?${params.toString()}`;
+};
+
+/**
+ * Truncate title to max length with ellipsis
+ */
+export const truncateTitle = (title: string, maxLength: number): string => {
+  if (title.length <= maxLength) return title;
+  return `${title.substring(0, maxLength - 3)}...`;
+};
+
+/**
+ * Check if current time is within a segment
+ */
+export const isWithinSegment = (
+  currentMs: number,
+  segment: { start: number; end: number } | null,
+): boolean => {
+  if (!segment) return false;
+  const currentSeconds = currentMs / 1000;
+  return currentSeconds >= segment.start && currentSeconds <= segment.end;
+};
+
+/**
+ * Format bitrate to human-readable string
+ */
+export const formatBitrate = (bitrate: number): string => {
+  const mbps = bitrate / 1000000;
+  if (mbps >= 1) {
+    return `${mbps.toFixed(1)} Mbps`;
+  }
+  return `${(bitrate / 1000).toFixed(0)} Kbps`;
+};
+
+/**
+ * Get protocol display name
+ */
+export const getProtocolName = (protocol: CastProtocol): string => {
+  switch (protocol) {
+    case "chromecast":
+      return "Chromecast";
+    case "airplay":
+      return "AirPlay";
+  }
+};
+
+/**
+ * Get protocol icon name
+ */
+export const getProtocolIcon = (
+  protocol: CastProtocol,
+): "tv" | "logo-apple" => {
+  switch (protocol) {
+    case "chromecast":
+      return "tv";
+    case "airplay":
+      return "logo-apple";
+  }
+};

utils/casting/types.ts

@@ -0,0 +1,87 @@
+/**
+ * Unified Casting Types and Options
+ * Abstracts Chromecast and AirPlay into a common interface
+ */
+
+export type CastProtocol = "chromecast" | "airplay";
+
+export interface CastDevice {
+  id: string;
+  name: string;
+  protocol: CastProtocol;
+  type?: string;
+}
+
+export interface CastPlayerState {
+  isConnected: boolean;
+  isPlaying: boolean;
+  currentItem: any | null;
+  currentDevice: CastDevice | null;
+  protocol: CastProtocol | null;
+  progress: number;
+  duration: number;
+  volume: number;
+  showControls: boolean;
+  isBuffering: boolean;
+}
+
+export interface CastSegmentData {
+  intro: { start: number; end: number } | null;
+  credits: { start: number; end: number } | null;
+  recap: { start: number; end: number } | null;
+  commercial: Array<{ start: number; end: number }>;
+  preview: Array<{ start: number; end: number }>;
+}
+
+export interface AudioTrack {
+  index: number;
+  language: string;
+  codec: string;
+  displayTitle: string;
+}
+
+export interface SubtitleTrack {
+  index: number;
+  language: string;
+  codec: string;
+  displayTitle: string;
+  isForced: boolean;
+}
+
+export interface MediaSource {
+  id: string;
+  name: string;
+  bitrate?: number;
+  container: string;
+}
+
+export const CASTING_CONSTANTS = {
+  POSTER_WIDTH: 300,
+  POSTER_HEIGHT: 450,
+  ANIMATION_DURATION: 300,
+  CONTROL_HIDE_DELAY: 5000,
+  PROGRESS_UPDATE_INTERVAL: 1000,
+  SEEK_FORWARD_SECONDS: 10,
+  SEEK_BACKWARD_SECONDS: 10,
+} as const;
+
+export const DEFAULT_CAST_STATE: CastPlayerState = {
+  isConnected: false,
+  isPlaying: false,
+  currentItem: null,
+  currentDevice: null,
+  protocol: null,
+  progress: 0,
+  duration: 0,
+  volume: 0.5,
+  showControls: true,
+  isBuffering: false,
+};
+
+export type ConnectionQuality = "excellent" | "good" | "fair" | "poor";
+
+// Protocol-specific colors for UI differentiation
+export const PROTOCOL_COLORS = {
+  chromecast: "#e50914", // Red (Google Cast)
+  airplay: "#007AFF", // Blue (Apple)
+} as const;