bitmovin-player-ui 4.21.0 → 4.22.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 (299) hide show
  1. package/CHANGELOG.md +13 -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/UIComponentConfigOverrides.d.ts +4 -0
  7. package/dist/js/framework/UIComponentLayoutOverrides.d.ts +4 -0
  8. package/dist/js/framework/UIFactory.js +16 -2
  9. package/dist/js/framework/UIManager.d.ts +1 -0
  10. package/dist/js/framework/UIManager.js +27 -0
  11. package/dist/js/framework/components/Component.d.ts +1 -0
  12. package/dist/js/framework/components/Component.js +3 -0
  13. package/dist/js/framework/components/ads/PauseAdStatusOverlay.d.ts +33 -0
  14. package/dist/js/framework/components/ads/PauseAdStatusOverlay.js +172 -0
  15. package/dist/js/framework/components/overlays/TouchControlOverlay.d.ts +12 -0
  16. package/dist/js/framework/components/overlays/TouchControlOverlay.js +27 -2
  17. package/dist/js/framework/main.d.ts +2 -0
  18. package/dist/js/framework/main.js +6 -24
  19. package/dist/js/framework/polyfills.d.ts +21 -0
  20. package/dist/js/framework/polyfills.js +60 -0
  21. package/dist/js/framework/spatialnavigation/NavigationGroup.d.ts +2 -1
  22. package/dist/js/framework/spatialnavigation/NavigationGroup.js +11 -2
  23. package/dist/js/framework/spatialnavigation/PauseAdNavigationGroup.d.ts +20 -0
  24. package/dist/js/framework/spatialnavigation/PauseAdNavigationGroup.js +75 -0
  25. package/dist/js/framework/spatialnavigation/SeekBarHandler.d.ts +2 -2
  26. package/dist/js/framework/utils/BrowserUtils.js +1 -3
  27. package/dist/js/framework/utils/NonLinearAdEvents.d.ts +3 -0
  28. package/dist/js/framework/utils/NonLinearAdEvents.js +17 -0
  29. package/docs/assets/hierarchy.js +1 -1
  30. package/docs/assets/navigation.js +1 -1
  31. package/docs/assets/search.js +1 -1
  32. package/docs/classes/AdClickOverlay.html +28 -28
  33. package/docs/classes/AdControlBar.html +31 -31
  34. package/docs/classes/AdCounterLabel.html +31 -31
  35. package/docs/classes/AdMessageLabel.html +31 -31
  36. package/docs/classes/AdSkipButton.html +27 -27
  37. package/docs/classes/AdStatusOverlay.html +31 -31
  38. package/docs/classes/AirPlayToggleButton.html +35 -35
  39. package/docs/classes/AudioQualitySelectBox.html +41 -41
  40. package/docs/classes/AudioTrackListBox.html +39 -39
  41. package/docs/classes/AudioTrackSelectBox.html +41 -41
  42. package/docs/classes/BackgroundColorSelectBox.html +41 -41
  43. package/docs/classes/BackgroundOpacitySelectBox.html +41 -41
  44. package/docs/classes/BrowserUtils.html +2 -2
  45. package/docs/classes/BufferingOverlay.html +31 -31
  46. package/docs/classes/Button.html +27 -27
  47. package/docs/classes/CaptionToggleButton.html +35 -35
  48. package/docs/classes/CastStatusOverlay.html +31 -31
  49. package/docs/classes/CastToggleButton.html +35 -35
  50. package/docs/classes/CastUIContainer.html +31 -31
  51. package/docs/classes/CharacterEdgeColorSelectBox.html +41 -41
  52. package/docs/classes/CharacterEdgeSelectBox.html +41 -41
  53. package/docs/classes/ClickOverlay.html +28 -28
  54. package/docs/classes/CloseButton.html +27 -27
  55. package/docs/classes/Component.html +25 -25
  56. package/docs/classes/Container.html +31 -31
  57. package/docs/classes/ContextMenu.html +39 -39
  58. package/docs/classes/ControlBar.html +31 -31
  59. package/docs/classes/DismissClickOverlay.html +31 -31
  60. package/docs/classes/DynamicSettingsPanelItem.html +34 -34
  61. package/docs/classes/EcoModeContainer.html +32 -32
  62. package/docs/classes/EcoModeToggleButton.html +35 -35
  63. package/docs/classes/ErrorMessageOverlay.html +31 -31
  64. package/docs/classes/FontColorSelectBox.html +41 -41
  65. package/docs/classes/FontFamilySelectBox.html +41 -41
  66. package/docs/classes/FontOpacitySelectBox.html +41 -41
  67. package/docs/classes/FontSizeSelectBox.html +41 -41
  68. package/docs/classes/FontStyleSelectBox.html +41 -41
  69. package/docs/classes/FullscreenToggleButton.html +35 -35
  70. package/docs/classes/HugePlaybackToggleButton.html +35 -35
  71. package/docs/classes/HugeReplayButton.html +27 -27
  72. package/docs/classes/I18n.html +2 -2
  73. package/docs/classes/Icon.html +25 -25
  74. package/docs/classes/InteractiveContextMenuItem.html +34 -34
  75. package/docs/classes/InteractiveSettingsPanelItem.html +34 -34
  76. package/docs/classes/ItemSelectionList.html +41 -41
  77. package/docs/classes/Label.html +31 -31
  78. package/docs/classes/ListBox.html +39 -39
  79. package/docs/classes/ListSelector.html +41 -41
  80. package/docs/classes/MetadataLabel.html +31 -31
  81. package/docs/classes/NavigationGroup.html +12 -12
  82. package/docs/classes/PauseAdStatusOverlay.html +107 -0
  83. package/docs/classes/PersistentPreferencesToggleButton.html +35 -35
  84. package/docs/classes/PictureInPictureToggleButton.html +35 -35
  85. package/docs/classes/PlaybackSpeedSelectBox.html +41 -41
  86. package/docs/classes/PlaybackTimeLabel.html +32 -32
  87. package/docs/classes/PlaybackToggleButton.html +35 -35
  88. package/docs/classes/PlaybackToggleOverlay.html +31 -31
  89. package/docs/classes/PlayerContextMenu.html +39 -39
  90. package/docs/classes/PlayerInsightsPanel.html +39 -39
  91. package/docs/classes/PlayerUtils.LiveStreamDetector.html +2 -2
  92. package/docs/classes/PlayerUtils.TimeShiftAvailabilityDetector.html +2 -2
  93. package/docs/classes/PlayerWrapper.html +4 -4
  94. package/docs/classes/QuickSeekButton.html +27 -27
  95. package/docs/classes/RecommendationItem.html +25 -25
  96. package/docs/classes/RecommendationOverlay.html +31 -31
  97. package/docs/classes/ReplayButton.html +27 -27
  98. package/docs/classes/RootNavigationGroup.html +12 -12
  99. package/docs/classes/SeekBar.html +36 -36
  100. package/docs/classes/SeekBarLabel.html +35 -35
  101. package/docs/classes/SelectBox.html +41 -41
  102. package/docs/classes/SettingsPanel.html +39 -39
  103. package/docs/classes/SettingsPanelItem.html +33 -33
  104. package/docs/classes/SettingsPanelNavigationGroup.html +12 -12
  105. package/docs/classes/SettingsPanelNavigationGroupConfig.html +2 -2
  106. package/docs/classes/SettingsPanelPage.html +33 -33
  107. package/docs/classes/SettingsPanelPageBackButton.html +29 -29
  108. package/docs/classes/SettingsPanelPageNavigatorButton.html +29 -29
  109. package/docs/classes/SettingsPanelPageOpenButton.html +29 -29
  110. package/docs/classes/SettingsPanelSelectOption.html +34 -34
  111. package/docs/classes/SettingsPanelSeparator.html +31 -31
  112. package/docs/classes/SettingsToggleButton.html +35 -35
  113. package/docs/classes/ShadowDomManager.html +2 -2
  114. package/docs/classes/SmallCenteredPlaybackToggleButton.html +35 -35
  115. package/docs/classes/Spacer.html +25 -25
  116. package/docs/classes/SpatialNavigation.html +4 -4
  117. package/docs/classes/SubtitleListBox.html +39 -39
  118. package/docs/classes/SubtitleOverlay.html +31 -31
  119. package/docs/classes/SubtitleSelectBox.html +41 -41
  120. package/docs/classes/SubtitleSettingSelectBox.html +41 -41
  121. package/docs/classes/SubtitleSettingsPanelPage.html +33 -33
  122. package/docs/classes/SubtitleSettingsResetButton.html +27 -27
  123. package/docs/classes/TitleBar.html +31 -31
  124. package/docs/classes/ToggleButton.html +35 -35
  125. package/docs/classes/ToggleSettingsPanelItem.html +34 -34
  126. package/docs/classes/TouchControlOverlay.html +32 -32
  127. package/docs/classes/TvNoiseCanvas.html +25 -25
  128. package/docs/classes/UIContainer.html +31 -31
  129. package/docs/classes/UIInstanceManager.html +16 -16
  130. package/docs/classes/UIManager.html +17 -17
  131. package/docs/classes/UIPreferencesManager.html +5 -5
  132. package/docs/classes/VRToggleButton.html +35 -35
  133. package/docs/classes/VideoQualitySelectBox.html +42 -42
  134. package/docs/classes/VolumeControlButton.html +33 -33
  135. package/docs/classes/VolumeSlider.html +36 -36
  136. package/docs/classes/VolumeToggleButton.html +35 -35
  137. package/docs/classes/Watermark.html +28 -28
  138. package/docs/classes/WindowColorSelectBox.html +41 -41
  139. package/docs/classes/WindowOpacitySelectBox.html +41 -41
  140. package/docs/enums/ButtonStyle.html +5 -5
  141. package/docs/enums/LabelStyle.html +4 -4
  142. package/docs/enums/MetadataLabelContent.html +3 -3
  143. package/docs/enums/NavigationDirection.html +2 -2
  144. package/docs/enums/PlaybackTimeLabelMode.html +5 -5
  145. package/docs/enums/PlayerUtils.PlayerState.html +2 -2
  146. package/docs/enums/UIComponentLayoutOverride.html +2 -2
  147. package/docs/enums/UIUtils.KeyCode.html +2 -2
  148. package/docs/enums/UIVariantIdentifier.html +2 -2
  149. package/docs/enums/ViewMode.html +3 -3
  150. package/docs/functions/ArrayUtils.remove.html +1 -1
  151. package/docs/functions/ErrorUtils.defaultMobileV3ErrorMessageTranslator.html +1 -1
  152. package/docs/functions/PlayerUtils.clampValueToRange.html +1 -1
  153. package/docs/functions/PlayerUtils.getCurrentTimeRelativeToSeekableRange.html +1 -1
  154. package/docs/functions/PlayerUtils.getSeekableRangeRespectingLive.html +1 -1
  155. package/docs/functions/PlayerUtils.getSeekableRangeStart.html +1 -1
  156. package/docs/functions/PlayerUtils.getState.html +1 -1
  157. package/docs/functions/PlayerUtils.isTimeShiftAvailable.html +1 -1
  158. package/docs/functions/StorageUtils.getItem.html +1 -1
  159. package/docs/functions/StorageUtils.getObject.html +1 -1
  160. package/docs/functions/StorageUtils.removeItem.html +1 -1
  161. package/docs/functions/StorageUtils.setItem.html +1 -1
  162. package/docs/functions/StorageUtils.setObject.html +1 -1
  163. package/docs/functions/StorageUtils.setStorageApiDisabled.html +1 -1
  164. package/docs/functions/StringUtils.replaceAdMessagePlaceholders.html +1 -1
  165. package/docs/functions/StringUtils.secondsToText.html +1 -1
  166. package/docs/functions/StringUtils.secondsToTime.html +1 -1
  167. package/docs/functions/UIFactory.buildCastReceiverUI.html +1 -1
  168. package/docs/functions/UIFactory.buildSmallScreenUI.html +1 -1
  169. package/docs/functions/UIFactory.buildSubtitleUI.html +1 -1
  170. package/docs/functions/UIFactory.buildTvUI.html +1 -1
  171. package/docs/functions/UIFactory.buildUI.html +1 -1
  172. package/docs/functions/UIFactory.defaultLayouts.ads.html +1 -1
  173. package/docs/functions/UIFactory.defaultLayouts.castReceiver.html +1 -1
  174. package/docs/functions/UIFactory.defaultLayouts.emptyState.html +1 -1
  175. package/docs/functions/UIFactory.defaultLayouts.main.html +1 -1
  176. package/docs/functions/UIFactory.defaultLayouts.smallScreen.html +1 -1
  177. package/docs/functions/UIFactory.defaultLayouts.smallScreenAds.html +1 -1
  178. package/docs/functions/UIFactory.defaultLayouts.subtitle.html +1 -1
  179. package/docs/functions/UIFactory.defaultLayouts.tv.html +1 -1
  180. package/docs/functions/UIFactory.defaultLayouts.tvAds.html +1 -1
  181. package/docs/functions/UIUtils.traverseTree.html +1 -1
  182. package/docs/hierarchy.html +1 -1
  183. package/docs/interfaces/ActiveUiChangedArgs.html +3 -3
  184. package/docs/interfaces/AdControlBarConfig.html +12 -12
  185. package/docs/interfaces/AdSkipButtonConfig.html +16 -16
  186. package/docs/interfaces/AudioTrackListBoxConfig.html +19 -19
  187. package/docs/interfaces/BufferingOverlayConfig.html +13 -13
  188. package/docs/interfaces/ButtonConfig.html +14 -14
  189. package/docs/interfaces/ClickOverlayConfig.html +15 -15
  190. package/docs/interfaces/CloseButtonConfig.html +15 -15
  191. package/docs/interfaces/ComponentConfig.html +11 -11
  192. package/docs/interfaces/ComponentFocusChangedEventArgs.html +2 -2
  193. package/docs/interfaces/ComponentHoverChangedEventArgs.html +2 -2
  194. package/docs/interfaces/ContainerConfig.html +12 -12
  195. package/docs/interfaces/ContextMenuConfig.html +17 -17
  196. package/docs/interfaces/ControlBarConfig.html +12 -12
  197. package/docs/interfaces/DismissClickOverlayConfig.html +14 -14
  198. package/docs/interfaces/DynamicSettingsPanelItemConfig.html +19 -19
  199. package/docs/interfaces/ErrorMessageMap.html +1 -1
  200. package/docs/interfaces/ErrorMessageOverlayConfig.html +13 -13
  201. package/docs/interfaces/ErrorMessageTranslator.html +1 -1
  202. package/docs/interfaces/ExternalRecommendationLink.html +3 -3
  203. package/docs/interfaces/InteractiveContextMenuItemConfig.html +18 -18
  204. package/docs/interfaces/InternalUIConfig.html +26 -26
  205. package/docs/interfaces/LabelConfig.html +14 -14
  206. package/docs/interfaces/ListBoxConfig.html +20 -20
  207. package/docs/interfaces/ListItem.html +2 -2
  208. package/docs/interfaces/ListItemFilter.html +1 -1
  209. package/docs/interfaces/ListItemLabelTranslator.html +1 -1
  210. package/docs/interfaces/ListSelectorConfig.html +12 -12
  211. package/docs/interfaces/LocalizationConfig.html +5 -5
  212. package/docs/interfaces/MetadataLabelConfig.html +15 -15
  213. package/docs/interfaces/PlaybackTimeLabelConfig.html +16 -16
  214. package/docs/interfaces/PlaybackToggleButtonConfig.html +19 -19
  215. package/docs/interfaces/PlaybackToggleOverlayConfig.html +13 -13
  216. package/docs/interfaces/PlayerContextMenuConfig.html +18 -18
  217. package/docs/interfaces/PlayerInsightsPanelConfig.html +18 -18
  218. package/docs/interfaces/PlayerUtils.LiveStreamDetectorEventArgs.html +2 -2
  219. package/docs/interfaces/PlayerUtils.TimeShiftAvailabilityChangedArgs.html +2 -2
  220. package/docs/interfaces/QuickSeekButtonConfig.html +15 -15
  221. package/docs/interfaces/RecommendationConfig.html +4 -4
  222. package/docs/interfaces/RecommendationItemConfig.html +12 -12
  223. package/docs/interfaces/RecommendationsApi.html +4 -4
  224. package/docs/interfaces/SeekBarConfig.html +19 -19
  225. package/docs/interfaces/SeekBarLabelConfig.html +12 -12
  226. package/docs/interfaces/SeekBarMarker.html +2 -2
  227. package/docs/interfaces/SeekPreviewArgs.html +3 -3
  228. package/docs/interfaces/SeekPreviewEventArgs.html +4 -4
  229. package/docs/interfaces/SettingsPanelConfig.html +17 -17
  230. package/docs/interfaces/SettingsPanelItemConfig.html +17 -17
  231. package/docs/interfaces/SettingsPanelPageConfig.html +13 -13
  232. package/docs/interfaces/SettingsPanelPageNavigatorConfig.html +17 -17
  233. package/docs/interfaces/SettingsPanelSelectOptionConfig.html +18 -18
  234. package/docs/interfaces/SettingsPanelSeparatorConfig.html +12 -12
  235. package/docs/interfaces/SettingsPanelState.html +2 -2
  236. package/docs/interfaces/SettingsToggleButtonConfig.html +20 -20
  237. package/docs/interfaces/ShadowDomConfig.html +4 -4
  238. package/docs/interfaces/SubtitleListBoxConfig.html +19 -19
  239. package/docs/interfaces/SubtitleOverlayConfig.html +14 -14
  240. package/docs/interfaces/SubtitleSettingSelectBoxConfig.html +12 -12
  241. package/docs/interfaces/SubtitleSettingsPanelPageConfig.html +13 -13
  242. package/docs/interfaces/TimelineMarker.html +6 -6
  243. package/docs/interfaces/TimelineMarkersApi.html +4 -4
  244. package/docs/interfaces/TitleBarConfig.html +13 -13
  245. package/docs/interfaces/ToggleButtonConfig.html +18 -18
  246. package/docs/interfaces/ToggleSettingsPanelItemConfig.html +17 -17
  247. package/docs/interfaces/TouchControlOverlayConfig.html +22 -17
  248. package/docs/interfaces/UIComponentConfigMap.html +3 -2
  249. package/docs/interfaces/UIComponentConfigOverrides.html +11 -10
  250. package/docs/interfaces/UIComponentLayoutOverrideMap.html +3 -2
  251. package/docs/interfaces/UIComponentLayoutOverrides.html +11 -10
  252. package/docs/interfaces/UIConditionContext.html +10 -10
  253. package/docs/interfaces/UIConditionResolver.html +1 -1
  254. package/docs/interfaces/UIConfig.html +24 -24
  255. package/docs/interfaces/UIContainerConfig.html +17 -17
  256. package/docs/interfaces/UIUtils.TreeTraversalCallback.html +1 -1
  257. package/docs/interfaces/UIVariant.html +5 -5
  258. package/docs/interfaces/UIVariantFactory.html +4 -4
  259. package/docs/interfaces/ViewModeChangedEventArgs.html +2 -2
  260. package/docs/interfaces/Vocabularies.html +1 -1
  261. package/docs/interfaces/Vocabulary.html +2 -2
  262. package/docs/interfaces/VolumeControlButtonConfig.html +14 -14
  263. package/docs/interfaces/VolumeSliderConfig.html +21 -21
  264. package/docs/interfaces/WatermarkConfig.html +15 -15
  265. package/docs/interfaces/WrappedPlayer.html +2 -2
  266. package/docs/media/CHANGELOG.md +13 -0
  267. package/docs/modules.html +1 -1
  268. package/docs/types/CustomVocabulary.html +1 -1
  269. package/docs/types/ListItemComparator.html +1 -1
  270. package/docs/types/LocalizableText.html +1 -1
  271. package/docs/types/Localizer.html +1 -1
  272. package/docs/variables/ErrorUtils.defaultErrorMessages.html +1 -1
  273. package/docs/variables/ErrorUtils.defaultWebErrorMessageTranslator.html +1 -1
  274. package/docs/variables/StringUtils.FORMAT_HHMMSS.html +1 -1
  275. package/docs/variables/StringUtils.FORMAT_MMSS.html +1 -1
  276. package/docs/variables/i18n.html +1 -1
  277. package/docs/variables/version.html +1 -1
  278. package/package.json +1 -1
  279. package/src/scss/bitmovinplayer-ui.scss +1 -0
  280. package/src/scss/components/ads/_pause-ad-status-overlay.scss +111 -0
  281. package/src/ts/UIComponentConfigOverrides.ts +4 -0
  282. package/src/ts/UIComponentLayoutOverrides.ts +4 -0
  283. package/src/ts/UIFactory.ts +19 -1
  284. package/src/ts/UIManager.ts +27 -0
  285. package/src/ts/components/Component.ts +3 -0
  286. package/src/ts/components/ads/PauseAdStatusOverlay.ts +184 -0
  287. package/src/ts/components/overlays/TouchControlOverlay.ts +38 -2
  288. package/src/ts/main.ts +3 -24
  289. package/src/ts/polyfills.ts +66 -0
  290. package/src/ts/spatialnavigation/NavigationGroup.ts +13 -2
  291. package/src/ts/spatialnavigation/PauseAdNavigationGroup.ts +49 -0
  292. package/src/ts/spatialnavigation/SeekBarHandler.ts +2 -2
  293. package/src/ts/utils/BrowserUtils.ts +1 -5
  294. package/src/ts/utils/NonLinearAdEvents.ts +7 -0
  295. package/test/browser/harness.ts +190 -11
  296. package/test/browser/helpers/tv.ts +45 -0
  297. package/test/browser/pause-ad-click-routing.pw.ts +140 -0
  298. package/test/browser/pause-ad-mobile-controls.pw.ts +170 -0
  299. package/test/browser/pause-ad-tv-controls.pw.ts +257 -0
package/CHANGELOG.md CHANGED
@@ -5,6 +5,19 @@ 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.22.0] - 2026-09-25
9
+
10
+ ### Added
11
+
12
+ - `PauseAdStatusOverlay` to show an Ad badge and a Close button over pause ads in the default, small-screen, and TV layouts. Clicking the creative opens its click-through while the player controls stay usable.
13
+ - `TouchControlOverlayConfig.singleTapAction` and `PauseAdStatusOverlay.getClickThroughAction()` to open a pause-ad click-through on a single tap without breaking double-tap seeking.
14
+
15
+ ## [4.21.1] - 2026-09-17
16
+
17
+ ### Fixed
18
+
19
+ - The UI failing to load on legacy platforms such as webOS 3.x when required polyfills were not yet installed.
20
+
8
21
  ## [4.21.0] - 2026-09-10
9
22
 
10
23
  ### Changed