@gcorevideo/player 2.26.1 → 2.26.4

package/src/plugins/source-controller/__tests__/SourceController.test.ts

@@ -4,11 +4,14 @@ import FakeTimers from '@sinonjs/fake-timers'
 import { SourceController } from '../SourceController'
 import { PlaybackErrorCode } from '../../../playback.types.js'
 import {
+  createMockContainer,
   createMockCore,
   createMockPlayback,
   createMockPlugin,
   createSpinnerPlugin,
 } from '../../../testUtils.js'
+import { Events } from '@clappr/core'
+import { SpinnerEvents } from '../../spinner-three-bounce/SpinnerThreeBounce.js'
 
 // import { LogTracer, Logger, setTracer } from '@gcorevideo/utils'
 
@@ -77,19 +80,22 @@ describe('SourceController', () => {
   describe('on fatal playback failure', () => {
     let core: any
     let nextPlayback: any
+    let nextContainer: any
     describe('basically', () => {
       beforeEach(() => {
         core = createMockCore({
           sources: MOCK_SOURCES,
         })
         const _ = new SourceController(core)
-        core.emit('core:ready')
-        core.emit('core:active:container:changed')
-        core.activePlayback.emit('playback:error', {
+        core.emit(Events.CORE_READY)
+        core.emit(Events.CORE_ACTIVE_CONTAINER_CHANGED)
+        core.activePlayback.emit(Events.PLAYBACK_ERROR, {
           code: PlaybackErrorCode.MediaSourceUnavailable,
         })
-        nextPlayback = createMockPlayback()
+        nextContainer = createMockContainer()
+        nextPlayback = nextContainer.playback
         core.activePlayback = nextPlayback
+        core.activeContainer = nextContainer
       })
       it('should load the next source after a delay', async () => {
         expect(core.load).not.toHaveBeenCalled()
@@ -124,7 +130,7 @@ describe('SourceController', () => {
               return spinner
             }
           })
-          core.emit('core:active:container:changed')
+          core.emit(Events.CORE_ACTIVE_CONTAINER_CHANGED)
         })
         it('should disable the poster', async () => {
           expect(poster.disable).toHaveBeenCalled()
@@ -147,18 +153,22 @@ describe('SourceController', () => {
           }
         })
         const _ = new SourceController(core)
-        core.emit('core:ready')
-        core.emit('core:active:container:changed')
-        core.activePlayback.emit('playback:error', {
+        core.emit(Events.CORE_READY)
+        core.emit(Events.CORE_ACTIVE_CONTAINER_CHANGED)
+        core.activePlayback.emit(Events.PLAYBACK_ERROR, {
           code: PlaybackErrorCode.MediaSourceUnavailable,
         })
-        nextPlayback = createMockPlayback()
+        nextContainer = createMockContainer()
+        nextPlayback = nextContainer.playback
         core.activePlayback = nextPlayback
+        core.activeContainer = nextContainer
       })
       it('should sync with the spinner before reloading the source', async () => {
         await clock.tickAsync(1000)
         expect(core.load).not.toHaveBeenCalled()
-        spinner.emit('plugins:spinner:sync')
+        spinner.emit(SpinnerEvents.SYNC, {
+          elapsedTime: 1000,
+        })
         expect(core.load).toHaveBeenCalled()
       })
     })
@@ -171,14 +181,16 @@ describe('SourceController', () => {
           sources: MOCK_SOURCES,
         })
         const _ = new SourceController(core)
-        core.emit('core:ready')
-        core.emit('core:active:container:changed')
-        core.activePlayback.emit('playback:error', {
+        core.emit(Events.CORE_READY)
+        core.emit(Events.CORE_ACTIVE_CONTAINER_CHANGED)
+        core.activePlayback.emit(Events.PLAYBACK_ERROR, {
           code: PlaybackErrorCode.MediaSourceUnavailable,
         })
         await clock.tickAsync(1000)
-        nextPlayback = createMockPlayback()
+        nextContainer = createMockContainer()
+        nextPlayback = nextContainer.playback
         core.activePlayback = nextPlayback
+        core.activeContainer = nextContainer
         poster = createMockPlugin()
         spinner = createSpinnerPlugin()
         core.activeContainer.getPlugin.mockImplementation((name: string) => {
@@ -189,9 +201,10 @@ describe('SourceController', () => {
             return spinner
           }
         })
-        core.emit('core:ready')
-        core.emit('core:active:container:changed')
-        nextPlayback.emit('playback:play')
+        core.emit(Events.CORE_READY)
+        core.emit(Events.CORE_ACTIVE_CONTAINER_CHANGED)
+        nextPlayback.emit(Events.PLAYBACK_PLAY)
+        nextContainer.emit(Events.CONTAINER_PLAY, 'Container', {})
       })
       it('should enable the poster', async () => {
         expect(poster.enable).toHaveBeenCalled()
@@ -206,7 +219,7 @@ describe('SourceController', () => {
         it('should do nothing', async () => {
           nextPlayback.emit(event)
           await clock.tickAsync(1000)
-          nextPlayback.emit('playback:play')
+          nextPlayback.emit(Events.PLAYBACK_PLAY)
           await clock.tickAsync(1000)
           expect(poster.enable).toHaveBeenCalledTimes(1)
           expect(spinner.hide).toHaveBeenCalledTimes(1)

package/src/plugins/spinner-three-bounce/SpinnerThreeBounce.ts

@@ -166,8 +166,10 @@ export class SpinnerThreeBounce extends UIContainerPlugin {
    */
   override render() {
     this.$el.html(this.template())
-    this.el.firstElementChild?.addEventListener('animationiteration', () => {
-      this.trigger(SpinnerEvents.SYNC)
+    this.el.firstElementChild?.addEventListener('animationiteration', (event) => {
+      this.trigger(SpinnerEvents.SYNC, {
+        elapsedTime: (event as AnimationEvent).elapsedTime,
+      })
     })
     this.container.$el.append(this.$el[0])
     if (this.container.buffering) {

package/src/plugins/thumbnails/Thumbnails.ts

@@ -23,7 +23,7 @@ import { loadImageDimensions } from './utils.js'
 
 /**
  * Plugin configuration options for the thumbnails plugin.
- * @beta
+ * @public
  */
 export type ThumbnailsPluginSettings = {
   backdropHeight?: number
@@ -49,7 +49,7 @@ const T = 'plugins.thumbnails'
 
 /**
  * `PLUGIN` that displays the thumbnails of the video when available.
- * @beta
+ * @public
  * @remarks
  * The plugin needs specially crafted VTT file with a thumbnail sprite sheet to work.
  * The VTT consist of timestamp records followed by a thumbnail area

package/src/plugins/volume-fade/VolumeFade.ts

@@ -33,7 +33,7 @@ export type VolumeFadeSettings = {
 
 /**
  * `PLUGIN` that mutes the sound and fades it in when the mouse is over the player.
- * @beta
+ * @public
  *
  * @remarks
  * When the user moves the mouse over and away from the player, the sound is unmuted and unmuted with a fade effect.

package/temp/player.api.json

@@ -175,7 +175,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!AudioTracks:class",
-          "docComment": "/**\n * `PLUGIN` that makes possible to switch audio tracks via the media control UI.\n *\n * @remarks\n *\n * The plugin is activated when there are multiple audio tracks available. The plugin adds a button showing the current audio track and a dropdown to switch to another audio track. Depends on:\n *\n * - {@link MediaControl}\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that makes possible to switch audio tracks via the media control UI.\n *\n * @remarks\n *\n * The plugin is activated when there are multiple audio tracks available. The plugin adds a button showing the current audio track and a dropdown to switch to another audio track. Depends on:\n *\n * - {@link MediaControl}\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -192,7 +192,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/audio-selector/AudioTracks.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "AudioTracks",
           "preserveMemberOrder": false,
@@ -1865,7 +1865,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!ContextMenu:class",
-          "docComment": "/**\n * `PLUGIN` that displays a small context menu when clicked on the player container.\n *\n * @remarks\n *\n * Configuration options - {@link ContextMenuPluginSettings}\n *\n * Should not be used together with {@link ClickToPause} plugin\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that displays a small context menu when clicked on the player container.\n *\n * @remarks\n *\n * Configuration options - {@link ContextMenuPluginSettings}\n *\n * Should not be used together with {@link ClickToPause} plugin\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1882,7 +1882,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/context-menu/ContextMenu.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "ContextMenu",
           "preserveMemberOrder": false,
@@ -1906,7 +1906,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -1930,7 +1930,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@gcorevideo/player!ContextMenuPluginSettings:interface",
-          "docComment": "/**\n * Context menu plugin settings\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Context menu plugin settings\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1938,7 +1938,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/context-menu/ContextMenu.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "ContextMenuPluginSettings",
           "preserveMemberOrder": false,
           "members": [
@@ -1967,7 +1967,7 @@
               ],
               "isReadonly": false,
               "isOptional": true,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "options",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -3390,7 +3390,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!MediaControl:class",
-          "docComment": "/**\n * `PLUGIN` that provides framework for building media control UI.\n *\n * @remarks\n *\n * The methods exposed are to be used by the other plugins that extend the media control UI.\n *\n * Configuration options (root level)\n *\n * - `hideMediaControlDelay`: number - specifies the delay in milliseconds before the media control UI is hidden after the last user interaction\n *\n * - `mediaControl`: {@link MediaControlSettings} - specifies the media control dashboard layout\n *\n * - `persistConfig`: boolean - `common` option, makes the plugin persist the media control settings\n *\n * - `chromeless`: boolean - `common` option, hides the media control UI\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that provides framework for building media control UI.\n *\n * @remarks\n *\n * The methods exposed are to be used by the other plugins that extend the media control UI.\n *\n * Configuration options (root level)\n *\n * - `hideMediaControlDelay`: number - specifies the delay in milliseconds before the media control UI is hidden after the last user interaction\n *\n * - `mediaControl`: {@link MediaControlSettings} - specifies the media control dashboard layout\n *\n * - `persistConfig`: boolean - `common` option, makes the plugin persist the media control settings\n *\n * - `chromeless`: boolean - `common` option, hides the media control UI\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -3407,7 +3407,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/media-control/MediaControl.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "MediaControl",
           "preserveMemberOrder": false,
@@ -3431,7 +3431,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -3465,7 +3465,7 @@
               ],
               "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "currentSeekPos",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -3498,7 +3498,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -3529,7 +3529,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -3560,7 +3560,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -3613,7 +3613,7 @@
                 "startIndex": 6,
                 "endIndex": 7
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -3653,7 +3653,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -3684,7 +3684,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -3733,7 +3733,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -3778,7 +3778,7 @@
               ],
               "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "muted",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -3811,7 +3811,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -3858,7 +3858,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -3924,7 +3924,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -3989,7 +3989,7 @@
                 "startIndex": 5,
                 "endIndex": 6
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -4034,7 +4034,7 @@
               ],
               "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "volume",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -4054,7 +4054,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!MediaControlElement:type",
-          "docComment": "/**\n * Media control element. Each element's token in the media control layout settings determines where the element is rendered.\n *\n * @remarks\n *\n * Standard media control elements are defined in the {@link StandardMediaControlElement} type. Custom media control elements can be identified by a unique token.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Media control element. Each element's token in the media control layout settings determines where the element is rendered.\n *\n * @remarks\n *\n * Standard media control elements are defined in the {@link StandardMediaControlElement} type. Custom media control elements can be identified by a unique token.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4070,7 +4070,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/media-control/MediaControl.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "MediaControlElement",
           "typeTokenRange": {
             "startIndex": 1,
@@ -4080,7 +4080,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!MediaControlSettings:type",
-          "docComment": "/**\n * Specifies the layout of media control elements. Actual elements will be rendered according to the playback settings. Custom elements rendered by the plugins will be mounted at the specified locations.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Specifies the layout of media control elements. Actual elements will be rendered according to the playback settings. Custom elements rendered by the plugins will be mounted at the specified locations.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4123,7 +4123,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/media-control/MediaControl.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "MediaControlSettings",
           "typeTokenRange": {
             "startIndex": 1,
@@ -4133,7 +4133,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!MediaControlSlotMountPoint:type",
-          "docComment": "/**\n * Identifies a location for mounting custom media control elements.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Identifies a location for mounting custom media control elements.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4149,7 +4149,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/media-control/MediaControl.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "MediaControlSlotMountPoint",
           "typeTokenRange": {
             "startIndex": 1,
@@ -5030,7 +5030,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!PlaybackRate:class",
-          "docComment": "/**\n * `PLUGIN` that allows changing the playback speed of the video.\n *\n * @remarks\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * - {@link BottomGear}\n *\n * It renders an option in the gear menu, which opens a dropdown with the options to change the playback rate. Note that the playback rate change is supported only for VOD or DVR-enabled live streams.\n *\n * Plugin settings - {@link PlaybackRateSettings}\n *\n * @example\n * ```ts\n * import { Player, PlaybackRateSettings } from '@gcorevideo/player'\n * Player.registerPlugin(PlaybackRate)\n * const player = new Player({\n *   playbackRate: {\n *     options: [\n *       { value: 0.5, label: '0.5x' },\n *       { value: 1, label: '1x' },\n *     ],\n *     defaultValue: 1,\n *   },\n * })\n * ```\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that allows changing the playback speed of the video.\n *\n * @remarks\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * - {@link BottomGear}\n *\n * It renders an option in the gear menu, which opens a dropdown with the options to change the playback rate. Note that the playback rate change is supported only for VOD or DVR-enabled live streams.\n *\n * Plugin settings - {@link PlaybackRateSettings}\n *\n * @example\n * ```ts\n * import { Player, PlaybackRateSettings } from '@gcorevideo/player'\n * Player.registerPlugin(PlaybackRate)\n * const player = new Player({\n *   playbackRate: {\n *     options: [\n *       { value: 0.5, label: '0.5x' },\n *       { value: 1, label: '1x' },\n *     ],\n *     defaultValue: 1,\n *   },\n * })\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -5047,7 +5047,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/playback-rate/PlaybackRate.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "PlaybackRate",
           "preserveMemberOrder": false,
@@ -5071,7 +5071,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -7646,7 +7646,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!SeekTime:class",
-          "docComment": "/**\n * `PLUGIN` that adds a seek time indicator when the mouse pointer is over the seek bar.\n *\n * @remarks\n *\n * Configuration options - {@link SeekTimeSettings}\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that adds a seek time indicator when the mouse pointer is over the seek bar.\n *\n * @remarks\n *\n * Configuration options - {@link SeekTimeSettings}\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7663,7 +7663,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/seek-time/SeekTime.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "SeekTime",
           "preserveMemberOrder": false,
@@ -7688,7 +7688,7 @@
               ],
               "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "attributes",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -7718,7 +7718,7 @@
               ],
               "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "name",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -7748,7 +7748,7 @@
               ],
               "isReadonly": true,
               "isOptional": false,
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "supportedVersion",
               "propertyTypeTokenRange": {
                 "startIndex": 1,
@@ -7768,7 +7768,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!SeekTimeSettings:type",
-          "docComment": "/**\n * Configuration options for the SeekTime plugin.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Configuration options for the SeekTime plugin.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7784,7 +7784,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/seek-time/SeekTime.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "SeekTimeSettings",
           "typeTokenRange": {
             "startIndex": 1,
@@ -8875,7 +8875,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!StandardMediaControlElement:type",
-          "docComment": "/**\n * Built-in media control elements.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Built-in media control elements.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -8891,7 +8891,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/media-control/MediaControl.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "StandardMediaControlElement",
           "typeTokenRange": {
             "startIndex": 1,
@@ -9348,7 +9348,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!Thumbnails:class",
-          "docComment": "/**\n * `PLUGIN` that displays the thumbnails of the video when available.\n *\n * @remarks\n *\n * The plugin needs specially crafted VTT file with a thumbnail sprite sheet to work. The VTT consist of timestamp records followed by a thumbnail area\n *\n * Configuration options - {@link ThumbnailsPluginSettings}\n *\n * @example\n * ```ts\n * import { Thumbnails } from '@gcorevideo/player'\n *\n * Player.registerPlugin(Thumbnails)\n *\n * new Player({\n *   thumbnails: {\n *     backdropHeight: 200,\n *     backdropMinOpacity: 0.9,\n *     backdropMaxOpacity: 0.99,\n *     spotlightHeight: 100,\n *     vtt: '1\\n00:00:00,000 --> 00:00:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,0,100,56\\n\\n2\\n00:00:10,000 --> 00:00:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,0,100,56\\n\\n3\\n00:00:20,000 --> 00:00:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,0,100,56\\n\\n4\\n00:00:30,000 --> 00:00:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,0,100,56\\n\\n5\\n00:00:40,000 --> 00:00:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,0,100,56\\n\\n6\\n00:00:50,000 --> 00:01:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,0,100,56\\n\\n7\\n00:01:00,000 --> 00:01:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,0,100,56\\n\\n8\\n00:01:10,000 --> 00:01:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,56,100,56\\n\\n9\\n00:01:20,000 --> 00:01:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,56,100,56\\n\\n10\\n00:01:30,000 --> 00:01:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,56,100,56\\n\\n11\\n00:01:40,000 --> 00:01:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,56,100,56\\n\\n12\\n00:01:50,000 --> 00:02:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,56,100,56\\n\\n13\\n00:02:00,000 --> 00:02:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,56,100,56\\n\\n14\\n00:02:10,000 --> 00:02:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,56,100,56\\n\\n15\\n00:02:20,000 --> 00:02:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,112,100,56\\n\\n16\\n00:02:30,000 --> 00:02:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,112,100,56\\n\\n17\\n00:02:40,000 --> 00:02:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,112,100,56\\n\\n18\\n00:02:50,000 --> 00:03:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,112,100,56\\n\\n19\\n00:03:00,000 --> 00:03:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,112,100,56\\n\\n20\\n00:03:10,000 --> 00:03:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,112,100,56\\n\\n21\\n00:03:20,000 --> 00:03:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,112,100,56\\n\\n22\\n00:03:30,000 --> 00:03:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,168,100,56\\n\\n23\\n00:03:40,000 --> 00:03:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,168,100,56\\n\\n24\\n00:03:50,000 --> 00:04:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,168,100,56\\n\\n25\\n00:04:00,000 --> 00:04:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,168,100,56\\n\\n26\\n00:04:10,000 --> 00:04:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,168,100,56\\n\\n27\\n00:04:20,000 --> 00:04:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,168,100,56\\n\\n28\\n00:04:30,000 --> 00:04:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,168,100,56\\n\\n29\\n00:04:40,000 --> 00:04:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,224,100,56\\n\\n30\\n00:04:50,000 --> 00:05:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,224,100,56\\n\\n31\\n00:05:00,000 --> 00:05:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,224,100,56\\n\\n32\\n00:05:10,000 --> 00:05:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,224,100,56\\n\\n33\\n00:05:20,000 --> 00:05:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,224,100,56\\n\\n34\\n00:05:30,000 --> 00:05:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,224,100,56\\n\\n35\\n00:05:40,000 --> 00:05:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,224,100,56\\n\\n36\\n00:05:50,000 --> 00:06:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,280,100,56\\n\\n37\\n00:06:00,000 --> 00:06:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,280,100,56\\n\\n38\\n00:06:10,000 --> 00:06:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,280,100,56\\n\\n39\\n00:06:20,000 --> 00:06:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,280,100,56\\n\\n40\\n00:06:30,000 --> 00:06:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,280,100,56\\n\\n41\\n00:06:40,000 --> 00:06:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,280,100,56\\n\\n42\\n00:06:50,000 --> 00:07:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,280,100,56\\n\\n43\\n00:07:00,000 --> 00:07:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,336,100,56\\n\\n44\\n00:07:10,000 --> 00:07:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,336,100,56\\n\\n45\\n00:07:20,000 --> 00:07:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,336,100,56\\n\\n46\\n00:07:30,000 --> 00:07:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,336,100,56\\n\\n47\\n00:07:40,000 --> 00:07:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,336,100,56\\n\\n48\\n00:07:50,000 --> 00:08:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,336,100,56\\n\\n49\\n00:08:00,000 --> 00:08:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,336,100,56\\n',\n *     sprite:\n *      'https://static.gvideo.co/videoplatform/sprites/2675/2452164_3dk4NsRt6vWsffEr.mp4_sprite.jpg',\n *   },\n * })\n * ```\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that displays the thumbnails of the video when available.\n *\n * @remarks\n *\n * The plugin needs specially crafted VTT file with a thumbnail sprite sheet to work. The VTT consist of timestamp records followed by a thumbnail area\n *\n * Configuration options - {@link ThumbnailsPluginSettings}\n *\n * @example\n * ```ts\n * import { Thumbnails } from '@gcorevideo/player'\n *\n * Player.registerPlugin(Thumbnails)\n *\n * new Player({\n *   thumbnails: {\n *     backdropHeight: 200,\n *     backdropMinOpacity: 0.9,\n *     backdropMaxOpacity: 0.99,\n *     spotlightHeight: 100,\n *     vtt: '1\\n00:00:00,000 --> 00:00:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,0,100,56\\n\\n2\\n00:00:10,000 --> 00:00:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,0,100,56\\n\\n3\\n00:00:20,000 --> 00:00:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,0,100,56\\n\\n4\\n00:00:30,000 --> 00:00:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,0,100,56\\n\\n5\\n00:00:40,000 --> 00:00:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,0,100,56\\n\\n6\\n00:00:50,000 --> 00:01:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,0,100,56\\n\\n7\\n00:01:00,000 --> 00:01:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,0,100,56\\n\\n8\\n00:01:10,000 --> 00:01:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,56,100,56\\n\\n9\\n00:01:20,000 --> 00:01:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,56,100,56\\n\\n10\\n00:01:30,000 --> 00:01:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,56,100,56\\n\\n11\\n00:01:40,000 --> 00:01:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,56,100,56\\n\\n12\\n00:01:50,000 --> 00:02:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,56,100,56\\n\\n13\\n00:02:00,000 --> 00:02:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,56,100,56\\n\\n14\\n00:02:10,000 --> 00:02:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,56,100,56\\n\\n15\\n00:02:20,000 --> 00:02:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,112,100,56\\n\\n16\\n00:02:30,000 --> 00:02:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,112,100,56\\n\\n17\\n00:02:40,000 --> 00:02:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,112,100,56\\n\\n18\\n00:02:50,000 --> 00:03:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,112,100,56\\n\\n19\\n00:03:00,000 --> 00:03:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,112,100,56\\n\\n20\\n00:03:10,000 --> 00:03:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,112,100,56\\n\\n21\\n00:03:20,000 --> 00:03:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,112,100,56\\n\\n22\\n00:03:30,000 --> 00:03:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,168,100,56\\n\\n23\\n00:03:40,000 --> 00:03:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,168,100,56\\n\\n24\\n00:03:50,000 --> 00:04:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,168,100,56\\n\\n25\\n00:04:00,000 --> 00:04:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,168,100,56\\n\\n26\\n00:04:10,000 --> 00:04:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,168,100,56\\n\\n27\\n00:04:20,000 --> 00:04:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,168,100,56\\n\\n28\\n00:04:30,000 --> 00:04:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,168,100,56\\n\\n29\\n00:04:40,000 --> 00:04:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,224,100,56\\n\\n30\\n00:04:50,000 --> 00:05:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,224,100,56\\n\\n31\\n00:05:00,000 --> 00:05:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,224,100,56\\n\\n32\\n00:05:10,000 --> 00:05:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,224,100,56\\n\\n33\\n00:05:20,000 --> 00:05:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,224,100,56\\n\\n34\\n00:05:30,000 --> 00:05:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,224,100,56\\n\\n35\\n00:05:40,000 --> 00:05:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,224,100,56\\n\\n36\\n00:05:50,000 --> 00:06:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,280,100,56\\n\\n37\\n00:06:00,000 --> 00:06:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,280,100,56\\n\\n38\\n00:06:10,000 --> 00:06:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,280,100,56\\n\\n39\\n00:06:20,000 --> 00:06:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,280,100,56\\n\\n40\\n00:06:30,000 --> 00:06:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,280,100,56\\n\\n41\\n00:06:40,000 --> 00:06:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,280,100,56\\n\\n42\\n00:06:50,000 --> 00:07:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,280,100,56\\n\\n43\\n00:07:00,000 --> 00:07:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=0,336,100,56\\n\\n44\\n00:07:10,000 --> 00:07:20,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=100,336,100,56\\n\\n45\\n00:07:20,000 --> 00:07:30,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=200,336,100,56\\n\\n46\\n00:07:30,000 --> 00:07:40,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=300,336,100,56\\n\\n47\\n00:07:40,000 --> 00:07:50,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=400,336,100,56\\n\\n48\\n00:07:50,000 --> 00:08:00,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=500,336,100,56\\n\\n49\\n00:08:00,000 --> 00:08:10,000\\n3dk4NsRt6vWsffEr_sprite.jpg#xywh=600,336,100,56\\n',\n *     sprite:\n *      'https://static.gvideo.co/videoplatform/sprites/2675/2452164_3dk4NsRt6vWsffEr.mp4_sprite.jpg',\n *   },\n * })\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9365,7 +9365,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/thumbnails/Thumbnails.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "Thumbnails",
           "preserveMemberOrder": false,
@@ -9389,7 +9389,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -9426,7 +9426,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -9444,7 +9444,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!ThumbnailsPluginSettings:type",
-          "docComment": "/**\n * Plugin configuration options for the thumbnails plugin.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Plugin configuration options for the thumbnails plugin.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9460,7 +9460,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/thumbnails/Thumbnails.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "ThumbnailsPluginSettings",
           "typeTokenRange": {
             "startIndex": 1,
@@ -9797,7 +9797,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!VolumeFade:class",
-          "docComment": "/**\n * `PLUGIN` that mutes the sound and fades it in when the mouse is over the player.\n *\n * @remarks\n *\n * When the user moves the mouse over and away from the player, the sound is unmuted and unmuted with a fade effect.\n *\n * Depends on {@link MediaControl} plugin. Configuration options - {@link VolumeFadeSettings}\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that mutes the sound and fades it in when the mouse is over the player.\n *\n * @remarks\n *\n * When the user moves the mouse over and away from the player, the sound is unmuted and unmuted with a fade effect.\n *\n * Depends on {@link MediaControl} plugin. Configuration options - {@link VolumeFadeSettings}\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9814,7 +9814,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/volume-fade/VolumeFade.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "VolumeFade",
           "preserveMemberOrder": false,
@@ -9838,7 +9838,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [