@gcorevideo/player 2.22.0 → 2.22.2

package/temp/player.api.json

@@ -237,7 +237,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!BottomGear:class",
-          "docComment": "/**\n * `PLUGIN` that adds the gear button with an extra options menu on the right side of the {@link MediaControl | media control} UI\n *\n * @remarks\n *\n * The plugins provides a base for attaching custom settings UI in the gear menu\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that adds a button to extend the media controls UI with extra options.\n *\n * @remarks\n *\n * The plugin renders small gear icon to the right of the media controls. It provides a base for attaching custom settings UI in the gear menu\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * @example\n *\n * You can use bottom gear to add custom settings UI to the gear menu.\n * ```ts\n * import { BottomGear } from '@gcorevideo/player/plugins/bottom-gear';\n *\n * class CustomOptionsPlugin extends UICorePlugin {\n *   // ...\n *\n *   override get events() {\n *     return {\n *       'click #my-button': 'doMyAction',\n *     }\n *   }\n *\n *   private doMyAction() {\n *     // ...\n *   }\n *\n *   override render() {\n *     const bottomGear = this.core.getPlugin('bottom_gear');\n *     if (!bottomGear) {\n *       return this;\n *     }\n *     this.$el.html('<button class=\"custom-option\">Custom option</button>');\n *     // Put rendered element into the gear menu\n *     bottomGear.addItem('custom').html(this.$el)\n *     return this;\n *   }\n *\n *   // alternatively, add an option with a submenu\n *   override render() {\n *     this.$el.html(template(templateHtml)({\n *       // ...\n *     })));\n *     return this;\n *   }\n *\n *   private addGearOption() {\n *     this.core.getPlugin('bottom_gear')\n *       .addItem('custom', this.$el)\n *       .html($('<button class=\"custom-option\">Custom option</button>'))\n *   }\n *\n *   override bindEvents() {\n *     this.listenToOnce(this.core, ClapprEvents.CORE_READY, () => {\n *       const bottomGear = this.core.getPlugin('bottom_gear');\n *       assert(bottomGear, 'bottom_gear plugin is required');\n *       // simple case\n *       this.listenTo(bottomGear, GearEvents.RENDERED, this.render);\n *       // or with a submenu\n *       this.listenTo(bottomGear, GearEvents.RENDERED, this.addGearOption);\n *      });\n *   }\n * }\n * ```\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -261,21 +261,20 @@
           "members": [
             {
               "kind": "Method",
-              "canonicalReference": "@gcorevideo/player!BottomGear#getElement:member(1)",
-              "docComment": "/**\n * @param name - Name of a gear menu placeholder item to attach custom UI\n *\n * @returns Zepto result of the element\n */\n",
+              "canonicalReference": "@gcorevideo/player!BottomGear#addItem:member(1)",
+              "docComment": "/**\n * Adds a custom option to the gear menu\n *\n * @remarks\n *\n * When called with $submenu param, a click on the added item will toggle the submenu visibility.\n *\n * When added without submenu, it's responsibility of the caller to handle the click event however needed.\n *\n * @param name - A unique name of the option\n *\n * @param $subMenu - The submenu to attach to the option\n *\n * @returns The added item placeholder to attach custom markup\n *\n * @example\n * ```ts\n * class MyPlugin extends UICorePlugin {\n *   override render() {\n *     this.$el.html('<div class=\"my-awesome-settings\">...</div>')\n *     this.core.getPlugin('bottom_gear')\n *       ?.addItem('custom', this.$el)\n *       .html($('<button>Custom settings</button>'))\n *     return this\n *   }\n * }\n * ```\n *\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getElement(name: "
+                  "text": "addItem(name: "
                 },
                 {
-                  "kind": "Reference",
-                  "text": "GearOptionsItem",
-                  "canonicalReference": "@gcorevideo/player!GearOptionsItem:type"
+                  "kind": "Content",
+                  "text": "string"
                 },
                 {
                   "kind": "Content",
-                  "text": "): "
+                  "text": ", $subMenu?: "
                 },
                 {
                   "kind": "Reference",
@@ -284,7 +283,12 @@
                 },
                 {
                   "kind": "Content",
-                  "text": " | null"
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ZeptoResult",
+                  "canonicalReference": "@gcorevideo/player!ZeptoResult:type"
                 },
                 {
                   "kind": "Content",
@@ -293,8 +297,8 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 5
+                "startIndex": 5,
+                "endIndex": 6
               },
               "releaseTag": "Beta",
               "isProtected": false,
@@ -307,16 +311,24 @@
                     "endIndex": 2
                   },
                   "isOptional": false
