eb-player 1.54.57 → 2.0.0

package/dist/build/types/core/lifecycle.d.ts

@@ -0,0 +1,96 @@
+import { TypedEventBus } from './event-bus';
+import { I18n } from './i18n';
+import type { PlayerState } from './types';
+import type { PlayerConfig } from './config';
+import type { EngineStateSync } from './engine-state-sync';
+import type { SavedSelections } from './command-handler';
+/**
+ * PlayerController manages the complete lifecycle of a player instance.
+ *
+ * Lifecycle:
+ *   1. Construct with config
+ *   2. mount(container) — apply CSS vars, set data-theme, create SkinRoot, initialize integrations
+ *   3. setEngineSync(sync) — attach engine bridge to state
+ *   4. dispose() — disconnect SkinRoot, abort all signals, detach engine, clear references
+ *   5. Optionally re-mount with a fresh container (dispose() creates a new AbortController)
+ *
+ * Mount order:
+ *   1. CSS vars / data-theme applied to container
+ *   2. Config-derived state (isRtl, isRadio) set
+ *   3. SkinRoot connected (needs DOM) — creates video element and ads container
+ *   4. AutoHideController + KeyboardController wired
+ *   5. Integrations initialized (need skin DOM for ads)
+ *
+ * Dispose order (reverse of mount):
+ *   1. Engine detached
+ *   2. Bus disposed
+ *   3. AbortController aborted (cleans up all signal-based listeners)
+ *   4. SkinRoot disconnected
+ *   5. References nulled
+ */
+export declare class PlayerController {
+    readonly state: PlayerState;
+    readonly bus: TypedEventBus;
+    readonly config: PlayerConfig;
+    readonly i18n: I18n;
+    private abortController;
+    private _container;
+    private engineSync;
+    private skinRoot;
+    private commandHandler;
+    private chromecastManager;
+    private reloadCallback;
+    get signal(): AbortSignal;
+    /**
+     * The currently mounted container element, or null if not mounted / after dispose().
+     * Available for Phase 2 engine implementations that need access to the DOM context.
+     */
+    get container(): HTMLElement | null;
+    constructor(config: Partial<PlayerConfig>);
+    /**
+     * Attach the player to a DOM container element.
+     *
+     * Applies CSS vars and data-theme, creates the SkinRoot DOM scaffold,
+     * registers AutoHide/Keyboard controllers, and initializes integration
+     * managers based on config flags.
+     *
+     * CSS application order (later wins):
+     *   1. primaryColor → --eb-color-primary
+     *   2. skinColors.general → --eb-color-primary (overrides primaryColor)
+     *   3. skinColors.progressBar → --eb-color-progress
+     *   4. skinColors.volumeBar → --eb-color-volume
+     */
+    mount(container: HTMLElement): void;
+    /**
+     * Store a callback to invoke when request-reload fires.
+     * Called by eb-player.ts after mount() to wire the reload orchestration path.
+     */
+    setReloadCallback(callback: () => void): void;
+    /**
+     * Returns saved stream selections from the CommandHandler (quality, audioTrack, subtitleTrack).
+     * Returns defaults when no CommandHandler exists (e.g., noUi mode, no video element).
+     */
+    getSavedSelections(): SavedSelections;
+    /**
+     * Attach an engine bridge implementation to the state store.
+     * If an existing engine is attached, detach() is called first.
+     * The engine receives the PlayerState and the current AbortSignal.
+     */
+    setEngineSync(sync: EngineStateSync): void;
+    /**
+     * Dispose the player instance.
+     * - Calls engineSync.detach() if an engine is attached
+     * - Calls bus.dispose() to clear all event listeners
+     * - Aborts the AbortController (removes all signal-based listeners atomically)
+     * - Disconnects SkinRoot
+     * - Clears all references
+     * - Creates a fresh AbortController for potential re-mount
+     */
+    dispose(): void;
+    /**
+     * Initialize integration managers based on config flags.
+     * All integrations are async and non-critical — errors are caught and logged.
+     */
+    private initIntegrations;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/build/types/core/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/core/lifecycle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAU7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGxD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IAEnB,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,cAAc,CAAqB;IAE3C,IAAI,MAAM,IAAI,WAAW,CAExB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,WAAW,GAAG,IAAI,CAElC;gBAEW,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;IAczC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IA4EnC;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI7C;;;OAGG;IACH,kBAAkB,IAAI,eAAe;IAOrC;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAQ1C;;;;;;;;OAQG;IACH,OAAO,IAAI,IAAI;IAwBf;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAyEzB"}

package/dist/build/types/core/player-state.d.ts

@@ -0,0 +1,15 @@
+import type { StateMap, PlayerState } from './types';
+/**
+ * Creates a Proxy-based reactive PlayerState instance.
+ *
+ * The Proxy set trap enforces three rules:
+ * 1. Non-plain objects (class instances) are rejected with a TypeError
+ * 2. `playbackState` assignments are validated via the FSM transition guard
+ * 3. Assigning the same value is a no-op (no subscriber notification)
+ *
+ * Subscribers are registered via `state.on('propertyName', callback, { signal })`.
+ * Pass an AbortController signal to clean up subscriptions automatically.
+ */
+export declare function createPlayerState(initial?: Partial<StateMap>): PlayerState;
+export type { PlayerState };
+//# sourceMappingURL=player-state.d.ts.map

package/dist/build/types/core/player-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-state.d.ts","sourceRoot":"","sources":["../../../../src/core/player-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAY,WAAW,EAAE,MAAM,SAAS,CAAA;AAoG9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,WAAW,CAuD1E;AAED,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/dist/build/types/core/types.d.ts

@@ -0,0 +1,84 @@
+import type { PlaybackState } from './fsm';
+/**
+ * A single EPG (Electronic Program Guide) entry.
+ */
+export interface EpgProgram {
+    title: string;
+    start: number;
+    end: number;
+    lang: string;
+}
+/**
+ * A chapter marker within the video timeline.
+ */
+export interface ChapterMark {
+    title: string;
+    startTime: number;
+    endTime: number;
+}
+/**
+ * A single item in a playlist.
+ */
+export interface PlaylistItem {
+    src: string;
+    title: string;
+    image: string;
+    duration: number;
+}
+/**
+ * The complete map of all reactive state properties in the player.
+ * Used by PlayerState (Proxy-based reactive store).
+ */
+export interface StateMap {
+    playbackState: PlaybackState;
+    volume: number;
+    currentTime: number;
+    duration: number;
+    muted: boolean;
+    bufferedEnd: number;
+    isLive: boolean;
+    qualityLevels: unknown[];
+    currentQuality: number;
+    audioTracks: unknown[];
+    currentAudioTrack: number;
+    subtitleTracks: unknown[];
+    currentSubtitleTrack: number;
+    playbackRate: number;
+    error: string | null;
+    src: string;
+    isFullscreen: boolean;
+    isPip: boolean;
+    isCasting: boolean;
+    controlsVisible: boolean;
+    settingsOpen: boolean;
+    socialsOpen: boolean;
+    infoOpen: boolean;
+    adPlaying: boolean;
+    castAvailable: boolean;
+    isRtl: boolean;
+    isRadio: boolean;
+    isIOS: boolean;
+    isSyncWithLive: boolean;
+    epgPrograms: EpgProgram[];
+    epgFetchedAt: number;
+    chapters: ChapterMark[];
+    playlist: PlaylistItem[];
+    currentEpisode: number;
+    reconnecting: boolean;
+    toast: string | null;
+}
+/**
+ * Per-property subscriber callback type.
+ * Receives the new value and the previous value.
+ */
+export type Listener<T> = (value: T, prev: T) => void;
+/**
+ * The public interface for the player state object.
+ * Combines all state properties with the subscription method.
+ */
+export type PlayerState = StateMap & {
+    on: <K extends keyof StateMap>(key: K, listener: Listener<StateMap[K]>, options?: {
+        signal?: AbortSignal;
+    }) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/build/types/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IAEvB,aAAa,EAAE,aAAa,CAAA;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;IACf,aAAa,EAAE,OAAO,EAAE,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,OAAO,EAAE,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,cAAc,EAAE,OAAO,EAAE,CAAA;IACzB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;IAGlB,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,OAAO,CAAA;IAClB,aAAa,EAAE,OAAO,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;IACd,cAAc,EAAE,OAAO,CAAA;IACvB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IAGtB,YAAY,EAAE,OAAO,CAAA;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAErD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG;IACnC,EAAE,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAC3B,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAC/B,IAAI,CAAA;CACV,CAAA"}

package/dist/build/types/eb-player-standalone.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Standalone entry point — used for the generated player bundle (not the npm UMD build).
+ *
+ * This file is resolved by Rollup with @rollup/plugin-virtual injecting the brand config
+ * from 'virtual:brand-config' at build time. The merged config is passed to start()
+ * automatically if config.start is truthy (the default).
+ *
+ * Import chain:
+ *   eb-player-standalone.ts → eb-player.ts (facade) + virtual:brand-config (brand config)
+ */
+export { start, stop, destroy } from './eb-player';
+//# sourceMappingURL=eb-player-standalone.d.ts.map

package/dist/build/types/eb-player-standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eb-player-standalone.d.ts","sourceRoot":"","sources":["../../../src/eb-player-standalone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA"}

package/dist/build/types/eb-player.d.ts

@@ -0,0 +1,43 @@
+/**
+ * EBPlayer facade — consumer-facing API layer.
+ *
+ * Provides the window.EBPlayer interface that existing consumers use:
+ *   - window.EBPlayer.start(config) — synchronously returns a PlayerReference
+ *   - window.EBPlayer.stop()        — detaches the active engine (skin stays mounted)
+ *   - window.EBPlayer.destroy()     — disposes the controller (tears down everything)
+ *
+ * The facade tracks one active controller and one active engine at module level.
+ * Multiple start() calls dispose the previous instance before creating a new one.
+ */
+import type { PlayerState } from './core/types';
+import type { PlayerConfig } from './core/config';
+/**
+ * The PlayerReference returned by start().
+ * Gives consumers direct control over the active stream.
+ */
+export interface PlayerReference {
+    /** Open a stream URL. Detects protocol from extension (.m3u8 → HLS, .mpd → DASH). */
+    open(src: string): void;
+    /** Close the active stream (detaches engine; skin remains mounted). */
+    close(): void;
+    /** Current player state (read-only reference to the reactive state store). */
+    readonly state: PlayerState;
+}
+/**
+ * Start the player with the given config.
+ * If a player is already running, it is disposed before the new one is created.
+ *
+ * Returns a PlayerReference synchronously — never returns a Promise.
+ */
+export declare function start(runtimeConfig: Partial<PlayerConfig>): PlayerReference;
+/**
+ * Stop the active stream.
+ * Detaches the engine without disposing the controller (skin stays mounted).
+ */
+export declare function stop(): void;
+/**
+ * Destroy the player completely.
+ * Disposes the controller (tears down skin, events, and all resources).
+ */
+export declare function destroy(): void;
+//# sourceMappingURL=eb-player.d.ts.map

package/dist/build/types/eb-player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eb-player.d.ts","sourceRoot":"","sources":["../../../src/eb-player.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGjD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,qFAAqF;IACrF,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,uEAAuE;IACvE,KAAK,IAAI,IAAI,CAAA;IACb,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAC5B;AA4DD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,eAAe,CAuJ3E;AAED;;;GAGG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAK3B;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAU9B"}

package/dist/build/types/engine-state-sync.d.ts

@@ -0,0 +1,38 @@
+import type { PlayerState } from './types';
+/**
+ * EngineStateSync is the abstract base class defining the contract for Phase 2
+ * engine bridge implementations (HLS, DASH).
+ *
+ * Phase 2 HLS and DASH engines extend this class to bridge DOM video events
+ * to the PlayerState store. The attach() method receives the PlayerState and
+ * an AbortSignal for automatic cleanup — engines register video element
+ * event listeners using the signal to ensure zero-leak cleanup on dispose().
+ *
+ * Usage pattern in Phase 2:
+ *   class HlsEngineSync extends EngineStateSync {
+ *     attach(state: PlayerState, signal: AbortSignal): void {
+ *       video.addEventListener('timeupdate', () => { state.currentTime = video.currentTime }, { signal })
+ *     }
+ *     detach(): void {
+ *       this.driver?.destroy()
+ *     }
+ *   }
+ */
+export declare abstract class EngineStateSync {
+    /**
+     * Called by PlayerController.setEngineSync() to bridge engine events to state.
+     * Implementations should register all event listeners using { signal } so they
+     * are automatically removed when the AbortController is aborted on dispose().
+     *
+     * @param state - The reactive PlayerState to write engine events into
+     * @param signal - AbortSignal tied to the PlayerController's lifecycle
+     */
+    abstract attach(state: PlayerState, signal: AbortSignal): void;
+    /**
+     * Called by PlayerController.dispose() or when a new engine replaces this one.
+     * Implementations should clean up engine-specific resources (e.g., driver.destroy()).
+     * Signal-based event listeners are automatically removed by the AbortController.
+     */
+    abstract detach(): void;
+}
+//# sourceMappingURL=engine-state-sync.d.ts.map

package/dist/build/types/engine-state-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-state-sync.d.ts","sourceRoot":"","sources":["../../../src/core/engine-state-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,eAAe;IACnC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAE9D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,IAAI,IAAI;CACxB"}

package/dist/build/types/engines/abr/dash.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DASH Custom ABR Rule
+ *
+ * Ported from component/engines/abr/dash.js
+ *
+ * Implements a buffer-and-throughput aware adaptive bitrate rule for dash.js.
+ * Applied via driver.addABRCustomRule('qualitySwitchRules', 'CustomAbrRule', factory).
+ */
+interface SwitchRequestInstance {
+    quality: number;
+    reason: string;
+    priority: number;
+}
+interface SwitchRequestFactory {
+    (context: unknown): {
+        create: () => SwitchRequestInstance;
+    };
+    PRIORITY: {
+        STRONG: number;
+    };
+}
+interface SingletonFactory<T> {
+    (context: unknown): {
+        getInstance: () => T;
+    };
+}
+interface AbrControllerInstance {
+    getQualityFor: (mediaType: string, streamInfo: unknown) => number;
+}
+interface RulesContextInstance {
+    getMediaInfo: () => {
+        type: string;
+        bitrateList: Array<{
+            bandwidth: number;
+        }>;
+        representationCount: number;
+    };
+    getAbrController: () => AbrControllerInstance;
+}
+interface FactoryMakerLike {
+    getClassFactoryByName: (name: string) => SwitchRequestFactory;
+    getSingletonFactoryByName: (name: string) => SingletonFactory<unknown>;
+    getClassFactory: (fn: AbrRuleFunction) => unknown;
+}
+interface AbrRuleFunction {
+    (): {
+        getMaxIndex: (rulesContext: RulesContextInstance) => SwitchRequestInstance;
+    };
+    __dashjs_factory_name: string;
+}
+export interface DashjsForAbr {
+    FactoryMaker: FactoryMakerLike;
+}
+export declare function createDashAbrRule(dashjs: DashjsForAbr): unknown;
+export {};
+//# sourceMappingURL=dash.d.ts.map

package/dist/build/types/engines/abr/dash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dash.d.ts","sourceRoot":"","sources":["../../../../../src/engines/abr/dash.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,UAAU,oBAAoB;IAC5B,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;KAAE,CAAA;IAC3D,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7B;AAED,UAAU,gBAAgB,CAAC,CAAC;IAC1B,CAAC,OAAO,EAAE,OAAO,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAC7C;AAwBD,UAAU,qBAAqB;IAC7B,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,MAAM,CAAA;CAClE;AAED,UAAU,oBAAoB;IAC5B,YAAY,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,KAAK,CAAC;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5G,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;CAC9C;AAED,UAAU,gBAAgB;IACxB,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,oBAAoB,CAAA;IAC7D,yBAAyB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACtE,eAAe,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,OAAO,CAAA;CAClD;AAED,UAAU,eAAe;IACvB,IAAI;QAAE,WAAW,EAAE,CAAC,YAAY,EAAE,oBAAoB,KAAK,qBAAqB,CAAA;KAAE,CAAA;IAClF,qBAAqB,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,gBAAgB,CAAA;CAC/B;AAyCD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAwJ/D"}

package/dist/build/types/engines/abr/hls.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Custom HLS ABR controller.
+ *
+ * Ported from component/engines/abr/hls.js (509 LOC).
+ *
+ * Creates a class that extends hls.js's built-in ABR controller and overrides
+ * nextAutoLevel with bandwidth-aware and buffer-level-based quality selection.
+ *
+ * Usage: pass the result as `abrController` in the Hls constructor config.
+ *
+ * Note: hls.js internals are accessed via type assertions because the library
+ * does not export its internal controller types (Open Question 3 in RESEARCH.md).
+ */
+interface AbrHlsLevel {
+    bitrate: number;
+    loaded?: {
+        bytes: number;
+        duration: number;
+    };
+    realBitrate?: number;
+}
+interface AbrHlsMedia {
+    currentTime: number;
+    playbackRate: number;
+    paused: boolean;
+    readyState: number;
+}
+interface AbrHlsConfig {
+    maxBufferLength: number;
+    [key: string]: unknown;
+}
+interface AbrHlsInstance {
+    on: (event: string, handler: (event: string, data: unknown) => void, context?: unknown) => void;
+    off: (event: string, handler: (event: string, data: unknown) => void, context?: unknown) => void;
+    levels: AbrHlsLevel[];
+    currentLevel: number;
+    media: AbrHlsMedia | null;
+    config: AbrHlsConfig;
+    autoLevelEnabled?: boolean;
+}
+interface AbrHlsEvents {
+    FRAG_LOADING: string;
+    FRAG_LOADED: string;
+    FRAG_BUFFERED: string;
+    LEVEL_LOADED: string;
+    ERROR: string;
+}
+interface AbrHlsConstructorLike {
+    Events: AbrHlsEvents;
+    DefaultConfig: {
+        abrController?: AbrControllerConstructor;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+interface AbrControllerConstructor {
+    new (hlsInstance: AbrHlsInstance, ...args: unknown[]): AbrControllerInstance;
+    prototype: AbrControllerInstance;
+}
+interface AbrControllerInstance {
+    hls: AbrHlsInstance;
+    destroy(): void;
+    registerListeners?: () => void;
+    unregisterListeners?: () => void;
+    clearTimer?: () => void;
+    fragCurrent?: HlsFragment | null;
+    partCurrent?: HlsFragPart | null;
+    timer?: ReturnType<typeof setInterval> | undefined;
+    onCheck?: () => void;
+    [key: string]: unknown;
+}
+interface HlsFragment {
+    type: string;
+    sn: number | 'initSegment';
+    level: number;
+    duration: number;
+    stats: HlsFragStats;
+    [key: string]: unknown;
+}
+interface HlsFragPart {
+    duration: number;
+    stats: HlsFragStats;
+}
+interface HlsFragStats {
+    loading: {
+        start: number;
+    };
+    parsing: {
+        end: number;
+    };
+    loaded: number;
+    tload?: number;
+    tfirst?: number;
+    trequest?: number;
+    aborted?: boolean;
+}
+/**
+ * Factory that creates a custom ABR controller class extending hls.js's built-in
+ * ABR controller. Takes the Hls constructor so it can access Events and DefaultConfig.
+ *
+ * The returned class can be passed as `abrController` in the Hls constructor config.
+ */
+export declare function createHlsAbrController(HlsConstructor: AbrHlsConstructorLike): AbrControllerConstructor;
+export {};
+//# sourceMappingURL=hls.d.ts.map

package/dist/build/types/engines/abr/hls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hls.d.ts","sourceRoot":"","sources":["../../../../../src/engines/abr/hls.ts"],"names":[],"mappings":"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"}

package/dist/build/types/engines/base-engine.d.ts

@@ -0,0 +1,56 @@
+/**
+ * BaseEngine — abstract base class for HLS and DASH engine implementations.
+ *
+ * Extends EngineStateSync with concrete lifecycle management:
+ *   - stores video, state, signal, bus, config
+ *   - binds native video element events to PlayerState
+ *   - delegates engine-specific startup / teardown to onAttach / onDetach
+ *   - delegates stall recovery to recoverFromStall (engine-specific)
+ */
+import { EngineStateSync } from '../core/engine-state-sync';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+import type { PlayerConfig } from '../core/config';
+export declare abstract class BaseEngine extends EngineStateSync {
+    protected video: HTMLVideoElement | null;
+    protected state: PlayerState | null;
+    protected signal: AbortSignal | null;
+    protected bus: TypedEventBus | null;
+    protected config: PlayerConfig | null;
+    private watchdog;
+    /**
+     * Promise that resolves when the engine driver (hls.js/dash.js) is created
+     * and ready for integration (e.g., P2P SDK). Resolved inside onAttach().
+     */
+    readonly driverReady: Promise<void>;
+    protected resolveDriverReady: () => void;
+    constructor();
+    attach(state: PlayerState, signal: AbortSignal): void;
+    detach(): void;
+    protected startWatchdog(): void;
+    protected stopWatchdog(): void;
+    setConfig(config: PlayerConfig): void;
+    setBus(bus: TypedEventBus): void;
+    setVideo(video: HTMLVideoElement): void;
+    protected bindVideoEvents(video: HTMLVideoElement, state: PlayerState, signal: AbortSignal): void;
+    protected abstract recoverFromStall(attempt: number): void;
+    protected abstract onAttach(): Promise<void> | void;
+    protected abstract onDetach(): void;
+    abstract setQuality(index: number): void;
+    abstract setAudioTrack(index: number): void;
+    abstract setSubtitle(index: number): void;
+    abstract setPlaybackRate(rate: number): void;
+    abstract seekToLive(): void;
+    /**
+     * Seek to a specific time. Default implementation sets video.currentTime.
+     * HLS engine overrides this for live streams to reset hls.js stream controller.
+     */
+    seek(time: number): void;
+    /**
+     * Returns the underlying driver instance (hls.js or dash.js player).
+     * Used by P2PManager to integrate with the streaming library.
+     * Returns null before engine initialization completes.
+     */
+    abstract getDriver(): unknown | null;
+}
+//# sourceMappingURL=base-engine.d.ts.map

package/dist/build/types/engines/base-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-engine.d.ts","sourceRoot":"","sources":["../../../../src/engines/base-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,8BAAsB,UAAW,SAAQ,eAAe;IACtD,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAO;IAC/C,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAO;IAC1C,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAO;IAC3C,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAO;IAC1C,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAO;IAE5C,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,SAAS,CAAC,kBAAkB,EAAG,MAAM,IAAI,CAAA;;IAazC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAMrD,MAAM,IAAI,IAAI;IAed,SAAS,CAAC,aAAa,IAAI,IAAI;IAmB/B,SAAS,CAAC,YAAY,IAAI,IAAI;IAa9B,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIrC,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAIhC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAQvC,SAAS,CAAC,eAAe,CACvB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,WAAW,GAClB,IAAI;IA0FP,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAC1D,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IACnD,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI;IAMnC,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IACxC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAC3C,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IACzC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAC5C,QAAQ,CAAC,UAAU,IAAI,IAAI;IAE3B;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB;;;;OAIG;IACH,QAAQ,CAAC,SAAS,IAAI,OAAO,GAAG,IAAI;CACrC"}

package/dist/build/types/engines/cdn-loader.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CDN Script Loader
+ *
+ * Replaces the scriptjs-based component/utils/load.js with direct <script> tag injection.
+ * Resolves with window[globalName] when the script loads, or rejects with a clear error.
+ */
+export interface LoadScriptOptions {
+    timeout?: number;
+}
+/**
+ * Loads a CDN script by injecting a <script> tag into document.head and resolves
+ * with window[globalName] once the script has loaded.
+ *
+ * - If window[globalName] already exists, resolves immediately (no re-injection).
+ * - If the script loads but the global is not on window, rejects with a descriptive error.
+ * - If script.onerror fires, rejects with a descriptive error.
+ * - If neither onload nor onerror fires within `options.timeout` ms (default 10000), rejects.
+ */
+export declare function loadScript<T>(url: string, globalName: string, options?: LoadScriptOptions): Promise<T>;
+//# sourceMappingURL=cdn-loader.d.ts.map

package/dist/build/types/engines/cdn-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdn-loader.d.ts","sourceRoot":"","sources":["../../../../src/engines/cdn-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,CAAC,CAAC,CAyCZ"}