@broadcastingplatforms/player 1.4.4 → 1.4.5

package/dist/components/bp-default-ui.d.ts

@@ -63,6 +63,6 @@ export declare class BPDefaultUI extends LitElement {
     private setupPlayer;
     private setupPlayerListeners;
     private renderDefaultControls;
-    protected render(): import("lit").TemplateResult<1>;
+    protected render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=bp-default-ui.d.ts.map

package/dist/components/bp-error-display.d.ts

@@ -24,7 +24,7 @@ export declare class BPErrorDisplay extends LitElement {
     static styles: import("lit").CSSResult;
     error: PlayerError | null;
     showCode: boolean;
-    render(): import("lit").TemplateResult<1> | null;
+    render(): import("lit-html").TemplateResult<1> | null;
     private renderIcon;
 }
 //# sourceMappingURL=bp-error-display.d.ts.map

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

@@ -23,7 +23,7 @@ export declare class BPOverlay extends LitElement {
     buttonMode: boolean;
     private getIcon;
     private getDefaultMessage;
-    render(): import("lit").TemplateResult<1> | null;
+    render(): import("lit-html").TemplateResult<1> | null;
     private renderIcon;
 }
 //# sourceMappingURL=bp-overlay.d.ts.map

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

@@ -82,6 +82,6 @@ export declare class BPPlayer extends LitElement {
     private clearVideoDimensions;
     private getContainerClasses;
     private getContainerStyle;
-    protected render(): import("lit").TemplateResult<1>;
+    protected render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=bp-player.d.ts.map

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

@@ -73,6 +73,17 @@ export interface PlayerCoreEventMap {
     videoelementchange: {
         video: HTMLVideoElement | null;
     };
+    /**
+     * Fires when the inner playback <video> element changes. For HLS this
+     * is the wrapper's `nativeEl` and matches `videoelementchange`. For
+     * Nano and LiveKit, the wrapper exposes a placeholder `nativeEl` and
+     * binds the real playback element asynchronously — this event fires
+     * once that real element is available, and again when it goes away.
+     * Analytics integrations (e.g. mux-embed) should listen here.
+     */
+    activevideoelementchange: {
+        video: HTMLVideoElement | null;
+    };
     error: PlayerError;
     destroy: void;
     statechange: {
@@ -99,6 +110,12 @@ export interface SourceLoadResult {
 export interface PlayerCore {
     readonly state: PlayerState;
     readonly videoElement: HTMLVideoElement | null;
+    /**
+     * The actively playing inner <video>, distinct from the wrapper. For
+     * Nano/LiveKit, this is null until the provider binds its real video
+     * element. Analytics integrations should monitor this.
+     */
+    readonly activeVideoElement: HTMLVideoElement | null;
     readonly bpLive: BPLiveService | null;
     readonly network: NetworkInterceptorController;
     /** Whether the player is ready (attached and can accept sources) */
@@ -148,6 +165,7 @@ export declare class PlayerCoreImpl implements PlayerCore {
     constructor();
     get state(): PlayerState;
     get videoElement(): HTMLVideoElement | null;
+    get activeVideoElement(): HTMLVideoElement | null;
     get bpLive(): BPLiveService | null;
     get network(): NetworkInterceptorController;
     get ready(): boolean;
@@ -164,6 +182,7 @@ export declare class PlayerCoreImpl implements PlayerCore {
     private destroyMediaElement;
     private createMediaElement;
     private attachMediaElementListeners;
+    private attachActiveVideoElementForwarding;
     private handleMediaEvent;
     unloadSource(): void;
     play(): Promise<void>;

package/dist/elements/hls-video.d.ts

@@ -19,6 +19,13 @@ declare class HlsVideoElement extends MediaTracksVideoElement {
     constructor();
     get config(): HlsVideoConfig | null;
     set config(value: HlsVideoConfig | null);
+    /**
+     * The actively playing inner <video> element. For HLS, the native
+     * element is the playback target (HLS.js attaches MSE to it), so this
+     * is always equal to `nativeEl`. Provided to give analytics integrations
+     * (e.g. mux-embed) a uniform contract across providers.
+     */
+    get activeVideoElement(): HTMLVideoElement | null;
     attributeChangedCallback(attrName: string, oldValue: string | null, newValue: string | null): void;
     disconnectedCallback(): void;
     load(): Promise<void>;

package/dist/elements/livekit-video.d.ts

@@ -24,6 +24,13 @@ declare class LiveKitVideoElement extends MediaTracksVideoElement {
     }): string;
     room: Room | null;
     constructor();
+    /**
+     * The actively playing inner <video> element, or null if no track has
+     * been subscribed yet. Distinct from `nativeEl`, which is the hidden
+     * placeholder from custom-media-element. Analytics integrations
+     * (e.g. mux-embed) must monitor this element, not `nativeEl`.
+     */
+    get activeVideoElement(): HTMLVideoElement | null;
     get config(): LiveKitVideoConfig | null;
     set config(value: LiveKitVideoConfig | null);
     get url(): string | null;

package/dist/elements/nano-video.d.ts

@@ -114,6 +114,13 @@ declare class NanoVideoElement extends MediaTracksVideoElement {
     }): string;
     api: NanoPlayerInstance | null;
     constructor();
+    /**
+     * The actively playing inner <video> element, or null if NanoPlayer has
+     * not bound one yet. Distinct from `nativeEl`, which is the hidden
+     * placeholder from custom-media-element. Analytics integrations
+     * (e.g. mux-embed) must monitor this element, not `nativeEl`.
+     */
+    get activeVideoElement(): HTMLVideoElement | null;
     get config(): NanoVideoConfig | null;
     set config(value: NanoVideoConfig | null);
     /** Full NanoPlayer source configuration from API */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@broadcastingplatforms/player",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "Universal video player web component built with Lit",
   "type": "module",
   "main": "dist/bp-player.js",
@@ -28,7 +28,6 @@
     "build:bundle": "node build.mjs",
     "build:prod": "NODE_ENV=production bun run build",
     "dev": "concurrently \"tsc --emitDeclarationOnly --watch --preserveWatchOutput\" \"node build.mjs --watch\"",
-    "dev:demo": "vite",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",