+                },
+                {
+                  "parameterName": "$subMenu",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getElement"
+              "name": "addItem"
             },
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!BottomGear#refresh:member(1)",
-              "docComment": "/**\n * Re-renders the gear menu. It fires the {@link MediaControlEvents.MEDIACONTROL_GEAR_RENDERED | MEDIACONTROL_GEAR_RENDERED} event, which the plugins that attach to the gear menu can listen to to re-render themselves.\n */\n",
+              "docComment": "/**\n * Collapses any submenu open back to the gear menu.\n *\n * @remarks\n *\n * Should be called by the UI plugin that added a gear item with a submenu when the latter is closed (e.g., when a \"back\" button is clicked).\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -343,55 +355,6 @@
               "isOptional": false,
               "isAbstract": false,
               "name": "refresh"
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@gcorevideo/player!BottomGear#setContent:member(1)",
-              "docComment": "/**\n * Replaces the content of the gear menu\n *\n * @param content - Zepto result of the element\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "setContent(content: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "ZeptoResult",
-                  "canonicalReference": "@gcorevideo/player!ZeptoResult:type"
-                },
-                {
-                  "kind": "Content",
-                  "text": "): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "void"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 3,
-                "endIndex": 4
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [
-                {
-                  "parameterName": "content",
-                  "parameterTypeTokenRange": {
-                    "startIndex": 1,
-                    "endIndex": 2
-                  },
-                  "isOptional": false
-                }
-              ],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "setContent"
             }
           ],
           "extendsTokenRange": {
@@ -403,7 +366,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!ClapprNerdStats:class",
-          "docComment": "/**\n * `PLUGIN` that displays useful network-related statistics.\n *\n * @remarks\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * - {@link BottomGear}\n *\n * - {@link ClapprStats}\n *\n * The plugin is rendered as an item in the gear menu.\n *\n * When clicked, it shows an overlay window with the information about the network speed, latency, etc, and recommended quality level.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that displays useful network-related statistics.\n *\n * @remarks\n *\n * Depends on:\n *\n * - {@link BottomGear}\n *\n * - {@link ClapprStats}\n *\n * The plugin is rendered as an item in the gear menu.\n *\n * When clicked, it shows an overlay window with the information about the network speed, latency, etc, and recommended quality level.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -614,7 +577,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!ClickToPause:class",
-          "docComment": "/**\n * `PLUGIN` that adds a behavior of toggling the playback state on click over the container\n *\n * @beta\n */\n",
+          "docComment": "/**\n * A small `PLUGIN` that toggles the playback state on click over the video container\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -770,7 +733,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!ClosedCaptions:class",
-          "docComment": "/**\n * `PLUGIN` that provides a UI to select the subtitles when available.\n *\n * @remarks\n *\n * The plugin is activated when closed captions tracks are provided with the media source. It shows a familiar \"CC\" button with a dropdown menu to select the subtitles language.\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * Configuration options - {@link ClosedCaptionsPluginSettings}\n *\n * @example\n * ```ts\n * import { ClosedCaptions } from '@gcorevideo/player'\n *\n * Player.registerPlugin(ClosedCaptions)\n *\n * new Player({\n *   ...\n *   cc: {\n *     language: 'en',\n *   },\n * })\n * ```\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that provides a UI to select the subtitles when available.\n *\n * @remarks\n *\n * The plugin is activated when closed captions tracks are detected in the media source. It shows a familiar \"CC\" button with a dropdown menu to select the subtitles language.\n *\n * Depends on:\n *\n * - {@link MediaControl}\n *\n * Configuration options - {@link ClosedCaptionsPluginSettings}\n *\n * @example\n * ```ts\n * import { ClosedCaptions } from '@gcorevideo/player'\n *\n * Player.registerPlugin(ClosedCaptions)\n *\n * new Player({\n *   ...\n *   cc: {\n *     language: 'pt-BR',\n *   },\n * })\n * ```\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -864,7 +827,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!ClosedCaptionsPluginSettings:type",
-          "docComment": "",
+          "docComment": "/**\n * Configuration options for the {@link ClosedCaptions} plugin.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -880,7 +843,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/subtitles/ClosedCaptions.ts",
-          "releaseTag": "Public",
+          "releaseTag": "Beta",
           "name": "ClosedCaptionsPluginSettings",
           "typeTokenRange": {
             "startIndex": 1,
@@ -1256,7 +1219,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!ErrorScreen:class",
-          "docComment": "/**\n * `PLUGIN` that displays errors nicely in the overlay on top of the player.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that displays fatal errors nicely in the overlay on top of the player.\n *\n * @remarks\n *\n * A fatal error is an error that prevents the player from playing the content. It's usually a network error that persists after multiple retries.\n *\n * The error screen should not be confused with the content stub that is shown when no media sources are available. This can happen due to the lack of the support of the given sources type or because the sources are misconfigured (e.g., omitted).\n *\n * Configuration options - {@link ErrorScreenPluginSettings}\n *\n * @example\n * ```ts\n * import { ErrorScreen, Player } from '@gcorevideo/player'\n *\n * Player.registerPlugin(ErrorScreen)\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1273,7 +1236,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/error-screen/ErrorScreen.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "ErrorScreen",
           "preserveMemberOrder": false,
@@ -1287,7 +1250,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!ErrorScreenPluginSettings:type",
-          "docComment": "/**\n * Configuration options for the {@link ErrorScreen | error screen} plugin.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Configuration options for the {@link ErrorScreen} plugin.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1303,13 +1266,39 @@
             }
           ],
           "fileUrlPath": "src/plugins/error-screen/ErrorScreen.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "ErrorScreenPluginSettings",
           "typeTokenRange": {
             "startIndex": 1,
             "endIndex": 2
           }
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@gcorevideo/player!ErrorScreenSettings:type",
+          "docComment": "/**\n * Settings for the {@link ErrorScreen} plugin.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ErrorScreenSettings = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    noReload?: boolean;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/plugins/error-screen/ErrorScreen.ts",
+          "releaseTag": "Public",
+          "name": "ErrorScreenSettings",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!Favicon:class",
@@ -1387,57 +1376,42 @@
           "extendsTokenRanges": []
         },
         {
-          "kind": "TypeAlias",
-          "canonicalReference": "@gcorevideo/player!GearItemElement:type",
-          "docComment": "/**\n * @deprecated\n *\n * Use {@link GearOptionsItem} instead\n */\n",
+          "kind": "Enum",
+          "canonicalReference": "@gcorevideo/player!GearEvents:enum",
+          "docComment": "/**\n * Events triggered by the plugin\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export type GearItemElement = "
-            },
-            {
-              "kind": "Reference",
-              "text": "GearOptionsItem",
-              "canonicalReference": "@gcorevideo/player!GearOptionsItem:type"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
+              "text": "export declare enum GearEvents "
             }
           ],
           "fileUrlPath": "src/plugins/bottom-gear/BottomGear.ts",
