strataplayer 1.0.12 → 1.1.0

package/README.md

@@ -22,24 +22,21 @@
 
 ## Introduction
 
-StrataPlayer represents a shift in how media playback is handled on the web. Instead of tightly coupling playback logic to a specific framework, StrataPlayer operates as a **framework-agnostic engine**.
+StrataPlayer is a production-grade, framework-agnostic media engine designed for the modern web. It decouples playback logic from the UI, ensuring high-performance rendering even during rapid state updates.
 
-While the UI layer is powered by the high-performance concurrent rendering of React 19, the player itself can be mounted into **any** application—be it Vanilla JS, Vue, Svelte, or Angular. It decouples the "playback state" (time, buffer, quality) from the "view layer," ensuring that high-frequency updates (like progress bars) never cause performance bottlenecks in your host application.
+Built on **React 19** and **TypeScript**, it features a modular plugin architecture that allows you to support only the formats you need—keeping your bundle size minimal while offering support for everything from HLS to BitTorrent streaming.
 
-## Core Philosophy
+## ✨ Key Features
 
-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.  **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
-
-- **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:** Plugin-based support for HLS (powered by `hls.js`).
-- **Audio Boost Engine:** Integrated Web Audio API nodes allowing volume boosting up to 300%.
-- **Themeable System:** 4 built-in distinct themes (Default, Pixel, Game, Hacker).
-- **Advanced Subtitles:** DOM-based rendering supporting custom positioning, shadows, and runtime sync adjustment.
+- **Universal Playback:** Support for **HLS**, **DASH**, **MPEG-TS/FLV**, and **WebTorrent** (P2P).
+- **Framework Agnostic:** First-class React support, with easy mounting for Vue, Svelte, Angular, and Vanilla JS.
+- **Robust Network Handling:** Automatic exponential backoff and retry logic for unstable connections.
+- **Advanced Audio Engine:** Integrated Web Audio API nodes for volume boosting (up to 300%) and gain control.
+- **Professional UI:**
+  - **Themes:** 4 built-in distinct themes (Default, Pixel, Game, Hacker).
+  - **Subtitles:** Comprehensive VTT/SRT support with user-customizable styling (size, color, sync, shadows).
+  - **Picture-in-Picture** & **Google Cast** integration.
+- **State Management:** Powered by `NanoStore` for isolated, high-performance state updates.
 
 ## 🚀 Installation
 
@@ -49,17 +46,27 @@ Install the core player:
 npm install strataplayer
 ```
 
-If you need HLS support (streaming `.m3u8` files), install the peer dependency:
+Install the specific engines you need as peer dependencies:
 
 ```bash
+# For HLS (.m3u8)
 npm install hls.js
+
+# For DASH (.mpd)
+npm install dashjs
+
+# For MPEG-TS / FLV
+npm install mpegts.js
+
+# For WebTorrent (Magnet links)
+npm install webtorrent
 ```
 
 ## 💻 Usage
 
-### 1. React + MP4 (Basic)
+### 1. Basic Usage (React)
 
-For standard video files, simply import the component. No extra plugins required.
+For standard MP4/WebM files, no plugins are required.
 
 ```tsx
 import { StrataPlayer } from "strataplayer";
@@ -76,88 +83,138 @@ const App = () => {
 };
 ```
 
-### 2. React + HLS (Advanced)
+### 2. Universal Player (All Formats)
 
-To play HLS streams, import the `HlsPlugin` from the sub-path `strataplayer/hls`.
+To support all formats, import the plugins and pass them to the player.
 
 ```tsx
 import { StrataPlayer } from "strataplayer";
-import { HlsPlugin } from "strataplayer/hls"; // Import from sub-path
+import { HlsPlugin } from "strataplayer/hls";
+import { DashPlugin } from "strataplayer/dash";
+import { MpegtsPlugin } from "strataplayer/mpegts";
+import { WebTorrentPlugin } from "strataplayer/webtorrent";
 import "strataplayer/style.css";
 
