ts-video-player 0.1.0

package/dist/core/state.d.ts

@@ -0,0 +1,142 @@
+/**
+ * ts-video-player State Management
+ *
+ * Simple reactive state system for the video player.
+ *
+ * @module core/state
+ */
+import type { PlayerState } from '../types';
+/**
+ * Shallow equality comparison for plain objects.
+ * Returns true if both objects have the same keys with === equal values.
+ * Used to optimize selector subscriptions — skip notifications when
+ * derived state hasn't meaningfully changed.
+ */
+export declare function shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean;
+type Unsubscribe = () => void;
+/**
+ * Create a reactive signal
+ */
+export declare function createSignal<T>(initial: T): [() => T, (value: T | ((prev: T) => T)) => void];
+/**
+ * Create a computed value from signals
+ */
+export declare function computed<T>(fn: () => T, deps: Array<() => unknown>): () => T;
+/**
+ * Default player state
+ */
+export declare function createDefaultState(): PlayerState;
+/**
+ * State store for the player
+ *
+ * Uses microtask-coalesced notifications: multiple rapid set() calls within
+ * the same microtask are batched into a single notification cycle. This prevents
+ * redundant re-renders when many state fields change in quick succession
+ * (e.g., timeupdate + progress + buffered all firing together).
+ */
+export declare class StateStore {
+    private state;
+    private listeners;
+    private _pendingKeys;
+    private _flushScheduled;
+    constructor(initial?: Partial<PlayerState>);
+    /**
+     * Get the current state
+     */
+    getState(): Readonly<PlayerState>;
+    /**
+     * Get a specific state value
+     */
+    get<K extends keyof PlayerState>(key: K): PlayerState[K];
+    /**
+     * Set a single state value. Notifications are coalesced via microtask.
+     */
+    set<K extends keyof PlayerState>(key: K, value: PlayerState[K]): void;
+    /**
+     * Batch update multiple state values. Notifications are coalesced via microtask.
+     */
+    batch(updates: Partial<PlayerState>): void;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(keyOrListener: keyof PlayerState | '*' | ((_state: PlayerState, _key?: keyof PlayerState) => void), listener?: (_state: PlayerState, _key?: keyof PlayerState) => void): Unsubscribe;
+    /**
+     * Reset state to defaults
+     */
+    reset(): void;
+    /**
+     * Force synchronous flush of pending notifications.
+     * Useful in tests or when immediate consistency is required.
+     */
+    flush(): void;
+    private scheduleNotify;
+    private notifyKey;
+    private notifyAll;
+}
+/**
+ * Calculate buffered percentage
+ */
+export declare function selectBufferedAmount(state: PlayerState): number;
+/**
+ * Calculate progress percentage
+ */
+export declare function selectProgress(state: PlayerState): number;
+/**
+ * Get remaining time
+ */
+export declare function selectRemainingTime(state: PlayerState): number;
+/**
+ * Check if player is in idle state
+ */
+export declare function selectIsIdle(state: PlayerState): boolean;
+/**
+ * Check if player is loading
+ */
+export declare function selectIsLoading(state: PlayerState): boolean;
+/**
+ * Check if live stream
+ */
+export declare function selectIsLive(state: PlayerState): boolean;
+/**
+ * Check if DVR enabled
+ */
+export declare function selectIsDVR(state: PlayerState): boolean;
+/**
+ * Get current quality
+ */
+export declare function selectCurrentQuality(state: PlayerState): string | null;
+/**
+ * Get current text track
+ */
+export declare function selectCurrentTextTrack(state: PlayerState): string | null;
+/**
+ * Get current audio track
+ */
+export declare function selectCurrentAudioTrack(state: PlayerState): string | null;
+/** @deprecated Use `state.fullscreenAvailability === 'available'` instead */
+export declare function selectCanFullscreen(state: PlayerState): boolean;
+/** @deprecated Use `state.pipAvailability === 'available'` instead */
+export declare function selectCanPiP(state: PlayerState): boolean;
+/** @deprecated Use `state.volumeAvailability === 'available'` instead */
+export declare function selectCanSetVolume(state: PlayerState): boolean;
+interface StoredState {
+    volume: number;
+    muted: boolean;
+    playbackRate: number;
+    captions: boolean;
+    quality: string;
+}
+/**
+ * Load persisted state from storage
+ */
+export declare function loadPersistedState(storage?: Storage): Partial<StoredState>;
+/**
+ * Save state to storage
+ */
+export declare function savePersistedState(state: Partial<StoredState>, storage?: Storage): void;
+/**
+ * Create storage sync for state store
+ */
+export declare function createStorageSync(store: StateStore, keys?: (keyof StoredState)[], storage?: Storage): Unsubscribe;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/core/state.d.ts.map

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

