@gcorevideo/player 2.20.8 → 2.20.11

package/dist/player.d.ts

@@ -6,6 +6,23 @@
  * It is built on top of the Clappr library and provides a framework for building custom integrations.
  * Start with {@link Player} for more information.
  *
+ * Various plugins (marked with `PLUGIN` keyword) are available to extend the player with additional features.
+ * @example
+ * ```ts
+ * import { Player, MediaControl, ErrorScreen } from '@gcorevideo/player'
+ *
+ * Player.registerPlugin(MediaControl)
+ * Player.registerPlugin(ErrorScreen)
+ *
+ * const player = new Player({
+ *   autoPlay: true,
+ *   mute: true,
+ *   sources: [{ source: 'https://example.com/a.mpd', mimeType: 'application/dash+xml' }],
+ * })
+ *
+ * player.attachTo(document.getElementById('container'))
+ * ```
+ *
  * @packageDocumentation
  */
 
@@ -28,7 +45,7 @@ import { UICorePlugin } from '@clappr/core';
 import { UIObject } from '@clappr/core';
 
 /**
- * Adds an audio track selector to the media control UI.
+ * `PLUGIN` that adds an audio track selector to the media control UI.
  * @beta
  */
 export declare class AudioSelector extends UICorePlugin {
@@ -98,7 +115,7 @@ export declare class AudioSelector extends UICorePlugin {
 }
 
 /**
- * Displays a big mute button over the video when it's muted.
+ * `PLUGIN` that displays a big mute button over the video when it's muted.
  * Once pressed, it unmutes the video.
  * @beta
  */
@@ -158,7 +175,7 @@ declare type BitrateTrackRecord = {
 };
 
 /**
- * Adds the gear button that triggers extra options menu on the right side of the {@link MediaControl | media control} UI
+ * `PLUGIN` that adds the gear button with an extra options menu on the right side of the {@link MediaControl | media control} UI
  * @beta
  * @remarks
  * The plugins provides a base for attaching custom settings UI in the gear menu
@@ -218,13 +235,18 @@ export declare class BottomGear extends UICorePlugin {
      * @internal
      */
     render(): this;
-    private refresh;
+    /**
+     * 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.
+     */
+    refresh(): void;
     private toggleGearMenu;
     private hide;
 }
 
 /**
- * Displays useful network-related statistics.
+ * `PLUGIN` that displays useful network-related statistics.
  * @beta
  *
  * @remarks
@@ -302,7 +324,7 @@ export declare class ClapprNerdStats extends UICorePlugin {
 }
 
 /**
- * Collects useful statistics about playback performance.
+ * `PLUGIN` that collects useful statistics about playback performance.
  * @beta
  * @remarks
  * This plugin does not render anything and is supposed to be extended or used together with other plugins that actually render something.
@@ -338,7 +360,7 @@ export declare class ClapprStats extends ContainerPlugin {
     private _stop;
     /**
      * Registers a callback to receive the metrics.
-     * @param updateMetricsFn
+     * @param updateMetricsFn - The callback to receive the metrics
      */
     setUpdateMetrics(updateMetricsFn: MetricsUpdateFn): void;
     private _defaultReport;
