animot-presenter 0.5.13 → 0.5.14

package/dist/AnimotPresenter.svelte

@@ -187,6 +187,30 @@
 	let menuVisible = $state(true);
 	let mouseIdleTimer: ReturnType<typeof setTimeout> | null = null;
 
+	// Single <audio> element for per-slide narration playback. Only used
+	// when `project.settings.narrationEnabled` is true. Lazy-allocated so
+	// decks without narration don't pay for it.
+	let narrationAudio: HTMLAudioElement | null = null;
+	function playNarrationForSlide(index: number) {
+		if (!project?.settings?.narrationEnabled) return;
+		const slide = project?.slides?.[index];
+		if (narrationAudio) {
+			narrationAudio.pause();
+			narrationAudio.currentTime = 0;
+		}
+		const src = slide?.narration?.src;
+		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(() => {});
+	}
+	function stopNarration() {
+		if (narrationAudio) { narrationAudio.pause(); narrationAudio = null; }
+	}
+
 	const slides = $derived(project?.slides ?? []);
 	const currentSlide = $derived(slides[currentSlideIndex]);
 	const isCinemaMode = $derived(project?.mode === 'cinema');
@@ -547,6 +571,12 @@
 		const targetSlide = slides[targetIndex];
 		clearAllTypewriterAnimations();
 		cancelMotionPathLoops();
+		// Trigger per-slide narration. No-op when `narrationEnabled` is off
+		// or the slide has no narration clip. First call may be blocked by
+		// the browser's autoplay policy; the deck consumer should suppress
+		// `autoplay` when narration is on so the viewer's first nav-click
+		// (which gets us here) acts as the unlocking gesture.
+		playNarrationForSlide(targetIndex);
 		const transition = targetSlide.transition;
 		const duration = durationOverride ?? transition.duration;
 		transitionDurationMs = duration;
@@ -1106,6 +1136,11 @@
 			await loadCodeHighlights();
 			loading = false;
 			if (currentSlide) setTimeout(() => animateMotionPaths(currentSlide!), 300);
+			// First-slide narration. Browsers may block this until the
+			// viewer interacts; downstream code (e.g. share-link page)
+			// should already disable autoplay when narration is on so the
+			// click that starts the deck doubles as the audio unlock.
+			playNarrationForSlide(currentSlideIndex);
 			if (autoplay) isAutoplay = true;
 		} catch (e: any) { error = e.message; loading = false; }
 	}
@@ -1123,7 +1158,7 @@
 		});
 		if (containerEl) resizeObserver.observe(containerEl);
 		resetMouseIdleTimer();
-		return () => { resizeObserver?.disconnect(); clearAutoplayTimer(); clearAllTypewriterAnimations(); if (mouseIdleTimer) clearTimeout(mouseIdleTimer); };
+		return () => { resizeObserver?.disconnect(); clearAutoplayTimer(); clearAllTypewriterAnimations(); if (mouseIdleTimer) clearTimeout(mouseIdleTimer); stopNarration(); };
 	});
 
 	// Watch for prop changes