@amazon/vinyl 3.0.1 → 3.1.0

package/dist/types/current/util/media/mimeType.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Extracts the container subtype from a MIME type, lowercased — the portion
+ * after the `/`, ignoring any parameters. For example
+ * `video/webm; codecs="vp9"` → `webm` and `audio/mp4` → `mp4`. Returns an empty
+ * string when the MIME type has no subtype.
+ */
+export declare function mimeSubtype(mimeType: string): string;
+//# sourceMappingURL=mimeType.d.ts.map

package/dist/types/current/util/media/mimeType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimeType.d.ts","sourceRoot":"","sources":["../../../../../src/util/media/mimeType.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/types/current/util/media/mimeType.js

@@ -0,0 +1,13 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Extracts the container subtype from a MIME type, lowercased — the portion
+ * after the `/`, ignoring any parameters. For example
+ * `video/webm; codecs="vp9"` → `webm` and `audio/mp4` → `mp4`. Returns an empty
+ * string when the MIME type has no subtype.
+ */
+export function mimeSubtype(mimeType) {
+    return mimeType.split(';', 1)[0].trim().toLowerCase().split('/')[1] ?? '';
+}

package/dist/types/current/vinyl/createVinylFactories.d.ts

@@ -1,6 +1,6 @@
 import type { CapabilitiesImplDeps } from '../client/CapabilitiesImpl';
 import { CapabilitiesImpl } from '../client/CapabilitiesImpl';
-import type { Merge, PartialDeep, PatchedRef } from '@amazon/vinyl-util';
+import type { Merge, PartialDeep } from '@amazon/vinyl-util';
 import { noop } from '@amazon/vinyl-util';
 import type { PlaybackControllerImplDeps, PlaybackControllerImplOptions } from '../playback/PlaybackControllerImpl';
 import { PlaybackControllerImpl } from '../playback/PlaybackControllerImpl';
@@ -9,7 +9,6 @@ import { PlaybackSourceImpl } from '../playback/PlaybackSourceImpl';
 import { type VinylTrackFactoryDeps } from '../track/createVinylTrackFactories';
 import type { TrackControllerImplDeps, TrackControllerImplOptions } from '../track/TrackController';
 import { TrackControllerImpl } from '../track/TrackController';
-import type { VinylPatchOptions } from './VinylPatchOptions';
 import { type QualitySelectorImplOptions } from '../streaming/abr/QualitySelectorImpl';
 import { AdControllerImpl, type AdControllerImplDeps, type AdControllerImplOptions } from '../ad/AdControllerImpl';
 import { type MediaTextTrackProvider } from '../text/mediaTextTrackProvider';
@@ -41,11 +40,6 @@ export interface VinylDependencyOptions {
      * `'hidden'`; without one they render natively. See `TextTrackRenderer`.
      */
     readonly textTrackRenderer?: TextTrackRenderer;
-    /**
-     * Flags for patches that should be applied browser-specifically.
-     * These will be defaulted based on the user-agent.
-     */
-    readonly patches?: PartialDeep<VinylPatchOptions>;
     /**
      * Configuration for the track controller.
      */
@@ -82,12 +76,7 @@ export interface VinylDependencyOptions {
  */
 export declare function createVinylFactories(options: VinylDependencyOptions): NoInfer<{
     options: (_deps: import("@amazon/vinyl-util").AnyRecord, add: import("@amazon/vinyl-util").AddDisposable) => import("@amazon/vinyl-observable").MutableValue<VinylOptions>;
-    patchedMedia: () => PatchedRef<HTMLMediaElement>;
-    media: (deps: {
-        readonly patchedMedia: {
-            readonly patched: HTMLMediaElement;
-        };
-    }) => HTMLMediaElement;
+    media: () => HTMLMediaElement;
     textTrackProvider: (deps: {
         readonly media: HTMLMediaElement;
     }) => MediaTextTrackProvider;
@@ -153,7 +142,7 @@ export declare function createVinylFactories(options: VinylDependencyOptions): N
             readonly manifestTransformed: ObservableValue<Promise<import("..").DashManifestData>>;
             readonly options: ObservableValue<Pick<VinylOptions, "text">>;
         }) => import("..").SidecarTextTrackController;
-        options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "audio" | "text" | "abr" | "allowedContentTypes">>>;
+        options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "text" | "audio" | "abr" | "allowedContentTypes">>>;
         playbackController: import("@amazon/vinyl-di").Factory<import("..").PlaybackController>;
         playbackSource: import("@amazon/vinyl-di").Factory<import("..").PlaybackSource>;
         drmKeySystemResolver: import("@amazon/vinyl-di").Factory<import("..").DrmKeySystemResolver>;
@@ -165,7 +154,9 @@ export declare function createVinylFactories(options: VinylDependencyOptions): N
         textTrackRenderer: import("@amazon/vinyl-di").Factory<TextTrackRenderer | null>;
         adController: import("@amazon/vinyl-di").Factory<import("..").AdController>;
     }>;
