@amazon/vinyl 1.1.1 → 2.0.0

package/dist/types/ts4.7/drm/util/unpackPlayReadyChallenge.d.ts

@@ -41,6 +41,11 @@ interface HttpHeaderType {
     readonly name: ContentType;
     readonly value: ContentType;
 }
+/**
+ * Parses a PlayReady SOAP key message.
+ *
+ * @internal Exported for unit testing; not part of the public API.
+ */
 export declare function parsePlayReadyKeyMessage(xmlStr: string): PlayReadyMessage & XmlElement<PlayReadyMessage>;
 export {};
 //# sourceMappingURL=unpackPlayReadyChallenge.d.ts.map

package/dist/types/ts4.7/global/environment.d.ts

@@ -1,6 +1,10 @@
+declare global {
+    var __VINYL_VERSION__: string | undefined;
+}
 /**
- * process.env.VINYL_VERSION will be null in node unit tests, but in the built library it is
- * replaced by the webpack DefinePlugin with the package.version.
+ * `globalThis.__VINYL_VERSION__` is replaced at build time with the package.version via
+ * esbuild's `define` option. In unit tests and unbundled dev builds the replacement does not
+ * happen and the global is undefined, so we fall through to a placeholder version.
  */
 export declare const vinylVersion: import("@amazon/vinyl-util").Version;
 //# sourceMappingURL=environment.d.ts.map

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

@@ -1,132 +1,157 @@
 /** Auto-generated from build scripts */
-export * from './vinyl/playerConfigFactory';
-export * from './vinyl/createVinylFactories';
-export * from './vinyl/VinylPlayer';
-export * from './vinyl/VinylPatchOptions';
-export * from './vinyl/VinylOptions';
-export * from './vinyl/VinylDeps';
-export * from './vinyl/ReadonlyPlaybackStreamingState';
-export * from './util/media/sourceBuffer';
-export * from './util/media/mediaSource';
-export * from './util/media/getAudioContext';
-export * from './track/createVinylTrackFactories';
-export * from './track/createSegmentDataProvider';
-export * from './track/TrackFactory';
-export * from './track/TrackController';
-export * from './track/TrackBase';
-export * from './track/Track';
+export * from './ad/AdBreakInfo';
+export * from './ad/AdController';
+export * from './ad/AdControllerImpl';
+export * from './ad/AdError';
+export * from './ad/AdsProvider';
+export * from './ad/defaultAdLoadOptionsResolver';
+export * from './ad/discoverHlsInterstitials';
+export * from './client/Capabilities';
+export * from './client/CapabilitiesImpl';
+export * from './client/Client';
+export * from './drm/CencEncryptionScheme';
+export * from './drm/commonEme/CommonEme';
+export * from './drm/commonEme/CommonEmeFactory';
+export * from './drm/commonEme/createDrmErrorHandler';
+export * from './drm/commonEme/EncryptedInitData';
+export * from './drm/commonEme/MsCommonEme';
+export * from './drm/commonEme/StandardCommonEme';
+export * from './drm/commonEme/WebKitCommonEme';
+export * from './drm/dom/HTMLMediaElement';
+export * from './drm/dom/MSMediaKeys';
+export * from './drm/dom/WebKitMediaKeys';
+export * from './drm/DrmController';
+export * from './drm/DrmControllerImpl';
+export * from './drm/DrmKeySystem';
+export * from './drm/DrmKeySystemResolver';
+export * from './drm/DrmOptions';
+export * from './drm/error/DrmError';
+export * from './drm/licenseProvider/defaultLicenseProvider';
+export * from './drm/licenseProvider/LicenseProvider';
+export * from './drm/util/createFairPlaySessionInitData';
+export * from './drm/util/extractContentId';
+export * from './drm/util/unpackPlayReadyChallenge';
+export * from './event/BasicErrorEvent';
+export * from './event/ChangeEvent';
+export * from './global/configureVinylGlobal';
+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/error/InvalidSeekError';
+export * from './playback/error/ReportableMediaError';
+export * from './playback/logging/mediaErrorToJson';
+export * from './playback/logging/playbackStateLoggingHandler';
+export * from './playback/loudness/LoudnessNormalizationController';
+export * from './playback/loudness/LoudnessNormalizationControllerImpl';
+export * from './playback/loudness/LoudnessNormalizationControllerImplOptions';
+export * from './playback/nextHasMetadata';
+export * from './playback/PlaybackController';
+export * from './playback/PlaybackControllerImpl';
+export * from './playback/PlaybackSource';
+export * from './playback/PlaybackSourceImpl';
+export * from './playback/ReadonlyPlaybackController';
+export * from './streaming/abr/QualitySelector';
+export * from './streaming/abr/QualitySelectorImpl';
+export * from './streaming/buffering/BufferingController';
+export * from './streaming/buffering/codecDenylist';
+export * from './streaming/buffering/error/SourceBufferError';
+export * from './streaming/buffering/MediaSourceController';
+export * from './streaming/buffering/SourceBufferController';
+export * from './streaming/ContentStream';
+export * from './streaming/ContentStreamingOptions';
+export * from './streaming/ContentTypesValue';
+export * from './streaming/createAllowedContentTypesValue';
+export * from './streaming/createDefaultMediaTimelineTransformer';
+export * from './streaming/DescriptorRecord';
+export * from './streaming/DrmInitDataType';
+export * from './streaming/LoadMetric';
+export * from './streaming/ManifestController';
+export * from './streaming/ManifestControllerImpl';
+export * from './streaming/MediaQualityMetadata';
+export * from './streaming/MediaTimeline';
+export * from './streaming/mediaTimelineAccessibilityFilter';
+export * from './streaming/mediaTimelineFilter';
+export * from './streaming/mediaTimelineLanguageFilter';
+export * from './streaming/SegmentController';
+export * from './streaming/SegmentControllerImpl';
+export * from './streaming/SegmentDataSlot';
+export * from './streaming/SegmentPrefetch';
+export * from './streaming/SegmentReference';
+export * from './streaming/StreamingEventMap';
+export * from './streaming/util/segment';
+export * from './text/discoverDashTextTracks';
+export * from './text/discoverHlsTextTracks';
+export * from './text/parseWebVtt';
+export * from './text/pickPreferredTextTrack';
+export * from './text/SidecarTextTrackController';
+export * from './text/SidecarTextTrackLoader';
+export * from './text/TextTrack';
+export * from './text/VttCueStyle';
 export * from './track/AutoResetController';
