@bitmovin/player-web-x 10.2.0-beta.0 → 10.2.0-beta.11

package/types/packages/playback-api/Types.d.ts

@@ -1,6 +1,8 @@
 import type { EventBus } from '../event-bus/Types';
 import type { PlayPauseApi } from './play-pause-api/Types';
-import type { PlaybackEventMap } from './playback-api-events/events/PlaybackEventMap';
-export type PlaybackApi = PlayPauseApi & {
-    events: EventBus<PlaybackEventMap>;
+import type { PlaybackEvent, PlaybackEventMap } from './playback-api-events/events/PlaybackEventMap';
+import type { TimeApi } from './time-api/Types';
+import type { VolumeApi } from './volume-api/Types';
+export type PlaybackApi = PlayPauseApi & TimeApi & VolumeApi & {
+    events: EventBus<PlaybackEventMap, typeof PlaybackEvent>;
 };

package/types/packages/playback-api/playback-api-events/Types.d.ts

@@ -1,23 +1,25 @@
 import type { ApiManager } from '../../../../framework-types/api-manager/ApiManager';
 import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
-import type { BundleExportNames } from '../../../bundles/Types';
 import type { CoreEffects, CoreExportNames } from '../../core/Types';
-import type { Logger } from '../../core/utils/Logger';
-import type { EventBus } from '../../event-bus/Types';
+import type { extendEventBusTypes } from '../../event-bus/EventBus';
+import type { EventBus, EventBusExportNames } from '../../event-bus/Types';
 import type { PlaybackState, PlaybackStateMachineAtom, PlaybackStatePackageExportNames } from '../../playback/playback-state/Types';
+import type { VideoElementStateExportNames } from '../../playback/video-element-state/Types';
+import type { VideoElementStateAtom } from '../../playback/video-element-state/VideoElementStateAtom';
 import type { SourceStateAtom } from '../../source/atoms/SourceStateAtom';
 import type { SourceExportNames } from '../../source/Types';
 import type { SourcesApiExportNames } from '../../sources-api/Types';
 import type { ContextWithState } from '../../Types';
 import type { PlaybackEvent, PlaybackEventMap } from './events/PlaybackEventMap';
 export type PlaybackApiEventsPackageDependencies = {
-    [BundleExportNames.Logger]: Logger;
     [CoreExportNames.CoreEffects]: CoreEffects;
+    [EventBusExportNames.ExtendEventBusTypes]: typeof extendEventBusTypes;
     [PlaybackStatePackageExportNames.PlaybackState]: typeof PlaybackState;
     [PlaybackStatePackageExportNames.PlaybackStateMachine]: PlaybackStateMachineAtom;
     [SourcesApiExportNames.SourceEventBus]: EventBus<PlaybackEventMap>;
     [SourcesApiExportNames.SourceApiManager]: ApiManager<PlaybackStateApi>;
     [SourceExportNames.SourceState]: SourceStateAtom;
+    [VideoElementStateExportNames.VideoElementState]: VideoElementStateAtom;
 };
 export declare enum PlaybackApiEventsPackageExportNames {
     PlaybackEvent = "playback-event"
@@ -27,5 +29,5 @@ export type PlaybackApiEventsPackageExports = {
 };
 export type PlaybackApiEventsPackageContext = ContextHaving<PlaybackApiEventsPackageDependencies, PlaybackApiEventsPackageExports, ContextWithState>;
 export type PlaybackStateApi = {
-    getState(): PlaybackState;
+    readonly state: PlaybackState;
 };

package/types/packages/playback-api/playback-api-events/events/DurationChangedEvent.d.ts

@@ -0,0 +1,6 @@
+import type { EventBase } from '../../../event-bus/Types';
+import type { PlaybackApiEventsPackageContext } from '../Types';
+export interface DurationChangedEvent extends EventBase {
+    duration: number;
+}
+export declare function createDurationChangedEvent(context: PlaybackApiEventsPackageContext): DurationChangedEvent;

package/types/packages/playback-api/playback-api-events/events/PlaybackEventMap.d.ts

@@ -1,7 +1,10 @@
 import type { EventBase } from '../../../event-bus/Types';
+import type { DurationChangedEvent } from './DurationChangedEvent';
+import type { PlaybackRateChangedEvent } from './PlaybackRateChangedEvent';
 import type { SeekedEvent } from './SeekedEvent';
 import type { SeekingEvent } from './SeekingEvent';
 import type { TimeChangedEvent } from './TimeChanged';
+import type { VolumeChangedEvent } from './VolumeChangedEvent';
 export declare enum PlaybackEvent {
     Ready = "ready",
     Play = "play",
@@ -14,7 +17,12 @@ export declare enum PlaybackEvent {
     StallStarted = "stall-started",
     StallEnded = "stall-ended",
     VideoDetached = "video-detached",
-    VideoAttached = "video-attached"
+    VideoAttached = "video-attached",
+    Muted = "muted",
+    Unmuted = "unmuted",
+    VolumeChanged = "volume-changed",
+    DurationChanged = "duration-changed",
+    PlaybackRateChanged = "playback-rate-changed"
 }
 export type PlaybackEventMap = {
     [PlaybackEvent.Ready]: EventBase;
@@ -29,4 +37,9 @@ export type PlaybackEventMap = {
     [PlaybackEvent.StallEnded]: EventBase;
     [PlaybackEvent.VideoDetached]: EventBase;
     [PlaybackEvent.VideoAttached]: EventBase;
+    [PlaybackEvent.Muted]: EventBase;
+    [PlaybackEvent.Unmuted]: EventBase;
+    [PlaybackEvent.VolumeChanged]: VolumeChangedEvent;
+    [PlaybackEvent.DurationChanged]: DurationChangedEvent;
+    [PlaybackEvent.PlaybackRateChanged]: PlaybackRateChangedEvent;
 };

package/types/packages/playback-api/playback-api-events/events/PlaybackRateChangedEvent.d.ts

@@ -0,0 +1,6 @@
+import type { EventBase } from '../../../event-bus/Types';
+import type { PlaybackApiEventsPackageContext } from '../Types';
+export interface PlaybackRateChangedEvent extends EventBase {
+    playbackRate: number;
+}
+export declare function createPlaybackRateChangedEvent(context: PlaybackApiEventsPackageContext): PlaybackRateChangedEvent;

package/types/packages/playback-api/playback-api-events/events/VolumeChangedEvent.d.ts

@@ -0,0 +1,6 @@
+import type { EventBase } from '../../../event-bus/Types';
+import type { PlaybackApiEventsPackageContext } from '../Types';
+export interface VolumeChangedEvent extends EventBase {
+    volume: number;
+}
+export declare function createVolumeChangedEvent(context: PlaybackApiEventsPackageContext): VolumeChangedEvent;

package/types/packages/playback-api/time-api/SeekableRangeProviderAtom.d.ts

@@ -0,0 +1,20 @@
+import type { EmptyObject } from '../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
+import type { ArrayAtom } from '../../core/state/ArrayStateAtom';
+import type { StateAtom } from '../../core/state/Types';
+import { CoreExportNames } from '../../core/Types';
+import type { CoreUtils } from '../../core/utils/Types';
+import type { VideoElementAtom } from '../../source/atoms/VideoElementAtom';
+import type { TrackAtom } from '../../stream-data-structure/track/TrackAtom';
+import type { ContextWithState } from '../../Types';
+import type { TimeRange } from './Types';
+type SeekableRangerProvider = {
+    range: TimeRange | undefined;
+};
+type Context = ContextHaving<{
+    [CoreExportNames.Utils]: CoreUtils;
+}, EmptyObject, ContextWithState>;
+export type SeekableRangeProviderAtom = StateAtom<SeekableRangerProvider>;
+export declare function createSeekableRangeProvider(context: Context, video: VideoElementAtom): SeekableRangeProviderAtom;
+export declare function createSeekableRangeProvider(context: Context, tracks: ArrayAtom<TrackAtom>): SeekableRangeProviderAtom;
+export {};

package/types/packages/playback-api/time-api/Types.d.ts

@@ -0,0 +1,36 @@
+import type { ApiManager } from '../../../../framework-types/api-manager/ApiManager';
+import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
+import type { ArrayAtom } from '../../core/state/ArrayStateAtom';
+import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../../core/Types';
+import type { CoreUtils } from '../../core/utils/Types';
+import type { VideoElementStateExportNames } from '../../playback/video-element-state/Types';
+import type { VideoElementStateAtom } from '../../playback/video-element-state/VideoElementStateAtom';
+import type { SourceStateAtom } from '../../source/atoms/SourceStateAtom';
+import type { SourceExportNames } from '../../source/Types';
+import type { SourcesApiExportNames } from '../../sources-api/Types';
+import type { ContextWithState } from '../../Types';
+import type { SeekableRangeProviderAtom } from './SeekableRangeProviderAtom';
+export type TimeRange = {
+    start: number;
+    end: number;
+};
+export type TimeApi = {
+    currentTime: number;
+    readonly duration: number;
+    readonly seekableRange: TimeRange;
+    playbackRate: number;
+};
+export type TimeApiPackageDependencies = {
+    [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [CoreExportNames.CoreEffects]: CoreEffects;
+    [CoreExportNames.Utils]: CoreUtils;
+    [VideoElementStateExportNames.VideoElementState]: VideoElementStateAtom;
+    [SourceExportNames.SourceState]: SourceStateAtom;
+    [SourcesApiExportNames.SourceApiManager]: ApiManager<TimeApi>;
+};
+export declare const SeekableRangeProviders = "seekable-range-providers";
+export type SeekableRangeProviders = {
+    [SeekableRangeProviders]: ArrayAtom<SeekableRangeProviderAtom>;
+};
+export type TimeApiPackageExports = SeekableRangeProviders;
+export type TimeApiPackageContext = ContextHaving<TimeApiPackageDependencies, TimeApiPackageExports, ContextWithState>;

package/types/packages/playback-api/volume-api/Types.d.ts

@@ -0,0 +1,19 @@
+import type { ApiManager } from '../../../../framework-types/api-manager/ApiManager';
+import type { EmptyObject } from '../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
+import type { CoreEffects, CoreExportNames } from '../../core/Types';
+import type { TargetVolumeStateAtom } from '../../playback/volume/TargetVolumeStateAtom';
+import type { TargetVolumeState } from '../../playback/volume/Types';
+import type { SourcesApiExportNames } from '../../sources-api/Types';
+import type { ContextWithState } from '../../Types';
+export type VolumeApi = {
+    volume: number;
+    muted: boolean;
+};
+export type VolumeApiPackageDependencies = {
+    [CoreExportNames.CoreEffects]: CoreEffects;
+    [TargetVolumeState]: TargetVolumeStateAtom;
+    [SourcesApiExportNames.SourceApiManager]: ApiManager<VolumeApi>;
+};
+export type VolumeApiPackageExports = EmptyObject;
+export type VolumeApiPackageContext = ContextHaving<VolumeApiPackageDependencies, VolumeApiPackageExports, ContextWithState>;

package/types/packages/playback-technology/PlaybackTechnology.package.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @packageDocumentation PlaybackTechnology.package
+ *
+ * Provides the PlaybackTechnologyComponent for managing and resolving playback technologies.
+ *
+ * Technologies register themselves with the component, declaring:
+ * - Their type (manifest-parsing, segment-loading, presentation)
+ * - What other types they depend on
+ * - What source types they handle
+ * - Whether they're supported in the current environment
+ *
+ * The component auto-resolves valid technology chains when technologies are added.
+ *
+ * Example chain: [manifest-parsing (dash)] -> [presentation (mse)]
+ * Example standalone: [presentation (native)]
+ *
+ * ### `PlaybackTechnology` Package Dependency Graph
+ * <svg aria-roledescription="flowchart-v2" role="graphics-document document" viewBox="-8 -8 292.578125 49" style="max-width: 292.578px; 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-PlaybackTechnology LE-Source" id="L-PlaybackTechnology-Source-0" d="M160.875,16.5L165.042,16.5C169.208,16.5,177.542,16.5,184.992,16.5C192.442,16.5,199.008,16.5,202.292,16.5L205.575,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(80.4375, 16.5)" data-id="PlaybackTechnology" data-node="true" id="flowchart-PlaybackTechnology-0" class="node default default flowchart-label"><rect height="33" width="160.875" y="-16.5" x="-80.4375" ry="0" rx="0" style="" class="basic label-container"/><g transform="translate(-72.9375, -9)" style="" class="label"><rect/><foreignObject height="18" width="145.875"><div style="display: inline-block; white-space: nowrap;" xmlns="http://www.w3.org/1999/xhtml"><span class="nodeLabel">PlaybackTechnology</span></div></foreignObject></g></g><g transform="translate(243.7265625, 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 { EmptyObject } from '../../Types';
+import type { PlaybackTechnologyDependencies, PlaybackTechnologyExports } from './Types';
+export declare const PlaybackTechnologyPackage: import("../../../framework-types/package-api/Package").Package<PlaybackTechnologyDependencies, PlaybackTechnologyExports, EmptyObject>;
+export default PlaybackTechnologyPackage;

package/types/packages/playback-technology/Types.d.ts

@@ -0,0 +1,54 @@
+import type { AnyRecord } from '../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../framework-types/execution-context/Types';
+import type { NamedTask, Task } from '../../../framework-types/task/Types';
+import type { BaseContext } from '../../../framework-types/Types';
+import type { EmptyObject } from '../../Types';
+import type { Constants, PlaybackTechnology, ResourceType } from '../core/Constants';
+import type { CoreEffects, CoreExportNames } from '../core/Types';
+import type { Resource } from '../source/atoms/SourceConfigAtom';
+import type { SourceStateAtom } from '../source/atoms/SourceStateAtom';
+import type { SourceExportNames } from '../source/Types';
+import type { ContextWithState } from '../Types';
+export declare enum PlaybackTechnologyEntryType {
+    Presentation = "presentation",
+    Manifest = "manifest"
+}
+export declare function isManifestEntry(entry: TechnologyEntry): entry is ManifestTechnologyEntry;
+export declare function isPresentationEntry(entry: TechnologyEntry): entry is PresentationTechnologyEntry;
+export interface TechnologyEntryBase<Exports extends AnyRecord = EmptyObject> {
+        type: PlaybackTechnologyEntryType;
+        name: string;
+        depends: PlaybackTechnologyEntryType[];
+        supported: (resource: Resource, playbackTechnology?: PlaybackTechnology) => boolean;
+        instantiate: NamedTask<Task<ContextHaving<PlaybackTechnologyDependencies, Exports, ContextWithState>, Resource, void>>;
+}
+export type PresentationTechnologyEntry<Exports extends AnyRecord = EmptyObject> = TechnologyEntryBase<Exports> & {
+        type: PlaybackTechnologyEntryType.Presentation;
+        supported: (resource: Resource, playbackTechnology: PlaybackTechnology) => boolean;
+};
+export type ManifestTechnologyEntry<Exports extends AnyRecord = EmptyObject> = TechnologyEntryBase<Exports> & {
+        type: PlaybackTechnologyEntryType.Manifest;
+        supported: (resource: Resource) => boolean;
+};
+export type TechnologyEntry<Exports extends AnyRecord = EmptyObject> = PresentationTechnologyEntry<Exports> | ManifestTechnologyEntry<Exports>;
+export interface TechnologyChain {
+    technologies: TechnologyEntry[];
+    playbackTechnology: PlaybackTechnology;
+}
+export type TechnologyPriority = {
+    manifest: ResourceType[];
+    playback: PlaybackTechnology[];
+};
+export type PlaybackTechnologyDependencies = {
+    [SourceExportNames.SourceState]: SourceStateAtom;
+    [CoreExportNames.CoreEffects]: CoreEffects;
+    [CoreExportNames.Constants]: Constants;
+};
+export type PlaybackTechnologyContext = ContextHaving<PlaybackTechnologyDependencies, EmptyObject, ContextWithState>;
+export interface PlaybackTechnologyComponent {
+        addTechnology: NamedTask<Task<BaseContext, TechnologyEntry<AnyRecord>, void>>;
+}
+export declare const PlaybackTechnologyComponent = "playback-technology-component";
+export type PlaybackTechnologyExports = {
+    [PlaybackTechnologyComponent]: PlaybackTechnologyComponent;
+};

package/types/packages/player-api/PlayerApi.package.d.ts

@@ -10,16 +10,14 @@
  */
 import type { ContextHaving } from '../../../framework-types/execution-context/Types';
 import type { BaseContext } from '../../../framework-types/Types';
-import { BundleExportNames } from '../../bundles/Types';
-import type { Logger } from '../core/utils/Logger';
-import type { createEventBus } from '../event-bus/EventBus';
+import type { createEventBus, extendEventBusTypes } from '../event-bus/EventBus';
 import type { EventBus } from '../event-bus/Types';
 import { EventBusExportNames } from '../event-bus/Types';
 import type { PlayerApi, PlayerEventMap } from './Types';
 import { PlayerApiExportNames } from './Types';
 type PlayerApiDependencies = {
-    [BundleExportNames.Logger]: Logger;
     [EventBusExportNames.CreateEventBus]: typeof createEventBus;
+    [EventBusExportNames.ExtendEventBusTypes]: typeof extendEventBusTypes;
 };
 type PlayerApiExports = {
     [PlayerApiExportNames.PlayerEventBus]: EventBus<PlayerEventMap>;

package/types/packages/player-api/Types.d.ts

@@ -1,4 +1,4 @@
-import type { LogLevel } from '../core/utils/Logger';
+import type { LogLevel, OnLogCallback } from '../../../framework-types/effects/LoggerEffect';
 import type { EventBus } from '../event-bus/Types';
 export declare enum PlayerApiExportNames {
     PlayerEventBus = "player-event-bus"
@@ -16,6 +16,7 @@ export type PlayerEventMap = {
 };
 export type PlayerEventBus = EventBus<PlayerEventMap>;
 export type PlayerApi = {
-    events: EventBus<PlayerEventMap>;
+    events: EventBus<PlayerEventMap, typeof PlayerEvent>;
     logLevel: LogLevel;
+    addOnLogCallback: (callback: OnLogCallback) => () => void;
 };

package/types/packages/presentation/mse/MsePlayback.package.d.ts

@@ -0,0 +1,3 @@
+import type { EmptyObject } from '../../../../framework-types/BaseTypes';
+export declare const MsePlaybackPackage: import("../../../../framework-types/package-api/Package").Package<EmptyObject, EmptyObject, EmptyObject>;
+export default MsePlaybackPackage;

package/types/packages/presentation/mse/playback-technology/Types.d.ts

@@ -0,0 +1,26 @@
+import type { EmptyObject } from '../../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../../framework-types/execution-context/Types';
+import type { CapabilitiesExportNames, PlatformCapabilities } from '../../../capabilities/Types';
+import type { Constants } from '../../../core/Constants';
+import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../../../core/Types';
+import type { PlaybackTechnologyComponent, PresentationTechnologyEntry } from '../../../playback-technology/Types';
+import type { Resource } from '../../../source/atoms/SourceConfigAtom';
+import type { ContextWithState } from '../../../Types';
+import type { MsePresentationStateAtom } from './atoms/MsePresentationStateAtom';
+export declare const MsePresentationState = "mse-presentation-state";
+export type MsePresentationState = {
+    [MsePresentationState]: MsePresentationStateAtom;
+};
+export interface MsePresentationStateData {
+    resource: Resource;
+}
+export type MsePlaybackTechnologyExports = EmptyObject;
+export type MsePlaybackTechnologyDependencies = {
+    [PlaybackTechnologyComponent]: PlaybackTechnologyComponent;
+    [CoreExportNames.Constants]: Constants;
+    [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [CoreExportNames.CoreEffects]: CoreEffects;
+    [CapabilitiesExportNames.PlatformCapabilities]: PlatformCapabilities;
+};
+export type MsePlaybackTechnologyContext = ContextHaving<MsePlaybackTechnologyDependencies, MsePlaybackTechnologyExports, ContextWithState>;
+export type MsePlaybackTechnology = PresentationTechnologyEntry<MsePresentationState>;

package/types/packages/presentation/mse/playback-technology/atoms/MsePresentationStateAtom.d.ts

@@ -0,0 +1,10 @@
+import type { EmptyObject } from '../../../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../../../framework-types/execution-context/Types';
+import type { StateAtom } from '../../../../core/state/Types';
+import type { Resource } from '../../../../source/atoms/SourceConfigAtom';
+import type { ContextWithState } from '../../../../Types';
+import type { MsePresentationStateData } from '../Types';
+export type MsePresentationStateAtom = StateAtom<MsePresentationStateData, EmptyObject>;
+type ExtendedContext = ContextHaving<EmptyObject, EmptyObject, ContextWithState>;
+export declare function createMsePresentationStateAtom(context: ExtendedContext, resource: Resource): MsePresentationStateAtom;
+export {};

package/types/packages/presentation/mse/presentation/MsePresentation.package.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @packageDocumentation Presentation.package
+ *
+ * Provides MSE interface to render the content from the PWX Stream
+ * data structure. It handles all of the related presentation logic:
+ *
+ * - Segment data queuing and appendage
+ * - Buffer clearing
+ * - timestamp offset handling
+ * - Gap handling
+ * - Video element related utilities
+ *
+ * ### `MsePresentation` Package Dependency Graph
+ * <svg aria-roledescription="flowchart-v2" role="graphics-document document" viewBox="-8 -8 16 16" style="max-width: 16px; 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"/><g class="edgeLabels"/><g class="nodes"/></g></g></svg>
+ */
+import type { ContextHaving, ContextUsing } from '../../../../../framework-types/execution-context/Types';
+import type { NamedTask, Task } from '../../../../../framework-types/task/Types';
+import type { EmptyObject } from '../../../../Types';
+import type { PlatformCapabilities } from '../../../capabilities/Types';
+import { CapabilitiesExportNames } from '../../../capabilities/Types';
+import type { MapStateAtom } from '../../../core/state/MapStateAtom';
+import type { StoreEffectFactory } from '../../../core/state/StoreEffectFactory';
+import type { StreamTimelineAtom } from '../../../core/state/stream-timeline/StreamTimelineMapAtom';
+import type { CoreExports } from '../../../core/Types';
+import { DataExportNames } from '../../../data/Types';
+import type SegmentProcessorErrors from '../../../segment-processing/Errors';
+import type { SegmentProcessingComponent, SegmentProcessorContext, SelectContainerFormatInput } from '../../../segment-processing/Types';
+import { SegmentProcessingExportNames } from '../../../segment-processing/Types';
+import type { SourceState } from '../../../source/atoms/SourceStateAtom';
+import { SourceExportNames } from '../../../source/Types';
+import type { ContainerFormat } from '../../../stream-data-structure/segment/SegmentDataAtom';
+import type { SelectionGroupAtom } from '../../../stream-data-structure/selection-group/SelectionGroupAtom';
+import type { StreamDataStructurePackageExports } from '../../../stream-data-structure/Types';
+import { StreamingState } from '../../../streaming/Types';
+import type { ContextWithState } from '../../../Types';
+import { MsePresentationState } from '../playback-technology/Types';
+import type { SegmentOutputCache } from './cache/Types';
+import { MsePresentationExportNames } from './Types';
+type Dependencies = {
+    [SourceExportNames.SourceState]: SourceState;
+    [DataExportNames.StreamTimeline]: StreamTimelineAtom;
+    [CapabilitiesExportNames.PlatformCapabilities]: PlatformCapabilities;
+    [SegmentProcessingExportNames.SegmentProcessingComponent]: SegmentProcessingComponent;
+    [SegmentProcessingExportNames.SegmentProcessorErrors]: typeof SegmentProcessorErrors;
+} & CoreExports & StreamDataStructurePackageExports & MsePresentationState & StreamingState;
+export type SelectContainerFormatTaskType = (context: PresentationContext) => NamedTask<Task<SegmentProcessorContext, SelectContainerFormatInput, ContainerFormat>>;
+export type PresentationExports = {
+    [MsePresentationExportNames.SelectContainerFormat]: SelectContainerFormatTaskType;
+};
+export type PresentationContext = ContextUsing<[
+    StoreEffectFactory<'segmentDataCache', SegmentOutputCache>,
+    StoreEffectFactory<'containerFormatMap', MapStateAtom<SelectionGroupAtom, ContainerFormat>>
+], ContextHaving<Dependencies, PresentationExports, ContextWithState>>;
+export declare const MsePresentationPackage: import("../../../../../framework-types/package-api/Package").Package<Dependencies, PresentationExports, EmptyObject>;
+export default MsePresentationPackage;

package/types/packages/presentation/{Types.d.ts → mse/presentation/Types.d.ts}

@@ -1,3 +1,3 @@
-export declare enum PresentationExportNames {
+export declare enum MsePresentationExportNames {
     SelectContainerFormat = "presentation-select-container-format-task"
 }

package/types/packages/presentation/mse/presentation/cache/Types.d.ts

@@ -0,0 +1,4 @@
+import type { DataStreamAtom } from '../../../../core/state/data-stream/DataStreamAtom';
+import type { SegmentAtom } from '../../../../stream-data-structure/segment/SegmentAtom';
+import type { SegmentDataAtom } from '../../../../stream-data-structure/segment/SegmentDataAtom';
+export type SegmentOutputCache = Map<SegmentAtom, DataStreamAtom<SegmentDataAtom>>;

package/types/packages/presentation/native/NativePlayback.package.d.ts

@@ -0,0 +1,4 @@
+import type { EmptyObject } from '../../../../framework-types/BaseTypes';
+import type { NativePlaybackDependencies } from './Types';
+export declare const NativePlaybackPackage: import("../../../../framework-types/package-api/Package").Package<NativePlaybackDependencies, EmptyObject, EmptyObject>;
+export default NativePlaybackPackage;

package/types/packages/presentation/native/Types.d.ts

@@ -0,0 +1,12 @@
+import type { EmptyObject } from '../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../framework-types/execution-context/Types';
+import { type createNetworkAtom } from '../../core/network/NetworkAtom';
+import type { NetworkTask } from '../../network/NetworkTask';
+import type { NetworkExportNames } from '../../network/Types';
+import type { ContextWithState } from '../../Types';
+export type NativePlaybackExports = EmptyObject;
+export type NativePlaybackDependencies = {
+    [NetworkExportNames.NetworkAtom]: typeof createNetworkAtom;
+    [NetworkExportNames.NetworkTask]: typeof NetworkTask;
+};
+export type NativePlaybackContext = ContextHaving<NativePlaybackDependencies, NativePlaybackExports, ContextWithState>;

package/types/packages/presentation/native/playback-technology/Types.d.ts

@@ -0,0 +1,26 @@
+import type { EmptyObject } from '../../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../../framework-types/execution-context/Types';
+import type { CapabilitiesExportNames, PlatformCapabilities } from '../../../capabilities/Types';
+import type { Constants } from '../../../core/Constants';
+import type { CoreEffects, CoreExportNames, CoreStateAtoms } from '../../../core/Types';
+import type { PlaybackTechnologyComponent, PresentationTechnologyEntry } from '../../../playback-technology/Types';
+import type { Resource } from '../../../source/atoms/SourceConfigAtom';
+import type { ContextWithState } from '../../../Types';
+import type { NativePresentationStateAtom } from './atoms/NativePresentationStateAtom';
+export declare const NativePresentationState = "native-presentation-state";
+export type NativePresentationState = {
+    [NativePresentationState]: NativePresentationStateAtom;
+};
+export interface NativePresentationStateData {
+    resource: Resource;
+}
+export type NativePlaybackTechnologyExports = EmptyObject;
+export type NativePlaybackTechnologyDependencies = {
+    [PlaybackTechnologyComponent]: PlaybackTechnologyComponent;
+    [CoreExportNames.Constants]: Constants;
+    [CoreExportNames.CoreStateAtoms]: CoreStateAtoms;
+    [CoreExportNames.CoreEffects]: CoreEffects;
+    [CapabilitiesExportNames.PlatformCapabilities]: PlatformCapabilities;
+};
+export type NativePlaybackTechnologyContext = ContextHaving<NativePlaybackTechnologyDependencies, NativePlaybackTechnologyExports, ContextWithState>;
+export type NativePlaybackTechnology = PresentationTechnologyEntry<NativePresentationState>;

package/types/packages/presentation/native/playback-technology/atoms/NativePresentationStateAtom.d.ts

@@ -0,0 +1,10 @@
+import type { EmptyObject } from '../../../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../../../framework-types/execution-context/Types';
+import type { StateAtom } from '../../../../core/state/Types';
+import type { Resource } from '../../../../source/atoms/SourceConfigAtom';
+import type { ContextWithState } from '../../../../Types';
+import type { NativePresentationStateData } from '../Types';
+export type NativePresentationStateAtom = StateAtom<NativePresentationStateData, EmptyObject>;
+type ExtendedContext = ContextHaving<EmptyObject, EmptyObject, ContextWithState>;
+export declare function createNativePresentationStateAtom(context: ExtendedContext, resource: Resource): NativePresentationStateAtom;
+export {};

package/types/packages/presentation/native/presentation/NativePresentation.package.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @packageDocumentation NativePresentation.package
+ *
+ * Provides native playback presentation for HLS (on Safari) and progressive
+ * resources. Sets `video.src` directly and lets the browser handle playback
+ * natively without MSE or segment processing.
+ *
+ * ### `NativePresentation` Package Dependency Graph
+ * <svg aria-roledescription="flowchart-v2" role="graphics-document document" viewBox="-8 -8 16 16" style="max-width: 16px; 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"/><g class="edgeLabels"/><g class="nodes"/></g></g></svg>
+ */
+import type { EmptyObject } from '../../../../Types';
+import type { NativePresentationDependencies } from './Types';
+export declare const NativePresentationPackage: import("../../../../../framework-types/package-api/Package").Package<NativePresentationDependencies, import("../../../../../framework-types/BaseTypes").EmptyObject, EmptyObject>;
+export default NativePresentationPackage;

package/types/packages/presentation/native/presentation/Types.d.ts

@@ -0,0 +1,12 @@
+import type { EmptyObject } from '../../../../../framework-types/BaseTypes';
+import type { ContextHaving } from '../../../../../framework-types/execution-context/Types';
+import type { CoreExports } from '../../../core/Types';
+import type { SourceState } from '../../../source/atoms/SourceStateAtom';
+import type { SourceExportNames } from '../../../source/Types';
+import type { ContextWithState } from '../../../Types';
+import type { NativePresentationState } from '../playback-technology/Types';
+export type NativePresentationExports = EmptyObject;
+export type NativePresentationDependencies = {
+    [SourceExportNames.SourceState]: SourceState;
+} & CoreExports & NativePresentationState;
+export type NativePresentationContext = ContextHaving<NativePresentationDependencies, NativePresentationExports, ContextWithState>;