From 63a7cf60aa5efbe1df22c827037a70b4af9c9768 Mon Sep 17 00:00:00 2001
From: Intenzi <intenzisenpai@gmail.com>
Date: Mon, 27 Jul 2026 18:07:43 +0530
Subject: [PATCH 1/2] fix: add waveform-is-placeholder class on analysis
 failure

---
 src/js/core.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/js/core.js b/src/js/core.js
index 2877842..d015739 100644
--- a/src/js/core.js
+++ b/src/js/core.js
@@ -1150,6 +1150,7 @@ export class WaveformPlayer {
             this.setLoading(true);
             this.progress = 0;
             this.hasError = false;
+            this.container.classList.remove('waveform-is-placeholder');
 
             // In external mode we don't own an <audio> element — skip
             // src assignment + metadata-wait, but still generate the
@@ -1202,6 +1203,7 @@ export class WaveformPlayer {
                 } catch (error) {
                     console.warn('[WaveformPlayer] Using placeholder waveform:', error);
                     this.waveformData = generatePlaceholderWaveform(this.options.samples);
+                    this.container.classList.add('waveform-is-placeholder');
                 }
             }
 

From db0cf8234fd26e97dcc44e0c5284e7a12f1db737 Mon Sep 17 00:00:00 2001
From: Intenzi <intenzisenpai@gmail.com>
Date: Tue, 28 Jul 2026 15:12:19 +0530
Subject: [PATCH 2/2] test: add unit tests for waveform placeholder class
 behavior

---
 test/player.test.js | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/test/player.test.js b/test/player.test.js
index 0de0624..35b714a 100644
--- a/test/player.test.js
+++ b/test/player.test.js
@@ -1003,3 +1003,25 @@ describe('speed menu a11y (#11)', () => {
 		expect(btn.getAttribute('aria-expanded')).toBe('true');
 	});
 });
+
+describe('waveform analysis fallback', () => {
+	it('adds the waveform-is-placeholder class on analysis failure', async () => {
+		const { el, player } = track(mount());
+		await player.loadTrack('does-not-exist.mp3', null, null, { autoplay: false });
+		expect(el.classList.contains('waveform-is-placeholder')).toBe(true);
+	});
+
+	it('removes the waveform-is-placeholder class when a new load starts', async () => {
+		const { el, player } = track(mount());
+		await player.loadTrack('does-not-exist.mp3', null, null, { autoplay: false });
+		expect(el.classList.contains('waveform-is-placeholder')).toBe(true);
+
+		const loadPromise = player.loadTrack('next.mp3', 'Next', 'Artist', {
+			waveform: [0.1, 0.5, 0.9],
+			autoplay: false
+		});
+		expect(el.classList.contains('waveform-is-placeholder')).toBe(false);
+		await loadPromise;
+	});
+});
+