@gcorevideo/player 2.16.17 → 2.18.0

package/temp/player.api.json

@@ -162,7 +162,7 @@
   },
   "kind": "Package",
   "canonicalReference": "@gcorevideo/player!",
-  "docComment": "/**\n * Video player for the GCore streaming platform\n *\n * @remarks\n *\n * This package provides a video player for the GCore streaming platform. It is built on top of the Clappr library and provides a framework for building custom integrations.\n *\n * @packageDocumentation\n */\n",
+  "docComment": "/**\n * Video player for the Gcore streaming platform\n *\n * @remarks\n *\n * This package provides a video player for the Gcore streaming platform. It is built on top of the Clappr library and provides a framework for building custom integrations.\n *\n * @packageDocumentation\n */\n",
   "name": "@gcorevideo/player",
   "preserveMemberOrder": false,
   "members": [
@@ -172,10 +172,36 @@
       "name": "",
       "preserveMemberOrder": false,
       "members": [
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@gcorevideo/player!ContainerSize:type",
+          "docComment": "/**\n * Dimensions of the player container DOM element.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type ContainerSize = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    width: number;\n    height: number;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/types.ts",
+          "releaseTag": "Beta",
+          "name": "ContainerSize",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!DashSettings:type",
-          "docComment": "/**\n * {@link https://cdn.dashjs.org/latest/jsdoc/module-Settings.html | DASH.js settings}\n *\n * @beta\n */\n",
+          "docComment": "/**\n * A plain JS object that must conform to the DASH.js settings schema.\n *\n * {@link https://cdn.dashjs.org/latest/jsdoc/module-Settings.html | DASH.js settings}\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -206,7 +232,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!ErrorLevel:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Levels of severity of errors. Non-fatal errors usually can be ignored.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -232,7 +258,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!LangTag:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * An ISO 639-1 language code.\n *\n * @example\n *\n * `pt`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -258,7 +284,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!MediaTransport:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Media delivery protocol\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -284,7 +310,7 @@
         {
           "kind": "Interface",
           "canonicalReference": "@gcorevideo/player!PlaybackError:interface",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * An error occurred during the playback.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -299,7 +325,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@gcorevideo/player!PlaybackError#code:member",
-              "docComment": "",
+              "docComment": "/**\n * Error code.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -327,7 +353,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@gcorevideo/player!PlaybackError#description:member",
-              "docComment": "",
+              "docComment": "/**\n * Detailed description of the error.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -354,7 +380,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@gcorevideo/player!PlaybackError#level:member",
-              "docComment": "",
+              "docComment": "/**\n * Level of severity of the error.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -382,7 +408,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@gcorevideo/player!PlaybackError#message:member",
-              "docComment": "",
+              "docComment": "/**\n * Error message. Non-fatal usually can be ignored.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -405,6 +431,61 @@
                 "startIndex": 1,
                 "endIndex": 2
               }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!PlaybackError#origin:member",
+              "docComment": "/**\n * Exact component that originated the error.\n *\n * @example\n *\n * - 'core' - 'dash' - 'media_control'\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "origin: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "origin",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!PlaybackError#scope:member",
+              "docComment": "/**\n * Component subsystem of the error origin\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "scope: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "PlayerComponentType",
+                  "canonicalReference": "@gcorevideo/player!PlayerComponentType:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "scope",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             }
           ],
           "extendsTokenRanges": []
@@ -412,7 +493,7 @@
         {
           "kind": "Enum",
           "canonicalReference": "@gcorevideo/player!PlaybackErrorCode:enum",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Codes of errors occurring within the playback component.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -427,7 +508,7 @@
             {
               "kind": "EnumMember",
               "canonicalReference": "@gcorevideo/player!PlaybackErrorCode.Generic:member",
-              "docComment": "",
+              "docComment": "/**\n * An unknown or uncategorised error.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -447,16 +528,16 @@
             },
             {
               "kind": "EnumMember",
-              "canonicalReference": "@gcorevideo/player!PlaybackErrorCode.MediaSourceUnavailable:member",
-              "docComment": "",
+              "canonicalReference": "@gcorevideo/player!PlaybackErrorCode.MediaSourceAccessDenied:member",
+              "docComment": "/**\n * The media source is not accessible due to some protection policy.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "MediaSourceUnavailable = "
+                  "text": "MediaSourceAccessDenied = "
                 },
                 {
                   "kind": "Content",
-                  "text": "1"
+                  "text": "3"
                 }
               ],
               "initializerTokenRange": {
@@ -464,20 +545,20 @@
                 "endIndex": 2
               },
               "releaseTag": "Beta",
-              "name": "MediaSourceUnavailable"
+              "name": "MediaSourceAccessDenied"
             },
             {
               "kind": "EnumMember",
-              "canonicalReference": "@gcorevideo/player!PlaybackErrorCode.QualityLevelUnavailable:member",
-              "docComment": "",
+              "canonicalReference": "@gcorevideo/player!PlaybackErrorCode.MediaSourceUnavailable:member",
+              "docComment": "/**\n * The media source is not available. Typically a network error.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "QualityLevelUnavailable = "
+                  "text": "MediaSourceUnavailable = "
                 },
                 {
                   "kind": "Content",
-                  "text": "2"
+                  "text": "1"
                 }
               ],
               "initializerTokenRange": {
@@ -485,14 +566,14 @@
                 "endIndex": 2
               },
               "releaseTag": "Beta",
