@scarlett-player/core 0.1.0

package/dist/state/state-manager.js

@@ -0,0 +1,334 @@
+/**
+ * StateManager - Centralized reactive state management for Scarlett Player.
+ *
+ * Manages all player state using reactive signals. Each state property
+ * is a Signal that can be observed for changes.
+ *
+ * Target size: ~1-2KB (excluding type definitions)
+ */
+import { signal } from './signal';
+/**
+ * Default initial values for all state properties.
+ */
+const DEFAULT_STATE = {
+    // Core Playback State
+    playbackState: 'idle',
+    playing: false,
+    paused: true,
+    ended: false,
+    buffering: false,
+    waiting: false,
+    seeking: false,
+    // Time & Duration
+    currentTime: 0,
+    duration: NaN,
+    buffered: null,
+    bufferedAmount: 0,
+    // Media Info
+    mediaType: 'unknown',
+    source: null,
+    title: '',
+    poster: '',
+    // Volume & Audio
+    volume: 1.0,
+    muted: false,
+    // Playback Controls
+    playbackRate: 1.0,
+    fullscreen: false,
+    pip: false,
+    controlsVisible: true,
+    // Quality & Tracks
+    qualities: [],
+    currentQuality: null,
+    audioTracks: [],
+    currentAudioTrack: null,
+    textTracks: [],
+    currentTextTrack: null,
+    // Live/DVR State (TSP features)
+    live: false,
+    liveEdge: true,
+    seekableRange: null,
+    liveLatency: 0,
+    lowLatencyMode: false,
+    // Chapters (TSP features)
+    chapters: [],
+    currentChapter: null,
+    // Error State
+    error: null,
+    // Network & Performance
+    bandwidth: 0,
+    autoplay: false,
+    loop: false,
+    // Casting State
+    airplayAvailable: false,
+    airplayActive: false,
+    chromecastAvailable: false,
+    chromecastActive: false,
+    // UI State
+    interacting: false,
+    hovering: false,
+    focused: false,
+};
+/**
+ * StateManager manages all player state using reactive signals.
+ *
+ * Each state property is a Signal that automatically tracks dependencies
+ * and notifies subscribers when changed.
+ *
+ * @example
+ * ```ts
+ * const state = new StateManager();
+ *
+ * // Get a signal
+ * const playingSignal = state.get('playing');
+ * playingSignal.get(); // false
+ *
+ * // Set a value
+ * state.set('playing', true);
+ *
+ * // Subscribe to changes
+ * state.subscribe((event) => {
+ *   console.log(`${event.key} changed to`, event.value);
+ * });
+ *
+ * // Batch updates
+ * state.update({
+ *   playing: true,
+ *   currentTime: 10,
+ *   volume: 0.8,
+ * });
+ * ```
+ */
+export class StateManager {
+    /**
+     * Create a new StateManager with default initial state.
+     *
+     * @param initialState - Optional partial initial state (merged with defaults)
+     */
+    constructor(initialState) {
+        /** Internal map of state signals */
+        this.signals = new Map();
+        /** Global state change subscribers */
+        this.changeSubscribers = new Set();
+        this.initializeSignals(initialState);
+    }
+    /**
+     * Initialize all state signals with default or provided values.
+     * @private
+     */
+    initializeSignals(overrides) {
+        const initialState = { ...DEFAULT_STATE, ...overrides };
+        // Create signals for all state properties
+        for (const [key, value] of Object.entries(initialState)) {
+            const stateKey = key;
+            const stateSignal = signal(value);
+            // Subscribe to each signal to emit global change events
+            stateSignal.subscribe(() => {
+                this.notifyChangeSubscribers(stateKey);
+            });
+            this.signals.set(stateKey, stateSignal);
+        }
+    }
+    /**
+     * Get the signal for a state property.
+     *
+     * @param key - State property key
+     * @returns Signal for the property
+     *
+     * @example
+     * ```ts
+     * const playingSignal = state.get('playing');
+     * playingSignal.get(); // false
+     * playingSignal.set(true);
+     * ```
+     */
+    get(key) {
+        const stateSignal = this.signals.get(key);
+        if (!stateSignal) {
+            throw new Error(`[StateManager] Unknown state key: ${key}`);
+        }
+        return stateSignal;
+    }
+    /**
+     * Get the current value of a state property (convenience method).
+     *
+     * @param key - State property key
+     * @returns Current value
+     *
+     * @example
+     * ```ts
+     * state.getValue('playing'); // false
+     * ```
+     */
+    getValue(key) {
+        return this.get(key).get();
+    }
+    /**
+     * Set the value of a state property.
+     *
+     * @param key - State property key
+     * @param value - New value
+     *
+     * @example
+     * ```ts
+     * state.set('playing', true);
+     * state.set('currentTime', 10.5);
+     * ```
+     */
+    set(key, value) {
+        this.get(key).set(value);
+    }
+    /**
+     * Update multiple state properties at once (batch update).
+     *
+     * More efficient than calling set() multiple times.
+     *
+     * @param updates - Partial state object with updates
+     *
+     * @example
+     * ```ts
+     * state.update({
+     *   playing: true,
+     *   currentTime: 0,
+     *   volume: 1.0,
+     * });
+     * ```
+     */
+    update(updates) {
+        for (const [key, value] of Object.entries(updates)) {
+            const stateKey = key;
+            if (this.signals.has(stateKey)) {
+                this.set(stateKey, value);
+            }
+        }
+    }
+    /**
+     * Subscribe to changes on a specific state property.
+     *
+     * @param key - State property key
+     * @param callback - Callback function receiving new value
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```ts
+     * const unsub = state.subscribe('playing', (value) => {
+     *   console.log('Playing:', value);
+     * });
+     * ```
+     */
+    subscribeToKey(key, callback) {
+        const stateSignal = this.get(key);
+        return stateSignal.subscribe(() => {
+            callback(stateSignal.get());
+        });
+    }
+    /**
+     * Subscribe to all state changes.
+     *
+     * Receives a StateChangeEvent for every state property change.
+     *
+     * @param callback - Callback function receiving change events
+     * @returns Unsubscribe function
+     *
+     * @example
+     * ```ts
+     * const unsub = state.subscribe((event) => {
+     *   console.log(`${event.key} changed:`, event.value);
+     * });
+     * ```
+     */
+    subscribe(callback) {
+        this.changeSubscribers.add(callback);
+        return () => this.changeSubscribers.delete(callback);
+    }
+    /**
+     * Notify all global change subscribers.
+     * @private
+     */
+    notifyChangeSubscribers(key) {
+        const stateSignal = this.get(key);
+        const value = stateSignal.get();
+        const event = {
+            key,
+            value,
+            previousValue: value, // Note: We don't track previous values in this simple impl
+        };
+        this.changeSubscribers.forEach(subscriber => {
+            try {
+                subscriber(event);
+            }
+            catch (error) {
+                console.error('[StateManager] Error in change subscriber:', error);
+            }
+        });
+    }
+    /**
+     * Reset all state to default values.
+     *
+     * @example
+     * ```ts
+     * state.reset();
+     * ```
+     */
+    reset() {
+        this.update(DEFAULT_STATE);
+    }
+    /**
+     * Reset a specific state property to its default value.
+     *
+     * @param key - State property key
+     *
+     * @example
+     * ```ts
+     * state.resetKey('playing');
+     * ```
+     */
+    resetKey(key) {
+        const defaultValue = DEFAULT_STATE[key];
+        this.set(key, defaultValue);
+    }
+    /**
+     * Get a snapshot of all current state values.
+     *
+     * @returns Frozen snapshot of current state
+     *
+     * @example
+     * ```ts
+     * const snapshot = state.snapshot();
+     * console.log(snapshot.playing, snapshot.currentTime);
+     * ```
+     */
+    snapshot() {
+        const snapshot = {};
+        for (const [key, stateSignal] of this.signals) {
+            snapshot[key] = stateSignal.get();
+        }
+        return Object.freeze(snapshot);
+    }
+    /**
+     * Get the number of subscribers for a state property (for debugging).
+     *
+     * @param key - State property key
+     * @returns Number of subscribers
+     * @internal
+     */
+    getSubscriberCount(key) {
+        return this.signals.get(key)?.getSubscriberCount() ?? 0;
+    }
+    /**
+     * Destroy the state manager and cleanup all signals.
+     *
+     * @example
+     * ```ts
+     * state.destroy();
+     * ```
+     */
+    destroy() {
+        // Destroy all signals
+        this.signals.forEach(stateSignal => stateSignal.destroy());
+        this.signals.clear();
+        // Clear change subscribers
+        this.changeSubscribers.clear();
+    }
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/state/state-manager.js.map

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

package/dist/types/events.d.ts

@@ -0,0 +1,323 @@
+/**
+ * Event system type definitions for Scarlett Player.
+ *
+ * Type-safe event bus for plugin communication and player events.
+ */
+import type { StateChangeEvent } from './state';
+import type { Chapter } from './state';
+import type { PlayerError } from '../error-handler';
+/**
+ * Core player events.
+ */
+export interface PlayerEventMap {
+    /** Player is ready (initialized) */
+    'player:ready': void;
+    /** Player is being destroyed */
+    'player:destroy': void;
+    /** Playback started */
+    'playback:play': void;
+    /** Playback paused */
+    'playback:pause': void;
+    /** Playback ended */
+    'playback:ended': void;
+    /** Playback time updated */
+    'playback:timeupdate': {
+        currentTime: number;
+    };
+    /** Seeking started */
+    'playback:seeking': {
+        time: number;
+    };
+    /** Seeking completed */
+    'playback:seeked': {
+        time: number;
+    };
+    /** Playback rate changed */
+    'playback:ratechange': {
+        rate: number;
+    };
+    /** Media source loaded */
+    'media:loaded': {
+        src: string;
+        type: string;
+    };
+    /** Media metadata loaded (duration, dimensions, etc.) */
+    'media:loadedmetadata': {
+        duration: number;
+    };
+    /** Media can play (buffered enough) */
+    'media:canplay': void;
+    /** Media can play through without buffering */
+    'media:canplaythrough': void;
+    /** Media is buffering/loading */
+    'media:waiting': void;
+    /** Media progress (buffering) */
+    'media:progress': {
+        buffered: number;
+    };
+    /** Media error occurred */
+    'media:error': {
+        error: Error;
+    };
+    /** Volume changed */
+    'volume:change': {
+        volume: number;
+        muted: boolean;
+    };
+    /** Mute toggled */
+    'volume:mute': {
+        muted: boolean;
+    };
+    /** Quality level changed */
+    'quality:change': {
+        quality: string;
+        auto: boolean;
+    };
+    /** Available qualities updated */
+    'quality:levels': {
+        levels: Array<{
+            id: string;
+            label: string;
+        }>;
+    };
+    /** User selected a quality level */
+    'quality:select': {
+        quality: string;
+        auto?: boolean;
+    };
+    /** Text track (subtitle/caption) changed */
+    'track:text': {
+        trackId: string | null;
+    };
+    /** Audio track changed */
+    'track:audio': {
+        trackId: string | null;
+    };
+    /** Entered fullscreen */
+    'fullscreen:enter': void;
+    /** Exited fullscreen */
+    'fullscreen:exit': void;
+    /** Fullscreen changed */
+    'fullscreen:change': {
+        fullscreen: boolean;
+    };
+    /** Entered PiP */
+    'pip:enter': void;
+    /** Exited PiP */
+    'pip:exit': void;
+    /** PiP changed */
+    'pip:change': {
+        pip: boolean;
+    };
+    /** AirPlay devices available */
+    'airplay:available': void;
+    /** AirPlay devices not available */
+    'airplay:unavailable': void;
+    /** AirPlay connected */
+    'airplay:connected': void;
+    /** AirPlay disconnected */
+    'airplay:disconnected': void;
+    /** Chromecast available */
+    'chromecast:available': void;
+    /** Chromecast unavailable */
+    'chromecast:unavailable': void;
+    /** Chromecast connected */
+    'chromecast:connected': {
+        deviceName: string;
+    };
+    /** Chromecast disconnected */
+    'chromecast:disconnected': void;
+    /** Chromecast error */
+    'chromecast:error': {
+        error: Error;
+    };
+    /** Live edge state changed */
+    'live:edgechange': {
+        atEdge: boolean;
+    };
+    /** Live latency updated */
+    'live:latency': {
+        latency: number;
+    };
+    /** Seekable range updated (DVR window) */
+    'live:seekablerange': {
+        start: number;
+        end: number;
+    };
+    /** Low-latency mode toggled */
+    'live:lowlatency': {
+        enabled: boolean;
+    };
+    /** Chapter changed (based on playback time) */
+    'chapter:change': {
+        chapter: Chapter | null;
+        previous: Chapter | null;
+    };
+    /** Chapters loaded/updated */
+    'chapter:loaded': {
+        chapters: Chapter[];
+    };
+    /** User clicked/selected a chapter */
+    'chapter:select': {
+        chapter: Chapter;
+    };
+    /** Controls shown */
+    'controls:show': void;
+    /** Controls hidden */
+    'controls:hide': void;
+    /** Controls visibility changed */
+    'controls:change': {
+        visible: boolean;
+    };
+    /** User started interacting */
+    'ui:interact:start': void;
+    /** User stopped interacting */
+    'ui:interact:end': void;
+    /** Mouse entered player */
+    'ui:mouseenter': void;
+    /** Mouse left player */
+    'ui:mouseleave': void;
+    /** Player gained focus */
+    'ui:focus': void;
+    /** Player lost focus */
+    'ui:blur': void;
+    /** Any state changed */
+    'state:change': StateChangeEvent;
+    /** Plugin registered */
+    'plugin:registered': {
+        name: string;
+        type: string;
+    };
+    /** Plugin activated */
+    'plugin:active': {
+        name: string;
+    };
+    /** Plugin destroyed */
+    'plugin:destroyed': {
+        name: string;
+    };
+    /** Plugin error */
+    'plugin:error': {
+        name: string;
+        error: Error;
+    };
+    /** General error occurred */
+    'error': PlayerError;
+    /** Network error */
+    'error:network': {
+        error: Error;
+    };
+    /** Media error (decode, format, etc.) */
+    'error:media': {
+        error: Error;
+    };
+    /** Plugin error */
+    'error:plugin': {
+        error: Error;
+        plugin: string;
+    };
+}
+/**
+ * Event names (type-safe).
+ */
+export type EventName = keyof PlayerEventMap;
+/**
+ * Event payload for a specific event name.
+ */
+export type EventPayload<T extends EventName> = PlayerEventMap[T];
+/**
+ * Event handler function signature.
+ */
+export type EventHandler<T extends EventName = EventName> = (payload: EventPayload<T>) => void | Promise<void>;
+/**
+ * Event interceptor function signature.
+ * Can modify payload or cancel event propagation.
+ */
+export type EventInterceptor<T extends EventName = EventName> = (payload: EventPayload<T>) => EventPayload<T> | null | Promise<EventPayload<T> | null>;
+/**
+ * Event subscription interface.
+ */
+export interface EventSubscription {
+    /** Unsubscribe from event */
+    unsubscribe(): void;
+}
+/**
+ * Event bus interface.
+ */
+export interface EventBus {
+    /**
+     * Subscribe to an event.
+     *
+     * @param event - Event name
+     * @param handler - Event handler function
+     * @returns Unsubscribe function
+     */
+    on<T extends EventName>(event: T, handler: EventHandler<T>): () => void;
+    /**
+     * Subscribe to an event once (auto-unsubscribe after first call).
+     *
+     * @param event - Event name
+     * @param handler - Event handler function
+     * @returns Unsubscribe function
+     */
+    once<T extends EventName>(event: T, handler: EventHandler<T>): () => void;
+    /**
+     * Unsubscribe from an event.
+     *
+     * @param event - Event name
+     * @param handler - Event handler function to remove
+     */
+    off<T extends EventName>(event: T, handler: EventHandler<T>): void;
+    /**
+     * Emit an event.
+     *
+     * @param event - Event name
+     * @param payload - Event payload
+     */
+    emit<T extends EventName>(event: T, payload: EventPayload<T>): void;
+    /**
+     * Emit an event asynchronously (next tick).
+     *
+     * @param event - Event name
+     * @param payload - Event payload
+     */
+    emitAsync<T extends EventName>(event: T, payload: EventPayload<T>): Promise<void>;
+    /**
+     * Add an event interceptor.
+     * Interceptors run before handlers and can modify/cancel events.
+     *
+     * @param event - Event name
+     * @param interceptor - Interceptor function
+     * @returns Remove interceptor function
+     */
+    intercept<T extends EventName>(event: T, interceptor: EventInterceptor<T>): () => void;
+    /**
+     * Remove all listeners for an event (or all events if no event specified).
+     *
+     * @param event - Optional event name
+     */
+    removeAllListeners(event?: EventName): void;
+    /**
+     * Get listener count for an event.
+     *
+     * @param event - Event name
+     * @returns Number of listeners
+     */
+    listenerCount(event: EventName): number;
+    /**
+     * Destroy event bus and cleanup all listeners.
+     */
+    destroy(): void;
+}
+/**
+ * Event emitter options.
+ */
+export interface EventEmitterOptions {
+    /** Maximum listeners per event (default: 100) */
+    maxListeners?: number;
+    /** Enable async event emission (default: false) */
+    async?: boolean;
+    /** Enable event interceptors (default: true) */
+    interceptors?: boolean;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

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

package/dist/types/events.js

@@ -0,0 +1,7 @@
+/**
+ * Event system type definitions for Scarlett Player.
+ *
+ * Type-safe event bus for plugin communication and player events.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Scarlett Player Type Definitions
+ *
+ * Central export for all TypeScript types and interfaces.
+ */
+export type { Plugin, PluginType, PluginState, PluginConfig, PluginFactory, PluginDescriptor, IPluginAPI, } from './plugin';
+export type { StateStore, StateKey, StateValue, StateUpdate, StateChangeEvent, IStateManager, PlaybackState, MediaType, MediaSource, Chapter, TextTrack, AudioTrack, QualityLevel, SeekableRange, } from './state';
+export type { PlayerEventMap, EventName, EventPayload, EventHandler, EventInterceptor, EventSubscription, EventBus, EventEmitterOptions, } from './events';
+//# sourceMappingURL=index.d.ts.map