-    createHlsFactories: (deps: import("..").HlsFactoryDeps) => (loadOptions: import("..").HlsTrackLoadOptions) => NoInfer<{
+    createHlsFactories: (deps: import("..").HlsFactoryDeps) => (loadOptions: import("..").HlsTrackLoadOptions /**
+     * Configuration for adaptive bitrate switching.
+     */) => NoInfer<{
         baseContentTypesValue: typeof import("..").createHlsContentTypesValue;
         contentTypesValue: typeof import("..").createAllowedContentTypesValue;
         manifestProvider: () => import("..").HlsManifestProvider;
@@ -208,7 +199,7 @@ export declare function createVinylFactories(options: VinylDependencyOptions): N
             readonly manifestTransformed: ObservableValue<Promise<import("..").HlsManifestData>>;
             readonly options: ObservableValue<Pick<VinylOptions, "text">>;
         }) => import("..").SidecarTextTrackController;
-        options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "audio" | "text" | "abr" | "allowedContentTypes">>>;
+        options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "text" | "audio" | "abr" | "allowedContentTypes">>>;
         playbackController: import("@amazon/vinyl-di").Factory<import("..").PlaybackController>;
         playbackSource: import("@amazon/vinyl-di").Factory<import("..").PlaybackSource>;
         drmKeySystemResolver: import("@amazon/vinyl-di").Factory<import("..").DrmKeySystemResolver>;

package/dist/types/current/vinyl/createVinylFactories.d.ts.map

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

package/dist/types/current/vinyl/createVinylFactories.js

@@ -3,14 +3,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { CapabilitiesImpl } from '../client/CapabilitiesImpl';
-import { mergeDeep, noop } from '@amazon/vinyl-util';
-import { patchMediaElement } from '../patch/media/patchMediaElement';
+import { noop } from '@amazon/vinyl-util';
 import { PlaybackControllerImpl } from '../playback/PlaybackControllerImpl';
 import { PlaybackSourceImpl } from '../playback/PlaybackSourceImpl';
 import { createVinylTrackFactories, } from '../track/createVinylTrackFactories';
 import { TrackControllerImpl } from '../track/TrackController';
 import { createTrackFactory } from '../track/TrackFactory';
-import { defaultPatchOptions } from './VinylPatchOptions';
 import { AdControllerImpl, } from '../ad/AdControllerImpl';
 import { createDashFactories } from '../track/dash/createDashFactories';
 import { createHlsFactories } from '../track/hls/createHlsFactories';