-export * from './track/source/SourceTrackBase';
-export * from './track/source/SourceTrack';
-export * from './track/source/SourceObjectTrack';
-export * from './track/source/FixedPlaybackQuality';
-export * from './track/mse/codec';
-export * from './track/mse/MseTrack';
-export * from './track/hls/createUrlHlsManifestProvider';
-export * from './track/hls/createHlsFactories';
-export * from './track/hls/createHlsContentTypesValue';
-export * from './track/hls/createHlsContentStreamFactories';
-export * from './track/hls/createDefaultHlsManifestTransformer';
-export * from './track/hls/buildHlsMediaTimeline';
-export * from './track/hls/HlsTrack';
-export * from './track/hls/HlsMediaQualityMetadataResolver';
-export * from './track/hls/HlsManifestProvider';
-export * from './track/hls/HlsManifestController';
-export * from './track/hls/util/hlsSegmentTime';
-export * from './track/hls/util/hlsByteRangeToMediaRange';
-export * from './track/filters/sampleRateFilter';
-export * from './track/filters/resourceTypeFilter';
-export * from './track/filters/languageFilter';
-export * from './track/filters/keySystemFilter';
-export * from './track/dash/urlDashManifestProvider';
-export * from './track/dash/manifestTransformUtils';
-export * from './track/dash/createSegmentControllerFactory';
-export * from './track/dash/createDefaultDashManifestTransformer';
-export * from './track/dash/createDashManifestProvider';
-export * from './track/dash/createDashFactories';
-export * from './track/dash/createDashContentTypesValue';
-export * from './track/dash/createDashContentStreamFactories';
+export * from './track/createSegmentDataProvider';
+export * from './track/createVinylTrackFactories';
 export * from './track/dash/buildDashMediaTimeline';
