@broadcastingplatforms/player 0.0.0-dev.8eb2bc0 → 0.0.0-dev.c57124a

package/dist/components/bp-player.d.ts

@@ -3,6 +3,7 @@ import { type PlayerCore } from '../core/player-core';
 import type { PlayerState } from '../core/state';
 import type { ProviderType, ProviderConfig, SourceDescription } from '../providers/contract';
 import type { BPLiveService } from '../bplive/service';
+import { VideoRenditionList } from './video-rendition-list';
 export type BPPlayerReadyEvent = CustomEvent<PlayerCore>;
 declare global {
     interface HTMLElementTagNameMap {
@@ -12,28 +13,6 @@ declare global {
         'ready': BPPlayerReadyEvent;
     }
 }
-interface VideoRendition {
-    id: string;
-    width: number;
-    height: number;
-    bitrate: number;
-    selected: boolean;
-}
-declare class VideoRenditionList extends EventTarget {
-    [index: number]: VideoRendition;
-    private _player;
-    private _renditions;
-    private _cleanup;
-    constructor(player: BPPlayer);
-    get length(): number;
-    [Symbol.iterator](): Iterator<VideoRendition>;
-    get selectedIndex(): number;
-    set selectedIndex(index: number);
-    private _updateSelection;
-    _syncFromPlayer(): void;
-    _setupListeners(): void;
-    _destroy(): void;
-}
 export declare class BPPlayer extends LitElement {
     protected createRenderRoot(): HTMLElement | DocumentFragment;
     connectedCallback(): void;
@@ -46,12 +25,13 @@ export declare class BPPlayer extends LitElement {
     config?: ProviderConfig;
     debug: boolean;
     private _playerCore;
-    private _ready;
     private containerRef;
     private providerContainer;
     private eventCleanup;
     private stateReceivers;
     private _mutationObserver;
+    private _videoRenditions;
+    private _hasDispatchedReady;
     get player(): PlayerCore | null;
     get playerState(): PlayerState | null;
     get bpLive(): BPLiveService | null;
@@ -76,20 +56,24 @@ export declare class BPPlayer extends LitElement {
     get videoHeight(): number;
     get videoElement(): HTMLVideoElement | null;
     get providerType(): ProviderType | null;
-    get videoRenditions(): VideoRenditionList;
-    private _videoRenditions;
+    get videoRenditions(): VideoRenditionList | null;
     disconnectedCallback(): void;
     protected firstUpdated(_changedProperties: PropertyValues): void;
     protected updated(changedProperties: PropertyValues): void;
-    private getPlayableSource;
+    /**
+     * Initialize player core once. Called in firstUpdated.
+     */
+    private initPlayerCore;
+    /**
+     * Load source into player core. Player core handles provider switching internally.
+     */
+    private loadSource;
     private handleMutation;
     private registerStateReceiver;
     private unregisterStateReceiver;
     private propagateStateToAllReceivers;
     private setupEventForwarding;
     private updateStateAttributes;
-    private initPlayer;
-    private loadPlayableSource;
     private destroyPlayer;
     /** Update video dimension CSS variables */
     updateVideoDimensions(width: number, height: number): void;
@@ -99,5 +83,4 @@ export declare class BPPlayer extends LitElement {
     private getContainerStyle;
     protected render(): import("lit").TemplateResult<1>;
 }
-export {};
 //# sourceMappingURL=bp-player.d.ts.map

package/dist/components/index.d.ts

@@ -2,4 +2,5 @@ export { BPPlayer, type BPPlayerReadyEvent } from './bp-player';
 export { BPDefaultUI, type BPDefaultUIReadyEvent } from './bp-default-ui';
 export { BPErrorDisplay } from './bp-error-display';
 export { BPOverlay, type OverlayType } from './bp-overlay';
+export { VideoRenditionList, type VideoRendition, type VideoRenditionHost } from './video-rendition-list';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/video-rendition-list.d.ts

@@ -0,0 +1,38 @@
+import type { PlayerCore } from '../core/player-core';
+/**
+ * Represents a single video rendition/quality level.
+ * Compatible with media-chrome's VideoRendition interface.
+ */
+export interface VideoRendition {
+    id: string;
+    width: number;
+    height: number;
+    bitrate: number;
+    selected: boolean;
+}
+/**
+ * Interface for the player host that provides access to PlayerCore.
+ */
+export interface VideoRenditionHost {
+    readonly player: PlayerCore | null;
+}
+/**
+ * VideoRenditionList provides media-chrome compatibility for quality selection.
+ * It exposes video quality levels as an iterable list with selection support.
+ */
+export declare class VideoRenditionList extends EventTarget {
+    [index: number]: VideoRendition;
+    private _host;
+    private _renditions;
+    private _cleanup;
+    constructor(host: VideoRenditionHost);
+    get length(): number;
+    [Symbol.iterator](): Iterator<VideoRendition>;
+    get selectedIndex(): number;
+    set selectedIndex(index: number);
+    private _updateSelection;
+    _syncFromPlayer(): void;
+    _setupListeners(): void;
+    _destroy(): void;
+}
+//# sourceMappingURL=video-rendition-list.d.ts.map

package/dist/core/index.d.ts

@@ -1,5 +1,5 @@
 export { createPlayerCore, PlayerCoreImpl } from './player-core';
-export type { PlayerCore, PlayerCoreEventMap, PlayerCoreEventType } from './player-core';
+export type { PlayerCore, PlayerCoreEventMap, PlayerCoreEventType, SourceLoadResult } from './player-core';
 export { createInitialState, classifyNanoPlayerError, classifyLiveKitError, NANOPLAYER_NO_REPLAY_CODES } from './state';
 export type { PlayerState, QualityLevel, PresentationMode, ConnectionState, StreamType, ProviderType, PlayerError, ErrorCategory, } from './state';
 export { StateReceiverMixin, StateReceiverProps, isStateReceiverElement, forEachStateReceiverElement, propagateStateToReceiver, removeStateFromReceiver, } from './state-receiver';

package/dist/core/player-core.d.ts

@@ -1,5 +1,5 @@
 import type { PlayerState, QualityLevel, PresentationMode, ConnectionState, StreamType, PlayerError } from './state';
-import type { PlayerSource, ProviderConfig } from '../providers/contract';
+import type { ProviderType, PlayerSource, ProviderConfig } from '../providers/contract';
 import { BPLiveService } from '../bplive/service';
 export interface PlayerCoreEventMap {
     play: void;
@@ -17,6 +17,7 @@ export interface PlayerCoreEventMap {
         currentTime: number;
         duration: number;
     };
+    emptied: void;
     loadstart: void;
     loadedmetadata: {
         duration: number;
@@ -86,17 +87,35 @@ type EventListener<T> = (event: T) => void;
 export type CustomVideoElement = HTMLVideoElement & {
     nativeEl: HTMLVideoElement;
 };
+/**
+ * Result returned when a source is loaded, containing metadata from the source.
+ */
+export interface SourceLoadResult {
+    poster?: string;
+    videoWidth?: number;
+    videoHeight?: number;
+}
 export interface PlayerCore {
     readonly state: PlayerState;
     readonly videoElement: HTMLVideoElement | null;
     readonly bpLive: BPLiveService | null;
+    /** Whether the player is ready (attached and can accept sources) */
+    readonly ready: boolean;
+    /** Current provider type based on loaded source */
+    readonly providerType: ProviderType | null;
     addEventListener<K extends PlayerCoreEventType>(type: K | K[], listener: EventListener<PlayerCoreEventMap[K]>): void;
     removeEventListener<K extends PlayerCoreEventType>(type: K | K[], listener: EventListener<PlayerCoreEventMap[K]>): void;
-    loadSource(source: string | PlayerSource, container: HTMLElement, config?: ProviderConfig): Promise<{
-        poster?: string;
-        videoWidth?: number;
-        videoHeight?: number;
-    } | void>;
+    /**
+     * Attach the player to a container element. Call once during initialization.
+     * After attaching, you can set sources via the source property or loadSource().
+     */
+    attach(container: HTMLElement, config?: ProviderConfig): void;
+    /**
+     * Load a source. Handles provider switching automatically.
+     * If source type changes (e.g., video -> nano), the player will
+     * destroy the old element and create a new one.
+     */
+    loadSource(source: string | PlayerSource, container?: HTMLElement, config?: ProviderConfig): Promise<SourceLoadResult | void>;
     unloadSource(): void;
     play(): Promise<void>;
     pause(): void;
@@ -115,23 +134,32 @@ export declare class PlayerCoreImpl implements PlayerCore {
     private _state;
     private _mediaElement;
     private _container;
+    private _config;
     private _listeners;
     private _eventCleanup;
     private _destroyed;
     private _bpLive;
+    private _currentProviderType;
+    private _ready;
     constructor();
     get state(): PlayerState;
     get videoElement(): HTMLVideoElement | null;
     get bpLive(): BPLiveService | null;
+    get ready(): boolean;
+    get providerType(): ProviderType | null;
     addEventListener<K extends PlayerCoreEventType>(type: K | K[], listener: EventListener<PlayerCoreEventMap[K]>): void;
     removeEventListener<K extends PlayerCoreEventType>(type: K | K[], listener: EventListener<PlayerCoreEventMap[K]>): void;
     private dispatch;
     private updateState;
-    loadSource(source: string | PlayerSource, container: HTMLElement, config?: ProviderConfig): Promise<{
-        poster?: string;
-        videoWidth?: number;
-        videoHeight?: number;
-    } | void>;
+    /**
+     * Attach the player to a container. Call once during initialization.
+     */
+    attach(container: HTMLElement, config?: ProviderConfig): void;
+    loadSource(source: string | PlayerSource, container?: HTMLElement, config?: ProviderConfig): Promise<SourceLoadResult | void>;
+    /**
+     * Destroy the current media element and clean up listeners.
+     */
+    private destroyMediaElement;
     private createMediaElement;
     private attachMediaElementListeners;
     private handleMediaEvent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@broadcastingplatforms/player",
-  "version": "0.0.0-dev.8eb2bc0",
+  "version": "0.0.0-dev.c57124a",
   "description": "Universal video player web component built with Lit",
   "type": "module",
   "main": "dist/bp-player.js",
@@ -54,7 +54,7 @@
     "esbuild": "^0.24.0",
     "typescript": "^5.7.2",
     "vite": "^6.0.5",
-    "@broadcastingplatforms/web-connectors": "0.0.0-dev.8eb2bc0"
+    "@broadcastingplatforms/web-connectors": "0.0.0-dev.c57124a"
   },
   "license": "UNLICENSED",
   "publishConfig": {