eb-player 1.54.55 → 2.0.0

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

@@ -0,0 +1,104 @@
+/**
+ * HLS Snapshot Handler.
+ *
+ * Ported from component/engines/snapshot/hls.js (102 LOC).
+ *
+ * Creates a separate Hls instance for seekbar thumbnail preview rendering.
+ * The snapshot instance runs independently from the main playback engine with
+ * its own off-screen video element and low-buffer settings.
+ *
+ * Token injection (Pitfall 6): tokenManager is captured via closure,
+ * not stored on `this`, to avoid binding issues inside pLoader.
+ */
+import type { CDNTokenManager } from '../cdn-token-manager';
+interface SnapshotLoaderContext {
+    url: string;
+}
+interface SnapshotLoaderCallbacks {
+    onSuccess: (response: unknown, stats: unknown, context: unknown) => void;
+    onError: (error: unknown, context: unknown, response: unknown) => void;
+    onTimeout: (stats: unknown, context: unknown, response: unknown) => void;
+}
+interface SnapshotLoaderConfig {
+    [key: string]: unknown;
+}
+interface SnapshotHlsLoaderClass {
+    new (config: SnapshotLoaderConfig): {
+        load: (context: SnapshotLoaderContext, config: SnapshotLoaderConfig, callbacks: SnapshotLoaderCallbacks) => void;
+    };
+}
+interface SnapshotHlsDriverConfig {
+    startLevel?: number;
+    enableWebVTT?: boolean;
+    maxBufferLength?: number;
+    pLoader?: SnapshotHlsLoaderClass;
+    [key: string]: unknown;
+}
+interface SnapshotHlsEvents {
+    MANIFEST_LOADED: string;
+    [key: string]: string;
+}
+interface SnapshotHlsInstance {
+    on: (event: string, handler: (...args: unknown[]) => void) => void;
+    once: (event: string, handler: (...args: unknown[]) => void) => void;
+    trigger: (event: string, data?: unknown) => unknown;
+    loadSource: (src: string) => void;
+    attachMedia: (element: HTMLVideoElement) => void;
+    detachMedia: () => void;
+    destroy: () => void;
+    [key: string]: unknown;
+}
+interface SnapshotHlsConstructor {
+    new (config?: SnapshotHlsDriverConfig): SnapshotHlsInstance;
+    isSupported: () => boolean;
+    Events: SnapshotHlsEvents;
+    DefaultConfig: {
+        loader: SnapshotHlsLoaderClass;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface SnapshotConfig {
+    src?: string;
+    engineSettings?: {
+        extraParamsCallback?: ((status?: number | string) => Promise<Record<string, unknown>>) | null;
+        onCDNTokenError?: ((error: {
+            status: number | string;
+            errorCode: string;
+            errorType: string;
+        }) => void) | null;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare class HlsSnapshotHandler {
+    private readonly config;
+    private readonly tokenManager;
+    private driver;
+    private offscreenVideo;
+    private throttleTimeout;
+    private pendingSeekTime;
+    constructor(config: SnapshotConfig, tokenManager: CDNTokenManager | null);
+    /**
+     * Initialize the snapshot Hls instance using the CDN-loaded Hls constructor.
+     * Creates a separate Hls instance with minimal buffering for thumbnail generation.
+     */
+    init(HlsConstructor: SnapshotHlsConstructor): void;
+    /**
+     * Seek the snapshot player to the specified time.
+     * Throttled to avoid excessive seeks (250ms minimum interval).
+     */
+    take(time: number): void;
+    private applyPendingSeek;
+    /**
+     * Returns the off-screen video element used for thumbnail rendering.
+     * The seekbar displays this element in the tooltip to show preview frames.
+     */
+    getVideo(): HTMLVideoElement | null;
+    /**
+     * Destroy the snapshot Hls instance and clean up resources.
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=hls.d.ts.map

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

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

package/dist/build/types/engines/stall-watchdog.d.ts

@@ -0,0 +1,41 @@
+/**
+ * StallWatchdog - Automatic playback recovery for live streams.
+ *
+ * Detects silent stalls (video.currentTime not advancing) and escalates
+ * through recovery attempts before requesting a full stream reload.
+ *
+ * Ported from component/engines/common.js:
+ *   startStallWatchdog / stopStallWatchdog / recoverFromStall
+ *
+ * Escalation sequence (10s interval):
+ *   - Attempt 1 (10s stuck): calls onRecoverAttempt(1)
+ *   - Attempt 2 (20s stuck): calls onRecoverAttempt(2)
+ *   - Attempt 3 (30s stuck): calls onReloadRequired(), stops watchdog
+ */
+export interface StallWatchdogOptions {
+    video: HTMLVideoElement;
+    onRecoverAttempt: (attempt: number) => void;
+    onReloadRequired: () => void;
+    isCasting: () => boolean;
+}
+export declare class StallWatchdog {
+    private readonly video;
+    private readonly onRecoverAttempt;
+    private readonly onReloadRequired;
+    private readonly isCasting;
+    private intervalId;
+    private lastTime;
+    private stallAttempts;
+    constructor(options: StallWatchdogOptions);
+    /**
+     * Start the stall watchdog interval.
+     * Calls stop() first to ensure idempotent restart.
+     */
+    start(): void;
+    /**
+     * Stop the stall watchdog and reset all internal state.
+     */
+    stop(): void;
+    private tick;
+}
+//# sourceMappingURL=stall-watchdog.d.ts.map

package/dist/build/types/engines/stall-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-watchdog.d.ts","sourceRoot":"","sources":["../../../../src/engines/stall-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,CAAA;IACvB,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,SAAS,EAAE,MAAM,OAAO,CAAA;CACzB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IAEzC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAY;gBAErB,OAAO,EAAE,oBAAoB;IAOzC;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ,OAAO,CAAC,IAAI;CA4Bb"}

package/dist/build/types/event-bus.d.ts

@@ -0,0 +1,54 @@
+/**
+ * EventMap defines the typed event names and their payload types.
+ * - void events: listener receives no arguments
+ * - payload events: listener receives the typed payload
+ *
+ * This type will be extended as more events are identified in Phase 2/3.
+ */
+export interface EventMap {
+    'request-reload': void;
+    'ad-complete': void;
+    'cast-stop': void;
+    'error-fatal': {
+        code: string;
+        message: string;
+    };
+    'cast-start': {
+        src: string;
+    };
+}
+type EventListener<T> = T extends void ? () => void : (payload: T) => void;
+type EmitArgs<K extends keyof EventMap> = EventMap[K] extends void ? [event: K] : [event: K, payload: EventMap[K]];
+/**
+ * TypedEventBus provides signal-based inter-component communication.
+ * It is distinct from PlayerState (reactive values) — the EventBus handles
+ * one-shot signals and commands between components.
+ *
+ * Usage:
+ *   bus.on('request-reload', () => reload())
+ *   bus.emit('request-reload')
+ *   bus.on('error-fatal', (payload) => handleError(payload), { signal: ac.signal })
+ */
+export declare class TypedEventBus {
+    private readonly listeners;
+    constructor();
+    /**
+     * Register a listener for the given event.
+     * Pass an AbortSignal via options to auto-remove the listener when the signal aborts.
+     */
+    on<K extends keyof EventMap>(event: K, listener: EventListener<EventMap[K]>, options?: {
+        signal?: AbortSignal;
+    }): void;
+    /**
+     * Emit an event, calling all registered listeners.
+     * Void events require no payload argument; payload events require the payload.
+     */
+    emit<K extends keyof EventMap>(...args: EmitArgs<K>): void;
+    /**
+     * Remove all listeners from all events.
+     * After calling dispose(), all subsequent emit calls are no-ops.
+     */
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/build/types/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,gBAAgB,EAAE,IAAI,CAAA;IACtB,aAAa,EAAE,IAAI,CAAA;IACnB,WAAW,EAAE,IAAI,CAAA;IACjB,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9B;AAED,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;AAE1E,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,SAAS,IAAI,GAC9D,CAAC,KAAK,EAAE,CAAC,CAAC,GACV,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAEpC;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkD;;IAM5E;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EACzB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EACpC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,IAAI;IA2BP;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAiB1D;;;OAGG;IACH,OAAO,IAAI,IAAI;CAGhB"}

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

@@ -0,0 +1,27 @@
+/**
+ * Finite State Machine for player playback state transitions.
+ *
+ * The TRANSITIONS map defines all valid state transitions. The Proxy set trap
+ * in player-state.ts calls isValidTransition to enforce these rules.
+ */
+export type PlaybackState = 'idle' | 'loading' | 'playing' | 'paused' | 'buffering' | 'error' | 'ended';
+/**
+ * Maps each state to the set of states it may transition into.
+ *
+ * Design notes:
+ * - idle -> loading: initial load or post-stall reload
+ * - loading -> playing | error: stream starts or fails
+ * - playing -> paused | buffering | ended | error: normal playback events
+ * - paused -> playing | loading | idle: resume or stop
+ * - buffering -> playing | paused | idle | error: buffer recovered, user pause, or stall
+ *   - buffering -> idle is needed for the stall-watchdog recovery path (kick off reload)
+ *   - buffering -> paused is needed for live stream support (user pauses during buffer)
+ * - error -> loading: retry after error
+ * - ended -> loading | idle: restart playback or reset
+ */
+export declare const TRANSITIONS: Readonly<Record<PlaybackState, ReadonlyArray<PlaybackState>>>;
+/**
+ * Returns true if transitioning from `from` to `to` is valid per the FSM.
+ */
+export declare function isValidTransition(from: PlaybackState, to: PlaybackState): boolean;
+//# sourceMappingURL=fsm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fsm.d.ts","sourceRoot":"","sources":["../../../src/core/fsm.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,CAAA;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAQrF,CAAA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,aAAa,GAAG,OAAO,CAEjF"}

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

@@ -0,0 +1,51 @@
+/**
+ * Lightweight i18n module replacing Vue i18n.
+ *
+ * Translations are keyed using dot-notation (e.g., 'error.start').
+ * A KEY_MAP provides backward compatibility with the old full-sentence keys
+ * used in component/translations/ for Phase 2/3 compatibility.
+ */
+type LocaleMap = Record<string, string>;
+type TranslationMap = Record<string, LocaleMap>;
+/**
+ * KEY_MAP maps old full-sentence keys to new dot-notation keys.
+ * Provides Phase 2/3 backward compatibility with existing translation lookups.
+ */
+export declare const KEY_MAP: Record<string, string>;
+/**
+ * I18n class provides translation and interpolation for the player UI.
+ * Designed to grow as skin components are ported in Phase 3.
+ */
+export declare class I18n {
+    private currentLocale;
+    private readonly translations;
+    constructor(locale?: string);
+    /**
+     * Add or extend translations at runtime.
+     * Useful for skin components adding their own translation keys in Phase 3.
+     */
+    addTranslations(entries: TranslationMap): void;
+    /**
+     * Look up a translation key in the current locale.
+     * Falls back to English if not found in current locale.
+     * Falls back to the key string itself if not found in English either.
+     * Interpolates {variable} placeholders with provided values.
+     */
+    t(key: string, vars?: Record<string, string | number>): string;
+    /**
+     * Replace {varName} placeholders in a template string with provided values.
+     * Unmatched placeholders are left unchanged.
+     */
+    interpolate(template: string, vars: Record<string, string | number>): string;
+    /**
+     * Change the active locale for subsequent t() calls.
+     * Falls back to 'en' for unsupported locales.
+     */
+    setLocale(locale: string): void;
+    /**
+     * Return the current active locale code.
+     */
+    getLocale(): string;
+}
+export {};
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/core/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AACvC,KAAK,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAqB/C;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE1C,CAAA;AAoBD;;;GAGG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,MAAM,CAAC,EAAE,MAAM;IAK3B;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAM9C;;;;;OAKG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAqB9D;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAO5E;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}

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

@@ -0,0 +1,21 @@
+/**
+ * eb-player core public API barrel export.
+ *
+ * This file is the entry point for the Rollup build (rollup.config.ts).
+ * Import from this file to access all public core module exports.
+ *
+ * CSS import: base.css is imported here so Rollup's postcss plugin
+ * extracts it to dist/eb-player.css as part of the build.
+ */
+import './css/base.css';
+export { PlaybackState, TRANSITIONS, isValidTransition } from './fsm';
+export type { StateMap, Listener, PlayerState } from './types';
+export { createPlayerState } from './player-state';
+export { TypedEventBus } from './event-bus';
+export type { EventMap } from './event-bus';
+export { mergeConfig, DEFAULT_CONFIG } from './config';
+export type { PlayerConfig, SkinColors, EngineSettings } from './config';
+export { I18n } from './i18n';
+export { PlayerController } from './lifecycle';
+export { EngineStateSync } from './engine-state-sync';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,gBAAgB,CAAA;AAGvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAGrE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACtD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAGxE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/build/types/integrations/ads-manager.d.ts

@@ -0,0 +1,32 @@
+import type { PlayerConfig } from '../core/config';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+/**
+ * AdsManager manages the IMA SDK preroll ad lifecycle.
+ *
+ * - Loads the IMA SDK from CDN via loadScript
+ * - Gates displayContainer.initialize() on a user gesture when config.autoplay is false
+ *   (browser autoplay policy requirement — see Pitfall 2 in plan context)
+ * - Sets state.adPlaying based on IMA lifecycle events
+ * - Emits 'ad-complete' on TypedEventBus when all ads are done
+ * - Cleans up adsManager.destroy() and displayContainer.destroy() on abort
+ */
+export declare class AdsManager {
+    private imaAdsManager;
+    private imaDisplayContainer;
+    /**
+     * Initialize the IMA SDK preroll ad system.
+     * - Skips if config.preroll is false/undefined
+     * - If !config.autoplay: waits for user click on video element before initializing
+     *   (required by browser autoplay policies to avoid muted/blocked display contexts)
+     * - Loads IMA SDK, creates AdDisplayContainer, AdsLoader, and AdsRequest
+     * - Wires ad lifecycle events to PlayerState and TypedEventBus
+     */
+    init(config: PlayerConfig, state: PlayerState, bus: TypedEventBus, video: HTMLVideoElement, adsContainer: HTMLElement, signal: AbortSignal): Promise<void>;
+    /**
+     * Wait for a click event on the video element.
+     * Used to satisfy browser autoplay policies when autoplay is disabled.
+     */
+    private waitForUserGesture;
+}
+//# sourceMappingURL=ads-manager.d.ts.map

package/dist/build/types/integrations/ads-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ads-manager.d.ts","sourceRoot":"","sources":["../../../../src/integrations/ads-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAuEtD;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,mBAAmB,CAAqC;IAEhE;;;;;;;OAOG;IACG,IAAI,CACR,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,WAAW,EACzB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC;IAmEhB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAgB3B"}

package/dist/build/types/integrations/chromecast-manager.d.ts

@@ -0,0 +1,50 @@
+import type { PlayerConfig } from '../core/config';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+/**
+ * Public interface for the Chromecast driver returned by ChromecastManager.getDriver().
+ * Provides play/pause/seek/volume controls to route commands during active cast sessions.
+ */
+export interface CastjsDriver {
+    play(): void;
+    pause(): void;
+    seek(time: number): void;
+    volume(level: number): void;
+}
+/**
+ * Reset the shared driver singleton. For testing only.
+ */
+export declare function resetSharedDriverForTesting(): void;
+/**
+ * ChromecastManager loads the Castjs SDK from CDN and manages cast sessions.
+ * Writes to PlayerState (castAvailable, isCasting) and emits EventBus events
+ * ('cast-stop') without depending on any skin component.
+ */
+export declare class ChromecastManager {
+    private readonly signal;
+    private localDriver;
+    constructor(abortController: AbortController);
+    /**
+     * Initialize Chromecast integration.
+     * - Skips if config.chromecast is false
+     * - Loads Castjs from CDN
+     * - Creates the singleton driver if not already created
+     * - Wires driver events to state
+     * - Cleans up on abort
+     */
+    init(config: PlayerConfig, state: PlayerState, bus: TypedEventBus): Promise<void>;
+    /**
+     * Returns the Castjs driver instance for routing play/pause/seek/volume
+     * commands during an active cast session. Returns null if not initialized.
+     */
+    getDriver(): CastjsDriver | null;
+    /**
+     * Toggle cast: disconnect if connected, start casting if available.
+     */
+    toggleCast(state: PlayerState): void;
+    private applyMetadata;
+    private bindDriverEvents;
+    private buildCastOptions;
+    private registerAbortCleanup;
+}
+//# sourceMappingURL=chromecast-manager.d.ts.map

package/dist/build/types/integrations/chromecast-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromecast-manager.d.ts","sourceRoot":"","sources":["../../../../src/integrations/chromecast-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,IAAI,CAAA;IACZ,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAwBD;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAID;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,WAAW,CAA8B;gBAErC,eAAe,EAAE,eAAe;IAI5C;;;;;;;OAOG;IACG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvF;;;OAGG;IACH,SAAS,IAAI,YAAY,GAAG,IAAI;IAIhC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAapC,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/build/types/integrations/epg-manager.d.ts

@@ -0,0 +1,22 @@
+import type { PlayerConfig } from '../core/config';
+import type { PlayerState } from '../core/types';
+/**
+ * EpgManager fetches EPG (Electronic Program Guide) data from the EasyBroadcast
+ * EPG API and optionally polls on an interval.
+ *
+ * - Writes state.epgPrograms and state.epgFetchedAt
+ * - Non-critical: errors are logged but never thrown
+ * - Cleans up poll timer on abort signal
+ */
+export declare class EpgManager {
+    private pollTimer;
+    /**
+     * Start EPG fetch and optional polling.
+     * - Skips if config.epgContentId is undefined
+     * - Fetches immediately, then sets up interval polling if epgPolling is set
+     * - Registers abort listener to stop polling
+     */
+    start(config: PlayerConfig, state: PlayerState, signal: AbortSignal): Promise<void>;
+    private fetchEpg;
+}
+//# sourceMappingURL=epg-manager.d.ts.map

package/dist/build/types/integrations/epg-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epg-manager.d.ts","sourceRoot":"","sources":["../../../../src/integrations/epg-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,eAAe,CAAA;AAI5D;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAA8C;IAE/D;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAmB3E,QAAQ;CAkBvB"}

package/dist/build/types/integrations/index.d.ts

@@ -0,0 +1,6 @@
+export { ChromecastManager } from './chromecast-manager';
+export { EpgManager } from './epg-manager';
+export { P2PManager } from './p2p-manager';
+export { PlaylistManager } from './playlist-manager';
+export { AdsManager } from './ads-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/build/types/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA"}

package/dist/build/types/integrations/p2p-manager.d.ts

@@ -0,0 +1,33 @@
+import type { PlayerConfig } from '../core/config';
+/**
+ * Parameters for P2PManager.integrate().
+ */
+export interface P2PIntegrateParams {
+    video: HTMLVideoElement;
+    driver: unknown;
+    type: 'hls' | 'dash';
+    config: PlayerConfig;
+    signal: AbortSignal;
+}
+/**
+ * P2PManager integrates the EasyBroadcast P2P SDK.
+ *
+ * Loads the SDK from CDN, creates an EBLibrary instance, builds settings
+ * (resourceManager, swarmManager, statsOutput, playerInput), and calls
+ * integrate() + start(). Cleans up via stop() on abort.
+ *
+ * Port of component/engines/eb/start.js.
+ */
+export declare class P2PManager {
+    private lib;
+    /**
+     * Integrate the EasyBroadcast P2P SDK.
+     * - Skips if config.lib or config.manager is absent/false
+     * - Loads the SDK via loadScript
+     * - Builds integration settings from config
+     * - Calls lib.integrate() and lib.start()
+     * - Registers abort cleanup
+     */
+    integrate(params: P2PIntegrateParams): Promise<void>;
+}
+//# sourceMappingURL=p2p-manager.d.ts.map

package/dist/build/types/integrations/p2p-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p2p-manager.d.ts","sourceRoot":"","sources":["../../../../src/integrations/p2p-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAiClD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,gBAAgB,CAAA;IACvB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,KAAK,GAAG,MAAM,CAAA;IACpB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAiC;IAE5C;;;;;;;OAOG;IACG,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;CAmD3D"}

package/dist/build/types/integrations/playlist-manager.d.ts

@@ -0,0 +1,21 @@
+import type { PlayerConfig } from '../core/config';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+/**
+ * PlaylistManager manages episode/playlist navigation.
+ *
+ * Writes state.playlist from config, then listens for 'playlist-next' and
+ * 'playlist-prev' bus events to advance/decrement the episode index with
+ * wrap-around. Updates state.src when the current episode changes.
+ */
+export declare class PlaylistManager {
+    /**
+     * Initialize playlist from config.
+     * - Skips if config.playlist is undefined or empty
+     * - Writes state.playlist and state.currentEpisode = 0
+     * - Listens for playlist-next and playlist-prev events (cleaned up on abort)
+     */
+    init(config: PlayerConfig, state: PlayerState, bus: TypedEventBus, signal: AbortSignal): void;
+    private advance;
+}
+//# sourceMappingURL=playlist-manager.d.ts.map

package/dist/build/types/integrations/playlist-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlist-manager.d.ts","sourceRoot":"","sources":["../../../../src/integrations/playlist-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGtD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAiB7F,OAAO,CAAC,OAAO;CAMhB"}

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

@@ -0,0 +1,64 @@
+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';
+/**
+ * PlayerController manages the complete lifecycle of a player instance.
+ *
+ * Lifecycle:
+ *   1. Construct with config
+ *   2. mount(container) — apply CSS vars, set data-theme, register listeners with AbortSignal
+ *   3. setEngineSync(sync) — attach engine bridge to state
+ *   4. dispose() — abort all listeners, detach engine, clear references
+ *   5. Optionally re-mount with a fresh container (dispose() creates a new AbortController)
+ *
+ * AbortController pattern:
+ *   All listeners registered during mount() and setEngineSync() use the AbortController's
+ *   signal. Calling dispose() aborts the signal, removing all registered listeners atomically.
+ *   After dispose(), a fresh AbortController is created so the controller can be re-mounted.
+ */
+export declare class PlayerController {
+    readonly state: PlayerState;
+    readonly bus: TypedEventBus;
+    readonly config: PlayerConfig;
+    readonly i18n: I18n;
+    private abortController;
+    private _container;
+    private engineSync;
+    private get signal();
+    /**
+     * 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 runtime CSS custom property overrides and sets the data-theme attribute
+     * for brand theming (backward compat with primaryColor/skinColors consumer API).
+     *
+     * 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;
+    /**
+     * 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)
+     * - Clears container and engine references
+     * - Creates a fresh AbortController for potential re-mount
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/build/types/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;AAC7B,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;;;;;;;;;;;;;;GAcG;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;IAE1C,OAAO,KAAK,MAAM,GAEjB;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,WAAW,GAAG,IAAI,CAElC;gBAEW,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;IAUzC;;;;;;;;;;OAUG;IACH,KAAK,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IA6BnC;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAQ1C;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAehB"}

package/dist/build/types/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/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;AA8E9D;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,WAAW,CAoD1E;AAED,YAAY,EAAE,WAAW,EAAE,CAAA"}

package/dist/build/types/skin/bars/bottom-bar.d.ts

@@ -0,0 +1,16 @@
+import type { TemplateResult } from 'lit-html';
+import { BaseComponent } from '../base-component';
+/**
+ * BottomBar is a structural container for the seekbar and control buttons.
+ *
+ * Renders a controls row with dynamic slot divs based on the layout config.
+ * When no layout config is provided, falls back to DEFAULT_LAYOUT.
+ *
+ * The slot divs are empty containers — individual control components
+ * mount into them via SkinRoot.connectChildComponents().
+ */
+export declare class BottomBar extends BaseComponent {
+    protected onConnect(): void;
+    protected template(): TemplateResult;
+}
+//# sourceMappingURL=bottom-bar.d.ts.map

package/dist/build/types/skin/bars/bottom-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bottom-bar.d.ts","sourceRoot":"","sources":["../../../../../src/skin/bars/bottom-bar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAIjD;;;;;;;;GAQG;AACH,qBAAa,SAAU,SAAQ,aAAa;IAC1C,SAAS,CAAC,SAAS,IAAI,IAAI;IAI3B,SAAS,CAAC,QAAQ,IAAI,cAAc;CAmBrC"}