-export * from './track/dash/DashTrack';
-export * from './track/dash/DashMediaQualityMetadataResolver';
-export * from './track/dash/DashManifestProvider';
+export * from './track/dash/createDashContentStreamFactories';
+export * from './track/dash/createDashContentTypesValue';
+export * from './track/dash/createDashFactories';
+export * from './track/dash/createDashManifestProvider';
+export * from './track/dash/createDefaultDashManifestTransformer';
+export * from './track/dash/createSegmentControllerFactory';
 export * from './track/dash/DashManifestController';
-export * from './track/dash/util/uriResolution';
-export * from './track/dash/util/mpd';
-export * from './track/dash/util/mimeType';
+export * from './track/dash/DashManifestProvider';
+export * from './track/dash/DashMediaQualityMetadataResolver';
+export * from './track/dash/DashTrack';
+export * from './track/dash/manifestTransformUtils';
 export * from './track/dash/timeline/DashRepresentationSegmentProvider';
-export * from './streaming/mediaTimelineLanguageFilter';
-export * from './streaming/mediaTimelineFilter';
-export * from './streaming/createDefaultMediaTimelineTransformer';
-export * from './streaming/StreamingEventMap';
-export * from './streaming/SegmentReference';
-export * from './streaming/SegmentPrefetch';
-export * from './streaming/SegmentDataSlot';
-export * from './streaming/SegmentControllerImpl';
-export * from './streaming/SegmentController';
-export * from './streaming/MediaTimeline';
-export * from './streaming/MediaQualityMetadata';
-export * from './streaming/ManifestController';
-export * from './streaming/DrmInitDataType';
-export * from './streaming/DescriptorRecord';
-export * from './streaming/ContentTypesValue';
-export * from './streaming/ContentStreamingOptions';
-export * from './streaming/ContentStream';
-export * from './streaming/util/segment';
-export * from './streaming/buffering/SourceBufferController';
-export * from './streaming/buffering/MediaSourceController';
-export * from './streaming/buffering/BufferingController';
-export * from './streaming/buffering/error/SourceBufferError';
-export * from './streaming/abr/QualitySelectorImpl';
-export * from './streaming/abr/QualitySelector';
-export * from './playback/nextHasMetadata';
-export * from './playback/ReadonlyPlaybackController';
-export * from './playback/PlaybackSourceImpl';
-export * from './playback/PlaybackSource';
-export * from './playback/PlaybackControllerImpl';
-export * from './playback/PlaybackController';
-export * from './playback/loudness/LoudnessNormalizationControllerImplOptions';
-export * from './playback/loudness/LoudnessNormalizationControllerImpl';
-export * from './playback/loudness/LoudnessNormalizationController';
-export * from './playback/logging/playbackStateLoggingHandler';
-export * from './playback/logging/mediaErrorToJson';
-export * from './playback/error/ReportableMediaError';
-export * from './playback/error/InvalidSeekError';
-export * from './patch/media/patchMediaElement';
-export * from './patch/media/MediaElementPatchOptions';
-export * from './patch/media/HtmlMediaElementPatch';
-export * from './patch/media/patches/createUnreliablePlaybackEventsPatch';
-export * from './patch/media/patches/createPreventStallsPatch';
-export * from './global/initializeVinylGlobal';
-export * from './global/globalRef';
-export * from './global/environment';
-export * from './global/configureVinylGlobal';
-export * from './global/PlayerRegistry';
-export * from './event/ChangeEvent';
-export * from './event/BasicErrorEvent';
-export * from './drm/DrmOptions';
-export * from './drm/DrmKeySystemResolver';
-export * from './drm/DrmKeySystem';
-export * from './drm/DrmControllerImpl';
-export * from './drm/DrmController';
-export * from './drm/CencEncryptionScheme';
-export * from './drm/util/unpackPlayReadyChallenge';
-export * from './drm/util/extractContentId';
-export * from './drm/util/createFairPlaySessionInitData';
-export * from './drm/licenseProvider/defaultLicenseProvider';
-export * from './drm/licenseProvider/LicenseProvider';
-export * from './drm/error/DrmError';
-export * from './drm/dom/WebKitMediaKeys';
-export * from './drm/dom/MSMediaKeys';
-export * from './drm/dom/HTMLMediaElement';
-export * from './drm/commonEme/createDrmErrorHandler';
-export * from './drm/commonEme/WebKitCommonEme';
-export * from './drm/commonEme/StandardCommonEme';
-export * from './drm/commonEme/MsCommonEme';
-export * from './drm/commonEme/EncryptedInitData';
-export * from './drm/commonEme/CommonEmeFactory';
-export * from './drm/commonEme/CommonEme';
-export * from './client/Client';
-export * from './client/CapabilitiesImpl';
-export * from './client/Capabilities';
+export * from './track/dash/urlDashManifestProvider';
+export * from './track/dash/util/mimeType';
+export * from './track/dash/util/mpd';
+export * from './track/dash/util/uriResolution';
+export * from './track/filters/keySystemFilter';
+export * from './track/filters/languageFilter';
+export * from './track/filters/resourceTypeFilter';
+export * from './track/filters/sampleRateFilter';
+export * from './track/hls/buildHlsMediaTimeline';
+export * from './track/hls/createDefaultHlsManifestTransformer';
+export * from './track/hls/createHlsContentStreamFactories';
+export * from './track/hls/createHlsContentTypesValue';
+export * from './track/hls/createHlsFactories';
+export * from './track/hls/createHlsManifestProvider';
+export * from './track/hls/createUrlHlsManifestProvider';
+export * from './track/hls/HlsManifestController';
+export * from './track/hls/HlsManifestData';
+export * from './track/hls/HlsMediaQualityMetadataResolver';
+export * from './track/hls/HlsTrack';
+export * from './track/hls/util/hlsByteRangeToMediaRange';
+export * from './track/hls/util/hlsSegmentTime';
+export * from './track/inferLoadOptionsFromUri';
+export * from './track/mse/codec';
+export * from './track/mse/MseTrack';
+export * from './track/SeekRange';
+export * from './track/source/FixedPlaybackQuality';
+export * from './track/source/SourceObjectTrack';
+export * from './track/source/SourceTrack';
+export * from './track/source/SourceTrackBase';
+export * from './track/Track';
+export * from './track/TrackBase';
+export * from './track/TrackController';
+export * from './track/TrackFactory';
+export * from './util/media/codecOverrides';
+export * from './util/media/codecSupport';
+export * from './util/media/getAudioContext';
+export * from './util/media/mediaSource';
+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/ts4.7/patch/media/patches/createPreventStallsPatch.d.ts

