bitmovin-player-ui 4.12.0 → 4.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (247) hide show
  1. package/CHANGELOG.md +26 -0
  2. package/dist/css/bitmovinplayer-ui.css +1 -1
  3. package/dist/css/bitmovinplayer-ui.css.map +1 -1
  4. package/dist/js/bitmovinplayer-ui.js +1 -1
  5. package/dist/js/bitmovinplayer-ui.js.map +1 -1
  6. package/dist/js/framework/UIConfig.d.ts +21 -0
  7. package/dist/js/framework/components/UIContainer.js +2 -0
  8. package/dist/js/framework/components/overlays/SubtitleOverlay.d.ts +18 -2
  9. package/dist/js/framework/components/overlays/SubtitleOverlay.js +49 -11
  10. package/dist/js/framework/main.d.ts +1 -1
  11. package/dist/js/framework/spatialnavigation/NavigationGroup.d.ts +16 -3
  12. package/dist/js/framework/spatialnavigation/NavigationGroup.js +10 -0
  13. package/dist/js/framework/spatialnavigation/types.d.ts +1 -0
  14. package/docs/assets/hierarchy.js +1 -1
  15. package/docs/assets/navigation.js +1 -1
  16. package/docs/assets/search.js +1 -1
  17. package/docs/classes/AdClickOverlay.html +28 -28
  18. package/docs/classes/AdControlBar.html +31 -31
  19. package/docs/classes/AdCounterLabel.html +31 -31
  20. package/docs/classes/AdMessageLabel.html +31 -31
  21. package/docs/classes/AdSkipButton.html +27 -27
  22. package/docs/classes/AdStatusOverlay.html +31 -31
  23. package/docs/classes/AirPlayToggleButton.html +35 -35
  24. package/docs/classes/AudioQualitySelectBox.html +41 -41
  25. package/docs/classes/AudioTrackListBox.html +39 -39
  26. package/docs/classes/AudioTrackSelectBox.html +41 -41
  27. package/docs/classes/BackgroundColorSelectBox.html +41 -41
  28. package/docs/classes/BackgroundOpacitySelectBox.html +41 -41
  29. package/docs/classes/BrowserUtils.html +2 -2
  30. package/docs/classes/BufferingOverlay.html +31 -31
  31. package/docs/classes/Button.html +27 -27
  32. package/docs/classes/CastStatusOverlay.html +31 -31
  33. package/docs/classes/CastToggleButton.html +35 -35
  34. package/docs/classes/CastUIContainer.html +31 -31
  35. package/docs/classes/CharacterEdgeColorSelectBox.html +41 -41
  36. package/docs/classes/CharacterEdgeSelectBox.html +41 -41
  37. package/docs/classes/ClickOverlay.html +28 -28
  38. package/docs/classes/CloseButton.html +27 -27
  39. package/docs/classes/Component.html +25 -25
  40. package/docs/classes/Container.html +31 -31
  41. package/docs/classes/ControlBar.html +31 -31
  42. package/docs/classes/DismissClickOverlay.html +31 -31
  43. package/docs/classes/DynamicSettingsPanelItem.html +34 -34
  44. package/docs/classes/EcoModeContainer.html +32 -32
  45. package/docs/classes/EcoModeToggleButton.html +35 -35
  46. package/docs/classes/ErrorMessageOverlay.html +31 -31
  47. package/docs/classes/FontColorSelectBox.html +41 -41
  48. package/docs/classes/FontFamilySelectBox.html +41 -41
  49. package/docs/classes/FontOpacitySelectBox.html +41 -41
  50. package/docs/classes/FontSizeSelectBox.html +41 -41
  51. package/docs/classes/FontStyleSelectBox.html +41 -41
  52. package/docs/classes/FullscreenToggleButton.html +35 -35
  53. package/docs/classes/HugePlaybackToggleButton.html +35 -35
  54. package/docs/classes/HugeReplayButton.html +27 -27
  55. package/docs/classes/I18n.html +2 -2
  56. package/docs/classes/Icon.html +25 -25
  57. package/docs/classes/InteractiveSettingsPanelItem.html +34 -34
  58. package/docs/classes/ItemSelectionList.html +41 -41
  59. package/docs/classes/Label.html +31 -31
  60. package/docs/classes/ListBox.html +39 -39
  61. package/docs/classes/ListSelector.html +41 -41
  62. package/docs/classes/MetadataLabel.html +31 -31
  63. package/docs/classes/NavigationGroup.html +23 -14
  64. package/docs/classes/PictureInPictureToggleButton.html +35 -35
  65. package/docs/classes/PlaybackSpeedSelectBox.html +41 -41
  66. package/docs/classes/PlaybackTimeLabel.html +32 -32
  67. package/docs/classes/PlaybackToggleButton.html +35 -35
  68. package/docs/classes/PlaybackToggleOverlay.html +31 -31
  69. package/docs/classes/PlayerUtils.LiveStreamDetector.html +2 -2
  70. package/docs/classes/PlayerUtils.TimeShiftAvailabilityDetector.html +2 -2
  71. package/docs/classes/PlayerWrapper.html +4 -4
  72. package/docs/classes/QuickSeekButton.html +27 -27
  73. package/docs/classes/RecommendationItem.html +25 -25
  74. package/docs/classes/RecommendationOverlay.html +31 -31
  75. package/docs/classes/ReplayButton.html +27 -27
  76. package/docs/classes/RootNavigationGroup.html +23 -14
  77. package/docs/classes/SeekBar.html +36 -36
  78. package/docs/classes/SeekBarLabel.html +35 -35
  79. package/docs/classes/SelectBox.html +41 -41
  80. package/docs/classes/SettingsPanel.html +39 -39
  81. package/docs/classes/SettingsPanelItem.html +33 -33
  82. package/docs/classes/SettingsPanelNavigationGroup.html +23 -14
  83. package/docs/classes/SettingsPanelNavigationGroupConfig.html +2 -2
  84. package/docs/classes/SettingsPanelPage.html +33 -33
  85. package/docs/classes/SettingsPanelPageBackButton.html +29 -29
  86. package/docs/classes/SettingsPanelPageNavigatorButton.html +29 -29
  87. package/docs/classes/SettingsPanelPageOpenButton.html +29 -29
  88. package/docs/classes/SettingsPanelSelectOption.html +34 -34
  89. package/docs/classes/SettingsToggleButton.html +35 -35
  90. package/docs/classes/ShadowDomManager.html +2 -2
  91. package/docs/classes/SmallCenteredPlaybackToggleButton.html +35 -35
  92. package/docs/classes/Spacer.html +25 -25
  93. package/docs/classes/SpatialNavigation.html +4 -4
  94. package/docs/classes/SubtitleListBox.html +39 -39
  95. package/docs/classes/SubtitleOverlay.html +31 -31
  96. package/docs/classes/SubtitleSelectBox.html +41 -41
  97. package/docs/classes/SubtitleSettingSelectBox.html +41 -41
  98. package/docs/classes/SubtitleSettingsPanelPage.html +33 -33
  99. package/docs/classes/SubtitleSettingsResetButton.html +27 -27
  100. package/docs/classes/TitleBar.html +31 -31
  101. package/docs/classes/ToggleButton.html +35 -35
  102. package/docs/classes/TouchControlOverlay.html +31 -31
  103. package/docs/classes/TvNoiseCanvas.html +25 -25
  104. package/docs/classes/UIContainer.html +31 -31
  105. package/docs/classes/UIInstanceManager.html +14 -14
  106. package/docs/classes/UIManager.html +15 -15
  107. package/docs/classes/VRToggleButton.html +35 -35
  108. package/docs/classes/VideoQualitySelectBox.html +42 -42
  109. package/docs/classes/VolumeControlButton.html +33 -33
  110. package/docs/classes/VolumeSlider.html +36 -36
  111. package/docs/classes/VolumeToggleButton.html +35 -35
  112. package/docs/classes/Watermark.html +28 -28
  113. package/docs/classes/WindowColorSelectBox.html +41 -41
  114. package/docs/classes/WindowOpacitySelectBox.html +41 -41
  115. package/docs/enums/ButtonStyle.html +5 -5
  116. package/docs/enums/LabelStyle.html +4 -4
  117. package/docs/enums/MetadataLabelContent.html +3 -3
  118. package/docs/enums/NavigationDirection.html +2 -2
  119. package/docs/enums/PlaybackTimeLabelMode.html +5 -5
  120. package/docs/enums/PlayerUtils.PlayerState.html +2 -2
  121. package/docs/enums/UIUtils.KeyCode.html +2 -2
  122. package/docs/enums/ViewMode.html +3 -3
  123. package/docs/functions/ArrayUtils.remove.html +1 -1
  124. package/docs/functions/ErrorUtils.defaultMobileV3ErrorMessageTranslator.html +1 -1
  125. package/docs/functions/PlayerUtils.clampValueToRange.html +1 -1
  126. package/docs/functions/PlayerUtils.getCurrentTimeRelativeToSeekableRange.html +1 -1
  127. package/docs/functions/PlayerUtils.getSeekableRangeRespectingLive.html +1 -1
  128. package/docs/functions/PlayerUtils.getSeekableRangeStart.html +1 -1
  129. package/docs/functions/PlayerUtils.getState.html +1 -1
  130. package/docs/functions/PlayerUtils.isTimeShiftAvailable.html +1 -1
  131. package/docs/functions/StorageUtils.getItem.html +1 -1
  132. package/docs/functions/StorageUtils.getObject.html +1 -1
  133. package/docs/functions/StorageUtils.setItem.html +1 -1
  134. package/docs/functions/StorageUtils.setObject.html +1 -1
  135. package/docs/functions/StorageUtils.setStorageApiDisabled.html +1 -1
  136. package/docs/functions/StringUtils.replaceAdMessagePlaceholders.html +1 -1
  137. package/docs/functions/StringUtils.secondsToText.html +1 -1
  138. package/docs/functions/StringUtils.secondsToTime.html +1 -1
  139. package/docs/functions/UIFactory.buildCastReceiverUI.html +1 -1
  140. package/docs/functions/UIFactory.buildSmallScreenUI.html +1 -1
  141. package/docs/functions/UIFactory.buildSubtitleUI.html +1 -1
  142. package/docs/functions/UIFactory.buildTvUI.html +1 -1
  143. package/docs/functions/UIFactory.buildUI.html +1 -1
  144. package/docs/functions/UIFactory.defaultLayouts.ads.html +1 -1
  145. package/docs/functions/UIFactory.defaultLayouts.castReceiver.html +1 -1
  146. package/docs/functions/UIFactory.defaultLayouts.emptyState.html +1 -1
  147. package/docs/functions/UIFactory.defaultLayouts.main.html +1 -1
  148. package/docs/functions/UIFactory.defaultLayouts.smallScreen.html +1 -1
  149. package/docs/functions/UIFactory.defaultLayouts.smallScreenAds.html +1 -1
  150. package/docs/functions/UIFactory.defaultLayouts.subtitle.html +1 -1
  151. package/docs/functions/UIFactory.defaultLayouts.tv.html +1 -1
  152. package/docs/functions/UIFactory.defaultLayouts.tvAds.html +1 -1
  153. package/docs/functions/UIUtils.traverseTree.html +1 -1
  154. package/docs/hierarchy.html +1 -1
  155. package/docs/interfaces/ActiveUiChangedArgs.html +3 -3
  156. package/docs/interfaces/AdControlBarConfig.html +12 -12
  157. package/docs/interfaces/AdSkipButtonConfig.html +16 -16
  158. package/docs/interfaces/AudioTrackListBoxConfig.html +17 -17
  159. package/docs/interfaces/BufferingOverlayConfig.html +13 -13
  160. package/docs/interfaces/ButtonConfig.html +14 -14
  161. package/docs/interfaces/ClickOverlayConfig.html +15 -15
  162. package/docs/interfaces/CloseButtonConfig.html +15 -15
  163. package/docs/interfaces/ComponentConfig.html +11 -11
  164. package/docs/interfaces/ComponentFocusChangedEventArgs.html +2 -2
  165. package/docs/interfaces/ComponentHoverChangedEventArgs.html +2 -2
  166. package/docs/interfaces/ContainerConfig.html +12 -12
  167. package/docs/interfaces/ControlBarConfig.html +12 -12
  168. package/docs/interfaces/DismissClickOverlayConfig.html +14 -14
  169. package/docs/interfaces/DynamicSettingsPanelItemConfig.html +19 -19
  170. package/docs/interfaces/ErrorMessageMap.html +1 -1
  171. package/docs/interfaces/ErrorMessageOverlayConfig.html +13 -13
  172. package/docs/interfaces/ErrorMessageTranslator.html +1 -1
  173. package/docs/interfaces/ExternalRecommendationLink.html +3 -3
  174. package/docs/interfaces/InternalUIConfig.html +34 -18
  175. package/docs/interfaces/LabelConfig.html +14 -14
  176. package/docs/interfaces/ListBoxConfig.html +18 -18
  177. package/docs/interfaces/ListItem.html +2 -2
  178. package/docs/interfaces/ListItemFilter.html +1 -1
  179. package/docs/interfaces/ListItemLabelTranslator.html +1 -1
  180. package/docs/interfaces/ListSelectorConfig.html +12 -12
  181. package/docs/interfaces/LocalizationConfig.html +5 -5
  182. package/docs/interfaces/MetadataLabelConfig.html +15 -15
  183. package/docs/interfaces/PlaybackTimeLabelConfig.html +16 -16
  184. package/docs/interfaces/PlaybackToggleButtonConfig.html +19 -19
  185. package/docs/interfaces/PlaybackToggleOverlayConfig.html +13 -13
  186. package/docs/interfaces/PlayerUtils.LiveStreamDetectorEventArgs.html +2 -2
  187. package/docs/interfaces/PlayerUtils.TimeShiftAvailabilityChangedArgs.html +2 -2
  188. package/docs/interfaces/QuickSeekButtonConfig.html +15 -15
  189. package/docs/interfaces/RecommendationConfig.html +4 -4
  190. package/docs/interfaces/RecommendationItemConfig.html +12 -12
  191. package/docs/interfaces/SeekBarConfig.html +19 -19
  192. package/docs/interfaces/SeekBarLabelConfig.html +12 -12
  193. package/docs/interfaces/SeekBarMarker.html +2 -2
  194. package/docs/interfaces/SeekPreviewArgs.html +3 -3
  195. package/docs/interfaces/SeekPreviewEventArgs.html +4 -4
  196. package/docs/interfaces/SettingsPanelConfig.html +15 -15
  197. package/docs/interfaces/SettingsPanelItemConfig.html +17 -17
  198. package/docs/interfaces/SettingsPanelPageConfig.html +13 -13
  199. package/docs/interfaces/SettingsPanelPageNavigatorConfig.html +17 -17
  200. package/docs/interfaces/SettingsPanelSelectOptionConfig.html +18 -18
  201. package/docs/interfaces/SettingsPanelState.html +2 -2
  202. package/docs/interfaces/SettingsToggleButtonConfig.html +20 -20
  203. package/docs/interfaces/ShadowDomConfig.html +4 -4
  204. package/docs/interfaces/SubtitleListBoxConfig.html +17 -17
  205. package/docs/interfaces/SubtitleOverlayConfig.html +33 -0
  206. package/docs/interfaces/SubtitleSettingSelectBoxConfig.html +12 -12
  207. package/docs/interfaces/SubtitleSettingsPanelPageConfig.html +13 -13
  208. package/docs/interfaces/TimelineMarker.html +6 -6
  209. package/docs/interfaces/TitleBarConfig.html +13 -13
  210. package/docs/interfaces/ToggleButtonConfig.html +18 -18
  211. package/docs/interfaces/TouchControlOverlayConfig.html +17 -17
  212. package/docs/interfaces/UIConditionContext.html +10 -10
  213. package/docs/interfaces/UIConditionResolver.html +1 -1
  214. package/docs/interfaces/UIConfig.html +32 -16
  215. package/docs/interfaces/UIContainerConfig.html +17 -17
  216. package/docs/interfaces/UIUtils.TreeTraversalCallback.html +1 -1
  217. package/docs/interfaces/UIVariant.html +2 -2
  218. package/docs/interfaces/ViewModeChangedEventArgs.html +2 -2
  219. package/docs/interfaces/Vocabularies.html +1 -1
  220. package/docs/interfaces/Vocabulary.html +2 -2
  221. package/docs/interfaces/VolumeControlButtonConfig.html +14 -14
  222. package/docs/interfaces/VolumeSliderConfig.html +21 -21
  223. package/docs/interfaces/WatermarkConfig.html +15 -15
  224. package/docs/interfaces/WrappedPlayer.html +2 -2
  225. package/docs/media/CHANGELOG.md +26 -0
  226. package/docs/modules.html +1 -1
  227. package/docs/types/CustomVocabulary.html +1 -1
  228. package/docs/types/ListItemComparator.html +1 -1
  229. package/docs/types/LocalizableText.html +1 -1
  230. package/docs/types/Localizer.html +1 -1
  231. package/docs/variables/ErrorUtils.defaultErrorMessages.html +1 -1
  232. package/docs/variables/ErrorUtils.defaultWebErrorMessageTranslator.html +1 -1
  233. package/docs/variables/StringUtils.FORMAT_HHMMSS.html +1 -1
  234. package/docs/variables/StringUtils.FORMAT_MMSS.html +1 -1
  235. package/docs/variables/i18n.html +1 -1
  236. package/docs/variables/version.html +1 -1
  237. package/package.json +2 -2
  238. package/src/scss/components/overlays/_subtitle-overlay-cea608.scss +25 -3
  239. package/src/scss/components/overlays/_subtitle-overlay.scss +21 -5
  240. package/src/scss/components/settings/subtitlesettings/_subtitle-overlay-settings.scss +3 -1
  241. package/src/ts/UIConfig.ts +22 -0
  242. package/src/ts/components/UIContainer.ts +4 -1
  243. package/src/ts/components/lists/ListSelector.ts +2 -2
  244. package/src/ts/components/overlays/SubtitleOverlay.ts +70 -14
  245. package/src/ts/main.ts +1 -1
  246. package/src/ts/spatialnavigation/NavigationGroup.ts +37 -3
  247. package/src/ts/spatialnavigation/types.ts +1 -0
