@vplayer/core 0.2.2 → 0.3.0

package/dist/media-session.d.ts

@@ -0,0 +1,20 @@
+/**
+ * media-session — Media Session API integration.
+ *
+ * Browsers project this to OS media controls (MPRIS on Linux desktops),
+ * which drive system notifications, lock-screen controls, and media keys.
+ * Metadata alone is not enough: without `playbackState` and action
+ * handlers the OS entry goes stale and its buttons are dead.
+ */
+import type { MediaRemote } from './types';
+type SessionPlaybackState = 'playing' | 'paused';
+export interface MediaSessionController {
+    setup(remote: MediaRemote): void;
+    syncMetadata(title: string | undefined, poster: string | undefined): void;
+    setPlaybackState(state: SessionPlaybackState): void;
+    syncPosition(duration: number, currentTime: number, playbackRate: number, force?: boolean): void;
+    readonly hasMetadata: boolean;
+    teardown(): void;
+}
+export declare function createMediaSessionController(): MediaSessionController;
+export {};

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/types.d.ts

@@ -19,6 +19,12 @@ export interface PlayerOptions {
     /** Title exposed to browser and operating-system media controls. */
     title?: string;
     poster?: string;
+    /**
+     * Artwork URL for OS media controls (Media Session → MPRIS).
+     * Falls back to `poster` when omitted — useful for serving a scaled-down
+     * image when full-size posters are too big.
+     */
+    mediaSessionArtwork?: string;
     subtitles?: SubtitleTrack[];
     subtitleProviders?: SubtitleProvider[];
     qualities?: string[];
@@ -80,6 +86,7 @@ export interface MediaRemote {
     togglePlay: () => void;
     resumeFromSavedProgress: () => void;
     startPlaybackOver: () => void;
+    dismissSavedProgress: () => void;
     seek: (time: number) => void;
     skip: (seconds: number) => void;
     setVolume: (v: number) => void;
@@ -95,6 +102,7 @@ export interface MediaRemote {
     clearSubtitleSearch: () => void;
     setCaptionSettings: (patch: Partial<CaptionSettings>) => void;
     resetCaptionSettings: () => void;
+    saveCaptionSettings: () => void;
     setActiveQuality: (q: string) => void;
     takeScreenshot: () => void;
     setFlip: (flip: FlipState) => void;
@@ -151,6 +159,8 @@ export interface PlayerLabels {
     captionDelay: string;
     captionPreview: string;
     captionReset: string;
+    captionSave: string;
+    captionSaved: string;
     subtitleLoadError: string;
     endedTitle: string;
     screenshot: string;
@@ -168,6 +178,7 @@ export interface PlayerLabels {
     continue: string;
     continuePlay: string;
     continueStartOver: string;
+    dismiss: string;
     error: string;
     retry: string;
     contextMenuPlay: string;
@@ -191,7 +202,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' | 'subtitleProviders' | 'qualities' | 'thumbnails' | 'transformThumbnailVTT' | 'playbackProgress'>>): void;
+    updateOptions(opts: Partial<Pick<PlayerOptions, 'src' | 'type' | 'title' | 'poster' | 'mediaSessionArtwork' | '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.2",
+  "version": "0.3.0",
   "private": false,
   "repository": {
     "type": "git",