itube-modern-player 0.4.1 → 0.4.2

package/dist/player.d.ts

@@ -53,6 +53,10 @@ export declare class Player {
     private upNext;
     /** Runtime autoplay-next toggle (gear switch); seeds from playlist.autoAdvance. */
     private autoAdvanceEnabled;
+    /** localStorage key for persisted prefs, or null when persistence is off. */
+    private persistKey;
+    private persistVolume;
+    private persistAutoAdvance;
     private playlistPanel;
     private scenesPanel;
     private spinner;
@@ -86,6 +90,10 @@ export declare class Player {
     setVolume(volume: number): void;
     setMuted(muted: boolean): void;
     toggleMute(): void;
+    /** Read persisted prefs (safe against private mode / SSR / bad JSON). */
+    private readPersisted;
+    /** Write the enabled prefs to localStorage. No-op when persistence is off. */
+    private persistState;
     get playbackRate(): number;
     setPlaybackRate(rate: number): void;
     get qualityLevels(): Level[];

package/dist/types.d.ts

@@ -396,6 +396,19 @@ export interface PlayerLabels {
 }
 /** SVG icon overrides — raw `<svg>` markup keyed by icon name. */
 export type IconName = 'play' | 'pause' | 'replay' | 'bigPlay' | 'volumeHigh' | 'volumeLow' | 'volumeMute' | 'fullscreen' | 'fullscreenExit' | 'pip' | 'settings' | 'speed' | 'subtitles' | 'list' | 'scenes' | 'next' | 'previous' | 'seekForward' | 'seekBack' | 'shuffle' | 'repeat' | 'like' | 'dislike' | 'addTo' | 'share' | 'report' | 'more' | 'close' | 'user' | 'channel';
+/**
+ * Remember selected user preferences in `localStorage` and restore them on the
+ * next load. Restored values take precedence over the matching options
+ * (`volume` / `muted` / `playlist.autoAdvance`).
+ */
+export interface PersistOptions {
+    /** `localStorage` key. Default `"itube-player"`. */
+    key?: string;
+    /** Remember volume + mute. Default `true`. */
+    volume?: boolean;
+    /** Remember the autoplay-next toggle. Default `true`. */
+    autoAdvance?: boolean;
+}
 export interface PlayerOptions {
     /** Single source or an array (an array enables playlist mode). */
     source?: VideoSource | VideoSource[];
@@ -444,6 +457,12 @@ export interface PlayerOptions {
     crossOrigin?: '' | 'anonymous' | 'use-credentials';
     /** Inline playback on iOS. Default true. */
     playsInline?: boolean;
+    /**
+     * Persist user preferences (volume/mute, autoplay-next) to `localStorage`
+     * and restore them on the next load. `true` enables all with defaults; pass
+     * an object for granular control / a custom key. Off by default.
+     */
+    persist?: boolean | PersistOptions;
 }
 /** A single popularity sample: how often users sought/replayed near `time`. */
 export interface HeatmapPoint {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itube-modern-player",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Lightweight, framework-agnostic HTML5 video player: HLS streams, playlists, chapters, VTT subtitles, sprite previews, VAST ads. Ships with a Vue 3 wrapper.",
   "type": "module",
   "main": "./dist/index.cjs",