@amazon/vinyl 1.2.0 → 2.0.4

package/dist/types/current/track/hls/createHlsFactories.js

@@ -5,25 +5,31 @@
 import { createMediaSource } from '../../util/media/mediaSource';
 import { createDefaultHlsMediaQualityMetadataResolver } from './HlsMediaQualityMetadataResolver';
 import { MediaSourceControllerImpl, } from '../../streaming/buffering/MediaSourceController';
-import { HlsManifestControllerImpl } from './HlsManifestController';
 import { externalDependencies, validateFactories, } from '@amazon/vinyl-di';
-import { createUrlHlsManifestProvider } from './createUrlHlsManifestProvider';
 import { createHlsContentTypesValue } from './createHlsContentTypesValue';
+import { createAllowedContentTypesValue } from '../../streaming/createAllowedContentTypesValue';
 import { createHlsContentStreamFactories } from './createHlsContentStreamFactories';
 import { createContentStreamFactory } from '../../streaming/ContentStream';
 import { QualitySelectorImpl } from '../../streaming/abr/QualitySelectorImpl';
 import { createDefaultHlsManifestTransformer } from './createDefaultHlsManifestTransformer';
 import { buildHlsMediaTimeline, } from './buildHlsMediaTimeline';
 import { createDefaultMediaTimelineTransformer } from '../../streaming/createDefaultMediaTimelineTransformer';
