@scarlett-player/core 0.1.0

package/dist/scarlett-player.d.ts

@@ -0,0 +1,404 @@
+/**
+ * ScarlettPlayer - Main player class integrating all core systems.
+ *
+ * Provides the public API for video playback, plugin management,
+ * state access, and event handling.
+ *
+ * Target size: ~1-1.5KB
+ */
+import type { Plugin } from './types/plugin';
+import type { EventName, EventHandler as EventHandlerFn } from './types/events';
+import type { StateStore } from './types/state';
+/**
+ * Player configuration options.
+ */
+export interface PlayerOptions {
+    /** HTML container element or CSS selector */
+    container: HTMLElement | string;
+    /** Initial source URL */
+    src?: string;
+    /** Poster image URL */
+    poster?: string;
+    /** Initial log level (default: 'warn') */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** Autoplay (default: false) */
+    autoplay?: boolean;
+    /** Loop playback (default: false) */
+    loop?: boolean;
+    /** Initial volume 0-1 (default: 1.0) */
+    volume?: number;
+    /** Start muted (default: false) */
+    muted?: boolean;
+    /** Plugins to register on initialization */
+    plugins?: Plugin[];
+}
+/**
+ * Quality level interface for proxy methods.
+ */
+export interface QualityLevel {
+    index: number;
+    width: number;
+    height: number;
+    bitrate: number;
+    label: string;
+}
+/**
+ * ScarlettPlayer - Lightweight, plugin-based video player.
+ *
+ * Features:
+ * - Plugin-based architecture
+ * - Reactive state management
+ * - Type-safe event system
+ * - Automatic provider selection
+ * - Live/DVR support (TSP)
+ * - Chapter/marker support (TSP)
+ *
+ * @example
+ * ```ts
+ * const player = new ScarlettPlayer({
+ *   container: document.getElementById('player'),
+ *   plugins: [hlsPlugin, controlsPlugin],
+ * });
+ *
+ * // Load and play
+ * await player.load('video.m3u8');
+ * player.play();
+ *
+ * // Listen to events
+ * player.on('playback:play', () => {
+ *   console.log('Playing!');
+ * });
+ *
+ * // Access state
+ * console.log(player.playing, player.currentTime);
+ *
+ * // Cleanup
+ * player.destroy();
+ * ```
+ */
+export declare class ScarlettPlayer {
+    /** Player container element */
+    readonly container: HTMLElement;
+    /** Event bus */
+    private eventBus;
+    /** State manager */
+    private stateManager;
+    /** Logger */
+    private logger;
+    /** Error handler */
+    private errorHandler;
+    /** Plugin manager */
+    private pluginManager;
+    /** Current media provider plugin */
+    private _currentProvider;
+    /** Player destroyed flag */
+    private destroyed;
+    /** Seeking while playing flag */
+    private seekingWhilePlaying;
+    /** Seek resume timeout */
+    private seekResumeTimeout;
+    /** Initial source URL */
+    private initialSrc?;
+    /**
+     * Create a new ScarlettPlayer.
+     *
+     * @param options - Player configuration
+     */
+    constructor(options: PlayerOptions);
+    /**
+     * Initialize the player asynchronously.
+     * Initializes non-provider plugins and loads initial source if provided.
+     */
+    init(): Promise<void>;
+    /**
+     * Load a media source.
+     *
+     * Selects appropriate provider plugin and loads the source.
+     *
+     * @param source - Media source URL
+     * @returns Promise that resolves when source is loaded
+     *
+     * @example
+     * ```ts
+     * await player.load('video.m3u8');
+     * ```
+     */
+    load(source: string): Promise<void>;
+    /**
+     * Start playback.
+     *
+     * @returns Promise that resolves when playback starts
+     *
+     * @example
+     * ```ts
+     * await player.play();
+     * ```
+     */
+    play(): Promise<void>;
+    /**
+     * Pause playback.
+     *
+     * @example
+     * ```ts
+     * player.pause();
+     * ```
+     */
+    pause(): void;
+    /**
+     * Seek to a specific time.
+     *
+     * @param time - Time in seconds
+     *
+     * @example
+     * ```ts
+     * player.seek(30); // Seek to 30 seconds
+     * ```
+     */
+    seek(time: number): void;
+    /**
+     * Set volume.
+     *
+     * @param volume - Volume 0-1
+     *
+     * @example
+     * ```ts
+     * player.setVolume(0.5); // 50% volume
+     * ```
+     */
+    setVolume(volume: number): void;
+    /**
+     * Set muted state.
+     *
+     * @param muted - Mute flag
+     *
+     * @example
+     * ```ts
+     * player.setMuted(true);
+     * ```
+     */
+    setMuted(muted: boolean): void;
+    /**
+     * Set playback rate.
+     *
+     * @param rate - Playback rate (e.g., 1.0 = normal, 2.0 = 2x speed)
+     *
+     * @example
+     * ```ts
+     * player.setPlaybackRate(1.5); // 1.5x speed
+     * ```
+     */
+    setPlaybackRate(rate: number): void;
+    /**
+     * Set autoplay state.
+     *
+     * When enabled, videos will automatically play after loading.
+     *
+     * @param autoplay - Autoplay flag
+     *
+     * @example
+     * ```ts
+     * player.setAutoplay(true);
+     * await player.load('video.mp4'); // Will auto-play
+     * ```
+     */
+    setAutoplay(autoplay: boolean): void;
+    /**
+     * Subscribe to an event.
+     *
+     * @param event - Event name
+     * @param handler - Event handler
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```ts
+     * const unsub = player.on('playback:play', () => {
+     *   console.log('Playing!');
+     * });
+     *
+     * // Later: unsubscribe
+     * unsub();
+     * ```
+     */
+    on<T extends EventName>(event: T, handler: EventHandlerFn<T>): () => void;
+    /**
+     * Subscribe to an event once.
+     *
+     * @param event - Event name
+     * @param handler - Event handler
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```ts
+     * player.once('player:ready', () => {
+     *   console.log('Player ready!');
+     * });
+     * ```
+     */
+    once<T extends EventName>(event: T, handler: EventHandlerFn<T>): () => void;
+    /**
+     * Get a plugin by name.
+     *
+     * @param name - Plugin name
+     * @returns Plugin instance or null
+     *
+     * @example
+     * ```ts
+     * const hls = player.getPlugin('hls-plugin');
+     * ```
+     */
+    getPlugin<T extends Plugin>(name: string): T | null;
+    /**
+     * Register a plugin.
+     *
+     * @param plugin - Plugin to register
+     *
+     * @example
+     * ```ts
+     * player.registerPlugin(myPlugin);
+     * ```
+     */
+    registerPlugin(plugin: Plugin): void;
+    /**
+     * Get current state snapshot.
+     *
+     * @returns Readonly state snapshot
+     *
+     * @example
+     * ```ts
+     * const state = player.getState();
+     * console.log(state.playing, state.currentTime);
+     * ```
+     */
+    getState(): Readonly<StateStore>;
+    /**
+     * Get available quality levels from the current provider.
+     * @returns Array of quality levels or empty array if not available
+     */
+    getQualities(): QualityLevel[];
+    /**
+     * Set quality level (-1 for auto).
+     * @param index - Quality level index
+     */
+    setQuality(index: number): void;
+    /**
+     * Get current quality level index (-1 = auto).
+     */
+    getCurrentQuality(): number;
+    /**
+     * Request fullscreen mode.
+     */
+    requestFullscreen(): Promise<void>;
+    /**
+     * Exit fullscreen mode.
+     */
+    exitFullscreen(): Promise<void>;
+    /**
+     * Toggle fullscreen mode.
+     */
+    toggleFullscreen(): Promise<void>;
+    /**
+     * Request AirPlay (proxied to airplay plugin).
+     */
+    requestAirPlay(): void;
+    /**
+     * Request Chromecast session (proxied to chromecast plugin).
+     */
+    requestChromecast(): Promise<void>;
+    /**
+     * Stop casting (AirPlay or Chromecast).
+     */
+    stopCasting(): void;
+    /**
+     * Seek to live edge (for live streams).
+     */
+    seekToLive(): void;
+    /**
+     * Destroy the player and cleanup all resources.
+     *
+     * @example
+     * ```ts
+     * player.destroy();
+     * ```
+     */
+    destroy(): void;
+    /**
+     * Get playing state.
+     */
+    get playing(): boolean;
+    /**
+     * Get paused state.
+     */
+    get paused(): boolean;
+    /**
+     * Get current time in seconds.
+     */
+    get currentTime(): number;
+    /**
+     * Get duration in seconds.
+     */
+    get duration(): number;
+    /**
+     * Get volume (0-1).
+     */
+    get volume(): number;
+    /**
+     * Get muted state.
+     */
+    get muted(): boolean;
+    /**
+     * Get playback rate.
+     */
+    get playbackRate(): number;
+    /**
+     * Get buffered amount (0-1).
+     */
+    get bufferedAmount(): number;
+    /**
+     * Get current provider plugin.
+     */
+    get currentProvider(): Plugin | null;
+    /**
+     * Get fullscreen state.
+     */
+    get fullscreen(): boolean;
+    /**
+     * Get live stream state.
+     */
+    get live(): boolean;
+    /**
+     * Get autoplay state.
+     */
+    get autoplay(): boolean;
+    /**
+     * Check if player is destroyed.
+     * @private
+     */
+    private checkDestroyed;
+    /**
+     * Detect MIME type from source URL.
+     * @private
+     */
+    private detectMimeType;
+}
+/**
+ * Create a ScarlettPlayer instance and initialize it.
+ *
+ * Convenience factory function that creates and initializes
+ * the player in a single async call.
+ *
+ * @param options - Player configuration
+ * @returns Promise resolving to initialized player
+ *
+ * @example
+ * ```ts
+ * const player = await createPlayer({
+ *   container: '#player',
+ *   src: 'video.m3u8',
+ *   plugins: [hlsPlugin()],
+ * });
+ *
+ * player.play();
+ * ```
+ */
+export declare function createPlayer(options: PlayerOptions): Promise<ScarlettPlayer>;
+//# sourceMappingURL=scarlett-player.d.ts.map

package/dist/scarlett-player.d.ts.map

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