@vplayer/core 0.2.1 → 0.2.3

package/dist/playback-progress.d.ts

@@ -11,10 +11,15 @@ export interface PlaybackProgressStore {
 export interface PlaybackProgressOptions {
     id?: string;
     store?: PlaybackProgressStore;
+    /** Normalize the media URL used as the progress key. Defaults to true. */
+    normalizeUrl?: boolean;
+    /** Milliseconds before the resume prompt dismisses itself. Use 0 to keep it visible. Defaults to 5000. */
+    resumePromptTimeout?: number;
 }
 export declare class LocalPlaybackProgressStore implements PlaybackProgressStore {
     private readonly storage;
-    constructor(storage?: Storage);
+    private readonly maxEntries;
+    constructor(storage?: Storage, maxEntries?: number);
     load(mediaId: string): Promise<PlaybackProgress | null>;
     save(mediaId: string, progress: PlaybackProgress): Promise<void>;
     clear(mediaId: string): Promise<void>;

package/dist/plugin-api.d.ts

@@ -10,6 +10,7 @@ export interface RemoteRef {
     seek: (time: number) => void;
     resumeFromSavedProgress: () => void;
     startPlaybackOver: () => void;
+    dismissSavedProgress: () => void;
     skip: (seconds: number) => void;
     setVolume: (v: number) => void;
     toggleMute: () => void;

package/dist/state/slices.d.ts

@@ -16,7 +16,7 @@ import type { PlaybackProgress } from '../playback-progress';
 import type { ControlRegistration, ContextMenuItem, FlipState, AspectRatioState } from '../plugin-api';
 import type { LayerRegistration, SettingRegistration } from '../plugin-api';
 import type { PlayerSource } from '../source-resolver';
-import type { SubtitleTrack, ThumbnailCue } from '../subtitle-parser';
+import type { CaptionSettings, SubtitleCue, SubtitleProviderInfo, SubtitleProviderResult, SubtitleTrack, ThumbnailCue } from '../subtitle-parser';
 export type PlaybackStatus = 'idle' | 'loading' | 'ready' | 'playing' | 'paused' | 'buffering' | 'seeking' | 'ended' | 'error';
 export interface MediaSlice {
     status: PlaybackStatus;
@@ -41,6 +41,14 @@ export interface PreferencesSlice {
     aspectRatio: AspectRatioState;
     activeSubtitle: SubtitleTrack | null;
     subtitleTracks: SubtitleTrack[];
+    subtitleCues: SubtitleCue[];
+    subtitleStatus: 'idle' | 'loading' | 'ready' | 'error';
+    subtitleError: string | null;
+    subtitleProviders: SubtitleProviderInfo[];
+    subtitleSearchResults: SubtitleProviderResult[];
+    subtitleSearchStatus: 'idle' | 'loading' | 'ready' | 'error';
+    subtitleSearchError: string | null;
+    captionSettings: CaptionSettings;
     activeQuality: string;
     qualities: string[];
 }
@@ -71,8 +79,16 @@ export interface ErrorSlice {
         isReconnecting: boolean;
     } | null;
 }
+export type ResumeState = {
+    status: 'idle';
+} | {
+    status: 'loading';
+} | {
+    status: 'prompt';
+    progress: PlaybackProgress;
+};
 export interface PlaybackProgressSlice {
-    resumeProgress: PlaybackProgress | null;
+    resumeState: ResumeState;
 }
 /**
  * Full MediaState — flat at runtime, logically organized here.
@@ -97,7 +113,7 @@ export declare const selectMedia: (s: MediaState) => {
     bufferedPercent: number;
     playbackRate: number;
     isLive: boolean;
-    resumeProgress: PlaybackProgress | null;
+    resumeState: ResumeState;
 };
 export declare const selectAudio: (s: MediaState) => {
     volume: number;
@@ -109,6 +125,14 @@ export declare const selectPreferences: (s: MediaState) => {
     aspectRatio: AspectRatioState;
     activeSubtitle: SubtitleTrack | null;
     subtitleTracks: SubtitleTrack[];
+    subtitleCues: SubtitleCue[];
+    subtitleStatus: "error" | "idle" | "loading" | "ready";
+    subtitleError: string | null;
+    subtitleProviders: SubtitleProviderInfo[];
+    subtitleSearchResults: SubtitleProviderResult[];
+    subtitleSearchStatus: "error" | "idle" | "loading" | "ready";
+    subtitleSearchError: string | null;
+    captionSettings: CaptionSettings;
     activeQuality: string;
     qualities: string[];
 };

package/dist/storage.d.ts

@@ -13,12 +13,13 @@ export declare class Storage {
 }
 /** Pre-defined persistence keys */
 export declare const STORAGE_KEYS: {
-    readonly VOLUME: "volume";
-    readonly MUTED: "muted";
-    readonly PLAYBACK_RATE: "playbackRate";
-    readonly SUBTITLE_LANG: "subtitleLang";
-    readonly QUALITY: "quality";
-    readonly LOOP: "loop";
-    readonly FLIP: "flip";
-    readonly ASPECT_RATIO: "aspectRatio";
+    readonly VOLUME: 'volume';
+    readonly MUTED: 'muted';
+    readonly PLAYBACK_RATE: 'playbackRate';
+    readonly SUBTITLE_LANG: 'subtitleLang';
+    readonly CAPTION_SETTINGS: 'captionSettings';
+    readonly QUALITY: 'quality';
+    readonly LOOP: 'loop';
+    readonly FLIP: 'flip';
+    readonly ASPECT_RATIO: 'aspectRatio';
 };

package/dist/subtitle-parser.d.ts

@@ -1,23 +1,105 @@
+export type SubtitleFormat = 'vtt' | 'srt';
 export interface SubtitleCue {
     index: number;
     start: number;
     end: number;
     text: string;
+    id?: string;
+    settings?: string;
 }
 export interface SubtitleTrack {
-    src: string;
+    id?: string;
+    src?: string;
+    content?: string;
     lang: string;
     label: string;
+    format?: SubtitleFormat;
     default?: boolean;
+    local?: boolean;
+}
+export interface SubtitleSearchQuery {
+    query?: string;
+    title?: string;
+    year?: number;
+    season?: number;
+    episode?: number;
+    imdbId?: string;
+    languages?: string[];
+    providerId?: string;
+}
+export interface SubtitleSearchItem {
+    id: string;
+    label: string;
+    language: string;
+    format?: SubtitleFormat;
+    release?: string;
+    downloads?: number;
+    hearingImpaired?: boolean;
+    machineTranslated?: boolean;
+    providerData?: unknown;
+}
+export interface SubtitleProviderResult extends SubtitleSearchItem {
+    providerId: string;
+    providerLabel: string;
+}
+export interface SubtitleSearchResult {
+    items: SubtitleSearchItem[];
+}
+export type SubtitleSource = {
+    content: string;
+    src?: never;
+    format?: SubtitleFormat;
+} | {
+    src: string;
+    content?: never;
+    format?: SubtitleFormat;
+};
+export interface SubtitleProvider {
+    id: string;
+    label: string;
+    search(query: SubtitleSearchQuery, signal: AbortSignal): Promise<SubtitleSearchResult | SubtitleSearchItem[]>;
+    fetch(item: SubtitleSearchItem, signal: AbortSignal): Promise<SubtitleSource>;
+}
+export type SubtitleProviderInfo = Pick<SubtitleProvider, 'id' | 'label'>;
+export interface CaptionSettings {
+    fontSize: 'small' | 'medium' | 'large';
+    fontScale: number;
+    fontFamily: 'sans' | 'serif' | 'monospace';
+    textColor: string;
+    textOpacity: number;
+    backgroundColor: string;
+    backgroundOpacity: number;
+    edgeStyle: 'none' | 'shadow' | 'outline';
+    edgeColor: string;
+    position: number;
+    lineHeight: number;
+    delay: number;
+}
+export declare const DEFAULT_CAPTION_SETTINGS: CaptionSettings;
+export interface SubtitleParseError {
+    code: 'unsupported-format' | 'malformed';
+    message: string;
 }
-/** Parse HH:MM:SS.mmm or HH:MM:SS,mmm timestamp → total seconds */
-export declare function parseTimestamp(ts: string): number;
-/** Parse SRT format text into cues */
+export type SubtitleParseResult = {
+    ok: true;
+    format: SubtitleFormat;
+    cues: SubtitleCue[];
+} | {
+    ok: false;
+    format?: undefined;
+    error: SubtitleParseError;
+};
+/** Parse HH:MM:SS.mmm, MM:SS.mmm, and comma-separated variants. */
+export declare function parseTimestamp(timestamp: string): number;
 export declare function parseSRT(content: string): SubtitleCue[];
-/** Parse VTT format text into cues */
 export declare function parseVTT(content: string): SubtitleCue[];
-/** Fetch and parse subtitles from URL */
-export declare function fetchSubtitles(track: SubtitleTrack): Promise<SubtitleCue[]>;
+export declare function parseSubtitles(content: string, hint?: {
+    format?: SubtitleFormat;
+    fileName?: string;
+    mimeType?: string;
+}): SubtitleParseResult;
+/** Fetch and parse subtitles from URL. */
+export declare function fetchSubtitles(track: SubtitleTrack, signal?: AbortSignal): Promise<SubtitleCue[]>;
 /** Get active cue at a given time */
 export declare function getActiveCue(cues: SubtitleCue[], time: number): SubtitleCue | null;
 export interface ThumbnailCue {

package/dist/types.d.ts

@@ -8,11 +8,10 @@ import type { PlaybackProgressOptions } from './playback-progress';
 import type { PlayerPlugin } from './plugin-api';
 import type { AspectRatioState, FlipState } from './plugin-api';
 import type { PlayerSource } from './source-resolver';
-import type { PlaybackStatus } from './state/slices';
-import type { MediaState } from './state/slices';
+import type { MediaState, PlaybackStatus, ResumeState } from './state/slices';
 import type { Storage } from './storage';
-import type { SubtitleTrack } from './subtitle-parser';
-export type { MediaState };
+import type { CaptionSettings, SubtitleProvider, SubtitleProviderResult, SubtitleSearchQuery, SubtitleTrack } from './subtitle-parser';
+export type { MediaState, ResumeState };
 export interface PlayerOptions {
     src: string;
     /** MIME/content type hint used by source provider selection. */
@@ -21,6 +20,7 @@ export interface PlayerOptions {
     title?: string;
     poster?: string;
     subtitles?: SubtitleTrack[];
+    subtitleProviders?: SubtitleProvider[];
     qualities?: string[];
     autoPlay?: boolean;
     thumbnails?: string;
@@ -80,6 +80,7 @@ export interface MediaRemote {
     togglePlay: () => void;
     resumeFromSavedProgress: () => void;
     startPlaybackOver: () => void;
+    dismissSavedProgress: () => void;
     seek: (time: number) => void;
     skip: (seconds: number) => void;
     setVolume: (v: number) => void;
@@ -88,6 +89,13 @@ export interface MediaRemote {
     toggleFullscreen: () => void;
     togglePiP: () => void;
     setActiveSubtitle: (track: SubtitleTrack | null) => void;
+    addSubtitleTrack: (track: SubtitleTrack) => void;
+    removeSubtitleTrack: (id: string) => void;
+    searchSubtitles: (query?: SubtitleSearchQuery) => void;
+    selectSubtitleResult: (result: SubtitleProviderResult) => void;
+    clearSubtitleSearch: () => void;
+    setCaptionSettings: (patch: Partial<CaptionSettings>) => void;
+    resetCaptionSettings: () => void;
     setActiveQuality: (q: string) => void;
     takeScreenshot: () => void;
     setFlip: (flip: FlipState) => void;
@@ -113,6 +121,38 @@ export interface PlayerLabels {
     quality: string;
     subtitles: string;
     off: string;
+    loadSubtitleFile: string;
+    findSubtitlesOnline: string;
+    subtitleSearch: string;
+    subtitleSearchPlaceholder: string;
+    subtitleSource: string;
+    subtitleAllSources: string;
+    subtitleLanguage: string;
+    subtitleAllLanguages: string;
+    subtitleNoResults: string;
+    subtitleSearching: string;
+    captionAppearance: string;
+    captionSize: string;
+    captionTextColor: string;
+    captionBackgroundColor: string;
+    captionBackgroundOpacity: string;
+    captionSmall: string;
+    captionMedium: string;
+    captionLarge: string;
+    captionFontFamily: string;
+    captionFontScale: string;
+    captionTextOpacity: string;
+    captionEdgeStyle: string;
+    captionEdgeNone: string;
+    captionEdgeShadow: string;
+    captionEdgeOutline: string;
+    captionEdgeColor: string;
+    captionPosition: string;
+    captionLineHeight: string;
+    captionDelay: string;
+    captionPreview: string;
+    captionReset: string;
+    subtitleLoadError: string;
     endedTitle: string;
     screenshot: string;
     flip: string;
@@ -129,6 +169,7 @@ export interface PlayerLabels {
     continue: string;
     continuePlay: string;
     continueStartOver: string;
+    dismiss: string;
     error: string;
     retry: string;
     contextMenuPlay: string;
@@ -152,7 +193,7 @@ export interface PlayerInstance {
     hotkeys: HotkeyRegistry;
     /** The active media engine. Null before mount and after unmount. */
     engine: MediaEngine | null;
-    updateOptions(opts: Partial<Pick<PlayerOptions, 'src' | 'type' | 'title' | 'poster' | 'autoPlay' | 'subtitles' | 'qualities' | 'thumbnails' | 'transformThumbnailVTT' | 'playbackProgress'>>): void;
+    updateOptions(opts: Partial<Pick<PlayerOptions, 'src' | 'type' | 'title' | 'poster' | 'autoPlay' | 'subtitles' | 'subtitleProviders' | 'qualities' | 'thumbnails' | 'transformThumbnailVTT' | 'playbackProgress'>>): void;
     setThumbnails(url?: string): void;
     initPlugins(plugins: PlayerPlugin[]): () => void;
     mount(videoEl: HTMLVideoElement, containerEl: HTMLDivElement): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vplayer/core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "private": false,
   "repository": {
     "type": "git",
@@ -33,12 +33,12 @@
     "test:coverage": "vitest run --coverage"
   },
   "dependencies": {
-    "@tanstack/store": "^0.8.0",
-    "dashjs": "^5.1.1",
-    "hls.js": "^1.6.16"
+    "@tanstack/store": "^0.11.1",
+    "dashjs": "^5.2.1",
+    "hls.js": "^1.7.1"
   },
   "devDependencies": {
-    "typescript": "^6.0.2",
-    "vite": "^8.0.0"
+    "typescript": "^7.0.2",
+    "vite": "^8.2.2"
   }
 }