@@ -30,17 +28,9 @@ import { defaultAdLoadOptionsResolver } from '../ad/defaultAdLoadOptionsResolver
  * @param options
  */
 export function createVinylFactories(options) {
-    const patches = mergeDeep([
-        defaultPatchOptions.value,
-        options.patches ?? {},
-    ]);
     return validateFactories({
         options: playerConfigFactory(defaultVinylOptions, vinylOptionsValidator),
-        patchedMedia: () => {
-            // Patches the media element if necessary.
-            return patchMediaElement(options.media, patches.media);
-        },
-        media: (deps) => deps.patchedMedia.patched,
+        media: () => options.media,
         // One provider per media element (the player container creates each
         // dependency once), so text tracks are reused rather than accumulated.
         textTrackProvider: (deps) => createMediaTextTrackProvider({ media: deps.media }),

package/dist/types/ts3.7/drm/DrmControllerImpl.d.ts

@@ -65,6 +65,8 @@ export declare class DrmControllerImpl extends EventHostImpl<DrmControllerEventM
      */
     private maybeCreateSession;
     initializeForPlayback(drmInfo: MediaFormatMetadata | null, options?: DrmPlaybackOptions): void;
+    /** True when the manifest carried pssh (sessions come from it, not events). */
+    private manifestProvidesInitData;
     setBufferingDrmInfo(drmInfo: MediaFormatMetadata | null, options?: DrmPlaybackOptions): void;
     /**
      * If the drm metadata contains initialization data for the current key system, create a new session.

package/dist/types/ts3.7/index.d.ts

@@ -38,11 +38,8 @@ export * from './global/environment';
 export * from './global/globalRef';
 export * from './global/initializeVinylGlobal';
 export * from './global/PlayerRegistry';
-export * from './patch/media/HtmlMediaElementPatch';
-export * from './patch/media/MediaElementPatchOptions';
-export * from './patch/media/patches/createPreventStallsPatch';
-export * from './patch/media/patches/createUnreliablePlaybackEventsPatch';
-export * from './patch/media/patchMediaElement';
+export * from './playback/createStallDetector';
+export * from './playback/createStallMonitor';
 export * from './playback/error/InvalidSeekError';
 export * from './playback/error/ReportableMediaError';
 export * from './playback/logging/mediaErrorToJson';
@@ -150,12 +147,12 @@ export * from './util/media/codecOverrides';
 export * from './util/media/codecSupport';
 export * from './util/media/getAudioContext';
 export * from './util/media/mediaSource';
+export * from './util/media/mimeType';
 export * from './util/media/sourceBuffer';
 export * from './vinyl/createVinylFactories';
 export * from './vinyl/playerConfigFactory';
 export * from './vinyl/ReadonlyPlaybackStreamingState';
 export * from './vinyl/VinylDeps';
 export * from './vinyl/VinylOptions';
-export * from './vinyl/VinylPatchOptions';
 export * from './vinyl/VinylPlayer';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/ts3.7/playback/PlaybackControllerImpl.d.ts

@@ -29,12 +29,19 @@ export interface PlaybackControllerImplOptions {
      * Default: 30
      */
     readonly seekTimeout: number;
+    /**
+     * The number of seconds the play head must be frozen while playing before a stall is reported
+     * via the `stallEntered`/`stallEnded` events.
+     * Default: 1
+     */
+    readonly stallThreshold: number;
 }
 export declare const defaultPlaybackControllerImplOptions: {
     readonly loopTimeAffordance: 2;
     readonly minSeekableBuffer: -1;
     readonly playTimeout: 30;
     readonly seekTimeout: 30;
+    readonly stallThreshold: 1;
 };
 /**
  * Safari and Edge Legacy cannot reliably seek close to the end of a seekable range.
@@ -57,6 +64,7 @@ export declare class PlaybackControllerImpl extends EventHostImpl<PlaybackContro
     private _seeking;
     private _waiting;
     private _seekId;
+    private stopStallDetection;
     private userVolume;
     private _pendingPlay;
     private playAbort;
@@ -153,6 +161,13 @@ export declare class PlaybackControllerImpl extends EventHostImpl<PlaybackContro
     pause(): void;
     private get pendingPlay();
     private set pendingPlay(value);
+    /**
+     * Starts (or restarts) the stall detector: recovers a play head that stays frozen when it
+     * should be advancing — some WebKit versions never resume after a seek or a play, e.g. after a
+     * buffer-flushing seek. Superseded by the next seek/play and stopped on dispose.
+     * @private
+     */
+    private startStallDetection;
     play(): Promise<void>;
     get canPlay(): boolean;
     get canPlayThrough(): boolean;

package/dist/types/ts3.7/playback/ReadonlyPlaybackController.d.ts

@@ -194,6 +194,19 @@ export interface PlaybackControllerEventMap {
      * true and the media is seeking a new position.
      */
     readonly seeking: AnyRecord;
+    /**
+     * Fired when the play head has been detected as frozen while playing — i.e. no `timeUpdate`
+     * was observed for longer than the stall threshold. Only emitted once playback has actually
+     * been observed (a `playing` event), so it is not emitted during initial loading or while
+     * awaiting a seek. Each stall is bracketed by a `stallEntered`/{@link stallEnded} pair.
+     */
+    readonly stallEntered: AnyRecord;
+    /**
+     * Fired when a stall (see {@link stallEntered}) has ended, for any reason. `started` is the
+     * time of the last `timeUpdate` observed before the play head froze, and `duration` is the
+     * total number of seconds the play head was frozen.
+     */
+    readonly stallEnded: OperationCompletedEvent<StallEndedReason>;
     /**
      * Fired when the time indicated by the currentTime attribute has been updated.
      */
@@ -241,6 +254,19 @@ export declare const waitedReasons: readonly [
     WaitedReason.EMPTIED,
     WaitedReason.SEEKING
 ];
+/**
+ * Reasons a stall (see {@link PlaybackControllerEventMap.stallEntered}) has ended.
+ */
+export declare enum StallEndedReason {
+    /** The play head advanced again — playback resumed. */
+    PLAYING = "playing",
+    /** Playback was paused. */
+    PAUSE = "pause",
+    /** A seek started. */
+    SEEKING = "seeking",
+    /** The media was emptied (e.g. unloaded/reloaded). */
+    EMPTIED = "emptied"
+}
 export declare const ALL_PLAYBACK_STATE_EVENTS: readonly [
     "abort",
     "canPlay",
@@ -267,6 +293,8 @@ export declare const ALL_PLAYBACK_STATE_EVENTS: readonly [
     "resize",
     "seeked",
     "seeking",
+    "stallEntered",
+    "stallEnded",
     "timeUpdate",
     "volumeChange",
     "waited",

package/dist/types/ts3.7/playback/createStallDetector.d.ts

@@ -0,0 +1,43 @@
+export interface StallDetectorOptions {
+    /**
+     * Called when playback resumes without emitting a `playing` event (or after the detector
+     * revived it), so the caller can announce playback.
+     */
+    readonly fabricatePlaying: () => void;
+    /** Poll interval in seconds. Default: 0.25 */
+    readonly pollInterval?: number;
+    /** Seconds the play head must be frozen before recovering. Default: 0.75 */
+    readonly stallThreshold?: number;
+    /**
+     * Don't nudge this close to the end of buffered data; a freeze there is a
+     * legitimate wait for more data. Seconds. Default: 0.5
+     */
+    readonly bufferEndMargin?: number;
+    /** Seconds to nudge the play head forward to prod a resume. Default: 0.1 */
+    readonly stallSkip?: number;
+    /** Max recovery attempts before giving up. Default: 3 */
+    readonly maxAttempts?: number;
+    /**
+     * Nudge even when the playhead isn't inside a buffered range. Some WebKit versions leave a
+     * seek perpetually pending (no `seeked`) with a stale empty `buffered` even though data is
+     * appended; re-issuing the seek via a nudge can complete it. Off by default (only nudge over
+     * genuinely buffered data). Default: false
+     */
+    readonly nudgeUnbuffered?: boolean;
+}
+/**
+ * Watches a media element after a seek/play and drives it back into a playing state. Some WebKit
+ * versions stall: the play head freezes inside buffered data and playback never resumes (often with
+ * a stale low readyState). This polls the play head and, while the element should be advancing:
+ *
+ * - if it's frozen inside buffered data, nudges currentTime forward to prod a resume;
+ * - if there's no data at the playhead, waits (it's legitimately buffering, or between sources).
+ *
+ * When the play head progresses it calls {@link StallDetectorOptions.fabricatePlaying} if playback
+ * resumed without a `playing` event (or after the detector revived it), then stops. It also stops
+ * on pause/ended/emptied or after {@link StallDetectorOptions.maxAttempts}.
+ *
+ * Start it after a seek or play only when playback is intended — a paused element won't advance.
+ */
+export declare function createStallDetector(media: HTMLMediaElement, options: StallDetectorOptions): () => void;
+//# sourceMappingURL=createStallDetector.d.ts.map

package/dist/types/ts3.7/playback/createStallMonitor.d.ts

@@ -0,0 +1,45 @@
+import { Timestamp } from '@amazon/vinyl-util';
+import { ReadonlyPlaybackController } from './ReadonlyPlaybackController';
+import { StallEndedReason } from './ReadonlyPlaybackController';
+export interface StallMonitorOptions {
+    /**
+     * Seconds the play head must be frozen (no `timeUpdate`) while playing before a stall is
+     * reported. Default: 1
+     */
+    readonly stallThreshold?: number;
+    /**
+     * How often (seconds) the play head freeze is checked. Default: 0.25
+     */
+    readonly pollInterval?: number;
+}
+export interface StallEndedInfo {
+    /** Time of the last `timeUpdate` observed before the play head froze. */
+    readonly started: Timestamp;
+    /** Time the stall ended. */
+    readonly ended: Timestamp;
+    /** Total seconds the play head was frozen. */
+    readonly duration: number;
+    /** Why the stall ended. */
+    readonly reason: StallEndedReason;
+}
+export interface StallMonitorCallbacks {
+    /** Called when a stall is first detected. */
+    readonly onStallEntered: () => void;
+    /** Called when a detected stall ends. */
+    readonly onStallEnded: (info: StallEndedInfo) => void;
+}
+/**
+ * Watches a {@link ReadonlyPlaybackController} for stalls while playing: the play head freezing
+ * (no `timeUpdate`) for longer than {@link StallMonitorOptions.stallThreshold} seconds.
+ *
+ * Detection only runs once playback has actually been observed (a `playing` event) and is
+ * suspended on `pause`/`seeking`/`emptied` until playback is observed again — so a stall is never
+ * reported during initial loading or while awaiting a seek. A detected stall ends when the play
+ * head advances again (`playing`) or playback stops for another reason (`pause`/`seeking`/
+ * `emptied`); {@link StallEndedInfo.duration} is measured from the last `timeUpdate` before the
+ * freeze, so it reflects the full frozen time rather than only the time past the threshold.
+ *
+ * Returns a function that stops the monitor.
+ */
+export declare function createStallMonitor(controller: ReadonlyPlaybackController, callbacks: StallMonitorCallbacks, options?: StallMonitorOptions): () => void;
+//# sourceMappingURL=createStallMonitor.d.ts.map

package/dist/types/ts3.7/streaming/AudioOptions.d.ts

@@ -1,4 +1,5 @@
 import { ObjectSchema } from '@amazon/vinyl-validation';
+import { Maybe } from '@amazon/vinyl-util';
 /**
  * Criteria used to pick which audio rendition to play.
  */
@@ -33,6 +34,32 @@ export interface AudioOptions {
      * The audio selection criteria (language / descriptive).
      */
     readonly selection?: AudioSelection;
+    /**
+     * When `true`, disables the audio sampling-rate support filter, so audio
+     * renditions whose sampling rate exceeds what the platform reports (via the
+     * `AudioContext` output rate) are kept and offered to playback anyway.
+     * `false` (the default) applies the filter. Changing this re-filters the
+     * timeline immediately.
+     */
+    readonly disableSampleRateFilter?: boolean;
+    /**
+     * The maximum audio sampling rate (Hz) the sampling-rate filter treats as
+     * supported. When set, it takes precedence over the platform's
+     * `AudioContext`-reported output rate. Ignored when
+     * {@link disableSampleRateFilter} is `true`. Changing this re-filters the
+     * timeline immediately. `null`/`undefined` falls back to the reported rate.
+     */
+    readonly maxSampleRate?: Maybe<number>;
+    /**
+     * The minimum audio sampling rate (Hz) the sampling-rate filter treats as
+     * supported. When set, renditions below it are filtered out as a soft floor
+     * (if every audio rendition is below it, the highest is kept so playback is
+     * never stranded). Applied alongside the max cap whenever the filter runs,
+     * regardless of how the max was determined; ignored when
+     * {@link disableSampleRateFilter} is `true`. Changing this re-filters the
+     * timeline immediately.
+     */
+    readonly minSampleRate?: Maybe<number>;
 }
 export declare const defaultAudioOptions: AudioOptions;
 export declare const audioOptionsValidator: ObjectSchema<AudioOptions>;

package/dist/types/ts3.7/streaming/ContentStream.d.ts

@@ -38,10 +38,6 @@ export interface ContentStream extends ReadonlyEventHost<StreamingEventMap>, Dis
      * True if the last segment has been appended.
      */
     readonly bufferingEnded: boolean;
-    /**
-     * True while this stream's buffer holds any data.
-     */
-    readonly hasData: boolean;
     /**
      * Starts prefetching with the given priority and prefetch start time.
      * @param options
@@ -96,7 +92,6 @@ export declare class ContentStreamImpl extends EventHostImpl<StreamingEventMap>
     get streamingQuality(): (MediaQualityMetadata | null);
     get bufferingQuality(): (MediaQualityMetadata | null);
     get playbackQuality(): (MediaQualityMetadata | null);
-    get hasData(): boolean;
     get bufferingEnded(): boolean;
     get error(): (Error | null);
     /**

package/dist/types/ts3.7/streaming/StreamingEventMap.d.ts

@@ -34,10 +34,6 @@ export interface StreamingEventMap {
      * The last segment has finished appending.
      */
     readonly bufferingEnded: AnyRecord;
-    /**
-     * The buffer went from empty to holding data, or back to empty.
-     */
-    readonly hasDataChange: ChangeEvent<boolean>;
     /**
      * Dispatched when a streaming error occurs.
      */
@@ -97,7 +93,6 @@ export declare const ALL_STREAMING_EVENTS: readonly [
     "bufferingQualityChange",
     "playbackQualityChange",
     "bufferingEnded",
-    "hasDataChange",
     "error",
     "reset",
     "qualitiesChange",

package/dist/types/ts3.7/streaming/buffering/BufferingController.d.ts

@@ -44,10 +44,6 @@ export interface BufferingControllerEventMap {
      * The last segment has finished appending.
      */
     readonly bufferingEnded: AnyRecord;
-    /**
-     * The buffer went from empty to holding data, or back to empty.
-     */
-    readonly hasDataChange: ChangeEvent<boolean>;
     /**
      * A codec the browser reported as supported failed to decode on append and
      * has been denylisted. Dispatched instead of `error` so the media can be
@@ -83,10 +79,6 @@ export interface BufferingController extends ReadonlyEventHost<BufferingControll
      * True if the stream has buffered the last segment.
      */
     readonly bufferingEnded: boolean;
-    /**
-     * True while the buffer holds any data (false when empty or cleared).
-     */
-    readonly hasData: boolean;
     /**
      * Begins buffering.
      */
@@ -163,7 +155,6 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
     private reopen;
     private _error;
     private _bufferingEnded;
-    private _hasData;
     private readonly queue;
     private disposer;
     private _active;
@@ -224,8 +215,6 @@ export declare class BufferingControllerImpl extends EventHostImpl<BufferingCont
      */
     private get mediaSourceClosed();
     get bufferingEnded(): boolean;
-    get hasData(): boolean;
-    private setHasData;
     private readonly handleError;
     /**
      * Attempts to recover from a SourceBuffer decode/append failure caused by a

package/dist/types/ts3.7/track/dash/DashMediaQualityMetadataResolver.d.ts

@@ -20,13 +20,17 @@ export interface DashMediaQualityMetadataResolverDeps {
 }
 export declare function createMediaQualityMetadataFromDashRepresentation(representation: RepresentationType, deps: DashMediaQualityMetadataResolverDeps): MediaQualityMetadata;
 /**
- * Estimates the total bandwidth a representation would use when paired with
- * proportionally matched qualities from sibling content types.
+ * Estimates the total bandwidth a representation uses alongside sibling content
+ * types, pairing it with the cheapest sibling rendition in its proportional
+ * bucket.
  *
- * For each sibling content type, the representation's relative position within its own
- * content type's sorted bandwidth list is mapped to the corresponding position in the
- * sibling's list. This produces realistic pairings — e.g. with video [v1,v2,v3,v4] and
- * audio [a1,a2], v1 pairs with a1, v2 with a1, v3 with a2, v4 with a2.
+ * Each content type's sorted list is split into as many buckets as this
+ * representation's own list has tiers; the representation is paired with the
+ * cheapest sibling rendition in the matching bucket. A stream with few tiers
+ * therefore stays selected across the span of a finer sibling's tiers (e.g. the
+ * top audio across the top half of video tiers) rather than being pinned to a
+ * single endpoint — with video [v1..v4] and audio [a1,a2], a1's bucket is
+ * v1..v2 so a1 pairs with v2, and a2's bucket is v3..v4 so a2 pairs with v4.
  */
 export declare function estimatePeakBandwidth(representation: RepresentationType, contentType: ContentType): number;
 /**

package/dist/types/ts3.7/track/dash/createDashFactories.d.ts

@@ -107,7 +107,7 @@ export declare function createDashFactories(options: Maybe<DashInitOptions>): (d
         readonly manifestTransformed: ObservableValue<Promise<DashManifestData>>;
         readonly options: ObservableValue<Pick<VinylOptions, "text">>;
     }) => SidecarTextTrackController;
-    options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "audio" | "text" | "abr" | "allowedContentTypes">>>;
+    options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "text" | "audio" | "abr" | "allowedContentTypes">>>;
     playbackController: import("@amazon/vinyl-di").Factory<PlaybackController>;
     playbackSource: import("@amazon/vinyl-di").Factory<PlaybackSource>;
     drmKeySystemResolver: import("@amazon/vinyl-di").Factory<DrmKeySystemResolver>;

package/dist/types/ts3.7/track/dash/util/mpd.d.ts

@@ -36,6 +36,12 @@ export declare function calculatePeriodTimeRange(period: PeriodType): PeriodRang
  *
  * In a static presentation, the first period SHALL start at the zero point of the MPD timeline (with a
  * Period@start value of 0 seconds).
+ *
+ * When `Period@start` is absent, the start is derived from the sum of the
+ * preceding periods' `Period@duration` values, per the PeriodStart derivation
+ * in ISO/IEC 23009-1 §5.3.2.1. This is common in on-demand manifests that
+ * declare only per-period durations (no explicit `@start`, no
+ * `MPD@mediaPresentationDuration`).
  */
 export declare function calculatePeriodStart(period: PeriodType): number;
 /**

package/dist/types/ts3.7/track/filters/resourceTypeFilter.d.ts

@@ -3,6 +3,10 @@ import { MediaFormatMetadata } from '../../streaming/MediaQualityMetadata';
 export declare function throwMimeTypesUnsupported(): never;
 /**
  * Returns true when the media's codec and container is supported.
+ *
+ * Both ISO-BMFF (MP4/fMP4) and WebM containers are supported: the DASH
+ * `SegmentBase` indexer reads ISO-BMFF `sidx` boxes or WebM EBML `Cues` as
+ * appropriate, and MSE appends each to a matching SourceBuffer.
  */
 export declare function canPlayMimeType(deps: {
     readonly capabilities: Capabilities;

package/dist/types/ts3.7/track/filters/sampleRateFilter.d.ts

@@ -1,13 +1,27 @@
 import { MediaQualityMetadata } from '../../streaming/MediaQualityMetadata';
 import { Capabilities } from '../../client/Capabilities';
 export declare function throwSamplingRatesUnsupported(): never;
+export interface AudioSampleRateRangeOptions {
+    readonly capabilities: Capabilities;
+    /**
+     * An explicit maximum sampling rate that takes precedence over the
+     * platform's `AudioContext`-reported output rate when set.
+     */
+    readonly maxSampleRate?: number | null;
+    /** An optional minimum sampling-rate floor. */
+    readonly minSampleRate?: number | null;
+}
 /**
- * Returns true when the media's sampling rate is supported.
- * If Firefox (which does not support >48kHz), filter out all sampling rates above the supported sampling rate.
- * All other browsers filter out all sampling rates above the supported sampling rate unless this will filter all
- * and then do not filter the lowest sampling rate.
+ * Returns true when the media's sampling rate is within the supported range.
+ * Only audio content types are gated; every other content type passes through.
+ *
+ * The upper bound is `maxSampleRate` when set, otherwise the platform's
+ * `AudioContext`-reported output rate (Firefox is hard-capped at 48kHz, which it
+ * cannot decode beyond via MSE). The optional lower bound is `minSampleRate`.
+ * Both bounds are soft: if every audio rendition is above the max the lowest is
+ * kept, and if every audio rendition is below the min the highest is kept, so
+ * playback is never stranded. Only audio renditions count toward those
+ * fallbacks — a co-present video quality (no audio rate) never influences them.
  */
-export declare function supportsAudioSamplingRate(deps: {
-    readonly capabilities: Capabilities;
-}, metadata: MediaQualityMetadata, _index: number, array: ArrayLike<MediaQualityMetadata>): boolean;
+export declare function withinAudioSampleRateRange(options: AudioSampleRateRangeOptions, metadata: MediaQualityMetadata, _index: number, array: ArrayLike<MediaQualityMetadata>): boolean;
 //# sourceMappingURL=sampleRateFilter.d.ts.map

package/dist/types/ts3.7/track/hls/createHlsFactories.d.ts

@@ -96,7 +96,7 @@ export declare function createHlsFactories(options: Maybe<HlsInitOptions>): (dep
         readonly manifestTransformed: ObservableValue<Promise<HlsManifestData>>;
         readonly options: ObservableValue<Pick<VinylOptions, "text">>;
     }) => SidecarTextTrackController;
-    options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "audio" | "text" | "abr" | "allowedContentTypes">>>;
+    options: import("@amazon/vinyl-di").Factory<ObservableValue<Pick<VinylOptions, "text" | "audio" | "abr" | "allowedContentTypes">>>;
     playbackController: import("@amazon/vinyl-di").Factory<PlaybackController>;
     playbackSource: import("@amazon/vinyl-di").Factory<PlaybackSource>;
     drmKeySystemResolver: import("@amazon/vinyl-di").Factory<DrmKeySystemResolver>;