eb-player 2.0.20 → 2.0.21

package/dist/build/types/src/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/src/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/src/integrations/ads-manager.d.ts

@@ -0,0 +1,79 @@
+import type { PlayerConfig } from '../core/config';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+/**
+ * G-07-9: backstop for an intro that never signals completion (all three
+ * IntroStreamManager completion triggers lost, e.g. a swallowed throw inside
+ * its init() that lifecycle.ts only logs). Chosen to exceed any plausible
+ * intro asset so it can never truncate a real intro — it converts an
+ * infinite hang into a bounded one.
+ */
+export declare const INTRO_DEFERRAL_TIMEOUT_MS = 120000;
+/**
+ * G-07-11: bound from ad-leg entry to the AdsManager being handed back by
+ * the loader. It spans the gesture wait, loadScript, displayContainer
+ * initialization, requestAds and the ads response, and stops there —
+ * creative fetch, buffering and render are IMA's and are not charged to it.
+ * Must stay below MAIN_OPEN_FALLBACK_MS (eb-player.ts) so this more precise
+ * mechanism resolves first.
+ */
+export declare const AD_LEG_TIMEOUT_MS = 20000;
+/**
+ * AdsManager manages the IMA SDK preroll ad lifecycle.
+ *
+ * - Defers IMA SDK loading until an intro stream (if configured) completes,
+ *   bounded by INTRO_DEFERRAL_TIMEOUT_MS (G-07-9)
+ * - Observes a user gesture on the player root starting before that
+ *   deferral, so a click during the intro satisfies the browser autoplay
+ *   gesture requirement without a second click after the intro (G-07-11)
+ * - Guarantees the ad leg completes exactly once, bounded by
+ *   AD_LEG_TIMEOUT_MS until the loader hands back an AdsManager (G-07-11)
+ * - Sets state.adPlaying based on IMA lifecycle events
+ * - Emits 'ad-complete' on TypedEventBus exactly once per instance
+ * - Cleans up adsManager.destroy() and displayContainer.destroy() on abort,
+ *   and on any completion path that never obtained an AdsManager
+ */
+export declare class AdsManager {
+    private imaAdsManager;
+    private imaDisplayContainer;
+    /**
+     * Initialize the IMA SDK preroll ad system.
+     * - Skips if config.ad is undefined
+     * - Defers initialization while config.preroll is set, until
+     *   'intro-stream-complete' fires or INTRO_DEFERRAL_TIMEOUT_MS elapses
+     *   (G-07-9)
+     * - If !config.autoplay: observes a click anywhere in the player before
+     *   the deferral, and consumes it after (required by browser autoplay
+     *   policies to avoid muted/blocked display contexts)
+     * - The ad leg always completes exactly once, bounded by
+     *   AD_LEG_TIMEOUT_MS until the loader hands back an AdsManager (G-07-11)
+     * - 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>;
+    /**
+     * Shared teardown for imaAdsManager and imaDisplayContainer, each behind
+     * its own null check and nulled immediately after — idempotent by
+     * construction. Called unconditionally on abort, and from the completion
+     * funnel only when this.imaAdsManager is still null (T-07-23).
+     */
+    private releaseImaResources;
+    /**
+     * Wait for a click event anywhere inside the player root.
+     * Used to satisfy browser autoplay policies when autoplay is disabled.
+     *
+     * G-07-11: the target widens from the video element to
+     * video.closest('.eb-player') (falling back to video itself for bare
+     * integrations), registered in the capture phase so a descendant that
+     * halts bubbling cannot hide the click from it. Observes only; never
+     * mutates the event, so the skip button and click-through link keep
+     * working exactly as they do today.
+     *
+     * WR-05: single-shot settle flag guards against the click-vs-abort race —
+     * Promise resolution is already idempotent but settled tightens the
+     * contract by ensuring listener cleanup happens exactly once for either
+     * outcome. Callers still distinguish outcomes via signal.aborted.
+     */
+    private waitForUserGesture;
+}
+//# sourceMappingURL=ads-manager.d.ts.map