-          "releaseTag": "Public",
-          "name": "GearItemElement",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          }
-        },
-        {
-          "kind": "TypeAlias",
-          "canonicalReference": "@gcorevideo/player!GearOptionsItem:type",
-          "docComment": "/**\n * An element inside the gear menu\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export type GearOptionsItem = "
-            },
-            {
-              "kind": "Content",
-              "text": "'quality' | 'rate' | 'nerd'"
-            },
+          "releaseTag": "Beta",
+          "name": "GearEvents",
+          "preserveMemberOrder": false,
+          "members": [
             {
-              "kind": "Content",
-              "text": ";"
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!GearEvents.RENDERED:member",
+              "docComment": "/**\n * Use this event to accurately attach an item to the gear menu\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "RENDERED = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"rendered\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "RENDERED"
             }
-          ],
-          "fileUrlPath": "src/plugins/bottom-gear/BottomGear.ts",
-          "releaseTag": "Beta",
-          "name": "GearOptionsItem",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          }
+          ]
         },
         {
           "kind": "Class",
@@ -2219,7 +2193,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "{\n        'click .gear-sub-menu_btn': string;\n        'click .gear-option': string;\n        'click .go-back': string;\n    }"
+                  "text": "{\n        'click .gear-sub-menu_btn': string;\n        'click .go-back': string;\n    }"
                 },
                 {
                   "kind": "Content",
@@ -2812,37 +2786,6 @@
               "isAbstract": false,
               "name": "enableControlButton"
             },
