vidply 1.1.2 → 1.1.3

package/README.md

@@ -2,12 +2,13 @@
 
 **Universal, Accessible Video & Audio Player**
 
-A modern, feature-rich media player built with vanilla ES6 JavaScript. Combines the best accessibility features from AblePlayer with the streaming capabilities of MediaElement.js. Fully internationalized with support for 5 languages and complete WCAG 2.2 AA compliance.
+A modern, feature-rich media player authored in strict TypeScript and shipped as a zero-dependency ES module. Combines the best accessibility features from AblePlayer with the streaming capabilities of MediaElement.js. Fully internationalized with support for 5 languages and complete WCAG 2.2 AA compliance.
 
 ![License](https://img.shields.io/badge/license-GPL--2.0--or--later-blue.svg)
-![ES6](https://img.shields.io/badge/ES6-Module-yellow.svg)
+![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)
+![ESM](https://img.shields.io/badge/ESM-Module-yellow.svg)
 ![WCAG](https://img.shields.io/badge/WCAG-2.2%20AA-green.svg)
-![Version](https://img.shields.io/badge/version-1.0.45-brightgreen.svg)
+![Version](https://img.shields.io/badge/version-1.1.3-brightgreen.svg)
 
 ## Live Demos
 
@@ -21,11 +22,12 @@ Try VidPly in action:
 
 ## Why VidPly?
 
-- **Zero Dependencies** - Pure vanilla JavaScript, no frameworks required
+- **Zero Dependencies** - Pure vanilla JavaScript / TypeScript, no frameworks required
+- **TypeScript Native** - Authored in strict TypeScript with shipped type declarations (`dist/types/index.d.ts`)
 - **Accessibility First** - WCAG 2.2 AA compliant with full keyboard and screen reader support
 - **Multilingual** - Built-in translations for 5 languages with easy extensibility
 - **Fully Customizable** - CSS variables and comprehensive API
-- **Modern Build** - ES6 modules with tree-shaking support
+- **Modern Build** - ES modules with tree-shaking, code-splitting and source maps
 - **Production Ready** - Thoroughly tested with real-world media content
 
 ## Features
@@ -35,8 +37,13 @@ Try VidPly in action:
 - **Multiple Formats** - MP3, OGG, WAV (audio) / MP4, WebM (video)
 - **YouTube Integration** - Embed YouTube videos with unified controls
 - **Vimeo Integration** - Seamless Vimeo player integration
+- **SoundCloud Integration** - Play SoundCloud tracks and sets via the Widget API with unified controls
 - **HLS Streaming** - Adaptive bitrate streaming with quality selection and dynamic subtitle detection
+  - Uses `hls.js` on Chrome / Firefox / Edge / desktop Safari for full feature parity (quality menu, captions, transcript)
+  - Falls back to native HLS on iOS / iPadOS where MSE is unavailable; native text tracks are still surfaced through the VidPly captions and transcript UI
 - **DASH Streaming** - MPEG-DASH support via dash.js with adaptive quality, TTML and WebVTT subtitles
+- **Buffering Spinner** - Centered loading spinner shown automatically while media is buffering (HTML5, HLS, DASH)
+- **Download Button** - Optional download control with custom URL support (`downloadButton` + `downloadUrl`)
 - **Preview Thumbnails** - Video preview thumbnails on progress bar hover
 - **Playlists** - Full playlist support with auto-advance and navigation
   - Audio playlists with track info
@@ -148,10 +155,10 @@ This creates minified files in the `dist/` folder.
 </script>
 ```
 
-### Option 3: Development (Source Files)
+### Option 3: Development (TypeScript Sources)
 
-```javascript
-import Player from './src/index.js';
+```typescript
+import Player from './src/index';
 
 const player = new Player('#my-video', {
   controls: true,
@@ -161,6 +168,8 @@ const player = new Player('#my-video', {
 });
 ```
 
+> The library is authored in strict TypeScript. Type declarations ship to `dist/types/index.d.ts` so consumers using `tsc` or `vite` get full IntelliSense without any extra `@types` package.
+
 ## Quick Start
 
 ### 1. Build the Player
@@ -223,6 +232,32 @@ That's it! The player auto-initializes.
 <video data-vidply src="https://example.com/manifest.mpd"></video>
 ```
 
+### SoundCloud
+
+```html
+<audio data-vidply src="https://soundcloud.com/artist/track"></audio>
+```
+
+### Download Button
+
+Enable the download button and (optionally) provide a custom URL:
+
+```html
+<video
+  data-vidply
+  data-vidply-download-button="true"
+  data-vidply-download-url="/files/lecture.mp4"
+  src="/streams/lecture/manifest.mpd">
+</video>
+```
+
+```javascript
+const player = new Player('#my-video', {
+  downloadButton: true,
+  downloadUrl: '/files/lecture.mp4' // optional, falls back to current src
+});
+```
+
 ### DASH + HLS + MP4 Fallback
 
 For maximum device compatibility, provide all three formats:
@@ -274,7 +309,9 @@ const player = new Player('#video', {
   signLanguageButton: true,
   fullscreenButton: true,
   pipButton: true,
-  
+  downloadButton: false,        // Show a download button in the control bar
+  downloadUrl: null,            // Optional explicit download URL (falls back to current src)
+
   // Captions
   captions: true,
   captionsDefault: false,
@@ -613,8 +650,8 @@ VidPly provides extensive CSS variables for easy customization:
 
 #### Option 2: JavaScript API
 
-```javascript
-import { i18n } from './src/i18n/i18n.js';
+```typescript
+import { i18n } from './src/i18n/i18n';
 
 // Load language file from URL
 await i18n.loadLanguageFromUrl('pt', 'languages/pt.json');
@@ -631,8 +668,8 @@ i18n.setLanguage('pt');
 
 #### Option 3: Add Translations Programmatically
 
-```javascript
-import { i18n } from './src/i18n/i18n.js';
+```typescript
+import { i18n } from './src/i18n/i18n';
 
 i18n.addTranslation('pt', {
   player: {
@@ -671,14 +708,16 @@ The player supports both JSON and YAML formats for language files.
 
 ## Build Process
 
-VidPly uses a modern build system with esbuild for JavaScript and clean-css for CSS.
+VidPly uses a modern build system with esbuild for TypeScript bundling, the TypeScript compiler for `.d.ts` declarations, and clean-css for CSS.
 
 ### Available Scripts
 
 ```bash
-npm run build        # Build everything (JS + CSS)
-npm run build:js     # Build JavaScript only
+npm run build        # Build everything (JS + types + CSS)
+npm run build:js     # Bundle TypeScript with esbuild (ESM + IIFE)
+npm run build:types  # Emit type declarations to dist/types/
 npm run build:css    # Build CSS only
+npm run typecheck    # Run tsc --noEmit
 npm run watch        # Watch mode for development
 npm run clean        # Clean dist directory
 npm run dev          # Start dev server
@@ -693,6 +732,7 @@ npm run test:all     # Run all tests
 - `dist/prod/vidply.esm.min.js` - ES Module (production)
 - `dist/legacy/vidply.js` - IIFE (development)
 - `dist/legacy/vidply.min.js` - IIFE (production)
+- `dist/types/index.d.ts` - TypeScript declarations
 - `dist/vidply.css` - Styles (unminified)
 - `dist/vidply.min.css` - Styles (minified)
 

package/dist/dev/{vidply.AudioDescriptionManager-2LDAC6BR.js → vidply.AudioDescriptionManager-AXPP5OKO.js}

@@ -5,7 +5,7 @@
  */
 import {
   CaptionManager
-} from "./vidply.chunk-ELJA4GMZ.js";
+} from "./vidply.chunk-55W33EGZ.js";
 import "./vidply.chunk-SXDZXXZD.js";
 import "./vidply.chunk-VLF6H5PZ.js";
 
@@ -569,4 +569,4 @@ var AudioDescriptionManager = class {
 export {
   AudioDescriptionManager
 };
-//# sourceMappingURL=vidply.AudioDescriptionManager-2LDAC6BR.js.map
+//# sourceMappingURL=vidply.AudioDescriptionManager-AXPP5OKO.js.map

package/dist/dev/{vidply.chunk-ELJA4GMZ.js → vidply.chunk-55W33EGZ.js}

@@ -146,10 +146,34 @@ var CaptionManager = class {
       });
     }
   }
+  /**
+   * Sync hls.js subtitle rendition to match the given language.
+   * Matches by lang, language, or falls back to name/label.
+   */
+  _syncHlsSubtitleTrack(targetLang, targetLabel) {
+    const renderer = this.player.renderer;
+    if (!renderer?.hls || !renderer.hls.subtitleTracks?.length) return;
+    const tracks = renderer.hls.subtitleTracks;
+    let hlsIndex = tracks.findIndex(
+      (t) => t.lang === targetLang
+    );
+    if (hlsIndex < 0 && targetLabel) {
+      hlsIndex = tracks.findIndex(
+        (t) => t.name === targetLabel
+      );
+    }
+    if (hlsIndex >= 0 && renderer.hls.subtitleTrack !== hlsIndex) {
+      renderer.hls.subtitleTrack = hlsIndex;
+      this.player.log(`HLS subtitle track set to index ${hlsIndex} (${targetLang})`, "info");
+    }
+  }
   attachEvents() {
     this.player.on("timeupdate", () => {
       this.updateCaptions();
     });
+    this.player.on("textcuesupdate", () => {
+      this.updateCaptions();
+    });
     this.player.on("captionschange", () => {
       this.updateStyles();
     });
@@ -228,6 +252,7 @@ var CaptionManager = class {
           ensureTrackReady();
         }
       });
+      this._syncHlsSubtitleTrack(selectedTrack.language, selectedTrack.label);
       this.player.emit("captionsenabled", selectedTrack);
     }
   }