-// Initialize plugins outside render loop or via useMemo
-const plugins = [new HlsPlugin()];
+// Initialize plugins once
+const plugins = [
+  new HlsPlugin(),
+  new DashPlugin(),
+  new MpegtsPlugin(),
+  new WebTorrentPlugin(),
+];
 
 const App = () => {
   return (
     <StrataPlayer
-      src="https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8"
+      // Can be a magnet link, m3u8, mpd, or mp4
+      src="magnet:?xt=urn:btih:..."
       plugins={plugins}
       theme="hacker"
+      autoPlay={false}
     />
   );
 };
 ```
 
-### 3. Vanilla JS / Vue / Svelte + MP4
-
-For non-React frameworks, use the `mountStrataPlayer` helper.
-
-**index.html**
-
-```html
-<div id="player-container" style="width: 100%; aspect-ratio: 16/9;"></div>
-```
+### 3. Vanilla JS / Vue / Svelte
 
-**main.js**
+Use the `mountStrataPlayer` helper to render the player into any DOM node.
 
 ```javascript
 import { mountStrataPlayer } from "strataplayer";
+import { HlsPlugin } from "strataplayer/hls";
 import "strataplayer/style.css";
 
-const container = document.getElementById("player-container");
+const container = document.getElementById("player-root");
 
-const instance = mountStrataPlayer(container, {
-  src: "https://example.com/video.mp4",
-  autoPlay: false,
+const player = mountStrataPlayer(container, {
+  src: "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8",
+  plugins: [new HlsPlugin()],
   theme: "game",
+  themeColor: "#eab308",
 });
 
-// Cleanup when done
-// instance.unmount();
+// Update props later
+// player.update({ theme: 'pixel' });
+
+// Cleanup
+// player.unmount();
 ```
 
-### 4. Vanilla JS / Vue / Svelte + HLS
+## 📋 Component Props
+
+The `<StrataPlayer />` component accepts the following props:
+
+| Prop                   | Type                                         | Default     | Description                                                                                |
+| :--------------------- | :------------------------------------------- | :---------- | :----------------------------------------------------------------------------------------- |
+| **src**                | `string`                                     | `undefined` | The primary media URL.                                                                     |
+| **sources**            | `PlayerSource[]`                             | `[]`        | Array of sources for quality fallback or alternative formats. Overrides `src` if provided. |
+| **poster**             | `string`                                     | `undefined` | URL for the poster image shown before playback.                                            |
+| **autoPlay**           | `boolean`                                    | `false`     | Whether to start playback automatically. Note: Browsers may block unmuted autoplay.        |
+| **volume**             | `number`                                     | `1`         | Initial volume (0.0 to 1.0).                                                               |
+| **muted**              | `boolean`                                    | `false`     | Initial mute state.                                                                        |
+| **theme**              | `'default' \| 'pixel' \| 'game' \| 'hacker'` | `'default'` | The visual theme of the player.                                                            |
+| **themeColor**         | `string`                                     | `'#6366f1'` | Primary accent color (Hex, RGB).                                                           |
+| **iconSize**           | `'small' \| 'medium' \| 'large'`             | `'medium'`  | Size of the control icons.                                                                 |
+| **thumbnails**         | `string`                                     | `undefined` | URL to a VTT file containing storyboard thumbnails for hover preview.                      |
+| **textTracks**         | `TextTrackConfig[]`                          | `[]`        | Array of subtitle/caption tracks.                                                          |
+| **plugins**            | `IPlugin[]`                                  | `[]`        | Array of initialized plugin instances (e.g., `new HlsPlugin()`).                           |
+| **disablePersistence** | `boolean`                                    | `false`     | If `true`, prevents saving settings to LocalStorage.                                       |
+| **audioGain**          | `number`                                     | `1`         | Initial audio boost level (e.g., `1.5` for 150%).                                          |
+| **playbackRate**       | `number`                                     | `1`         | Initial playback speed.                                                                    |
+
+### Data Structures
+
+#### `PlayerSource`
+
+```ts
+{
+  url: string;
+  // Optional: 'hls' | 'dash' | 'mp4' | 'webm' | 'mpegts' | 'webtorrent'
+  // If omitted, the player attempts to detect it from the extension.
+  type?: string;
+  name?: string; // Label for source selector
+}
+```
 
-Just like in React, import the plugin and pass it in the config object.
+#### `TextTrackConfig`
 
-```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()],
-});
+```ts
+{
+  kind: 'subtitles' | 'captions';
+  label: string;  // e.g. "English"
+  src: string;    // URL to .vtt file
+  srcLang: string; // e.g. "en"
+  default?: boolean;
+}
 ```
 