@@ -1,4 +1,4 @@
-import type { HtmlMediaElementPatch } from '../../../patch/media/HtmlMediaElementPatch';
+import type { HtmlMediaElementPatch } from '../HtmlMediaElementPatch';
 /**
  * The number of timeupdate events stuck at the same position before attempting to jiggle the playhead.
  * @private

package/dist/types/ts4.7/patch/media/patches/createUnreliablePlaybackEventsPatch.d.ts

@@ -1,4 +1,4 @@
-import type { HtmlMediaElementPatch } from '../../../patch/media/HtmlMediaElementPatch';
+import type { HtmlMediaElementPatch } from '../HtmlMediaElementPatch';
 /**
  * The interval (in seconds) to poll for time progress in a media element.
  *

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

@@ -1,7 +1,7 @@
 import { EventHostImpl, type ReadonlyRanges } from '@amazon/vinyl-util';
 import { type PlaybackController } from './PlaybackController';
 import { type PlaybackControllerEventMap, PlaybackReadyState } from './ReadonlyPlaybackController';
-import type { LoudnessNormalizationController } from '../playback/loudness/LoudnessNormalizationController';
+import type { LoudnessNormalizationController } from './loudness/LoudnessNormalizationController';
 export interface PlaybackControllerImplOptions {
     /**
      * An affordance when comparing the last currentTime and the new currentTime after a seek.
@@ -56,6 +56,7 @@ export declare class PlaybackControllerImpl extends EventHostImpl<PlaybackContro
     private _playing;
     private _seeking;
     private _waiting;
+    private _seekId;
     private userVolume;
     private _pendingPlay;
     private playAbort;

package/dist/types/ts4.7/playback/PlaybackSource.d.ts

@@ -27,7 +27,7 @@ export interface PlaybackSource {
     load(): void;
     /**
      * Determines whether the media element is allowed to have a remote playback UI.
-     * (Note: AirPlay does not support remote playback for Dash)
+     * (Note: AirPlay does not support remote playback for MSE)
      */
     disableRemotePlayback: boolean;
 }

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

