@bitmovin/player-web-x 10.2.0-beta.13 → 10.2.0-beta.14

package/types/packages/capabilities/Types.d.ts

@@ -1,4 +1,4 @@
-import type { ContainerFormat } from '../stream-data-structure/segment/SegmentDataAtom';
+import type { ContainerFormat } from '../core/Constants';
 export interface PlatformCapabilities {
     managedMediaSourceSupported(): boolean;
     mediaSourceSupported(): boolean;

package/types/packages/container/container-mp4/ContainerMp4.package.d.ts

@@ -14,6 +14,7 @@
  */
 import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
 import type { EmptyObject } from '../../../Types';
+import type { Constants } from '../../core/Constants';
 import type { CoreEffects, CoreStateAtoms } from '../../core/Types';
 import { CoreExportNames } from '../../core/Types';
 import type SegmentProcessorErrors from '../../segment-processing/Errors';
@@ -27,6 +28,7 @@ type Dependencies = {
     [SourceExportNames.SourceState]: SourceStateAtom;
     [CoreExportNames.CoreEffects]: CoreEffects;
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [CoreExportNames.Constants]: Constants;
     [SegmentProcessingExportNames.SegmentProcessorType]: typeof SegmentProcessorType;
     [SegmentProcessingExportNames.SegmentProcessingComponent]: SegmentProcessingComponent;
     [SegmentProcessingExportNames.SegmentProcessorErrors]: typeof SegmentProcessorErrors;

package/types/packages/container/container-ts/ContainerTs.package.d.ts

@@ -11,6 +11,7 @@
  */
 import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
 import type { EmptyObject } from '../../../Types';
+import type { Constants } from '../../core/Constants';
 import type { CoreEffects, CoreStateAtoms } from '../../core/Types';
 import { CoreExportNames } from '../../core/Types';
 import type SegmentProcessorErrors from '../../segment-processing/Errors';
@@ -18,12 +19,13 @@ import type { SegmentProcessingComponent, SegmentProcessorType } from '../../seg
 import { SegmentProcessingExportNames } from '../../segment-processing/Types';
 import type { SourceStateAtom } from '../../source/atoms/SourceStateAtom';
 import { SourceExportNames } from '../../source/Types';
-import type { StreamDataStructureSegments } from '../../stream-data-structure/segment/Exports';
+import { StreamDataStructureSegments } from '../../stream-data-structure/segment/Exports';
 import type { ContextWithState } from '../../Types';
 type Dependencies = {
     [SourceExportNames.SourceState]: SourceStateAtom;
     [CoreExportNames.CoreEffects]: CoreEffects;
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [CoreExportNames.Constants]: Constants;
     [SegmentProcessingExportNames.SegmentProcessorType]: typeof SegmentProcessorType;
     [SegmentProcessingExportNames.SegmentProcessingComponent]: SegmentProcessingComponent;
     [SegmentProcessingExportNames.SegmentProcessorErrors]: typeof SegmentProcessorErrors;

package/types/packages/container/ts-transmuxer/TsTransmuxer.package.d.ts

@@ -12,6 +12,7 @@
  */
 import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
 import type { EmptyObject } from '../../../Types';
+import type { Constants } from '../../core/Constants';
 import type { CoreEffects, CoreStateAtoms } from '../../core/Types';
 import { CoreExportNames } from '../../core/Types';
 import type { CoreUtils } from '../../core/utils/Types';
@@ -27,6 +28,7 @@ type Dependencies = {
     [CoreExportNames.Utils]: CoreUtils;
     [CoreExportNames.CoreEffects]: CoreEffects;
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [CoreExportNames.Constants]: Constants;
     [SegmentProcessingExportNames.SegmentProcessorType]: typeof SegmentProcessorType;
     [SegmentProcessingExportNames.SegmentProcessingComponent]: SegmentProcessingComponent;
     [SegmentProcessingExportNames.SegmentProcessorErrors]: typeof SegmentProcessorErrors;

package/types/packages/core/Constants.d.ts

@@ -39,6 +39,12 @@ export declare enum LoadControl {
     Metadata = 1,
     Data = 2
 }
+export declare enum ContainerFormat {
+    MP4 = "mp4",
+    TS = "mp2t",
+    WebM = "webm",
+    Unknown = "unknown"
+}
 export type Constants = {
     Codec: typeof Codec;
     MediaType: typeof MediaType;
@@ -49,4 +55,5 @@ export type Constants = {
     LoadControl: typeof LoadControl;
     Version: string;
     SubtitleFormatType: typeof SubtitleFormatType;
+    ContainerFormat: typeof ContainerFormat;
 };

package/types/packages/core/Types.d.ts

@@ -9,8 +9,9 @@ import type { createDataStreamAtom, DataStreamClearedError, DataStreamClosedErro
 import type { createMapStateAtom } from './state/MapStateAtom';
 import type { createPrimitiveAtom } from './state/PrimitiveAtom';
 import type { createQueueAtom, QueueItemRemovedError } from './state/QueueAtom';
+import type { createRingBufferAtom } from './state/RingBufferAtom';
 import type { StateEffectFactory } from './state/state-effect/StateEffectFactory';
-import type { createStateMachineAtom, flushPendingUpdates, logTransitions } from './state/StateMachineAtom';
+import type { createStateMachineAtom, flushPendingUpdates } from './state/StateMachineAtom';
 import type { CreateStoreEffectFactory } from './state/StoreEffectFactory';
 import type { createStreamSectionAtom } from './state/stream-timeline/StreamSectionAtom';
 import type { createStreamSequenceMapAtom } from './state/stream-timeline/StreamSequenceMapAtom';
@@ -61,6 +62,7 @@ export type CoreStateAtoms = {
     createPrimitiveAtom: typeof createPrimitiveAtom;
     createTimelineAtom: typeof createTimelineAtom;
     createTimelineTrackerAtom: typeof createTimelineTrackerAtom;
+    createRingBufferAtom: typeof createRingBufferAtom;
     Queue: {
         createQueueAtom: typeof createQueueAtom;
         QueueItemRemovedError: typeof QueueItemRemovedError;
@@ -89,6 +91,5 @@ export type CoreStateAtoms = {
     StateMachine: {
         createStateMachineAtom: typeof createStateMachineAtom;
         flushPendingUpdates: typeof flushPendingUpdates;
-        logTransitions: typeof logTransitions;
     };
 };

package/types/packages/core/metrics/MetricsAtom.d.ts

@@ -1,7 +1,7 @@
 import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
 import type { EmptyObject } from '../../../Types';
-import type { RingBufferAtom } from '../../adaptation/RingBufferAtom';
 import type { ContextWithState } from '../../Types';
+import type { RingBufferAtom } from '../state/RingBufferAtom';
 import type { CoreExportNames, CoreStateAtoms } from '../Types';
 import type { NetworkSampleAtom } from './network/NetworkSampleAtom';
 export interface Metrics {

package/types/packages/{adaptation → core/state}/RingBufferAtom.d.ts

@@ -1,4 +1,4 @@
-import type { ContextWithState } from '../Types';
+import type { ContextWithState } from '../../Types';
 export interface RingBuffer<T> {
     buffer: T[];
     capacity: number;
@@ -10,7 +10,7 @@ export declare function getDefaultRingBuffer<T>(capacity?: number, input?: T[]):
 export declare function getTail<T>(data: RingBufferAtom<T>): T | undefined;
 export declare function getHead<T>(data: RingBufferAtom<T>): T | undefined;
 export type RingBufferAtom<T> = ReturnType<typeof createRingBufferAtom<T>>;
-export declare const createRingBufferAtom: <ElementType>(context: ContextWithState, capacity?: number, defaultData?: ElementType[] | undefined) => import("../core/state/Types").StateAtom<RingBuffer<ElementType>, {
+export declare const createRingBufferAtom: <ElementType>(context: ContextWithState, capacity?: number, defaultData?: ElementType[] | undefined) => import("./Types").StateAtom<RingBuffer<ElementType>, {
     add: (data: RingBuffer<ElementType>, element: ElementType) => boolean;
     clear: (data: RingBuffer<ElementType>) => boolean;
 }>;

package/types/packages/core/state/StateMachineAtom.d.ts

@@ -9,21 +9,22 @@ export interface StateMachine<S> {
     current: S;
     previous: S;
 }
-export type StateMachineAtom<S extends string, _ extends ContextWithState, D = void> = StateAtom<StateMachine<S>, {
+export type BaseStateMachineContext = ContextHaving<{
+    [CoreExportNames.Utils]: CoreUtils;
+}, EmptyObject, ContextWithState>;
+export type StateMachineAtom<S extends string, _ extends BaseStateMachineContext, D = void> = StateAtom<StateMachine<S>, {
     updateState: (state: StateMachine<S>, data: D) => boolean;
 }>;
-export type Transition<S extends string, C extends ContextWithState, D = void> = (context: C, data: D) => S;
-export type TransitionMap<S extends string, C extends ContextWithState, D = void> = {
+export type Transition<S extends string, C extends BaseStateMachineContext, D = void> = (context: C, data: D) => S;
+export type TransitionMap<S extends string, C extends BaseStateMachineContext, D = void> = {
     [key in S]: Transition<S, C, D>;
 };
-export type Handler<S extends string, C extends ContextWithState, D = void> = NamedTask<Task<C, StateMachineAtom<S, C, D>, void>>;
-export type HandlerMap<S extends string, C extends ContextWithState, D = void> = {
+export type Handler<S extends string, C extends BaseStateMachineContext, D = void> = NamedTask<Task<C, StateMachineAtom<S, C, D>, void>>;
+export type HandlerMap<S extends string, C extends BaseStateMachineContext, D = void> = {
     [key in S]?: Handler<S, C, D>;
 };
-export declare function createStateMachineAtom<S extends string, C extends ContextWithState, D = void>(context: C, initialState: S, transitions: TransitionMap<S, C, D>, handlers?: HandlerMap<S, C, D>): StateMachineAtom<S, C, D>;
-export declare function flushPendingUpdates(context: ContextWithState, stateMachine: StateMachineAtom<string, ContextWithState>): void;
-type ContextWithStateAndLogger = ContextHaving<{
-    [CoreExportNames.Utils]: CoreUtils;
-}, EmptyObject, ContextWithState>;
-export declare function logTransitions<S extends string, C extends ContextWithState, D = void>(context: ContextWithStateAndLogger, stateMachine: StateMachineAtom<S, C, D>, name: string): void;
-export {};
+export type StateMachineLoggingOptions = {
+    name: string;
+};
+export declare function createStateMachineAtom<S extends string, C extends BaseStateMachineContext, D = void>(context: C, initialState: S, transitions: TransitionMap<S, C, D>, handlers?: HandlerMap<S, C, D>, loggingOptions?: StateMachineLoggingOptions): StateMachineAtom<S, C, D>;
+export declare function flushPendingUpdates(context: BaseStateMachineContext, stateMachine: StateMachineAtom<string, BaseStateMachineContext>): void;

package/types/packages/core/state/state-effect/Types.d.ts

@@ -1,8 +1,8 @@
 import type { ExecutionContext } from '../../../../../framework-types/execution-context/ExecutionContext';
 import type { AnyNamedTask, AnyParameterTask, AnyTask, NamedTask, TaskParam } from '../../../../../framework-types/task/Types';
 import type { EmptyObject } from '../../../../Types';
-import type { IsStateAtom } from '../Types';
+import type { StateAtom } from '../Types';
 export type ParameterizedTask<P, S extends NamedTask<AnyTask>> = S extends NamedTask<AnyParameterTask<P>> ? S : NamedTask<AnyParameterTask<P>>;
-export type TaskParameter<Atom, Task extends ParameterizedTask<Atom, NamedTask<AnyTask>>> = IsStateAtom<TaskParam<Task>> extends true ? TaskParam<Task> : never;
+export type TaskParameter<Atom, Task extends ParameterizedTask<Atom, NamedTask<AnyTask>>> = Extract<TaskParam<Task>, StateAtom>;
 export type ErrorCallback = (error: Error) => boolean;
 export type SubscriberTuple = [ExecutionContext<EmptyObject, EmptyObject>, AnyNamedTask, ErrorCallback];

package/types/packages/core/technology/Types.d.ts

@@ -11,9 +11,9 @@ export type Factory<Payload, Context extends AnyExecutionContext, TechnologyName
     resolve: NamedTask<Task<Context, Payload, void>>;
     add(technology: Technology<Payload, Context, TechnologyName>, abortSignal: AbortSignal): void;
 };
-export declare const TechnologyExport = "technology";
+export declare const TechnologyExports = "technology";
 export type TechnologyExports = {
-    [TechnologyExport]: {
+    [TechnologyExports]: {
         create: <Payload, Context extends AnyExecutionContext, TechnologyName extends string>(context: ContextWithState, prioritize: Prioritize<Payload, Context, TechnologyName>) => Factory<Payload, Context, TechnologyName>;
     };
 };

package/types/packages/data/Types.d.ts

@@ -10,8 +10,10 @@ import type { StateEffect } from '../core/state/state-effect/StateEffectFactory'
 import type { StreamTimelineAtom } from '../core/state/stream-timeline/StreamTimelineMapAtom';
 import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../core/Types';
 import type { CoreUtils } from '../core/utils/Types';
+import type { createNetworkAtom } from '../network/NetworkAtom';
+import type { NetworkMessageType } from '../network/NetworkMessageTypes';
 import type { NetworkTask } from '../network/NetworkTask';
-import type { NetworkExportNames } from '../network/Types';
+import type { HttpRequestMethod, HttpResponseType, NetworkExportNames } from '../network/Types';
 import type SegmentProcessorErrors from '../segment-processing/Errors';
 import type { SegmentProcessingComponent, SegmentProcessingExportNames } from '../segment-processing/Types';
 import type { SourceStateAtom } from '../source/atoms/SourceStateAtom';
@@ -30,6 +32,10 @@ export type DataDependencies = {
     [CoreExportNames.Utils]: CoreUtils;
     [AdaptationExportNames.Metrics]: MetricsAtom;
     [NetworkExportNames.NetworkTask]: typeof NetworkTask;
+    [NetworkExportNames.NetworkMessageType]: typeof NetworkMessageType;
+    [NetworkExportNames.NetworkAtom]: typeof createNetworkAtom;
+    [NetworkExportNames.HttpRequestMethod]: typeof HttpRequestMethod;
+    [NetworkExportNames.HttpResponseType]: typeof HttpResponseType;
     [SegmentProcessingExportNames.SegmentProcessorErrors]: typeof SegmentProcessorErrors;
     [SegmentProcessingExportNames.SegmentProcessingComponent]: SegmentProcessingComponent;
     [AdaptationExportNames.Select]: (tracks: readonly MediaTrackAtom[]) => MediaTrackAtom;

package/types/packages/manifest/dash/parsing/Errors.d.ts

@@ -1,4 +1,4 @@
-import { FrameworkError } from '../../../core/FrameworkError';
+import { FrameworkError } from '../../../../../framework-types/error/FrameworkError';
 export declare class DashParsingError extends FrameworkError {
     constructor(message: string);
 }

package/types/packages/manifest/dash/root/Types.d.ts

@@ -6,7 +6,7 @@ import type { MetricsAtom } from '../../../core/metrics/MetricsAtom';
 import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../../../core/Types';
 import type { CoreUtils } from '../../../core/utils/Types';
 import type { NetworkTask } from '../../../network/NetworkTask';
-import type { NetworkExportNames } from '../../../network/Types';
+import type { HttpRequestMethod, HttpResponseType, NetworkExportNames } from '../../../network/Types';
 import type { SourceStateAtom } from '../../../source/atoms/SourceStateAtom';
 import type { SourceExportNames } from '../../../source/Types';
 import type { StreamDataStructurePackageExports } from '../../../stream-data-structure/Types';
@@ -28,6 +28,8 @@ export type DashDependencies = {
     [SourceExportNames.SourceState]: SourceStateAtom;
     [AdaptationExportNames.Metrics]: MetricsAtom;
     [NetworkExportNames.NetworkTask]: typeof NetworkTask;
+    [NetworkExportNames.HttpRequestMethod]: typeof HttpRequestMethod;
+    [NetworkExportNames.HttpResponseType]: typeof HttpResponseType;
     [DashParsingExportNames.ParsingTask]: typeof DashParsingTask;
     [DashTranslationExportNames.DashTranslator]: typeof DashPlaylistTranslatorTask;
 } & StreamDataStructurePackageExports & StreamingState & DashTechState;

package/types/packages/manifest/dash/technology/Types.d.ts

@@ -3,7 +3,7 @@ import type { ContextHaving } from '../../../../../framework-types/execution-con
 import type { Constants } from '../../../core/Constants';
 import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../../../core/Types';
 import type { CoreUtils } from '../../../core/utils/Types';
-import type { ManifestTechnologyEntry, PlaybackTechnologyComponent } from '../../../playback-technology/Types';
+import type { ManifestTechnologyEntry, PlaybackTechnologyComponent, PlaybackTechnologyEntryType, PlaybackTechnologyExportNames } from '../../../playback-technology/Types';
 import type { Resource } from '../../../source/atoms/SourceConfigAtom';
 import type { StreamDataStructureStream } from '../../../stream-data-structure/stream/Exports';
 import type { createStreamingStateAtom, StreamingStateAtom } from '../../../streaming/atoms/StreamingStateAtom';
@@ -20,6 +20,7 @@ export interface DashTechStateData {
 export type DashManifestTechnologyExports = EmptyObject;
 export type DashManifestTechnologyDependencies = {
     [PlaybackTechnologyComponent]: PlaybackTechnologyComponent;
+    [PlaybackTechnologyExportNames.EntryType]: typeof PlaybackTechnologyEntryType;
     [CoreExportNames.Constants]: Constants;
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
     [CoreExportNames.CoreEffects]: CoreEffects;

package/types/packages/manifest/hls/parsing/Constants.d.ts

@@ -0,0 +1,47 @@
+export declare enum HlsEncryptionMethod {
+    NONE = "NONE",
+    AES_128 = "AES-128",
+    SAMPLE_AES = "SAMPLE-AES"
+}
+export declare enum MetadataType {
+        CUETAG = "CUETAG",
+        DATERANGE = "DATERANGE",
+        CUSTOM = "CUSTOM",
+        SCTE = "SCTE",
+        ID3 = "ID3",
+        EMSG = "EMSG"
+}
+export declare enum TagType {
+    M3u = "m3u",
+    AllowCache = "allow-cache",
+    ByteRange = "byterange",
+    EndList = "endlist",
+    Inf = "inf",
+    Key = "key",
+    MediaSequence = "media-sequence",
+    DiscontinuitySequence = "discontinuity-sequence",
+    PlaylistType = "playlist-type",
+    StreamInf = "stream-inf",
+    IframeStreamInf = "i-frame-stream-inf",
+    Media = "media",
+    Start = "start",
+    Discontinuity = "discontinuity",
+    DateTime = "date-time",
+    TargetDuration = "targetduration",
+    Map = "map",
+    IndependentSegments = "independent-segments",
+    SessionData = "session-data",
+    SessionKey = "session-key",
+    CueOut = "cue-out",
+    CueOutCont = "cue-out-cont",
+    CueIn = "cue-in",
+    Scte35 = "scte35",
+    DateRange = "daterange",
+    Version = "version",
+    Uri = "uri",
+    Unknown = "unknown"
+}
+export declare enum PlaylistType {
+    Vod = "VOD",
+    Event = "EVENT"
+}

package/types/packages/manifest/hls/parsing/Errors.d.ts

@@ -1,4 +1,4 @@
-import { FrameworkError } from '../../../core/FrameworkError';
+import { FrameworkError } from '../../../../../framework-types/error/FrameworkError';
 export declare class HlsParsingError extends FrameworkError {
     constructor(message: string);
 }

package/types/packages/manifest/hls/parsing/Types.d.ts

@@ -1,5 +1,10 @@
 import type { ByteRange } from '../../../stream-data-structure/segment/SegmentAtom';
+import type { MetadataType, PlaylistType, TagType } from './Constants';
 import type { HlsParsingError, MissingM3uTagError } from './Errors';
+export type { HlsEncryptionMethod } from './Constants';
+export type { MetadataType } from './Constants';
+export type { TagType } from './Constants';
+export type { PlaylistType } from './Constants';
 interface StartTagAttributes {
     timeOffset: number;
     precise: boolean;
@@ -20,11 +25,6 @@ export interface Scte35 {
     attributes?: Scte35TagAttributes;
     type: MetadataType.SCTE;
 }
-export declare enum HlsEncryptionMethod {
-    NONE = "NONE",
-    AES_128 = "AES-128",
-    SAMPLE_AES = "SAMPLE-AES"
-}
 export interface SegmentEncryptionInfo {
     uri: string;
     method: string;
@@ -152,14 +152,6 @@ export interface MediaPlaylist extends Playlist {
         map?: MapInformation;
 }
 export type HlsManifest = MultivariantPlaylist | MediaPlaylist;
-export declare enum MetadataType {
-        CUETAG = "CUETAG",
-        DATERANGE = "DATERANGE",
-        CUSTOM = "CUSTOM",
-        SCTE = "SCTE",
-        ID3 = "ID3",
-        EMSG = "EMSG"
-}
 export interface HlsTag {
         name: string;
         attributes?: {
@@ -167,40 +159,6 @@ export interface HlsTag {
     };
         value?: string;
 }
-export declare enum TagType {
-    M3u = "m3u",
-    AllowCache = "allow-cache",
-    ByteRange = "byterange",
-    EndList = "endlist",
-    Inf = "inf",
-    Key = "key",
-    MediaSequence = "media-sequence",
-    DiscontinuitySequence = "discontinuity-sequence",
-    PlaylistType = "playlist-type",
-    StreamInf = "stream-inf",
-    IframeStreamInf = "i-frame-stream-inf",
-    Media = "media",
-    Start = "start",
-    Discontinuity = "discontinuity",
-    DateTime = "date-time",
-    TargetDuration = "targetduration",
-    Map = "map",
-    IndependentSegments = "independent-segments",
-    SessionData = "session-data",
-    SessionKey = "session-key",
-    CueOut = "cue-out",
-    CueOutCont = "cue-out-cont",
-    CueIn = "cue-in",
-    Scte35 = "scte35",
-    DateRange = "daterange",
-    Version = "version",
-    Uri = "uri",
-    Unknown = "unknown"
-}
-export declare enum PlaylistType {
-    Vod = "VOD",
-    Event = "EVENT"
-}
 export type BaseTag<T extends TagType> = {
     tagType: T;
 };
@@ -269,4 +227,3 @@ export declare enum HlsParsingExportNames {
     ParsingFunctions = "hls-parsing-functions",
     Errors = "hls-parsing-errors"
 }
-export {};

package/types/packages/manifest/hls/root/Hls.package.d.ts

@@ -13,13 +13,14 @@
 import type { ContextHaving } from '../../../../../framework-types/execution-context/Types';
 import type { NamedTask, Task } from '../../../../../framework-types/task/Types';
 import type { EmptyObject } from '../../../../Types';
-import type { AdaptationExportNames } from '../../../adaptation/Types';
+import { AdaptationExportNames } from '../../../adaptation/Types';
 import type { Constants } from '../../../core/Constants';
 import type { MetricsAtom } from '../../../core/metrics/MetricsAtom';
 import type { CoreEffects, CoreStateAtoms } from '../../../core/Types';
 import { CoreExportNames } from '../../../core/Types';
 import type { CoreUtils } from '../../../core/utils/Types';
 import type { NetworkTask } from '../../../network/NetworkTask';
+import type { HttpRequestMethod, HttpResponseType } from '../../../network/Types';
 import { NetworkExportNames } from '../../../network/Types';
 import type { SourceStateAtom } from '../../../source/atoms/SourceStateAtom';
 import { SourceExportNames } from '../../../source/Types';
@@ -32,6 +33,7 @@ import { HlsParsingExportNames } from '../parsing/Types';
 import { HlsTechState } from '../technology/Types';
 import type { HlsMultivariantPlaylistTranslatorTask } from '../translation/manifests/HlsMultivariantPlaylistTranslatorTask';
 import type { HlsVariantTranslationTask } from '../translation/manifests/HlsVariantTranslationTask';
+import type { HlsTranslationUtils } from '../translation/Types';
 import { HlsTranslationExportNames } from '../translation/Types';
 import { HlsPackageExportNames } from './Types';
 type HlsDependencies = {
@@ -41,11 +43,14 @@ type HlsDependencies = {
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
     [SourceExportNames.SourceState]: SourceStateAtom;
     [NetworkExportNames.NetworkTask]: typeof NetworkTask;
+    [NetworkExportNames.HttpRequestMethod]: typeof HttpRequestMethod;
+    [NetworkExportNames.HttpResponseType]: typeof HttpResponseType;
     [AdaptationExportNames.Metrics]: MetricsAtom;
     [HlsParsingExportNames.ParsingTask]: typeof HlsParsingTask;
     [HlsParsingExportNames.ParsingFunctions]: typeof HlsParsingFunctions;
     [HlsTranslationExportNames.HlsVariantTranslator]: typeof HlsVariantTranslationTask;
     [HlsTranslationExportNames.HlsMultivariantTranslator]: typeof HlsMultivariantPlaylistTranslatorTask;
+    [HlsTranslationExportNames.HlsTranslationUtils]: HlsTranslationUtils;
 } & StreamDataStructurePackageExports & StreamingStateType & HlsTechState;
 type ManifestLoadTaskType = NamedTask<Task<HlsPackageContext, SourceStateAtom, void>>;
 export type HlsExports = {

package/types/packages/manifest/hls/technology/Types.d.ts

@@ -3,7 +3,7 @@ import type { ContextHaving } from '../../../../../framework-types/execution-con
 import type { Constants } from '../../../core/Constants';
 import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../../../core/Types';
 import type { CoreUtils } from '../../../core/utils/Types';
-import type { ManifestTechnologyEntry, PlaybackTechnologyComponent } from '../../../playback-technology/Types';
+import type { ManifestTechnologyEntry, PlaybackTechnologyComponent, PlaybackTechnologyEntryType, PlaybackTechnologyExportNames } from '../../../playback-technology/Types';
 import type { Resource } from '../../../source/atoms/SourceConfigAtom';
 import type { StreamDataStructureStream } from '../../../stream-data-structure/stream/Exports';
 import type { createStreamingStateAtom, StreamingStateAtom } from '../../../streaming/atoms/StreamingStateAtom';
@@ -20,6 +20,7 @@ export interface HlsTechStateData {
 export type HlsManifestTechnologyExports = EmptyObject;
 export type HlsManifestTechnologyDependencies = {
     [PlaybackTechnologyComponent]: PlaybackTechnologyComponent;
+    [PlaybackTechnologyExportNames.EntryType]: typeof PlaybackTechnologyEntryType;
     [CoreExportNames.Constants]: Constants;
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
     [CoreExportNames.CoreEffects]: CoreEffects;

package/types/packages/manifest/hls/translation/HlsTranslation.package.d.ts

@@ -14,18 +14,23 @@ import { CoreExportNames } from '../../../core/Types';
 import type { CoreUtils } from '../../../core/utils/Types';
 import type { StreamDataStructurePackageExports } from '../../../stream-data-structure/Types';
 import type { ContextWithState } from '../../../Types';
+import type { HlsParsingFunctions } from '../parsing/HlsParsingFunctions';
+import { HlsParsingExportNames } from '../parsing/Types';
 import { HlsMultivariantPlaylistTranslatorTask } from './manifests/HlsMultivariantPlaylistTranslatorTask';
 import { HlsVariantTranslationTask } from './manifests/HlsVariantTranslationTask';
+import type { HlsTranslationUtils } from './Types';
 import { HlsTranslationExportNames } from './Types';
 type Dependencies = {
     [CoreExportNames.Utils]: CoreUtils;
     [CoreExportNames.Constants]: Constants;
     [CoreExportNames.CoreEffects]: CoreEffects;
     [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [HlsParsingExportNames.ParsingFunctions]: typeof HlsParsingFunctions;
 } & StreamDataStructurePackageExports;
 export type HlsTranslationPackageExports = {
     [HlsTranslationExportNames.HlsVariantTranslator]: typeof HlsVariantTranslationTask;
     [HlsTranslationExportNames.HlsMultivariantTranslator]: typeof HlsMultivariantPlaylistTranslatorTask;
+    [HlsTranslationExportNames.HlsTranslationUtils]: HlsTranslationUtils;
 };
 export type HlsTranslationPackageContext = ContextHaving<Dependencies, HlsTranslationPackageExports, ContextWithState>;
 export declare const HlsTranslationPackage: import("../../../../../framework-types/package-api/Package").Package<Dependencies, HlsTranslationPackageExports, EmptyObject>;

package/types/packages/manifest/hls/translation/Types.d.ts

@@ -1,14 +1,13 @@
-import type { RenditionAttributes, Variant } from '../parsing/Types';
-export declare function isMediaTagWithUri(rendition: {
-    attributes: RenditionAttributes;
-}): rendition is {
-    attributes: RenditionAttributes & {
-        URI: string;
-    };
-};
-export declare function getReferencedAudioGroupId(variant: Variant): string | undefined;
-export declare function getReferencedVideoGroupId(variant: Variant): string | undefined;
+import type { maybeSetSelectionGroupContainerFormat } from './segments/StreamHelpers';
+import type { addTrackToSelectionGroup } from './stream/TracksToSelectionGroups';
+import type { translateUnknownTrackToMediaTrack } from './stream/UnknownTrackToMediaTrackTranslator';
 export declare enum HlsTranslationExportNames {
     HlsMultivariantTranslator = "hls-multivariant-translator",
-    HlsVariantTranslator = "hls-variant-translator"
+    HlsVariantTranslator = "hls-variant-translator",
+    HlsTranslationUtils = "hls-translation-utils"
 }
+export type HlsTranslationUtils = {
+    addTrackToSelectionGroup: typeof addTrackToSelectionGroup;
+    maybeSetSelectionGroupContainerFormat: typeof maybeSetSelectionGroupContainerFormat;
+    translateUnknownTrackToMediaTrack: typeof translateUnknownTrackToMediaTrack;
+};

package/types/packages/manifest/hls/translation/segments/StreamHelpers.d.ts

@@ -0,0 +1,14 @@
+import type { SegmentAtom } from '../../../../stream-data-structure/segment/SegmentAtom';
+import type { SelectionGroupAtom } from '../../../../stream-data-structure/selection-group/SelectionGroupAtom';
+import type { StreamAtom } from '../../../../stream-data-structure/stream/StreamAtom';
+import type { AudioTrackAtom, MediaTrackAtom, SubtitleTrackAtom, TrackAtom, VideoTrackAtom } from '../../../../stream-data-structure/track/TrackAtom';
+import type { SegmentEntry } from '../../parsing/Types';
+import type { HlsTranslationPackageContext } from '../HlsTranslation.package';
+export declare function createSelectionGroup(context: HlsTranslationPackageContext, track: TrackAtom): import("../../../../stream-data-structure/selection-group/SelectionGroupAtom").UnknownSelectionGroupAtom | import("../../../../stream-data-structure/selection-group/SelectionGroupAtom").AudioSelectionGroupAtom | import("../../../../stream-data-structure/selection-group/SelectionGroupAtom").VideoSelectionGroupAtom | import("../../../../stream-data-structure/selection-group/SelectionGroupAtom").SubtitleSelectionGroupAtom;
+export declare function findOrCreateSelectionGroup(context: HlsTranslationPackageContext, track: TrackAtom, selectionGroups: readonly SelectionGroupAtom[]): SelectionGroupAtom;
+export declare function createTrack(context: HlsTranslationPackageContext, variantUrl: string, stream: StreamAtom, discontinuitySequenceNumber: number, referenceTrack?: TrackAtom): AudioTrackAtom | VideoTrackAtom | SubtitleTrackAtom | import("../../../../stream-data-structure/track/TrackAtom").UnknownTrackAtom;
+export declare function findTracksOfVariant(context: HlsTranslationPackageContext, stream: StreamAtom, variantUrl: string): TrackAtom[];
+export declare function findOrCreateTrack(context: HlsTranslationPackageContext, variantUrl: string, segment: SegmentEntry, stream: StreamAtom, referenceTrack?: TrackAtom): TrackAtom;
+export declare function hasSegment(track: MediaTrackAtom, segment: SegmentEntry): boolean;
+export declare function isMatchingSegment(segment: SegmentAtom, entry: SegmentEntry): boolean;
+export declare function maybeSetSelectionGroupContainerFormat(context: HlsTranslationPackageContext, selectionGroup: SelectionGroupAtom): void;

package/types/packages/manifest/hls/translation/stream/TracksToSelectionGroups.d.ts

@@ -0,0 +1,6 @@
+import type { ArrayAtom } from '../../../../core/state/ArrayStateAtom';
+import type { SelectionGroupsAtom } from '../../../../stream-data-structure/stream/StreamAtom';
+import type { TrackAtom } from '../../../../stream-data-structure/track/TrackAtom';
+import type { HlsTranslationPackageContext } from '../HlsTranslation.package';
+export declare function tracksToSelectionGroups(context: HlsTranslationPackageContext, tracks: ArrayAtom<TrackAtom>): SelectionGroupsAtom;
+export declare function addTrackToSelectionGroup(context: HlsTranslationPackageContext, track: TrackAtom, selectionGroups: SelectionGroupsAtom): void;

package/types/packages/manifest/hls/translation/stream/UnknownTrackToMediaTrackTranslator.d.ts

@@ -0,0 +1,4 @@
+import type { UnknownTrackAtom } from '../../../../stream-data-structure/track/TrackAtom';
+import type { TypeDetection } from '../../../../stream-data-structure/track/TypeDetection';
+import type { HlsPackageContext } from '../../root/Hls.package';
+export declare function translateUnknownTrackToMediaTrack(context: HlsPackageContext, track: UnknownTrackAtom, detection: TypeDetection): import("../../../../stream-data-structure/track/TrackAtom").AudioTrackAtom | import("../../../../stream-data-structure/track/TrackAtom").VideoTrackAtom | undefined;

package/types/packages/media-state/MediaInfoAtoms.d.ts

@@ -0,0 +1,18 @@
+import type { ContextHaving } from '../../../framework-types/execution-context/Types';
+import type { EmptyObject } from '../../Types';
+import type { PrimitiveAtom } from '../core/state/PrimitiveAtom';
+import { type CoreStateAtoms, CoreExportNames } from '../core/Types';
+import type { ContextWithState } from '../Types';
+export type MediaInfo = {
+    currentTime: PrimitiveAtom<number | undefined>;
+    duration: PrimitiveAtom<number | undefined>;
+    volume: PrimitiveAtom<number | undefined>;
+    muted: PrimitiveAtom<boolean | undefined>;
+    playbackRate: PrimitiveAtom<number | undefined>;
+    error: PrimitiveAtom<Error | undefined>;
+};
+type ContextT = ContextHaving<{
+    [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+}, EmptyObject, ContextWithState>;
+export declare function createMediaInfo(context: ContextT): MediaInfo;
+export {};

package/types/packages/media-state/MediaState.d.ts

@@ -0,0 +1,10 @@
+export declare enum MediaState {
+    Detached = "detached",
+    Play = "play",
+    Paused = "paused",
+    Playing = "playing",
+    Seeking = "seeking",
+    Stalled = "stalled",
+    Ended = "ended",
+    Error = "error"
+}

package/types/packages/media-state/MediaState.package.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @packageDocumentation MediaState.package
+ *
+ * Owns the per-source media state slot. Tech-agnostic: a controller (e.g.
+ * `VideoElementController` for HTMLVideoElement)
+ * is responsible for translating its underlying medium into transitions on
+ * `mediaState` and updates on `mediaInfo`.
+ *
+ * Exposes:
+ * - `MediaState` — `StateMachineAtom<MediaState>` for qualitative playback state
+ *   (`Detached | Playing | Paused | Seeking | Stalled | Ended | Error`).
+ * - `MediaInfo` — per-scalar atoms (`currentTime`, `duration`, `volume`,
+ *   `muted`, `playbackRate`, `error`).
+ * - `SeekRestriction` — whether seeking is allowed; seeded from the source's
+ *   `preventSeeking` playback config.
+ *
+ * ### `MediaState` Package Dependency Graph
+ * <svg aria-roledescription="flowchart-v2" role="graphics-document document" viewBox="-8 -8 227.640625 49" style="max-width: 227.641px; background-color: transparent;" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="100%" id="my-svg"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#ccc;}#my-svg .error-icon{fill:#a44141;}#my-svg .error-text{fill:#ddd;stroke:#ddd;}#my-svg .edge-thickness-normal{stroke-width:2px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:lightgrey;stroke:lightgrey;}#my-svg .marker.cross{stroke:lightgrey;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#ccc;}#my-svg .cluster-label text{fill:#F9FFFE;}#my-svg .cluster-label span,#my-svg p{color:#F9FFFE;}#my-svg .label text,#my-svg span,#my-svg p{fill:#ccc;color:#ccc;}#my-svg .node rect,#my-svg .node circle,#my-svg .node ellipse,#my-svg .node polygon,#my-svg .node path{fill:#1f2020;stroke:#81B1DB;stroke-width:1px;}#my-svg .flowchart-label text{text-anchor:middle;}#my-svg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#my-svg .node .label{text-align:center;}#my-svg .node.clickable{cursor:pointer;}#my-svg .arrowheadPath{fill:lightgrey;}#my-svg .edgePath .path{stroke:lightgrey;stroke-width:2.0px;}#my-svg .flowchart-link{stroke:lightgrey;fill:none;}#my-svg .edgeLabel{background-color:hsl(0, 0%, 34.4117647059%);text-align:center;}#my-svg .edgeLabel rect{opacity:0.5;background-color:hsl(0, 0%, 34.4117647059%);fill:hsl(0, 0%, 34.4117647059%);}#my-svg .labelBkg{background-color:rgba(87.75, 87.75, 87.75, 0.5);}#my-svg .cluster rect{fill:hsl(180, 1.5873015873%, 28.3529411765%);stroke:rgba(255, 255, 255, 0.25);stroke-width:1px;}#my-svg .cluster text{fill:#F9FFFE;}#my-svg .cluster span,#my-svg p{color:#F9FFFE;}#my-svg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(20, 1.5873015873%, 12.3529411765%);border:1px solid rgba(255, 255, 255, 0.25);border-radius:2px;pointer-events:none;z-index:100;}#my-svg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#ccc;}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g><marker orient="auto" markerHeight="12" markerWidth="12" markerUnits="userSpaceOnUse" refY="5" refX="6" viewBox="0 0 10 10" class="marker flowchart" id="my-svg_flowchart-pointEnd"><path style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 0 0 L 10 5 L 0 10 z"/></marker><marker orient="auto" markerHeight="12" markerWidth="12" markerUnits="userSpaceOnUse" refY="5" refX="4.5" viewBox="0 0 10 10" class="marker flowchart" id="my-svg_flowchart-pointStart"><path style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 0 5 L 10 10 L 10 0 z"/></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5" refX="11" viewBox="0 0 10 10" class="marker flowchart" id="my-svg_flowchart-circleEnd"><circle style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" r="5" cy="5" cx="5"/></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5" refX="-1" viewBox="0 0 10 10" class="marker flowchart" id="my-svg_flowchart-circleStart"><circle style="stroke-width: 1; stroke-dasharray: 1, 0;" class="arrowMarkerPath" r="5" cy="5" cx="5"/></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5.2" refX="12" viewBox="0 0 11 11" class="marker cross flowchart" id="my-svg_flowchart-crossEnd"><path style="stroke-width: 2; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 1,1 l 9,9 M 10,1 l -9,9"/></marker><marker orient="auto" markerHeight="11" markerWidth="11" markerUnits="userSpaceOnUse" refY="5.2" refX="-1" viewBox="0 0 11 11" class="marker cross flowchart" id="my-svg_flowchart-crossStart"><path style="stroke-width: 2; stroke-dasharray: 1, 0;" class="arrowMarkerPath" d="M 1,1 l 9,9 M 10,1 l -9,9"/></marker><g class="root"><g class="clusters"/><g class="edgePaths"><path marker-end="url(#my-svg_flowchart-pointEnd)" style="fill:none;" class="edge-thickness-normal edge-pattern-solid flowchart-link LS-MediaState LE-Source" id="L-MediaState-Source-0" d="M95.938,16.5L100.104,16.5C104.271,16.5,112.604,16.5,120.054,16.5C127.504,16.5,134.071,16.5,137.354,16.5L140.638,16.5"/></g><g class="edgeLabels"><g class="edgeLabel"><g transform="translate(0, 0)" class="label"><foreignObject height="0" width="0"><div style="display: inline-block; white-space: nowrap;" xmlns="http://www.w3.org/1999/xhtml"><span class="edgeLabel"></span></div></foreignObject></g></g></g><g class="nodes"><g transform="translate(47.96875, 16.5)" data-id="MediaState" data-node="true" id="flowchart-MediaState-0" class="node default default flowchart-label"><rect height="33" width="95.9375" y="-16.5" x="-47.96875" ry="0" rx="0" style="" class="basic label-container"/><g transform="translate(-40.46875, -9)" style="" class="label"><rect/><foreignObject height="18" width="80.9375"><div style="display: inline-block; white-space: nowrap;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel">MediaState</span></div></foreignObject></g></g><g transform="translate(178.7890625, 16.5)" data-id="Source" data-node="true" id="flowchart-Source-1" class="node default default flowchart-label"><rect height="33" width="65.703125" y="-16.5" x="-32.8515625" ry="0" rx="0" style="" class="basic label-container"/><g transform="translate(-25.3515625, -9)" style="" class="label"><rect/><foreignObject height="18" width="50.703125"><div style="display: inline-block; white-space: nowrap;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel">Source</span></div></foreignObject></g></g></g></g></g></svg>
+ */
+import type { MediaStatePackageDependencies, MediaStatePackageExports } from './Types';
+export declare const MediaStatePackage: import("../../../framework-types/package-api/Package").Package<MediaStatePackageDependencies, MediaStatePackageExports, import("../../../framework-types/BaseTypes").EmptyObject>;
+export default MediaStatePackage;