@@ -452,4 +477,4 @@ export {
   rafWithTimeout,
   CaptionManager
 };
-//# sourceMappingURL=vidply.chunk-ELJA4GMZ.js.map
+//# sourceMappingURL=vidply.chunk-55W33EGZ.js.map

package/dist/dev/vidply.chunk-55W33EGZ.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/PerformanceUtils.ts", "../../src/controls/CaptionManager.ts"],
+  "sourcesContent": ["export function debounce<T extends (...args: unknown[]) => void>(func: T, wait = 100): T {\n  let timeout: ReturnType<typeof setTimeout> | undefined;\n  return function executedFunction(this: unknown, ...args: unknown[]) {\n    const later = () => {\n      clearTimeout(timeout);\n      func.apply(this, args);\n    };\n    clearTimeout(timeout);\n    timeout = setTimeout(later, wait);\n  } as unknown as T;\n}\n\nexport function throttle<T extends (...args: unknown[]) => void>(func: T, limit = 100): T {\n  let inThrottle = false;\n  return function executedFunction(this: unknown, ...args: unknown[]) {\n    if (!inThrottle) {\n      func.apply(this, args);\n      inThrottle = true;\n      setTimeout(() => inThrottle = false, limit);\n    }\n  } as unknown as T;\n}\n\nexport function isMobile(breakpoint = 768): boolean {\n  return window.innerWidth < breakpoint;\n}\n\nexport function rafWithTimeout(callback: () => void, timeout = 100): void {\n  let called = false;\n\n  const execute = () => {\n    if (!called) {\n      called = true;\n      callback();\n    }\n  };\n\n  requestAnimationFrame(execute);\n  setTimeout(execute, timeout);\n}\n", "/**\n * Caption/Subtitle Manager\n */\n\nimport {DOMUtils} from '../utils/DOMUtils.js';\nimport {i18n} from '../i18n/i18n.js';\nimport {StorageManager} from '../utils/StorageManager.js';\nimport {debounce, isMobile, rafWithTimeout} from '../utils/PerformanceUtils.js';\nimport type { Player } from '../core/Player.js';\n\nexport class CaptionManager {\n    player: Player;\n    _altCueChangeHandler: any;\n    cueChangeHandler: any;\n    currentCue: any;\n    currentTrack: any;\n    debouncedPositionCaptions: any;\n    element: any;\n    storage: StorageManager;\n    tracks: any[];\n\n    constructor(player: Player) {\n        this.player = player;\n        this.element = null;\n        this.tracks = [];\n        this.currentTrack = null;\n        this.currentCue = null;\n        \n        // Storage manager\n        this.storage = new StorageManager('vidply');\n        \n        // Load saved preferences\n        this.loadSavedPreferences();\n\n        this.init();\n    }\n    \n    loadSavedPreferences() {\n        const saved = this.storage.getCaptionPreferences();\n        if (saved) {\n            // Override player options with saved preferences\n            if (saved.fontSize) this.player.options.captionsFontSize = saved.fontSize;\n            if (saved.fontFamily) this.player.options.captionsFontFamily = saved.fontFamily;\n            if (saved.color) this.player.options.captionsColor = saved.color;\n            if (saved.backgroundColor) this.player.options.captionsBackgroundColor = saved.backgroundColor;\n            if (saved.opacity !== undefined) this.player.options.captionsOpacity = saved.opacity;\n        }\n    }\n    \n    saveCaptionPreferences() {\n        this.storage.saveCaptionPreferences({\n            fontSize: this.player.options.captionsFontSize,\n            fontFamily: this.player.options.captionsFontFamily,\n            color: this.player.options.captionsColor,\n            backgroundColor: this.player.options.captionsBackgroundColor,\n            opacity: this.player.options.captionsOpacity\n        });\n    }\n\n    init() {\n        this.createElement();\n        this.loadTracks();\n        this.attachEvents();\n\n        // Only enable captions via captionsDefault option if no default track was found\n        // (loadTracks() already enables tracks with the default attribute)\n        if (this.player.options.captionsDefault && this.tracks.length > 0 && !this.currentTrack) {\n            this.enable();\n        }\n    }\n\n    createElement() {\n        this.element = DOMUtils.createElement('div', {\n            className: `${this.player.options.classPrefix}-captions`,\n            attributes: {\n                'role': 'region',\n                'aria-label': i18n.t('player.captions')\n            }\n        });\n\n        // Apply caption styles\n        this.updateStyles();\n\n        // Append to videoWrapper if it exists, otherwise to container\n        const target = this.player.videoWrapper || this.player.container;\n        target.appendChild(this.element);\n    }\n\n    loadTracks() {\n        const textTracks = this.player.element.textTracks;\n        let defaultTrackIndex = -1;\n\n        // Safari's native HLS can expose both SUBTITLES (WebVTT sidecar) and\n        // CLOSED-CAPTIONS (inband CEA-608) groups as separate TextTrack objects\n        // with the same language and label. Deduplicate to one menu entry per\n        // language+label, storing the extras as alternatives. enable() will\n        // listen on all of them and use whichever delivers cues first.\n        const seen = new Map();\n\n        for (let i = 0; i < textTracks.length; i++) {\n            const track = textTracks[i];\n\n            if ((track.kind === 'subtitles' || track.kind === 'captions') && !track._vidplyStale) {\n                track.mode = 'hidden';\n\n                const dedupeKey = `${track.language}|${track.label}`;\n                const existing = seen.get(dedupeKey);\n\n                if (existing) {\n                    existing.alternatives.push(track);\n                    continue;\n                }\n\n                const trackElement = this.player.findTrackElement(track);\n                const isDefault = trackElement && trackElement.hasAttribute('default');\n                const entry = {\n                    track,\n                    language: track.language,\n                    label: track.label,\n                    kind: track.kind,\n                    index: i,\n                    isDefault,\n                    alternatives: [] as TextTrack[]\n                };\n\n                this.tracks.push(entry);\n                seen.set(dedupeKey, entry);\n\n                if (isDefault) {\n                    defaultTrackIndex = this.tracks.length - 1;\n                }\n            }\n        }\n        \n        if (defaultTrackIndex >= 0) {\n            requestAnimationFrame(() => {\n                this.enable(defaultTrackIndex);\n            });\n        }\n    }\n\n    /**\n     * Sync hls.js subtitle rendition to match the given language.\n     * Matches by lang, language, or falls back to name/label.\n     */\n    private _syncHlsSubtitleTrack(targetLang: string, targetLabel?: string) {\n        const renderer = (this.player as any).renderer;\n        if (!renderer?.hls || !renderer.hls.subtitleTracks?.length) return;\n\n        const tracks = renderer.hls.subtitleTracks;\n        let hlsIndex = tracks.findIndex(\n            (t: any) => t.lang === targetLang\n        );\n        // Fallback: match by name/label\n        if (hlsIndex < 0 && targetLabel) {\n            hlsIndex = tracks.findIndex(\n                (t: any) => t.name === targetLabel\n            );\n        }\n        if (hlsIndex >= 0 && renderer.hls.subtitleTrack !== hlsIndex) {\n            renderer.hls.subtitleTrack = hlsIndex;\n            this.player.log(`HLS subtitle track set to index ${hlsIndex} (${targetLang})`, 'info');\n        }\n    }\n\n    attachEvents() {\n        this.player.on('timeupdate', () => {\n            this.updateCaptions();\n        });\n\n        // When hls.js finishes loading new subtitle cues, refresh captions\n        this.player.on('textcuesupdate', () => {\n            this.updateCaptions();\n        });\n\n        this.player.on('captionschange', () => {\n            this.updateStyles();\n        });\n        \n        // Debounced resize handler to avoid excessive recalculations\n        this.debouncedPositionCaptions = debounce(() => {\n            this.positionCaptionsOnMobile();\n        }, 150);\n        \n        window.addEventListener('resize', this.debouncedPositionCaptions);\n        \n        // Recalculate on fullscreen change with RAF\n        this.player.on('enterfullscreen', () => {\n            rafWithTimeout(() => this.positionCaptionsOnMobile(), 100);\n        });\n        \n        this.player.on('exitfullscreen', () => {\n            rafWithTimeout(() => this.positionCaptionsOnMobile(), 100);\n        });\n    }\n\n    enable(trackIndex = 0) {\n        if (this.tracks.length === 0) {\n            return;\n        }\n\n        // Disable current track and clean up alternative listeners\n        this._cleanupTrackListeners();\n\n        // Enable selected track\n        const selectedTrack = this.tracks[trackIndex];\n\n        if (selectedTrack && selectedTrack.track) {\n            selectedTrack.track.mode = 'hidden';\n            this.currentTrack = selectedTrack;\n            this.player.state.captionsEnabled = true;\n            \n            if (selectedTrack.language) {\n                this.element.setAttribute('lang', selectedTrack.language);\n            }\n\n            this.cueChangeHandler = () => {\n                this.updateCaptions();\n            };\n            selectedTrack.track.addEventListener('cuechange', this.cueChangeHandler);\n\n            // Native HLS dedup: Safari can expose duplicate TextTrack objects\n            // for the same language (SUBTITLES vs CLOSED-CAPTIONS groups) but\n            // only one actually delivers cues. Listen on all alternatives and\n            // swap to whichever fires first with real cues.\n            if (selectedTrack.alternatives && selectedTrack.alternatives.length > 0) {\n                this._altCueChangeHandler = () => {\n                    if (this.currentTrack !== selectedTrack) return;\n                    for (const alt of selectedTrack.alternatives) {\n                        if (alt.activeCues && alt.activeCues.length > 0) {\n                            this.player.log(`Switching to alternative caption track for \"${selectedTrack.label}\"`, 'info');\n                            selectedTrack.track.removeEventListener('cuechange', this.cueChangeHandler);\n                            selectedTrack.alternatives.forEach((a: TextTrack) => a.removeEventListener('cuechange', this._altCueChangeHandler));\n                            selectedTrack.track = alt;\n                            selectedTrack.track.addEventListener('cuechange', this.cueChangeHandler);\n                            this._altCueChangeHandler = null;\n                            this.updateCaptions();\n                            return;\n                        }\n                    }\n                };\n                selectedTrack.alternatives.forEach((alt: TextTrack) => {\n                    alt.mode = 'hidden';\n                    alt.addEventListener('cuechange', this._altCueChangeHandler);\n                });\n            }\n\n            const ensureTrackReady = () => {\n                if (selectedTrack.track.readyState < 2) {\n                    const onTrackLoad = () => {\n                        selectedTrack.track.removeEventListener('load', onTrackLoad);\n                        selectedTrack.track.removeEventListener('error', onTrackLoad);\n                        requestAnimationFrame(() => {\n                            if (this.currentTrack && this.currentTrack.track === selectedTrack.track) {\n                                this.updateCaptions();\n                            }\n                        });\n                    };\n                    selectedTrack.track.addEventListener('load', onTrackLoad, { once: true });\n                    selectedTrack.track.addEventListener('error', onTrackLoad, { once: true });\n                } else {\n                    requestAnimationFrame(() => {\n                        if (this.currentTrack && this.currentTrack.track === selectedTrack.track) {\n                            this.updateCaptions();\n                        }\n                    });\n                }\n            };\n\n            requestAnimationFrame(() => {\n                if (this.currentTrack && this.currentTrack.track === selectedTrack.track) {\n                    ensureTrackReady();\n                }\n            });\n\n            // Sync hls.js subtitle rendition to match the selected track language\n            this._syncHlsSubtitleTrack(selectedTrack.language, selectedTrack.label);\n\n            this.player.emit('captionsenabled', selectedTrack);\n        }\n    }\n\n    _cleanupTrackListeners() {\n        if (this.currentTrack && this.currentTrack.track) {\n            if (this.cueChangeHandler) {\n                this.currentTrack.track.removeEventListener('cuechange', this.cueChangeHandler);\n            }\n            if (this._altCueChangeHandler && this.currentTrack.alternatives) {\n                this.currentTrack.alternatives.forEach((alt: TextTrack) => {\n                    alt.removeEventListener('cuechange', this._altCueChangeHandler);\n                });\n            }\n            this.currentTrack.track.mode = 'hidden';\n        }\n        this._altCueChangeHandler = null;\n    }\n\n    disable() {\n        this._cleanupTrackListeners();\n        this.currentTrack = null;\n\n        this.element.style.display = 'none';\n        this.element.innerHTML = '';\n        this.element.removeAttribute('lang');\n        this.currentCue = null;\n        this.player.state.captionsEnabled = false;\n        this.player.emit('captionsdisabled');\n    }\n\n    updateCaptions() {\n        if (!this.currentTrack || !this.currentTrack.track) {\n            return;\n        }\n\n        // When the renderer handles its own caption display (e.g. dash.js TTML\n        // rendering div), skip VidPly's caption overlay entirely.\n        if (this.player.renderer?.handlesOwnCaptions?.()) {\n            return;\n        }\n\n        // Ensure track mode is set to 'hidden' (not 'disabled') to receive cue updates\n        // 'hidden' mode loads cues and fires cuechange events, but doesn't show native captions\n        if (this.currentTrack.track.mode === 'disabled') {\n            this.currentTrack.track.mode = 'hidden';\n        }\n\n        if (this.currentTrack.track.mode === 'showing') {\n            this.currentTrack.track.mode = 'hidden';\n        }\n\n        if (!this.currentTrack.track.activeCues) {\n            if (this.currentTrack.track.cues && this.currentTrack.track.cues.length > 0) {\n                if (this.currentCue) {\n                    this.element.innerHTML = '';\n                    this.element.style.display = 'none';\n                    this.currentCue = null;\n                }\n            }\n            return;\n        }\n\n        const activeCues = this.currentTrack.track.activeCues;\n        const isAudioPlayer = this.player.element.tagName.toLowerCase() === 'audio';\n\n        if (activeCues.length > 0) {\n            const cue = activeCues[0];\n\n            if (this.currentCue !== cue) {\n                this.currentCue = cue;\n\n                let text = cue.text || '';\n                text = this.parseVTTFormatting(text);\n                const sanitized = DOMUtils.sanitizeHTML(text);\n\n                if (!sanitized.trim()) {\n                    return;\n                }\n\n                if (isAudioPlayer) {\n                    const existingCues = this.element.querySelectorAll(`.${this.player.options.classPrefix}-caption-cue`);\n                    existingCues.forEach((el: Element) => el.classList.remove(`${this.player.options.classPrefix}-caption-active`));\n                    \n                    const cueId = `cue-${cue.startTime}-${cue.endTime}`;\n                    let cueElement = this.element.querySelector(`[data-cue-id=\"${cueId}\"]`);\n                    \n                    if (!cueElement) {\n                        cueElement = document.createElement('div');\n                        cueElement.className = `${this.player.options.classPrefix}-caption-cue`;\n                        cueElement.setAttribute('data-cue-id', cueId);\n                        cueElement.innerHTML = sanitized;\n                        this.element.appendChild(cueElement);\n                    }\n                    \n                    cueElement.classList.add(`${this.player.options.classPrefix}-caption-active`);\n                    \n                    requestAnimationFrame(() => {\n                        if (cueElement) {\n                            cueElement.scrollIntoView({ behavior: 'smooth', block: 'center' });\n                        }\n                    });\n                } else {\n                    this.element.innerHTML = sanitized;\n                }\n\n                this.element.style.display = 'block';\n                this.positionCaptionsOnMobile();\n                this.player.emit('captionchange', cue);\n            }\n        } else if (this.currentCue) {\n            if (!isAudioPlayer) {\n                this.element.innerHTML = '';\n                this.element.style.display = 'none';\n            }\n            this.currentCue = null;\n        }\n    }\n    \n    positionCaptionsOnMobile() {\n        if (!this.element || this.element.style.display === 'none') {\n            return;\n        }\n        \n        const isFullscreen = this.player.state?.fullscreen || false;\n        const mobile = isMobile();\n        \n        if (!mobile && !isFullscreen) {\n            // Reset to CSS defaults on desktop\n            this.element.style.bottom = '';\n            return;\n        }\n        \n        const controls = this.player.controlBar?.element;\n        if (!controls) {\n            return;\n        }\n        \n        // Use requestAnimationFrame to ensure layout is complete\n        requestAnimationFrame(() => {\n            if (!this.element || this.element.style.display === 'none') {\n                return;\n            }\n            \n            const controlsRect = controls.getBoundingClientRect();\n            const wrapperRect = this.player.videoWrapper.getBoundingClientRect();\n            const bottomOffset = wrapperRect.bottom - controlsRect.top + 16;\n            \n            this.element.style.bottom = `${bottomOffset}px`;\n            \n            if (this.player.options.debug) {\n                console.log('[VidPly] Caption position:', {\n                    mobile,\n                    isFullscreen,\n                    controlsHeight: controlsRect.height,\n                    bottomOffset: `${bottomOffset}px`\n                });\n            }\n        });\n    }\n\n    parseVTTFormatting(text: string) {\n        // Basic VTT tag support\n        text = text.replace(/<c[^>]*>(.*?)<\\/c>/g, '<span class=\"caption-class\">$1</span>');\n        text = text.replace(/<b>(.*?)<\\/b>/g, '<strong>$1</strong>');\n        text = text.replace(/<i>(.*?)<\\/i>/g, '<em>$1</em>');\n        text = text.replace(/<u>(.*?)<\\/u>/g, '<u>$1</u>');\n\n        // Voice tags\n        text = text.replace(/<v\\s+([^>]+)>(.*?)<\\/v>/g, '<span class=\"caption-voice\" data-voice=\"$1\">$2</span>');\n\n        return text;\n    }\n\n    updateStyles() {\n        if (!this.element) return;\n\n        const options = this.player.options;\n\n        this.element.style.fontSize = options.captionsFontSize;\n        this.element.style.fontFamily = options.captionsFontFamily;\n        this.element.style.color = options.captionsColor;\n        this.element.style.backgroundColor = this.hexToRgba(\n            options.captionsBackgroundColor,\n            options.captionsOpacity\n        );\n    }\n\n    hexToRgba(hex: string, alpha: number) {\n        const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n        if (result) {\n            return `rgba(${parseInt(result[1], 16)}, ${parseInt(result[2], 16)}, ${parseInt(result[3], 16)}, ${alpha})`;\n        }\n        return hex;\n    }\n\n    setCaptionStyle(property: string, value: string | number) {\n        switch (property) {\n            case 'fontSize':\n                this.player.options.captionsFontSize = value;\n                break;\n            case 'fontFamily':\n                this.player.options.captionsFontFamily = value;\n                break;\n            case 'color':\n                this.player.options.captionsColor = value;\n                break;\n            case 'backgroundColor':\n                this.player.options.captionsBackgroundColor = value;\n                break;\n            case 'opacity':\n                this.player.options.captionsOpacity = value;\n                break;\n        }\n\n        this.updateStyles();\n        this.saveCaptionPreferences();\n        this.player.emit('captionschange');\n    }\n\n    getAvailableTracks() {\n        return this.tracks.map((t: any, index: number) => ({\n            index,\n            language: t.language,\n            label: t.label || t.language,\n            kind: t.kind\n        }));\n    }\n\n    /**\n     * Refresh tracks list - useful when HLS adds subtitle tracks dynamically\n     */\n    refreshTracks() {\n        // Store current track info to restore after refresh\n        const currentLanguage = this.currentTrack?.language;\n        const wasEnabled = this.player.state.captionsEnabled;\n        \n        // Disable current caption\n        if (this.currentTrack) {\n            this.disable();\n        }\n        \n        // Clear existing tracks\n        this.tracks = [];\n        \n        // Reload tracks from video element\n        this.loadTracks();\n        \n        this.player.log(`Caption tracks refreshed, found ${this.tracks.length} tracks`, 'info');\n        \n        // Try to restore previous track if it exists\n        if (wasEnabled && currentLanguage && this.tracks.length > 0) {\n            const matchingIndex = this.tracks.findIndex((t: any) => t.language === currentLanguage);\n            if (matchingIndex >= 0) {\n                this.enable(matchingIndex);\n            }\n        }\n        \n        return this.tracks.length;\n    }\n\n    switchTrack(trackIndex: number) {\n        if (trackIndex >= 0 && trackIndex < this.tracks.length) {\n            this.disable();\n            this.enable(trackIndex);\n        }\n    }\n\n    destroy() {\n        this.disable();\n\n        if (this.element && this.element.parentNode) {\n            this.element.parentNode.removeChild(this.element);\n        }\n    }\n}\n\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/dev/vidply.esm.js

@@ -15,7 +15,7 @@ import {
   isMobile,
   rafWithTimeout,
   throttle
-} from "./vidply.chunk-ELJA4GMZ.js";
+} from "./vidply.chunk-55W33EGZ.js";
 import {
   StorageManager
 } from "./vidply.chunk-SXDZXXZD.js";