@@ -163,6 +163,11 @@ export interface PlaybackControllerEventMap {
      * Fired periodically as the browser loads a resource.
      */
     readonly progress: ProgressEvent;
+    /**
+     * Fired when the intrinsic dimensions of the media (e.g. a video's width or
+     * height) change, including once they first become known.
+     */
+    readonly resize: AnyRecord;
     /**
      * Fired when the playback rate has changed.
      */
@@ -259,6 +264,7 @@ export declare const ALL_PLAYBACK_STATE_EVENTS: readonly [
     "rateChange",
     "readyStateChange",
     "reset",
+    "resize",
     "seeked",
     "seeking",
     "timeUpdate",

package/dist/types/ts4.7/playback/logging/playbackStateLoggingHandler.d.ts

@@ -1,5 +1,5 @@
 import type { Disposable } from '@amazon/vinyl-util';
-import type { ReadonlyPlaybackController } from '../../playback/ReadonlyPlaybackController';
+import type { ReadonlyPlaybackController } from '../ReadonlyPlaybackController';
 /**
  * The number of seconds to throttle timeupdate logs.
  * Logs will not be emitted for timeupdate events less than this interval.

package/dist/types/ts4.7/playback/nextHasMetadata.d.ts

@@ -1,4 +1,4 @@
-import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from '../playback/ReadonlyPlaybackController';
+import type { PlaybackControllerEventMap, ReadonlyPlaybackController } from './ReadonlyPlaybackController';
 import { type AnyRecord, type NextEventAsPromiseOptions } from '@amazon/vinyl-util';
 export declare function nextHasMetadata(controller: ReadonlyPlaybackController, options?: NextEventAsPromiseOptions<PlaybackControllerEventMap, 'loadedMetadata'>): Promise<AnyRecord>;
 //# sourceMappingURL=nextHasMetadata.d.ts.map

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

@@ -1,8 +1,8 @@
 import { type Disposable, EventHostImpl, type Maybe, type ReadonlyEventHost, type ReadonlyRanges } from '@amazon/vinyl-util';
-import type { StreamingEventMap } from '../streaming/StreamingEventMap';
-import type { SegmentController } from '../streaming/SegmentController';
-import type { BufferingController } from '../streaming/buffering/BufferingController';
-import type { ContentType, MediaQualityMetadata } from '../streaming/MediaQualityMetadata';
+import type { StreamingEventMap } from './StreamingEventMap';
+import type { SegmentController } from './SegmentController';
+import type { BufferingController } from './buffering/BufferingController';
+import type { ContentType, MediaQualityMetadata } from './MediaQualityMetadata';
 import { type Factories } from '@amazon/vinyl-di';
 /**
  * Creates a new ContentStream for the given content type.
@@ -38,6 +38,10 @@ 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
@@ -52,7 +56,7 @@ export interface ContentStream extends ReadonlyEventHost<StreamingEventMap>, Dis
     /**
      * Activates the content stream, activating sub-controllers.
      */
-    activate(options: ContentStreamActivateOptions): void;
+    activate(options: Maybe<ContentStreamActivateOptions>): void;
     /**
      * Deactivates the content stream, deactivating sub-controllers.
      */
@@ -81,6 +85,8 @@ export interface ContentStreamImplDeps {
 }
 export declare class ContentStreamImpl extends EventHostImpl<StreamingEventMap> implements ContentStream {
     readonly contentType: ContentType;
+    get [Symbol.toStringTag](): string;
+    readonly logPrefix: string;
     private disposer;
     private readonly segmentController;
     private readonly bufferingController;
@@ -90,6 +96,7 @@ 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/ts4.7/streaming/ContentStreamingOptions.d.ts

@@ -1,5 +1,5 @@
-import type { SegmentControllerImplOptions } from '../streaming/SegmentControllerImpl';
-import type { BufferingControllerImplOptions } from '../streaming/buffering/BufferingController';
+import type { SegmentControllerImplOptions } from './SegmentControllerImpl';
+import type { BufferingControllerImplOptions } from './buffering/BufferingController';
 export interface ContentStreamingOptions {
     /**
      * Configuration for the segment controller.

package/dist/types/ts4.7/streaming/LoadMetric.d.ts

@@ -0,0 +1,58 @@
+import type { Timestamp } from '@amazon/vinyl-util';
+import type { TrackUri } from '../track/Track';
+/**
+ * The stage of the track-load journey a {@link LoadSpanMeasurement} describes.
+ *
+ * - `manifest`: fetching and parsing the DASH/HLS manifest.
+ * - `license`: the DRM license request/response exchange.
+ * - `initSegment`: fetching the initialization segment.
+ * - `firstSegment`: fetching the first media segment.
+ */
+export type LoadSpanKind = 'manifest' | 'license' | 'initSegment' | 'firstSegment';
+/**
+ * A timed span for one stage of a track load.
+ *
+ * Dispatched by the controller that owns the stage. Emitters attribute the span
+ * to the track it was measured for at the source (see {@link trackUri}); the
+ * player republishes it as a {@link LoadSpanEvent}. When the emitter cannot know
+ * the owning track, `trackUri` is omitted and the span is dropped rather than
+ * misattributed.
+ */
+export interface LoadSpanMeasurement {
+    readonly kind: LoadSpanKind;
+    /**
+     * When the stage began, as a unix millisecond timestamp.
+     */
+    readonly startTime: Timestamp;
+    /**
+     * When the stage completed, as a unix millisecond timestamp.
+     */
+    readonly endTime: Timestamp;
+    /**
+     * The track this span was measured for, stamped at the source by the
+     * emitter that knows which track initiated the load. Omitted only when the
+     * initiating track is not yet known (e.g. an encrypted event handled before
+     * buffering DRM info is set).
+     */
+    readonly trackUri?: TrackUri;
+}
+/**
+ * A {@link LoadSpanMeasurement} attributed to the track it was measured for.
+ *
+ * Emitted on the player as the `loadSpan` event.
+ */
+export interface LoadSpanEvent extends LoadSpanMeasurement {
+    readonly trackUri: TrackUri;
+}
+/**
+ * Player-level load metric events.
+ */
+export interface LoadMetricEventMap {
+    /**
+     * A stage of a track load completed. Reports the time span of the stage
+     * together with the track it belongs to. Consumers measuring end-to-end
+     * load latency key on the first event per `kind` and `trackUri`.
+     */
+    readonly loadSpan: LoadSpanEvent;
+}
+//# sourceMappingURL=LoadMetric.d.ts.map

package/dist/types/ts4.7/streaming/ManifestController.d.ts

@@ -1,5 +1,16 @@
 import type { ObservableValue } from '@amazon/vinyl-observable';
-export interface ManifestController<T> extends ObservableValue<T> {
+import type { ReadonlyAbort, ReadonlyEventHost } from '@amazon/vinyl-util';
+import type { LoadSpanMeasurement } from './LoadMetric';
+/**
+ * Events a manifest controller dispatches.
+ */
+export interface ManifestControllerEventMap {
+    /**
+     * The initial manifest fetch completed.
+     */
+    readonly loadSpanMeasured: LoadSpanMeasurement;
+}
+export interface ManifestController<T> extends ObservableValue<T>, ReadonlyEventHost<ManifestControllerEventMap> {
     /**
      * Manually triggers a reload of the manifest.
      * A manifest reload will not clear currently fetched or buffered segments.
@@ -10,4 +21,8 @@ export interface ManifestController<T> extends ObservableValue<T> {
      */
     reset(): void;
 }
+/**
+ * Provides a manifest.
+ */
+export type ManifestProvider<T> = (abort?: ReadonlyAbort) => Promise<T>;
 //# sourceMappingURL=ManifestController.d.ts.map

package/dist/types/ts4.7/streaming/ManifestControllerImpl.d.ts

@@ -0,0 +1,43 @@
+import { type MutableValue } from '@amazon/vinyl-observable';
+import { type EventHandler, type SignalOptions, type Unsubscribe } from '@amazon/vinyl-util';
+import type { ManifestController, ManifestControllerEventMap, ManifestProvider } from './ManifestController';
+export interface ManifestControllerImplDeps<T> {
+    readonly manifestProvider: ManifestProvider<T>;
+}
+export declare class ManifestControllerImpl<T> implements ManifestController<Promise<T>> {
+    private readonly deps;
+    get [Symbol.toStringTag](): string;
+    get logPrefix(): string;
+    private readonly _data;
+    private _error;
+    private readonly abortSlot;
+    private readonly disposer;
+    private readonly events;
+    private manifestSpanArmed;
+    constructor(deps: ManifestControllerImplDeps<T>);
+    on<K extends keyof ManifestControllerEventMap>(type: K, handler: EventHandler<ManifestControllerEventMap[K]>, options?: SignalOptions): Unsubscribe;
+    hasAnyListeners(): boolean;
+    hasListeners(type: keyof ManifestControllerEventMap): boolean;
+    readonly __eventMapType: import("@amazon/vinyl-util").Covariant<ManifestControllerEventMap>;
+    /**
+     * The most recent error from the manifest provider, or null.
+     */
+    get error(): Error | null;
+    refresh(): void;
+    private requestManifest;
+    /**
+     * Measures the initial manifest fetch as a load span, re-arming on failure
+     * so a recovered load is still measured.
+     */
+    private measureLoadSpan;
+    reset(): void;
+    get value(): Promise<T>;
+    get changeId(): number;
+    getValue(): Promise<T>;
+    onData(callback: (value: Promise<T>, previous?: Promise<T>) => void): () => void;
+    map<U>(fn: (value: Promise<T>) => U): import("@amazon/vinyl-observable").ObservableValue<U>;
+    pick<K extends keyof NonNullable<Promise<T>>>(key: K): MutableValue<Promise<T>[K]>;
+    get disposed(): boolean;
+    dispose(): void;
+}
+//# sourceMappingURL=ManifestControllerImpl.d.ts.map

package/dist/types/ts4.7/streaming/MediaQualityMetadata.d.ts

@@ -1,7 +1,7 @@
 import { type Maybe, type MutableDeep } from '@amazon/vinyl-util';
 import type { ObjectSchema } from '@amazon/vinyl-validation';
-import { type DescriptorRecord } from '../streaming/DescriptorRecord';
-import type { DrmInitDataType } from '../streaming/DrmInitDataType';
+import { type DescriptorRecord } from './DescriptorRecord';
+import type { DrmInitDataType } from './DrmInitDataType';
 import type { CencEncryptionScheme } from '../drm/CencEncryptionScheme';
 import { DrmKeySystem } from '../drm/DrmKeySystem';
 import type { FrameRate } from '@amazon/vinyl-mpd-parser';
@@ -11,6 +11,17 @@ export declare const ALL_CONTENT_TYPES: [
     "audio",
     "text"
 ];
+/**
+ * The content types that can be restricted via an allow list (see
+ * `VinylOptions.allowedContentTypes`). Text is intentionally excluded: text
+ * tracks (subtitles / closed captions) are governed by caption selection, not
+ * by the content-type allow list, so they always remain available.
+ */
+export type RestrictableContentType = Exclude<ContentType, 'text'>;
+export declare const RESTRICTABLE_CONTENT_TYPES: [
+    "video",
+    "audio"
+];
 /**
  * Contains media formatting and encryption metadata.
  */
@@ -117,6 +128,14 @@ export interface MediaQualityMetadata extends MediaFormatMetadata {
      * Specifies the language of the content, using a code as defined by RFC 5646.
      */
     readonly lang: string | null;
+    /**
+     * Media characteristics / accessibility roles describing this rendition,
+     * e.g. `public.accessibility.describes-video` (HLS CHARACTERISTICS) or a
+     * DASH Role / Accessibility scheme value such as `description`. Used to keep
+     * accessibility renditions (e.g. audio description) from being auto-selected
+     * by default. Empty when none are signaled.
+     */
+    readonly characteristics: readonly string[];
     /**
      * Identifies the group this quality belongs to (e.g. the adaptation set).
      */