@theoplayer/extended 5.7.0 → 5.9.0

package/THEOplayer.common.d.ts

@@ -2482,1409 +2482,1419 @@ interface HlsPlaybackConfiguration {
 }
 
 /**
- * Represents a media resource.
- *
- * @remarks
- * <br/> - Can be a string value representing the URL of a media resource, a {@link TypedSource} or a {@link VerizonMediaSource}.
+ * Fired when a text track cue is entered.
  *
  * @public
  */
-type Source = string | TypedSource | VerizonMediaSource;
+interface TextTrackCueEnterEvent extends Event<'enter'> {
+    /**
+     * The text track cue that is entered.
+     */
+    readonly cue: TextTrackCue;
+}
 /**
- * A media resource or list of media resources.
- *
- * @remarks
- * <br/> - The order of sources when using a list determines their priority when attempting playback.
+ * Fired when a text track cue is exited.
  *
  * @public
  */
-type Sources = Source | Source[];
+interface TextTrackCueExitEvent extends Event<'exit'> {
+    /**
+     * The text track cue that is exited.
+     */
+    readonly cue: TextTrackCue;
+}
 /**
- * The cross-origin setting of a source, represented by a value from the following list:
- * <br/> - `'anonymous'`: CORS requests will have the credentials flag set to 'same-origin'.
- * <br/> - `'use-credentials'`: CORS requests will have the credentials flag set to 'include'.
- * <br/> - `''`: Setting the empty string is the same as `'anonymous'`
- *
- * @remarks
- * <br/> - See {@link https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes | The crossorigin attribute: Requesting CORS access to content}
+ * Fired when a text track cue is updated.
  *
  * @public
  */
-type CrossOriginSetting = '' | 'anonymous' | 'use-credentials';
+interface TextTrackCueUpdateEvent extends Event<'update'> {
+    /**
+     * The text track cue that is updated.
+     */
+    readonly cue: TextTrackCue;
+}
 /**
- * Describes the configuration of a player's source.
+ * The events fired by the {@link TextTrackCue}.
  *
  * @public
  */