package/dist/core/text-tracks.d.ts

@@ -0,0 +1,162 @@
+/**
+ * ts-video-player Text Tracks
+ *
+ * Comprehensive text track management for captions and subtitles.
+ * Supports VTT, SRT, and external track loading.
+ *
+ * @module core/text-tracks
+ */
+import type { TextTrack, TextTrackCue } from '../types';
+/**
+ * Text track ready state
+ */
+export declare enum TextTrackReadyState {
+    /** Not loaded */
+    NotLoaded = 0,
+    /** Loading */
+    Loading = 1,
+    /** Ready */
+    Ready = 2,
+    /** Error */
+    Error = 3
+}
+/**
+ * Text track init options
+ */
+export interface TextTrackInit {
+    /** Track kind */
+    kind: TextTrack['kind'];
+    /** Track label */
+    label: string;
+    /** Track language (BCP 47) */
+    language: string;
+    /** Track source URL */
+    src?: string;
+    /** Whether this is the default track */
+    default?: boolean;
+    /** Track content (VTT/SRT string) */
+    content?: string;
+}
+/**
+ * VTT cue init options
+ */
+export interface VTTCueInit {
+    /** Cue ID */
+    id?: string;
+    /** Start time in seconds */
+    startTime: number;
+    /** End time in seconds */
+    endTime: number;
+    /** Cue text */
+    text: string;
+    /** Vertical setting */
+    vertical?: '' | 'rl' | 'lr';
+    /** Line position */
+    line?: number | 'auto';
+    /** Line alignment */
+    lineAlign?: 'start' | 'center' | 'end';
+    /** Position */
+    position?: number | 'auto';
+    /** Position alignment */
+    positionAlign?: 'line-left' | 'center' | 'line-right' | 'auto';
+    /** Size (percentage) */
+    size?: number;
+    /** Alignment */
+    align?: 'start' | 'center' | 'end' | 'left' | 'right';
+}
+/**
+ * Manages a list of text tracks
+ */
+export declare class TextTrackList {
+    private tracks;
+    private listeners;
+    private video;
+    constructor(video?: HTMLVideoElement);
+    /**
+     * Get all tracks
+     */
+    getAll(): TextTrack[];
+    /**
+     * Get track by ID
+     */
+    get(id: string): TextTrack | null;
+    /**
+     * Get currently showing track
+     */
+    getShowing(): TextTrack | null;
+    /**
+     * Add a new text track
+     */
+    add(init: TextTrackInit): Promise<TextTrack>;
+    /**
+     * Remove a text track
+     */
+    remove(id: string): void;
+    /**
+     * Set track mode
+     */
+    setMode(id: string, mode: TextTrack['mode']): void;
+    /**
+     * Get active cues at a specific time
+     */
+    getActiveCues(time: number): TextTrackCue[];
+    /**
+     * Subscribe to track changes
+     */
+    subscribe(listener: (tracks: TextTrack[]) => void): () => void;
+    /**
+     * Clear all tracks
+     */
+    clear(): void;
+    private addToVideo;
+    private notify;
+}
+export interface CaptionRendererOptions {
+    /** Container element */
+    container: HTMLElement;
+    /** Font size */
+    fontSize?: number;
+    /** Font family */
+    fontFamily?: string;
+    /** Text color */
+    color?: string;
+    /** Background color */
+    backgroundColor?: string;
+    /** Background opacity */
+    backgroundOpacity?: number;
+    /** Text shadow */
+    textShadow?: boolean;
+}
+/**
+ * Render captions on screen
+ */
+export declare class CaptionRenderer {
+    private container;
+    private element;
+    private options;
+    constructor(options: CaptionRendererOptions);
+    private createCaptionElement;
+    private applyStyles;
+    /**
+     * Update the displayed text
+     */
+    setText(text: string): void;
+    /**
+     * Update renderer options
+     */
+    setOptions(options: Partial<Omit<CaptionRendererOptions, 'container'>>): void;
+    /**
+     * Destroy the renderer
+     */
+    destroy(): void;
+    private hexToRgba;
+}
+/**
+ * Create a new text track list
+ */
+export declare function createTextTrackList(video?: HTMLVideoElement): TextTrackList;
+/**
+ * Create a caption renderer
+ */
+export declare function createCaptionRenderer(options: CaptionRendererOptions): CaptionRenderer;
+//# sourceMappingURL=text-tracks.d.ts.map

package/dist/core/text-tracks.d.ts.map

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

package/dist/core/themes.d.ts

@@ -0,0 +1,213 @@
+/**
+ * CSS Variables / Theming System
+ *
+ * Provides a comprehensive theming system using CSS custom properties.
+ *
+ * @module core/themes
+ */
+export interface ThemeColors {
+    /** Primary brand color (default: #00a8ff) */
+    primary?: string;
+    /** Secondary accent color */
+    secondary?: string;
+    /** Background color */
+    background?: string;
+    /** Text color */
+    text?: string;
+    /** Text color on primary background */
+    textOnPrimary?: string;
+    /** Border color */
+    border?: string;
+    /** Focus ring color */
+    focus?: string;
+    /** Error/danger color */
+    error?: string;
+    /** Success color */
+    success?: string;
+    /** Warning color */
+    warning?: string;
+}
+export interface ThemeTypography {
+    /** Font family for UI elements */
+    fontFamily?: string;
+    /** Base font size */
+    fontSize?: string;
+    /** Small font size */
+    fontSizeSmall?: string;
+    /** Large font size */
+    fontSizeLarge?: string;
+    /** Font weight */
+    fontWeight?: string;
+    /** Bold font weight */
+    fontWeightBold?: string;
+    /** Line height */
+    lineHeight?: string;
+}
+export interface ThemeSpacing {
+    /** Extra small spacing (4px) */
+    xs?: string;
+    /** Small spacing (8px) */
+    sm?: string;
+    /** Medium spacing (12px) */
+    md?: string;
+    /** Large spacing (16px) */
+    lg?: string;
+    /** Extra large spacing (24px) */
+    xl?: string;
+}
+export interface ThemeBorderRadius {
+    /** Small border radius */
+    sm?: string;
+    /** Medium border radius */
+    md?: string;
+    /** Large border radius */
+    lg?: string;
+    /** Full/round border radius */
+    full?: string;
+}
+export interface ThemeShadows {
+    /** Small shadow */
+    sm?: string;
+    /** Medium shadow */
+    md?: string;
+    /** Large shadow */
+    lg?: string;
+}
+export interface ThemeTransitions {
+    /** Fast transition duration */
+    fast?: string;
+    /** Normal transition duration */
+    normal?: string;
+    /** Slow transition duration */
+    slow?: string;
+    /** Default easing function */
+    easing?: string;
+}
+export interface ThemeSlider {
+    /** Slider track height */
+    trackHeight?: string;
+    /** Slider thumb size */
+    thumbSize?: string;
+    /** Slider track background */
+    trackBg?: string;
+    /** Slider track fill background */
+    trackFillBg?: string;
+    /** Slider buffered background */
+    bufferedBg?: string;
+    /** Slider thumb background */
+    thumbBg?: string;
+    /** Slider thumb border */
+    thumbBorder?: string;
+}
+export interface ThemeControls {
+    /** Controls bar height */
+    height?: string;
+    /** Controls background */
+    background?: string;
+    /** Controls padding */
+    padding?: string;
+    /** Button size */
+    buttonSize?: string;
+    /** Icon size */
+    iconSize?: string;
+    /** Tooltip background */
+    tooltipBg?: string;
+    /** Tooltip text color */
+    tooltipText?: string;
+}
+export interface ThemeMenu {
+    /** Menu background */
+    background?: string;
+    /** Menu border radius */
+    borderRadius?: string;
+    /** Menu shadow */
+    shadow?: string;
+    /** Menu item height */
+    itemHeight?: string;
+    /** Menu item hover background */
+    itemHoverBg?: string;
+    /** Menu item active background */
+    itemActiveBg?: string;
+}
+export interface ThemeCaptions {
+    /** Caption font family */
+    fontFamily?: string;
+    /** Caption font size */
+    fontSize?: string;
+    /** Caption text color */
+    textColor?: string;
+    /** Caption background */
+    background?: string;
+    /** Caption text shadow */
+    textShadow?: string;
+    /** Caption border radius */
+    borderRadius?: string;
+    /** Caption padding */
+    padding?: string;
+}
+export interface ThemeThumbnails {
+    /** Thumbnail width */
+    width?: string;
+    /** Thumbnail height */
+    height?: string;
+    /** Thumbnail border radius */
+    borderRadius?: string;
+    /** Thumbnail border */
+    border?: string;
+    /** Thumbnail shadow */
+    shadow?: string;
+}
+export interface ThemeLive {
+    /** Live indicator color */
+    indicatorColor?: string;
+    /** Live indicator size */
+    indicatorSize?: string;
+    /** Live badge background */
+    badgeBg?: string;
+    /** Live badge text color */
+    badgeText?: string;
+}
+export interface Theme {
+    colors?: ThemeColors;
+    typography?: ThemeTypography;
+    spacing?: ThemeSpacing;
+    borderRadius?: ThemeBorderRadius;
+    shadows?: ThemeShadows;
+    transitions?: ThemeTransitions;
+    slider?: ThemeSlider;
+    controls?: ThemeControls;
+    menu?: ThemeMenu;
+    captions?: ThemeCaptions;
+    thumbnails?: ThemeThumbnails;
+    live?: ThemeLive;
+}
+export declare const defaultTheme: Required<Theme>;
+export declare const darkTheme: Theme;
+export declare const lightTheme: Theme;
+export declare const minimalTheme: Theme;
+export declare const netflixTheme: Theme;
+export declare const youtubeTheme: Theme;
+export declare const vimeoTheme: Theme;
+export declare const presetThemes: Record<string, Theme>;
+export type PresetThemeName = keyof typeof presetThemes;
+/**
+ * Deep merge two theme objects
+ */
+export declare function mergeThemes(base: Theme, override: Theme): Theme;
+/**
+ * Generate CSS custom properties from a theme
+ */
+export declare function generateThemeCSS(theme: Theme, prefix?: string): string;
+/**
+ * Create a style element with theme CSS
+ */
+export declare function createThemeStyleElement(theme: Theme, selector?: string): HTMLStyleElement;
+/**
+ * Apply theme to a player element
+ */
+export declare function applyTheme(element: HTMLElement, theme: Theme | PresetThemeName): void;
+/**
+ * Inject global theme styles
+ */
+export declare function injectThemeStyles(theme?: Theme | PresetThemeName, selector?: string): void;
+//# sourceMappingURL=themes.d.ts.map