-## ⚙️ Advanced Configuration
+## 🧩 Plugin System
+
+StrataPlayer uses a modular system. You only pay the bundle size cost for the formats you use.
+
+| Plugin               | Import Path               | Dependency   | Description                          |
+| :------------------- | :------------------------ | :----------- | :----------------------------------- |
+| **HlsPlugin**        | `strataplayer/hls`        | `hls.js`     | Adaptive HTTP Live Streaming (.m3u8) |
+| **DashPlugin**       | `strataplayer/dash`       | `dashjs`     | MPEG-DASH Streaming (.mpd)           |
+| **MpegtsPlugin**     | `strataplayer/mpegts`     | `mpegts.js`  | MPEG-TS and FLV live streams         |
+| **WebTorrentPlugin** | `strataplayer/webtorrent` | `webtorrent` | P2P streaming via WebRTC             |
+
+## ⚙️ Configuration
 
 ### Sources & Tracks
 
-StrataPlayer supports complex source arrays (for quality fallbacks) and subtitle tracks.
+Support multiple sources for quality fallback and detailed subtitle configuration.
 
-```javascript
-const props = {
-  // Priority order: HLS -> MP4
-  sources: [
-    { 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
-  textTracks: [
+```tsx
+<StrataPlayer
+  sources={[
+    { name: "HLS Master", url: "master.m3u8", type: "hls" },
+    { name: "Fallback MP4", url: "fallback.mp4", type: "mp4" },
+  ]}
+  poster="https://example.com/poster.jpg"
+  thumbnails="https://example.com/storyboard.vtt" // for hover previews
+  textTracks={[
     {
       kind: "subtitles",
       label: "English",
@@ -165,8 +222,29 @@ const props = {
       srcLang: "en",
       default: true,
     },
-  ],
-};
+  ]}
+/>
+```
+
+### UI & Themes
+
+The player includes 4 professionally designed themes.
+
+| Theme     | Description                                                   |
+| :-------- | :------------------------------------------------------------ |
+| `default` | Clean, modern aesthetic using Inter font.                     |
+| `pixel`   | Retro 8-bit style with sharp edges and "Press Start 2P" font. |
+| `game`    | Cinematic RPG style with serif typography and gold accents.   |
+| `hacker`  | Terminal-inspired look with scanlines and monospaced fonts.   |
+
+Customize further with:
+
+```tsx
+<StrataPlayer
+  theme="game"
+  themeColor="#10b981" // Custom accent color
+  iconSize="medium" // 'small' | 'medium' | 'large'
+/>
 ```
 
 ## ⌨️ Keyboard Shortcuts
@@ -181,24 +259,27 @@ const props = {
 | `Arrow Up`    | Increase Volume   |
 | `Arrow Down`  | Decrease Volume   |
 
-## 🎨 Themes
-
-StrataPlayer separates layout from aesthetics. Themes can be switched instantly at runtime via props:
+## 🛠️ Development
 
-- **Default:** Professional, clean lines using Inter font.
-- **Pixel:** Retro-gaming aesthetic with sharp edges and 8-bit fonts.
-- **Game:** Cinematic RPG style with serif typography and gold accents.
-- **Hacker:** Terminal-inspired aesthetic with scanlines and monospaced fonts.
+1. Clone the repository
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Start the dev server:
+   ```bash
+   npm run dev
+   ```
 
 ## 🤝 Contributing
 
-We welcome contributions that align with our philosophy of performance and modularity.
+Contributions are welcome! Please follow these steps:
 
-1.  Fork the project
-2.  Create your feature branch (`git checkout -b feature/AmazingFeature`)
-3.  Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4.  Push to the branch (`git push origin feature/AmazingFeature`)
-5.  Open a Pull Request
+1. Fork the repository.
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`).
+3. Commit your changes.
+4. Push to the branch.
+5. Open a Pull Request.
 
 ## 📄 License
 