-interface SourceConfiguration {
-    /**
-     * List of {@link AdDescription}s to be queued for playback.
-     */
-    ads?: AdDescription[];
+interface TextTrackCueEventMap {
     /**
-     * Whether the player should be blocked when an ad-related error occurs.
-     *
-     * @remarks
-     * <br/> - A blocked player is not usable anymore. This has the same effect as invoking {@link ChromelessPlayer.destroy}.
-     *
-     * @defaultValue `false`
+     * Fired when the cue is entered.
      */
-    blockContentIfAdError?: boolean;
+    enter: TextTrackCueEnterEvent;
     /**
-     * If set, only allow ads to play that are scheduled after this time.
-     *
-     * @remarks
-     * <br/> - This setting is strictly after - e.g. setting `playAdsAfterTime` to 15 will cause the player to ignore an ad break scheduled to play at 15s.
-     *
+     * Fired when the cue is exited.
      */
-    playAdsAfterTime?: number;
+    exit: TextTrackCueExitEvent;
     /**
-     * Content protection configuration.
+     * Fired when the cue is updated.
      */
-    contentProtection?: DRMConfiguration;
+    update: TextTrackCueUpdateEvent;
+}
+/**
+ * Represents a cue of a text track.
+ *
+ * @public
+ */
+interface TextTrackCue extends EventDispatcher<TextTrackCueEventMap> {
     /**
-     * {@inheritDoc SourceConfiguration.contentProtection}
-     * @deprecated Superseded by {@link SourceConfiguration.contentProtection}.
+     * The text track of the cue.
      */
-    drm?: DRMConfiguration;
+    track: TextTrack;
     /**
-     * The poster of the media source.
-     *
-     * @remarks
-     * <br/> - An empty string (`''`) clears the current poster.
-     * <br/> - This poster has priority over {@link ChromelessPlayer.poster}.
+     * The identifier of the cue.
      */
-    poster?: string;
+    id: string;
     /**
-     * List of text tracks to be side-loaded with the media source.
+     * A unique identifier of the text track cue.
      *
      * @remarks
-     * <br/> - A source change will reset side-loaded text tracks.
+     * <br/> - This identifier is unique across text track cues of a THEOplayer instance and can be used to distinguish between cues.
+     * <br/> - This identifier is a randomly generated number.
      */
-    textTracks?: TextTrackDescription[];
+    readonly uid: number;
     /**
-     * Virtual reality configuration.
+     * The playback position at which the cue becomes active, in seconds.
      */
-    vr?: VRConfiguration;
+    startTime: number;
     /**
-     * List of {@link AnalyticsDescription}s to configure analytics integrations for the media source.
+     * The playback position at which the cue becomes inactive, in seconds.
      */
-    analytics?: AnalyticsDescription[];
+    endTime: number;
     /**
-     * The muted autoplay policy.
+     * The content of the cue.
      *
      * @remarks
-     * <br/> - The muted autoplay policy is impacted by this property and {@link PlayerConfiguration.mutedAutoplay}.
-     *
-     * @defaultValue `'none'`
+     * The content differs depending on the {@link TextTrackCue.track}'s {@link TextTrack."type" | type }:
+     * <br/> - `'emsg'`: Content is a Uint8Array representing the binary message data from the `emsg` box.
+     * <br/> - `'eventstream'`: Content is the value of the `messageData` attribute which was specified in the manifest.
+     * <br/> - `'ttml'`: Content is an intermediate TTML document’s body element. This is a view of a TTML document where all nodes in the document are active during the cue’s startTime and endTime. As a result, all begin, dur and end properties have been removed. TTML Styles, Regions and Metadata are stored in cue.styles, cue.regions, cue.metadata respectively. Combining those properties with the given content should suffice to render a TTML cue.
+     * <br/> - `'webvtt'`: Content is the cue text in raw unparsed form.
      */
-    mutedAutoplay?: MutedAutoplayConfiguration;
+    content: any;
+}
+
+/**
+ * List of text track cues.
+ *
+ * @public
+ */
+interface TextTrackCueList extends ReadonlyArray<TextTrackCue> {
     /**
-     * The URL of a time server used by the player to synchronise the time in DASH sources.
-     *
-     * @remarks
-     * <br/> - The time server should return time in ISO-8601 format.
-     * <br/> - Overrides the time server provided the DASH manifest's `<UTCTiming>`.
-     * <br/> - All sources will use the time server. Alternatively, for one source use {@link BaseSource.timeServer}.
+     * The number of text track cues in the list.
      */
-    timeServer?: string;
+    readonly length: number;
     /**
-     * Chromecast metadata configuration.
+     * Return the text track cue at the requested index in the list.
      *
-     * @remarks
-     * <br/> - Available since v2.21.0.
+     * @param index - A `number` representing the index of a text track cue in the list.
+     * @returns The text track cue with index `index` in the list.
      */
-    metadata?: ChromecastMetadataDescription;
+    item(index: number): TextTrackCue;
     /**
-     * Whether segments in a HLS manifest should be represented by cues in a metadata text track.
-     *
-     * @deprecated Do not use this feature without consulting THEO Technologies.
+     * Index signature to get the text track cue at the requested index in the list.
      */
-    manifestMetadataTrack?: boolean;
+    readonly [index: number]: TextTrackCue;
 }
+
 /**
- * Describes the configuration of a player's source.
+ * Fired when a new track has been added to this list.
  *
  * @public
  */
-interface SourceDescription extends SourceConfiguration {
+interface AddTrackEvent extends Event<'addtrack'> {
     /**
-     * One or more media resources for playback.
-     *
-     * @remarks
-     * <br/> - Multiple media sources should be used to increase platform compatibility. See examples below for important use cases.
-     * <br/> - The player will try each source in the provided order.
-     *
-     * @example
-     * In this example, the player will first try to play the DASH source.
-     * This might fail if the browser does not support the {@link https://www.widevine.com/ | Widevine} or {@link https://www.microsoft.com/playready/ | PlayReady} CDM, for example on Safari.
-     * In that case, the player will try to play the HLS source instead.
-     *
-     * ```
-     * [{
-     *   src: 'dash-source-with-drm.mpd'
-     *   contentProtection: {
-     *     widevine: {
-     *       licenseAcquisitionURL: 'https://license.company.com/wv'
-     *     },
-     *     playready: {
-     *       licenseAcquisitionURL: 'https://license.company.com/pr'
-     *     }
-     *   }
-     * },{
-     *   src: 'hls-source-with-drm.m3u8',
-     *   contentProtection: {
-     *     fairplay: {
-     *       certificateURL: 'https://license.company.com/fp'
-     *     }
-     *   }
-     * }]
-     * ```
-     *
-     * @example
-     * In this example, the player will first try to play the DASH source.
-     * This might fail if the browser does not support the {@link https://developer.mozilla.org/en-US/docs/Web/API/Media_Source_Extensions_API | Media Source Extensions API}.
-     * In that case, the player will try to play the MP4 source instead, though without features such as adaptive bitrate switching.
-     *
-     * ```
-     * [{
-     *   src: 'source.mpd'
-     * },{
-     *   src: 'source.mp4'
-     * }]
-     * ```
+     * The track that has been added.
      */
-    sources?: Sources;
+    readonly track: Track;
 }
 /**
- * Describes the configuration of a side-loaded text track.
+ * Fired when a track has been removed to this list.
  *
  * @public
  */
-interface TextTrackDescription {
+interface RemoveTrackEvent extends Event<'removetrack'> {
     /**
-     * Whether the text track should be enabled by default.
-     *
-     * @remarks
-     * <br/> - Only one text track per {@link TextTrack.kind} may be marked as default.
-     *
-     * @defaultValue `false`
+     * The track that has been removed.
      */
-    default?: boolean;
+    readonly track: Track;
+}
+/**
+ * Fired when a track has been changed.
+ *
+ * @public
+ */
+interface TrackChangeEvent extends Event<'change'> {
     /**
-     * The kind of the text track, represented by a value from the following list:
-     * <br/> - `'subtitles'`: The track provides subtitles, used to display subtitles in a video.
-     * <br/> - `'captions'`: The track provides a translation of dialogue and sound effects (suitable for users with a hearing impairment).
-     * <br/> - `'descriptions'`: The track provides a textual description of the video (suitable for users with a vision impairment).
-     * <br/> - `'chapters'`: The track provides chapter titles (suitable for navigating the media resource).
-     * <br/> - `'metadata'`: The track provides content used by scripts and is not visible for users.
-     *
-     * @remarks
-     * <br/> -  If an unrecognized value is provided, the player will interpret it as `'metadata'`.
-     *
-     * @defaultValue `'subtitles'`
+     * The track that has changed.
      */
-    kind?: string;
+    readonly track: Track;
+}
+/**
+ * The events fired by a {@link TrackList}.
+ *
+ * @public
+ */
+interface TrackListEventMap {
     /**
-     * The format of the track, represented by a value from the following list:
-     * <br/> - `'srt'`
-     * <br/> - `'ttml'`
-     * <br/> - `'webvtt'`
-     * <br/> - `'emsg'`
-     * <br/> - `'eventstream'`
-     * <br/> - `'id3'`
-     * <br/> - `'cea608'`
-     * <br/> - `'daterange'`
-     *
-     * @defaultValue `''`
+     * Fired when a track is added.
      */
-    format?: string;
+    addtrack: AddTrackEvent;
     /**
-     * The source URL of the text track.
+     * Fired when a track is removed.
      */
-    src: string;
+    removetrack: RemoveTrackEvent;
     /**
-     * The language of the text track.
+     * Fired when a track is activated or deactivated.
      */
-    srclang?: string;
+    change: TrackChangeEvent;
+}
+
+/**
+ * Fired when one or more properties of a track have been updated.
+ *
+ * @public
+ */
+interface TrackUpdateEvent extends Event<'update'> {
     /**
-     * A label for the text track.
-     *
-     * @remarks
-     * <br/> - This will be used as an identifier on the player API and in the UI.
+     * The track that has been updated.
      */
-    label?: string;
+    readonly track: Track;
+}
+/**
+ * The events fired by a {@link Track}.
+ *
+ * @public
+ */
+interface TrackEventMap {
     /**
-     * The identifier of this text track.
+     * Fired when a media track's {@link MediaTrack.enabled | enabled} or a text track's {@link TextTrack.mode | mode} changes.
+     */
+    change: TrackChangeEvent;
+    /**
+     * Fired when the track updates.
      *
-     * @internal
+     * @remarks
+     * <br/> - A track might update because a change propagated from a remote player (e.g. Chromecast).
      */
-    id?: string;
+    update: TrackUpdateEvent;
 }
 /**
- * Represents the common properties of a media resource.
+ * Represents a track of a media resource.
+ *
+ * @remarks
+ * <br/> - A specific track type (e.g. {@link TextTrack}) will always be used.
  *
  * @public
  */
-interface BaseSource {
+interface Track extends EventDispatcher<TrackEventMap> {
     /**
-     * The integration ID of the source.
+     * The kind of the track.
      *
      * @remarks
-     * <br/> - This can be used to signal that a source is specific to an integration.
+     * <br/> - The values for this property depend on the specific type of the track.
      */
-    integration?: SourceIntegrationId;
+    kind: string;
     /**
-     * The cross-origin setting of the source.
-     *
-     * @defaultValue `''`
+     * The identifier of the track.
      *
      * @remarks
-     * <br/> - Available since v2.9.0.
+     * <br/> - This identifier can be used to distinguish between related tracks, e.g. tracks in the same list.
      */
-    crossOrigin?: CrossOriginSetting;
+    id: string;
     /**
-     * Whether the player is allowed to use credentials for cross-origin requests.
+     * A unique identifier of the track.
      *
      * @remarks
-     * <br/> - Credentials are cookies, authorization headers or TLS client certificates.
-     *
-     * @defaultValue `false`
+     * <br/> - This identifier is unique across tracks of a THEOplayer instance and can be used to distinguish between tracks.
+     * <br/> - This identifier is a randomly generated number.
      */
-    useCredentials?: boolean;
+    uid: number;
     /**
-     * The offset in seconds used to determine the live point.
-     * This live point is the end of the manifest minus the provided offset.
-     *
-     * @remarks
-     * <br/> - Available since v2.35.0.
-     *
-     * @defaultValue Three times the segment's target duration.
+     * The label of the track.
      */
-    liveOffset?: number;
+    label: string;
     /**
-     * The URL of a time server used by the player to synchronise the time in DASH sources.
-     *
-     * @remarks
-     * <br/> - Available since v2.47.0.
-     * <br/> - The time server should return time in ISO-8601 format.
-     * <br/> - Overrides the time server provided the DASH manifest's `<UTCTiming>`.
-     * <br/> - Only this source will use the time server. Alternatively, for all source use {@link SourceConfiguration.timeServer}.
+     * The language of the track.
      */
-    timeServer?: string;
+    language: string;
     /**
-     * Whether the player should parse and expose date ranges from HLS manifests.
-     *
-     * @defaultValue `false`
+     * The accessibility settings of the track.
      *
      * @remarks
-     * <br/> - Available since v2.61.0.
+     * <br/> - For DASH: the accessibility descriptors for the corresponding AdaptationSet.
+     * <br/> - For HLS: the CHARACTERISTICS for the corresponding #EXT-X-MEDIA tag.
      */
-    hlsDateRange?: boolean;
+    readonly accessibility: AccessibilityRole[];
+}
+/**
+ * Possible accessibility roles.
+ *
+ * @public
+ */
+type AccessibilityRole = 'caption' | 'sign' | 'description' | 'enhanced audio intelligibility' | 'easy reader' | 'transcribes spoken dialog' | 'describes music and sound' | 'describes video';
+
+/**
+ * A code that indicates the type of error that has occurred.
+ *
+ * @public
+ */
+declare enum ErrorCode {
     /**
-     * Whether to use an experimental rendering pipeline for playback.
-     *
-     * @remarks
-     * <br/> - The availability of an experimental rendering pipeline depends on the platform.
-     * <br/> - Only use after specifically being advised to.
-     *
-     * @internal
+     * The configuration provided is invalid.
      */
-    experimentalRendering?: boolean;
+    CONFIGURATION_ERROR = 1000,
     /**
-     * Whether to use native ui rendering.
-     *
-     * @internal
+     * The license provided is invalid.
      */
-    nativeUiRendering?: boolean;
+    LICENSE_ERROR = 2000,
     /**
-     * Whether the source should be played in the low-latency-mode of the player.
-     *
-     * @defaultValue `false`
-     *
-     * @remarks
-     * <br/> - This setting must be `true` when using Low-Latency CMAF with ABR.
-     * <br/> - Available since v2.62.0.
+     * The provided license does not contain the current domain.
      */
-    lowLatency?: boolean;
+    LICENSE_INVALID_DOMAIN = 2001,
     /**
-     * Whether this source should be played using native playback.
-     *
-     * @defaultValue `false`
-     *
-     * @remarks
-     * <br/> - Available since v2.68.0.
-     * <br/> - Ignored for DASH streams.
-     * <br/> - Only supported on browsers that can play HLS streams natively, will error otherwise.
+     * The current source is not allowed in the license provided.
      */
-    useNativePlayback?: boolean;
+    LICENSE_INVALID_SOURCE = 2002,
     /**
-     * The configuration for controlling playback of an MPEG-DASH stream.
-     *
-     * @remarks
-     * <br/> - Available since v2.79.0.
-     * <br/> - Ignored for non-DASH streams.
+     * The license has expired.
      */
-    dash?: DashPlaybackConfiguration;
+    LICENSE_EXPIRED = 2003,
     /**
-     * The configuration for controlling playback of an HLS stream.
-     *
-     * @remarks
-     * <br/> - Available since v2.82.0.
-     * <br/> - Ignored for non-HLS streams.
+     * The provided license does not contain the necessary feature.
      */
-    hls?: HlsPlaybackConfiguration;
+    LICENSE_INVALID_FEATURE = 2004,
     /**
-     * The source's ABR configuration.
-     *
-     * @remarks
-     * <br/> - Available since v3.1.0.
-     * <br/> - Overrides {@link PlayerConfiguration.abr}.
-     * <br/> - Used for DASH and LL-HLS streams.
+     * The source provided is not valid.
      */
-    abr?: SourceAbrConfiguration;
+    SOURCE_INVALID = 3000,
     /**
-     * Whether this source should be played using the LCEVC sdk.
-     *
-     * @remarks
-     * <br/> - Requires the LCEVC feature to be enabled.
-     * <br/> - Requires the V-Nova LCEVC SDK to be loaded on the page.
-     * <br/> - Only available for DASH and HLS streams.
+     * The provided source is not supported.
      */
-    lcevc?: boolean;
-}
-/**
- * Represents a media resource characterized by a URL to the resource and optionally information about the resource.
- *
- * @public
- */
-interface TypedSource extends BaseSource {
+    SOURCE_NOT_SUPPORTED = 3001,
     /**
-     * The source URL of the media resource.
-     *
-     * @remarks
-     * <br/> - Required if the `ssai` property is absent.
-     * <br/> - Available since v2.4.0.
+     * The manifest could not be loaded.
      */
-    src?: string;
+    MANIFEST_LOAD_ERROR = 4000,
     /**
-     * The content type (MIME type) of the media resource, represented by a value from the following list:
-     * <br/> - `'application/dash+xml'`: The media resource is an MPEG-DASH stream.
-     * <br/> - `'application/x-mpegURL'` or `'application/vnd.apple.mpegurl'`: The media resource is an HLS stream.
-     * <br/> - `'video/mp4'`, `'video/webm'` and other formats: The media resource should use native HTML5 playback if supported by the browser.
-     * <br/> - `'application/vnd.theo.hesp+json'`: The media resource is an HESP stream.
+     * An Error related to Cross-origin resource sharing (CORS).
      *
      * @remarks
-     * <br/> - Available since v2.4.0.
+     * <br/> - See {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS | Cross-Origin Resource Sharing (CORS)}.
      */
-    type?: string;
+    MANIFEST_CORS_ERROR = 4001,
     /**
-     * The content protection parameters for the media resource.
-     *
-     * @remarks
-     * <br/> - Available since v2.15.0.
+     * The manifest could not be parsed.
      */
-    contentProtection?: DRMConfiguration;
+    MANIFEST_PARSE_ERROR = 4002,
     /**
-     * The content protection parameters for the media resource.
-     *
-     * @deprecated Superseded by {@link TypedSource.contentProtection}.
+     * The media is not supported.
      */
-    drm?: DRMConfiguration;
+    MEDIA_NOT_SUPPORTED = 5000,
     /**
-     * The Server-side Ad Insertion parameters for the media resource.
-     *
-     * @remarks
-     * <br/> - Available since v2.12.0.
+     * The media could not be loaded.
      */
-    ssai?: ServerSideAdInsertionConfiguration;
+    MEDIA_LOAD_ERROR = 5001,
     /**
-     * Whether the source is for an ad or a content playback
-     *
-     * @internal
+     * The media could not be decoded.
      */
-    isAdvertisement?: boolean;
-}
-/**
- * The integration identifier of a source specific to a pre-integration, represented by a value from the following list:
- * <br/> - `'verizon-media'`: The source is a {@link VerizonMediaSource}
- * <br/> - `'mediatailor'`: The source contains the MediaTailor initialization url
- *
- * @public
- */
-type SourceIntegrationId = 'verizon-media' | 'mediatailor';
-/**
- * The integration identifier of an analytics description, represented by a value from the following list:
- * <br/> - `'agama'`: The description is an {@link AgamaConfiguration}
- * <br/> - `'conviva'`: The description is a {@link ConvivaConfiguration}
- * <br/> - `'youbora'`: The description is a {@link YouboraOptions}
- * <br/> - `'moat'`: The description is a {@link MoatConfiguration}
- * <br/> - `'streamone'`: The description is a {@link StreamOneConfiguration}
- * <br/> - `'smartsight'`: The description is a {@link SmartSightConfiguration}
- *
- * @public
- */
-type AnalyticsIntegrationID = 'agama' | 'conviva' | 'youbora' | 'moat' | 'streamone' | 'smartsight';
-/**
- * Describes the configuration of an analytics integration.
- *
- * @public
- */
-interface AnalyticsDescription {
+    MEDIA_DECODE_ERROR = 5002,
     /**
-     * The identifier of the analytics integration.
+     * An error related to playback through AVPlayer in the iOS or tvOS SDK.
      */
-    integration: AnalyticsIntegrationID;
-}
-
-/**
- * Fired when {@link RelatedContent.sources} changes.
- *
- * @public
- */
-type RelatedChangeEvent = Event<'relatedchange'>;
-/**
- * Fired when the related content panel is shown.
- *
- * @public
- */
-type RelatedShowEvent = Event<'show'>;
-/**
- * Fired when the related content panel is hidden.
- *
- * @public
- */
-type RelatedHideEvent = Event<'hide'>;
-/**
- * The events fired by the {@link RelatedContent | related content API}.
- *
- * @public
- */
-interface RelatedContentEventMap {
+    MEDIA_AVPLAYER_ERROR = 5003,
     /**
-     * {@inheritDoc RelatedChangeEvent}
+     * The fetching process for the media resource was aborted by the user agent at the user's request.
      */
-    relatedchange: RelatedChangeEvent;
-}
-/**
- * The related content API.
- *
- * @remarks
- * <br/> - Available since v2.14.2.
- *
- * @public
- */
-interface RelatedContent extends EventDispatcher<RelatedContentEventMap> {
+    MEDIA_ABORTED = 5004,
     /**
-     * List of related content sources.
+     * An error related to network has been detected.
      */
-    sources: RelatedContentSource[];
-}
-/**
- * The events fired by the {@link UIRelatedContent | related content API (with ui)}.
- *
- * @public
- */
-interface UIRelatedContentEventMap extends RelatedContentEventMap {
+    NETWORK_ERROR = 6000,
     /**
-     * {@inheritDoc RelatedShowEvent}
+     * The network has timed out.
      */
-    show: RelatedShowEvent;
+    NETWORK_TIMEOUT = 6001,
     /**
-     * {@inheritDoc RelatedHideEvent}
+     * An error related to the content protection.
      */
-    hide: RelatedHideEvent;
-}
-/**
- * The related content UI API which can be used to toggle UI components.
- *
- * @remarks
- * <br/> - Available since v2.14.2.
- *
- * @public
- */
-interface UIRelatedContent extends RelatedContent, EventDispatcher<UIRelatedContentEventMap> {
+    CONTENT_PROTECTION_ERROR = 7000,
     /**
-     * Whether the related content menu is showing.
+     * The DRM provided is not supported on this platform.
      */
-    showing: boolean;
+    CONTENT_PROTECTION_NOT_SUPPORTED = 7001,
     /**
-     * Show the related content menu.
+     * The media is DRM protected, but no content protection configuration was provided.
      */
-    show(): void;
+    CONTENT_PROTECTION_CONFIGURATION_MISSING = 7002,
     /**
-     * Hides the related content menu.
+     * The content protection configuration is invalid.
      */
-    hide(): void;
+    CONTENT_PROTECTION_CONFIGURATION_INVALID = 7003,
     /**
-     * {@inheritDoc EventDispatcher.addEventListener}
+     * The DRM initialization data could not be parsed.
      */
-    addEventListener<TType extends StringKeyOf<UIRelatedContentEventMap>>(type: TType | readonly TType[], listener: EventListener<UIRelatedContentEventMap[TType]>): void;
+    CONTENT_PROTECTION_INITIALIZATION_INVALID = 7004,
     /**
-     * {@inheritDoc EventDispatcher.removeEventListener}
+     * The content protection's certificate could not be loaded.
      */
-    removeEventListener<TType extends StringKeyOf<UIRelatedContentEventMap>>(type: TType | readonly TType[], listener: EventListener<UIRelatedContentEventMap[TType]>): void;
-}
-/**
- * Represents a related content source.
- *
- * @remarks
- * <br/> - Available since v2.14.2.
- *
- * @public
- */
-interface RelatedContentSource {
+    CONTENT_PROTECTION_CERTIFICATE_ERROR = 7005,
     /**
-     * The duration of the related content source.
+     * The content protection's certificate is invalid.
      */
-    duration?: string;
+    CONTENT_PROTECTION_CERTIFICATE_INVALID = 7006,
     /**
-     * The image of the related content source.
+     * The content protection's license could not be loaded.
      */
-    image: string;
+    CONTENT_PROTECTION_LICENSE_ERROR = 7007,
     /**
-     * The target URL for the related content source.
-     *
-     * @remarks
-     * <br/> - Mutually exclusive with {@link RelatedContentSource.source}.
-     * <br/> - Required if {@link RelatedContentSource.source} is not present.
+     * The content protection's license is invalid.
      */
-    link?: string;
+    CONTENT_PROTECTION_LICENSE_INVALID = 7008,
     /**
-     * The source description of the related content source.
-     *
-     * @remarks
-     * <br/> - Mutually exclusive with {@link RelatedContentSource.link}.
-     * <br/> - Required if {@link RelatedContentSource.link} is not present.
+     * The content protection's key has expired.
      */
-    source?: SourceDescription;
+    CONTENT_PROTECTION_KEY_EXPIRED = 7009,
     /**
-     * The title of the related content source.
+     * The content protection's key is missing.
      */
-    title?: string;
-}
-
-/**
- * Fired when a text track cue is entered.
- *
- * @public
- */
-interface TextTrackCueEnterEvent extends Event<'enter'> {
+    CONTENT_PROTECTION_KEY_MISSING = 7010,
     /**
-     * The text track cue that is entered.
+     * All qualities require HDCP, but the current output does not fulfill HDCP requirements.
      */
-    readonly cue: TextTrackCue;
-}
-/**
- * Fired when a text track cue is exited.
- *
- * @public
- */
-interface TextTrackCueExitEvent extends Event<'exit'> {
+    CONTENT_PROTECTION_OUTPUT_RESTRICTED = 7011,
     /**
-     * The text track cue that is exited.
+     * Something went wrong in the internal logic of the content protection system.
      */
-    readonly cue: TextTrackCue;
-}
-/**
- * Fired when a text track cue is updated.
- *
- * @public
- */
-interface TextTrackCueUpdateEvent extends Event<'update'> {
+    CONTENT_PROTECTION_INTERNAL_ERROR = 7012,
     /**
-     * The text track cue that is updated.
+     * Loading subtitles has failed.
      */
-    readonly cue: TextTrackCue;
-}
-/**
- * The events fired by the {@link TextTrackCue}.
- *
- * @public
- */
-interface TextTrackCueEventMap {
+    SUBTITLE_LOAD_ERROR = 8000,
     /**
-     * Fired when the cue is entered.
+     * Loading subtitles has failed due to CORS.
+     *
+     * @remarks
+     * <br/> - See {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS | Cross-Origin Resource Sharing (CORS)}.
      */
-    enter: TextTrackCueEnterEvent;
+    SUBTITLE_CORS_ERROR = 8001,
     /**
-     * Fired when the cue is exited.
+     * Parsing subtitles has failed.
      */
-    exit: TextTrackCueExitEvent;
+    SUBTITLE_PARSE_ERROR = 8002,
     /**
-     * Fired when the cue is updated.
+     * This error occurs when VR is not supported on the current platform.
      */
-    update: TextTrackCueUpdateEvent;
-}
-/**
- * Represents a cue of a text track.
- *
- * @public
- */
-interface TextTrackCue extends EventDispatcher<TextTrackCueEventMap> {
+    VR_PLATFORM_UNSUPPORTED = 9000,
     /**
-     * The text track of the cue.
+     * Changing the presentation to VR was not possible.
      */
-    track: TextTrack;
+    VR_PRESENTATION_ERROR = 9001,
     /**
-     * The identifier of the cue.
+     * Something went wrong with an ad.
      */
-    id: string;
+    AD_ERROR = 10000,
     /**
-     * A unique identifier of the text track cue.
-     *
-     * @remarks
-     * <br/> - This identifier is unique across text track cues of a THEOplayer instance and can be used to distinguish between cues.
-     * <br/> - This identifier is a randomly generated number.
+     * An ad blocker has been detected.
      */
-    readonly uid: number;
+    AD_BLOCKER_DETECTED = 10001,
     /**
-     * The playback position at which the cue becomes active, in seconds.
+     * Changing the presentation to fullscreen was not possible.
      */
-    startTime: number;
+    FULLSCREEN_ERROR = 11000,
     /**
-     * The playback position at which the cue becomes inactive, in seconds.
+     * Something went wrong while caching a source.
      */
-    endTime: number;
+    CACHE_SOURCE_ERROR = 12000,
     /**
-     * The content of the cue.
-     *
-     * @remarks
-     * The content differs depending on the {@link TextTrackCue.track}'s {@link TextTrack."type" | type }:
-     * <br/> - `'emsg'`: Content is a Uint8Array representing the binary message data from the `emsg` box.
-     * <br/> - `'eventstream'`: Content is the value of the `messageData` attribute which was specified in the manifest.
-     * <br/> - `'ttml'`: Content is an intermediate TTML document’s body element. This is a view of a TTML document where all nodes in the document are active during the cue’s startTime and endTime. As a result, all begin, dur and end properties have been removed. TTML Styles, Regions and Metadata are stored in cue.styles, cue.regions, cue.metadata respectively. Combining those properties with the given content should suffice to render a TTML cue.
-     * <br/> - `'webvtt'`: Content is the cue text in raw unparsed form.
+     * Something went wrong while caching content protection's license.
      */
-    content: any;
+    CACHE_CONTENT_PROTECTION_ERROR = 12001
 }
-
 /**
- * List of text track cues.
+ * The category of an error.
  *
  * @public
  */
-interface TextTrackCueList extends ReadonlyArray<TextTrackCue> {
+declare enum ErrorCategory {
     /**
-     * The number of text track cues in the list.
+     * This category clusters all errors related to the configuration.
      */
-    readonly length: number;
+    CONFIGURATION = 1,
     /**
-     * Return the text track cue at the requested index in the list.
-     *
-     * @param index - A `number` representing the index of a text track cue in the list.
-     * @returns The text track cue with index `index` in the list.
+     * This category clusters all errors related to the license.
      */
-    item(index: number): TextTrackCue;
+    LICENSE = 2,
     /**
-     * Index signature to get the text track cue at the requested index in the list.
+     * This category clusters all errors related to the source.
      */
-    readonly [index: number]: TextTrackCue;
-}
-
-/**
- * Fired when a new track has been added to this list.
- *
+    SOURCE = 3,
+    /**
+     * This category clusters all errors related to the manifest.
+     */
+    MANIFEST = 4,
+    /**
+     * This category clusters all errors related to the media.
+     */
+    MEDIA = 5,
+    /**
+     * This category clusters all errors related to the network.
+     */
+    NETWORK = 6,
+    /**
+     * This category clusters all errors related to the content protection.
+     */
+    CONTENT_PROTECTION = 7,
+    /**
+     * This category clusters all errors related to the subtitles.
+     */
+    SUBTITLE = 8,
+    /**
+     * This category clusters all errors related to VR.
+     */
+    VR = 9,
+    /**
+     * This category clusters all errors related to ads.
+     */
+    AD = 10,
+    /**
+     * This category clusters all errors related to fullscreen.
+     */
+    FULLSCREEN = 11,
+    /**
+     * This category clusters all errors related to caching.
+     */
+    CACHE = 12
+}
+/**
  * @public
  */
-interface AddTrackEvent extends Event<'addtrack'> {
+declare namespace ErrorCategory {
     /**
-     * The track that has been added.
+     * Determine the `ErrorCategory` of the given {@link ErrorCode}.
+     *
+     * @param code - The {@link ErrorCode} to determine the `ErrorCategory` of.
      */
-    readonly track: Track;
+    function fromCode(code: ErrorCode): ErrorCategory;
 }
+
 /**
- * Fired when a track has been removed to this list.
+ * An error that is thrown by THEOplayer.
  *
  * @public
  */
-interface RemoveTrackEvent extends Event<'removetrack'> {
+interface THEOplayerError extends Error {
     /**
-     * The track that has been removed.
+     * An {@link ErrorCode} that indicates the type of error that has occurred.
      */
-    readonly track: Track;
+    readonly code: ErrorCode;
+    /**
+     * An `ErrorCategory` that indicates the category of the error that has occurred.
+     *
+     * @remarks
+     * <br/> - Equivalent to `ErrorCategory.fromCode(error.code)`
+     */
+    readonly category: ErrorCategory;
+    /**
+     * The underlying cause of this error, if known.
+     */
+    readonly cause: Error | undefined;
 }
+
 /**
- * Fired when a track has been changed.
+ * Fired when an error occurs.
  *
  * @public
  */
-interface TrackChangeEvent extends Event<'change'> {
+interface ErrorEvent extends Event<'error'> {
     /**
-     * The track that has changed.
+     * The error that occurred.
+     *
+     * @deprecated use {@link ErrorEvent.errorObject | errorObject.message} instead
      */
-    readonly track: Track;
+    error: string;
+    /**
+     * An error object containing additional information about the error.
+     */
+    errorObject: THEOplayerError;
 }
+
 /**
- * The events fired by a {@link TrackList}.
+ * An error code whose category is `ErrorCategory.SUBTITLE`.
  *
  * @public
  */
-interface TrackListEventMap {
+type TextTrackErrorCode = ErrorCode.SUBTITLE_LOAD_ERROR | ErrorCode.SUBTITLE_CORS_ERROR | ErrorCode.SUBTITLE_PARSE_ERROR;
+/**
+ * An error thrown by a text track.
+ *
+ * @public
+ */
+interface TextTrackError extends THEOplayerError {
     /**
-     * Fired when a track is added.
+     * {@inheritDoc THEOplayerError.code}
      */
-    addtrack: AddTrackEvent;
+    readonly code: TextTrackErrorCode;
     /**
-     * Fired when a track is removed.
+     * The URL of the (sideloaded) text track.
      */
-    removetrack: RemoveTrackEvent;
+    readonly url: string;
     /**
-     * Fired when a track is activated or deactivated.
+     * The status code from the HTTP response.
      */
-    change: TrackChangeEvent;
+    readonly status: number;
 }
 
 /**
- * Fired when one or more properties of a track have been updated.
+ * The content type of a text track, represented by a value from the following list:
+ * <br/> - `'srt'`: The track contains SRT (SubRip Text) content.
+ * <br/> - `'ttml'`: The track contains TTML (Timed Text Markup Language) content.
+ * <br/> - `'webvtt'`: The track contains WebVTT (Web Video Text Tracks) content.
+ * <br/> - `'emsg'`: The track contains emsg (Event Message) content.
+ * <br/> - `'eventstream'`: The track contains Event Stream content.
+ * <br/> - `'id3'`: The track contains ID3 content.
+ * <br/> - `'cea608'`: The track contains CEA608 content.
+ * <br/> - `'daterange'`: The track contains HLS EXT-X-DATERANGE content.
+ * <br/> - `''`: The type of the track contents is unknown.
  *
  * @public
  */
-interface TrackUpdateEvent extends Event<'update'> {
+type TextTrackType = 'srt' | 'ttml' | 'webvtt' | 'emsg' | 'eventstream' | 'id3' | 'cea608' | 'daterange' | '';
+/**
+ * The ready state of a text track, represented by a value from the following list:
+ * <br/> - `0`: Indicates that the text track's cues have not been obtained.
+ * <br/> - `1`: The text track is loading. Further cues might still be added to the track by the parser.
+ * <br/> - `2`: The text track has been loaded with no fatal errors.
+ * <br/> - `3`: An error occurred obtaining the cues for the track. Some or all of the cues are likely missing and will not be obtained.
+ *
+ * @public
+ */
+type TextTrackReadyState = 0 | 1 | 2 | 3;
+/**
+ * An error event fired by a {@link TextTrack}.
+ *
+ * @public
+ */
+interface TextTrackErrorEvent extends ErrorEvent {
     /**
-     * The track that has been updated.
+     * {@inheritDoc ErrorEvent.errorObject}
      */
-    readonly track: Track;
+    readonly errorObject: TextTrackError;
 }
 /**
- * The events fired by a {@link Track}.
+ * Fired when a cue is added to the text track.
  *
  * @public
  */
-interface TrackEventMap {
-    /**
-     * Fired when a media track's {@link MediaTrack.enabled | enabled} or a text track's {@link TextTrack.mode | mode} changes.
-     */
-    change: TrackChangeEvent;
+interface TextTrackAddCueEvent extends Event<'addcue'> {
     /**
-     * Fired when the track updates.
-     *
-     * @remarks
-     * <br/> - A track might update because a change propagated from a remote player (e.g. Chromecast).
+     * The cue that is added to the text track.
      */
-    update: TrackUpdateEvent;
+    readonly cue: TextTrackCue;
 }
 /**
- * Represents a track of a media resource.
- *
- * @remarks
- * <br/> - A specific track type (e.g. {@link TextTrack}) will always be used.
+ * Fired when a cue is removed from the text track.
  *
  * @public
  */
-interface Track extends EventDispatcher<TrackEventMap> {
+interface TextTrackRemoveCueEvent extends Event<'removecue'> {
     /**
-     * The kind of the track.
-     *
-     * @remarks
-     * <br/> - The values for this property depend on the specific type of the track.
+     * The cue that is removed from the text track.
      */
-    kind: string;
+    readonly cue: TextTrackCue;
+}
+/**
+ * Fired when a cue of the text track has entered.
+ *
+ * @public
+ */
+interface TextTrackEnterCueEvent extends Event<'entercue'> {
     /**
-     * The identifier of the track.
-     *
-     * @remarks
-     * <br/> - This identifier can be used to distinguish between related tracks, e.g. tracks in the same list.
+     * The cue from the text track that has entered.
      */
-    id: string;
+    readonly cue: TextTrackCue;
+}
+/**
+ * Fired when a cue of the text track has exited.
+ *
+ * @public
+ */
+interface TextTrackExitCueEvent extends Event<'exitcue'> {
     /**
-     * A unique identifier of the track.
-     *
-     * @remarks
-     * <br/> - This identifier is unique across tracks of a THEOplayer instance and can be used to distinguish between tracks.
-     * <br/> - This identifier is a randomly generated number.
+     * The cue from the text track that has exited.
      */
-    uid: number;
+    readonly cue: TextTrackCue;
+}
+/**
+ * Fired when the displaying cues of the text track has changed.
+ *
+ * @public
+ */
+interface TextTrackCueChangeEvent extends Event<'cuechange'> {
     /**
-     * The label of the track.
+     * The text track which displaying cues has changed.
      */
-    label: string;
+    readonly track: TextTrack;
+}
+/**
+ * Fired when the {@link TextTrack.readyState | ready state} of the text track has changed.
+ *
+ * @public
+ */
+interface TextTrackReadyStateChangeEvent extends Event<'readystatechange'> {
     /**
-     * The language of the track.
+     * The text track which ready state has changed.
      */
-    language: string;
+    readonly track: TextTrack;
     /**
-     * The accessibility settings of the track.
-     *
-     * @remarks
-     * <br/> - For DASH: the accessibility descriptors for the corresponding AdaptationSet.
-     * <br/> - For HLS: the CHARACTERISTICS for the corresponding #EXT-X-MEDIA tag.
+     * The new {@link TextTrack.readyState | ready state} of the text track.
      */
-    readonly accessibility: AccessibilityRole[];
+    readonly readyState: TextTrackReadyState;
 }
 /**
- * Possible accessibility roles.
+ * Fired when the {@link TextTrack."type" | type} of the text track has changed.
  *
  * @public
  */
-type AccessibilityRole = 'caption' | 'sign' | 'description' | 'enhanced audio intelligibility' | 'easy reader' | 'transcribes spoken dialog' | 'describes music and sound' | 'describes video';
-
+interface TextTrackTypeChangeEvent extends Event<'typechange'> {
+    /**
+     * The text track which type has changed.
+     */
+    readonly track: TextTrack;
+}
 /**
- * A code that indicates the type of error that has occurred.
+ * The events fired by a {@link TextTrack}.
  *
  * @public
  */
-declare enum ErrorCode {
+interface TextTrackEventMap extends TrackEventMap {
     /**
-     * The configuration provided is invalid.
+     * Fired when a cue is added to the track.
      */
-    CONFIGURATION_ERROR = 1000,
+    addcue: TextTrackAddCueEvent;
     /**
-     * The license provided is invalid.
+     * Fired when a cue of the track is removed.
      */
-    LICENSE_ERROR = 2000,
+    removecue: TextTrackRemoveCueEvent;
     /**
-     * The provided license does not contain the current domain.
+     * Fired when a cue of the track enters.
      */
-    LICENSE_INVALID_DOMAIN = 2001,
+    entercue: TextTrackEnterCueEvent;
     /**
-     * The current source is not allowed in the license provided.
+     * Fired when a cue of the track exits.
      */
-    LICENSE_INVALID_SOURCE = 2002,
+    exitcue: TextTrackExitCueEvent;
     /**
-     * The license has expired.
+     * Fired when the displaying cues of the text track changes.
      */
-    LICENSE_EXPIRED = 2003,
+    cuechange: TextTrackCueChangeEvent;
     /**
-     * The provided license does not contain the necessary feature.
+     * Fired when the text track's {@link TextTrack.readyState | ready state} changes.
      */
-    LICENSE_INVALID_FEATURE = 2004,
+    readystatechange: TextTrackReadyStateChangeEvent;
     /**
-     * The source provided is not valid.
+     * Fired when the text track's {@link TextTrack."type" | type} changes.
      */
-    SOURCE_INVALID = 3000,
+    typechange: TextTrackTypeChangeEvent;
     /**
-     * The provided source is not supported.
+     * Fired when an error occurred while loading or parsing the track.
      */
-    SOURCE_NOT_SUPPORTED = 3001,
+    error: TextTrackErrorEvent;
+}
+/**
+ * Represents a text track of a media resource.
+ *
+ * @public
+ */
+interface TextTrack extends Track, EventDispatcher<TextTrackEventMap> {
     /**
-     * The manifest could not be loaded.
+     * The kind of the text track, represented by a value from the following list:
+     * <br/> - `'subtitles'`: The track contains subtitles.
+     * <br/> - `'captions'`: The track contains closed captions, a translation of dialogue and sound effects.
+     * <br/> - `'descriptions'`: The track contains descriptions, a textual description of the video.
+     * <br/> - `'chapters'`: The track contains chapter titles.
+     * <br/> - `'metadata'`: The track contains metadata. This track will not serve display purposes.
      */
-    MANIFEST_LOAD_ERROR = 4000,
+    readonly kind: string;
     /**
-     * An Error related to Cross-origin resource sharing (CORS).
+     * The label of the text track.
+     */
+    label: string;
+    /**
+     * The language of the text track.
+     */
+    readonly language: string;
+    /**
+     * The identifier of the text track.
      *
      * @remarks
-     * <br/> - See {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS | Cross-Origin Resource Sharing (CORS)}.
+     * <br/> - This identifier can be used to distinguish between related tracks, e.g. tracks in the same list.
+     * <br/> - For a text track embedded within an MPEG-DASH stream, this returns the Representation’d id attribute.
+     * <br/> - For MPEG-DASH streams a Representation's ID is preferred over the AdaptationSet's ID.
      */
-    MANIFEST_CORS_ERROR = 4001,
+    readonly id: string;
     /**
-     * The manifest could not be parsed.
+     * A unique identifier of the text track.
+     *
+     * @remarks
+     * <br/> - This identifier is unique across tracks of a THEOplayer instance and can be used to distinguish between tracks.
+     * <br/> - This identifier is a randomly generated number.
      */
-    MANIFEST_PARSE_ERROR = 4002,
+    readonly uid: number;
     /**
-     * The media is not supported.
+     * The in-band metadata track dispatch type of the text track.
      */
-    MEDIA_NOT_SUPPORTED = 5000,
+    readonly inBandMetadataTrackDispatchType: string;
     /**
-     * The media could not be loaded.
+     * The mode of the text track, represented by a value from the following list:
+     * <br/> - `'disabled'`: The track is disabled.
+     * <br/> - `'hidden'`: The track is hidden.
+     * <br/> - `'showing'`: The track is showing.
+     *
+     * @remarks
+     * <br/> - A disabled track is not displayed and exposes no active cues, nor fires cue events.
+     * <br/> - A hidden track is not displayed but exposes active cues and fires cue events.
+     * <br/> - A showing track is displayed, exposes active cues and fires cue events.
      */
-    MEDIA_LOAD_ERROR = 5001,
+    mode: string;
     /**
-     * The media could not be decoded.
+     * The ready state of the text track.
      */
-    MEDIA_DECODE_ERROR = 5002,
+    readonly readyState: TextTrackReadyState;
     /**
-     * An error related to playback through AVPlayer in the iOS or tvOS SDK.
+     * The content type of the text track.
      */
-    MEDIA_AVPLAYER_ERROR = 5003,
+    readonly type: TextTrackType;
     /**
-     * The fetching process for the media resource was aborted by the user agent at the user's request.
+     * The list of cues of the track.
+     *
+     * @remarks
+     * <br/> - If the {@link TextTrack.mode} is `'disabled'`, this property is `null`.
      */
-    MEDIA_ABORTED = 5004,
+    readonly cues: TextTrackCueList | null;
     /**
-     * An error related to network has been detected.
+     * The list of active cues of the track.
+     *
+     * @remarks
+     * <br/> - A cue is active if the current playback position falls within the time bounds of the cue.
+     * <br/> - This list dynamically updates based on the current playback position.
+     * <br/> - If the {@link TextTrack.mode} is `'disabled'`, this property is `null`.
      */
-    NETWORK_ERROR = 6000,
+    readonly activeCues: TextTrackCueList | null;
     /**
-     * The network has timed out.
+     * The source of the text track.
      */
-    NETWORK_TIMEOUT = 6001,
+    readonly src: string;
     /**
-     * An error related to the content protection.
+     * Indicates whether the track contains Forced Narrative cues.
+     * This may only be true for subtitle tracks where
+     * <br/> - For DASH: the corresponding AdaptationSet contains a child Role with its value attribute equal to `'forced_subtitle'`
+     * <br/> - For HLS: the corresponding #EXT-X-MEDIA tag contains the attributes TYPE=SUBTITLES and FORCED=YES (not supported yet)
      */
-    CONTENT_PROTECTION_ERROR = 7000,
+    readonly forced: boolean;
     /**
-     * The DRM provided is not supported on this platform.
+     * {@inheritDoc EventDispatcher.addEventListener}
      */
-    CONTENT_PROTECTION_NOT_SUPPORTED = 7001,
+    addEventListener<TType extends StringKeyOf<TextTrackEventMap>>(type: TType | readonly TType[], listener: EventListener<TextTrackEventMap[TType]>): void;
     /**
-     * The media is DRM protected, but no content protection configuration was provided.
+     * {@inheritDoc EventDispatcher.removeEventListener}
      */
-    CONTENT_PROTECTION_CONFIGURATION_MISSING = 7002,
+    removeEventListener<TType extends StringKeyOf<TextTrackEventMap>>(type: TType | readonly TType[], listener: EventListener<TextTrackEventMap[TType]>): void;
+}
+
+/**
+ * Represents a media resource.
+ *
+ * @remarks
+ * <br/> - Can be a string value representing the URL of a media resource, a {@link TypedSource} or a {@link VerizonMediaSource}.
+ *
+ * @public
+ */
+type Source = string | TypedSource | VerizonMediaSource;
+/**
+ * A media resource or list of media resources.
+ *
+ * @remarks
+ * <br/> - The order of sources when using a list determines their priority when attempting playback.
+ *
+ * @public
+ */
+type Sources = Source | Source[];
+/**
+ * The cross-origin setting of a source, represented by a value from the following list:
+ * <br/> - `'anonymous'`: CORS requests will have the credentials flag set to 'same-origin'.
+ * <br/> - `'use-credentials'`: CORS requests will have the credentials flag set to 'include'.
+ * <br/> - `''`: Setting the empty string is the same as `'anonymous'`
+ *
+ * @remarks
+ * <br/> - See {@link https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes | The crossorigin attribute: Requesting CORS access to content}
+ *
+ * @public
+ */
+type CrossOriginSetting = '' | 'anonymous' | 'use-credentials';
+/**
+ * Describes the configuration of a player's source.
+ *
+ * @public
+ */
+interface SourceConfiguration {
     /**
-     * The content protection configuration is invalid.
+     * List of {@link AdDescription}s to be queued for playback.
      */
-    CONTENT_PROTECTION_CONFIGURATION_INVALID = 7003,
+    ads?: AdDescription[];
     /**
-     * The DRM initialization data could not be parsed.
+     * Whether the player should be blocked when an ad-related error occurs.
+     *
+     * @remarks
+     * <br/> - A blocked player is not usable anymore. This has the same effect as invoking {@link ChromelessPlayer.destroy}.
+     *
+     * @defaultValue `false`
      */
-    CONTENT_PROTECTION_INITIALIZATION_INVALID = 7004,
+    blockContentIfAdError?: boolean;
     /**
-     * The content protection's certificate could not be loaded.
+     * If set, only allow ads to play that are scheduled after this time.
+     *
+     * @remarks
+     * <br/> - This setting is strictly after - e.g. setting `playAdsAfterTime` to 15 will cause the player to ignore an ad break scheduled to play at 15s.
+     *
      */
-    CONTENT_PROTECTION_CERTIFICATE_ERROR = 7005,
+    playAdsAfterTime?: number;
     /**
-     * The content protection's certificate is invalid.
+     * Content protection configuration.
      */
-    CONTENT_PROTECTION_CERTIFICATE_INVALID = 7006,
+    contentProtection?: DRMConfiguration;
     /**
-     * The content protection's license could not be loaded.
+     * {@inheritDoc SourceConfiguration.contentProtection}
+     * @deprecated Superseded by {@link SourceConfiguration.contentProtection}.
      */
-    CONTENT_PROTECTION_LICENSE_ERROR = 7007,
+    drm?: DRMConfiguration;
     /**
-     * The content protection's license is invalid.
+     * The poster of the media source.
+     *
+     * @remarks
+     * <br/> - An empty string (`''`) clears the current poster.
+     * <br/> - This poster has priority over {@link ChromelessPlayer.poster}.
      */
-    CONTENT_PROTECTION_LICENSE_INVALID = 7008,
+    poster?: string;
     /**
-     * The content protection's key has expired.
+     * List of text tracks to be side-loaded with the media source.
+     *
+     * @remarks
+     * <br/> - A source change will reset side-loaded text tracks.
      */
-    CONTENT_PROTECTION_KEY_EXPIRED = 7009,
+    textTracks?: TextTrackDescription[];
     /**
-     * The content protection's key is missing.
+     * Virtual reality configuration.
      */
-    CONTENT_PROTECTION_KEY_MISSING = 7010,
+    vr?: VRConfiguration;
     /**
-     * All qualities require HDCP, but the current output does not fulfill HDCP requirements.
+     * List of {@link AnalyticsDescription}s to configure analytics integrations for the media source.
      */
-    CONTENT_PROTECTION_OUTPUT_RESTRICTED = 7011,
+    analytics?: AnalyticsDescription[];
     /**
-     * Something went wrong in the internal logic of the content protection system.
+     * The muted autoplay policy.
+     *
+     * @remarks
+     * <br/> - The muted autoplay policy is impacted by this property and {@link PlayerConfiguration.mutedAutoplay}.
+     *
+     * @defaultValue `'none'`
      */
-    CONTENT_PROTECTION_INTERNAL_ERROR = 7012,
+    mutedAutoplay?: MutedAutoplayConfiguration;
     /**
-     * Loading subtitles has failed.
+     * The URL of a time server used by the player to synchronise the time in DASH sources.
+     *
+     * @remarks
+     * <br/> - The time server should return time in ISO-8601 format.
+     * <br/> - Overrides the time server provided the DASH manifest's `<UTCTiming>`.
+     * <br/> - All sources will use the time server. Alternatively, for one source use {@link BaseSource.timeServer}.
      */
-    SUBTITLE_LOAD_ERROR = 8000,
+    timeServer?: string;
     /**
-     * Loading subtitles has failed due to CORS.
+     * Chromecast metadata configuration.
      *
      * @remarks
-     * <br/> - See {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS | Cross-Origin Resource Sharing (CORS)}.
+     * <br/> - Available since v2.21.0.
      */
-    SUBTITLE_CORS_ERROR = 8001,
+    metadata?: ChromecastMetadataDescription;
     /**
-     * Parsing subtitles has failed.
+     * Whether segments in a HLS manifest should be represented by cues in a metadata text track.
+     *
+     * @deprecated Do not use this feature without consulting THEO Technologies.
      */
-    SUBTITLE_PARSE_ERROR = 8002,
+    manifestMetadataTrack?: boolean;
+}
+/**
+ * Describes the configuration of a player's source.
+ *
+ * @public
+ */
+interface SourceDescription extends SourceConfiguration {
     /**
-     * This error occurs when VR is not supported on the current platform.
+     * One or more media resources for playback.
+     *
+     * @remarks
+     * <br/> - Multiple media sources should be used to increase platform compatibility. See examples below for important use cases.
+     * <br/> - The player will try each source in the provided order.
+     *
+     * @example
+     * In this example, the player will first try to play the DASH source.
+     * This might fail if the browser does not support the {@link https://www.widevine.com/ | Widevine} or {@link https://www.microsoft.com/playready/ | PlayReady} CDM, for example on Safari.
+     * In that case, the player will try to play the HLS source instead.
+     *
+     * ```
+     * [{
+     *   src: 'dash-source-with-drm.mpd'
+     *   contentProtection: {
+     *     widevine: {
+     *       licenseAcquisitionURL: 'https://license.company.com/wv'
+     *     },
+     *     playready: {
+     *       licenseAcquisitionURL: 'https://license.company.com/pr'
+     *     }
+     *   }
+     * },{
+     *   src: 'hls-source-with-drm.m3u8',
+     *   contentProtection: {
+     *     fairplay: {
+     *       certificateURL: 'https://license.company.com/fp'
+     *     }
+     *   }
+     * }]
+     * ```
+     *
+     * @example
+     * In this example, the player will first try to play the DASH source.
+     * This might fail if the browser does not support the {@link https://developer.mozilla.org/en-US/docs/Web/API/Media_Source_Extensions_API | Media Source Extensions API}.
+     * In that case, the player will try to play the MP4 source instead, though without features such as adaptive bitrate switching.
+     *
+     * ```
+     * [{
+     *   src: 'source.mpd'
+     * },{
+     *   src: 'source.mp4'
+     * }]
+     * ```
      */
-    VR_PLATFORM_UNSUPPORTED = 9000,
+    sources?: Sources;
+}
+/**
+ * Describes the configuration of a side-loaded text track.
+ *
+ * @public
+ */
+interface TextTrackDescription {
     /**
-     * Changing the presentation to VR was not possible.
+     * Whether the text track should be enabled by default.
+     *
+     * @remarks
+     * <br/> - Only one text track per {@link TextTrack.kind} may be marked as default.
+     *
+     * @defaultValue `false`
+     */
+    default?: boolean;
+    /**
+     * The kind of the text track, represented by a value from the following list:
+     * <br/> - `'subtitles'`: The track provides subtitles, used to display subtitles in a video.
+     * <br/> - `'captions'`: The track provides a translation of dialogue and sound effects (suitable for users with a hearing impairment).
+     * <br/> - `'descriptions'`: The track provides a textual description of the video (suitable for users with a vision impairment).
+     * <br/> - `'chapters'`: The track provides chapter titles (suitable for navigating the media resource).
+     * <br/> - `'metadata'`: The track provides content used by scripts and is not visible for users.
+     *
+     * @remarks
+     * <br/> -  If an unrecognized value is provided, the player will interpret it as `'metadata'`.
+     *
+     * @defaultValue `'subtitles'`
      */
-    VR_PRESENTATION_ERROR = 9001,
+    kind?: string;
     /**
-     * Something went wrong with an ad.
+     * The format of the track, represented by a value from the following list:
+     * <br/> - `'srt'`
+     * <br/> - `'ttml'`
+     * <br/> - `'webvtt'`
+     * <br/> - `'emsg'`
+     * <br/> - `'eventstream'`
+     * <br/> - `'id3'`
+     * <br/> - `'cea608'`
+     * <br/> - `'daterange'`
+     *
+     * @defaultValue `''`
      */
-    AD_ERROR = 10000,
+    format?: string;
     /**
-     * An ad blocker has been detected.
+     * The source URL of the text track.
      */
-    AD_BLOCKER_DETECTED = 10001,
+    src: string;
     /**
-     * Changing the presentation to fullscreen was not possible.
+     * The language of the text track.
      */
-    FULLSCREEN_ERROR = 11000,
+    srclang?: string;
     /**
-     * Something went wrong while caching a source.
+     * A label for the text track.
+     *
+     * @remarks
+     * <br/> - This will be used as an identifier on the player API and in the UI.
      */
-    CACHE_SOURCE_ERROR = 12000,
+    label?: string;
     /**
-     * Something went wrong while caching content protection's license.
+     * The identifier of this text track.
+     *
+     * @internal
      */
-    CACHE_CONTENT_PROTECTION_ERROR = 12001
+    id?: string;
 }
 /**
- * The category of an error.
+ * Represents the common properties of a media resource.
  *
  * @public
  */
-declare enum ErrorCategory {
-    /**
-     * This category clusters all errors related to the configuration.
-     */
-    CONFIGURATION = 1,
+interface BaseSource {
     /**
-     * This category clusters all errors related to the license.
+     * The integration ID of the source.
+     *
+     * @remarks
+     * <br/> - This can be used to signal that a source is specific to an integration.
      */
-    LICENSE = 2,
+    integration?: SourceIntegrationId;
     /**
-     * This category clusters all errors related to the source.
+     * The cross-origin setting of the source.
+     *
+     * @defaultValue `''`
+     *
+     * @remarks
+     * <br/> - Available since v2.9.0.
      */
-    SOURCE = 3,
+    crossOrigin?: CrossOriginSetting;
     /**
-     * This category clusters all errors related to the manifest.
+     * Whether the player is allowed to use credentials for cross-origin requests.
+     *
+     * @remarks
+     * <br/> - Credentials are cookies, authorization headers or TLS client certificates.
+     *
+     * @defaultValue `false`
      */
-    MANIFEST = 4,
+    useCredentials?: boolean;
     /**
-     * This category clusters all errors related to the media.
+     * The offset in seconds used to determine the live point.
+     * This live point is the end of the manifest minus the provided offset.
+     *
+     * @remarks
+     * <br/> - Available since v2.35.0.
+     *
+     * @defaultValue Three times the segment's target duration.
      */
-    MEDIA = 5,
+    liveOffset?: number;
     /**
-     * This category clusters all errors related to the network.
+     * The URL of a time server used by the player to synchronise the time in DASH sources.
+     *
+     * @remarks
+     * <br/> - Available since v2.47.0.
+     * <br/> - The time server should return time in ISO-8601 format.
+     * <br/> - Overrides the time server provided the DASH manifest's `<UTCTiming>`.
+     * <br/> - Only this source will use the time server. Alternatively, for all source use {@link SourceConfiguration.timeServer}.
      */
-    NETWORK = 6,
+    timeServer?: string;
     /**
-     * This category clusters all errors related to the content protection.
+     * Whether the player should parse and expose date ranges from HLS manifests.
+     *
+     * @defaultValue `false`
+     *
+     * @remarks
+     * <br/> - Available since v2.61.0.
      */
-    CONTENT_PROTECTION = 7,
+    hlsDateRange?: boolean;
     /**
-     * This category clusters all errors related to the subtitles.
+     * Whether to use an experimental rendering pipeline for playback.
+     *
+     * @remarks
+     * <br/> - The availability of an experimental rendering pipeline depends on the platform.
+     * <br/> - Only use after specifically being advised to.
+     *
+     * @internal
      */
-    SUBTITLE = 8,
+    experimentalRendering?: boolean;
     /**
-     * This category clusters all errors related to VR.
+     * Whether to use native ui rendering.
+     *
+     * @internal
      */
-    VR = 9,
+    nativeUiRendering?: boolean;
     /**
-     * This category clusters all errors related to ads.
+     * Whether the source should be played in the low-latency-mode of the player.
+     *
+     * @defaultValue `false`
+     *
+     * @remarks
+     * <br/> - This setting must be `true` when using Low-Latency CMAF with ABR.
+     * <br/> - Available since v2.62.0.
      */
-    AD = 10,
+    lowLatency?: boolean;
     /**
-     * This category clusters all errors related to fullscreen.
+     * Whether this source should be played using native playback.
+     *
+     * @defaultValue `false`
+     *
+     * @remarks
+     * <br/> - Available since v2.68.0.
+     * <br/> - Ignored for DASH streams.
+     * <br/> - Only supported on browsers that can play HLS streams natively, will error otherwise.
      */
-    FULLSCREEN = 11,
+    useNativePlayback?: boolean;
     /**
-     * This category clusters all errors related to caching.
+     * The configuration for controlling playback of an MPEG-DASH stream.
+     *
+     * @remarks
+     * <br/> - Available since v2.79.0.
+     * <br/> - Ignored for non-DASH streams.
      */
-    CACHE = 12
-}
-/**
- * @public
- */
-declare namespace ErrorCategory {
+    dash?: DashPlaybackConfiguration;
     /**
-     * Determine the `ErrorCategory` of the given {@link ErrorCode}.
+     * The configuration for controlling playback of an HLS stream.
      *
-     * @param code - The {@link ErrorCode} to determine the `ErrorCategory` of.
+     * @remarks
+     * <br/> - Available since v2.82.0.
+     * <br/> - Ignored for non-HLS streams.
      */
-    function fromCode(code: ErrorCode): ErrorCategory;
-}
-
-/**
- * An error that is thrown by THEOplayer.
- *
- * @public
- */
-interface THEOplayerError extends Error {
+    hls?: HlsPlaybackConfiguration;
     /**
-     * An {@link ErrorCode} that indicates the type of error that has occurred.
+     * The source's ABR configuration.
+     *
+     * @remarks
+     * <br/> - Available since v3.1.0.
+     * <br/> - Overrides {@link PlayerConfiguration.abr}.
+     * <br/> - Used for DASH and LL-HLS streams.
      */
-    readonly code: ErrorCode;
+    abr?: SourceAbrConfiguration;
     /**
-     * An `ErrorCategory` that indicates the category of the error that has occurred.
+     * Whether this source should be played using the LCEVC sdk.
      *
      * @remarks
-     * <br/> - Equivalent to `ErrorCategory.fromCode(error.code)`
+     * <br/> - Requires the LCEVC feature to be enabled.
+     * <br/> - Requires the V-Nova LCEVC SDK to be loaded on the page.
+     * <br/> - Only available for DASH and HLS streams.
      */
-    readonly category: ErrorCategory;
+    lcevc?: boolean;
     /**
-     * The underlying cause of this error, if known.
+     * A list of embedded {@link TextTrackType}s to ignore when parsing media segments.
+     *
+     * @remarks
+     * <br/> - Available since v5.9.0
+     * <br/> - Only 'cea608' and 'emsg' can currently be ignored.
+     * <br/> - Only for DASH and HLS playback.
+     *
      */
-    readonly cause: Error | undefined;
+    ignoreEmbeddedTextTrackTypes?: TextTrackType[];
 }
-
 /**
- * Fired when an error occurs.
+ * Represents a media resource characterized by a URL to the resource and optionally information about the resource.
  *
  * @public
  */
-interface ErrorEvent extends Event<'error'> {
+interface TypedSource extends BaseSource {
     /**
-     * The error that occurred.
+     * The source URL of the media resource.
      *
-     * @deprecated use {@link ErrorEvent.errorObject | errorObject.message} instead
+     * @remarks
+     * <br/> - Required if the `ssai` property is absent.
+     * <br/> - Available since v2.4.0.
      */
-    error: string;
+    src?: string;
     /**
-     * An error object containing additional information about the error.
+     * The content type (MIME type) of the media resource, represented by a value from the following list:
+     * <br/> - `'application/dash+xml'`: The media resource is an MPEG-DASH stream.
+     * <br/> - `'application/x-mpegURL'` or `'application/vnd.apple.mpegurl'`: The media resource is an HLS stream.
+     * <br/> - `'video/mp4'`, `'video/webm'` and other formats: The media resource should use native HTML5 playback if supported by the browser.
+     * <br/> - `'application/vnd.theo.hesp+json'`: The media resource is an HESP stream.
+     *
+     * @remarks
+     * <br/> - Available since v2.4.0.
      */
-    errorObject: THEOplayerError;
-}
-
-/**
- * An error code whose category is `ErrorCategory.SUBTITLE`.
- *
- * @public
- */
-type TextTrackErrorCode = ErrorCode.SUBTITLE_LOAD_ERROR | ErrorCode.SUBTITLE_CORS_ERROR | ErrorCode.SUBTITLE_PARSE_ERROR;
-/**
- * An error thrown by a text track.
- *
- * @public
- */
-interface TextTrackError extends THEOplayerError {
+    type?: string;
     /**
-     * {@inheritDoc THEOplayerError.code}
+     * The content protection parameters for the media resource.
+     *
+     * @remarks
+     * <br/> - Available since v2.15.0.
      */
-    readonly code: TextTrackErrorCode;
+    contentProtection?: DRMConfiguration;
     /**
-     * The URL of the (sideloaded) text track.
+     * The content protection parameters for the media resource.
+     *
+     * @deprecated Superseded by {@link TypedSource.contentProtection}.
      */
-    readonly url: string;
+    drm?: DRMConfiguration;
     /**
-     * The status code from the HTTP response.
+     * The Server-side Ad Insertion parameters for the media resource.
+     *
+     * @remarks
+     * <br/> - Available since v2.12.0.
+     */
+    ssai?: ServerSideAdInsertionConfiguration;
+    /**
+     * Whether the source is for an ad or a content playback
+     *
+     * @internal
      */
-    readonly status: number;
+    isAdvertisement?: boolean;
 }
-
 /**
- * The content type of a text track, represented by a value from the following list:
- * <br/> - `'srt'`: The track contains SRT (SubRip Text) content.
- * <br/> - `'ttml'`: The track contains TTML (Timed Text Markup Language) content.
- * <br/> - `'webvtt'`: The track contains WebVTT (Web Video Text Tracks) content.
- * <br/> - `'emsg'`: The track contains emsg (Event Message) content.
- * <br/> - `'eventstream'`: The track contains Event Stream content.
- * <br/> - `'id3'`: The track contains ID3 content.
- * <br/> - `'cea608'`: The track contains CEA608 content.
- * <br/> - `'daterange'`: The track contains HLS EXT-X-DATERANGE content.
- * <br/> - `''`: The type of the track contents is unknown.
+ * The integration identifier of a source specific to a pre-integration, represented by a value from the following list:
+ * <br/> - `'verizon-media'`: The source is a {@link VerizonMediaSource}
+ * <br/> - `'mediatailor'`: The source contains the MediaTailor initialization url
  *
  * @public
  */
-type TextTrackType = 'srt' | 'ttml' | 'webvtt' | 'emsg' | 'eventstream' | 'id3' | 'cea608' | 'daterange' | '';
+type SourceIntegrationId = 'verizon-media' | 'mediatailor';
 /**
- * The ready state of a text track, represented by a value from the following list:
- * <br/> - `0`: Indicates that the text track's cues have not been obtained.
- * <br/> - `1`: The text track is loading. Further cues might still be added to the track by the parser.
- * <br/> - `2`: The text track has been loaded with no fatal errors.
- * <br/> - `3`: An error occurred obtaining the cues for the track. Some or all of the cues are likely missing and will not be obtained.
+ * The integration identifier of an analytics description, represented by a value from the following list:
+ * <br/> - `'agama'`: The description is an {@link AgamaConfiguration}
+ * <br/> - `'conviva'`: The description is a {@link ConvivaConfiguration}
+ * <br/> - `'youbora'`: The description is a {@link YouboraOptions}
+ * <br/> - `'moat'`: The description is a {@link MoatConfiguration}
+ * <br/> - `'streamone'`: The description is a {@link StreamOneConfiguration}
+ * <br/> - `'smartsight'`: The description is a {@link SmartSightConfiguration}
  *
  * @public
  */
-type TextTrackReadyState = 0 | 1 | 2 | 3;
+type AnalyticsIntegrationID = 'agama' | 'conviva' | 'youbora' | 'moat' | 'streamone' | 'smartsight';
 /**
- * An error event fired by a {@link TextTrack}.
+ * Describes the configuration of an analytics integration.
  *
  * @public
  */
-interface TextTrackErrorEvent extends ErrorEvent {
+interface AnalyticsDescription {
     /**
-     * {@inheritDoc ErrorEvent.errorObject}
+     * The identifier of the analytics integration.
      */
-    readonly errorObject: TextTrackError;
+    integration: AnalyticsIntegrationID;
 }
+
 /**
- * Fired when a cue is added to the text track.
+ * Fired when {@link RelatedContent.sources} changes.
  *
  * @public
  */
-interface TextTrackAddCueEvent extends Event<'addcue'> {
-    /**
-     * The cue that is added to the text track.
-     */
-    readonly cue: TextTrackCue;
-}
+type RelatedChangeEvent = Event<'relatedchange'>;
 /**
- * Fired when a cue is removed from the text track.
+ * Fired when the related content panel is shown.
  *
  * @public
  */
-interface TextTrackRemoveCueEvent extends Event<'removecue'> {
-    /**
-     * The cue that is removed from the text track.
-     */
-    readonly cue: TextTrackCue;
-}
+type RelatedShowEvent = Event<'show'>;
 /**
- * Fired when a cue of the text track has entered.
+ * Fired when the related content panel is hidden.
  *
  * @public
  */
-interface TextTrackEnterCueEvent extends Event<'entercue'> {
-    /**
-     * The cue from the text track that has entered.
-     */
-    readonly cue: TextTrackCue;
-}
+type RelatedHideEvent = Event<'hide'>;
 /**
- * Fired when a cue of the text track has exited.
+ * The events fired by the {@link RelatedContent | related content API}.
  *
  * @public
  */
-interface TextTrackExitCueEvent extends Event<'exitcue'> {
+interface RelatedContentEventMap {
     /**
-     * The cue from the text track that has exited.
+     * {@inheritDoc RelatedChangeEvent}
      */
-    readonly cue: TextTrackCue;
+    relatedchange: RelatedChangeEvent;
 }
 /**
- * Fired when the displaying cues of the text track has changed.
+ * The related content API.
+ *
+ * @remarks
+ * <br/> - Available since v2.14.2.
  *
  * @public
  */
-interface TextTrackCueChangeEvent extends Event<'cuechange'> {
+interface RelatedContent extends EventDispatcher<RelatedContentEventMap> {
     /**
-     * The text track which displaying cues has changed.
+     * List of related content sources.
      */
-    readonly track: TextTrack;
+    sources: RelatedContentSource[];
 }
 /**
- * Fired when the {@link TextTrack.readyState | ready state} of the text track has changed.
+ * The events fired by the {@link UIRelatedContent | related content API (with ui)}.
  *
  * @public
  */
-interface TextTrackReadyStateChangeEvent extends Event<'readystatechange'> {
+interface UIRelatedContentEventMap extends RelatedContentEventMap {
     /**
-     * The text track which ready state has changed.
+     * {@inheritDoc RelatedShowEvent}
      */
-    readonly track: TextTrack;
+    show: RelatedShowEvent;
     /**
-     * The new {@link TextTrack.readyState | ready state} of the text track.
+     * {@inheritDoc RelatedHideEvent}
      */
-    readonly readyState: TextTrackReadyState;
+    hide: RelatedHideEvent;
 }
 /**
- * Fired when the {@link TextTrack."type" | type} of the text track has changed.
+ * The related content UI API which can be used to toggle UI components.
  *
- * @public
- */
-interface TextTrackTypeChangeEvent extends Event<'typechange'> {
-    /**
-     * The text track which type has changed.
-     */
-    readonly track: TextTrack;
-}
-/**
- * The events fired by a {@link TextTrack}.
+ * @remarks
+ * <br/> - Available since v2.14.2.
  *
  * @public
  */
-interface TextTrackEventMap extends TrackEventMap {
-    /**
-     * Fired when a cue is added to the track.
-     */
-    addcue: TextTrackAddCueEvent;
-    /**
-     * Fired when a cue of the track is removed.
-     */
-    removecue: TextTrackRemoveCueEvent;
-    /**
-     * Fired when a cue of the track enters.
-     */
-    entercue: TextTrackEnterCueEvent;
+interface UIRelatedContent extends RelatedContent, EventDispatcher<UIRelatedContentEventMap> {
     /**
-     * Fired when a cue of the track exits.
+     * Whether the related content menu is showing.
      */
-    exitcue: TextTrackExitCueEvent;
+    showing: boolean;
     /**
-     * Fired when the displaying cues of the text track changes.
+     * Show the related content menu.
      */
-    cuechange: TextTrackCueChangeEvent;
+    show(): void;
     /**
-     * Fired when the text track's {@link TextTrack.readyState | ready state} changes.
+     * Hides the related content menu.
      */
-    readystatechange: TextTrackReadyStateChangeEvent;
+    hide(): void;
     /**
-     * Fired when the text track's {@link TextTrack."type" | type} changes.
+     * {@inheritDoc EventDispatcher.addEventListener}
      */
-    typechange: TextTrackTypeChangeEvent;
+    addEventListener<TType extends StringKeyOf<UIRelatedContentEventMap>>(type: TType | readonly TType[], listener: EventListener<UIRelatedContentEventMap[TType]>): void;
     /**
-     * Fired when an error occurred while loading or parsing the track.
+     * {@inheritDoc EventDispatcher.removeEventListener}
      */
-    error: TextTrackErrorEvent;
+    removeEventListener<TType extends StringKeyOf<UIRelatedContentEventMap>>(type: TType | readonly TType[], listener: EventListener<UIRelatedContentEventMap[TType]>): void;
 }
 /**
- * Represents a text track of a media resource.
+ * Represents a related content source.
+ *
+ * @remarks
+ * <br/> - Available since v2.14.2.
  *
  * @public
  */
-interface TextTrack extends Track, EventDispatcher<TextTrackEventMap> {
-    /**
-     * The kind of the text track, represented by a value from the following list:
-     * <br/> - `'subtitles'`: The track contains subtitles.
-     * <br/> - `'captions'`: The track contains closed captions, a translation of dialogue and sound effects.
-     * <br/> - `'descriptions'`: The track contains descriptions, a textual description of the video.
-     * <br/> - `'chapters'`: The track contains chapter titles.
-     * <br/> - `'metadata'`: The track contains metadata. This track will not serve display purposes.
-     */
-    readonly kind: string;
-    /**
-     * The label of the text track.
-     */
-    label: string;
-    /**
-     * The language of the text track.
-     */
-    readonly language: string;
-    /**
-     * The identifier of the text track.
-     *
-     * @remarks
-     * <br/> - This identifier can be used to distinguish between related tracks, e.g. tracks in the same list.
-     * <br/> - For a text track embedded within an MPEG-DASH stream, this returns the Representation’d id attribute.
-     * <br/> - For MPEG-DASH streams a Representation's ID is preferred over the AdaptationSet's ID.
-     */
-    readonly id: string;
-    /**
-     * A unique identifier of the text track.
-     *
-     * @remarks
-     * <br/> - This identifier is unique across tracks of a THEOplayer instance and can be used to distinguish between tracks.
-     * <br/> - This identifier is a randomly generated number.
-     */
-    readonly uid: number;
-    /**
-     * The in-band metadata track dispatch type of the text track.
-     */
-    readonly inBandMetadataTrackDispatchType: string;
-    /**
-     * The mode of the text track, represented by a value from the following list:
-     * <br/> - `'disabled'`: The track is disabled.
-     * <br/> - `'hidden'`: The track is hidden.
-     * <br/> - `'showing'`: The track is showing.
-     *
-     * @remarks
-     * <br/> - A disabled track is not displayed and exposes no active cues, nor fires cue events.
-     * <br/> - A hidden track is not displayed but exposes active cues and fires cue events.
-     * <br/> - A showing track is displayed, exposes active cues and fires cue events.
-     */
-    mode: string;
+interface RelatedContentSource {
     /**
-     * The ready state of the text track.
+     * The duration of the related content source.
      */
-    readonly readyState: TextTrackReadyState;
+    duration?: string;
     /**
-     * The content type of the text track.
+     * The image of the related content source.
      */
-    readonly type: TextTrackType;
+    image: string;
     /**
-     * The list of cues of the track.
+     * The target URL for the related content source.
      *
      * @remarks
-     * <br/> - If the {@link TextTrack.mode} is `'disabled'`, this property is `null`.
+     * <br/> - Mutually exclusive with {@link RelatedContentSource.source}.
+     * <br/> - Required if {@link RelatedContentSource.source} is not present.
      */
-    readonly cues: TextTrackCueList | null;
+    link?: string;
     /**
-     * The list of active cues of the track.
+     * The source description of the related content source.
      *
      * @remarks
-     * <br/> - A cue is active if the current playback position falls within the time bounds of the cue.
-     * <br/> - This list dynamically updates based on the current playback position.
-     * <br/> - If the {@link TextTrack.mode} is `'disabled'`, this property is `null`.
-     */
-    readonly activeCues: TextTrackCueList | null;
-    /**
-     * The source of the text track.
-     */
-    readonly src: string;
-    /**
-     * Indicates whether the track contains Forced Narrative cues.
-     * This may only be true for subtitle tracks where
-     * <br/> - For DASH: the corresponding AdaptationSet contains a child Role with its value attribute equal to `'forced_subtitle'`
-     * <br/> - For HLS: the corresponding #EXT-X-MEDIA tag contains the attributes TYPE=SUBTITLES and FORCED=YES (not supported yet)
-     */
-    readonly forced: boolean;
-    /**
-     * {@inheritDoc EventDispatcher.addEventListener}
+     * <br/> - Mutually exclusive with {@link RelatedContentSource.link}.
+     * <br/> - Required if {@link RelatedContentSource.link} is not present.
      */
-    addEventListener<TType extends StringKeyOf<TextTrackEventMap>>(type: TType | readonly TType[], listener: EventListener<TextTrackEventMap[TType]>): void;
+    source?: SourceDescription;
     /**
-     * {@inheritDoc EventDispatcher.removeEventListener}
+     * The title of the related content source.
      */
-    removeEventListener<TType extends StringKeyOf<TextTrackEventMap>>(type: TType | readonly TType[], listener: EventListener<TextTrackEventMap[TType]>): void;
+    title?: string;
 }
 
 /**
@@ -11024,16 +11034,34 @@ interface AgamaPlayerConfiguration extends AgamaConfiguration {
      * The manufacturer of the device
      *
      * @remarks
-     * <br/> Available since v5.3.0
+     * <br/> - Available since v5.3.0
      */
     deviceManufacturer?: string;
     /**
-     * The model name of the Device, including the "submodel". Use the spelling set by the manufacturer.
+     * The model name of the Device, including the "submodel".
      *
      * @remarks
-     * <br/> Available since v5.3.0
+     * <br/> - Use the spelling set by the manufacturer.
+     * <br/> - Available since v5.3.0
      */
     deviceModel?: string;
+    /**
+     * The name of the OS that the device is running.
+     *
+     * @remarks
+     * <br/> - Use in combination with `deviceOsVersion`.
+     * <br/> - Include platform's name if the software can be used on various devices (e.g. case of Android platform).
+     * <br/> - Available since v5.9.0
+     */
+    deviceOs?: string;
+    /**
+     * The version of the OS the device is running.
+     *
+     * @remarks
+     * <br/> - Version should be reported in major.minor.patch notation (i.e. without build information).
+     * <br/> - Available since v5.9.0
+     */
+    deviceOsVersion?: string;
 }
 /**
  * The stream type, represented by a value from the following list: