@vplayer/core 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -23,5 +23,5 @@ export type { MediaSessionController } from './media-session';
 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, TransformThumbnailVTT, MediaState, ResumeState, MediaRemote, PlayerLabels, PlayerInstance, PlayerSystems, PlayerError, PlaybackStatus, } from './types';
+export type { PlayerOptions, MediaSessionMetadataOptions, TransformThumbnailVTT, MediaState, ResumeState, MediaRemote, PlayerLabels, PlayerInstance, PlayerSystems, PlayerError, PlaybackStatus, } from './types';
 export type { ControlRegistration, SettingRegistration, LayerRegistration, ContextMenuItem, ContextMenuRegistration, PlayerPlugin, PluginAPI, RemoteRef, PlayerContextRef, FlipState, AspectRatioState, SettingItem, } from './plugin-api';

package/dist/index.js

@@ -205,70 +205,72 @@ function _(e, t, n) {
 	} catch {}
 }
 function v() {
-	let e = null, t, n, r = !1, i = NaN, a = NaN, o = NaN;
-	function s() {
-		let r = g();
-		r && e && r.metadata === e && (r.metadata = null), e = null, t = void 0, n = void 0;
+	let e = null, t, n, r, i, a = !1, o = NaN, s = NaN, c = NaN;
+	function l() {
+		let a = g();
+		a && e && a.metadata === e && (a.metadata = null), e = null, t = void 0, n = void 0, r = void 0, i = void 0;
 	}
-	function c(e) {
+	function u(e) {
 		let t = g();
-		!t || r || (_(t, "play", () => e.play()), _(t, "pause", () => e.pause()), _(t, "seekbackward", (t) => {
+		!t || a || (_(t, "play", () => e.play()), _(t, "pause", () => e.pause()), _(t, "seekbackward", (t) => {
 			e.skip(-(t.seekOffset ?? p));
 		}), _(t, "seekforward", (t) => {
 			e.skip(t.seekOffset ?? p);
 		}), _(t, "seekto", (t) => {
 			typeof t.seekTime == "number" && e.seek(t.seekTime);
-		}), r = !0);
-	}
-	function l(r, i) {
-		let a = g();
-		if (!a || typeof MediaMetadata > "u") return;
-		let o = r?.trim() || void 0;
-		if (!o) {
-			s();
+		}), a = !0);
+	}
+	function d(a, o, s) {
+		let c = g();
+		if (!c || typeof MediaMetadata > "u") return;
+		let u = a?.trim() || void 0, d = o?.artwork ?? s, f = o?.artist?.trim() || void 0, p = o?.album?.trim() || void 0;
+		if (!u) {
+			l();
 			return;
 		}
-		if (e && a.metadata === e && t === o && n === i) return;
-		let c = new MediaMetadata({
-			title: o,
-			artwork: i ? [{ src: i }] : []
+		if (e && c.metadata === e && t === u && n === d && r === f && i === p) return;
+		let m = new MediaMetadata({
+			title: u,
+			...f ? { artist: f } : {},
+			...p ? { album: p } : {},
+			artwork: d ? [{ src: d }] : []
 		});
-		a.metadata = c, e = c, t = o, n = i;
+		c.metadata = m, e = m, t = u, n = d, r = f, i = p;
 	}
-	function u(e) {
+	function v(e) {
 		let t = g();
 		t && (t.playbackState = e);
 	}
-	function d(e, t, n, r = !1) {
-		let s = g();
-		if (!(!s || typeof s.setPositionState != "function") && !(!f(e) || !Number.isFinite(t) || t < 0) && !(!r && Number.isFinite(i) && Math.abs(t - i) < m && e === a && n === o)) try {
-			s.setPositionState({
+	function y(e, t, n, r = !1) {
+		let i = g();
+		if (!(!i || typeof i.setPositionState != "function") && !(!f(e) || !Number.isFinite(t) || t < 0) && !(!r && Number.isFinite(o) && Math.abs(t - o) < m && e === s && n === c)) try {
+			i.setPositionState({
 				duration: e,
 				playbackRate: n,
 				position: Math.min(t, e)
-			}), i = t, a = e, o = n;
+			}), o = t, s = e, c = n;
 		} catch {}
 	}
-	function v() {
+	function b() {
 		let e = g();
 		if (e) {
-			if (r) {
+			if (a) {
 				for (let t of h) _(e, t, null);
-				r = !1;
+				a = !1;
 			}
 			e.playbackState = "none";
 		}
-		s(), i = NaN, a = NaN, o = NaN;
+		l(), o = NaN, s = NaN, c = NaN;
 	}
 	return {
-		setup: c,
-		syncMetadata: l,
-		setPlaybackState: u,
-		syncPosition: d,
+		setup: u,
+		syncMetadata: d,
+		setPlaybackState: v,
+		syncPosition: y,
 		get hasMetadata() {
 			return e !== null;
 		},
-		teardown: v
+		teardown: b
 	};
 }
 //#endregion
@@ -867,15 +869,15 @@ var U = (e) => ({
 	layers: e.layers,
 	contextMenuItems: e.contextMenuItems,
 	contextMenuEnabled: e.contextMenuEnabled
-}), se = (e) => ({ thumbnailCues: e.thumbnailCues }), q = (e) => e.error, J = [
+}), se = (e) => ({ thumbnailCues: e.thumbnailCues }), ce = (e) => e.error, q = [
 	"default",
 	"16:9",
 	"4:3",
 	"21:9",
 	"cover",
 	"fill"
-], ce = 5e3, le = 2;
-function ue(e) {
+], le = 5e3, ue = 2;
+function de(e) {
 	try {
 		let t = new URL(e, typeof document > "u" ? void 0 : document.baseURI);
 		return t.search = "", t.hash = "", t.href;
@@ -883,11 +885,11 @@ function ue(e) {
 		return e.split(/[?#]/, 1)[0] ?? e;
 	}
 }
-var de = {
+var fe = {
 	"16:9": "16 / 9",
 	"4:3": "4 / 3",
 	"21:9": "21 / 9"
-}, fe = {
+}, pe = {
 	default: "default",
 	"16:9": "16-9",
 	"4:3": "4-3",
@@ -895,27 +897,27 @@ var de = {
 	cover: "cover",
 	fill: "fill"
 };
-function pe(e) {
-	e.classList.remove("vplayer--media-default", "vplayer--media-16-9", "vplayer--media-4-3", "vplayer--media-21-9", "vplayer--media-cover", "vplayer--media-fill");
-}
 function me(e) {
-	return typeof e == "string" && e in fe ? e : "default";
+	e.classList.remove("vplayer--media-default", "vplayer--media-16-9", "vplayer--media-4-3", "vplayer--media-21-9", "vplayer--media-cover", "vplayer--media-fill");
 }
 function he(e) {
+	return typeof e == "string" && e in pe ? e : "default";
+}
+function ge(e) {
 	return e === "cover" ? "cover" : e === "fill" ? "fill" : "contain";
 }
-function Y(e) {
+function J(e) {
 	return {
 		...e,
 		id: e.id ?? `${e.local ? "local" : "track"}:${e.src ?? e.label}:${e.lang}`
 	};
 }
-function ge(e) {
+function Y(e) {
 	let r = ae(), i = { ...e }, o = new t(), s = new b(), c = new a(i.lang);
 	i.translations && c.addTranslations(i.lang ?? "en", i.translations);
 	let l = new n(), u = i.reconnectMax ?? 3, p = i.reconnectSleep ?? 1500, m = null, h = null, g = null, _ = 0, y = NaN, S = null, C = 0, w = null, T = null, E = null, D = v(), A = new ee(), j = 0, M = !1, N = null, P = [], F = !1;
 	function I(e) {
-		let t = e.playbackProgress?.id ?? (e.playbackProgress?.normalizeUrl === !1 ? e.src : ue(e.src));
+		let t = e.playbackProgress?.id ?? (e.playbackProgress?.normalizeUrl === !1 ? e.src : de(e.src));
 		return {
 			generation: j,
 			id: t,
@@ -953,7 +955,7 @@ function ge(e) {
 		}));
 	}
 	function ie(e) {
-		!r.state.isPlaying || Date.now() - _ < ce || Number.isFinite(y) && Math.abs(e.currentTime - y) < le || V(L, e);
+		!r.state.isPlaying || Date.now() - _ < le || Number.isFinite(y) && Math.abs(e.currentTime - y) < ue || V(L, e);
 	}
 	function H() {
 		j++, L = I(i), M = !1, _ = 0, y = NaN, r.setState((e) => ({
@@ -996,7 +998,7 @@ function ge(e) {
 		r.setState((t) => {
 			let n = new Map(t.subtitleTracks.map((e) => [e.id, e]));
 			for (let t of e) {
-				let e = Y(t);
+				let e = J(t);
 				n.set(e.id, e);
 			}
 			return {
@@ -1103,7 +1105,7 @@ function ge(e) {
 			subtitleError: null
 		})), (async () => {
 			try {
-				let i = await t.fetch(e, n.signal), a = Y({
+				let i = await t.fetch(e, n.signal), a = J({
 					id: `provider:${t.id}:${e.id}`,
 					lang: e.language,
 					label: e.label,
@@ -1130,63 +1132,60 @@ function ge(e) {
 		})();
 	}
 	i.subtitles?.length && W(i.subtitles), K();
-	function q() {
-		return i.mediaSessionArtwork ?? i.poster;
-	}
-	function ge() {
+	function ce() {
 		l.register({
 			key: "Space",
 			description: "Toggle play/pause",
 			handler: (e) => {
-				e.preventDefault(), Z.togglePlay();
+				e.preventDefault(), X.togglePlay();
 			}
 		}), l.register({
 			key: "KeyK",
 			description: "Toggle play/pause",
 			handler: (e) => {
-				e.preventDefault(), Z.togglePlay();
+				e.preventDefault(), X.togglePlay();
 			}
 		}), l.register({
 			key: "KeyL",
 			description: "Toggle loop",
 			handler: (e) => {
-				e.preventDefault(), Z.toggleLoop();
+				e.preventDefault(), X.toggleLoop();
 			}
 		}), l.register({
 			key: "KeyI",
 			description: "Toggle info panel",
 			handler: (e) => {
-				e.preventDefault(), Z.toggleInfoPanel();
+				e.preventDefault(), X.toggleInfoPanel();
 			}
 		}), l.register({
 			key: "KeyF",
 			description: "Toggle fullscreen",
 			handler: (e) => {
-				e.preventDefault(), Z.toggleFullscreen();
+				e.preventDefault(), X.toggleFullscreen();
 			}
 		}), l.register({
 			key: "KeyA",
 			description: "Cycle aspect ratio",
 			handler: (e) => {
-				e.preventDefault(), Z.cycleAspectRatio();
+				e.preventDefault(), X.cycleAspectRatio();
 			}
 		}), l.register({
 			key: "KeyM",
 			description: "Toggle mute",
 			handler: (e) => {
-				e.preventDefault(), Z.toggleMute();
+				e.preventDefault(), X.toggleMute();
 			}
 		}), l.register({
 			key: "ArrowLeft",
 			description: "Seek backward 5s",
 			handler: (e) => {
-				e.preventDefault(), Z.skip(-5);
+				e.preventDefault(), X.skip(-5);
 			}
 		}), l.register({
 			key: "ArrowRight",
 			description: "Seek forward 5s",
 			handler: (e) => {
-				e.preventDefault(), Z.skip(5);
+				e.preventDefault(), X.skip(5);
 			}
 		}), l.register({
 			key: "ArrowUp",
@@ -1194,7 +1193,7 @@ function ge(e) {
 			handler: (e) => {
 				e.preventDefault();
 				let t = Math.min(1, r.state.volume + .1);
-				Z.setVolume(t);
+				X.setVolume(t);
 			}
 		}), l.register({
 			key: "ArrowDown",
@@ -1202,12 +1201,12 @@ function ge(e) {
 			handler: (e) => {
 				e.preventDefault();
 				let t = Math.max(0, r.state.volume - .1);
-				Z.setVolume(t);
+				X.setVolume(t);
 			}
 		});
 	}
-	i.defaultHotkeys !== !1 && ge();
-	function X() {
+	i.defaultHotkeys !== !1 && ce();
+	function Y() {
 		if (typeof document > "u") return;
 		let e = document;
 		r.setState((t) => ({
@@ -1216,7 +1215,7 @@ function ge(e) {
 			capabilities: d(h?.element ?? void 0, m)
 		}));
 	}
-	let Z = {
+	let X = {
 		play: () => {
 			h?.play();
 		},
@@ -1279,7 +1278,7 @@ function ge(e) {
 		toggleFullscreen: () => {
 			if (!m || typeof document > "u") return;
 			let e = m, t = document, n = !!(document.fullscreenElement || t.webkitFullscreenElement), r = () => {
-				m?.focus({ preventScroll: !0 }), X();
+				m?.focus({ preventScroll: !0 }), Y();
 			}, i = n ? typeof document.exitFullscreen == "function" ? document.exitFullscreen() : t.webkitExitFullscreen?.() : typeof m.requestFullscreen == "function" ? m.requestFullscreen() : e.webkitRequestFullscreen?.();
 			Promise.resolve(i).then(r, r);
 		},
@@ -1301,11 +1300,11 @@ function ge(e) {
 			G(e);
 		},
 		addSubtitleTrack: (e) => {
-			let t = Y(e);
+			let t = J(e);
 			W([t]), G(t);
 		},
 		removeSubtitleTrack: (e) => {
-			r.state.activeSubtitle?.id === e && Z.setActiveSubtitle(null), r.setState((t) => ({
+			r.state.activeSubtitle?.id === e && X.setActiveSubtitle(null), r.setState((t) => ({
 				...t,
 				subtitleTracks: t.subtitleTracks.filter((t) => t.id !== e)
 			}));
@@ -1368,17 +1367,17 @@ function ge(e) {
 			}));
 		},
 		setAspectRatio: (e) => {
-			let t = me(e), n = h?.element;
+			let t = he(e), n = h?.element;
 			if (!n) return;
-			let i = de[t];
-			i ? n.style.setProperty("--vplayer-media-aspect-ratio", i) : n.style.removeProperty("--vplayer-media-aspect-ratio"), n.style.objectFit = he(t), n.style.setProperty("--vplayer-media-object-fit", he(t)), m && (pe(m), m.classList.add(`vplayer--media-${fe[t]}`)), r.setState((e) => ({
+			let i = fe[t];
+			i ? n.style.setProperty("--vplayer-media-aspect-ratio", i) : n.style.removeProperty("--vplayer-media-aspect-ratio"), n.style.objectFit = ge(t), n.style.setProperty("--vplayer-media-object-fit", ge(t)), m && (me(m), m.classList.add(`vplayer--media-${pe[t]}`)), r.setState((e) => ({
 				...e,
 				aspectRatio: t
 			}));
 		},
 		cycleAspectRatio: () => {
-			let e = r.state.aspectRatio, t = J[(J.indexOf(e) + 1) % J.length] ?? "default";
-			Z.setAspectRatio(t);
+			let e = r.state.aspectRatio, t = q[(q.indexOf(e) + 1) % q.length] ?? "default";
+			X.setAspectRatio(t);
 		},
 		toggleLoop: () => {
 			let e = h;
@@ -1397,7 +1396,7 @@ function ge(e) {
 	function _e(e) {
 		return [
 			e.on("play", () => {
-				D.syncMetadata(i.title, q()), D.setPlaybackState("playing"), r.setState((e) => ({
+				D.syncMetadata(i.title, i.mediaSession, i.poster), D.setPlaybackState("playing"), r.setState((e) => ({
 					...e,
 					status: "playing",
 					isPlaying: !0,
@@ -1552,7 +1551,7 @@ function ge(e) {
 			})
 		];
 	}
-	let Q = null;
+	let Z = null;
 	function ve() {
 		let e = s.get(x.CAPTION_SETTINGS);
 		e && r.setState((t) => ({
@@ -1574,19 +1573,19 @@ function ge(e) {
 			playbackRate: n ?? r.playbackRate,
 			isLooping: a ?? r.isLooping,
 			flip: o ?? r.flip,
-			aspectRatio: me(c)
-		})), ve(), Q = r.subscribe(() => {
+			aspectRatio: he(c)
+		})), ve(), Z = r.subscribe(() => {
 			let e = r.state;
 			e.volume !== 1 && s.set(x.VOLUME, e.volume), e.isMuted && s.set(x.MUTED, !0), e.playbackRate !== 1 && s.set(x.PLAYBACK_RATE, e.playbackRate), e.isLooping ? s.set(x.LOOP, !0) : s.remove(x.LOOP), e.flip === "normal" ? s.remove(x.FLIP) : s.set(x.FLIP, e.flip), e.aspectRatio === "default" ? s.remove(x.ASPECT_RATIO) : s.set(x.ASPECT_RATIO, e.aspectRatio), s.set(x.CAPTION_SETTINGS, e.captionSettings);
 		});
 	}
 	function be() {
-		if (Q) {
-			let e = Q;
-			typeof e == "function" ? e() : e.unsubscribe(), Q = null;
+		if (Z) {
+			let e = Z;
+			typeof e == "function" ? e() : e.unsubscribe(), Z = null;
 		}
 	}
-	function $(e) {
+	function Q(e) {
 		if (w?.abort(), w = null, !e) {
 			r.setState((e) => ({
 				...e,
@@ -1611,7 +1610,7 @@ function ge(e) {
 		return {
 			name: e,
 			store: r,
-			remote: Z,
+			remote: X,
 			events: o,
 			storage: s,
 			hotkeys: l,
@@ -1690,15 +1689,15 @@ function ge(e) {
 			}
 		};
 	}
-	let Se = [];
-	function Ce(e = !0) {
+	let $ = [];
+	function Se(e = !0) {
 		S !== null && (clearTimeout(S), S = null), C = 0;
-		for (let e of Se) e();
-		Se = [], h && (e && V(L, h), h.pause(), h.destroy(), h = null, Ee.engine = null);
+		for (let e of $) e();
+		$ = [], h && (e && V(L, h), h.pause(), h.destroy(), h = null, Te.engine = null);
 	}
-	function we(e) {
+	function Ce(e) {
 		let t = O(i), n = te(e, i);
-		h = n, Ee.engine = n, Se = _e(n), e.playsInline = !0, e.autoplay = !!i.autoPlay, e.preload = e.preload || "metadata", D.setPlaybackState("paused"), r.setState((n) => ({
+		h = n, Te.engine = n, $ = _e(n), e.playsInline = !0, e.autoplay = !!i.autoPlay, e.preload = e.preload || "metadata", D.setPlaybackState("paused"), r.setState((n) => ({
 			...n,
 			status: "loading",
 			source: t,
@@ -1713,16 +1712,16 @@ function ge(e) {
 			error: null
 		})), i.autoPlay && n.play();
 	}
-	function Te(e = !0) {
+	function we(e = !0) {
 		let t = h?.element;
 		if (t) {
-			for (Ce(e), t.pause(), t.removeAttribute("src"); t.firstChild;) t.removeChild(t.firstChild);
-			t.load(), we(t);
+			for (Se(e), t.pause(), t.removeAttribute("src"); t.firstChild;) t.removeChild(t.firstChild);
+			t.load(), Ce(t);
 		}
 	}
-	let Ee = {
+	let Te = {
 		store: r,
-		remote: Z,
+		remote: X,
 		events: o,
 		storage: s,
 		i18n: c,
@@ -1733,7 +1732,7 @@ function ge(e) {
 				...i,
 				...e
 			}, l = I(c), u = l.id !== L.id || l.store !== L.store;
-			if ((t || u) && V(L, h), i = c, (t || u) && H(), (r.state.isPlaying || D.hasMetadata) && D.syncMetadata(i.title, q()), r.setState((t) => {
+			if ((t || u) && V(L, h), i = c, (t || u) && H(), (r.state.isPlaying || D.hasMetadata) && D.syncMetadata(i.title, i.mediaSession, i.poster), r.setState((t) => {
 				let n = e.qualities ?? t.qualities;
 				return {
 					...t,
@@ -1742,15 +1741,15 @@ function ge(e) {
 				};
 			}), e.subtitles && (W(e.subtitles), !r.state.activeSubtitle)) {
 				let t = e.subtitles.find((e) => e.default) ?? null;
-				t && Z.setActiveSubtitle(Y(t));
+				t && X.setActiveSubtitle(J(t));
 			}
-			s && (E?.abort(), E = null, K()), (a || o) && $(i.thumbnails), t || n ? Te(!(t || u)) : u && h && f(h.duration) && U(h);
+			s && (E?.abort(), E = null, K()), (a || o) && Q(i.thumbnails), t || n ? we(!(t || u)) : u && h && f(h.duration) && U(h);
 		},
 		setThumbnails(e) {
 			i = {
 				...i,
 				thumbnails: e
-			}, $(e);
+			}, Q(e);
 		},
 		initPlugins(e) {
 			let t = [];
@@ -1772,12 +1771,12 @@ function ge(e) {
 			};
 		},
 		mount(e, t) {
-			h && this.unmount(), m = t, we(e), g = X, document.addEventListener("fullscreenchange", g), document.addEventListener("webkitfullscreenchange", g), N = () => V(), window.addEventListener("pagehide", N), D.setup(Z), $(i.thumbnails);
+			h && this.unmount(), m = t, Ce(e), g = Y, document.addEventListener("fullscreenchange", g), document.addEventListener("webkitfullscreenchange", g), N = () => V(), window.addEventListener("pagehide", N), D.setup(X), Q(i.thumbnails);
 			let n = r.state.subtitleTracks.find((e) => e.default);
-			n && Z.setActiveSubtitle(n), ve(), ye(), Z.setAspectRatio(r.state.aspectRatio);
+			n && X.setActiveSubtitle(n), ve(), ye(), X.setAspectRatio(r.state.aspectRatio);
 		},
 		unmount() {
-			Ce(), H(), D.teardown(), m = null, w?.abort(), w = null, T?.abort(), T = null, E?.abort(), E = null, be(), S !== null && (clearTimeout(S), S = null), g &&= (document.removeEventListener("fullscreenchange", g), document.removeEventListener("webkitfullscreenchange", g), null), N &&= (window.removeEventListener("pagehide", N), null), r.setState((e) => ({
+			Se(), H(), D.teardown(), m = null, w?.abort(), w = null, T?.abort(), T = null, E?.abort(), E = null, be(), S !== null && (clearTimeout(S), S = null), g &&= (document.removeEventListener("fullscreenchange", g), document.removeEventListener("webkitfullscreenchange", g), null), N &&= (window.removeEventListener("pagehide", N), null), r.setState((e) => ({
 				...e,
 				activeSubtitle: null,
 				subtitleTracks: e.subtitleTracks.filter((e) => !e.local),
@@ -1795,7 +1794,7 @@ function ge(e) {
 			this.unmount(), o.clear();
 		}
 	};
-	return Ee;
+	return Te;
 }
 //#endregion
 //#region src/gesture-engine.ts
@@ -1859,14 +1858,14 @@ function X(e, t) {
 }
 //#endregion
 //#region src/utils.ts
-function Z(e) {
+function _e(e) {
 	if (!Number.isFinite(e) || e < 0) return "0:00";
 	let t = Math.floor(e / 3600), n = Math.floor(e % 3600 / 60), r = Math.floor(e % 60);
 	return t > 0 ? `${t}:${String(n).padStart(2, "0")}:${String(r).padStart(2, "0")}` : `${n}:${String(r).padStart(2, "0")}`;
 }
 //#endregion
 //#region src/defaults.ts
-var _e = {
+var Z = {
 	play: "Play",
 	pause: "Pause",
 	replay: "Replay",
@@ -1943,4 +1942,4 @@ var _e = {
 	loop: "Loop"
 };
 //#endregion
-export { S as BaseMediaEngine, T as DashMediaEngine, t as EventBus, w as HlsMediaEngine, n as HotkeyRegistry, a as I18n, ee as LocalPlaybackProgressStore, C as NativeVideoEngine, x as STORAGE_KEYS, b as Storage, c as canUseFullscreen, o as canUseMSE, s as canUseNativeHLS, l as canUsePictureInPicture, u as canUseTextTracks, X as createGestureEngine, v as createMediaSessionController, ae as createMediaStore, ge as createPlayer, te as createResolvedMediaEngine, _e as defaultPlayerLabels, D as detectSourceKind, R as fetchSubtitles, re as fetchThumbnails, Z as formatTime, z as getActiveCue, H as getInitialMediaState, d as getMediaCapabilities, ie as getThumbnailAtTime, f as isFiniteDuration, F as parseSRT, L as parseSubtitles, B as parseThumbnailVTT, N as parseTimestamp, I as parseVTT, W as selectAudio, q as selectError, U as selectMedia, oe as selectPlugins, G as selectPreferences, se as selectThumbnails, K as selectUI, O as toPlayerSource };
+export { S as BaseMediaEngine, T as DashMediaEngine, t as EventBus, w as HlsMediaEngine, n as HotkeyRegistry, a as I18n, ee as LocalPlaybackProgressStore, C as NativeVideoEngine, x as STORAGE_KEYS, b as Storage, c as canUseFullscreen, o as canUseMSE, s as canUseNativeHLS, l as canUsePictureInPicture, u as canUseTextTracks, X as createGestureEngine, v as createMediaSessionController, ae as createMediaStore, Y as createPlayer, te as createResolvedMediaEngine, Z as defaultPlayerLabels, D as detectSourceKind, R as fetchSubtitles, re as fetchThumbnails, _e as formatTime, z as getActiveCue, H as getInitialMediaState, d as getMediaCapabilities, ie as getThumbnailAtTime, f as isFiniteDuration, F as parseSRT, L as parseSubtitles, B as parseThumbnailVTT, N as parseTimestamp, I as parseVTT, W as selectAudio, ce as selectError, U as selectMedia, oe as selectPlugins, G as selectPreferences, se as selectThumbnails, K as selectUI, O as toPlayerSource };

package/dist/media-session.d.ts

@@ -6,11 +6,11 @@
  * 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';
+import type { MediaRemote, MediaSessionMetadataOptions } from './types';
 type SessionPlaybackState = 'playing' | 'paused';
 export interface MediaSessionController {
     setup(remote: MediaRemote): void;
-    syncMetadata(title: string | undefined, poster: string | undefined): void;
+    syncMetadata(title: string | undefined, metadata?: MediaSessionMetadataOptions, poster?: string): void;
     setPlaybackState(state: SessionPlaybackState): void;
     syncPosition(duration: number, currentTime: number, playbackRate: number, force?: boolean): void;
     readonly hasMetadata: boolean;

package/dist/types.d.ts

@@ -12,6 +12,15 @@ import type { MediaState, PlaybackStatus, ResumeState } from './state/slices';
 import type { Storage } from './storage';
 import type { CaptionSettings, SubtitleProvider, SubtitleProviderResult, SubtitleSearchQuery, SubtitleTrack } from './subtitle-parser';
 export type { MediaState, ResumeState };
+/** OS media-control metadata overrides (Media Session → MPRIS). */
+export interface MediaSessionMetadataOptions {
+    /** Overrides the artwork sent to OS controls; falls back to `poster`. */
+    artwork?: string;
+    /** Artist line shown under the title (e.g. studio or channel name). */
+    artist?: string;
+    /** Album line; rarely meaningful for video, supported for completeness. */
+    album?: string;
+}
 export interface PlayerOptions {
     src: string;
     /** MIME/content type hint used by source provider selection. */
@@ -20,11 +29,11 @@ export interface PlayerOptions {
     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.
+     * OS media-control overrides (Media Session → MPRIS), e.g. a scaled-down
+     * artwork image when full-size posters are too big, or a studio name as
+     * the artist line. Artwork falls back to `poster` when omitted.
      */
-    mediaSessionArtwork?: string;
+    mediaSession?: MediaSessionMetadataOptions;
     subtitles?: SubtitleTrack[];
     subtitleProviders?: SubtitleProvider[];
     qualities?: string[];
@@ -202,7 +211,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' | 'mediaSessionArtwork' | 'autoPlay' | 'subtitles' | 'subtitleProviders' | 'qualities' | 'thumbnails' | 'transformThumbnailVTT' | 'playbackProgress'>>): void;
+    updateOptions(opts: Partial<Pick<PlayerOptions, 'src' | 'type' | 'title' | 'poster' | 'mediaSession' | '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.3.0",
+  "version": "0.4.0",
   "private": false,
   "repository": {
     "type": "git",