-              "name": "QualityLevelUnavailable"
+              "name": "MediaSourceUnavailable"
             }
           ]
         },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!PlaybackModule:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Module to perform the playback.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -593,7 +674,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#attachTo:member(1)",
-              "docComment": "/**\n * Initializes the player at the given container element.\n *\n * @param playerElement - DOM element to host the player\n */\n",
+              "docComment": "/**\n * Initializes the player at the given container element.\n *\n * @remarks\n *\n * The player will be initialized and attached to the given element.\n *\n * All the core plugins will be initialized at this point.\n *\n * If no sources were configured, it will trigger an error.\n *\n * The player container will be initialized and then all the registered UI plugins.\n *\n * If the `autoPlay` option is set, then it will trigger playback immediately.\n *\n * It is an error to call this method twice. If you need to attache player to another DOM element, first call {@link Player.destroy} and then {@link Player.attachTo}.\n *\n * @param playerElement - DOM element to host the player\n *\n * @example\n * ```ts\n * const player = new Player({\n *   sources: [{ source: 'https://example.com/a.mpd', mimeType: 'application/dash+xml' }],\n * })\n * document.addEventListener('DOMContentLoaded', () => {\n *   player.attachTo(document.getElementById('video-container'))\n * })\n * ```\n *\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -642,7 +723,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#configure:member(1)",
-              "docComment": "/**\n * Configures the player.\n *\n * Can be called multiple times. Each consequent call extends the previous configuration. After a reconfiguration, if something significant has changed, the must be reinitialized (i.e, a `.destroy()` followed by an `.init()` call).\n *\n * @param config - complete or partial configuration\n */\n",
+              "docComment": "/**\n * Configures the player.\n *\n * @remarks\n *\n * Can be called multiple times. Each consequent call extends the previous configuration with only the new keys overridden.\n *\n * After a reconfiguration, if something significant has changed, it might make sense reinitialize the player (i.e, a `.destroy()` followed by an `.init()` call).\n *\n * @param config - complete or partial configuration\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -704,7 +785,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#destroy:member(1)",
-              "docComment": "/**\n * Destroys the player, releasing all resources and removing any DOM elements added.\n */\n",
+              "docComment": "/**\n * Destroys the player, releasing all resources and unmounting its UI from the DOM.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -735,7 +816,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#getCurrentTime:member(1)",
-              "docComment": "/**\n * Current playback time in seconds, if appropriate.\n *\n * @returns For live streams, it returns the current time of the current segment.\n */\n",
+              "docComment": "/**\n * Current playback (time since the beginning of the stream), if appropriate.\n *\n * @remarks\n *\n * For live streams, it returns the current time within the current segment.\n *\n * @returns Time in seconds\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -766,7 +847,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#getDuration:member(1)",
-              "docComment": "/**\n * Duration of the current media in seconds, if appropriate.\n *\n * @returns For live streams, it returns the duration of the current segment.\n */\n",
+              "docComment": "/**\n * Duration of the current media in seconds, if appropriate.\n *\n * @remarks\n *\n * For live streams, it returns the duration of the current segment.\n *\n * @returns Time in seconds\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -794,10 +875,134 @@
               "isAbstract": false,
               "name": "getDuration"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@gcorevideo/player!Player#getVolume:member(1)",