package/dist/dash.cjs.js

@@ -0,0 +1,2 @@
+"use strict";var h=Object.defineProperty;var u=(s,t,e)=>t in s?h(s,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[t]=e;var a=(s,t,e)=>u(s,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("dashjs");function y(s){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(s){for(const e in s)if(e!=="default"){const r=Object.getOwnPropertyDescriptor(s,e);Object.defineProperty(t,e,r.get?r:{enumerable:!0,get:()=>s[e]})}}return t.default=s,Object.freeze(t)}const n=y(c),l=n.default||n;class p{constructor(){a(this,"name","DashPlugin");a(this,"player",null);a(this,"core",null)}init(t){this.core=t,this.core.events.on("load",e=>{e.type==="dash"||e.url.includes(".mpd")?this.loadDash(e.url):this.player&&(this.player.destroy(),this.player=null)}),this.core.events.on("quality-request",e=>{this.player&&(e===-1?this.player.updateSettings({streaming:{abr:{autoSwitchBitrate:{video:!0}}}}):(this.player.updateSettings({streaming:{abr:{autoSwitchBitrate:{video:!1}}}}),this.player.setQualityFor("video",e)))}),this.core.events.on("audio-track-request",e=>{if(this.player){const r=this.player.getTracksFor("audio");r[e]&&this.player.setCurrentTrack(r[e])}})}loadDash(t){this.player&&(this.player.destroy(),this.player=null);try{this.player=l.MediaPlayer().create(),this.player.initialize(this.core.video,t,this.core.store.get().isPlaying),this.player.on(l.MediaPlayer.events.STREAM_INITIALIZED,()=>{this.updateQualityLevels(),this.updateAudioTracks()}),this.player.on(l.MediaPlayer.events.ERROR,e=>{var r;this.core.triggerError(`Dash Error: ${((r=e.error)==null?void 0:r.message)||"Unknown"}`,!0)})}catch(e){this.core.triggerError(`Dash Init Failed: ${e.message}`,!0)}}updateQualityLevels(){if(!this.player)return;const t=this.player.getBitrateInfoListFor("video");if(t&&t.length){const e=t.map((r,i)=>({height:r.height,bitrate:r.bitrate,index:i}));this.core.store.setState({qualityLevels:e})}}updateAudioTracks(){if(!this.player)return;const t=this.player.getTracksFor("audio");if(t&&t.length){const e=t.map((r,i)=>{var o;return{label:r.lang||((o=r.roles)==null?void 0:o[0])||`Audio ${i+1}`,language:r.lang||"",index:i}});this.core.store.setState({audioTracks:e})}}destroy(){this.player&&(this.player.destroy(),this.player=null)}}exports.DashPlugin=p;
+//# sourceMappingURL=dash.cjs.js.map

package/dist/dash.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.cjs.js","sources":["../plugins/DashPlugin.ts"],"sourcesContent":["import { StrataCore, IPlugin } from '../core/StrataCore';\r\nimport * as DashModule from 'dashjs';\r\n\r\n// Handle environment differences where dashjs might be a default export or module export\r\nconst dashjs = (DashModule as any).default || DashModule;\r\n\r\nexport class DashPlugin implements IPlugin {\r\n  name = 'DashPlugin';\r\n  private player: any = null;\r\n  private core: StrataCore | null = null;\r\n\r\n  init(core: StrataCore) {\r\n    this.core = core;\r\n\r\n    // Listen for load requests\r\n    this.core.events.on('load', (data: { url: string, type: string }) => {\r\n      if (data.type === 'dash' || data.url.includes('.mpd')) {\r\n        this.loadDash(data.url);\r\n      } else {\r\n        // Cleanup if we switch away from DASH\r\n        if (this.player) {\r\n          this.player.destroy();\r\n          this.player = null;\r\n        }\r\n      }\r\n    });\r\n\r\n    // Quality Handling\r\n    this.core.events.on('quality-request', (index: number) => {\r\n      if (this.player) {\r\n        // -1 means Auto (ABR enabled), otherwise specific index\r\n        if (index === -1) {\r\n          this.player.updateSettings({ streaming: { abr: { autoSwitchBitrate: { video: true } } } });\r\n        } else {\r\n          this.player.updateSettings({ streaming: { abr: { autoSwitchBitrate: { video: false } } } });\r\n          this.player.setQualityFor('video', index);\r\n        }\r\n      }\r\n    });\r\n\r\n    // Audio Track Handling\r\n    this.core.events.on('audio-track-request', (index: number) => {\r\n      if (this.player) {\r\n        const tracks = this.player.getTracksFor('audio');\r\n        if (tracks[index]) {\r\n          this.player.setCurrentTrack(tracks[index]);\r\n        }\r\n      }\r\n    });\r\n  }\r\n\r\n  private loadDash(url: string) {\r\n    if (this.player) {\r\n      this.player.destroy();\r\n      this.player = null;\r\n    }\r\n\r\n    try {\r\n      this.player = dashjs.MediaPlayer().create();\r\n      this.player.initialize(this.core!.video, url, this.core!.store.get().isPlaying);\r\n\r\n      // Event Listeners\r\n      this.player.on(dashjs.MediaPlayer.events.STREAM_INITIALIZED, () => {\r\n        this.updateQualityLevels();\r\n        this.updateAudioTracks();\r\n      });\r\n\r\n      this.player.on(dashjs.MediaPlayer.events.ERROR, (e: any) => {\r\n        // Pass error to core with retry logic enabled (fatal=true)\r\n        this.core!.triggerError(`Dash Error: ${e.error?.message || 'Unknown'}`, true);\r\n      });\r\n\r\n    } catch (e: any) {\r\n      this.core!.triggerError(`Dash Init Failed: ${e.message}`, true);\r\n    }\r\n  }\r\n\r\n  private updateQualityLevels() {\r\n    if (!this.player) return;\r\n    const bitrates = this.player.getBitrateInfoListFor('video');\r\n    if (bitrates && bitrates.length) {\r\n      const levels = bitrates.map((b: any, i: number) => ({\r\n        height: b.height,\r\n        bitrate: b.bitrate,\r\n        index: i\r\n      }));\r\n      this.core!.store.setState({ qualityLevels: levels });\r\n    }\r\n  }\r\n\r\n  private updateAudioTracks() {\r\n    if (!this.player) return;\r\n    const tracks = this.player.getTracksFor('audio');\r\n    if (tracks && tracks.length) {\r\n      const list = tracks.map((t: any, i: number) => ({\r\n        label: t.lang || t.roles?.[0] || `Audio ${i + 1}`,\r\n        language: t.lang || '',\r\n        index: i\r\n      }));\r\n      this.core!.store.setState({ audioTracks: list });\r\n    }\r\n  }\r\n\r\n  destroy() {\r\n    if (this.player) {\r\n      this.player.destroy();\r\n      this.player = null;\r\n    }\r\n  }\r\n}"],"names":["dashjs","DashModule","DashPlugin","__publicField","core","data","index","tracks","url","_a","bitrates","levels","b","list","t"],"mappings":"wiBAIMA,EAAUC,EAAmB,SAAWA,EAEvC,MAAMC,CAA8B,CAApC,cACLC,EAAA,YAAO,cACCA,EAAA,cAAc,MACdA,EAAA,YAA0B,MAElC,KAAKC,EAAkB,CACrB,KAAK,KAAOA,EAGZ,KAAK,KAAK,OAAO,GAAG,OAASC,GAAwC,CAC/DA,EAAK,OAAS,QAAUA,EAAK,IAAI,SAAS,MAAM,EAClD,KAAK,SAASA,EAAK,GAAG,EAGlB,KAAK,SACP,KAAK,OAAO,QAAA,EACZ,KAAK,OAAS,KAGpB,CAAC,EAGD,KAAK,KAAK,OAAO,GAAG,kBAAoBC,GAAkB,CACpD,KAAK,SAEHA,IAAU,GACZ,KAAK,OAAO,eAAe,CAAE,UAAW,CAAE,IAAK,CAAE,kBAAmB,CAAE,MAAO,EAAA,CAAK,CAAE,EAAK,GAEzF,KAAK,OAAO,eAAe,CAAE,UAAW,CAAE,IAAK,CAAE,kBAAmB,CAAE,MAAO,EAAA,CAAM,CAAE,EAAK,EAC1F,KAAK,OAAO,cAAc,QAASA,CAAK,GAG9C,CAAC,EAGD,KAAK,KAAK,OAAO,GAAG,sBAAwBA,GAAkB,CAC5D,GAAI,KAAK,OAAQ,CACf,MAAMC,EAAS,KAAK,OAAO,aAAa,OAAO,EAC3CA,EAAOD,CAAK,GACd,KAAK,OAAO,gBAAgBC,EAAOD,CAAK,CAAC,CAE7C,CACF,CAAC,CACH,CAEQ,SAASE,EAAa,CACxB,KAAK,SACP,KAAK,OAAO,QAAA,EACZ,KAAK,OAAS,MAGhB,GAAI,CACF,KAAK,OAASR,EAAO,YAAA,EAAc,OAAA,EACnC,KAAK,OAAO,WAAW,KAAK,KAAM,MAAOQ,EAAK,KAAK,KAAM,MAAM,IAAA,EAAM,SAAS,EAG9E,KAAK,OAAO,GAAGR,EAAO,YAAY,OAAO,mBAAoB,IAAM,CACjE,KAAK,oBAAA,EACL,KAAK,kBAAA,CACP,CAAC,EAED,KAAK,OAAO,GAAGA,EAAO,YAAY,OAAO,MAAQ,GAAW,OAE1D,KAAK,KAAM,aAAa,iBAAeS,EAAA,EAAE,QAAF,YAAAA,EAAS,UAAW,SAAS,GAAI,EAAI,CAC9E,CAAC,CAEH,OAAS,EAAQ,CACf,KAAK,KAAM,aAAa,qBAAqB,EAAE,OAAO,GAAI,EAAI,CAChE,CACF,CAEQ,qBAAsB,CAC5B,GAAI,CAAC,KAAK,OAAQ,OAClB,MAAMC,EAAW,KAAK,OAAO,sBAAsB,OAAO,EAC1D,GAAIA,GAAYA,EAAS,OAAQ,CAC/B,MAAMC,EAASD,EAAS,IAAI,CAACE,EAAQ,KAAe,CAClD,OAAQA,EAAE,OACV,QAASA,EAAE,QACX,MAAO,CAAA,EACP,EACF,KAAK,KAAM,MAAM,SAAS,CAAE,cAAeD,EAAQ,CACrD,CACF,CAEQ,mBAAoB,CAC1B,GAAI,CAAC,KAAK,OAAQ,OAClB,MAAMJ,EAAS,KAAK,OAAO,aAAa,OAAO,EAC/C,GAAIA,GAAUA,EAAO,OAAQ,CAC3B,MAAMM,EAAON,EAAO,IAAI,CAACO,EAAQ,IAAA,OAAe,OAC9C,MAAOA,EAAE,QAAQL,EAAAK,EAAE,QAAF,YAAAL,EAAU,KAAM,SAAS,EAAI,CAAC,GAC/C,SAAUK,EAAE,MAAQ,GACpB,MAAO,CAAA,EACP,EACF,KAAK,KAAM,MAAM,SAAS,CAAE,YAAaD,EAAM,CACjD,CACF,CAEA,SAAU,CACJ,KAAK,SACP,KAAK,OAAO,QAAA,EACZ,KAAK,OAAS,KAElB,CACF"}

package/dist/dash.d.ts

@@ -0,0 +1,210 @@
+export declare class DashPlugin implements IPlugin {
+    name: string;
+    private player;
+    private core;
+    init(core: StrataCore): void;
+    private loadDash;
+    private updateQualityLevels;
+    private updateAudioTracks;
+    destroy(): void;
+}
+
+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;
+
+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' | 'mpegts' | 'webtorrent' | 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/dash.es.js

@@ -0,0 +1,71 @@
+var n = Object.defineProperty;
+var u = (s, t, e) => t in s ? n(s, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[t] = e;
+var a = (s, t, e) => u(s, typeof t != "symbol" ? t + "" : t, e);
+import * as h from "dashjs";
+const l = h.default || h;
+class p {
+  constructor() {
+    a(this, "name", "DashPlugin");
+    a(this, "player", null);
+    a(this, "core", null);
+  }
+  init(t) {
+    this.core = t, this.core.events.on("load", (e) => {
+      e.type === "dash" || e.url.includes(".mpd") ? this.loadDash(e.url) : this.player && (this.player.destroy(), this.player = null);
+    }), this.core.events.on("quality-request", (e) => {
+      this.player && (e === -1 ? this.player.updateSettings({ streaming: { abr: { autoSwitchBitrate: { video: !0 } } } }) : (this.player.updateSettings({ streaming: { abr: { autoSwitchBitrate: { video: !1 } } } }), this.player.setQualityFor("video", e)));
+    }), this.core.events.on("audio-track-request", (e) => {
+      if (this.player) {
+        const r = this.player.getTracksFor("audio");
+        r[e] && this.player.setCurrentTrack(r[e]);
+      }
+    });
+  }
+  loadDash(t) {
+    this.player && (this.player.destroy(), this.player = null);
+    try {
+      this.player = l.MediaPlayer().create(), this.player.initialize(this.core.video, t, this.core.store.get().isPlaying), this.player.on(l.MediaPlayer.events.STREAM_INITIALIZED, () => {
+        this.updateQualityLevels(), this.updateAudioTracks();
+      }), this.player.on(l.MediaPlayer.events.ERROR, (e) => {
+        var r;
+        this.core.triggerError(`Dash Error: ${((r = e.error) == null ? void 0 : r.message) || "Unknown"}`, !0);
+      });
+    } catch (e) {
+      this.core.triggerError(`Dash Init Failed: ${e.message}`, !0);
+    }
+  }
+  updateQualityLevels() {
+    if (!this.player) return;
+    const t = this.player.getBitrateInfoListFor("video");
+    if (t && t.length) {
+      const e = t.map((r, i) => ({
+        height: r.height,
+        bitrate: r.bitrate,
+        index: i
+      }));
+      this.core.store.setState({ qualityLevels: e });
+    }
+  }
+  updateAudioTracks() {
+    if (!this.player) return;
+    const t = this.player.getTracksFor("audio");
+    if (t && t.length) {
+      const e = t.map((r, i) => {
+        var o;
+        return {
+          label: r.lang || ((o = r.roles) == null ? void 0 : o[0]) || `Audio ${i + 1}`,
+          language: r.lang || "",
+          index: i
+        };
+      });
+      this.core.store.setState({ audioTracks: e });
+    }
+  }
+  destroy() {
+    this.player && (this.player.destroy(), this.player = null);
+  }
+}
+export {
+  p as DashPlugin
+};
+//# sourceMappingURL=dash.es.js.map

package/dist/dash.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.es.js","sources":["../plugins/DashPlugin.ts"],"sourcesContent":["import { StrataCore, IPlugin } from '../core/StrataCore';\r\nimport * as DashModule from 'dashjs';\r\n\r\n// Handle environment differences where dashjs might be a default export or module export\r\nconst dashjs = (DashModule as any).default || DashModule;\r\n\r\nexport class DashPlugin implements IPlugin {\r\n  name = 'DashPlugin';\r\n  private player: any = null;\r\n  private core: StrataCore | null = null;\r\n\r\n  init(core: StrataCore) {\r\n    this.core = core;\r\n\r\n    // Listen for load requests\r\n    this.core.events.on('load', (data: { url: string, type: string }) => {\r\n      if (data.type === 'dash' || data.url.includes('.mpd')) {\r\n        this.loadDash(data.url);\r\n      } else {\r\n        // Cleanup if we switch away from DASH\r\n        if (this.player) {\r\n          this.player.destroy();\r\n          this.player = null;\r\n        }\r\n      }\r\n    });\r\n\r\n    // Quality Handling\r\n    this.core.events.on('quality-request', (index: number) => {\r\n      if (this.player) {\r\n        // -1 means Auto (ABR enabled), otherwise specific index\r\n        if (index === -1) {\r\n          this.player.updateSettings({ streaming: { abr: { autoSwitchBitrate: { video: true } } } });\r\n        } else {\r\n          this.player.updateSettings({ streaming: { abr: { autoSwitchBitrate: { video: false } } } });\r\n          this.player.setQualityFor('video', index);\r\n        }\r\n      }\r\n    });\r\n\r\n    // Audio Track Handling\r\n    this.core.events.on('audio-track-request', (index: number) => {\r\n      if (this.player) {\r\n        const tracks = this.player.getTracksFor('audio');\r\n        if (tracks[index]) {\r\n          this.player.setCurrentTrack(tracks[index]);\r\n        }\r\n      }\r\n    });\r\n  }\r\n\r\n  private loadDash(url: string) {\r\n    if (this.player) {\r\n      this.player.destroy();\r\n      this.player = null;\r\n    }\r\n\r\n    try {\r\n      this.player = dashjs.MediaPlayer().create();\r\n      this.player.initialize(this.core!.video, url, this.core!.store.get().isPlaying);\r\n\r\n      // Event Listeners\r\n      this.player.on(dashjs.MediaPlayer.events.STREAM_INITIALIZED, () => {\r\n        this.updateQualityLevels();\r\n        this.updateAudioTracks();\r\n      });\r\n\r\n      this.player.on(dashjs.MediaPlayer.events.ERROR, (e: any) => {\r\n        // Pass error to core with retry logic enabled (fatal=true)\r\n        this.core!.triggerError(`Dash Error: ${e.error?.message || 'Unknown'}`, true);\r\n      });\r\n\r\n    } catch (e: any) {\r\n      this.core!.triggerError(`Dash Init Failed: ${e.message}`, true);\r\n    }\r\n  }\r\n\r\n  private updateQualityLevels() {\r\n    if (!this.player) return;\r\n    const bitrates = this.player.getBitrateInfoListFor('video');\r\n    if (bitrates && bitrates.length) {\r\n      const levels = bitrates.map((b: any, i: number) => ({\r\n        height: b.height,\r\n        bitrate: b.bitrate,\r\n        index: i\r\n      }));\r\n      this.core!.store.setState({ qualityLevels: levels });\r\n    }\r\n  }\r\n\r\n  private updateAudioTracks() {\r\n    if (!this.player) return;\r\n    const tracks = this.player.getTracksFor('audio');\r\n    if (tracks && tracks.length) {\r\n      const list = tracks.map((t: any, i: number) => ({\r\n        label: t.lang || t.roles?.[0] || `Audio ${i + 1}`,\r\n        language: t.lang || '',\r\n        index: i\r\n      }));\r\n      this.core!.store.setState({ audioTracks: list });\r\n    }\r\n  }\r\n\r\n  destroy() {\r\n    if (this.player) {\r\n      this.player.destroy();\r\n      this.player = null;\r\n    }\r\n  }\r\n}"],"names":["dashjs","DashModule","DashPlugin","__publicField","core","data","index","tracks","url","_a","bitrates","levels","b","list","t"],"mappings":"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"}

package/dist/hls.d.ts

@@ -46,7 +46,7 @@ declare interface Notification_2 {
 
 declare interface PlayerSource {
     url: string;
-    type?: 'hls' | 'mp4' | 'webm' | 'dash' | string;
+    type?: 'hls' | 'mp4' | 'webm' | 'dash' | 'mpegts' | 'webtorrent' | string;
     name?: string;
 }