@banou/media-player 0.9.0 → 0.10.0

package/README.md

@@ -58,6 +58,13 @@ player.play()
 
 `useSeekThumbnails` and `usePictureInPicture` are exported for reuse outside the bundled chrome.
 
+`useSeekThumbnails` returns `{ thumbnails, requestThumbnail }`. Previews are generated from the start
+of the file to the end, which is right until somebody points at the seekbar: `requestThumbnail(time)`
+moves the preview covering `time` to the front of that queue, and the walk carries on behind it from
+wherever it had got to. Pass `undefined` when the pointer leaves. The bundled seekbar calls it for
+you, so this is only for a chrome you draw yourself. It cannot interrupt a decode already in flight,
+so the wait is the tail of that one rather than the whole backlog.
+
 `downloadedRanges` paints byte spans you already hold onto the seekbar, mapped through the keyframe
 index rather than by percentage, because a file's download progress is not its playback progress:
 containers carry headers, fonts and attachments that occupy no time at all.

package/dist/engine/index.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "../engine-DZrYu66u.js";
+import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, t as u, u as d } from "../engine-YeMWShCv.js";
 export { i as DEFAULT_BUFFER_SIZE, e as MediaElementError, a as SUBTITLES_OFF, u as createPictureInPicture, d as createSubtitleRenderer, c as createThumbnailGenerator, n as getTimeRanges, s as isMediaElementError, o as pictureInPictureMode, l as startPlayback, t as terminateRemuxer, r as updateSourceBuffer };

package/dist/engine/thumbnails.d.ts

@@ -17,6 +17,17 @@ export type ThumbnailGeneratorOptions = {
 export type ThumbnailGenerator = {
     /** Report which byte ranges are readable. Called with no argument when the whole file is. */
     update: (ranges?: [number, number][]) => void;
+    /**
+     * Where the viewer is pointing, so that preview is decoded next. `undefined` when they stop.
+     *
+     * Only the slot covering `time` jumps the queue, and only for as long as it is still waiting, so
+     * this moves one preview forward rather than re-ordering the run. Everything behind it keeps the
+     * order it was claimed in and carries on the moment the jumped slot is done.
+     *
+     * It cannot interrupt a decode that has already started, so the wait is the tail of the one in
+     * flight and not the whole backlog.
+     */
+    prioritize: (time: number | undefined) => void;
     destroy: () => void;
 };
 export declare const createThumbnailGenerator: (options: ThumbnailGeneratorOptions) => Promise<ThumbnailGenerator>;

package/dist/{engine-DZrYu66u.js → engine-YeMWShCv.js}

@@ -404,7 +404,14 @@ var i = (e) => Array(e.buffered.length).fill(void 0).map((t, n) => ({
 		}
 		for (let [e, t] of a.entries()) t.endTime = a[e + 1]?.timestamp ?? n;
 		a.length > 1 && a.at(-1).timestamp > n - r * 2 && a.pop();
-		let l = [], u = !1, d = Promise.resolve(), f = () => {
+		let l = [], u = !1, d = [], f = !1, p, m = () => {
+			let e = p;
+			if (e !== void 0) {
+				let t = d.findIndex(({ timestamp: t, endTime: n }) => t <= e && e < n);
+				if (t >= 0) return t;
+			}
+			return 0;
+		}, h = () => {
 			let e = [];
 			for (let [t, n] of l.entries()) {
 				n.startTime - (e.at(-1)?.endTime ?? 0) > .01 && e.push({
@@ -425,30 +432,39 @@ var i = (e) => Array(e.buffered.length).fill(void 0).map((t, n) => ({
 				startTime: t,
 				endTime: n
 			}), o(e);
-		}, p = (e) => {
-			e.done = !0, d = d.then(async () => {
-				if (u) return;
-				let t = await Promise.race([c.readKeyframe(e.timestamp), new Promise((e, t) => setTimeout(() => t(/* @__PURE__ */ Error("timed out")), M))]), n = await createImageBitmap(new Blob([t], { type: "image/png" })), r = new OffscreenCanvas(s, Math.max(1, Math.round(n.height * (s / n.width))));
-				r.getContext("2d").drawImage(n, 0, 0, r.width, r.height), n.close();
-				let i = await r.convertToBlob({
-					type: "image/webp",
-					quality: .7
-				});
-				u || (l = [...l, {
-					url: URL.createObjectURL(i),
-					startTime: e.timestamp,
-					endTime: e.endTime
-				}].sort((e, t) => e.startTime - t.startTime), f());
-			}).catch(() => {
+		}, g = async (e) => {
+			if (u) return;
+			let t = await Promise.race([c.readKeyframe(e.timestamp), new Promise((e, t) => setTimeout(() => t(/* @__PURE__ */ Error("timed out")), M))]), n = await createImageBitmap(new Blob([t], { type: "image/png" })), r = new OffscreenCanvas(s, Math.max(1, Math.round(n.height * (s / n.width))));
+			r.getContext("2d").drawImage(n, 0, 0, r.width, r.height), n.close();
+			let i = await r.convertToBlob({
+				type: "image/webp",
+				quality: .7
+			});
+			u || (l = [...l, {
+				url: URL.createObjectURL(i),
+				startTime: e.timestamp,
+				endTime: e.endTime
+			}].sort((e, t) => e.startTime - t.startTime), h());
+		}, _ = () => {
+			if (f || u || !d.length) return;
+			let e = d.splice(m(), 1)[0];
+			f = !0, g(e).catch(() => {
 				e.attempts += 1, e.done = e.attempts >= ae;
+			}).finally(() => {
+				f = !1, _();
 			});
+		}, v = (e) => {
+			e.done = !0, d.push(e), _();
 		};
-		return f(), {
+		return h(), {
 			update: (e) => {
-				if (!u) for (let t of a) t.done || (!e || e.some(([e, n]) => e <= t.startByte && t.endByte <= n)) && p(t);
+				if (!u) for (let t of a) t.done || (!e || e.some(([e, n]) => e <= t.startByte && t.endByte <= n)) && v(t);
+			},
+			prioritize: (e) => {
+				u || (p = e);
 			},
 			destroy: () => {
-				u = !0;
+				u = !0, d.length = 0;
 				for (let e of l) URL.revokeObjectURL(e.url);
 				l = [], A(c);
 			}