+              "docComment": "/**\n * Gets the current volume of the media content being played.\n *\n * @returns a number between 0 and 1\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getVolume(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getVolume"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@gcorevideo/player!Player#isDvrEnabled:member(1)",
+              "docComment": "/**\n * Indicates whether DVR is enabled.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isDvrEnabled(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isDvrEnabled"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@gcorevideo/player!Player#isDvrInUse:member(1)",
+              "docComment": "/**\n * Indicates whether DVR is in use.\n *\n * @remarks\n *\n * DVR mode, if it is enabled, is triggered we a user seeks behind the live edge.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isDvrInUse(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isDvrInUse"
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@gcorevideo/player!Player#isPlaying:member(1)",
+              "docComment": "/**\n * Indicates the playing state.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "isPlaying(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "isPlaying"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#mute:member(1)",
-              "docComment": "/**\n * Mutes the player.\n */\n",
+              "docComment": "/**\n * Mutes the sound of the video.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -828,11 +1033,11 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#off:member(1)",
-              "docComment": "/**\n * Removes a listener from a player event\n *\n * @param event - See {@link PlayerEvent}\n *\n * @param handler - See {@link PlayerEventHandler}\n */\n",
+              "docComment": "/**\n * Removes a previously added event listener\n *\n * @param event - See {@link PlayerEvent}\n *\n * @param handler - a callback attached earlier to that event type\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "off<T extends "
+                  "text": "off<E extends "
                 },
                 {
                   "kind": "Reference",
@@ -845,7 +1050,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "T"
+                  "text": "E"
                 },
                 {
                   "kind": "Content",
@@ -858,7 +1063,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "<T>"
+                  "text": "<E>"
                 },
                 {
                   "kind": "Content",
@@ -875,7 +1080,7 @@
               ],
               "typeParameters": [
                 {
-                  "typeParameterName": "T",
+                  "typeParameterName": "E",
                   "constraintTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -919,11 +1124,11 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#on:member(1)",
-              "docComment": "/**\n * Adds a listener to a player event\n *\n * @param event - See {@link PlayerEvent}\n *\n * @param handler - See {@link PlayerEventHandler}\n */\n",
+              "docComment": "/**\n * Adds a listener to a player event\n *\n * @param event - event type, see {@link PlayerEvent}\n *\n * @param handler - a callback function to handle the event\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
-                  "text": "on<T extends "
+                  "text": "on<E extends "
                 },
                 {
                   "kind": "Reference",
@@ -936,7 +1141,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "T"
+                  "text": "E"
                 },
                 {
                   "kind": "Content",
@@ -949,7 +1154,7 @@
                 },
                 {
                   "kind": "Content",
-                  "text": "<T>"
+                  "text": "<E>"
                 },
                 {
                   "kind": "Content",
@@ -966,7 +1171,7 @@
               ],
               "typeParameters": [
                 {
-                  "typeParameterName": "T",
+                  "typeParameterName": "E",
                   "constraintTokenRange": {
                     "startIndex": 1,
                     "endIndex": 2
@@ -1072,7 +1277,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player.registerPlugin:member(1)",
-              "docComment": "/**\n * Registers a plugin.\n *\n * @param plugin - plugin to register\n */\n",
+              "docComment": "/**\n * Registers a plugin.\n *\n * @remarks\n *\n * Use this method to extend the player with custom behavior. The plugin class must inherit from one of the Clappr UIPlugin, UIContainerPlugin or CorePlugin classes. A core plugin will be initialized and attached to the player when the player is initialized. A UI plugin will be initialized and attached to the player container is initialized.\n *\n * @param plugin - a plugin class\n *\n * @example\n * ```ts\n * import MyPlugin from './MyPlugin.js'\n *\n * Player.registerPlugin(MyPlugin)\n * ```\n *\n * @see\n *\n * {@link https://github.com/clappr/clappr/wiki/Architecture}\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1121,15 +1326,16 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#resize:member(1)",
-              "docComment": "/**\n * Resizes the player container element and everything within it.\n *\n * @param newSize - new size of the player\n */\n",
+              "docComment": "/**\n * Resizes the player container element and everything within it.\n *\n * @remarks\n *\n * Use this method when the player itself does not detect properly the change in size of its container element. It can be a case for orientation change on some mobile devices.\n *\n * @param newSize - new size of the player\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
                   "text": "resize(newSize: "
                 },
                 {
-                  "kind": "Content",
-                  "text": "{\n        width: number;\n        height: number;\n    }"
+                  "kind": "Reference",
+                  "text": "ContainerSize",
+                  "canonicalReference": "@gcorevideo/player!ContainerSize:type"
                 },
                 {
                   "kind": "Content",
@@ -1169,7 +1375,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#seek:member(1)",
-              "docComment": "/**\n * Seeks to the given time.\n *\n * @param time - time to seek to in seconds\n */\n",
+              "docComment": "/**\n * Seeks to the given time.\n *\n * @param time - time to seek to in seconds (since the beginning of the stream)\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1214,6 +1420,54 @@
               "isAbstract": false,
               "name": "seek"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@gcorevideo/player!Player#setVolume:member(1)",
+              "docComment": "/**\n * Sets the current volume of the media content being played.\n *\n * @param volume - a number between 0 and 1\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "setVolume(volume: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "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": "volume",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "setVolume"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#stop:member(1)",
@@ -1248,7 +1502,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player#unmute:member(1)",
-              "docComment": "/**\n * Unmutes the player.\n */\n",
+              "docComment": "/**\n * Unmutes the video sound.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1279,7 +1533,7 @@
             {
               "kind": "Method",
               "canonicalReference": "@gcorevideo/player!Player.unregisterPlugin:member(1)",
-              "docComment": "/**\n * Unregisters a plugin.\n *\n * @param plugin - plugin to unregister\n */\n",
+              "docComment": "/**\n * Unregisters a plugin registered earlier with {@link Player.registerPlugin}.\n *\n * @param plugin - a plugin class\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -1328,6 +1582,32 @@
           ],
           "implementsTokenRanges": []
         },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@gcorevideo/player!PlayerComponentType:type",
+          "docComment": "/**\n * Subsystems of a player component.\n *\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type PlayerComponentType = "
+            },
+            {
+              "kind": "Content",
+              "text": "'container' | 'core' | 'playback'"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/playback.types.ts",
+          "releaseTag": "Beta",
+          "name": "PlayerComponentType",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@gcorevideo/player!PlayerConfig:interface",
@@ -1647,7 +1927,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!PlayerDebugSettings:type",
-          "docComment": "/**\n * @remarks\n *\n * true is equivalent to 'all', false is equivalent to 'none'\n *\n * @beta\n */\n",
+          "docComment": "/**\n * @remarks\n *\n * `true` is equivalent to `'all'`, `false` is equivalent to `'none'`\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1678,7 +1958,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!PlayerDebugTag:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Debug output category selector\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -1739,7 +2019,49 @@
             },
             {
               "kind": "EnumMember",
-              "canonicalReference": "@gcorevideo/player!PlayerEvent.Pause:member",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Error:member",
+              "docComment": "/**\n * An error occurred. Parameters: {@link PlaybackError}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "Error = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"error\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "Error"
+            },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Fullscreen:member",
+              "docComment": "/**\n * The player has switched to or from the fullscreen mode. Parameters:`boolean` isFullscreen\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "Fullscreen = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"fullscreen\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "Fullscreen"
+            },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Pause:member",
               "docComment": "/**\n * Playback has been paused.\n */\n",
               "excerptTokens": [
                 {
@@ -1800,6 +2122,48 @@
               "releaseTag": "Beta",
               "name": "Ready"
             },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Resize:member",
+              "docComment": "/**\n * The player's container has been resized. Parameters: {@link ContainerSize}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "Resize = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"resize\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "Resize"
+            },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Seek:member",
+              "docComment": "/**\n * The player is seeking to a new position.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "Seek = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"seek\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "Seek"
+            },
             {
               "kind": "EnumMember",
               "canonicalReference": "@gcorevideo/player!PlayerEvent.Stop:member",
@@ -1820,17 +2184,59 @@
               },
               "releaseTag": "Beta",
               "name": "Stop"
+            },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.TimeUpdate:member",
+              "docComment": "/**\n * The current playback time has changed. Parameters: {@link TimePosition}\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "TimeUpdate = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"timeupdate\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "TimeUpdate"
+            },
+            {
+              "kind": "EnumMember",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.VolumeUpdate:member",
+              "docComment": "/**\n * The volume has changed. Parameters: `number` volume in the range 0..1\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "VolumeUpdate = "
+                },
+                {
+                  "kind": "Content",
+                  "text": "\"volumeupdate\""
+                }
+              ],
+              "initializerTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "name": "VolumeUpdate"
             }
           ]
         },
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!PlayerEventHandler:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Type of a listener callback function for a player event. See the description of the event parameters in {@link PlayerEvent}.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export type PlayerEventHandler<T extends "
+              "text": "export type PlayerEventHandler<E extends "
             },
             {
               "kind": "Reference",
@@ -1843,7 +2249,16 @@
             },
             {
               "kind": "Content",
-              "text": "() => void"
+              "text": "(...args: "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEventParams",
+              "canonicalReference": "@gcorevideo/player!PlayerEventParams:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<E>) => void"
             },
             {
               "kind": "Content",
@@ -1855,7 +2270,7 @@
           "name": "PlayerEventHandler",
           "typeParameters": [
             {
-              "typeParameterName": "T",
+              "typeParameterName": "E",
               "constraintTokenRange": {
                 "startIndex": 1,
                 "endIndex": 2
@@ -1868,7 +2283,127 @@
           ],
           "typeTokenRange": {
             "startIndex": 3,
-            "endIndex": 4
+            "endIndex": 6
+          }
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@gcorevideo/player!PlayerEventParams:type",
+          "docComment": "/**\n * @beta\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type PlayerEventParams<E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent:enum"
+            },
+            {
+              "kind": "Content",
+              "text": "> = "
+            },
+            {
+              "kind": "Content",
+              "text": "E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent.Seek",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Seek:member"
+            },
+            {
+              "kind": "Content",
+              "text": " ? [number] : E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent.VolumeUpdate",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.VolumeUpdate:member"
+            },
+            {
+              "kind": "Content",
+              "text": " ? [number] : E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent.TimeUpdate",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.TimeUpdate:member"
+            },
+            {
+              "kind": "Content",
+              "text": " ? ["
+            },
+            {
+              "kind": "Reference",
+              "text": "TimePosition",
+              "canonicalReference": "@gcorevideo/player!TimePosition:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "] : E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent.Resize",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Resize:member"
+            },
+            {
+              "kind": "Content",
+              "text": " ? [{\n    width: number;\n    height: number;\n}] : E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent.Fullscreen",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Fullscreen:member"
+            },
+            {
+              "kind": "Content",
+              "text": " ? [boolean] : E extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "PlayerEvent.Error",
+              "canonicalReference": "@gcorevideo/player!PlayerEvent.Error:member"
+            },
+            {
+              "kind": "Content",
+              "text": " ? ["
+            },
+            {
+              "kind": "Reference",
+              "text": "PlaybackError",
+              "canonicalReference": "@gcorevideo/player!PlaybackError:interface"
+            },
+            {
+              "kind": "Content",
+              "text": "] : []"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/Player.ts",
+          "releaseTag": "Beta",
+          "name": "PlayerEventParams",
+          "typeParameters": [
+            {
+              "typeParameterName": "E",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "typeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 20
           }
         },
         {
@@ -1920,7 +2455,7 @@
             {
               "kind": "PropertySignature",
               "canonicalReference": "@gcorevideo/player!PlayerMediaSourceDesc#mimeType:member",
-              "docComment": "/**\n * The MIME type of the media source (e.g. \"video/mp4\", \"application/x-mpegURL\")\n */\n",
+              "docComment": "/**\n * The MIME type of the media source (e.g. `\"video/mp4\"`, `\"application/x-mpegURL\"`). Necessary if the type cannot be detected from file extension of the source URL.\n */\n",
               "excerptTokens": [
                 {
                   "kind": "Content",
@@ -2001,74 +2536,204 @@
           }
         },
         {
-          "kind": "TypeAlias",
-          "canonicalReference": "@gcorevideo/player!QualityLevel:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "kind": "Interface",
+          "canonicalReference": "@gcorevideo/player!QualityLevel:interface",
+          "docComment": "/**\n * A level of quality within a media source.\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
-              "text": "export type QualityLevel = "
-            },
-            {
-              "kind": "Content",
-              "text": "{\n    level: number;\n    width: number;\n    height: number;\n    bitrate: number;\n}"
-            },
-            {
-              "kind": "Content",
-              "text": ";"
+              "text": "export interface QualityLevel "
             }
           ],
           "fileUrlPath": "src/playback.types.ts",
           "releaseTag": "Beta",
           "name": "QualityLevel",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 2
-          }
-        },
-        {
-          "kind": "TypeAlias",
-          "canonicalReference": "@gcorevideo/player!TimePosition:type",
-          "docComment": "/**\n * For the plugin development\n *\n * @beta\n */\n",
-          "excerptTokens": [
-            {
-              "kind": "Content",
-              "text": "export type TimePosition = "
-            },
-            {
-              "kind": "Content",
-              "text": "{\n    current: "
-            },
+          "preserveMemberOrder": false,
+          "members": [
             {
-              "kind": "Reference",
-              "text": "TimeValue",
-              "canonicalReference": "@gcorevideo/player!TimeValue:type"
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!QualityLevel#bitrate:member",
+              "docComment": "/**\n * Bitrate of the video, bps.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "bitrate: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "bitrate",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             },
             {
-              "kind": "Content",
-              "text": ";\n    total: "
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!QualityLevel#height:member",
+              "docComment": "/**\n * Height of the video, pixels.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "height: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "height",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             },
             {
-              "kind": "Reference",
-              "text": "TimeValue",
-              "canonicalReference": "@gcorevideo/player!TimeValue:type"
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!QualityLevel#level:member",
+              "docComment": "/**\n * Zero-based index of the quality level.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "level: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "level",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
             },
             {
-              "kind": "Content",
-              "text": ";\n}"
-            },
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!QualityLevel#width:member",
+              "docComment": "/**\n * Width of the video, pixels.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "width: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "number"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "width",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
+        },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@gcorevideo/player!TimePosition:interface",
+          "docComment": "/**\n * Current playback time and total duration of the media.\n *\n * @beta\n */\n",
+          "excerptTokens": [
             {
               "kind": "Content",
-              "text": ";"
+              "text": "export interface TimePosition "
             }
           ],
           "fileUrlPath": "src/playback.types.ts",
           "releaseTag": "Beta",
           "name": "TimePosition",
-          "typeTokenRange": {
-            "startIndex": 1,
-            "endIndex": 6
-          }
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!TimePosition#current:member",
+              "docComment": "/**\n * Current playback time, 0..duration, seconds.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "current: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TimeValue",
+                  "canonicalReference": "@gcorevideo/player!TimeValue:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "current",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            },
+            {
+              "kind": "PropertySignature",
+              "canonicalReference": "@gcorevideo/player!TimePosition#total:member",
+              "docComment": "/**\n * Total duration of the media, seconds.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "total: "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "TimeValue",
+                  "canonicalReference": "@gcorevideo/player!TimeValue:type"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "total",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              }
+            }
+          ],
+          "extendsTokenRanges": []
         },
         {
           "kind": "TypeAlias",
@@ -2082,7 +2747,7 @@
             {
               "kind": "Reference",
               "text": "TimePosition",
-              "canonicalReference": "@gcorevideo/player!TimePosition:type"
+              "canonicalReference": "@gcorevideo/player!TimePosition:interface"
             },
             {
               "kind": "Content",
@@ -2113,7 +2778,7 @@
             {
               "kind": "Reference",
               "text": "TimePosition",
-              "canonicalReference": "@gcorevideo/player!TimePosition:type"
+              "canonicalReference": "@gcorevideo/player!TimePosition:interface"
             },
             {
               "kind": "Content",
@@ -2135,7 +2800,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!TimeValue:type",
-          "docComment": "/**\n * Playback time in seconds since the beginning of the stream (or a segment for the live streams) For the plugin development\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Playback time in seconds since the beginning of the stream (or a segment for the live streams)\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2187,7 +2852,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!TranslationSettings:type",
-          "docComment": "/**\n * [language][key] =\\> string\n *\n * @example\n * ```\n * {\n *   en: {\n *     play: 'Play',\n *     ...\n *   },\n *   es: {\n *     play: 'Reproducir',\n *     ...\n *   },\n *   ...\n * }\n * ```\n *\n * @beta\n */\n",
+          "docComment": "/**\n * Localization strings for the player UI.\n *\n * @remarks\n *\n * The keys are language codes, and the values are objects with keys being the translation keys and values being the translations.\n *\n * This dictionary is used to localize the player UI, including the error messages and is shared across all the player components (including the plugins).\n *\n * @example\n * ```\n * {\n *   en: {\n *     play: 'Play',\n *     ...\n *   },\n *   es: {\n *     play: 'Reproducir',\n *     ...\n *   },\n *   ...\n * }\n * ```\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -2254,7 +2919,7 @@
         {
           "kind": "TypeAlias",
           "canonicalReference": "@gcorevideo/player!TransportPreference:type",
-          "docComment": "/**\n * @beta\n */\n",
+          "docComment": "/**\n * Preferred media delivery protocol\n *\n * @beta\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",