unified-video-framework 1.4.612 → 1.4.614

package/CHANGELOG.md

@@ -1,184 +1,184 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [1.5.0] - 2026-06-04
-
-### Added
-- **Multi-Audio Track Support**: Full support for multiple audio tracks in HLS and DASH streams
-  - `AudioTrackConfig` interface for typed audio track metadata
-  - `getAudioTracks()`, `getCurrentAudioTrack()`, `setAudioTrack(index)` public API methods
-  - Auto-detection of audio tracks from HLS manifests (`MANIFEST_PARSED`, `AUDIO_TRACK_SWITCHED`)
-  - Auto-detection of audio tracks from DASH manifests (`STREAM_INITIALIZED`, `TRACK_CHANGE_RENDERED`)
-  - Manual audio track specification via `VideoSource.audioTracks[]` with label/channel overrides
-  - Default audio track selection via `VideoSource.defaultAudioTrack` (language code or track id)
-  - Audio track preference persistence in `localStorage` (`uvf_preferred_audio_lang`)
-  - Priority-based auto-selection: source default > saved preference > manifest default
-  - `onAudioTracksAvailable` event when tracks are detected from manifest
-  - `onAudioTrackChanged` / `onAudiotrackchange` events on track switch
-  - Audio track accordion section in settings menu with channel info display (5.1, Stereo)
-  - `AudioTrackAPI` interface in `WebPlayerView` for React integration (`onAudioTrackAPI` prop)
-  - `ControlsVisibilityConfig.audio.audioTrackButton` for controlling button visibility
-  - `PlayerConfig.settings.audioTracks` option to enable/disable audio track selection in settings
-  - Proper cleanup of audio track state on source change and player destroy
-  - Comprehensive test suite (25 tests) covering extraction, switching, persistence, and edge cases
-
-## [1.4.85] - 2024-12-25
-
-### Added
-- **🦁 Brave Browser Fullscreen Support**: Comprehensive Brave browser detection and enhanced fullscreen handling
-  - Accurate Brave browser detection using multiple detection methods
-  - Private/Incognito mode detection for different handling approaches
-  - Enhanced permissions checking and fullscreen capability analysis
-  - `enterFullscreenWithBraveSupport()` method with targeted error handling for Brave-specific issues
-  - Brave-specific user gesture validation and permission requests
-- **🧪 Comprehensive Debug Testing**: Advanced debugging tools for Brave fullscreen issues
-  - `brave-fullscreen-debug-test.html` - Comprehensive test page for diagnosing fullscreen problems
-  - Browser environment detection with detailed capability analysis
-  - Multiple fullscreen test methods (button click, keyboard shortcuts, double-click, direct API)
-  - Debug logging system with export functionality for issue analysis
-  - Permission state monitoring and site settings validation
-
-### Enhanced
-- **Fullscreen Button Handler**: Enhanced with Brave-specific logic and debugging
-  - Special handling for Brave normal tabs vs private tabs
-  - Enhanced error messages with browser-specific guidance
-  - Multiple event dispatch methods for maximum compatibility
-  - Fresh user gesture validation for reliable fullscreen activation
-- **Cross-browser Compatibility**: Improved fullscreen API support
-  - Multiple fullscreen API fallbacks (standard, webkit, moz, ms)
-  - Enhanced error handling with specific guidance for common browser issues
-  - Improved user gesture context preservation
-
-### Fixed
-- **Brave Browser Issues**: Resolved common fullscreen problems in Brave browser
-  - Fixed "API can only be initiated by a user gesture" errors in normal tabs
-  - Improved permission handling for Brave's stricter security policies
-  - Better handling of Brave Shields and site settings interference
-  - Enhanced fallback mechanisms when fullscreen APIs are restricted
-
-### Improved
-- **Developer Experience**: Better debugging and issue identification tools
-  - Detailed browser capability detection and logging
-  - Comprehensive test suite for diagnosing fullscreen issues across different browser modes
-  - Enhanced error messages with actionable guidance for users
-  - Export functionality for debug logs to assist with issue resolution
-
-## [1.4.47] - 2024-01-24
-
-### Fixed
-- **EPG Alignment Issues**: Fixed critical alignment problems in Electronic Program Guide
-  - Fixed misaligned grid lines between timeline header and program grid
-  - Resolved channel row height inconsistencies (standardized to 80px)
-  - Fixed timeline header and program grid vertical line alignment
-- **EPG Scrolling Synchronization**: Implemented bidirectional scroll synchronization
-  - Timeline header and program grid now scroll in perfect sync horizontally
-  - Added scroll state management and event coordination
-  - Hidden scrollbars for clean professional appearance
-- **EPG Layout Structure**: Enhanced component architecture
-  - Added 200px channel spacer in timeline header matching program grid
-  - Improved grid line rendering with separate horizontal and vertical lines
-  - Enhanced scroll event handling and throttling
-
-### Changed
-- **EPGProgramGrid**: Enhanced with scroll synchronization props (`onTimelineScroll`, `timelineScrollLeft`)
-- **EPGTimelineHeader**: Restructured layout with scrollable container and channel spacer
-- **EPGOverlay**: Added scroll state management and coordination between components
-
-### Improved
-- Professional TV guide appearance with perfect alignment
-- Smooth synchronized scrolling experience
-- Consistent visual measurements across all EPG components
-- Better user experience for Electronic Program Guide interface
-
-## [1.4.19] - 2024-09-09
-
-### Fixed
-- Fixed ES module import resolution issues when consumers install the package
-- Updated fix-imports.js script to properly handle ES module import statements
-- Fixed internal imports to include .js extensions for ES module compatibility
-- Resolved "Cannot resolve module" errors in consumer projects
-- Fixed directory import issues by updating all import statements to reference specific files
-
-### Changed
-- Enhanced build process to ensure ES modules work correctly when installed via npm
-- Improved fix-imports script to handle both CommonJS and ES module import patterns
-
-## [1.4.1] - 2024-09-06
-
-### Fixed
-- Fixed webpack warning about react-native module resolution in web environments
-- Changed VideoPlayerFactory to use eval() for react-native require to prevent build-time resolution
-
-## [1.4.0] - 2024-09-06
-
-### Added
-- Homepage and bugs URLs for better npm package display
-- CHANGELOG.md to track version changes
-- Engines field specifying Node.js >=14.0.0 and npm >=6.0.0 requirements
-- peerDependenciesMeta to make HLS.js and dash.js optional peer dependencies
-
-### Changed
-- Updated README.md with correct import examples and usage documentation
-- Removed "Under Development" warning from README
-- Improved Quick Start examples with actual working code
-
-### Improved
-- Overall package documentation and npm page presentation
-- TypeScript support with better type exports
-
-## [1.3.4] - 2024-09-06
-
-### Fixed
-- Fixed react-native import error in VideoPlayerFactory by wrapping require in try-catch
-- Improved module exports configuration for better subpath imports
-- Added TypeScript declaration file for better type support
-- Fixed import paths resolution issue when using `unified-video-framework/web`
-
-### Added
-- Added module declaration file `unified-video-framework.d.ts`
-- Added proper export paths for `/packages/web/dist` and `/packages/core/dist`
-
-### Changed
-- Updated build process to exclude non-existent HTML5Player references
-
-## [1.3.3] - 2024-09-06
-
-### Fixed
-- Resolved module resolution issue for @unified-video/core dependency
-- Added post-build script to fix import paths in compiled JavaScript files
-- Updated webpack configuration to bundle core with web package
-
-### Added
-- Added `scripts/fix-imports.js` to automatically fix import paths after build
-- Added `fix-imports` npm script to build process
-
-### Changed
-- Modified build scripts to run fix-imports after compilation
-- Updated prepublishOnly script to use build:publish
-
-## [1.3.2] - 2024-09-06
-
-### Added
-- Initial public release with core functionality
-- Web player implementation with HLS and DASH support
-- React Native player implementation
-- Core interfaces and base player class
-- Support for multiple platforms (iOS, Android, Web, Smart TVs)
-- DRM support architecture
-- Analytics integration hooks
-- Custom controls and theming
-- Watermark overlay support
-- Picture-in-Picture support
-- Subtitle and audio track management
-
-### Features
-- Unified API across all platforms
-- Dynamic loading of streaming libraries (HLS.js, dash.js)
-- Fallback mechanisms for unsupported formats
-- Event-driven architecture
-- TypeScript support with full type definitions
-- Modular package structure (monorepo)
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.5.0] - 2026-06-04
+
+### Added
+- **Multi-Audio Track Support**: Full support for multiple audio tracks in HLS and DASH streams
+  - `AudioTrackConfig` interface for typed audio track metadata
+  - `getAudioTracks()`, `getCurrentAudioTrack()`, `setAudioTrack(index)` public API methods
+  - Auto-detection of audio tracks from HLS manifests (`MANIFEST_PARSED`, `AUDIO_TRACK_SWITCHED`)
+  - Auto-detection of audio tracks from DASH manifests (`STREAM_INITIALIZED`, `TRACK_CHANGE_RENDERED`)
+  - Manual audio track specification via `VideoSource.audioTracks[]` with label/channel overrides
+  - Default audio track selection via `VideoSource.defaultAudioTrack` (language code or track id)
+  - Audio track preference persistence in `localStorage` (`uvf_preferred_audio_lang`)
+  - Priority-based auto-selection: source default > saved preference > manifest default
+  - `onAudioTracksAvailable` event when tracks are detected from manifest
+  - `onAudioTrackChanged` / `onAudiotrackchange` events on track switch
+  - Audio track accordion section in settings menu with channel info display (5.1, Stereo)
+  - `AudioTrackAPI` interface in `WebPlayerView` for React integration (`onAudioTrackAPI` prop)
+  - `ControlsVisibilityConfig.audio.audioTrackButton` for controlling button visibility
+  - `PlayerConfig.settings.audioTracks` option to enable/disable audio track selection in settings
+  - Proper cleanup of audio track state on source change and player destroy
+  - Comprehensive test suite (25 tests) covering extraction, switching, persistence, and edge cases
+
+## [1.4.85] - 2024-12-25
+
+### Added
+- **🦁 Brave Browser Fullscreen Support**: Comprehensive Brave browser detection and enhanced fullscreen handling
+  - Accurate Brave browser detection using multiple detection methods
+  - Private/Incognito mode detection for different handling approaches
+  - Enhanced permissions checking and fullscreen capability analysis
+  - `enterFullscreenWithBraveSupport()` method with targeted error handling for Brave-specific issues
+  - Brave-specific user gesture validation and permission requests
+- **🧪 Comprehensive Debug Testing**: Advanced debugging tools for Brave fullscreen issues
+  - `brave-fullscreen-debug-test.html` - Comprehensive test page for diagnosing fullscreen problems
+  - Browser environment detection with detailed capability analysis
+  - Multiple fullscreen test methods (button click, keyboard shortcuts, double-click, direct API)
+  - Debug logging system with export functionality for issue analysis
+  - Permission state monitoring and site settings validation
+
+### Enhanced
+- **Fullscreen Button Handler**: Enhanced with Brave-specific logic and debugging
+  - Special handling for Brave normal tabs vs private tabs
+  - Enhanced error messages with browser-specific guidance
+  - Multiple event dispatch methods for maximum compatibility
+  - Fresh user gesture validation for reliable fullscreen activation
+- **Cross-browser Compatibility**: Improved fullscreen API support
+  - Multiple fullscreen API fallbacks (standard, webkit, moz, ms)
+  - Enhanced error handling with specific guidance for common browser issues
+  - Improved user gesture context preservation
+
+### Fixed
+- **Brave Browser Issues**: Resolved common fullscreen problems in Brave browser
+  - Fixed "API can only be initiated by a user gesture" errors in normal tabs
+  - Improved permission handling for Brave's stricter security policies
+  - Better handling of Brave Shields and site settings interference
+  - Enhanced fallback mechanisms when fullscreen APIs are restricted
+
+### Improved
+- **Developer Experience**: Better debugging and issue identification tools
+  - Detailed browser capability detection and logging
+  - Comprehensive test suite for diagnosing fullscreen issues across different browser modes
+  - Enhanced error messages with actionable guidance for users
+  - Export functionality for debug logs to assist with issue resolution
+
+## [1.4.47] - 2024-01-24
+
+### Fixed
+- **EPG Alignment Issues**: Fixed critical alignment problems in Electronic Program Guide
+  - Fixed misaligned grid lines between timeline header and program grid
+  - Resolved channel row height inconsistencies (standardized to 80px)
+  - Fixed timeline header and program grid vertical line alignment
+- **EPG Scrolling Synchronization**: Implemented bidirectional scroll synchronization
+  - Timeline header and program grid now scroll in perfect sync horizontally
+  - Added scroll state management and event coordination
+  - Hidden scrollbars for clean professional appearance
+- **EPG Layout Structure**: Enhanced component architecture
+  - Added 200px channel spacer in timeline header matching program grid
+  - Improved grid line rendering with separate horizontal and vertical lines
+  - Enhanced scroll event handling and throttling
+
+### Changed
+- **EPGProgramGrid**: Enhanced with scroll synchronization props (`onTimelineScroll`, `timelineScrollLeft`)
+- **EPGTimelineHeader**: Restructured layout with scrollable container and channel spacer
+- **EPGOverlay**: Added scroll state management and coordination between components
+
+### Improved
+- Professional TV guide appearance with perfect alignment
+- Smooth synchronized scrolling experience
+- Consistent visual measurements across all EPG components
+- Better user experience for Electronic Program Guide interface
+
+## [1.4.19] - 2024-09-09
+
+### Fixed
+- Fixed ES module import resolution issues when consumers install the package
+- Updated fix-imports.js script to properly handle ES module import statements
+- Fixed internal imports to include .js extensions for ES module compatibility
+- Resolved "Cannot resolve module" errors in consumer projects
+- Fixed directory import issues by updating all import statements to reference specific files
+
+### Changed
+- Enhanced build process to ensure ES modules work correctly when installed via npm
+- Improved fix-imports script to handle both CommonJS and ES module import patterns
+
+## [1.4.1] - 2024-09-06
+
+### Fixed
+- Fixed webpack warning about react-native module resolution in web environments
+- Changed VideoPlayerFactory to use eval() for react-native require to prevent build-time resolution
+
+## [1.4.0] - 2024-09-06
+
+### Added
+- Homepage and bugs URLs for better npm package display
+- CHANGELOG.md to track version changes
+- Engines field specifying Node.js >=14.0.0 and npm >=6.0.0 requirements
+- peerDependenciesMeta to make HLS.js and dash.js optional peer dependencies
+
+### Changed
+- Updated README.md with correct import examples and usage documentation
+- Removed "Under Development" warning from README
+- Improved Quick Start examples with actual working code
+
+### Improved
+- Overall package documentation and npm page presentation
+- TypeScript support with better type exports
+
+## [1.3.4] - 2024-09-06
+
+### Fixed
+- Fixed react-native import error in VideoPlayerFactory by wrapping require in try-catch
+- Improved module exports configuration for better subpath imports
+- Added TypeScript declaration file for better type support
+- Fixed import paths resolution issue when using `unified-video-framework/web`
+
+### Added
+- Added module declaration file `unified-video-framework.d.ts`
+- Added proper export paths for `/packages/web/dist` and `/packages/core/dist`
+
+### Changed
+- Updated build process to exclude non-existent HTML5Player references
+
+## [1.3.3] - 2024-09-06
+
+### Fixed
+- Resolved module resolution issue for @unified-video/core dependency
+- Added post-build script to fix import paths in compiled JavaScript files
+- Updated webpack configuration to bundle core with web package
+
+### Added
+- Added `scripts/fix-imports.js` to automatically fix import paths after build
+- Added `fix-imports` npm script to build process
+
+### Changed
+- Modified build scripts to run fix-imports after compilation
+- Updated prepublishOnly script to use build:publish
+
+## [1.3.2] - 2024-09-06
+
+### Added
+- Initial public release with core functionality
+- Web player implementation with HLS and DASH support
+- React Native player implementation
+- Core interfaces and base player class
+- Support for multiple platforms (iOS, Android, Web, Smart TVs)
+- DRM support architecture
+- Analytics integration hooks
+- Custom controls and theming
+- Watermark overlay support
+- Picture-in-Picture support
+- Subtitle and audio track management
+
+### Features
+- Unified API across all platforms
+- Dynamic loading of streaming libraries (HLS.js, dash.js)
+- Fallback mechanisms for unsupported formats
+- Event-driven architecture
+- TypeScript support with full type definitions
+- Modular package structure (monorepo)