@gcorevideo/player 2.22.15 → 2.22.17

package/dist/player.d.ts

@@ -51,7 +51,7 @@ import { UIObject } from '@clappr/core';
  *
  * - {@link MediaControl}
  */
-export declare class AudioSelector extends UICorePlugin {
+declare class AudioTracks extends UICorePlugin {
     private currentTrack;
     private tracks;
     /**
@@ -80,28 +80,22 @@ export declare class AudioSelector extends UICorePlugin {
      */
     get events(): {
         'click [data-audiotracks-select]': string;
-        'click [data-audiotracks-button]': string;
+        'click #audiotracks-button': string;
     };
     /**
      * @internal
      */
     bindEvents(): void;
     private onCoreReady;
-    private bindPlaybackEvents;
-    private setupAudioTrackListeners;
-    private onStop;
     private onActiveContainerChanged;
     private shouldRender;
     /**
      * @internal
      */
     render(): this;
-    private fillTracks;
-    private findTrackBy;
     private onTrackSelect;
     private selectAudioTrack;
-    private onShowLevelSelectMenu;
-    private hideSelectTrackMenu;
+    private hideMenu;
     private toggleContextMenu;
     private buttonElement;
     private buttonElementText;
@@ -111,6 +105,8 @@ export declare class AudioSelector extends UICorePlugin {
     private updateText;
     private highlightCurrentTrack;
 }
+export { AudioTracks as AudioSelector }
+export { AudioTracks }
 
 /**
  * `PLUGIN` that displays a big mute button over the video when it's muted.
@@ -316,101 +312,32 @@ export declare class BottomGear extends UICorePlugin {
 }
 
 /**
- * `PLUGIN` that displays useful network-related statistics.
  * @beta
- *
- * @remarks
- * Depends on:
- *
- * - {@link BottomGear}
- *
- * - {@link ClapprStats}
- *
- * The plugin is rendered as an item in the gear menu.
- *
- * When clicked, it shows an overlay window with the information about the network speed, latency, etc,
- * and recommended quality level.
  */
-export declare class ClapprNerdStats extends UICorePlugin {
-    private container;
-    private customMetrics;
-    private metrics;
-    private showing;
-    private shortcut;
-    private iconPosition;
-    private static readonly buttonTemplate;
-    /**
-     * @internal
-     */
-    get name(): string;
-    /**
-     * @internal
-     */
-    get supportedVersion(): {
-        min: string;
-    };
-    private static readonly template;
-    /**
-     * @internal
-     */
-    get attributes(): {
-        'data-clappr-nerd-stats': string;
-        class: string;
-    };
-    /**
-     * @internal
-     */
-    get events(): {
-        'click [data-show-stats-button]': string;
-        'click [data-close-button]': string;
-        'click [data-refresh-button]': string;
-    };
-    private get statsBoxElem();
-    private get statsBoxWidthThreshold();
-    private get playerWidth();
-    private get playerHeight();
-    constructor(core: Core);
-    /**
-     * @internal
-     */
-    bindEvents(): void;
-    private onCoreReady;
-    private toggle;
-    private show;
-    private hide;
-    private onPlayerResize;
-    private addGeneralMetrics;
-    private addCustomMetrics;
-    private updateMetrics;
-    private setStatsBoxSize;
-    /**
-     * @internal
-     */
-    render(): this;
-    private addToBottomGear;
-    private clearCustomMetrics;
-    private refreshSpeedTest;
+declare enum Chronograph {
+    Startup = "startup",
+    Watch = "watch",
+    Pause = "pause",
+    Buffering = "buffering",
+    Session = "session"
 }
 
 /**
- * `PLUGIN` that collects useful statistics about playback performance.
+ * `PLUGIN` that measures data about playback, which can be useful for analyzing performance and UX.
  * @beta
  * @remarks
  * This plugin does not render anything and is supposed to be extended or used together with other plugins that actually render something.
+ *
+ * Configuration options - {@link ClapprStatsSettings}
+ *
+ * Events - {@link ClapprStatsEvents}
  */
 export declare class ClapprStats extends ContainerPlugin {
-    private bwMeasureCount;
-    private intervalId;
+    private timerId;
     private lastDecodedFramesCount;
     private metrics;
-    private completion;
-    private _onReport;
-    private runBandwidthTestEvery;
-    private runEach;
     private timers;
-    private updateFn;
-    private urisToMeasureBandwidth;
-    private uriToMeasureLatency;
+    private runEach;
     /**
      * @internal
      */
@@ -421,18 +348,12 @@ export declare class ClapprStats extends ContainerPlugin {
     get supportedVersion(): {
         min: string;
     };
-    private get _playbackName();
-    private get _playbackType();
-    private _now;
-    private _inc;
+    private get playbackName();
+    private get playbackType();
+    private now;
+    private inc;
     private start;
-    private _stop;
-    /**
-     * Registers a callback to receive the metrics.
-     * @param updateMetricsFn - The callback to receive the metrics
-     */
-    setUpdateMetrics(updateMetricsFn: MetricsUpdateFn): void;
-    private _defaultReport;
+    private stop;
     constructor(container: Container);
     /**
      * @internal
@@ -444,7 +365,7 @@ export declare class ClapprStats extends ContainerPlugin {
     destroy(): void;
     /**
      * Returns the collected metrics.
-     * @returns Currently collected metrics
+     * @returns Measurements collected so far
      */
     exportMetrics(): Metrics;
     private onBitrate;
@@ -460,17 +381,22 @@ export declare class ClapprStats extends ContainerPlugin {
     private onBuffering;
     private onBufferfull;
     private onProgress;
-    private _newMetrics;
-    private _onCompletion;
-    private _buildReport;
-    private _fetchFPS;
-    private _calculateBitrates;
-    private _calculatePercentages;
-    private _html5FetchFPS;
-    private _measureLatency;
-    private _measureBandwidth;
+    private onCompletion;
+    private buildReport;
+    private fetchFPS;
+    private calcBitrates;
+    private calcBufferingPercentage;
+    private html5FetchFPS;
 }
 
+export declare type ClapprStatsSettings = {
+    /**
+     * The interval in milliseconds of periodic measurements.
+     * The plugin will emit a {@link ClapprStatsEvents.REPORT} event with the collected metrics at the specified interval.
+     */
+    runEach?: number;
+};
+
 /**
  * A small `PLUGIN` that toggles the playback state on click over the video container
  * @beta
@@ -499,21 +425,23 @@ export declare class ClickToPause extends ContainerPlugin {
 }
 
 /**
- * `PLUGIN` that shows text over the seekbar to indicate the current clip.
+ * `PLUGIN` that allows marking up the timeline of the video
  * @beta
  * @remarks
+ * The plugin decorates the seekbar with notches to indicate the clips of the video and displays current clip text in the left panel
+ *
  * Depends on:
  *
  * - {@link MediaControl}
  *
  * Configuration options - {@link ClipsPluginSettings}
  */
-export declare class ClipsPlugin extends UICorePlugin {
+export declare class Clips extends UICorePlugin {
+    private barStyle;
     private clips;
-    private duration;
-    private durationGetting;
-    private _oldContainer;
+    private oldContainer;
     private svgMask;
+    private static readonly template;
     /**
      * @internal
      */
@@ -524,34 +452,37 @@ export declare class ClipsPlugin extends UICorePlugin {
     get attributes(): {
         class: string;
     };
+    get version(): string;
+    get supportedVersion(): {
+        min: string;
+    };
     /**
      * @internal
      */
     bindEvents(): void;
-    private _onCoreReady;
-    private _onMediaControlContainerChanged;
+    render(): this;
+    destroy(): UIObject;
+    disable(): void;
+    enable(): void;
+    private onCoreReady;
+    private onMcRender;
+    private onContainerChanged;
     private playerResize;
-    private _bindContainerEvents;
     private onTimeUpdate;
     private parseClips;
-    /**
-     * Returns the text of the current clip.
-     * @param time - The current time of the player.
-     * @returns The text of the current clip.
-     */
-    getText(time: number): string;
     private makeSvg;
     private setSVGMask;
     private setClipText;
 }
 
 /**
- * Configuration options for the {@link ClipsPlugin | clips} plugin.
+ * Configuration options for the {@link ClipsPlugin} plugin.
  * @beta
  */
 export declare interface ClipsPluginSettings {
     /**
-     * The text to display over the seekbar.
+     * The compiled text of the clips description, one clip per line in format  :
+     * `HH:MM:SS text` or `MM:SS text` or `SS text`
      */
     text: string;
 }
@@ -697,11 +628,11 @@ export declare type ContainerSize = {
  * @beta
  * @remarks
  * Configuration options - {@link ContextMenuPluginSettings}
+ *
+ * Should not be used together with {@link ClickToPause} plugin
  */
 export declare class ContextMenu extends UIContainerPlugin {
-    private _label;
-    private _url;
-    private menuOptions;
+    private open;
     /**
      * @internal
      */
@@ -719,14 +650,11 @@ export declare class ContextMenu extends UIContainerPlugin {
         class: string;
     };
     private static readonly template;
-    private get label();
-    private get url();
-    private get exposeVersion();
     /**
      * @internal
      */
     get events(): {
-        'click [data-version]': string;
+        'click [role="menuitem"]': string;
     };
     constructor(container: Container);
     /**
@@ -737,10 +665,11 @@ export declare class ContextMenu extends UIContainerPlugin {
      * @internal
      */
     destroy(): UIObject;
-    private toggleContextMenu;
+    private onContainerClick;
+    private onContextMenu;
     private show;
     private hide;
-    private onOpenMainPage;
+    private runAction;
     /**
      * @internal
      */
@@ -753,9 +682,7 @@ export declare class ContextMenu extends UIContainerPlugin {
  * @beta
  */
 export declare interface ContextMenuPluginSettings {
-    label?: string;
-    url?: string;
-    preventShowContextMenu?: boolean;
+    options?: MenuOption[];
 }
 
 /**
@@ -766,6 +693,23 @@ export declare type CorePluginConstructor = {
     type: string;
 };
 
+/**
+ * @beta
+ */
+declare enum Counter {
+    Play = "play",
+    Pause = "pause",
+    Error = "error",
+    Buffering = "buffering",
+    DecodedFrames = "decodedFrames",
+    DroppedFrames = "droppedFrames",
+    Fps = "fps",
+    ChangeLevel = "changeLevel",
+    Seek = "seek",
+    Fullscreen = "fullscreen",
+    DvrUsage = "dvrUsage"
+}
+
 /**
  * A plain JS object that must conform to the DASH.js settings schema.
  * @public
@@ -1027,116 +971,6 @@ export declare interface InitEventData {
  */
 export declare type LangTag = string;
 
-/**
- * `PLUGIN` that provides a UI to select the desired quality level of the playback.
- * @beta
- *
- * @remarks
- * Depends on:
- *
- * - {@link MediaControl}
- *
- * - {@link BottomGear}
- *
- * The plugin is rendered as an item in the gear menu, which, when clicked, shows a list of quality levels to choose from.
- *
- * Configuration options - {@link LevelSelectorPluginSettings}
- *
- * @example
- * ```ts
- * new Player({
- *   levelSelector: {
- *     restrictResolution: 360,
- *     labels: { 360: 'SD', 720: 'HD' },
- *   },
- * })
- * ```
- */
-export declare class LevelSelector extends UICorePlugin {
-    private levels;
-    private levelLabels;
-    private removeAuto;
-    private isHd;
-    private currentText;
-    private selectedLevelId;
-    private static readonly buttonTemplate;
-    private static readonly listTemplate;
-    /**
-     * @internal
-     */
-    get name(): string;
-    /**
-     * @internal
-     */
-    get supportedVersion(): {
-        min: string;
-    };
-    /**
-     * @internal
-     */
-    static get version(): string;
-    /**
-     * @internal
-     */
-    get attributes(): {
-        class: string;
-        'data-level-selector': string;
-    };
-    get events(): {
-        'click .gear-sub-menu_btn': string;
-        'click .go-back': string;
-    };
-    /**
-     * @internal
-     */
-    bindEvents(): void;
-    private onCoreReady;
-    private onGearRendered;
-    private onActiveContainerChange;
-    private updateHd;
-    private onStop;
-    private shouldRender;
-    /**
-     * @internal
-     */
-    render(): this;
-    private renderDropdown;
-    private updateButton;
-    private get maxLevel();
-    private onLevelsAvailable;
-    private makeLevelsLabels;
-    private onSelect;
-    private goBack;
-    private setLevel;
-    private allLevelElements;
-    private levelElement;
-    private onLevelSwitchStart;
-    private onLevelSwitchEnd;
-    private updateText;
-    private getLevelLabel;
-    private onBitrate;
-    private highlightCurrentLevel;
-}
-
-/**
- * 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 }
 
 /**
@@ -1177,10 +1011,16 @@ export { LogTracer }
  * @beta
  * @remarks
  * The methods exposed are to be used by the other plugins that extend the media control UI.
+ *
+ * Configuration options:
+ *
+ * - `mediaControl`: {@link MediaControlSettings} - specifies the allowed media control elements in each area
+ *
+ * - `persistConfig`: boolean - `common` option, makes the plugin persist the media control settings
+ *
+ * - `chromeless`: boolean
  */
 export declare class MediaControl extends UICorePlugin {
-    private customAreaElements;
-    private customAreaHandler?;
     private buttonsColor;
     private currentDurationValue;
     private currentPositionValue;
@@ -1199,20 +1039,20 @@ export declare class MediaControl extends UICorePlugin {
     private kibo;
     private lastMouseX;
     private lastMouseY;
+    private metadataLoaded;
+    private hasUpdate;
     private persistConfig;
+    private renderTimerId;
     private rendered;
     private settings;
     private userDisabled;
     private userKeepVisible;
     private verticalVolume;
-    private $clipText;
-    private $clipTextContainer;
     private $duration;
     private $fullscreenToggle;
     private $multiCameraSelector;
     private $playPauseToggle;
     private $playStopToggle;
-    private $playbackRate;
     private $position;
     private $seekBarContainer;
     private $seekBarHover;
@@ -1373,17 +1213,15 @@ export declare class MediaControl extends UICorePlugin {
      * ```ts
      * class MyPlugin extends UICorePlugin {
      *   override render() {
-     *     const mediaControl = this.core.getPlugin('media_control')
-     *     const clipText = mediaControl.getElement('clipText')
-     *     clipText?.el.text('Here we go')
+     *     this.$el.html('<div data-clips>Here we go</div>')
+     *     this.core.getPlugin('media_control').mount('clips', this.$el)
      *     return this
      *   }
      * }
      * ```
      */
-    getElement(name: MediaControlElement): ZeptoResult | null;
+    mount(name: MediaControlElement, element: ZeptoResult): void;
     putElement(name: MediaControlElement, element: ZeptoResult): void;
-    handleCustomArea(handler: (name: string, content: HTMLElement) => void): void;
     /**
      * Toggle the visibility of a media control element
      * @param name - The name of the media control element
@@ -1406,6 +1244,7 @@ export declare class MediaControl extends UICorePlugin {
      * @internal
      */
     destroy(): UIObject;
+    private cancelRenderTimer;
     private configure;
     /**
      * @internal
@@ -1431,35 +1270,108 @@ export declare class MediaControl extends UICorePlugin {
 }
 
 /**
- * Media control elements, mount points for additional plugins
+ * Built-in media control elements.
+ * @beta
+ */
+export declare type MediaControlElement = MediaControlLeftElement | MediaControlLayerElement | MediaControlRightElement;
+
+/**
+ * Media control elements that appear in main layer, spanning the entire width of the player.
+ * @beta
+ */
+export declare type MediaControlLayerElement = 'seekbar' | 'seekBarContainer';
+
+/**
+ * Media control elements that appear in the left area.
  * @beta
  */
-export declare type MediaControlElement = 'audiotracks' | 'cc' | 'clipText' | 'dvr' | 'duration' | 'fullscreen' | 'gear' | 'multicamera' | 'pip' | 'playbackRate' | 'position' | 'seekBarContainer' | 'vr' | 'volume';
+export declare type MediaControlLeftElement = 'clipText' | 'duration' | 'dvr' | 'playpause' | 'playstop' | 'position' | 'volume' | 'clips';
+
+/**
+ * Media control elements that appear in the right area.
+ * @beta
+ */
+export declare type MediaControlRightElement = 'audiotracks' | 'cc' | 'fullscreen' | 'hd-indicator' | 'gear' | 'multicamera' | 'pip' | 'vr';
+
+/**
+ * Specifies the allowed media control elements in each area.
+ * Can be used to restrict rendered media control elements.
+ * @beta
+ */
+export declare type MediaControlSettings = {
+    left: MediaControlLeftElement[];
+    right: MediaControlRightElement[];
+    default: MediaControlLayerElement[];
+    seekEnabled: boolean;
+};
+
+/**
+ * @beta
+ */
+export declare type MenuOption = {
+    /**
+     * Menu item label text. One of `label` or `labelKey` must be specified.
+     */
+    label?: string;
+    /**
+     * Menu item label localisation key, if specified, the `label` will be ignored
+     */
+    labelKey?: string;
+    /**
+     * Menu item name. Must be unique.
+     */
+    name: string;
+    /**
+     * Menu item handler function
+     */
+    handler?: () => void;
+    /**
+     * Menu item icon, plain HTML string
+     */
+    icon?: string;
+};
 
 /**
  * @beta
  */
 declare type Metrics = {
+    /**
+     * Events count counters
+     */
     counters: {
-        play: number;
-        pause: number;
-        error: number;
-        buffering: number;
-        decodedFrames: number;
-        droppedFrames: number;
-        fps: number;
-        changeLevel: number;
-        seek: number;
-        fullscreen: number;
-        dvrUsage: number;
-    };
-    timers: {
-        startup: number;
-        watch: number;
-        pause: number;
-        buffering: number;
-        session: number;
-        latency: number;
+        /**
+         *
+         */
+        [Counter.Play]: number;
+        [Counter.Pause]: number;
+        [Counter.Error]: number;
+        [Counter.Buffering]: number;
+        [Counter.DecodedFrames]: number;
+        [Counter.DroppedFrames]: number;
+        [Counter.Fps]: number;
+        [Counter.ChangeLevel]: number;
+        [Counter.Seek]: number;
+        [Counter.Fullscreen]: number;
+        [Counter.DvrUsage]: number;
+    };
+    /**
+     * Time measurements - accumulated duration of time-based activities
+     */
+    chrono: {
+        /**
+         * Time spent in the startup phase
+         */
+        [Chronograph.Startup]: number;
+        /**
+         * Total time spent in the watch phase
+         */
+        [Chronograph.Watch]: number;
+        /**
+         *
+         */
+        [Chronograph.Pause]: number;
+        [Chronograph.Buffering]: number;
+        [Chronograph.Session]: number;
     };
     extra: {
         playbackName: string;
@@ -1478,11 +1390,6 @@ declare type Metrics = {
     custom: Record<string, unknown>;
 };
 
-/**
- * @beta
- */
-declare type MetricsUpdateFn = (metrics: Metrics) => void;
-
 /**
  * `PLUGIN` that adds support for loading multiple streams and switching between them using the media control UI.
  * @beta
@@ -1536,6 +1443,89 @@ export declare class MultiCamera extends UICorePlugin {
     private highlightCurrentLevel;
 }
 
+/**
+ * `PLUGIN` that displays useful network-related statistics.
+ * @beta
+ *
+ * @remarks
+ * Depends on:
+ *
+ * - {@link BottomGear}
+ *
+ * - {@link ClapprStats}
+ *
+ * The plugin is rendered as an item in the gear menu.
+ *
+ * When clicked, it shows an overlay window with the information about the network speed, latency, etc,
+ * and recommended quality level.
+ */
+declare class NerdStats extends UICorePlugin {
+    private container;
+    private customMetrics;
+    private metrics;
+    private showing;
+    private shortcut;
+    private iconPosition;
+    private static readonly buttonTemplate;
+    /**
+     * @internal
+     */
+    get name(): string;
+    /**
+     * @internal
+     */
+    get supportedVersion(): {
+        min: string;
+    };
+    private static readonly template;
+    /**
+     * @internal
+     */
+    get attributes(): {
+        'data-clappr-nerd-stats': string;
+        class: string;
+    };
+    /**
+     * @internal
+     */
+    get events(): {
+        'click [data-show-stats-button]': string;
+        'click [data-close-button]': string;
+        'click [data-refresh-button]': string;
+    };
+    private get statsBoxElem();
+    private get statsBoxWidthThreshold();
+    private get playerWidth();
+    private get playerHeight();
+    constructor(core: Core);
+    /**
+     * @internal
+     */
+    bindEvents(): void;
+    private onCoreReady;
+    /**
+     * @internal
+     */
+    destroy(): UIObject;
+    private toggle;
+    private show;
+    private hide;
+    private onPlayerResize;
+    private addGeneralMetrics;
+    private addCustomMetrics;
+    private updateMetrics;
+    private setStatsBoxSize;
+    /**
+     * @internal
+     */
+    render(): this;
+    private addToBottomGear;
+    private clearCustomMetrics;
+    private refreshSpeedTest;
+}
+export { NerdStats as ClapprNerdStats }
+export { NerdStats }
+
 /**
  * `PLUGIN` that enables picture in picture mode.
  * @beta
@@ -1681,13 +1671,14 @@ export declare type PlaybackModule = 'dash' | 'hls' | 'html5_video';
  *       { value: 1, label: '1x' },
  *     ],
  *     defaultValue: 1,
- *   } as PlaybackRateSettings,
+ *   },
  * })
  * ```
  */
 export declare class PlaybackRate extends UICorePlugin {
-    private playbackRates;
     private selectedRate;
+    private metadataLoaded;
+    private mountTimerId;
     /**
      * @internal
      */
@@ -1701,6 +1692,7 @@ export declare class PlaybackRate extends UICorePlugin {
     private static readonly buttonTemplate;
     private static readonly listTemplate;
     constructor(core: Core);
+    private get playbackRates();
     /**
      * @internal
      */
@@ -1722,17 +1714,22 @@ export declare class PlaybackRate extends UICorePlugin {
     private onActiveContainerChange;
     private onMediaControlRendered;
     private onGearRendered;
-    private addGearItem;
+    private mount;
     private onMetaDataLoaded;
     private allRateElements;
     private rateElement;
     private onPlaybackRateChange;
-    private shouldRender;
+    private shouldMount;
     /**
      * @internal
      */
     render(): this;
+    /**
+     * @internal
+     */
+    destroy(): UIObject;
     private onPlay;
+    private syncRate;
     private resetPlaybackRate;
     private onStop;
     private onSelect;
@@ -2043,9 +2040,10 @@ export declare interface PlayerConfig extends Record<string, unknown> {
      */
     mute?: boolean;
     /**
-     * The type of playback (live stream or video on demand).
-     *
-     * @defaultValue 'vod'
+     * Stream type.
+     * @remark
+     * Should only be set if known in advance, as it should not change once determined.
+     * Otherwise it might cause inconsistencies in the UI plugins behavior, for instance, glitches with rendering of the DVR controls or seek bar.
      */
     playbackType?: PlaybackType;
     /**
@@ -2283,20 +2281,21 @@ export declare class Poster extends UIContainerPlugin {
 }
 
 /**
- * A level of quality within a media source.
+ * A level of quality within a media source/representation.
  * @public
  */
 export declare interface QualityLevel {
     /**
      * Zero-based index of the quality level.
+     * Quality levels go from low to high
      */
     level: number;
     /**
-     * Width of the video, pixels.
+     * Width of the video frame, pixels.
      */
     width: number;
     /**
-     * Height of the video, pixels.
+     * Height of the video frame, pixels.
      */
     height: number;
     /**
@@ -2305,6 +2304,119 @@ export declare interface QualityLevel {
     bitrate: number;
 }
 
+/**
+ * `PLUGIN` that provides a UI to select the desired quality level of the playback.
+ * @beta
+ *
+ * @remarks
+ * Depends on:
+ *
+ * - {@link MediaControl}
+ *
+ * - {@link BottomGear}
+ *
+ * The plugin is rendered as an item in the gear menu, which, when clicked, shows a list of quality levels to choose from.
+ *
+ * Configuration options - {@link QualityLevelsPluginSettings}
+ *
+ * @example
+ * ```ts
+ * new Player({
+ *   qualityLevels: {
+ *     restrictResolution: 360,
+ *     labels: { 360: 'SD', 720: 'HD' },
+ *   },
+ * })
+ * ```
+ */
+declare class QualityLevels extends UICorePlugin {
+    private levels;
+    private levelLabels;
+    private removeAuto;
+    private isHd;
+    private currentText;
+    private selectedLevelId;
+    private static readonly buttonTemplate;
+    private static readonly listTemplate;
+    /**
+     * @internal
+     */
+    get name(): string;
+    /**
+     * @internal
+     */
+    get supportedVersion(): {
+        min: string;
+    };
+    /**
+     * @internal
+     */
+    static get version(): string;
+    /**
+     * @internal
+     */
+    get attributes(): {
+        class: string;
+        'data-level-selector': string;
+    };
+    get events(): {
+        'click .gear-sub-menu_btn': string;
+        'click .go-back': string;
+    };
+    /**
+     * @internal
+     */
+    bindEvents(): void;
+    private onCoreReady;
+    private onGearRendered;
+    private onActiveContainerChange;
+    private updateHd;
+    private onStop;
+    private shouldRender;
+    /**
+     * @internal
+     */
+    render(): this;
+    private renderDropdown;
+    private updateButton;
+    private get pluginOptions();
+    private get maxLevel();
+    private onLevelsAvailable;
+    private makeLevelsLabels;
+    private onSelect;
+    private goBack;
+    private setLevel;
+    private allLevelElements;
+    private levelElement;
+    private onLevelSwitchStart;
+    private onLevelSwitchEnd;
+    private updateText;
+    private getLevelLabel;
+    private onBitrate;
+    private highlightCurrentLevel;
+}
+export { QualityLevels as LevelSelector }
+export { QualityLevels }
+
+/**
+ * Configuration options for the {@link QualityLevels} plugin.
+ * @beta
+ */
+export declare interface QualityLevelsPluginSettings {
+    /**
+     * 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 { reportError_2 as reportError }
 
 /**
@@ -2823,21 +2935,32 @@ export declare type ThumbnailsPluginSettings = {
  */
 export declare interface TimePosition {
     /**
-     * Current playback time, 0..duration, seconds.
+     * Current playback time, 0..duration
      */
     current: TimeValue;
     /**
-     * Total duration of the media, seconds.
+     * Total duration of the media content (or DVR window size or segment duration for live streams)
      */
     total: TimeValue;
 }
 
 /**
- * For the plugin development
+ * Time progress information indicated by Clappr CONTAINER_PROGRESS and PLAYBACK_PROGRESS events.
  * @beta
  */
-export declare type TimeProgress = TimePosition & {
-    start: number;
+export declare type TimeProgress = {
+    /**
+     * Current playback time
+     */
+    start: TimeValue;
+    /**
+     * Current buffer length beginning from the start (=current) time
+     */
+    current: TimeValue;
+    /**
+     * Total duration of the media content
+     */
+    total: TimeValue;
 };
 
 /**
@@ -2849,7 +2972,8 @@ export declare type TimeUpdate = TimePosition & {
 };
 
 /**
- * Playback time in seconds since the beginning of the stream (or a segment for the live streams)
+ * Playback time position in seconds since the beginning of the stream.
+ * For the live streams this is limited to the length of a segment. When DVR is enabled, this refers to the
  * @public
  */
 export declare type TimeValue = number;