-            {
-              "kind": "Method",
-              "canonicalReference": "@gcorevideo/player!MediaControl#getCenterPanel:member(1)",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "getCenterPanel(): "
-                },
-                {
-                  "kind": "Content",
-                  "text": "any"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "getCenterPanel"
-            },
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!MediaControl#getElement:member(1)",
@@ -2899,47 +2842,33 @@
             },
             {
               "kind": "Method",
-              "canonicalReference": "@gcorevideo/player!MediaControl#getLeftPanel:member(1)",
-              "docComment": "/**\n * Get the left panel area to append custom elements to\n *\n * @returns ZeptoSelector of the left panel element\n */\n",
+              "canonicalReference": "@gcorevideo/player!MediaControl#handleCustomArea:member(1)",
+              "docComment": "",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "getLeftPanel(): "
+                  "text": "handleCustomArea(handler: "
                 },
                 {
                   "kind": "Content",
-                  "text": "any"
+                  "text": "(name: string, content: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "HTMLElement",
+                  "canonicalReference": "!HTMLElement:interface"
                 },
                 {
                   "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isStatic": false,
-              "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "isProtected": false,
-              "overloadIndex": 1,
-              "parameters": [],
-              "isOptional": false,
-              "isAbstract": false,
-              "name": "getLeftPanel"
-            },
-            {
-              "kind": "Method",
-              "canonicalReference": "@gcorevideo/player!MediaControl#getRightPanel:member(1)",
-              "docComment": "/**\n * Get the right panel area to append custom elements to\n *\n * @returns ZeptoSelector of the right panel element\n */\n",
-              "excerptTokens": [
+                  "text": ") => void"
+                },
                 {
                   "kind": "Content",
-                  "text": "getRightPanel(): "
+                  "text": "): "
                 },
                 {
                   "kind": "Content",
-                  "text": "any"
+                  "text": "void"
                 },
                 {
                   "kind": "Content",
@@ -2948,16 +2877,25 @@
               ],
               "isStatic": false,
               "returnTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
+                "startIndex": 5,
+                "endIndex": 6
               },
               "releaseTag": "Beta",
               "isProtected": false,
               "overloadIndex": 1,
-              "parameters": [],
+              "parameters": [
+                {
+                  "parameterName": "handler",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 4
+                  },
+                  "isOptional": false
+                }
+              ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "getRightPanel"
+              "name": "handleCustomArea"
             },
             {
               "kind": "Property",
@@ -3009,8 +2947,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "HTMLElement",
-                  "canonicalReference": "!HTMLElement:interface"
+                  "text": "ZeptoResult",
+                  "canonicalReference": "@gcorevideo/player!ZeptoResult:type"
                 },
                 {
                   "kind": "Content",
@@ -3084,24 +3022,89 @@
               "parameters": [],
               "isOptional": false,
               "isAbstract": false,
-              "name": "setInitialVolume"
+              "name": "setInitialVolume"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@gcorevideo/player!MediaControl#setVolume:member(1)",
+              "docComment": "/**\n * Set the volume\n *\n * @remarks\n *\n * Initial volume can be restored later\n *\n * @param value - The volume value\n *\n * @param isInitialVolume - save as the initial volume\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setVolume(value: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", isInitialVolume?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "value",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "isInitialVolume",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setVolume"
             },
             {
               "kind": "Method",
-              "canonicalReference": "@gcorevideo/player!MediaControl#setVolume:member(1)",
-              "docComment": "/**\n * Set the volume\n *\n * @remarks\n *\n * Initial volume can be restored later\n *\n * @param value - The volume value\n *\n * @param isInitialVolume - save as the initial volume\n */\n",
+              "canonicalReference": "@gcorevideo/player!MediaControl#toggleElement:member(1)",
+              "docComment": "/**\n * Toggle the visibility of a media control element\n *\n * @param name - The name of the media control element\n *\n * @param show - Whether to show or hide the element\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "setVolume(value: "
+                  "text": "toggleElement(area: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "number"
+                  "kind": "Reference",
+                  "text": "MediaControlElement",
+                  "canonicalReference": "@gcorevideo/player!MediaControlElement:type"
                 },
                 {
                   "kind": "Content",
-                  "text": ", isInitialVolume?: "
+                  "text": ", show: "
                 },
                 {
                   "kind": "Content",
@@ -3130,7 +3133,7 @@
               "overloadIndex": 1,
               "parameters": [
                 {
-                  "parameterName": "value",
+                  "parameterName": "area",
                   "parameterTypeTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -3138,17 +3141,17 @@
                   "isOptional": false
                 },
                 {
-                  "parameterName": "isInitialVolume",
+                  "parameterName": "show",
                   "parameterTypeTokenRange": {
                     "startIndex": 3,
                     "endIndex": 4
                   },
-                  "isOptional": true
+                  "isOptional": false
                 }
               ],
               "isOptional": false,
               "isAbstract": false,
-              "name": "setVolume"
+              "name": "toggleElement"
             },
             {
               "kind": "Property",
@@ -3198,7 +3201,7 @@
             },
             {
               "kind": "Content",
-              "text": "'audiotracks' | 'clipText' | 'gear' | 'pip' | 'playbackRate' | 'seekBarContainer' | 'cc'"
+              "text": "'audiotracks' | 'cc' | 'clipText' | 'dvr' | 'duration' | 'fullscreen' | 'gear' | 'multicamera' | 'pip' | 'playbackRate' | 'position' | 'seekBarContainer' | 'vr' | 'volume'"
             },
             {
               "kind": "Content",
@@ -3213,44 +3216,6 @@
             "endIndex": 2
           }
         },
