strataplayer 1.0.6 → 1.0.9

package/README.md

@@ -30,54 +30,78 @@ While the UI layer is powered by the high-performance concurrent rendering of Re
 
 1.  **Universal Compatibility:** Write once, run anywhere. Whether you are building a static HTML site or a complex Next.js application, the implementation remains consistent.
 2.  **State Isolation:** The playback engine runs on a detached state store (`NanoStore`). This allows the player to handle micro-updates (video time, download progress) internally without triggering re-renders in your parent application.
-3.  **Opt-in Complexity:** The core is lightweight. Advanced capabilities like HLS/DASH adaptive streaming, analytics, or casting are treated as plugins, keeping your bundle size strictly minimal unless needed.
+3.  **Modular Architecture:** The core is ultra-lightweight. Heavy dependencies like HLS (`.m3u8`) are entirely opt-in via sub-path imports, keeping your main bundle size minimal.
 
 ## ✨ Features
 
-### Engine & Performance
-
 - **Framework Agnostic:** First-class support for React, with a mounting API for Vue, Svelte, and Vanilla JS.
 - **Resilient Network Handling:** Automatic exponential backoff and retry logic for unstable connections.
-- **Adaptive Streaming:** Native support for HLS (`.m3u8`) and DASH via plugin architecture.
+- **Adaptive Streaming:** Plugin-based support for HLS (powered by `hls.js`).
 - **Audio Boost Engine:** Integrated Web Audio API nodes allowing volume boosting up to 300%.
-
-### Visuals & Interface
-
-- **Themeable System:** 4 built-in distinct themes (Default, Pixel, Game, Hacker) with CSS variable support.
+- **Themeable System:** 4 built-in distinct themes (Default, Pixel, Game, Hacker).
 - **Advanced Subtitles:** DOM-based rendering supporting custom positioning, shadows, and runtime sync adjustment.
-- **Mobile Optimized:** Touch gestures for seeking (double-tap), scrubbing, and volume control.
-- **Google Cast:** Native Chromecast integration.
 
 ## 🚀 Installation
 
+Install the core player:
+
 ```bash
 npm install strataplayer
 ```
 
+If you need HLS support (streaming `.m3u8` files), install the peer dependency:
+
+```bash
+npm install hls.js
+```
+
 ## 💻 Usage
 
-### React
+### 1. React + MP4 (Basic)
+
+For standard video files, simply import the component. No extra plugins required.
+
+```tsx
+import { StrataPlayer } from "strataplayer";
+import "strataplayer/style.css";
+
+const App = () => {
+  return (
+    <StrataPlayer
+      src="https://example.com/video.mp4"
+      theme="default"
+      themeColor="#6366f1"
+    />
+  );
+};
+```
+
+### 2. React + HLS (Advanced)
+
+To play HLS streams, import the `HlsPlugin` from the sub-path `strataplayer/hls`.
 
 ```tsx
 import { StrataPlayer } from "strataplayer";
+import { HlsPlugin } from "strataplayer/hls"; // Import from sub-path
 import "strataplayer/style.css";
 
+// Initialize plugins outside render loop or via useMemo
+const plugins = [new HlsPlugin()];
+
 const App = () => {
   return (
-    <div className="player-wrapper">
-      <StrataPlayer
-        src="https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8"
-        theme="default"
-        themeColor="#6366f1"
-      />
-    </div>
+    <StrataPlayer
+      src="https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8"
+      plugins={plugins}
+      theme="hacker"
+    />
   );
 };
 ```
 
-### Vanilla JS / Vue / Svelte / Angular
+### 3. Vanilla JS / Vue / Svelte + MP4
 
-For non-React frameworks, use the `mountStrataPlayer` helper. This mounts the player into a specific DOM node and returns an instance for cleanup and updates.
+For non-React frameworks, use the `mountStrataPlayer` helper.
 
 **index.html**
 
@@ -94,34 +118,42 @@ import "strataplayer/style.css";
 const container = document.getElementById("player-container");
 
 const instance = mountStrataPlayer(container, {
-  src: "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8",
+  src: "https://example.com/video.mp4",
   autoPlay: false,
-  theme: "hacker",
-  themeColor: "#22c55e",
-  sources: [
-    { name: "HLS Stream", url: "...", type: "hls" },
-    { name: "MP4 Fallback", url: "...", type: "mp4" },
-  ],
+  theme: "game",
 });
 
-// To update props later (e.g., change video):
-// instance.update({ src: 'new-video.mp4' });
-
-// To destroy/cleanup (e.g., in Vue onUnmounted):
+// Cleanup when done
 // instance.unmount();
 ```
 
+### 4. Vanilla JS / Vue / Svelte + HLS
+
+Just like in React, import the plugin and pass it in the config object.
+
+```javascript
+import { mountStrataPlayer } from "strataplayer";
+import { HlsPlugin } from "strataplayer/hls";
+import "strataplayer/style.css";
+
+const instance = mountStrataPlayer(document.getElementById("root"), {
+  src: "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8",
+  plugins: [new HlsPlugin()],
+});
+```
+
 ## ⚙️ Advanced Configuration
 
 ### Sources & Tracks
 
-StrataPlayer supports complex source arrays and subtitle tracks.
+StrataPlayer supports complex source arrays (for quality fallbacks) and subtitle tracks.
 
 ```javascript
 const props = {
+  // Priority order: HLS -> MP4
   sources: [
-    { name: "1080p HLS", url: "master.m3u8", type: "hls" },
-    { name: "720p MP4", url: "fallback.mp4", type: "mp4" },
+    { name: "Stream", url: "master.m3u8", type: "hls" },
+    { name: "Download", url: "fallback.mp4", type: "mp4" },
   ],
   poster: "https://example.com/poster.jpg",
   thumbnails: "https://example.com/storyboard.vtt", // For seek preview

package/dist/hls.cjs.js

@@ -0,0 +1,2 @@
+"use strict";var a=Object.defineProperty;var u=(i,s,e)=>s in i?a(i,s,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[s]=e;var n=(i,s,e)=>u(i,typeof s!="symbol"?s+"":s,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("hls.js");class c{constructor(){n(this,"name","HlsPlugin");n(this,"hls",null);n(this,"core",null)}init(s){this.core=s,this.core.events.on("load",e=>{e.type==="hls"||e.url.includes(".m3u8")?h.isSupported()?this.loadHls(e.url):this.core.video.canPlayType("application/vnd.apple.mpegurl")&&(this.core.video.src=e.url):this.hls&&(this.hls.destroy(),this.hls=null)}),this.core.events.on("quality-request",e=>{this.hls&&(this.hls.currentLevel=e)}),this.core.events.on("audio-track-request",e=>{this.hls&&(this.hls.audioTrack=e)})}loadHls(s){this.hls&&this.hls.destroy(),this.hls=new h({autoStartLoad:!0,startLevel:-1,capLevelToPlayerSize:!0}),this.hls.loadSource(s),this.hls.attachMedia(this.core.video),this.hls.on(h.Events.MANIFEST_PARSED,(e,t)=>{const r=t.levels.map((l,o)=>({height:l.height,bitrate:l.bitrate,index:o}));this.core.store.setState({qualityLevels:r})}),this.hls.on(h.Events.AUDIO_TRACKS_UPDATED,(e,t)=>{const r=t.audioTracks.map((l,o)=>({label:l.name||l.lang||`Audio ${o+1}`,language:l.lang||"",index:o}));this.core.store.setState({audioTracks:r,currentAudioTrack:this.hls.audioTrack})}),this.hls.on(h.Events.LEVEL_SWITCHED,(e,t)=>{}),this.hls.on(h.Events.ERROR,(e,t)=>{if(t.fatal){const r=t.details||"Unknown HLS Error";this.core.triggerError(r,!0)}})}destroy(){this.hls&&(this.hls.destroy(),this.hls=null)}}exports.HlsPlugin=c;
+//# sourceMappingURL=hls.cjs.js.map

package/dist/hls.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hls.cjs.js","sources":["../plugins/HlsPlugin.ts"],"sourcesContent":["\nimport { StrataCore, IPlugin } from '../core/StrataCore';\nimport Hls from 'hls.js';\n\nexport class HlsPlugin implements IPlugin {\n  name = 'HlsPlugin';\n  private hls: Hls | null = null;\n  private core: StrataCore | null = null;\n\n  init(core: StrataCore) {\n    this.core = core;\n\n    // Listen for load requests\n    this.core.events.on('load', (data: { url: string, type: string }) => {\n      // Only proceed if type matches HLS\n      if (data.type === 'hls' || data.url.includes('.m3u8')) {\n        if (Hls.isSupported()) {\n          this.loadHls(data.url);\n        } else if (this.core!.video.canPlayType('application/vnd.apple.mpegurl')) {\n          // Native HLS fallback (Safari) - Core sets src, we do nothing\n          // Core already handles setting video.src if standard\n          this.core!.video.src = data.url;\n        }\n      } else {\n        // If we had an active HLS instance but switched to MP4, destroy it\n        if (this.hls) {\n          this.hls.destroy();\n          this.hls = null;\n        }\n      }\n    });\n\n    // Listen for quality changes from UI\n    this.core.events.on('quality-request', (index: number) => {\n      if (this.hls) {\n        this.hls.currentLevel = index;\n      }\n    });\n\n    // Listen for audio track changes from UI\n    this.core.events.on('audio-track-request', (index: number) => {\n      if (this.hls) {\n        this.hls.audioTrack = index;\n      }\n    });\n  }\n\n  private loadHls(url: string) {\n    if (this.hls) {\n      this.hls.destroy();\n    }\n\n    this.hls = new Hls({\n      autoStartLoad: true,\n      startLevel: -1, // Auto\n      capLevelToPlayerSize: true, // Performance opt\n    });\n\n    this.hls.loadSource(url);\n    this.hls.attachMedia(this.core!.video);\n\n    this.hls.on(Hls.Events.MANIFEST_PARSED, (event: any, data: any) => {\n      const levels = data.levels.map((lvl: any, idx: number) => ({\n        height: lvl.height,\n        bitrate: lvl.bitrate,\n        index: idx\n      }));\n      this.core!.store.setState({ qualityLevels: levels });\n    });\n\n    // Handle Audio Tracks\n    this.hls.on(Hls.Events.AUDIO_TRACKS_UPDATED, (event: any, data: any) => {\n      const tracks = data.audioTracks.map((track: any, idx: number) => ({\n        label: track.name || track.lang || `Audio ${idx + 1}`,\n        language: track.lang || '',\n        index: idx\n      }));\n      this.core!.store.setState({\n        audioTracks: tracks,\n        currentAudioTrack: this.hls!.audioTrack\n      });\n    });\n\n    this.hls.on(Hls.Events.LEVEL_SWITCHED, (event: any, data: any) => {\n      // Update current quality only if in auto mode to show what's playing\n      // If manual, state is already set\n    });\n\n    this.hls.on(Hls.Events.ERROR, (event: any, data: any) => {\n      if (data.fatal) {\n        // Pass fatal errors to Core to handle the retry loop visibly\n        const msg = data.details || 'Unknown HLS Error';\n        this.core!.triggerError(msg, true);\n\n        // Cleanup if needed, but core.load() will eventually destroy and re-init this plugin\n      }\n    });\n  }\n\n  destroy() {\n    if (this.hls) {\n      this.hls.destroy();\n      this.hls = null;\n    }\n  }\n}\n"],"names":["HlsPlugin","__publicField","core","data","Hls","index","url","event","levels","lvl","idx","tracks","track","msg"],"mappings":"8QAIO,MAAMA,CAA6B,CAAnC,cACLC,EAAA,YAAO,aACCA,EAAA,WAAkB,MAClBA,EAAA,YAA0B,MAElC,KAAKC,EAAkB,CACrB,KAAK,KAAOA,EAGZ,KAAK,KAAK,OAAO,GAAG,OAASC,GAAwC,CAE/DA,EAAK,OAAS,OAASA,EAAK,IAAI,SAAS,OAAO,EAC9CC,EAAI,cACN,KAAK,QAAQD,EAAK,GAAG,EACZ,KAAK,KAAM,MAAM,YAAY,+BAA+B,IAGrE,KAAK,KAAM,MAAM,IAAMA,EAAK,KAI1B,KAAK,MACP,KAAK,IAAI,QAAA,EACT,KAAK,IAAM,KAGjB,CAAC,EAGD,KAAK,KAAK,OAAO,GAAG,kBAAoBE,GAAkB,CACpD,KAAK,MACP,KAAK,IAAI,aAAeA,EAE5B,CAAC,EAGD,KAAK,KAAK,OAAO,GAAG,sBAAwBA,GAAkB,CACxD,KAAK,MACP,KAAK,IAAI,WAAaA,EAE1B,CAAC,CACH,CAEQ,QAAQC,EAAa,CACvB,KAAK,KACP,KAAK,IAAI,QAAA,EAGX,KAAK,IAAM,IAAIF,EAAI,CACjB,cAAe,GACf,WAAY,GACZ,qBAAsB,EAAA,CACvB,EAED,KAAK,IAAI,WAAWE,CAAG,EACvB,KAAK,IAAI,YAAY,KAAK,KAAM,KAAK,EAErC,KAAK,IAAI,GAAGF,EAAI,OAAO,gBAAiB,CAACG,EAAYJ,IAAc,CACjE,MAAMK,EAASL,EAAK,OAAO,IAAI,CAACM,EAAUC,KAAiB,CACzD,OAAQD,EAAI,OACZ,QAASA,EAAI,QACb,MAAOC,CAAA,EACP,EACF,KAAK,KAAM,MAAM,SAAS,CAAE,cAAeF,EAAQ,CACrD,CAAC,EAGD,KAAK,IAAI,GAAGJ,EAAI,OAAO,qBAAsB,CAACG,EAAYJ,IAAc,CACtE,MAAMQ,EAASR,EAAK,YAAY,IAAI,CAACS,EAAYF,KAAiB,CAChE,MAAOE,EAAM,MAAQA,EAAM,MAAQ,SAASF,EAAM,CAAC,GACnD,SAAUE,EAAM,MAAQ,GACxB,MAAOF,CAAA,EACP,EACF,KAAK,KAAM,MAAM,SAAS,CACxB,YAAaC,EACb,kBAAmB,KAAK,IAAK,UAAA,CAC9B,CACH,CAAC,EAED,KAAK,IAAI,GAAGP,EAAI,OAAO,eAAgB,CAACG,EAAYJ,IAAc,CAGlE,CAAC,EAED,KAAK,IAAI,GAAGC,EAAI,OAAO,MAAO,CAACG,EAAYJ,IAAc,CACvD,GAAIA,EAAK,MAAO,CAEd,MAAMU,EAAMV,EAAK,SAAW,oBAC5B,KAAK,KAAM,aAAaU,EAAK,EAAI,CAGnC,CACF,CAAC,CACH,CAEA,SAAU,CACJ,KAAK,MACP,KAAK,IAAI,QAAA,EACT,KAAK,IAAM,KAEf,CACF"}

package/dist/hls.d.ts

@@ -0,0 +1,208 @@
+declare class EventBus {
+    private events;
+    constructor();
+    on<T>(event: string, callback: EventCallback<T>): () => void;
+    off<T>(event: string, callback: EventCallback<T>): void;
+    emit<T>(event: string, data?: T): void;
+    destroy(): void;
+}
+
+declare type EventCallback<T = any> = (data: T) => void;
+
+export declare class HlsPlugin implements IPlugin {
+    name: string;
+    private hls;
+    private core;
+    init(core: StrataCore): void;
+    private loadHls;
+    destroy(): void;
+}
+
+declare interface IPlugin {
+    name: string;
+    init(core: StrataCore): void;
+    destroy?(): void;
+}
+
+declare type Listener<T> = (state: T, prevState: T) => void;
+
+declare class NanoStore<T> {
+    private state;
+    private listeners;
+    constructor(initialState: T);
+    get(): T;
+    setState(partial: Partial<T> | ((prev: T) => Partial<T>)): void;
+    subscribe(listener: Listener<T>): () => void;
+    destroy(): void;
+}
+
+declare interface Notification_2 {
+    id: string;
+    message: string;
+    type: 'info' | 'success' | 'warning' | 'error' | 'loading';
+    duration?: number;
+    progress?: number;
+}
+
+declare interface PlayerSource {
+    url: string;
+    type?: 'hls' | 'mp4' | 'webm' | 'dash' | string;
+    name?: string;
+}
+
+declare interface PlayerState {
+    isPlaying: boolean;
+    isBuffering: boolean;
+    currentTime: number;
+    duration: number;
+    buffered: {
+        start: number;
+        end: number;
+    }[];
+    volume: number;
+    isMuted: boolean;
+    audioGain: number;
+    playbackRate: number;
+    qualityLevels: {
+        height: number;
+        bitrate: number;
+        index: number;
+    }[];
+    currentQuality: number;
+    audioTracks: {
+        label: string;
+        language: string;
+        index: number;
+    }[];
+    currentAudioTrack: number;
+    error: string | null;
+    isFullscreen: boolean;
+    isPip: boolean;
+    subtitleTracks: {
+        label: string;
+        language: string;
+        index: number;
+    }[];
+    currentSubtitle: number;
+    subtitleOffset: number;
+    subtitleSettings: SubtitleSettings;
+    activeCues: string[];
+    viewMode: 'normal' | 'theater' | 'pip';
+    notifications: Notification_2[];
+    iconSize: 'small' | 'medium' | 'large';
+    themeColor: string;
+    theme: PlayerTheme;
+    sources: PlayerSource[];
+    currentSourceIndex: number;
+}
+
+declare type PlayerTheme = 'default' | 'pixel' | 'game' | 'hacker';
+
+declare interface StrataConfig {
+    volume?: number;
+    muted?: boolean;
+    playbackRate?: number;
+    audioGain?: number;
+    theme?: PlayerTheme;
+    themeColor?: string;
+    iconSize?: 'small' | 'medium' | 'large';
+    subtitleSettings?: Partial<SubtitleSettings>;
+    disablePersistence?: boolean;
+}
+
+declare class StrataCore {
+    video: HTMLVideoElement;
+    container: HTMLElement | null;
+    events: EventBus;
+    store: NanoStore<PlayerState>;
+    private plugins;
+    private audioEngine;
+    private config;
+    private retryCount;
+    private maxRetries;
+    private retryTimer;
+    private currentSource;
+    private currentSrc;
+    private currentTracks;
+    private castInitialized;
+    private boundCueChange;
+    private boundFullscreenChange;
+    constructor(config?: StrataConfig, videoElement?: HTMLVideoElement);
+    private initVideoListeners;
+    triggerError(message: string, isFatal?: boolean): void;
+    private handleError;
+    private updateBuffer;
+    private updateSubtitles;
+    fetchWithRetry(url: string, retries?: number): Promise<Response>;
+    attach(container: HTMLElement): void;
+    use(plugin: IPlugin): void;
+    setSources(sources: PlayerSource[], tracks?: TextTrackConfig[]): void;
+    switchSource(index: number): void;
+    load(source: PlayerSource | string, tracks?: TextTrackConfig[], isRetry?: boolean): void;
+    addTextTrack(file: File, label: string): void;
+    private addTextTrackInternal;
+    play(): Promise<void>;
+    pause(): void;
+    togglePlay(): void;
+    seek(time: number): void;
+    skip(seconds: number): void;
+    setVolume(vol: number): void;
+    toggleMute(): void;
+    setAudioGain(gain: number): void;
+    setQuality(index: number): void;
+    setAudioTrack(index: number): void;
+    toggleFullscreen(): void;
+    togglePip(): void;
+    private initCast;
+    requestCast(): void;
+    private loadMediaToCast;
+    private handleCueChange;
+    setSubtitle(index: number): void;
+    updateSubtitleSettings(settings: Partial<SubtitleSettings>): void;
+    resetSubtitleSettings(): void;
+    setSubtitleOffset(offset: number): void;
+    download(): Promise<void>;
+    notify(n: Omit<Notification_2, 'id'> & {
+        id?: string;
+    }): string;
+    removeNotification(id: string): void;
+    setAppearance(settings: {
+        iconSize?: 'small' | 'medium' | 'large';
+        themeColor?: string;
+        theme?: PlayerTheme;
+    }): void;
+    destroy(): void;
+}
+
+declare interface SubtitleSettings {
+    useNative: boolean;
+    fixCapitalization: boolean;
+    backgroundOpacity: number;
+    backgroundBlur: boolean;
+    backgroundBlurAmount: number;
+    textSize: number;
+    textStyle: 'none' | 'outline' | 'raised' | 'depressed' | 'shadow';
+    isBold: boolean;
+    textColor: string;
+    verticalOffset: number;
+}
+
+declare interface TextTrackConfig {
+    kind: 'subtitles' | 'captions' | 'descriptions' | 'chapters' | 'metadata';
+    label: string;
+    src: string;
+    srcLang: string;
+    default?: boolean;
+}
+
+export { }
+
+
+declare module 'react' {
+    namespace JSX {
+        interface IntrinsicElements {
+            'google-cast-launcher': React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>;
+        }
+    }
+}
+

package/dist/hls.es.js

@@ -0,0 +1,59 @@
+var a = Object.defineProperty;
+var u = (i, e, s) => e in i ? a(i, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : i[e] = s;
+var n = (i, e, s) => u(i, typeof e != "symbol" ? e + "" : e, s);
+import h from "hls.js";
+class v {
+  constructor() {
+    n(this, "name", "HlsPlugin");
+    n(this, "hls", null);
+    n(this, "core", null);
+  }
+  init(e) {
+    this.core = e, this.core.events.on("load", (s) => {
+      s.type === "hls" || s.url.includes(".m3u8") ? h.isSupported() ? this.loadHls(s.url) : this.core.video.canPlayType("application/vnd.apple.mpegurl") && (this.core.video.src = s.url) : this.hls && (this.hls.destroy(), this.hls = null);
+    }), this.core.events.on("quality-request", (s) => {
+      this.hls && (this.hls.currentLevel = s);
+    }), this.core.events.on("audio-track-request", (s) => {
+      this.hls && (this.hls.audioTrack = s);
+    });
+  }
+  loadHls(e) {
+    this.hls && this.hls.destroy(), this.hls = new h({
+      autoStartLoad: !0,
+      startLevel: -1,
+      // Auto
+      capLevelToPlayerSize: !0
+      // Performance opt
+    }), this.hls.loadSource(e), this.hls.attachMedia(this.core.video), this.hls.on(h.Events.MANIFEST_PARSED, (s, t) => {
+      const r = t.levels.map((l, o) => ({
+        height: l.height,
+        bitrate: l.bitrate,
+        index: o
+      }));
+      this.core.store.setState({ qualityLevels: r });
+    }), this.hls.on(h.Events.AUDIO_TRACKS_UPDATED, (s, t) => {
+      const r = t.audioTracks.map((l, o) => ({
+        label: l.name || l.lang || `Audio ${o + 1}`,
+        language: l.lang || "",
+        index: o
+      }));
+      this.core.store.setState({
+        audioTracks: r,
+        currentAudioTrack: this.hls.audioTrack
+      });
+    }), this.hls.on(h.Events.LEVEL_SWITCHED, (s, t) => {
+    }), this.hls.on(h.Events.ERROR, (s, t) => {
+      if (t.fatal) {
+        const r = t.details || "Unknown HLS Error";
+        this.core.triggerError(r, !0);
+      }
+    });
+  }
+  destroy() {
+    this.hls && (this.hls.destroy(), this.hls = null);
+  }
+}
+export {
+  v as HlsPlugin
+};
+//# sourceMappingURL=hls.es.js.map

package/dist/hls.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hls.es.js","sources":["../plugins/HlsPlugin.ts"],"sourcesContent":["\nimport { StrataCore, IPlugin } from '../core/StrataCore';\nimport Hls from 'hls.js';\n\nexport class HlsPlugin implements IPlugin {\n  name = 'HlsPlugin';\n  private hls: Hls | null = null;\n  private core: StrataCore | null = null;\n\n  init(core: StrataCore) {\n    this.core = core;\n\n    // Listen for load requests\n    this.core.events.on('load', (data: { url: string, type: string }) => {\n      // Only proceed if type matches HLS\n      if (data.type === 'hls' || data.url.includes('.m3u8')) {\n        if (Hls.isSupported()) {\n          this.loadHls(data.url);\n        } else if (this.core!.video.canPlayType('application/vnd.apple.mpegurl')) {\n          // Native HLS fallback (Safari) - Core sets src, we do nothing\n          // Core already handles setting video.src if standard\n          this.core!.video.src = data.url;\n        }\n      } else {\n        // If we had an active HLS instance but switched to MP4, destroy it\n        if (this.hls) {\n          this.hls.destroy();\n          this.hls = null;\n        }\n      }\n    });\n\n    // Listen for quality changes from UI\n    this.core.events.on('quality-request', (index: number) => {\n      if (this.hls) {\n        this.hls.currentLevel = index;\n      }\n    });\n\n    // Listen for audio track changes from UI\n    this.core.events.on('audio-track-request', (index: number) => {\n      if (this.hls) {\n        this.hls.audioTrack = index;\n      }\n    });\n  }\n\n  private loadHls(url: string) {\n    if (this.hls) {\n      this.hls.destroy();\n    }\n\n    this.hls = new Hls({\n      autoStartLoad: true,\n      startLevel: -1, // Auto\n      capLevelToPlayerSize: true, // Performance opt\n    });\n\n    this.hls.loadSource(url);\n    this.hls.attachMedia(this.core!.video);\n\n    this.hls.on(Hls.Events.MANIFEST_PARSED, (event: any, data: any) => {\n      const levels = data.levels.map((lvl: any, idx: number) => ({\n        height: lvl.height,\n        bitrate: lvl.bitrate,\n        index: idx\n      }));\n      this.core!.store.setState({ qualityLevels: levels });\n    });\n\n    // Handle Audio Tracks\n    this.hls.on(Hls.Events.AUDIO_TRACKS_UPDATED, (event: any, data: any) => {\n      const tracks = data.audioTracks.map((track: any, idx: number) => ({\n        label: track.name || track.lang || `Audio ${idx + 1}`,\n        language: track.lang || '',\n        index: idx\n      }));\n      this.core!.store.setState({\n        audioTracks: tracks,\n        currentAudioTrack: this.hls!.audioTrack\n      });\n    });\n\n    this.hls.on(Hls.Events.LEVEL_SWITCHED, (event: any, data: any) => {\n      // Update current quality only if in auto mode to show what's playing\n      // If manual, state is already set\n    });\n\n    this.hls.on(Hls.Events.ERROR, (event: any, data: any) => {\n      if (data.fatal) {\n        // Pass fatal errors to Core to handle the retry loop visibly\n        const msg = data.details || 'Unknown HLS Error';\n        this.core!.triggerError(msg, true);\n\n        // Cleanup if needed, but core.load() will eventually destroy and re-init this plugin\n      }\n    });\n  }\n\n  destroy() {\n    if (this.hls) {\n      this.hls.destroy();\n      this.hls = null;\n    }\n  }\n}\n"],"names":["HlsPlugin","__publicField","core","data","Hls","index","url","event","levels","lvl","idx","tracks","track","msg"],"mappings":";;;;AAIO,MAAMA,EAA6B;AAAA,EAAnC;AACL,IAAAC,EAAA,cAAO;AACC,IAAAA,EAAA,aAAkB;AAClB,IAAAA,EAAA,cAA0B;AAAA;AAAA,EAElC,KAAKC,GAAkB;AACrB,SAAK,OAAOA,GAGZ,KAAK,KAAK,OAAO,GAAG,QAAQ,CAACC,MAAwC;AAEnE,MAAIA,EAAK,SAAS,SAASA,EAAK,IAAI,SAAS,OAAO,IAC9CC,EAAI,gBACN,KAAK,QAAQD,EAAK,GAAG,IACZ,KAAK,KAAM,MAAM,YAAY,+BAA+B,MAGrE,KAAK,KAAM,MAAM,MAAMA,EAAK,OAI1B,KAAK,QACP,KAAK,IAAI,QAAA,GACT,KAAK,MAAM;AAAA,IAGjB,CAAC,GAGD,KAAK,KAAK,OAAO,GAAG,mBAAmB,CAACE,MAAkB;AACxD,MAAI,KAAK,QACP,KAAK,IAAI,eAAeA;AAAA,IAE5B,CAAC,GAGD,KAAK,KAAK,OAAO,GAAG,uBAAuB,CAACA,MAAkB;AAC5D,MAAI,KAAK,QACP,KAAK,IAAI,aAAaA;AAAA,IAE1B,CAAC;AAAA,EACH;AAAA,EAEQ,QAAQC,GAAa;AAC3B,IAAI,KAAK,OACP,KAAK,IAAI,QAAA,GAGX,KAAK,MAAM,IAAIF,EAAI;AAAA,MACjB,eAAe;AAAA,MACf,YAAY;AAAA;AAAA,MACZ,sBAAsB;AAAA;AAAA,IAAA,CACvB,GAED,KAAK,IAAI,WAAWE,CAAG,GACvB,KAAK,IAAI,YAAY,KAAK,KAAM,KAAK,GAErC,KAAK,IAAI,GAAGF,EAAI,OAAO,iBAAiB,CAACG,GAAYJ,MAAc;AACjE,YAAMK,IAASL,EAAK,OAAO,IAAI,CAACM,GAAUC,OAAiB;AAAA,QACzD,QAAQD,EAAI;AAAA,QACZ,SAASA,EAAI;AAAA,QACb,OAAOC;AAAA,MAAA,EACP;AACF,WAAK,KAAM,MAAM,SAAS,EAAE,eAAeF,GAAQ;AAAA,IACrD,CAAC,GAGD,KAAK,IAAI,GAAGJ,EAAI,OAAO,sBAAsB,CAACG,GAAYJ,MAAc;AACtE,YAAMQ,IAASR,EAAK,YAAY,IAAI,CAACS,GAAYF,OAAiB;AAAA,QAChE,OAAOE,EAAM,QAAQA,EAAM,QAAQ,SAASF,IAAM,CAAC;AAAA,QACnD,UAAUE,EAAM,QAAQ;AAAA,QACxB,OAAOF;AAAA,MAAA,EACP;AACF,WAAK,KAAM,MAAM,SAAS;AAAA,QACxB,aAAaC;AAAA,QACb,mBAAmB,KAAK,IAAK;AAAA,MAAA,CAC9B;AAAA,IACH,CAAC,GAED,KAAK,IAAI,GAAGP,EAAI,OAAO,gBAAgB,CAACG,GAAYJ,MAAc;AAAA,IAGlE,CAAC,GAED,KAAK,IAAI,GAAGC,EAAI,OAAO,OAAO,CAACG,GAAYJ,MAAc;AACvD,UAAIA,EAAK,OAAO;AAEd,cAAMU,IAAMV,EAAK,WAAW;AAC5B,aAAK,KAAM,aAAaU,GAAK,EAAI;AAAA,MAGnC;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,UAAU;AACR,IAAI,KAAK,QACP,KAAK,IAAI,QAAA,GACT,KAAK,MAAM;AAAA,EAEf;AACF;"}

package/dist/{lib.d.ts → index.d.ts}

@@ -11,15 +11,6 @@ declare class EventBus {
 
 declare type EventCallback<T = any> = (data: T) => void;
 
-export declare class HlsPlugin implements IPlugin {
-    name: string;
-    private hls;
-    private core;
-    init(core: StrataCore): void;
-    private loadHls;
-    destroy(): void;
-}
-
 declare interface IPlugin {
     name: string;
     init(core: StrataCore): void;