package/CHANGELOG.md CHANGED
@@ -5,6 +5,32 @@ All notable changes to this project will be documented in this file.
5
5
  The format is based on [Keep a Changelog](http://keepachangelog.com/)
6
6
  and this project adheres to [Semantic Versioning](http://semver.org/).
7
7
 
8
+ ## [4.14.0] - 2026-05-14
9
+
10
+ ### Added
11
+
12
+ - New `UIConfig.cea608SmallPlayerHeightThreshold` option (default `360`) to configure the rendered player height threshold at or below which small-player CEA-608 caption adjustments are applied
13
+
14
+ ### Changed
15
+
16
+ - CEA-608 captions on players with a rendered height at or below 360 CSS pixels (configurable via `cea608SmallPlayerHeightThreshold`) now stay readable by using a centered 80% safe area and avoiding control-bar pushup that can crowd caption rows on small players
17
+
18
+ ### Fixed
19
+
20
+ - CEA-608 captions could keep stale sizing after CEA subtitle rendering was disabled and re-enabled, causing captions to appear incorrectly scaled or positioned
21
+
22
+ ## [4.13.0] - 2026-05-07
23
+
24
+ ### Added
25
+
26
+ - New `SubtitleOverlayConfig.enableCea608CaptionFormatting` option (defaults to `true`) to opt out of CEA-608-specific text formatting (monospaced font, uppercase transform, character letter-spacing). CEA-608 row/column positioning is still applied.
27
+ - `NavigationGroup.afterNavigation` which is called after a directional navigation finishes, regardless of whether a target was found
28
+
29
+ ### Fixed
30
+
31
+ - Inline `<i>`/`<em>`, `<b>`/`<strong>`, and `<u>` tags in subtitle cue text (e.g. CEA-608 italics) were rendered without their semantic styling
32
+ - Player APIs called after the player was already destroyed
33
+
8
34
  ## [4.12.0] - 2026-04-30
9
35
 
10
36
  ### Added