package/dist/build/types/src/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;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,SAAU,CAAA;AAEhD;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAA;AAEvC;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,mBAAmB,CAAqC;IAEhE;;;;;;;;;;;;;OAaG;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;IA+PhB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,kBAAkB;CAmB3B"}

package/dist/build/types/src/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/src/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/src/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/src/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/src/integrations/index.d.ts

@@ -0,0 +1,7 @@
+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';
+export { IntroStreamManager } from './intro-stream-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/build/types/src/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;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/build/types/src/integrations/intro-stream-manager.d.ts

@@ -0,0 +1,62 @@
+import type { PlayerConfig } from '../core/config';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+/**
+ * G-07-12: absolute backstop for an intro pass where every other completion
+ * trigger is lost — no video `ended`, no `preroll-skip`, no `error-fatal`,
+ * and no `state.error` write. 90s cannot truncate a real brand intro
+ * (single-digit to ~30s assets) but converts an infinite hang into a bounded
+ * one.
+ *
+ * D-10: this value MUST stay strictly below AdsManager's
+ * INTRO_DEFERRAL_TIMEOUT_MS (120_000, src/integrations/ads-manager.ts) so
+ * the intro pass always completes before the ad leg falls through — intro →
+ * ad → main precedence must hold in the failure case too, not only the
+ * happy path. Test 14 in test/integrations/intro-stream-manager.test.ts
+ * asserts this ordering so a future edit to either constant fails loudly.
+ */
+export declare const INTRO_MAX_DURATION_MS = 90000;
+/**
+ * IntroStreamManager owns the intro-stream lifecycle.
+ *
+ * - On init(), if config.preroll is set: flips state.introStreamPlaying = true and
+ *   subscribes to:
+ *     - the video element's native `ended` event
+ *     - bus `preroll-skip` (from the PrerollOverlay skip button)
+ *     - bus `error-fatal` (D-04 silent fall-through — intro must never block main)
+ *     - PlayerState `error` becoming non-null (G-07-12: the one signal shared
+ *       by two silent failure modes that never reach the bus —
+ *       StallWatchdog reload-budget exhaustion,
+ *       src/core/command-handler.ts:159-164, and a synchronous engine
+ *       init() throw caught in onAttach, src/engines/dash.ts:108-120 and
+ *       src/engines/hls.ts:194-207)
+ *     - the on-demand bus event that lets eb-player.ts's openMainStream()
+ *       guarantee the intro pass is finished before main opens (G-07-13
+ *       receiving half — see the bus.on() registration below for its name)
+ *     - an absolute INTRO_MAX_DURATION_MS backstop timer, armed in case no
+ *       other trigger ever fires
+ * - Any one of those triggers calls a closure `complete()` exactly once
+ *   (idempotent via a `completed` boolean guard), which flips
+ *   state.introStreamPlaying = false and emits `intro-stream-complete`.
+ * - On abort, the video `ended` listener is removed explicitly via
+ *   removeEventListener and the backstop timer is cleared. Bus and state
+ *   listeners auto-clean via the `{ signal }` option (see
+ *   src/core/event-bus.ts on() and src/core/player-state.ts on()).
+ *
+ * Scope: this manager listens and emits — it does NOT itself open the intro
+ * stream. The engine open() call is owned by eb-player.ts (single source of
+ * engine selection + DRM wiring), driven by the orchestration around this
+ * manager's `intro-stream-complete` event.
+ */
+export declare class IntroStreamManager {
+    /**
+     * Initialize intro-stream lifecycle tracking.
+     * - Skips entirely if config.preroll is falsy (no state flip, no listeners).
+     * - Otherwise flips state.introStreamPlaying = true and registers the
+     *   completion triggers (video `ended`, bus `preroll-skip`, bus
+     *   `error-fatal`, PlayerState `error`, the on-demand force-completion bus
+     *   event, and the INTRO_MAX_DURATION_MS backstop timer).
+     */
+    init(config: PlayerConfig, state: PlayerState, bus: TypedEventBus, video: HTMLVideoElement, signal: AbortSignal): Promise<void>;
+}
+//# sourceMappingURL=intro-stream-manager.d.ts.map