+import { SidecarTextTrackController } from '../../text/SidecarTextTrackController';
+import { discoverHlsTextTracks } from '../../text/discoverHlsTextTracks';
+import { ManifestControllerImpl, } from '../../streaming/ManifestControllerImpl';
+import { createHlsManifestProvider } from './createHlsManifestProvider';
 export function createHlsFactories(options) {
     return (deps) => {
         return (loadOptions) => {
-            const manifestProvider = loadOptions.manifestProvider ||
-                createUrlHlsManifestProvider(loadOptions.uri, loadOptions.requestInit || undefined);
             return validateFactories({
+                // Spreads all player-level deps (including adController) as
+                // external, non-owned dependencies so disposing this track's
+                // container never disposes the shared player-level controllers.
                 ...externalDependencies(deps),
-                contentTypesValue: createHlsContentTypesValue,
-                manifestController: () => new HlsManifestControllerImpl(manifestProvider),
+                baseContentTypesValue: createHlsContentTypesValue,
+                contentTypesValue: createAllowedContentTypesValue,
+                manifestProvider: () => createHlsManifestProvider(loadOptions),
+                manifestController: (deps) => new ManifestControllerImpl(deps),
                 manifestTransformed: createDefaultHlsManifestTransformer,
                 mediaQualityMetadataResolver: () => createDefaultHlsMediaQualityMetadataResolver(),
                 mediaSourceFactory: () => createMediaSource,
@@ -34,11 +40,34 @@ export function createHlsFactories(options) {
                 qualitySelector: (deps) => new QualitySelectorImpl({
                     options: deps.options.pick('abr'),
                 }),
+                preferredAudioLanguage: (deps) => deps.options.pick('preferredAudioLanguage'),
+                allowedContentTypes: (deps) => deps.options.pick('allowedContentTypes'),
+                preferDescriptiveAudio: (deps) => deps.options.pick('preferDescriptiveAudio'),
+                abr: (deps) => deps.options.pick('abr'),
                 mediaTimeline: (deps) => deps.manifestTransformed.map(async (manifestPromise) => {
                     const data = await manifestPromise;
                     return buildHlsMediaTimeline(deps, data);
                 }),
                 mediaTimelineTransformed: createDefaultMediaTimelineTransformer,
+                textTrackController: (deps) => {
+                    const controller = new SidecarTextTrackController({
+                        media: deps.media,
+                        requestInit: loadOptions.requestInit ?? undefined,
+                        preferredTextLanguage: deps.options.pick('preferredTextLanguage'),
+                        cueStyle: deps.options.pick('textCueStyle'),
+                    });
+                    deps.manifestTransformed.onData((manifestPromise) => {
+                        manifestPromise
+                            .then((data) => {
+                            controller.setTextTracks(discoverHlsTextTracks(data.mainPlaylist, data.baseUrl));
+                        })
+                            .catch(() => {
+                            // Manifest errors are surfaced through the
+                            // manifest controller. Don't double-report.
+                        });
+                    });
+                    return controller;
+                },
             });
         };
     };

package/dist/types/current/track/hls/createHlsManifestProvider.d.ts

@@ -0,0 +1,6 @@
+import type { HlsTrackLoadOptions } from './HlsTrack';
+import type { ManifestProvider } from '../../streaming/ManifestController';
+import type { HlsManifestData } from './HlsManifestData';
+export declare function createHlsManifestProvider(loadOptions: HlsTrackLoadOptions): HlsManifestProvider;
+export type HlsManifestProvider = ManifestProvider<HlsManifestData>;
+//# sourceMappingURL=createHlsManifestProvider.d.ts.map

package/dist/types/current/track/hls/createHlsManifestProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createHlsManifestProvider.d.ts","sourceRoot":"","sources":["../../../../../src/track/hls/createHlsManifestProvider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD,wBAAgB,yBAAyB,CACrC,WAAW,EAAE,mBAAmB,GACjC,mBAAmB,CAQrB;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAA"}

package/dist/types/current/track/hls/createHlsManifestProvider.js

@@ -0,0 +1,9 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { createUrlHlsManifestProvider } from './createUrlHlsManifestProvider';
+export function createHlsManifestProvider(loadOptions) {
+    return (loadOptions.manifestProvider ||
+        createUrlHlsManifestProvider(loadOptions.uri, loadOptions.requestInit || undefined));
+}

package/dist/types/current/track/hls/createUrlHlsManifestProvider.d.ts

@@ -1,6 +1,6 @@
-import type { MainPlaylist, MediaPlaylist } from '@amazon/vinyl-hls-parser';
+import type { HlsMainPlaylist, HlsMediaPlaylist } from '@amazon/vinyl-hls-parser';
 import type { Maybe, ReadonlyAbort, RequestInitOptions } from '@amazon/vinyl-util';
-import type { HlsManifestProvider } from './HlsManifestProvider';
+import type { HlsManifestProvider } from './createHlsManifestProvider';
 export declare function createUrlHlsManifestProvider(url: string, requestInit?: RequestInitOptions): HlsManifestProvider;
 export interface FetchMediaPlaylistOptions {
     /** The variant URI to resolve against the base URL. */
@@ -8,7 +8,7 @@ export interface FetchMediaPlaylistOptions {
     /** The base URL for resolving relative URIs. */
     readonly baseUrl: string;
     /** Variable definitions from the main playlist. */
-    readonly defines: MainPlaylist['defines'];
+    readonly defines: HlsMainPlaylist['defines'];
     /** Optional request configuration. */
     readonly requestInit?: Maybe<RequestInitOptions>;
     /** Optional abort signal. */
@@ -17,5 +17,5 @@ export interface FetchMediaPlaylistOptions {
 /**
  * Fetches and parses an HLS media playlist from a variant URI.
  */
-export declare function fetchMediaPlaylist(options: FetchMediaPlaylistOptions): Promise<MediaPlaylist>;
+export declare function fetchMediaPlaylist(options: FetchMediaPlaylistOptions): Promise<HlsMediaPlaylist>;
 //# sourceMappingURL=createUrlHlsManifestProvider.d.ts.map

package/dist/types/current/track/hls/createUrlHlsManifestProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createUrlHlsManifestProvider.d.ts","sourceRoot":"","sources":["../../../../../src/track/hls/createUrlHlsManifestProvider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAE3E,OAAO,KAAK,EACR,KAAK,EACL,aAAa,EACb,kBAAkB,EACrB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAER,mBAAmB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,wBAAgB,4BAA4B,CACxC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,kBAAkB,GACjC,mBAAmB,CA8BrB;AAED,MAAM,WAAW,yBAAyB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,CAAA;IACzC,sCAAsC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAChD,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CACxC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACnC,OAAO,CAAC,aAAa,CAAC,CAMxB"}
+{"version":3,"file":"createUrlHlsManifestProvider.d.ts","sourceRoot":"","sources":["../../../../../src/track/hls/createUrlHlsManifestProvider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,eAAe,EACf,gBAAgB,EACnB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,KAAK,EACR,KAAK,EACL,aAAa,EACb,kBAAkB,EACrB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEtE,wBAAgB,4BAA4B,CACxC,GAAG,EAAE,MAAM,EACX,WAAW,CAAC,EAAE,kBAAkB,GACjC,mBAAmB,CAiCrB;AAED,MAAM,WAAW,yBAAyB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IAC5C,sCAAsC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAA;IAChD,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CACxC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACpC,OAAO,EAAE,yBAAyB,GACnC,OAAO,CAAC,gBAAgB,CAAC,CAU3B"}

package/dist/types/current/track/hls/createUrlHlsManifestProvider.js

@@ -10,10 +10,10 @@ export function createUrlHlsManifestProvider(url, requestInit) {
             abort,
         });
         const mainText = await mainResponse.text();
-        const mainPlaylist = parseMainPlaylist(mainText);
         // Use the response URL (after redirects) as the base for resolving
-        // relative URIs in the manifest.
+        // relative URIs and for resolving #EXT-X-DEFINE:QUERYPARAM tokens.
         const baseUrl = mainResponse.url || url;
+        const mainPlaylist = parseMainPlaylist(mainText, parseQueryParams(baseUrl));
         const getMediaPlaylist = memoize((uri) => fetchMediaPlaylist({
             uri,
             baseUrl,
@@ -36,5 +36,24 @@ export async function fetchMediaPlaylist(options) {
     const variantUrl = resolveUrl(uri, baseUrl);
     const response = await requestWithRetry(variantUrl, requestInit, { abort });
     const text = await response.text();
-    return parseMediaPlaylist(text, defines);
+    // The resolved URL (after redirects) carries the query parameters that
+    // #EXT-X-DEFINE:QUERYPARAM entries resolve against (e.g. MediaTailor ad
+    // manifests). Fall back to the requested URL if the response omits it.
+    const queryParams = parseQueryParams(response.url || variantUrl);
+    return parseMediaPlaylist(text, defines, queryParams);
+}
+/**
+ * Extracts a URL's query parameters into a plain record for
+ * `#EXT-X-DEFINE:QUERYPARAM` resolution. Returns undefined when the URL has no
+ * query string so the parser can skip substitution entirely.
+ */
+function parseQueryParams(url) {
+    const queryStart = url.indexOf('?');
+    if (queryStart === -1)
+        return undefined;
+    const params = {};
+    const search = new URLSearchParams(url.substring(queryStart + 1));
+    for (const [key, value] of search)
+        params[key] = value;
+    return params;
 }

package/dist/types/current/track/hls/index.d.ts

@@ -1,4 +1,4 @@
-export * from './HlsManifestProvider';
+export * from './HlsManifestData';
 export * from './createUrlHlsManifestProvider';
 export * from './HlsManifestController';
 export * from './HlsMediaQualityMetadataResolver';

package/dist/types/current/track/hls/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/track/hls/index.ts"],"names":[],"mappings":"AAIA,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,yBAAyB,CAAA;AACvC,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mCAAmC,CAAA;AACjD,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/track/hls/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAA;AACjC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,yBAAyB,CAAA;AACvC,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mCAAmC,CAAA;AACjD,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA"}

package/dist/types/current/track/hls/index.js

@@ -1,7 +1,7 @@
 /*
  * Copyright (c) 2026. Amazon.com, Inc. or its affiliates. All rights reserved.
  */
-export * from './HlsManifestProvider';
+export * from './HlsManifestData';
 export * from './createUrlHlsManifestProvider';
 export * from './HlsManifestController';
 export * from './HlsMediaQualityMetadataResolver';

package/dist/types/current/track/inferLoadOptionsFromUri.d.ts

@@ -0,0 +1,15 @@
+import type { VinylTrackLoadOptions } from './createVinylTrackFactories';
+/**
+ * The built-in track types Vinyl can infer from a URI.
+ */
+export type TrackType = 'hls' | 'dash' | 'src';
+/**
+ * Infers the track type from a URI based first on its file extension
+ * then mime type.
+ *
+ * Returns null if the type cannot be determined.
+ */
+export declare function inferTrackTypeFromUrl(url: string): Promise<TrackType | null>;
+export declare function inferTrackTypeFromUrlPath(url: string): TrackType | null;
+export declare function createTrackLoadOptionsFromUrl(url: string): Promise<VinylTrackLoadOptions | null>;
+//# sourceMappingURL=inferLoadOptionsFromUri.d.ts.map

package/dist/types/current/track/inferLoadOptionsFromUri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferLoadOptionsFromUri.d.ts","sourceRoot":"","sources":["../../../../src/track/inferLoadOptionsFromUri.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAGxE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAE9C;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACvC,GAAG,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAE3B;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMvE;AAED,wBAAsB,6BAA6B,CAC/C,GAAG,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAKvC"}

package/dist/types/current/track/inferLoadOptionsFromUri.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { memoize, requestWithRetry } from '@amazon/vinyl-util';
+/**
+ * Infers the track type from a URI based first on its file extension
+ * then mime type.
+ *
+ * Returns null if the type cannot be determined.
+ */
+export async function inferTrackTypeFromUrl(url) {
+    return inferTrackTypeFromUrlPath(url) ?? (await probeType(url));
+}
+export function inferTrackTypeFromUrlPath(url) {
+    if (url.endsWith('.m3u8') || url.includes('.m3u8?'))
+        return 'hls';
+    if (url.endsWith('.mpd') || url.includes('.mpd?'))
+        return 'dash';
+    if (/\.(mp3|mp4|m4a|m4v|aac|ogg|opus|wav|webm)(\?|$)/i.test(url))
+        return 'src';
+    return null;
+}
+export async function createTrackLoadOptionsFromUrl(url) {
+    if (!url)
+        return null;
+    const type = await inferTrackTypeFromUrl(url);
+    if (!type)
+        return null;
+    return { uri: url, type };
+}
+/**
+ * Performs a HEAD request on the given URL to determine its track type by its
+ * content-type response.
+ * The result is cached.
+ */
+const probeType = memoize(async (url) => {
+    try {
+        const res = await requestWithRetry(url, { method: 'HEAD' });
+        if (!res.ok)
+            return null;
+        const mime = (res.headers.get('content-type') ?? '').toLowerCase();
+        if (mime.includes('dash+xml'))
+            return 'dash';
+        if (mime.includes('mpegurl'))
+            return 'hls';
+        if (mime.startsWith('video/') || mime.startsWith('audio/'))
+            return 'src';
+        return null;
+    }
+    catch {
+        return null;
+    }
+}, (url) => url, 
+/* capacity */ 30);

package/dist/types/current/track/mse/MseTrack.d.ts

@@ -1,5 +1,5 @@
-import { TrackBase, type TrackBaseDeps, type TrackBaseOptions } from '../TrackBase';
-import { type ReadonlyRanges, type ReadonlySet } from '@amazon/vinyl-util';
+import { TrackBase, type TrackBaseDeps } from '../TrackBase';
+import { type Maybe, type ReadonlyRanges, type ReadonlySet } from '@amazon/vinyl-util';
 import type { TrackPreloadOptions, TrackTypeId, TrackUri } from '../Track';
 import type { ContentType, MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
 import { type Factories } from '@amazon/vinyl-di';
@@ -9,7 +9,20 @@ import type { PlaybackSource } from '../../playback/PlaybackSource';
 import type { ContentTypesValue } from '../../streaming/ContentTypesValue';
 import type { ManifestController } from '../../streaming/ManifestController';
 import type { ObservableValue } from '@amazon/vinyl-observable';
-import type { MediaTimeline } from '../../streaming/MediaTimeline';
+import { type MediaTimeline } from '../../streaming/MediaTimeline';
+import type { TextTrackController } from '../../text/TextTrack';
+import type { TrackConfigOptions } from '../TrackFactory';
+import type { TrackAds } from '../../ad/AdBreakInfo';
+import type { VinylOptions } from '../../vinyl/VinylOptions';
+/**
+ * How long to wait after all streams have data before checking whether a seek
+ * is still stuck, in seconds.
+ */
+export declare const SEEKING_STALL_TIME_CHECK = 0.1;
+/**
+ * How far to nudge the playhead, in seconds, to recover a stuck seek.
+ */
+export declare const PLAYHEAD_NUDGE = 0.05;
 export type MseTrackDeps = TrackBaseDeps & {
     readonly contentTypesValue: ContentTypesValue;
     readonly contentStreamFactory: (contentType: ContentType) => ContentStream;
@@ -18,6 +31,21 @@ export type MseTrackDeps = TrackBaseDeps & {
     readonly playbackSource: PlaybackSource;
     readonly mediaTimeline: ObservableValue<Promise<MediaTimeline>>;
     readonly mediaTimelineTransformed: ObservableValue<Promise<MediaTimeline>>;
+    /**
+     * Optional sidecar text track controller for this track. When provided,
+     * the controller is exposed via {@link MseTrack.textTrackController} and
+     * disposed when the track itself is disposed.
+     */
+    readonly textTrackController?: TextTrackController | null;
+    /**
+     * Player options that re-select this track's audio/streams. A change (not
+     * the initial value) is applied to this track immediately so it takes
+     * effect without waiting for the buffered media to drain.
+     */
+    readonly preferredAudioLanguage: ObservableValue<VinylOptions['preferredAudioLanguage']>;
+    readonly allowedContentTypes: ObservableValue<VinylOptions['allowedContentTypes']>;
+    readonly preferDescriptiveAudio: ObservableValue<VinylOptions['preferDescriptiveAudio']>;
+    readonly abr: ObservableValue<VinylOptions['abr']>;
 };
 /**
  * An MseTrack uses media source extensions for streaming.
@@ -25,10 +53,11 @@ export type MseTrackDeps = TrackBaseDeps & {
 export declare class MseTrack extends TrackBase {
     get [Symbol.toStringTag](): string;
     protected readonly deps: MseTrackDeps;
+    get textTrackController(): TextTrackController | null;
     private readonly streams;
+    private stallNudgeTimer;
     private readonly disposeAbort;
     private lastPreloadOptions;
-    private activateOptions;
     private readonly allFetchedRanges;
     private readonly _fetchedRanges;
     private _contentTypes;
@@ -37,23 +66,44 @@ export declare class MseTrack extends TrackBase {
     private timeUpdateSub;
     private _cachedPeriod;
     constructor(uri: TrackUri, type: TrackTypeId, dependencyFactories: Factories<MseTrackDeps>);
+    /**
+     * Clears this track's buffers and rebuilds its streams so a changed
+     * audio/language/content-type selection applies immediately.
+     * {@link reset} with `hard` safely no-ops the rebuild for an inactive
+     * (cached) track.
+     */
+    private reloadStreams;
+    /**
+     * Re-dispatches a sub-controller's load span stamped with this track's uri,
+     * so the span attributes to the track that owns it at the source.
+     */
+    private dispatchLoadSpan;
     /**
      * Updates the cached qualities list from the transformed timeline for the current period.
      */
     private updateQualities;
+    getAds(): Promise<TrackAds>;
     /**
      * Updates the cached unfiltered qualities list from the raw timeline for the current period.
      */
     private updateQualitiesUnfiltered;
+    private updateSeekRanges;
+    /**
+     * Invokes a callback when the given timeline promise resolves and was not
+     * interrupted by that timeline changing or the track being disposed.
+     *
+     * Pass `mediaTimelineTransformed` for the playable (filtered) view or
+     * `mediaTimeline` for the raw, unfiltered view.
+     */
+    private withTimeline;
     /**
      * Creates and adds a content stream for the given content type.
      *
      * @param contentType
      */
     protected createStream(contentType: ContentType): void;
-    preload(trackOptions: TrackPreloadOptions, loadOptions: TrackBaseOptions): void;
+    preload(trackOptions: TrackPreloadOptions, loadOptions: Maybe<TrackConfigOptions>): void;
     get contentTypes(): ReadonlySet<ContentType>;
-    set contentTypes(value: ReadonlySet<ContentType>);
     get qualities(): readonly MediaQualityMetadata[] | null;
     get qualitiesUnfiltered(): readonly MediaQualityMetadata[] | null;
     get fetchedRanges(): ReadonlyRanges;
@@ -67,8 +117,8 @@ export declare class MseTrack extends TrackBase {
      * Resets the track to recover from error states.
      * Resets both the segment controller and buffering controller to clear failed segments and error conditions.
      */
-    reset(): void;
-    onActivated(loadOptions: TrackBaseOptions): void;
+    reset(hard?: boolean): void;
+    onActivated(loadOptions: Maybe<TrackConfigOptions>): void;
     onDeactivated(): void;
     getStreamingQuality(contentType: ContentType): MediaQualityMetadata | null;
     getBufferingQuality(contentType: ContentType): MediaQualityMetadata | null;
@@ -80,6 +130,14 @@ export declare class MseTrack extends TrackBase {
     private getStream;
     private clearStreams;
     get bufferingEnded(): boolean;
+    /**
+     * A seek only completes once every stream has data at the target, but on
+     * some platforms the element can stay stuck `seeking` even after that. Once
+     * all streams hold data, if we're still seeking a moment later, nudge the
+     * playhead to prod the element into completing the seek.
+     */
+    private checkStalledSeek;
+    private setContentTypes;
     dispose(): void;
 }
 //# sourceMappingURL=MseTrack.d.ts.map

package/dist/types/current/track/mse/MseTrack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MseTrack.d.ts","sourceRoot":"","sources":["../../../../../src/track/mse/MseTrack.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MseTrack.d.ts","sourceRoot":"","sources":["../../../../../src/track/mse/MseTrack.ts"],"names":[],"mappings":"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"}