package/dist/core/themes.d.ts.map

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

package/dist/core/thumbnails.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Thumbnail Sprites / Seek Preview
+ *
+ * Provides thumbnail preview functionality during seeking.
+ *
+ * @module core/thumbnails
+ */
+export interface ThumbnailSprite {
+    /** URL to the sprite image */
+    url: string;
+    /** Width of each thumbnail in pixels */
+    width: number;
+    /** Height of each thumbnail in pixels */
+    height: number;
+    /** Number of columns in the sprite */
+    cols: number;
+    /** Number of rows in the sprite */
+    rows: number;
+    /** Duration each thumbnail represents in seconds */
+    interval: number;
+    /** Starting time offset in seconds */
+    startTime?: number;
+}
+export interface ThumbnailCue {
+    /** Start time in seconds */
+    startTime: number;
+    /** End time in seconds */
+    endTime: number;
+    /** URL to the thumbnail image (or sprite) */
+    url: string;
+    /** X position in sprite (if using sprite) */
+    x?: number;
+    /** Y position in sprite (if using sprite) */
+    y?: number;
+    /** Width of thumbnail */
+    width: number;
+    /** Height of thumbnail */
+    height: number;
+}
+export interface ThumbnailsConfig {
+    /** Source for thumbnails - URL to VTT file or sprite config */
+    src?: string | ThumbnailSprite | ThumbnailCue[];
+    /** Whether to preload thumbnail images */
+    preload?: boolean;
+    /** Custom thumbnail renderer */
+    renderer?: (cue: ThumbnailCue, container: HTMLElement) => void;
+}
+/**
+ * Parse a WebVTT file containing thumbnail cues
+ *
+ * VTT format for thumbnails:
+ * ```
+ * WEBVTT
+ *
+ * 00:00:00.000 --> 00:00:05.000
+ * sprite.jpg#xywh=0,0,160,90
+ *
+ * 00:00:05.000 --> 00:00:10.000
+ * sprite.jpg#xywh=160,0,160,90
+ * ```
+ */
+export declare function parseThumbnailVTT(url: string): Promise<ThumbnailCue[]>;
+/**
+ * Generate thumbnail cues from a sprite configuration
+ */
+export declare function generateSpriteCues(sprite: ThumbnailSprite, duration: number): ThumbnailCue[];
+export declare class Thumbnails {
+    private cues;
+    private preloadedImages;
+    private container;
+    private _currentCue;
+    private config;
+    constructor(config?: ThumbnailsConfig);
+    /**
+     * Initialize thumbnails from config
+     */
+    initialize(duration: number): Promise<void>;
+    /**
+     * Preload all unique thumbnail images
+     */
+    private preloadImages;
+    /**
+     * Get thumbnail cue for a specific time
+     */
+    getCueForTime(time: number): ThumbnailCue | null;
+    /**
+     * Create thumbnail preview element
+     */
+    createPreviewElement(): HTMLElement;
+    /**
+     * Update thumbnail preview for a specific time
+     */
+    updatePreview(time: number, position?: number): void;
+    /**
+     * Show thumbnail preview
+     */
+    show(): void;
+    /**
+     * Hide thumbnail preview
+     */
+    hide(): void;
+    /**
+     * Get all cues
+     */
+    getCues(): ThumbnailCue[];
+    /**
+     * Add cues manually
+     */
+    addCues(cues: ThumbnailCue[]): void;
+    /**
+     * Get current cue
+     */
+    getCurrentCue(): ThumbnailCue | null;
+    /**
+     * Clear all cues
+     */
+    clear(): void;
+    /**
+     * Destroy thumbnails instance
+     */
+    destroy(): void;
+}
+export declare function createThumbnails(config?: ThumbnailsConfig): Thumbnails;
+//# sourceMappingURL=thumbnails.d.ts.map

package/dist/core/thumbnails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnails.d.ts","sourceRoot":"","sources":["../../src/core/thumbnails.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,6CAA6C;IAC7C,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,6CAA6C;IAC7C,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,YAAY,EAAE,CAAA;IAC/C,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,KAAK,IAAI,CAAA;CAC/D;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAyC5E;AAyDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CA2B5F;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,eAAe,CAAsC;IAC7D,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,GAAE,gBAAqB;IAIzC;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBjD;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAShD;;OAEG;IACH,oBAAoB,IAAI,WAAW;IAmDnC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IA8CpD;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,OAAO,IAAI,YAAY,EAAE;IAIzB;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI;IAInC;;OAEG;IACH,aAAa,IAAI,YAAY,GAAG,IAAI;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAMD,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAEtE"}