package/dist/build/types/src/integrations/intro-stream-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intro-stream-manager.d.ts","sourceRoot":"","sources":["../../../../../src/integrations/intro-stream-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;AAEtD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,kBAAkB;IAC7B;;;;;;;OAOG;IACG,IAAI,CACR,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC;CAgFjB"}

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

@@ -0,0 +1,42 @@
+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>;
+    /**
+     * Stop and detach the P2P SDK. Idempotent.
+     *
+     * Called on AbortSignal teardown, and eagerly on an unrecoverable engine
+     * error: hls.js nulls its media element on a fatal keySystemError, so a
+     * still-running eblib instance would keep polling `media.currentTime` and
+     * throw in a loop until full dispose.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=p2p-manager.d.ts.map

package/dist/build/types/src/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;IAmD1D;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI;CAMb"}

package/dist/build/types/src/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/src/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/src/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/src/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"}

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

@@ -0,0 +1,16 @@
+import type { TemplateResult } from 'lit-html';
+import { BaseComponent } from '../base-component';
+/**
+ * MiddleBar renders centered playback controls with a built-in play/pause button.
+ *
+ * The central play/pause button is always present (part of the bar's identity).
+ * Surrounding slots (default: rewind left, forward right) are driven by layout config.
+ *
+ * Subscribes to state.playbackState for icon toggle.
+ */
+export declare class MiddleBar extends BaseComponent {
+    protected onConnect(): void;
+    protected template(): TemplateResult;
+    private handleClick;
+}
+//# sourceMappingURL=middle-bar.d.ts.map

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

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

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

@@ -0,0 +1,15 @@
+import type { TemplateResult } from 'lit-html';
+import { BaseComponent } from '../base-component';
+/**
+ * TopBar renders the top control bar with logo and dynamic action slots.
+ *
+ * - Logo: renders as <img> wrapped in <a> if logoLink is set (always built-in)
+ * - Action slots: driven by layout config (default: share + info on the right)
+ *
+ * Subscribes to state.controlsVisible for visibility transitions.
+ */
+export declare class TopBar extends BaseComponent {
+    protected onConnect(): void;
+    protected template(): TemplateResult;
+}
+//# sourceMappingURL=top-bar.d.ts.map

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

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

package/dist/build/types/src/skin/base-component.d.ts

@@ -0,0 +1,69 @@
+import { html, render } from 'lit-html';
+import type { TemplateResult } from 'lit-html';
+import type { PlayerState } from '../core/types';
+import type { TypedEventBus } from '../core/event-bus';
+import type { PlayerConfig } from '../core/config';
+import type { I18n } from '../core/i18n';
+export { html, render };
+export type { TemplateResult };
+/**
+ * Abstract base class for all skin components.
+ *
+ * Provides a connect/disconnect lifecycle with AbortSignal-based cleanup,
+ * so state subscriptions and event listeners registered in onConnect()
+ * are automatically removed when disconnect() is called.
+ *
+ * Usage:
+ *   class PlayButton extends BaseComponent {
+ *     protected onConnect(): void {
+ *       this.state!.on('playbackState', () => this.render(), { signal: this.signal })
+ *     }
+ *     protected template(): TemplateResult {
+ *       return html`<button>Play</button>`
+ *     }
+ *   }
+ */
+export declare abstract class BaseComponent {
+    protected el: HTMLElement | null;
+    protected state: PlayerState | null;
+    protected bus: TypedEventBus | null;
+    protected config: PlayerConfig | null;
+    protected i18n: I18n | null;
+    private abortController;
+    /**
+     * Returns the AbortSignal for the current connect() session.
+     * Only valid after connect() and before disconnect().
+     * Pass this signal to state.on() and bus.on() for automatic cleanup.
+     */
+    protected get signal(): AbortSignal;
+    /**
+     * Connect this component to the DOM and player context.
+     * Creates a fresh AbortController, sets all fields, then calls onConnect().
+     *
+     * @param i18n - Optional i18n instance for components that render translated text.
+     *   Components that use this.i18n should handle null gracefully (null = fallback to key string).
+     */
+    connect(el: HTMLElement, state: PlayerState, bus: TypedEventBus, config: PlayerConfig, i18n?: I18n): void;
+    /**
+     * Disconnect this component from the player context.
+     * Aborts the AbortController (cleaning up all signal-based subscriptions),
+     * then nulls all references.
+     */
+    disconnect(): void;
+    /**
+     * Called during connect() after all fields are set.
+     * Override to register state subscriptions and event listeners using this.signal.
+     */
+    protected abstract onConnect(): void;
+    /**
+     * Returns the lit-html TemplateResult for this component.
+     * Called by render() to produce the DOM output.
+     */
+    protected abstract template(): TemplateResult;
+    /**
+     * Renders the component into this.el using lit-html.
+     * No-op if el is null (e.g., after disconnect()).
+     */
+    protected render(): void;
+}
+//# sourceMappingURL=base-component.d.ts.map