@@ -3397,7 +3397,7 @@ var AudioDescriptionManagerModule = null;
 var SignLanguageManagerModule = null;
 async function loadAudioDescriptionManager() {
   if (!AudioDescriptionManagerModule) {
-    const module = await import("./vidply.AudioDescriptionManager-2LDAC6BR.js");
+    const module = await import("./vidply.AudioDescriptionManager-AXPP5OKO.js");
     AudioDescriptionManagerModule = module.AudioDescriptionManager;
   }
   return AudioDescriptionManagerModule;

package/dist/legacy/vidply.js

@@ -1812,10 +1812,35 @@
             });
           }
         }
+        /**
+         * Sync hls.js subtitle rendition to match the given language.
+         * Matches by lang, language, or falls back to name/label.
+         */
+        _syncHlsSubtitleTrack(targetLang, targetLabel) {
+          var _a;
+          const renderer = this.player.renderer;
+          if (!(renderer == null ? void 0 : renderer.hls) || !((_a = renderer.hls.subtitleTracks) == null ? void 0 : _a.length)) return;
+          const tracks = renderer.hls.subtitleTracks;
+          let hlsIndex = tracks.findIndex(
+            (t) => t.lang === targetLang
+          );
+          if (hlsIndex < 0 && targetLabel) {
+            hlsIndex = tracks.findIndex(
+              (t) => t.name === targetLabel
+            );
+          }
+          if (hlsIndex >= 0 && renderer.hls.subtitleTrack !== hlsIndex) {
+            renderer.hls.subtitleTrack = hlsIndex;
+            this.player.log(`HLS subtitle track set to index ${hlsIndex} (${targetLang})`, "info");
+          }
+        }
         attachEvents() {
           this.player.on("timeupdate", () => {
             this.updateCaptions();
           });
+          this.player.on("textcuesupdate", () => {
+            this.updateCaptions();
+          });
           this.player.on("captionschange", () => {
             this.updateStyles();
           });
@@ -1894,6 +1919,7 @@
                 ensureTrackReady();
               }
             });
+            this._syncHlsSubtitleTrack(selectedTrack.language, selectedTrack.label);
             this.player.emit("captionsenabled", selectedTrack);
           }
         }