animot-presenter 0.5.14 → 0.5.15

package/dist/AnimotPresenter.svelte

@@ -191,6 +191,11 @@
 	// when `project.settings.narrationEnabled` is true. Lazy-allocated so
 	// decks without narration don't pay for it.
 	let narrationAudio: HTMLAudioElement | null = null;
+	// Set when the most recent play() was rejected by the browser autoplay
+	// policy. The first user gesture clears it and replays the current
+	// slide's clip — without this a single-slide deck would never play
+	// narration, since there's no navigation event to retry on.
+	let narrationPendingGesture = false;
 	function playNarrationForSlide(index: number) {
 		if (!project?.settings?.narrationEnabled) return;
 		const slide = project?.slides?.[index];
@@ -202,13 +207,22 @@
 		if (!src) return;
 		if (!narrationAudio) narrationAudio = new Audio();
 		narrationAudio.src = src;
-		// First play() may reject under autoplay policy; the player's first
-		// user gesture (pressing play / clicking the deck) unlocks the audio
-		// context and subsequent slides will work.
-		narrationAudio.play().catch(() => {});
+		// First play() may reject under autoplay policy. We track the
+		// rejection so a subsequent user gesture (handled below) retries
+		// once instead of silently giving up.
+		narrationAudio.play().then(
+			() => { narrationPendingGesture = false; },
+			() => { narrationPendingGesture = true; }
+		);
+	}
+	function tryUnlockNarrationOnGesture() {
+		if (narrationPendingGesture) {
+			playNarrationForSlide(currentSlideIndex);
+		}
 	}
 	function stopNarration() {
 		if (narrationAudio) { narrationAudio.pause(); narrationAudio = null; }
+		narrationPendingGesture = false;
 	}
 
 	const slides = $derived(project?.slides ?? []);
@@ -1158,7 +1172,24 @@
 		});
 		if (containerEl) resizeObserver.observe(containerEl);
 		resetMouseIdleTimer();
-		return () => { resizeObserver?.disconnect(); clearAutoplayTimer(); clearAllTypewriterAnimations(); if (mouseIdleTimer) clearTimeout(mouseIdleTimer); stopNarration(); };
+
+		// First-gesture retry for narration playback. Browsers block
+		// audio.play() until the user has interacted; without this hook
+		// a single-slide deck would never play its narration since there's
+		// no slide change to retry on. Attached on document so any click
+		// or key press in the page acts as the unlocking gesture.
+		document.addEventListener('pointerdown', tryUnlockNarrationOnGesture, { capture: true });
+		document.addEventListener('keydown', tryUnlockNarrationOnGesture, { capture: true });
+
+		return () => {
+			resizeObserver?.disconnect();
+			clearAutoplayTimer();
+			clearAllTypewriterAnimations();
+			if (mouseIdleTimer) clearTimeout(mouseIdleTimer);
+			stopNarration();
+			document.removeEventListener('pointerdown', tryUnlockNarrationOnGesture, { capture: true });
+			document.removeEventListener('keydown', tryUnlockNarrationOnGesture, { capture: true });
+		};
 	});
 
 	// Watch for prop changes