package/dist/build/types/src/skin/base-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-component.d.ts","sourceRoot":"","sources":["../../../../../src/skin/base-component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,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;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAGxC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACvB,YAAY,EAAE,cAAc,EAAE,CAAA;AAE9B;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,aAAa;IACjC,SAAS,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAO;IACvC,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAO;IAC1C,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAAO;IAC1C,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAO;IAC5C,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAO;IAClC,OAAO,CAAC,eAAe,CAA+B;IAEtD;;;;OAIG;IACH,SAAS,KAAK,MAAM,IAAI,WAAW,CAElC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI;IAUzG;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAUlB;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI;IAEpC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,cAAc;IAE7C;;;OAGG;IACH,SAAS,CAAC,MAAM,IAAI,IAAI;CAIzB"}

package/dist/build/types/src/skin/brand/forja-playlist-bar.d.ts

@@ -0,0 +1,15 @@
+import type { TemplateResult } from 'lit-html';
+import { BaseComponent } from '../base-component';
+/**
+ * ForjaPlaylistBar renders a horizontal episode list in the bottom-extra
+ * extension zone for the Forja brand skin.
+ *
+ * Subscribes to state.playlist and state.currentEpisode.
+ * Provides prev/next navigation buttons that emit bus events.
+ */
+export declare class ForjaPlaylistBar extends BaseComponent {
+    protected onConnect(): void;
+    protected template(): TemplateResult;
+    private formatDuration;
+}
+//# sourceMappingURL=forja-playlist-bar.d.ts.map

package/dist/build/types/src/skin/brand/forja-playlist-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forja-playlist-bar.d.ts","sourceRoot":"","sources":["../../../../../../src/skin/brand/forja-playlist-bar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;IACjD,SAAS,CAAC,SAAS,IAAI,IAAI;IAc3B,SAAS,CAAC,QAAQ,IAAI,cAAc;IA6CpC,OAAO,CAAC,cAAc;CAKvB"}

package/dist/build/types/src/skin/brand/snrt-radio-carousel.d.ts

@@ -0,0 +1,16 @@
+import type { TemplateResult } from 'lit-html';
+import { BaseComponent } from '../base-component';
+/**
+ * SnrtRadioCarousel renders a horizontal carousel of radio program items
+ * for the SNRT brand skin.
+ *
+ * Subscribes to state.epgPrograms for data. Each item shows the program
+ * title and time range. This component is registered as a brand extra
+ * by the SNRT configuration.
+ */
+export declare class SnrtRadioCarousel extends BaseComponent {
+    protected onConnect(): void;
+    protected template(): TemplateResult;
+    private formatTime;
+}
+//# sourceMappingURL=snrt-radio-carousel.d.ts.map

package/dist/build/types/src/skin/brand/snrt-radio-carousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snrt-radio-carousel.d.ts","sourceRoot":"","sources":["../../../../../../src/skin/brand/snrt-radio-carousel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAGjD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,SAAS,CAAC,SAAS,IAAI,IAAI;IAU3B,SAAS,CAAC,QAAQ,IAAI,cAAc;IAiBpC,OAAO,CAAC,UAAU;CAInB"}

package/dist/build/types/src/skin/component-registry.d.ts

