@vplayer/core 0.1.0

package/dist/defaults.d.ts

@@ -0,0 +1,4 @@
+import type { PlayerIcons, PlayerLabels } from './types';
+export declare const defaultPlayerLabels: PlayerLabels;
+/** @see https://iconify.design/icon-sets/lucide/ */
+export declare const defaultPlayerIcons: PlayerIcons;

package/dist/event-bus.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Typed event bus for player-wide communication.
+ * Companion to TanStack Store: store = state, event bus = actions/notifications.
+ */
+export type PlayerEventName = 'play' | 'pause' | 'seeked' | 'timeupdate' | 'ended' | 'volumechange' | 'ratechange' | 'fullscreenchange' | 'pipchange' | 'controlschange' | 'settingchange' | 'pluginregistered' | 'error' | 'sourcechange' | (string & {});
+export type PlayerEventHandler = (...args: any[]) => void;
+export declare class EventBus {
+    private listeners;
+    /** Subscribe to an event. Returns an unsubscribe function. */
+    on(event: PlayerEventName, handler: PlayerEventHandler): () => void;
+    /** Subscribe to an event for one invocation only. */
+    once(event: PlayerEventName, handler: PlayerEventHandler): () => void;
+    /** Unsubscribe a handler. If no handler given, removes all. */
+    off(event: PlayerEventName, handler?: PlayerEventHandler): void;
+    /** Emit an event with payload. */
+    emit(event: PlayerEventName, ...args: any[]): void;
+    /** Remove all listeners. */
+    clear(): void;
+    /** Number of listeners for an event (or total if no event given). */
+    listenerCount(event?: PlayerEventName): number;
+}

package/dist/gesture-engine.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Framework-agnostic touch gesture engine for media players.
+ *
+ * Detects horizontal swipe (seek), vertical swipe (volume on right half),
+ * single tap, and double-tap (skip left/right 10s).
+ *
+ * Returns plain DOM event handlers — works with any framework.
+ */
+export interface GestureEngineCallbacks {
+    seek: (time: number) => void;
+    setVolume: (v: number) => void;
+    skip: (seconds: number) => void;
+}
+export interface GestureHandlers {
+    onTouchStart: (e: TouchEvent) => void;
+    onTouchMove: (e: TouchEvent) => void;
+    onTouchEnd: (e: TouchEvent) => void;
+}
+export declare function createGestureEngine(getState: () => {
+    currentTime: number;
+    volume: number;
+    duration: number;
+}, callbacks: GestureEngineCallbacks): GestureHandlers;

package/dist/hotkey-registry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Extensible keyboard shortcut registry.
+ * Built-in hotkeys are registered by default; plugins can add/remove.
+ */
+export interface HotkeyBinding {
+    /** KeyboardEvent.code (e.g. 'Space', 'KeyK', 'ArrowLeft') */
+    key: string;
+    /** Human-readable description */
+    description: string;
+    /** Handler. Return false to prevent default propagation to other bindings of same key. */
+    handler: (event: KeyboardEvent) => void;
+    /** If true, fires even when an input/textarea is focused (default: false) */
+    allowWhenEditing?: boolean;
+}
+export declare class HotkeyRegistry {
+    private bindings;
+    private enabled;
+    /** Register a hotkey binding. Returns an unsubscribe function. */
+    register(binding: HotkeyBinding): () => void;
+    /** Unregister a specific binding. */
+    unregister(binding: HotkeyBinding): void;
+    /** Remove all bindings for a key. */
+    unregisterAll(key: string): void;
+    /** Clear all registered bindings. */
+    clear(): void;
+    /** Enable/disable hotkey processing. */
+    setEnabled(enabled: boolean): void;
+    /** Process a keydown event. Returns true if a binding handled it. */
+    handleKeyDown(event: KeyboardEvent): boolean;
+    /** Get all registered bindings (for debug display). */
+    getBindings(): HotkeyBinding[];
+}

package/dist/i18n.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Runtime-switchable i18n system.
+ * Plugins can add their own translations via addTranslations().
+ */
+export type LanguageDict = Record<string, string>;
+export declare class I18n {
+    private languages;
+    private currentLang;
+    private currentDict;
+    constructor(initialLang?: string);
+    /** Get the current language code */
+    getLanguage(): string;
+    /** Set language by BCP 47 code (e.g. 'en', 'zh-cn', 'fr') */
+    setLanguage(lang: string): void;
+    /** Add or override translations for a language */
+    addTranslations(lang: string, dict: LanguageDict): void;
+    /** Translate a key. Supports simple {placeholder} substitution. */
+    t(key: string, fallback?: string, params?: Record<string, string | number>): string;
+    /** Get a copy of the current dict */
+    getCurrentDict(): LanguageDict;
+    /** Get available language codes */
+    getAvailableLanguages(): string[];
+}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+export { createPlayer } from './player';
+export { createGestureEngine } from './gesture-engine';
+export type { GestureEngineCallbacks, GestureHandlers } from './gesture-engine';
+export { EventBus } from './event-bus';
+export type { PlayerEventName, PlayerEventHandler } from './event-bus';
+export { Storage, STORAGE_KEYS } from './storage';
+export { I18n } from './i18n';
+export type { LanguageDict } from './i18n';
+export { HotkeyRegistry } from './hotkey-registry';
+export type { HotkeyBinding } from './hotkey-registry';
+export { parseSRT, parseVTT, fetchSubtitles, getActiveCue, fetchThumbnails, parseThumbnailVTT, getThumbnailAtTime, parseTimestamp, } from './subtitle-parser';
+export type { SubtitleCue, SubtitleTrack, ThumbnailCue } from './subtitle-parser';
+export { detectSourceKind, toPlayerSource, createResolvedMediaEngine } from './source-resolver';
+export type { PlayerSource, SourceKind } from './source-resolver';
+export { canUseMSE, canUseNativeHLS, canUseFullscreen, canUsePictureInPicture, canUseTextTracks, getMediaCapabilities, isFiniteDuration, } from './media-capabilities';
+export type { MediaCapabilitiesSnapshot } from './media-capabilities';
+export { formatTime } from './utils';
+export { defaultPlayerLabels, defaultPlayerIcons } from './defaults';
+export { BaseMediaEngine, NativeVideoEngine, HlsMediaEngine, DashMediaEngine } from './media-engine';
+export type { MediaEngine, MediaEngineDimensions, MediaEngineError, MediaEngineEvent, MediaEngineEventHandler, HlsMediaEngineOptions, DashMediaEngineOptions, } from './media-engine';
+export { createMediaStore, getInitialMediaState, selectMedia, selectAudio, selectPreferences, selectUI, selectPlugins, selectThumbnails, selectError, } from './state/slices';
+export type { PlayerOptions, MediaState, MediaRemote, PlayerLabels, PlayerIcons, SvgIcon, PlayerInstance, PlayerSystems, PlayerError, PlaybackStatus, } from './types';
+export type { ControlRegistration, SettingRegistration, LayerRegistration, ContextMenuItem, ContextMenuRegistration, PlayerPlugin, PluginAPI, RemoteRef, PlayerContextRef, FlipState, AspectRatioState, SettingItem, } from './plugin-api';