-        {
-          "kind": "Enum",
-          "canonicalReference": "@gcorevideo/player!MediaControlEvents:enum",
-          "docComment": "/**\n * Custom events emitted by the plugins to communicate with one another\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export declare enum MediaControlEvents "
-            }
-          ],
-          "fileUrlPath": "src/plugins/media-control/MediaControl.ts",
-          "releaseTag": "Beta",
-          "name": "MediaControlEvents",
-          "preserveMemberOrder": false,
-          "members": [
-            {
-              "kind": "EnumMember",
-              "canonicalReference": "@gcorevideo/player!MediaControlEvents.MEDIACONTROL_GEAR_RENDERED:member",
-              "docComment": "/**\n * Emitted when the gear menu is rendered\n */\n",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "MEDIACONTROL_GEAR_RENDERED = "
-                },
-                {
-                  "kind": "Content",
-                  "text": "\"mediacontrol:gear:rendered\""
-                }
-              ],
-              "initializerTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              },
-              "releaseTag": "Beta",
-              "name": "MEDIACONTROL_GEAR_RENDERED"
-            }
-          ]
-        },
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!MultiCamera:class",
@@ -4034,7 +3999,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 | media_control}\n *\n * - {@link BottomGear | bottom_gear}\n *\n * It renders a button 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 * @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 *   } as PlaybackRateSettings,\n * })\n * ```\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -4096,6 +4061,67 @@
           },
           "implementsTokenRanges": []
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@gcorevideo/player!PlaybackRateOption:type",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type PlaybackRateOption = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    value: number;\n    label: string;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/plugins/playback-rate/PlaybackRate.ts",
+          "releaseTag": "Beta",
+          "name": "PlaybackRateOption",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@gcorevideo/player!PlaybackRateSettings:type",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type PlaybackRateSettings = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlaybackRateOption",
+              "canonicalReference": "@gcorevideo/player!PlaybackRateOption:type"
+            },
+            {
+              "kind": "Content",
+              "text": "[];\n    defaultValue?: number;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/plugins/playback-rate/PlaybackRate.ts",
+          "releaseTag": "Beta",
+          "name": "PlaybackRateSettings",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 4
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!PlaybackType:type",
@@ -7765,7 +7791,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!SourceController:class",
-          "docComment": "/**\n * `PLUGIN` that is responsible for managing the automatic failover between sources.\n *\n * @remarks\n *\n * Have a look at the {@link https://miro.com/app/board/uXjVLiN15tY=/?share_link_id=390327585787 | source failover diagram} for the details on how sources ordering and selection works.\n *\n * This plugin does not expose any public methods apart from required by the Clappr plugin interface. It is supposed to work autonomously.\n *\n * The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `SourceController` class.\n *\n * @example\n * ```ts\n * import { SourceController } from '@gcorevideo/player'\n *\n * Player.registerPlugin(SourceController)\n * ```\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that is responsible for managing the automatic failover between media sources.\n *\n * @remarks\n *\n * Have a look at the {@link https://miro.com/app/board/uXjVLiN15tY=/?share_link_id=390327585787 | source failover diagram} for the details on how sources ordering and selection works. Below is a simplified diagram:\n * ```markdown\n * sources_list:\n *       - a.mpd  |    +--------------------+\n *       - b.m3u8 |--->|         init       |\n *       - ...    |    |--------------------|\n *                     | current_source = 0 |\n *                     +--------------------+\n *                            |\n *                            |  source = a.mpd\n *                            |  playback = dash.js\n *                            v\n *                      +------------------+\n *                  +-->|   load source    |\n *                  |   +---------|--------+\n *                  |             v\n *                  |   +------------------+\n *                  |   |       play       |\n *                  |   +---------|--------+\n *                  |             |\n *                  |             v\n *                  |   +-----------------------+\n *                  |   |  on playback_error    |\n *                  |   |-----------------------|\n *                  |   | current_source =      |\n *                  |   |  (current_source + 1) |\n *                  |   |  % len sources_list   |\n *                  |   |                       |\n *                  |   | delay 1..3s           |\n *                  |   +---------------|-------+\n *                  |                   |\n *                  |   source=b.m3u8   |\n *                  |   playback=hls.js |\n *                  +-------------------+\n *\n * ```\n *\n * This plugin does not expose any public methods apart from required by the Clappr plugin interface. It is supposed to work autonomously.\n *\n * @example\n * ```ts\n * import { SourceController } from '@gcorevideo/player'\n *\n * Player.registerPlugin(SourceController)\n * ```\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7782,11 +7808,45 @@
             }
           ],
           "fileUrlPath": "src/plugins/source-controller/SourceController.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "SourceController",
           "preserveMemberOrder": false,
-          "members": [],
+          "members": [
+            {
+              "kind": "Constructor",
+              "canonicalReference": "@gcorevideo/player!SourceController:constructor(1)",
+              "docComment": "/**\n * Constructs a new instance of the `SourceController` class\n *\n * @param core - The Clappr core instance.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "constructor(core: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "ClapprCore",
+                  "canonicalReference": "@clappr/core!default:class"
+                },
+                {
+                  "kind": "Content",
+                  "text": ");"
+                }
+              ],
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "core",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ]
+            }
+          ],
           "extendsTokenRange": {
             "startIndex": 1,
             "endIndex": 2
@@ -7796,7 +7856,7 @@
         {
           "kind": "Enum",
           "canonicalReference": "@gcorevideo/player!SpinnerEvents:enum",
-          "docComment": "/**\n * Custom events emitted by the plugin\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Custom events emitted by the plugin\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7804,14 +7864,14 @@
             }
           ],
           "fileUrlPath": "src/plugins/spinner-three-bounce/SpinnerThreeBounce.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "name": "SpinnerEvents",
           "preserveMemberOrder": false,
           "members": [
             {
               "kind": "EnumMember",
               "canonicalReference": "@gcorevideo/player!SpinnerEvents.SYNC:member",
-              "docComment": "/**\n * Emitted at the end of the spinner animation cycle to facilitate smooth UI updates, e.g. {@link SourceController} listens to this event to reload the source when the spinner is hidden\n */\n",
+              "docComment": "/**\n * Emitted at the end of the spinner animation cycle to facilitate smooth UI updates, for instance, {@link SourceController} listens to this event to reload the source when the spinner is hidden\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7826,7 +7886,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "name": "SYNC"
             }
           ]
@@ -7834,7 +7894,7 @@
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!SpinnerThreeBounce:class",
-          "docComment": "/**\n * `PLUGIN` that shows a pending operation indicator when playback is buffering or in a similar state\n *\n * @remarks\n *\n * Events emitted- {@link SpinnerEvents} Other plugins can use {@link SpinnerThreeBounce.show | show} and {@link SpinnerThreeBounce.hide | hide} methods to implement custom pending/progress indication scenarios.\n *\n * @beta\n */\n",
+          "docComment": "/**\n * `PLUGIN` that shows a pending operation indicator when playback is buffering or in a similar state.\n *\n * @remarks\n *\n * Events emitted- {@link SpinnerEvents} Other plugins can use {@link SpinnerThreeBounce.show | show} and {@link SpinnerThreeBounce.hide | hide} methods to implement custom pending/progress indication scenarios.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -7851,7 +7911,7 @@
             }
           ],
           "fileUrlPath": "src/plugins/spinner-three-bounce/SpinnerThreeBounce.ts",
-          "releaseTag": "Beta",
+          "releaseTag": "Public",
           "isAbstract": false,
           "name": "SpinnerThreeBounce",
           "preserveMemberOrder": false,
@@ -7875,7 +7935,7 @@
                   "text": ");"
                 }
               ],
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -7912,7 +7972,7 @@
                 "startIndex": 1,
                 "endIndex": 2
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [],
@@ -7923,7 +7983,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!SpinnerThreeBounce#show:member(1)",
-              "docComment": "/**\n * Shows the spinner.\n *\n * When called, the spinner will not hide (due to its built-in logic) until {@link SpinnerThreeBounce.hide} is called\n */\n",
+              "docComment": "/**\n * Shows the spinner.\n *\n * The method call prevents spinner's built-in logic from automatically hiding it until {@link SpinnerThreeBounce.hide} is called\n *\n * @param delay - The delay in milliseconds before the spinner is shown.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -7951,7 +8011,7 @@
                 "startIndex": 3,
                 "endIndex": 4
               },
-              "releaseTag": "Beta",
+              "releaseTag": "Public",
               "isProtected": false,
               "overloadIndex": 1,
               "parameters": [
@@ -8148,33 +8208,6 @@
           ],
           "extendsTokenRanges": []
         },
-        {
-          "kind": "TypeAlias",
-          "canonicalReference": "@gcorevideo/player!SubtitlesPluginSettings:type",
-          "docComment": "/**\n * @deprecated\n *\n * Use {@link ClosedCaptionsPluginSettings} instead.\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export type SubtitlesPluginSettings = "
-            },
-            {
-              "kind": "Reference",
-              "text": "ClosedCaptionsPluginSettings",
-              "canonicalReference": "@gcorevideo/player!ClosedCaptionsPluginSettings:type"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
-            }
-          ],
-          "fileUrlPath": "src/plugins/subtitles/ClosedCaptions.ts",
-          "releaseTag": "Public",
-          "name": "SubtitlesPluginSettings",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          }
-        },
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!Telemetry:class",
@@ -8576,106 +8609,6 @@
             "endIndex": 4
           }
         },
-        {
-          "kind": "Interface",
-          "canonicalReference": "@gcorevideo/player!TextTrackItem:interface",
-          "docComment": "",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export interface TextTrackItem "
-            }
-          ],
-          "fileUrlPath": "src/playback.types.ts",
-          "releaseTag": "Public",
-          "name": "TextTrackItem",
-          "preserveMemberOrder": false,
-          "members": [
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@gcorevideo/player!TextTrackItem#id:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "id: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "number"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "id",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@gcorevideo/player!TextTrackItem#name:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "name: "
-                },
-                {
-                  "kind": "Content",
-                  "text": "string"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "name",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            },
-            {
-              "kind": "PropertySignature",
-              "canonicalReference": "@gcorevideo/player!TextTrackItem#track:member",
-              "docComment": "",
-              "excerptTokens": [
-                {
-                  "kind": "Content",
-                  "text": "track: "
-                },
-                {
-                  "kind": "Reference",
-                  "text": "TextTrack",
-                  "canonicalReference": "!TextTrack:interface"
-                },
-                {
-                  "kind": "Content",
-                  "text": ";"
-                }
-              ],
-              "isReadonly": false,
-              "isOptional": false,
-              "releaseTag": "Public",
-              "name": "track",
-              "propertyTypeTokenRange": {
-                "startIndex": 1,
-                "endIndex": 2
-              }
-            }
-          ],
-          "extendsTokenRanges": []
-        },
         {
           "kind": "Class",
           "canonicalReference": "@gcorevideo/player!Thumbnails:class",