@@ -353,10 +375,10 @@ export declare class ClapprStats extends ContainerPlugin {
     destroy(): void;
     /**
      * Returns the collected metrics.
-     * @returns The collected metrics
+     * @returns Currently collected metrics
      */
     exportMetrics(): Metrics;
-    onBitrate(newBitrate: QualityLevel): void;
+    private onBitrate;
     private stopReporting;
     private startTimers;
     private onFirstPlaying;
@@ -381,7 +403,7 @@ export declare class ClapprStats extends ContainerPlugin {
 }
 
 /**
- * Adds a behavior of toggling the playback state on click over the container
+ * `PLUGIN` that adds a behavior of toggling the playback state on click over the container
  * @beta
  */
 export declare class ClickToPause extends ContainerPlugin {
@@ -408,7 +430,7 @@ export declare class ClickToPause extends ContainerPlugin {
 }
 
 /**
- * Adds a behavior of showing a text over the seekbar to indicate the current clip.
+ * `PLUGIN` that shows text over the seekbar to indicate the current clip.
  * @beta
  * @remarks
  * Depends on:
@@ -455,7 +477,8 @@ export declare class ClipsPlugin extends UICorePlugin {
 }
 
 /**
- * Configuration options
+ * Configuration options for the {@link ClipsPlugin | clips} plugin.
+ * @beta
  */
 export declare interface ClipsPluginSettings {
     /**
@@ -464,9 +487,17 @@ export declare interface ClipsPluginSettings {
     text: string;
 }
 
+/**
+ * @public
+ */
+export declare type ContainerPluginConstructor = {
+    new (container: Container): PlayerPlugin;
+    type: string;
+};
+
 /**
  * Dimensions of the player container DOM element.
- * @beta
+ * @public
  */
 export declare type ContainerSize = {
     width: number;
@@ -474,7 +505,7 @@ export declare type ContainerSize = {
 };
 
 /**
- * Displays a small context menu when clicked on the player container.
+ * `PLUGIN` that displays a small context menu when clicked on the player container.
  * @beta
  * @remarks
  * Configuration options - {@link ContextMenuPluginSettings}
@@ -539,15 +570,24 @@ export declare interface ContextMenuPluginSettings {
     preventShowContextMenu?: boolean;
 }
 
+/**
+ * @public
+ */
+export declare type CorePluginConstructor = {
+    new (core: Core): PlayerPlugin;
+    type: string;
+};
+
 /**
  * A plain JS object that must conform to the DASH.js settings schema.
- * @beta
+ * @public
  * {@link https://cdn.dashjs.org/latest/jsdoc/module-Settings.html | DASH.js settings}
  */
 export declare type DashSettings = Record<string, unknown>;
 
 /**
- * Adds the DVR controls to the media control UI
+ * `PLUGIN` that adds the DVR controls to the media control UI
+ *
  * @beta
  *
  * @remarks
@@ -555,7 +595,9 @@ export declare type DashSettings = Record<string, unknown>;
  *
  * - {@link MediaControl}
  *
- * The plugin renders the live stream indicator and the DVR seek bar, if DVR is enabled, in the media control UI.
+ * The plugin renders live stream indicator.
+ * If DVR is enabled, the indicator shows whether the current position is at the live edge of the stream or not.
+ * In the latter case, the indicator can be clicked to seek to the live edge.
  */
 export declare class DvrControls extends UICorePlugin {
     private static readonly template;
@@ -582,13 +624,13 @@ export declare class DvrControls extends UICorePlugin {
         class: string;
         'data-dvr-controls': string;
     };
-    constructor(core: Core);
     /**
      * @internal
      */
     bindEvents(): void;
+    private onCoreReady;
     private bindContainerEvents;
-    private dvrChanged;
+    private onDvrChanged;
     private click;
     private settingsUpdate;
     private shouldRender;
@@ -600,50 +642,68 @@ export declare class DvrControls extends UICorePlugin {
 
 /**
  * Levels of severity of errors. Non-fatal errors usually can be ignored.
- * @beta
+ * @public
  */
 export declare type ErrorLevel = 'FATAL' | 'WARN' | 'INFO';
 
 /**
- * Displays a descriptive error in the overlay on top of the player.
+ * `PLUGIN` that displays errors nicely in the overlay on top of the player.
  * @beta
  */
 export declare class ErrorScreen extends UICorePlugin {
-    private _retry;
     private err;
-    private hideValue;
-    private timeout;
-    private reloadButton;
+    /**
+     * @internal
+     */
     get name(): string;
+    /**
+     * @internal
+     */
     get supportedVersion(): {
         min: string;
     };
-    get template(): any;
-    get container(): any;
+    private static readonly template;
+    /**
+     * @internal
+     */
     get attributes(): {
         class: string;
         'data-error-screen': string;
     };
+    /**
+     * @internal
+     */
     bindEvents(): void;
-    private onCoreReady;
     private onPlay;
-    private destroyError;
-    unBindEvents(): void;
-    private bindReload;
+    private unmount;
+    /**
+     * @internal
+     */
+    get events(): {
+        'click .player-error-screen__reload': string;
+    };
     private reload;
-    private unbindReload;
-    private onContainerChanged;
-    private onStartAd;
-    private onFinishAd;
+    private onActiveContainerChanged;
     private onError;
-    private drying;
-    show(err?: PresentationalError): void;
-    hide(): void;
+    /**
+     * @internal
+     */
     render(): this;
 }
 
 /**
- * The plugin adds custom favicon to the player's tab.
+ * Configuration options for the {@link ErrorScreen | error screen} plugin.
+ * @beta
+ */
+export declare type ErrorScreenPluginSettings = {
+    /**
+     * Whether to hide the reload button.
+     */
+    noReload?: boolean;
+};
+
+/**
+ * `PLUGIN` that adds custom favicon to the player's tab.
  * @beta
  */
 export declare class Favicon extends CorePlugin {
@@ -669,17 +729,6 @@ export declare class Favicon extends CorePlugin {
     private changeIcon;
 }
 
-/**
- * Custom events emitted by the plugin
- * @beta
- */
-export declare enum GearEvents {
-    /**
-     * Emitted when the gear menu is rendered
-     */
-    MEDIACONTROL_GEAR_RENDERED = "mediacontrol:gear:rendered"
-}
-
 /**
  * An element inside the gear menu
  * @beta
@@ -687,7 +736,7 @@ export declare enum GearEvents {
 export declare type GearItemElement = 'quality' | 'rate' | 'nerd';
 
 /**
- * An example Google Analytics integration plugin
+ * `PLUGIN` that integrates with Google Analytics
  * @beta
  */
 export declare class GoogleAnalytics extends ContainerPlugin {
@@ -727,40 +776,15 @@ export declare interface InitEventData {
     event: TelemetryEvent.Init;
 }
 
-declare type KeyboardEventHandler = (e: KeyboardEvent) => boolean | undefined;
-
-/**
- * @internal
- */
-export declare class Kibo {
-    private element;
-    private lastKeyCode;
-    private lastModifiers;
-    private keysDown;
-    private keysUp;
-    private downHandler;
-    private upHandler;
-    constructor(element?: Document | Element);
-    private handler;
-    private registerKeys;
-    private unregisterKeys;
-    off(keys: string | string[]): Kibo;
-    delegate(upOrDown: UpDown, keys: string | string[], func?: KeyboardEventHandler | null): Kibo;
-    down(keys: string | string[], func?: KeyboardEventHandler | null): Kibo;
-    up(keys: string | string[], func?: KeyboardEventHandler | null): Kibo;
-    lastKey(modifier?: string): string | boolean;
-    lastModifiersAndKey(): string;
-}
-
 /**
  * An ISO 639-1 language code.
  * @example `pt`
- * @beta
+ * @public
  */
 export declare type LangTag = string;
 
 /**
- * A {@link MediaControl | media control} plugin that provides a UI to control the quality level of the playback.
+ * `PLUGIN` that provides a UI to select the desired quality level of the playback.
  * @beta
  *
  * @remarks
@@ -770,15 +794,9 @@ export declare type LangTag = string;
  *
  * - {@link BottomGear}
  *
- * The plugin is rendered as an item in the gear menu.
+ * The plugin is rendered as an item in the gear menu, which, when clicked, shows a list of quality levels to choose from.
  *
- * When clicked, it shows a list of quality levels to choose from.
- *
- * Configuration options:
- *
- * - `labels`: The labels to show in the level selector. [video resolution]: string
- *
- * - `restrictResolution`: The maximum resolution to allow in the level selector.
+ * Configuration options - {@link LevelSelectorPluginSettings}
  *
  * @example
  * ```ts
@@ -830,6 +848,8 @@ export declare class LevelSelector extends UICorePlugin {
      * @internal
      */
     bindEvents(): void;
+    private onCoreReady;
+    private onGearRendered;
     private bindPlaybackEvents;
     private onStop;
     private shouldRender;
@@ -857,10 +877,29 @@ export declare class LevelSelector extends UICorePlugin {
     private deferRender;
 }
 
+/**
+ * Configuration options for the {@link LevelSelector | level selector} plugin.
+ * @beta
+ */
+export declare interface LevelSelectorPluginSettings {
+    /**
+     * The maximum resolution to allow in the level selector.
+     */
+    restrictResolution?: number;
+    /**
+     * The labels to show in the level selector.
+     * @example
+     * ```ts
+     * { 360: 'SD', 720: 'HD' }
+     * ```
+     */
+    labels?: Record<number, string>;
+}
+
 export { Logger }
 
 /**
- * The plugin adds custom logo to the player.
+ * `PLUGIN` that adds custom logo to the player.
  * @beta
  */
 export declare class Logo extends UIContainerPlugin {
@@ -893,11 +932,11 @@ export declare class Logo extends UIContainerPlugin {
 export { LogTracer }
 
 /**
- * The MediaControl provides a foundation for developing custom media controls UI.
+ * `PLUGIN` that provides a foundation for developing custom media controls UI.
  * @beta
  * @remarks
  * The methods exposed are to be used by the other plugins that extend the media control UI.
- * The plugin registration should be arranged so that MediaControl is initialized before every other plugin that depends on it.
+ * The plugin registration should be arranged so that MediaControl is initialized before every other `PLUGIN` that depends on it.
  * @example
  * ```ts
  * Player.registerPlugin(MediaControl) // <--- This must go first
@@ -970,12 +1009,12 @@ export declare class MediaControl extends UICorePlugin {
     private get disabled();
     /**
      * @internal
-     * @deprecated
+     * @deprecated Use core.activeContainer directly
      */
     get container(): any;
     /**
      * @internal
-     * @deprecated
+     * @deprecated Use core.activePlayback directly
      */
     get playback(): any;
     /**
@@ -1015,6 +1054,7 @@ export declare class MediaControl extends UICorePlugin {
         'mouseenter .media-control-layer[data-controls]': string;
         'mouseleave .media-control-layer[data-controls]': string;
     };
+    get currentSeekPos(): number;
     /**
      * Current volume [0..100]
      */
@@ -1037,7 +1077,7 @@ export declare class MediaControl extends UICorePlugin {
     bindEvents(): void;
     private bindContainerEvents;
     /**
-     * Disables the plugin and unmounts its UI
+     * Hides the media control UI
      */
     disable(): void;
     /**
@@ -1159,19 +1199,16 @@ export declare class MediaControl extends UICorePlugin {
  */
 export declare type MediaControlElement = 'audioTracksSelector' | 'bottomGear' | 'clipText' | 'gear' | 'pip' | 'playbackRate' | 'seekBarContainer' | 'subtitlesSelector';
 
-declare type MediaSourceInfo = {
-    live: boolean;
-    source: string;
-    id: number;
-    dvr: boolean;
-    projection: string | null;
-};
-
 /**
- * Media delivery protocol
+ * Custom events emitted by the plugins to communicate with one another
  * @beta
  */
-export declare type MediaTransport = 'dash' | 'hls';
+export declare enum MediaControlEvents {
+    /**
+     * Emitted when the gear menu is rendered
+     */
+    MEDIACONTROL_GEAR_RENDERED = "mediacontrol:gear:rendered"
+}
 
 /**
  * @beta
@@ -1221,7 +1258,7 @@ declare type Metrics = {
 declare type MetricsUpdateFn = (metrics: Metrics) => void;
 
 /**
- * The plugin adds support for loading multiple streams and switching between them using the media control UI.
+ * `PLUGIN` that adds support for loading multiple streams and switching between them using the media control UI.
  * @beta
  */
 export declare class MultiCamera extends UICorePlugin {
@@ -1262,8 +1299,8 @@ export declare class MultiCamera extends UICorePlugin {
     private showError;
     private hideError;
     private changeById;
-    getCamerasList(): MediaSourceInfo[];
-    getCurrentCamera(): MediaSourceInfo | null;
+    private getCamerasList;
+    private getCurrentCamera;
     private findElementById;
     private findIndexById;
     private onShowLevelSelectMenu;
@@ -1274,7 +1311,7 @@ export declare class MultiCamera extends UICorePlugin {
 }
 
 /**
- * Enables picture in picture mode.
+ * `PLUGIN` that enables picture in picture mode.
  * @beta
  * @remarks
  * Depends on:
@@ -1321,7 +1358,7 @@ export declare class PictureInPicture extends UICorePlugin {
 
 /**
  * An error occurred during the playback.
- * @beta
+ * @public
  */
 export declare interface PlaybackError {
     /**
@@ -1352,35 +1389,43 @@ export declare interface PlaybackError {
      * Component subsystem of the error origin
      */
     scope: PlayerComponentType;
+    /**
+     * UI description of the error.
+     */
+    UI?: {
+        title: string;
+        message: string;
+        icon?: string;
+    };
 }
 
 /**
  * Codes of errors occurring within the playback component.
- * @beta
+ * @public
  */
 export declare enum PlaybackErrorCode {
     /**
      * An unknown or uncategorised error.
      */
-    Generic = 0,
+    Generic = "GENERIC_ERROR",
     /**
      * The media source is not available. Typically a network error.
      */
-    MediaSourceUnavailable = 1,
+    MediaSourceUnavailable = "MEDIA_SOURCE_UNAVAILABLE",
     /**
      * The media source is not accessible due to some protection policy.
      */
-    MediaSourceAccessDenied = 3
+    MediaSourceAccessDenied = "MEDIA_SOURCE_ACCESS_DENIED"
 }
 
 /**
  * Module to perform the playback.
- * @beta
+ * @public
  */
 export declare type PlaybackModule = 'dash' | 'hls' | 'html5_video';
 
 /**
- * Allows changing the playback speed of the video.
+ * `PLUGIN` that allows changing the playback speed of the video.
  * @beta
  *
  * @remarks
@@ -1390,12 +1435,12 @@ export declare type PlaybackModule = 'dash' | 'hls' | 'html5_video';
  *
  * - {@link BottomGear | bottom_gear}
  *
- * It renders a button in the gear menu, which opens a dropdown with the available playback rates.
+ * It renders a button in the gear menu, which opens a dropdown with the options to change the playback rate.
  */
 export declare class PlaybackRate extends UICorePlugin {
-    private currentPlayback;
     private playbackRates;
     private prevSelectedRate;
+    private rendered;
     private selectedRate;
     /**
      * @internal
@@ -1407,9 +1452,9 @@ export declare class PlaybackRate extends UICorePlugin {
     get supportedVersion(): {
         min: string;
     };
-    private static readonly template;
     private static readonly buttonTemplate;
     private static readonly listTemplate;
+    constructor(core: Core);
     /**
      * @internal
      */
@@ -1429,12 +1474,13 @@ export declare class PlaybackRate extends UICorePlugin {
      * @internal
      */
     bindEvents(): void;
-    private unBindEvents;
+    private onCoreReady;
+    private onActiveContainerChange;
+    private onGearRendered;
+    private onDvrStateChanged;
     private allRateElements;
     private rateElement;
-    private onDashRateChange;
-    private updateLiveStatus;
-    private reload;
+    private onPlaybackRateChange;
     private shouldRender;
     /**
      * @internal
@@ -1443,25 +1489,25 @@ export declare class PlaybackRate extends UICorePlugin {
     private onStartAd;
     private onFinishAd;
     private onPlay;
+    private resetPlaybackRate;
     private onStop;
     private onRateSelect;
     private onShowMenu;
     private goBack;
-    private updatePlaybackRate;
     private setSelectedRate;
     private getTitle;
     private highlightCurrentRate;
 }
 
 /**
- * Type of a stream playback
- * @beta
+ * Type of a stream
+ * @public
  */
 export declare type PlaybackType = 'live' | 'vod';
 
 /**
- * The main component to use in the application code.
- * @beta
+ * `MAIN` component to use in the application code.
+ * @public
  * @remarks
  * The Player object provides very basic API to control playback.
  * To build a sophisticated UI, use the plugins framework to tap into the Clappr core.
@@ -1626,12 +1672,23 @@ export declare class Player {
      * Player.registerPlugin(MyPlugin)
      * ```
      */
-    static registerPlugin(plugin: PlayerPlugin): void;
+    static registerPlugin(plugin: PlayerPluginConstructor): void;
     /**
      * Unregisters a plugin registered earlier with {@link Player.registerPlugin}.
-     * @param plugin - a plugin class
+     * @remarks
+     * It can be also used to unregister a built-in default plugin.
+     *
+     * Currently, the plugins that are always registered are:
+     *
+     * - {@link https://github.com/clappr/clappr-core/blob/3126c3a38a6eee9d5aba3918b194e6380fa1178c/src/plugins/strings/strings.js | 'strings'}, which supports internationalization of the player UI
+     *
+     * - {@link https://github.com/clappr/clappr-core/blob/3126c3a38a6eee9d5aba3918b194e6380fa1178c/src/plugins/sources/sources.js | 'sources'}, which lets to specify multiple media sources and selects the first suitable playback module
+     *
+     * @param name - name of the plugin
      */
-    static unregisterPlugin(plugin: PlayerPlugin): void;
+    static unregisterPlugin(name: string): void;
+    private static getRegisteredPlugins;
+    private static corePlugins;
     private setConfig;
     private initPlayer;
     private tuneIn;
@@ -1647,7 +1704,7 @@ export declare class Player {
 
 /**
  * Subsystems of a player component.
- * @beta
+ * @public
  */
 export declare type PlayerComponentType = 'container' | 'core' | 'playback';
 
@@ -1690,7 +1747,7 @@ export declare type PlayerComponentType = 'container' | 'core' | 'playback';
  *   },
  * }
  * ```
- * @beta
+ * @public
  */
 export declare interface PlayerConfig extends Record<string, unknown> {
     /**
@@ -1748,19 +1805,19 @@ export declare interface PlayerConfig extends Record<string, unknown> {
 
 /**
  * @remarks `true` is equivalent to `'all'`, `false` is equivalent to `'none'`
- * @beta
+ * @public
  */
 export declare type PlayerDebugSettings = PlayerDebugTag | boolean;
 
 /**
  * Debug output category selector
- * @beta
+ * @public
  */
 export declare type PlayerDebugTag = 'all' | 'clappr' | 'dash' | 'hls' | 'none';
 
 /**
  * A top-level event on the player object
- * @beta
+ * @public
  */
 export declare enum PlayerEvent {
     /**
@@ -1817,12 +1874,12 @@ export declare enum PlayerEvent {
 /**
  * Type of a listener callback function for a player event.
  * See the description of the event parameters in {@link PlayerEvent}.
- * @beta
+ * @public
  */
 export declare type PlayerEventHandler<E extends PlayerEvent> = (...args: PlayerEventParams<E>) => void;
 
 /**
- * @beta
+ * @public
  */
 export declare type PlayerEventParams<E extends PlayerEvent> = E extends PlayerEvent.Seek ? [number] : E extends PlayerEvent.VolumeUpdate ? [number] : E extends PlayerEvent.TimeUpdate ? [TimePosition] : E extends PlayerEvent.Resize ? [{
     width: number;
@@ -1831,7 +1888,7 @@ export declare type PlayerEventParams<E extends PlayerEvent> = E extends PlayerE
 
 /**
  * A media source to fetch the media data from
- * @beta
+ * @public
  */
 export declare type PlayerMediaSource = string | PlayerMediaSourceDesc;
 
@@ -1841,7 +1898,7 @@ export declare type PlayerMediaSource = string | PlayerMediaSourceDesc;
  * @remarks
  * When the MIME type is provided, it helps the player determine the appropriate playback engine.
  * If omitted, the player will attempt to detect the type from the source URL extension.
- * @beta
+ * @public
  */
 export declare interface PlayerMediaSourceDesc {
     /**
@@ -1856,16 +1913,21 @@ export declare interface PlayerMediaSourceDesc {
 }
 
 /**
- * @beta
- * @see {@link https://clappr.github.io/classes/UIContainerPlugin.html}, {@link https://clappr.github.io/classes/ContainerPlugin.html}
+ * @public
+ * @see {@link https://clappr.github.io/classes/UIContainerPlugin.html},
+ * {@link https://clappr.github.io/classes/ContainerPlugin.html}
  */
 export declare type PlayerPlugin = {
-    new (...args: any[]): unknown;
     name: string;
 };
 
 /**
- * Displays a poster image in the background and a big play button on top when playback is stopped
+ * @public
+ */
+export declare type PlayerPluginConstructor = CorePluginConstructor | ContainerPluginConstructor;
+
+/**
+ * `PLUGIN` that displays a poster image in the background and a big play button on top when playback is stopped
  * @beta
  * @remarks
  * When the playback is stopped, media control UI is disabled.
@@ -1958,17 +2020,9 @@ export declare class Poster extends UIContainerPlugin {
     destroy(): this;
 }
 
-declare type PresentationalError = {
-    title: string;
-    message: string;
-    code: string;
-    icon: string;
-    reloadIcon: string;
-};
-
 /**
  * A level of quality within a media source.
- * @beta
+ * @public
  */
 export declare interface QualityLevel {
     /**
@@ -1992,7 +2046,7 @@ export declare interface QualityLevel {
 export { reportError_2 as reportError }
 
 /**
- * The plugin adds a seek time indicator to the media control UI.
+ * `PLUGIN` that adds a seek time indicator to the media control UI.
  * @beta
  */
 export declare class SeekTime extends UICorePlugin {
@@ -2036,7 +2090,8 @@ export { SentryTracer }
 export { setTracer }
 
 /**
- * The plugin adds a share button to the media control UI.
+ * `PLUGIN` that adds a share button to the media control UI.
+ * @beta
  */
 export declare class Share extends UICorePlugin {
     private hide;
@@ -2075,7 +2130,8 @@ export declare class Share extends UICorePlugin {
 }
 
 /**
- * The plugin adds skip controls to the media control UI.
+ * `PLUGIN` that adds skip controls to the media control UI.
+ * @beta
  */
 export declare class SkipTime extends UICorePlugin {
     get name(): string;
@@ -2104,7 +2160,7 @@ export declare class SkipTime extends UICorePlugin {
 }
 
 /**
- * This plugin is responsible for managing the automatic failover between sources.
+ * `PLUGIN` that is responsible for managing the automatic failover between sources.
  * @beta
  * @remarks
  * Have a look at the {@link https://miro.com/app/board/uXjVLiN15tY=/?share_link_id=390327585787 | source failover diagram} for the details
@@ -2125,6 +2181,7 @@ export declare class SourceController extends CorePlugin {
     private currentSourceIndex;
     private sourcesDelay;
     private active;
+    private switching;
     private sync;
     /**
      * @internal
@@ -2141,7 +2198,8 @@ export declare class SourceController extends CorePlugin {
      * @internal
      */
     bindEvents(): void;
-    private onReady;
+    private onCoreReady;
+    private onActiveContainerChanged;
     private bindContainerEventListeners;
     private reset;
     private retryPlayback;
@@ -2154,6 +2212,7 @@ export declare class SourceController extends CorePlugin {
 
 /**
  * Custom events emitted by the plugin
+ * @beta
  */
 export declare enum SpinnerEvents {
     /**
@@ -2164,12 +2223,15 @@ export declare enum SpinnerEvents {
 }
 
 /**
- * Shows a pending operation indicator when playback is buffering or in other appropriate cases
+ * `PLUGIN` that shows a pending operation indicator when playback is buffering or in a similar state
  * @beta
  * @remarks
- * The plugin emits
+ * 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.
  */
 export declare class SpinnerThreeBounce extends UIContainerPlugin {
+    private userShown;
     /**
      * @internal
      */
@@ -2198,13 +2260,17 @@ export declare class SpinnerThreeBounce extends UIContainerPlugin {
     private onStop;
     private onError;
     /**
-     * Shows the spinner
+     * Shows the spinner.
+     *
+     * When called, the spinner will not hide (due to its built-in logic) until {@link SpinnerThreeBounce.hide} is called
      */
-    show(): void;
+    show(delay?: number): void;
     /**
-     * Hides the spinner
+     * Hides the spinner.
      */
     hide(): void;
+    private _show;
+    private _hide;
     /**
      * @internal
      */
@@ -2240,7 +2306,7 @@ export declare interface StartEventData {
 }
 
 /**
- * A {@link MediaControl | media control} plugin that provides a UI to select the subtitles when available.
+ * `PLUGIN` that provides a UI to select the subtitles when available.
  * @beta
  *
  * @remarks
@@ -2348,7 +2414,7 @@ export declare class Subtitles extends UICorePlugin {
 }
 
 /**
- * Collects and reports the performance statistics.
+ * `PLUGIN` that collects and reports the performance statistics.
  * @beta
  * @remarks
  * This plugin is experimental and its API is likely to change.
@@ -2460,10 +2526,10 @@ export declare type TelemetryRecord = {
  * @param data - The telemetry record to send.
  * @beta
  */
-declare type TelemetrySendFn = (data: TelemetryRecord) => void;
+export declare type TelemetrySendFn = (data: TelemetryRecord) => void;
 
 /**
- * Displays the thumbnails of the video when available.
+ * `PLUGIN` that displays the thumbnails of the video when available.
  * @beta
  * @example
  * ```ts
@@ -2555,7 +2621,7 @@ export declare type ThumbnailsPluginSettings = {
 
 /**
  * Current playback time and total duration of the media.
- * @beta
+ * @public
  */
 export declare interface TimePosition {
     /**
@@ -2576,11 +2642,6 @@ export declare type TimeProgress = TimePosition & {
     start: number;
 };
 
-/**
- * @internal
- */
-export declare type TimerId = ReturnType<typeof setTimeout>;
-
 /**
  * For the plugin development
  * @beta
@@ -2591,14 +2652,14 @@ export declare type TimeUpdate = TimePosition & {
 
 /**
  * Playback time in seconds since the beginning of the stream (or a segment for the live streams)
- * @beta
+ * @public
  */
 export declare type TimeValue = number;
 
 export { trace }
 
 /**
- * @beta
+ * @public
  */
 export declare type TranslationKey = string;
 
@@ -2624,17 +2685,15 @@ export declare type TranslationKey = string;
  * }
  * ```
  *
- * @beta
+ * @public
  */
 export declare type TranslationSettings = Partial<Record<LangTag, Record<TranslationKey, string>>>;
 
 /**
- * Preferred media delivery protocol
- * @beta
+ * Preferred streaming media delivery protocol
+ * @public
  */
-export declare type TransportPreference = MediaTransport;
-
-declare type UpDown = 'up' | 'down';
+export declare type TransportPreference = 'dash' | 'hls';
 
 /**
  * Version information about the gplayer and its main dependencies
@@ -2649,7 +2708,7 @@ export declare function version(): {
 };
 
 /**
- * Applies fade effect to the player's volume change.
+ * `PLUGIN` that applies fade effect to the player's volume change.
  * @beta
  */
 export declare class VolumeFade extends UICorePlugin {