source: Klonkt/src/assets/js/audio-player.js@ 4c9c60b

main
Last change on this file since 4c9c60b was 834bcc3, checked in by Robin Genis <roboburr@…>, 3 months ago

i18n: translate Dutch code comments to English across src/

Comments in routes/services/views/config/middleware/assets translated to
English for the public repo. A few dev-facing throw/console message strings
were Englished too. No user-facing UI strings or i18n dictionary values changed
(src/services/i18n.js untouched). Logic unchanged.

Co-Authored-By: Claude <noreply@…>

  • Property mode set to 100644
File size: 40.6 KB
Line 
1/**
2 * Klonkt Audio Player — v9 mini-player + Spotify-style sheet.
3 *
4 * Two surfaces:
5 * 1. .audio-player — bottom strip: cover + meta + controls + progress + volume
6 * 2. .audio-sheet — full-height now-playing panel (slides up from bottom)
7 *
8 * Features:
9 * - Click cover/meta on mini-player → open sheet
10 * - Sheet handle (pill) or backdrop click → close
11 * - Touch swipe-down on the drag-zone → close (mobile only; desktop has the X)
12 * - Reads data-pcms-track-url + data-pcms-track + data-pcms-album from posts
13 * - body.has-audio-player adds bottom padding when player visible
14 * - body.audio-sheet-locked prevents body scroll when sheet open
15 * - Survives HTMX swaps + history-restores via event delegation on document.body
16 *
17 * Singleton — guards against double-init.
18 */
19(function() {
20 if (window.pcmsAudioPlayer) return;
21
22 const SVG = {
23 play: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M8 4l12 8-12 8z" fill="currentColor"/></svg>',
24 pause: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M7 4h4v16H7zM13 4h4v16h-4z" fill="currentColor"/></svg>',
25 prev: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M7 5v14M20 5l-11 7 11 7V5z" stroke="currentColor" stroke-width="1.8" fill="none" stroke-linecap="round" stroke-linejoin="round"/></svg>',
26 next: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M17 5v14M4 5l11 7-11 7V5z" stroke="currentColor" stroke-width="1.8" fill="none" stroke-linecap="round" stroke-linejoin="round"/></svg>',
27 vol: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 9v6h4l5 5V4L7 9H3zM16 8a5 5 0 010 8M19 5a9 9 0 010 14" stroke="currentColor" stroke-width="1.8" fill="none" stroke-linecap="round" stroke-linejoin="round"/></svg>',
28 mute: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M3 9v6h4l5 5V4L7 9H3zM17 9l5 5M22 9l-5 5" stroke="currentColor" stroke-width="1.8" fill="none" stroke-linecap="round" stroke-linejoin="round"/></svg>',
29 musicNote: '<svg viewBox="0 0 24 24" aria-hidden="true"><path d="M9 17V5l12-2v12" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/><circle cx="6" cy="17" r="3" fill="currentColor"/><circle cx="18" cy="15" r="3" fill="currentColor"/></svg>',
30 };
31
32 // ============================================================
33 // 1. Build DOM
34 // ============================================================
35 const root = document.createElement('aside');
36 root.id = 'pcms-audio-player';
37 root.className = 'audio-player';
38 root.setAttribute('aria-label', 'Audio speler');
39 root.innerHTML = `
40 <div class="audio-player-inner">
41 <button type="button" class="audio-player-expand-trigger" id="audio-expand-trigger" aria-label="Vergroot speler">
42 <div class="audio-player-cover" id="audio-cover" aria-hidden="true">${SVG.musicNote}</div>
43 <div class="audio-player-meta">
44 <div class="audio-player-title-wrap"><span class="audio-player-title" id="audio-title">No track</span></div>
45 <div class="audio-player-artist" id="audio-artist"></div>
46 </div>
47 </button>
48 <div class="audio-player-controls">
49 <button type="button" class="audio-btn" id="audio-prev" aria-label="Vorige" title="Vorige">${SVG.prev}</button>
50 <button type="button" class="audio-btn audio-btn-play" id="audio-play" aria-label="Afspelen">
51 <span class="icon-play">${SVG.play}</span><span class="icon-pause">${SVG.pause}</span>
52 </button>
53 <button type="button" class="audio-btn" id="audio-next" aria-label="Volgende" title="Volgende">${SVG.next}</button>
54 </div>
55 <div class="audio-player-progress">
56 <span class="audio-time mono" id="audio-current">0:00</span>
57 <div class="audio-seek" id="audio-seek" role="slider" aria-label="Voortgang" tabindex="0">
58 <div class="audio-seek-bar"><div class="audio-seek-fill" id="audio-seek-fill"></div></div>
59 </div>
60 <span class="audio-time mono" id="audio-total">0:00</span>
61 </div>
62 <div class="audio-player-volume">
63 <button type="button" class="audio-btn" id="audio-mute" aria-label="Mute">
64 <span class="icon-vol">${SVG.vol}</span><span class="icon-mute">${SVG.mute}</span>
65 </button>
66 <div class="audio-volume-popup">
67 <input type="range" id="audio-volume" min="0" max="100" value="80" aria-label="Volume">
68 </div>
69 </div>
70 </div>
71 <audio id="audio-element" preload="none" playsinline webkit-playsinline controlsList="nodownload"></audio>
72
73 <div class="audio-sheet" id="audio-sheet" aria-hidden="true">
74 <div class="audio-sheet-backdrop" id="audio-sheet-backdrop"></div>
75 <div class="audio-sheet-panel" role="dialog" aria-label="Now playing">
76 <div class="audio-sheet-drag-zone" id="audio-sheet-drag-zone">
77 <button type="button" class="audio-sheet-handle" id="audio-sheet-close" aria-label="Speler verkleinen"></button>
78 <div class="audio-sheet-cover" id="audio-sheet-cover" aria-hidden="true">${SVG.musicNote}</div>
79 </div>
80 <div class="audio-sheet-info">
81 <div class="audio-sheet-title" id="audio-sheet-title">—</div>
82 <div class="audio-sheet-artist" id="audio-sheet-artist"></div>
83 <div class="audio-sheet-album" id="audio-sheet-album"></div>
84 </div>
85 <div class="audio-sheet-progress">
86 <span class="audio-time mono" id="audio-sheet-current">0:00</span>
87 <div class="audio-seek" id="audio-sheet-seek" role="slider" aria-label="Voortgang" tabindex="0">
88 <div class="audio-seek-bar"><div class="audio-seek-fill" id="audio-sheet-seek-fill"></div></div>
89 </div>
90 <span class="audio-time mono" id="audio-sheet-total">0:00</span>
91 </div>
92 <div class="audio-sheet-controls">
93 <button type="button" class="audio-btn audio-sheet-btn" id="audio-sheet-prev" aria-label="Vorige">${SVG.prev}</button>
94 <button type="button" class="audio-btn audio-sheet-play" id="audio-sheet-play" aria-label="Afspelen">
95 <span class="icon-play">${SVG.play}</span><span class="icon-pause">${SVG.pause}</span>
96 </button>
97 <button type="button" class="audio-btn audio-sheet-btn" id="audio-sheet-next" aria-label="Volgende">${SVG.next}</button>
98 </div>
99 <div class="audio-sheet-queue" id="audio-sheet-queue" hidden>
100 <div class="audio-sheet-queue-label">Queue</div>
101 <ol class="audio-sheet-queue-list" id="audio-sheet-queue-list"></ol>
102 </div>
103 </div>
104 </div>
105 `;
106 document.body.appendChild(root);
107
108 // FIX: Move .audio-sheet out of the .audio-player root so its
109 // position:fixed is anchored to the viewport, not to the mini-bar.
110 // The mini-bar has backdrop-filter, which makes it a containing
111 // block for fixed descendants — that broke the sheet's left/right/top/bottom.
112 const _detachedSheet = root.querySelector('.audio-sheet');
113 if (_detachedSheet) document.body.appendChild(_detachedSheet);
114
115 // ============================================================
116 // 2. Element references
117 // ============================================================
118 const $ = (id) => document.getElementById(id);
119 const audio = $('audio-element');
120 const cover = $('audio-cover');
121 const titleEl = $('audio-title');
122 const artistEl = $('audio-artist');
123 const seek = $('audio-seek');
124 const seekFill = $('audio-seek-fill');
125 const currentEl = $('audio-current');
126 const totalEl = $('audio-total');
127 const playBtn = $('audio-play');
128 const prevBtn = $('audio-prev');
129 const nextBtn = $('audio-next');
130 const muteBtn = $('audio-mute');
131 const volumeSlider = $('audio-volume');
132 const expandTrigger = $('audio-expand-trigger');
133
134 const sheet = $('audio-sheet');
135 const sheetBackdrop = $('audio-sheet-backdrop');
136 const sheetPanel = sheet.querySelector('.audio-sheet-panel');
137 const sheetClose = $('audio-sheet-close');
138 const sheetCover = $('audio-sheet-cover');
139 const sheetTitle = $('audio-sheet-title');
140 const sheetArtist = $('audio-sheet-artist');
141 const sheetAlbum = $('audio-sheet-album');
142 const sheetSeek = $('audio-sheet-seek');
143 const sheetSeekFill = $('audio-sheet-seek-fill');
144 const sheetCurrent = $('audio-sheet-current');
145 const sheetTotal = $('audio-sheet-total');
146 const sheetPlay = $('audio-sheet-play');
147 const sheetPrev = $('audio-sheet-prev');
148 const sheetNext = $('audio-sheet-next');
149 const sheetQueue = $('audio-sheet-queue');
150 const sheetQueueList = $('audio-sheet-queue-list');
151 const dragZone = $('audio-sheet-drag-zone');
152
153 // ============================================================
154 // 3. State
155 // ============================================================
156 let queue = [];
157 let currentIndex = 0;
158 let isPlaying = false;
159 let albumName = '';
160 // Blob playback state. We fetch each track's bytes and play from a blob:
161 // object URL — no plain media URL is ever exposed to the page. currentObjectUrl
162 // is revoked when we move on, so we don't leak one Blob per track in memory.
163 let currentObjectUrl = null;
164 // Monotonic load token: a fast prev/next can fire several loads before an
165 // earlier fetch resolves. Only the latest load may set audio.src.
166 let loadSeq = 0;
167 // Next-track prefetch. While the current track plays we download the *next*
168 // track's bytes into a held blob, so `ended` → next() can swap src instantly
169 // (no silent gap, and no long async window where the browser's autoplay
170 // activation can lapse and reject play()). At most one track ahead is held.
171 // Shape: { url, objUrl } — objUrl is null while the fetch is still in flight.
172 let preload = null;
173
174 // Hide initially
175 root.classList.add('audio-player-hidden');
176
177 // ============================================================
178 // 4. Track / queue loading
179 // ============================================================
180 function setCoverImage(el, url) {
181 if (url) {
182 el.style.backgroundImage = `url("${url}")`;
183 el.classList.add('has-image');
184 el.innerHTML = '';
185 } else {
186 el.style.backgroundImage = '';
187 el.classList.remove('has-image');
188 el.innerHTML = SVG.musicNote;
189 }
190 }
191
192 // Fetch the track bytes and hand back a blob: object URL. The X-Audio-Player
193 // header + same-origin credentials get us past the stream route's access gate.
194 // Retries a few times with backoff: a single transient network blip used to
195 // bump the error counter and SKIP the song (auto-advance past it). Now one
196 // hiccup just costs a retry, and we only give up after genuinely failing.
197 async function fetchAsObjectUrl(url, attempts) {
198 attempts = attempts || 1;
199 let lastErr;
200 for (let i = 0; i < attempts; i++) {
201 try {
202 const r = await fetch(url, {
203 credentials: 'same-origin',
204 headers: { 'X-Audio-Player': '1' },
205 });
206 if (!r.ok) throw new Error('HTTP ' + r.status);
207 const blob = await r.blob();
208 return URL.createObjectURL(blob);
209 } catch (e) {
210 lastErr = e;
211 if (i < attempts - 1) {
212 await new Promise((res) => setTimeout(res, 350 * (i + 1)));
213 }
214 }
215 }
216 throw lastErr;
217 }
218
219 // Apply a ready blob URL to the <audio> element. Single source of truth for
220 // "swap the playing source": used by both the cached-preload path and the
221 // fresh-fetch path so there's one place that touches audio.src.
222 function applyBlob(objUrl, autoplay, mySeq) {
223 if (mySeq !== loadSeq) { try { URL.revokeObjectURL(objUrl); } catch (e) {} return; } // superseded
224 root.classList.remove('audio-loading');
225 // Free the previously-playing track's blob — otherwise each track leaks a
226 // copy. Never the same handle as objUrl (createObjectURL is unique), so this
227 // can't revoke the source we're about to play.
228 if (currentObjectUrl && currentObjectUrl !== objUrl) {
229 try { URL.revokeObjectURL(currentObjectUrl); } catch (e) {}
230 }
231 currentObjectUrl = objUrl;
232 // Clean transition: pause + load forces a reset of internal state after
233 // multiple src changes (prevents state corruption of the audio element).
234 try { audio.pause(); } catch (e) {}
235 audio.src = objUrl;
236 try { audio.load(); } catch (e) {}
237 if (autoplay) play();
238 }
239
240 function onLoadError(err, mySeq) {
241 if (mySeq !== loadSeq) return; // superseded — ignore stale failure
242 root.classList.remove('audio-loading');
243 console.error('[pcms-audio] track load failed after retries', err);
244 // Genuine failure (after retries): bump the counter and auto-skip, but stop
245 // after 3 in a row so a fully-broken queue can't loop "next" forever.
246 consecutiveErrors++;
247 if (consecutiveErrors < 3 && queue.length > 1) setTimeout(next, 400);
248 }
249
250 // Discard any held/in-flight preload and free its blob if resolved.
251 function dropPreload() {
252 if (preload && preload.objUrl) { try { URL.revokeObjectURL(preload.objUrl); } catch (e) {} }
253 preload = null;
254 }
255
256 // Prefetch the *next* track's bytes in the background. Idempotent: re-calling
257 // while the same track is already cached / in flight is a no-op. Called from
258 // the `playing` event so the network is otherwise idle.
259 function preloadNext() {
260 if (queue.length < 2) return;
261 const ni = (currentIndex + 1) % queue.length;
262 const t = queue[ni];
263 if (!t || !t.url) return;
264 if (preload && preload.url === t.url) return; // already held or in flight
265 dropPreload(); // different track queued before → free it
266 const marker = { url: t.url, objUrl: null };
267 preload = marker;
268 fetchAsObjectUrl(t.url, 2).then((obj) => {
269 // Only keep it if this is still the track we want next; otherwise free it.
270 if (preload === marker) { marker.objUrl = obj; }
271 else { try { URL.revokeObjectURL(obj); } catch (e) {} }
272 }).catch(() => { if (preload === marker) preload = null; });
273 }
274
275 // metaOnly: show the track in the UI but DON'T download its bytes yet.
276 // Used by the site pre-seed so opening a page doesn't auto-download audio;
277 // the blob is fetched lazily on the first play().
278 // Persistently mark the current track (stays highlighted as long as it's active).
279 function markPlaying(trackId) {
280 document.querySelectorAll('.pat-playing').forEach((e) => e.classList.remove('pat-playing'));
281 if (!trackId) return;
282 const el = document.getElementById('track-' + trackId);
283 if (el) el.classList.add('pat-playing');
284 }
285 // After an htmx navigation the post DOM is replaced → reapply the highlight.
286 document.body.addEventListener('htmx:afterSettle', () => {
287 const t = queue[currentIndex];
288 if (t) markPlaying(t.id);
289 });
290
291 function loadTrack(index, autoplay, metaOnly) {
292 if (!queue[index]) {
293 console.warn('[pcms-audio] loadTrack: no track at index', index);
294 return;
295 }
296 currentIndex = index;
297 const t = queue[index];
298 if (!t.url) {
299 console.error('[pcms-audio] track has no url', t);
300 return;
301 }
302 console.log('[pcms-audio] loading', t.title, t.url, metaOnly ? '(meta only)' : '');
303 // Metadata + chrome update synchronously so the UI reacts instantly while
304 // the bytes download.
305 titleEl.textContent = t.title || 'Untitled';
306 artistEl.textContent = t.artist || '';
307 sheetTitle.textContent = t.title || 'Untitled';
308 sheetArtist.textContent = t.artist || '';
309 sheetAlbum.textContent = albumName || '';
310 setCoverImage(cover, t.cover);
311 setCoverImage(sheetCover, t.cover);
312 root.classList.remove('audio-player-hidden');
313 document.body.classList.add('has-audio-player');
314 renderQueue();
315 markPlaying(t.id);
316
317 if (metaOnly) return;
318
319 const mySeq = ++loadSeq;
320
321 // Fast path: the bytes for this exact track were already prefetched while
322 // the previous track played → swap in instantly, no gap, no fetch window.
323 if (preload && preload.url === t.url && preload.objUrl) {
324 const obj = preload.objUrl;
325 preload = null; // ownership moves to applyBlob (becomes currentObjectUrl)
326 applyBlob(obj, autoplay, mySeq);
327 return;
328 }
329
330 // Not preloaded (or preload still in flight) → drop any stale preload and
331 // fetch fresh, retrying transient failures before giving up.
332 dropPreload();
333 root.classList.add('audio-loading');
334 fetchAsObjectUrl(t.url, 3)
335 .then((objUrl) => applyBlob(objUrl, autoplay, mySeq))
336 .catch((err) => onLoadError(err, mySeq));
337 }
338
339 // True when the viewport is in the mobile sheet-layout — matches the CSS
340 // breakpoint where .audio-sheet slides up full-width from the bottom
341 // (@media max-width:719.98px). On wider/desktop widths the sheet is a centered
342 // panel, so we do NOT auto-open it there.
343 // Three layouts (Robin 2026-06-15): phone (<768) = fullscreen sheet;
344 // tablet/car (768–1199) = large landscape full-player (tablet + car-mode);
345 // desktop (≥1200) = mini-player only, NO full player. matchMedia so this
346 // exactly follows the CSS breakpoints.
347 function playerTier() {
348 if (window.matchMedia('(min-width: 1200px)').matches) return 'desktop';
349 if (window.matchMedia('(min-width: 768px)').matches) return 'tablet';
350 return 'phone';
351 }
352 function hasFullPlayer() { return playerTier() !== 'desktop'; }
353 function isMobileView() { return playerTier() === 'phone'; }
354
355 function setQueue(tracks, startIdx, opts) {
356 queue = Array.isArray(tracks) ? tracks.slice() : [];
357 albumName = (opts && opts.albumName) || '';
358 if (!queue.length) return;
359 loadTrack(typeof startIdx === 'number' ? Math.max(0, Math.min(startIdx, queue.length - 1)) : 0, true);
360 // Mobile: a track press from an album/playlist auto-opens the full
361 // now-playing sheet (Spotify-style) instead of just the thin mini-strip.
362 // Only here (setQueue = a fresh, user-initiated queue) —
363 // not on next/prev or the site pre-seed — so a sheet the user
364 // deliberately closed doesn't reappear by itself.
365 if (hasFullPlayer()) openSheet();
366 }
367
368 function play() {
369 if (!audio.src) {
370 // Nothing fetched yet (pre-seed showed metadata only, or a load is still
371 // in flight). Kick off the blob load for the current track and autoplay.
372 if (queue[currentIndex]) loadTrack(currentIndex, true);
373 return;
374 }
375 const p = audio.play();
376 if (p && typeof p.catch === 'function') {
377 p.catch((err) => {
378 console.warn('[pcms-audio] play() rejected:', err.name, err.message);
379 // Browser autoplay policy blocked it (typically after 3-4
380 // auto-plays on iOS Safari, or when the tab was temporarily inactive).
381 // Show a visual hint for the user to tap play.
382 if (err && err.name === 'NotAllowedError') {
383 root.classList.add('audio-needs-tap');
384 isPlaying = false;
385 root.classList.remove('is-playing');
386 }
387 });
388 }
389 }
390 function pause() { audio.pause(); }
391 function togglePlay() { audio.paused ? play() : pause(); }
392 function next() {
393 if (!queue.length) return;
394 loadTrack((currentIndex + 1) % queue.length, true);
395 }
396 function prev() {
397 if (!queue.length) return;
398 loadTrack(currentIndex === 0 ? queue.length - 1 : currentIndex - 1, true);
399 }
400 function close() {
401 pause();
402 mediaRegistry().release(registrySelf);
403 root.classList.add('audio-player-hidden');
404 document.body.classList.remove('has-audio-player');
405 closeSheet();
406 queue = [];
407 albumName = '';
408 loadSeq++; // cancel any in-flight load
409 dropPreload(); // free any prefetched next-track blob
410 if (currentObjectUrl) { try { URL.revokeObjectURL(currentObjectUrl); } catch (e) {} }
411 currentObjectUrl = null;
412 try { audio.removeAttribute('src'); audio.load(); } catch (e) {}
413 }
414
415 function renderQueue() {
416 if (!queue.length) { sheetQueue.hidden = true; return; }
417 sheetQueueList.innerHTML = '';
418 queue.forEach((t, i) => {
419 const li = document.createElement('li');
420 li.className = 'audio-sheet-queue-item' + (i === currentIndex ? ' is-current' : '');
421 li.dataset.idx = String(i);
422 li.innerHTML = `<span class="aqi-num">${i + 1}.</span> <span class="aqi-title">${escapeHtml(t.title || 'Untitled')}</span>`
423 + (t.artist ? `<span class="aqi-artist">${escapeHtml(t.artist)}</span>` : '');
424 sheetQueueList.appendChild(li);
425 });
426 sheetQueueList.querySelectorAll('.audio-sheet-queue-item').forEach((li) => {
427 li.addEventListener('click', () => {
428 const idx = parseInt(li.dataset.idx, 10);
429 if (!isNaN(idx) && idx !== currentIndex) {
430 loadTrack(idx, true);
431 }
432 });
433 });
434 sheetQueue.hidden = queue.length < 2;
435 }
436
437 function escapeHtml(s) {
438 return String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;');
439 }
440
441 // ============================================================
442 // 4b. Mutual exclusion — shared media registry (see embed-player.js).
443 // ============================================================
444 // All players (this site player + YouTube/SoundCloud/Spotify embeds)
445 // register themselves in window.pcmsMediaRegistry. Starting one pauses
446 // the previous. This is the precise replacement for the old focus/blur
447 // heuristic for embeds with a real JS API. (The blur fallback below stays
448 // for iframe-only embeds without an API: Bandcamp/Apple Music/Vimeo.)
449 function mediaRegistry() {
450 if (window.pcmsMediaRegistry) return window.pcmsMediaRegistry;
451 const r = {
452 _active: null,
453 setActive(player) {
454 if (this._active && this._active !== player && this._active.pause) {
455 try { this._active.pause(); } catch (e) {}
456 }
457 this._active = player;
458 },
459 release(player) { if (this._active === player) this._active = null; },
460 };
461 window.pcmsMediaRegistry = r;
462 return r;
463 }
464 const registrySelf = { pause() { try { audio.pause(); } catch (e) {} } };
465
466 // ============================================================
467 // 5. Audio element events → UI sync
468 // ============================================================
469 // Error counter prevents an infinite loop when ALL tracks are broken.
470 let consecutiveErrors = 0;
471
472 audio.addEventListener('play', () => {
473 isPlaying = true;
474 root.classList.add('is-playing');
475 root.classList.remove('audio-needs-tap'); // hide tap hint
476 mediaRegistry().setActive(registrySelf); // pause any currently playing embeds
477 });
478 // Reset the error counter only on a REAL playback start (`playing`), not the
479 // eager `play` event. `play` fires before any network/decode error, so resetting
480 // there would prevent the 3-strikes stop from ever triggering on a broken
481 // track → infinite "next" loop. `playing` only fires when audio is actually playing.
482 audio.addEventListener('playing', () => { consecutiveErrors = 0; preloadNext(); });
483 audio.addEventListener('pause', () => { isPlaying = false; root.classList.remove('is-playing'); });
484 audio.addEventListener('ended', next);
485 audio.addEventListener('error', (e) => {
486 const code = audio.error ? audio.error.code : '?';
487 console.error('[pcms-audio] playback error', code, audio.src, e);
488 consecutiveErrors++;
489 // On network/decode error: skip to next track instead of stalling.
490 // Max 3 consecutive errors before giving up (otherwise infinite loop).
491 if (consecutiveErrors < 3 && queue.length > 1) {
492 console.warn('[pcms-audio] auto-skip to next after error', consecutiveErrors);
493 setTimeout(next, 400);
494 }
495 });
496 audio.addEventListener('stalled', () => console.warn('[pcms-audio] stalled at', audio.currentTime));
497 audio.addEventListener('volumechange', () => { root.classList.toggle('is-muted', audio.muted || audio.volume === 0); });
498 audio.addEventListener('timeupdate', () => {
499 if (!audio.duration || isNaN(audio.duration)) return;
500 const pct = (audio.currentTime / audio.duration) * 100;
501 seekFill.style.width = pct + '%';
502 sheetSeekFill.style.width = pct + '%';
503 currentEl.textContent = formatTime(audio.currentTime);
504 totalEl.textContent = formatTime(audio.duration);
505 sheetCurrent.textContent = formatTime(audio.currentTime);
506 sheetTotal.textContent = formatTime(audio.duration);
507 });
508
509 function formatTime(s) {
510 if (!s || isNaN(s)) return '0:00';
511 const m = Math.floor(s / 60), sec = Math.floor(s % 60);
512 return m + ':' + (sec < 10 ? '0' : '') + sec;
513 }
514
515 function attachSeek(seekEl) {
516 seekEl.addEventListener('click', (e) => {
517 if (!audio.duration) return;
518 const rect = seekEl.getBoundingClientRect();
519 const ratio = Math.max(0, Math.min(1, (e.clientX - rect.left) / rect.width));
520 audio.currentTime = ratio * audio.duration;
521 });
522 }
523 attachSeek(seek);
524 attachSeek(sheetSeek);
525
526 audio.volume = 0.8;
527 volumeSlider.addEventListener('input', () => {
528 audio.volume = volumeSlider.value / 100;
529 if (volumeSlider.value > 0) audio.muted = false;
530 });
531 muteBtn.addEventListener('click', () => { audio.muted = !audio.muted; });
532
533 // ============================================================
534 // 6. Control wiring
535 // ============================================================
536 playBtn.addEventListener('click', togglePlay);
537 prevBtn.addEventListener('click', prev);
538 nextBtn.addEventListener('click', next);
539 sheetPlay.addEventListener('click', togglePlay);
540 sheetPrev.addEventListener('click', prev);
541 sheetNext.addEventListener('click', next);
542
543 // ============================================================
544 // 7. Sheet expand/close + drag-down-to-close
545 // ============================================================
546 // Back button closes the sheet on mobile: on open we push a history entry
547 // so the phone back button (popstate) closes the sheet first instead of
548 // leaving the page. We balance it on a UI-initiated close via history.back().
549 let sheetHistoryPushed = false;
550
551 function openSheet() {
552 if (!hasFullPlayer()) return; // desktop (≥1200): no full player, mini-player only
553 if (sheet.classList.contains('is-open')) return;
554 sheet.classList.add('is-open');
555 sheet.setAttribute('aria-hidden', 'false');
556 document.body.classList.add('audio-sheet-locked');
557 // Phone + tablet: push a history entry so the back button closes the sheet first.
558 try { history.pushState({ pcmsSheet: true }, ''); sheetHistoryPushed = true; } catch (e) {}
559 }
560 function closeSheet(fromPopstate) {
561 if (!sheet.classList.contains('is-open')) return;
562 sheet.classList.remove('is-open');
563 sheet.setAttribute('aria-hidden', 'true');
564 document.body.classList.remove('audio-sheet-locked');
565 sheetPanel.style.removeProperty('--pcms-drag-y');
566 sheetBackdrop.style.removeProperty('--pcms-sheet-progress');
567 // UI close (X / swipe / backdrop / Esc): pop our own history entry so the
568 // next back button navigates normally. On a popstate close (back button itself)
569 // the entry is already popped.
570 const wasPushed = sheetHistoryPushed;
571 sheetHistoryPushed = false;
572 if (wasPushed && !fromPopstate) { try { history.back(); } catch (e) {} }
573 }
574 window.addEventListener('popstate', () => {
575 if (sheet.classList.contains('is-open')) closeSheet(true);
576 });
577 // Clicking the mini-player track info:
578 // - DESKTOP (≥1200px): jump to the post the track came from (if known),
579 // via htmx so audio keeps playing. No post known → fall back to the sheet.
580 // - MOBILE/TABLET: always open the full now-playing sheet.
581 function scrollToTrack(trackId) {
582 if (!trackId) { window.scrollTo(0, 0); return; }
583 const el = document.getElementById('track-' + trackId);
584 if (!el) { window.scrollTo(0, 0); return; }
585 el.scrollIntoView({ block: 'center', behavior: 'smooth' });
586 el.classList.add('pat-flash');
587 setTimeout(() => el.classList.remove('pat-flash'), 1600);
588 }
589 function goToPost(url, trackId) {
590 const hash = trackId ? ('#track-' + trackId) : '';
591 if (window.htmx && url.charAt(0) === '/') {
592 try {
593 const p = window.htmx.ajax('GET', url, { target: '#pcms-main', swap: 'innerHTML' });
594 history.pushState({}, '', url + hash);
595 // Scroll to the track after the swap (small delay so the global
596 // afterSwap scroll-to-top runs first); fall back to top if not found.
597 const go = () => setTimeout(() => scrollToTrack(trackId), 60);
598 if (p && typeof p.then === 'function') p.then(go); else setTimeout(go, 150);
599 return;
600 } catch (e) { /* fall back to full navigation */ }
601 }
602 location.href = url + hash;
603 }
604 expandTrigger.addEventListener('click', () => {
605 const t = queue[currentIndex];
606 // Only on true desktop (≥1200, no full-player) do we jump to the post.
607 // Tablet + phone have a full-player → open it (same as mobile behaviour).
608 const jumpToPost = !hasFullPlayer();
609 if (jumpToPost && t) {
610 // 1) Track played from a post → we already know that URL.
611 if (t.postUrl) { goToPost(t.postUrl, t.id); return; }
612 // 2) Site-wide track (no postUrl) → look up the post via the track id.
613 if (t.id) {
614 fetch('/audio/track/' + encodeURIComponent(t.id) + '/post')
615 .then((r) => (r.ok ? r.json() : null))
616 .then((d) => { if (d && d.url) goToPost(d.url, t.id); else openSheet(); })
617 .catch(() => openSheet());
618 return;
619 }
620 }
621 openSheet();
622 });
623 sheetClose.addEventListener('click', () => closeSheet());
624 sheetBackdrop.addEventListener('click', () => closeSheet());
625 document.addEventListener('keydown', (e) => {
626 if (e.key === 'Escape' && sheet.classList.contains('is-open')) closeSheet();
627 });
628 // Resized to desktop width (≥1200) while the full player is open? Close it —
629 // the full player doesn't exist on desktop.
630 window.addEventListener('resize', () => {
631 if (!hasFullPlayer() && sheet.classList.contains('is-open')) closeSheet();
632 });
633
634 // Fallback for mutual exclusion. For YouTube/SoundCloud/Spotify embeds the
635 // registry already handles this precisely (real play events). But for
636 // iframe-only embeds WITHOUT a JS API (Bandcamp/Apple/Vimeo) and for the
637 // iframe FALLBACK (when an ad-blocker blocks the player API) there is no
638 // play event: we catch those via focus. User clicks such an iframe →
639 // window 'blur' → pause our player. (For API embeds this is at worst a
640 // harmless double-pause.)
641 window.addEventListener('blur', () => {
642 setTimeout(() => {
643 const el = document.activeElement;
644 // Only embed iframes (inside .folio-embed) pause the player — not a
645 // random iframe (captcha/ad/map) that happens to receive focus.
646 if (el && el.tagName === 'IFRAME' && el.closest('.folio-embed') && audio.src && !audio.paused) {
647 pause();
648 }
649 }, 0);
650 });
651
652 // Drag-down-to-close on touch devices.
653 //
654 // We set --pcms-drag-y as a CSS custom prop instead of writing
655 // sheetPanel.style.transform directly. The reason: on desktop the panel
656 // uses `transform: translate(-50%, 0)` for horizontal centering. Writing
657 // `style.transform = translateY(...)` would obliterate the -50% and the
658 // panel would jump rightward. With a custom prop, audio.css composes the
659 // final transform per breakpoint:
660 // mobile: transform: translateY(var(--pcms-drag-y, 0))
661 // desktop: transform: translate(-50%, var(--pcms-drag-y, 0))
662 let dragStartY = 0, dragLastY = 0, isDragging = false;
663 function onPointerDown(e) {
664 if (e.pointerType !== 'touch') return;
665 if (sheetPanel.scrollTop > 0) return; // queue is scrolled, don't drag
666 dragStartY = dragLastY = e.clientY;
667 isDragging = true;
668 sheetPanel.classList.add('is-dragging');
669 sheetBackdrop.classList.add('is-dragging');
670 }
671 function onPointerMove(e) {
672 if (!isDragging) return;
673 dragLastY = e.clientY;
674 const dy = Math.max(0, dragLastY - dragStartY);
675 sheetPanel.style.setProperty('--pcms-drag-y', dy + 'px');
676 const progress = Math.max(0, 1 - dy / sheetPanel.offsetHeight);
677 sheetBackdrop.style.setProperty('--pcms-sheet-progress', String(progress));
678 }
679 function onPointerUp() {
680 if (!isDragging) return;
681 isDragging = false;
682 sheetPanel.classList.remove('is-dragging');
683 sheetBackdrop.classList.remove('is-dragging');
684 const dy = dragLastY - dragStartY;
685 if (dy > 100) {
686 closeSheet();
687 } else {
688 sheetPanel.style.removeProperty('--pcms-drag-y');
689 sheetBackdrop.style.removeProperty('--pcms-sheet-progress');
690 }
691 }
692 if (window.PointerEvent) {
693 dragZone.addEventListener('pointerdown', onPointerDown);
694 document.addEventListener('pointermove', onPointerMove);
695 document.addEventListener('pointerup', onPointerUp);
696 document.addEventListener('pointercancel', onPointerUp);
697 }
698
699 // ============================================================
700 // 8. Hook up post-audio-track + post-album-cover-btn + .pat-row + .post-album-playall
701 // ============================================================
702 // Four entry points fire the same play action:
703 // - .pat-play → single-track widget in a post
704 // - .pat-row → track row inside an album/playlist tracklist
705 // - .post-album-cover-btn → big cover button (plays album from track 0)
706 // - .post-album-playall → "Speel album" / "Speel playlist" button
707 //
708 // For .pat-play the metadata lives on the surrounding .post-audio-track
709 // wrapper. For the other three the data is on the button itself. The
710 // handler reads from button-first, falls back to wrapper.
711 // Event delegation on document.body instead of per-button listeners. This
712 // survives HTMX history-restores: the mobile back button (popstate) lets HTMX
713 // restore #pcms-main from its snapshot; a per-element `data-pcms-attached` flag
714 // would leave dead buttons (flag baked into the snapshot, listener gone). One
715 // delegated listener works regardless of how many times the DOM is (re)swapped.
716 const PLAY_SELECTOR =
717 '.post-audio-track .pat-play, .post-album-tracks .pat-row, .post-album-cover-btn, .post-album-playall';
718 document.body.addEventListener('click', (e) => {
719 const btn = e.target.closest(PLAY_SELECTOR);
720 if (!btn) return;
721 e.preventDefault();
722 e.stopPropagation();
723 // The post you're playing FROM = the current page (embeds live in post content).
724 // Store it on the track(s) so the desktop mini-player can jump back to it —
725 // survives the sessionStorage resume as well.
726 const postUrl = location.pathname + location.search;
727 // Resolve metadata: button-first, then closest .post-audio-track wrapper
728 // (only inline single-track widgets put the data on the wrapper).
729 const wrapper = btn.closest('.post-audio-track');
730 const albumId = btn.dataset.pcmsAlbumId || (wrapper && wrapper.dataset.pcmsAlbumId);
731 const trackData = btn.dataset.pcmsTrack || (wrapper && wrapper.dataset.pcmsTrack);
732 const trackUrl = btn.dataset.pcmsTrackUrl || (wrapper && wrapper.dataset.pcmsTrackUrl);
733 console.log('[pcms-audio] click', { btn: btn.className, albumId, trackUrl, hasTrackData: !!trackData });
734
735 if (albumId) {
736 const album = document.getElementById(albumId);
737 if (!album) { console.error('[pcms-audio] album not found:', albumId); return; }
738 try {
739 const tracks = JSON.parse(album.dataset.pcmsAlbum);
740 tracks.forEach((t) => { t.postUrl = postUrl; });
741 // Start at the clicked track if we know its URL, else start at 0
742 // (cover-btn and playall both want to start from the beginning).
743 const startIdx = trackUrl ? tracks.findIndex(t => t.url === trackUrl) : 0;
744 setQueue(tracks, startIdx >= 0 ? startIdx : 0, { albumName: album.dataset.pcmsAlbumTitle || '' });
745 } catch(err) { console.error('[pcms-audio] bad album JSON', err, album.dataset.pcmsAlbum); }
746 } else if (trackData) {
747 try {
748 const t = JSON.parse(trackData);
749 t.postUrl = postUrl;
750 setQueue([t], 0);
751 } catch(err) { console.error('[pcms-audio] bad track JSON', err, trackData); }
752 } else if (trackUrl) {
753 // Fallback: at minimum we have the signed URL
754 setQueue([{ url: trackUrl, title: 'Track', artist: '', cover: '', postUrl }], 0);
755 } else {
756 console.error('[pcms-audio] no track data or url on button or wrapper', btn);
757 }
758 });
759
760 // ============================================================
761 // 8b. Admin playlist delete (event delegation)
762 // ============================================================
763 // The post-album embed renders a [data-pcms-playlist-delete] button
764 // top-right when the viewer is admin (server decides; not client).
765 // We delegate from document.body so HTMX-swapped content works too.
766 document.body.addEventListener('click', async (e) => {
767 const btn = e.target.closest('[data-pcms-playlist-delete]');
768 if (!btn) return;
769 e.preventDefault();
770 e.stopPropagation();
771 const id = btn.dataset.pcmsPlaylistDelete;
772 const title = btn.dataset.pcmsPlaylistTitle || id;
773 if (!id) return;
774 if (!confirm(`Playlist "${title}" verwijderen? De embed in deze post toont vanaf nu een placeholder.`)) return;
775 btn.disabled = true;
776 try {
777 const r = await fetch(`/admin/playlists/api/${encodeURIComponent(id)}/delete`, {
778 method: 'POST',
779 headers: { 'X-CSRF-Token': '' },
780 credentials: 'same-origin',
781 });
782 const j = await r.json().catch(() => ({}));
783 if (j && j.ok) {
784 location.reload();
785 } else {
786 alert('Verwijderen mislukt: ' + ((j && j.error) || 'onbekende fout'));
787 btn.disabled = false;
788 }
789 } catch (err) {
790 alert('Verwijderen mislukt: ' + err.message);
791 btn.disabled = false;
792 }
793 });
794
795 // ============================================================
796 // 9. Public API
797 // ============================================================
798 window.pcmsAudioPlayer = {
799 setQueue, play, pause, next, prev, close, openSheet, closeSheet,
800 isPlaying: () => isPlaying,
801 currentTrack: () => queue[currentIndex] || null,
802 };
803
804 // ============================================================
805 // 10. Session persistence — player "survives" across page navigations
806 // ============================================================
807 // An <audio> element doesn't survive a full page load (and cross-context
808 // navigation — e.g. to the headerless hub overview — is intentionally a
809 // full-nav). We save the session to sessionStorage and restore + resume it
810 // on the next page: the player comes back with the same track at the same
811 // position. In Chrome (high media engagement) it resumes immediately;
812 // if the browser blocks autoplay it waits at that position (one tap = play).
813 const PLAYER_STATE_KEY = 'pcms-player-state';
814 let pendingSeek = 0;
815 function savePlayerState() {
816 try {
817 if (!queue.length) { sessionStorage.removeItem(PLAYER_STATE_KEY); return; }
818 sessionStorage.setItem(PLAYER_STATE_KEY, JSON.stringify({
819 queue, currentIndex, albumName,
820 time: audio.currentTime || 0,
821 playing: !!audio.src && !audio.paused,
822 }));
823 } catch (e) {}
824 }
825 window.addEventListener('pagehide', savePlayerState);
826 window.addEventListener('beforeunload', savePlayerState);
827 audio.addEventListener('play', savePlayerState);
828 audio.addEventListener('pause', savePlayerState);
829 audio.addEventListener('ended', savePlayerState);
830 setInterval(() => { if (audio.src && !audio.paused) savePlayerState(); }, 5000);
831 // Apply the restored position once track metadata is available.
832 audio.addEventListener('loadedmetadata', () => {
833 if (pendingSeek > 0 && isFinite(audio.duration) && audio.duration > 0) {
834 try { audio.currentTime = Math.min(pendingSeek, audio.duration - 0.25); } catch (e) {}
835 pendingSeek = 0;
836 }
837 });
838 function restorePlayerState() {
839 let s = null;
840 try { s = JSON.parse(sessionStorage.getItem(PLAYER_STATE_KEY) || 'null'); } catch (e) { return false; }
841 if (!s || !Array.isArray(s.queue) || !s.queue.length) return false;
842 queue = s.queue;
843 albumName = s.albumName || '';
844 pendingSeek = s.time || 0;
845 const idx = Math.max(0, Math.min(s.currentIndex || 0, queue.length - 1));
846 // playing → fetch + (attempt to) resume; paused → meta-only.
847 loadTrack(idx, !!s.playing, !s.playing);
848 return true;
849 }
850
851 // ============================================================
852 // 11. Site-level pre-seed (window.PCMS_SITE_TRACKS)
853 // ============================================================
854 // An active session (restore) wins over the page seed, so music that is
855 // already playing continues instead of being replaced by the new page's tracks.
856 if (!restorePlayerState()) {
857 if (Array.isArray(window.PCMS_SITE_TRACKS) && window.PCMS_SITE_TRACKS.length) {
858 queue = window.PCMS_SITE_TRACKS.map(t => ({
859 id: t.id || null,
860 url: t.media_url || t.url,
861 title: t.title || 'Untitled',
862 artist: t.artist || '',
863 cover: t.cover_url || t.cover || '',
864 }));
865 // Only prime the queue — the player bar appears only on the first audio click
866 // (.post-audio-track or the mini-player play button calls setQueue/loadTrack,
867 // which shows the bar). No more pre-seed bar on page load.
868 currentIndex = 0;
869 }
870 }
871})();
Note: See TracBrowser for help on using the repository browser.