@@ -0,0 +1,16 @@
+import type { ComponentId } from '../core/config';
+import type { BaseComponent } from './base-component';
+type ComponentFactory = () => BaseComponent;
+/**
+ * Maps ComponentId strings to factory functions that create component instances.
+ * Used by SkinRoot.connectChildComponents() to dynamically mount components
+ * based on the layout config.
+ */
+export declare const COMPONENT_REGISTRY: Record<ComponentId, ComponentFactory>;
+/**
+ * Returns the CSS selector for a component's slot element.
+ * Seekbar uses a special class for flex:1 behavior.
+ */
+export declare function slotSelector(componentId: ComponentId): string;
+export {};
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/build/types/src/skin/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../../../../src/skin/component-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAgBrD,KAAK,gBAAgB,GAAG,MAAM,aAAa,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAepE,CAAA;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAG7D"}

package/dist/build/types/src/skin/controllers/auto-hide.d.ts

@@ -0,0 +1,27 @@
+import type { PlayerState } from '../../core/types';
+/**
+ * AutoHideController manages the 3-second auto-hide timer for player controls.
+ *
+ * On any user activity (pointermove, touchstart, keyup), the timer resets to 3s.
+ * When the timer fires, controls are hidden — but ONLY if no panel is open,
+ * no ad is playing, and no intro stream is playing.
+ *
+ * Note: Uses manual removeEventListener instead of the { signal } option in
+ * addEventListener. JSDOM 28 rejects non-JSDOM AbortSignal instances in the
+ * options dict, making the signal approach non-testable. Production behavior
+ * is identical — cleanup is triggered by the signal's 'abort' event.
+ *
+ * Usage:
+ *   const controller = new AutoHideController(container, state, signal)
+ *   // cleanup happens automatically when signal aborts
+ */
+export declare class AutoHideController {
+    private timer;
+    private readonly state;
+    private readonly onActivity;
+    private readonly container;
+    constructor(container: HTMLElement, state: PlayerState, signal: AbortSignal);
+    private show;
+    private hide;
+}
+//# sourceMappingURL=auto-hide.d.ts.map

package/dist/build/types/src/skin/controllers/auto-hide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-hide.d.ts","sourceRoot":"","sources":["../../../../../../src/skin/controllers/auto-hide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAkB;IAE7B,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW;IAyB3E,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,IAAI;CAYb"}

package/dist/build/types/src/skin/controllers/keyboard.d.ts

@@ -0,0 +1,29 @@
+import type { PlayerState } from '../../core/types';
+import type { TypedEventBus } from '../../core/event-bus';
+import type { PlayerConfig } from '../../core/config';
+/**
+ * KeyboardController handles player keyboard shortcuts.
+ *
+ * Space: toggles play/pause, prevents default scroll behavior.
+ * ArrowLeft: seek back by config.seekOffset seconds (clamped to 0).
+ * ArrowRight: seek forward by config.seekOffset seconds (clamped to duration).
+ * m: mutes/unmutes — only when config.supportHotKeys is true.
+ *
+ * All shortcuts are disabled during ads or intro streams (state.adPlaying || state.introStreamPlaying).
+ *
+ * The container must be focusable to receive keyboard events.
+ * If container.tabIndex < 0, it is set to 0 automatically.
+ *
+ * Note: Uses manual removeEventListener instead of the { signal } option in
+ * addEventListener. JSDOM 28 rejects non-JSDOM AbortSignal instances in the
+ * options dict, making the signal approach non-testable. Production behavior
+ * is identical — cleanup is triggered by the signal's 'abort' event.
+ *
+ * Usage:
+ *   const controller = new KeyboardController(container, state, bus, config, signal)
+ *   // cleanup happens automatically when signal aborts
+ */
+export declare class KeyboardController {
+    constructor(container: HTMLElement, state: PlayerState, bus: TypedEventBus, config: PlayerConfig, signal: AbortSignal);
+}
+//# sourceMappingURL=keyboard.d.ts.map

package/dist/build/types/src/skin/controllers/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../../../../src/skin/controllers/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;gBAE3B,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,WAAW;CAyDtB"}