@arraypress/waveform-bar 1.2.1 → 1.3.1

package/README.md

@@ -78,6 +78,33 @@ npm install @arraypress/waveform-player @arraypress/waveform-bar
 Click the button → the bar slides up from the bottom → music plays. Add more buttons anywhere on the page and they all
 share the same player bar.
 
+## Inline WaveformPlayer integration (v1.3+)
+
+When `@arraypress/waveform-player` 1.6+ instances are mounted on the same page with `audioMode: 'external'`, WaveformBar discovers them automatically and treats them as **synchronized visual surfaces**:
+
+- Click the inline player's play button → playback happens in the bar
+- The bar's audio progress mirrors into the inline canvas in real time (scrubber moves, play/pause icon flips)
+- When the bar switches tracks, the previously-active inline player resets to paused
+
+No configuration on the bar side — the discovery scan runs on init + MutationObserver tick, listening for `waveformplayer:request-play|pause|seek` events at the document level. Any inline player whose URL matches the bar's current track gets `setPlayingState(...)` and `setProgress(...)` calls pumped to it.
+
+```html
+<!-- The same element doubles as a bar trigger (data-wb-play) AND an
+     inline visual surface (data-waveform-player + audio-mode). Single
+     audio source (the bar), multiple visual surfaces (bar + every
+     matching inline player). -->
+<div data-waveform-player
+     data-audio-mode="external"
+     data-url="song.mp3"
+     data-waveform-style="bars"
+
+     data-wb-play
+     data-wb-url="song.mp3"
+     data-wb-title="..."></div>
+```
+
+This is the SoundCloud / Bandcamp pattern — the persistent bar owns playback, but every place a track surfaces on the page gets its own playable, progress-aware visualization.
+
 ## Data Attributes
 
 ### Play Trigger (`data-wb-play`)

package/dist/waveform-bar.esm.js

@@ -536,6 +536,7 @@ var WaveformBar = class {
         this.isPlaying = true;
         this._updatePlayButton();
         this._syncPageState();
+        this._pumpExternalPlayState(true);
         const track = this.getCurrentTrack();
         this._emit("play", { track });
         if (this.config.onPlay) this.config.onPlay(track);
@@ -544,6 +545,7 @@ var WaveformBar = class {
         this.isPlaying = false;
         this._updatePlayButton();
         this._syncPageState();
+        this._pumpExternalPlayState(false);
         this._saveState();
         const track = this.getCurrentTrack();
         this._emit("pause", { track });
@@ -553,6 +555,7 @@ var WaveformBar = class {
         this.isPlaying = false;
         this._updatePlayButton();
         this._syncPageState();
+        this._pumpExternalPlayState(false);
         if (this.timeCurrentEl) this.timeCurrentEl.textContent = "0:00";
         if (this.repeat === "one") {
           if (this.player) {
@@ -574,6 +577,7 @@ var WaveformBar = class {
         this._lastPosition = currentTime;
         if (this.timeCurrentEl) this.timeCurrentEl.textContent = formatTime(currentTime);
         if (this.timeTotalEl) this.timeTotalEl.textContent = formatTime(duration);
+        this._pumpExternalProgress(currentTime, duration);
         if (!this._lastSaveTime || currentTime - this._lastSaveTime > 2) {
           this._lastSaveTime = currentTime;
           this._saveState();
@@ -612,6 +616,119 @@ var WaveformBar = class {
         if (track) this.addToQueue(track);
       });
     });
+    this._attachExternalPlayers();
+  }
+  /**
+   * Discover external-mode WaveformPlayer instances and listen for
+   * their request-play / request-pause / request-seek events. Also
+   * builds a url → Set<WaveformPlayer> map used by _syncPageState()
+   * and the onTimeUpdate callback to push state into the matching
+   * inline visualizations.
+   *
+   * Idempotent — safe to call repeatedly. Late-mounted players are
+   * picked up by the MutationObserver in _observeDOM().
+   *
+   * @private
+   */
+  _attachExternalPlayers() {
+    if (!this._externalListenersBound) {
+      this._externalListenersBound = true;
+      document.addEventListener("waveformplayer:request-play", (e) => {
+        const t = e.detail;
+        if (!t || !t.url) return;
+        e.preventDefault();
+        this.play(t);
+      });
+      document.addEventListener("waveformplayer:request-pause", (e) => {
+        const t = e.detail;
+        if (!t || !t.url) return;
+        const current = this.getCurrentTrack();
+        if (current && current.url === t.url) {
+          e.preventDefault();
+          if (this.isPlaying) this.togglePlay();
+        }
+      });
+      document.addEventListener("waveformplayer:request-seek", (e) => {
+        const t = e.detail;
+        if (!t || !t.url || typeof t.percent !== "number") return;
+        const current = this.getCurrentTrack();
+        if (current && current.url === t.url && this.player && this.player.audio) {
+          e.preventDefault();
+          this.player.seekToPercent(t.percent);
+        }
+      });
+    }
+    const previous = this._externalPlayers || /* @__PURE__ */ new Map();
+    this._externalPlayers = /* @__PURE__ */ new Map();
+    const WP = window.WaveformPlayer;
+    if (!WP || !WP.instances) return;
+    const newlyDiscovered = [];
+    document.querySelectorAll('[data-waveform-player][data-audio-mode="external"]').forEach((el) => {
+      const inst = WP.instances.get(el.id);
+      if (!inst || !inst.options || !inst.options.url) return;
+      const url = inst.options.url;
+      if (!this._externalPlayers.has(url)) this._externalPlayers.set(url, /* @__PURE__ */ new Set());
+      this._externalPlayers.get(url).add(inst);
+      const wasKnown = previous.get(url) && previous.get(url).has(inst);
+      if (!wasKnown) newlyDiscovered.push({ inst, url });
+    });
+    if (newlyDiscovered.length) {
+      const current = this.getCurrentTrack();
+      const currentUrl = current ? current.url : null;
+      newlyDiscovered.forEach(({ inst, url }) => {
+        const isCurrent = url === currentUrl;
+        if (typeof inst.setPlayingState === "function") {
+          inst.setPlayingState(isCurrent && this.isPlaying);
+        }
+        if (isCurrent && typeof inst.setProgress === "function" && this.player && this.player.audio) {
+          inst.setProgress(this.player.audio.currentTime || 0, this.player.audio.duration || 0);
+        }
+      });
+    }
+  }
+  /**
+   * Push playing-state into every external-mode player whose URL
+   * matches the currently playing track. Other URLs get set to
+   * false (paused) — covers the case where the bar switched tracks
+   * and the previously-current external player should stop showing
+   * its play indicator.
+   *
+   * @private
+   * @param {boolean} playing
+   */
+  _pumpExternalPlayState(playing) {
+    if (!this._externalPlayers || this._externalPlayers.size === 0) return;
+    const current = this.getCurrentTrack();
+    const currentUrl = current ? current.url : null;
+    this._externalPlayers.forEach((set, url) => {
+      const isCurrent = url === currentUrl;
+      set.forEach((player) => {
+        if (typeof player.setPlayingState === "function") {
+          player.setPlayingState(isCurrent && playing);
+        }
+      });
+    });
+  }
+  /**
+   * Push progress (currentTime + duration) into the external-mode
+   * player(s) tracking the current URL. Called on every timeupdate
+   * tick of the internal player.
+   *
+   * @private
+   * @param {number} currentTime
+   * @param {number} duration
+   */
+  _pumpExternalProgress(currentTime, duration) {
+    if (!this._externalPlayers || this._externalPlayers.size === 0) return;
+    const current = this.getCurrentTrack();
+    if (!current) return;
+    const set = this._externalPlayers.get(current.url);
+    if (!set) return;
+    set.forEach((player) => {
+      if (typeof player.setProgress === "function") {
+        player.setProgress(currentTime, duration);
+      }
+    });
   }
   _observeDOM() {
     if (typeof MutationObserver === "undefined") return;
@@ -967,6 +1084,7 @@ var WaveformBar = class {
   _loadCurrentTrack() {
     const track = this.getCurrentTrack();
     if (!track || !this.player) return;
+    this._pumpExternalPlayState(false);
     this.show();
     this._updateTrackDisplay(track);
     this._updateFavoriteUI();

package/dist/waveform-bar.js

@@ -537,6 +537,7 @@
           this.isPlaying = true;
           this._updatePlayButton();
           this._syncPageState();
+          this._pumpExternalPlayState(true);
           const track = this.getCurrentTrack();
           this._emit("play", { track });
           if (this.config.onPlay) this.config.onPlay(track);
@@ -545,6 +546,7 @@
           this.isPlaying = false;
           this._updatePlayButton();
           this._syncPageState();
+          this._pumpExternalPlayState(false);
           this._saveState();
           const track = this.getCurrentTrack();
           this._emit("pause", { track });
@@ -554,6 +556,7 @@
           this.isPlaying = false;
           this._updatePlayButton();
           this._syncPageState();
+          this._pumpExternalPlayState(false);
           if (this.timeCurrentEl) this.timeCurrentEl.textContent = "0:00";
           if (this.repeat === "one") {
             if (this.player) {
@@ -575,6 +578,7 @@
           this._lastPosition = currentTime;
           if (this.timeCurrentEl) this.timeCurrentEl.textContent = formatTime(currentTime);
           if (this.timeTotalEl) this.timeTotalEl.textContent = formatTime(duration);
+          this._pumpExternalProgress(currentTime, duration);
           if (!this._lastSaveTime || currentTime - this._lastSaveTime > 2) {
             this._lastSaveTime = currentTime;
             this._saveState();
@@ -613,6 +617,119 @@
           if (track) this.addToQueue(track);
         });
       });
+      this._attachExternalPlayers();
+    }
+    /**
+     * Discover external-mode WaveformPlayer instances and listen for
+     * their request-play / request-pause / request-seek events. Also
+     * builds a url → Set<WaveformPlayer> map used by _syncPageState()
+     * and the onTimeUpdate callback to push state into the matching
+     * inline visualizations.
+     *
+     * Idempotent — safe to call repeatedly. Late-mounted players are
+     * picked up by the MutationObserver in _observeDOM().
+     *
+     * @private
+     */
+    _attachExternalPlayers() {
+      if (!this._externalListenersBound) {
+        this._externalListenersBound = true;
+        document.addEventListener("waveformplayer:request-play", (e) => {
+          const t = e.detail;
+          if (!t || !t.url) return;
+          e.preventDefault();
+          this.play(t);
+        });
+        document.addEventListener("waveformplayer:request-pause", (e) => {
+          const t = e.detail;
+          if (!t || !t.url) return;
+          const current = this.getCurrentTrack();
+          if (current && current.url === t.url) {
+            e.preventDefault();
+            if (this.isPlaying) this.togglePlay();
+          }
+        });
+        document.addEventListener("waveformplayer:request-seek", (e) => {
+          const t = e.detail;
+          if (!t || !t.url || typeof t.percent !== "number") return;
+          const current = this.getCurrentTrack();
+          if (current && current.url === t.url && this.player && this.player.audio) {
+            e.preventDefault();
+            this.player.seekToPercent(t.percent);
+          }
+        });
+      }
+      const previous = this._externalPlayers || /* @__PURE__ */ new Map();
+      this._externalPlayers = /* @__PURE__ */ new Map();
+      const WP = window.WaveformPlayer;
+      if (!WP || !WP.instances) return;
+      const newlyDiscovered = [];
+      document.querySelectorAll('[data-waveform-player][data-audio-mode="external"]').forEach((el) => {
+        const inst = WP.instances.get(el.id);
+        if (!inst || !inst.options || !inst.options.url) return;
+        const url = inst.options.url;
+        if (!this._externalPlayers.has(url)) this._externalPlayers.set(url, /* @__PURE__ */ new Set());
+        this._externalPlayers.get(url).add(inst);
+        const wasKnown = previous.get(url) && previous.get(url).has(inst);
+        if (!wasKnown) newlyDiscovered.push({ inst, url });
+      });
+      if (newlyDiscovered.length) {
+        const current = this.getCurrentTrack();
+        const currentUrl = current ? current.url : null;
+        newlyDiscovered.forEach(({ inst, url }) => {
+          const isCurrent = url === currentUrl;
+          if (typeof inst.setPlayingState === "function") {
+            inst.setPlayingState(isCurrent && this.isPlaying);
+          }
+          if (isCurrent && typeof inst.setProgress === "function" && this.player && this.player.audio) {
+            inst.setProgress(this.player.audio.currentTime || 0, this.player.audio.duration || 0);
+          }
+        });
+      }
+    }
+    /**
+     * Push playing-state into every external-mode player whose URL
+     * matches the currently playing track. Other URLs get set to
+     * false (paused) — covers the case where the bar switched tracks
+     * and the previously-current external player should stop showing
+     * its play indicator.
+     *
+     * @private
+     * @param {boolean} playing
+     */
+    _pumpExternalPlayState(playing) {
+      if (!this._externalPlayers || this._externalPlayers.size === 0) return;
+      const current = this.getCurrentTrack();
+      const currentUrl = current ? current.url : null;
+      this._externalPlayers.forEach((set, url) => {
+        const isCurrent = url === currentUrl;
+        set.forEach((player) => {
+          if (typeof player.setPlayingState === "function") {
+            player.setPlayingState(isCurrent && playing);
+          }
+        });
+      });
+    }
+    /**
+     * Push progress (currentTime + duration) into the external-mode
+     * player(s) tracking the current URL. Called on every timeupdate
+     * tick of the internal player.
+     *
+     * @private
+     * @param {number} currentTime
+     * @param {number} duration
+     */
+    _pumpExternalProgress(currentTime, duration) {
+      if (!this._externalPlayers || this._externalPlayers.size === 0) return;
+      const current = this.getCurrentTrack();
+      if (!current) return;
+      const set = this._externalPlayers.get(current.url);
+      if (!set) return;
+      set.forEach((player) => {
+        if (typeof player.setProgress === "function") {
+          player.setProgress(currentTime, duration);
+        }
+      });
     }
     _observeDOM() {
       if (typeof MutationObserver === "undefined") return;
@@ -968,6 +1085,7 @@
     _loadCurrentTrack() {
       const track = this.getCurrentTrack();
       if (!track || !this.player) return;
+      this._pumpExternalPlayState(false);
       this.show();
       this._updateTrackDisplay(track);
       this._updateFavoriteUI();

package/dist/waveform-bar.min.js

@@ -1,4 +1,4 @@
-(()=>{var n={play:'<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor"><path d="M8 5v14l11-7z"/></svg>',pause:'<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor"><path d="M6 4h4v16H6zM14 4h4v16h-4z"/></svg>',prev:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M6 6h2v12H6zm3.5 6l8.5 6V6z"/></svg>',next:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M6 18l8.5-6L6 6v12zM16 6v12h2V6h-2z"/></svg>',queue:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M3 13h2v-2H3v2zm0 4h2v-2H3v2zm0-8h2V7H3v2zm4 4h14v-2H7v2zm0 4h14v-2H7v2zM7 7v2h14V7H7z"/></svg>',music:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor" opacity="0.5"><path d="M12 3v10.55c-.59-.34-1.27-.55-2-.55C7.79 13 6 14.79 6 17s1.79 4 4 4 4-1.79 4-4V7h4V3h-6z"/></svg>',volHigh:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM14 3.23v2.06c2.89.86 5 3.54 5 6.71s-2.11 5.85-5 6.71v2.06c4.01-.91 7-4.49 7-8.77s-2.99-7.86-7-8.77z"/></svg>',volLow:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M18.5 12c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM5 9v6h4l5 5V4L9 9H5z"/></svg>',volMute:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M16.5 12c0-1.77-1.02-3.29-2.5-4.03v2.21l2.45 2.45c.03-.2.05-.41.05-.63zm2.5 0c0 .94-.2 1.82-.54 2.64l1.51 1.51C20.63 14.91 21 13.5 21 12c0-4.28-2.99-7.86-7-8.77v2.06c2.89.86 5 3.54 5 6.71zM4.27 3L3 4.27 7.73 9H3v6h4l5 5v-6.73l4.25 4.25c-.67.52-1.42.93-2.25 1.18v2.06c1.38-.31 2.63-.95 3.69-1.81L19.73 21 21 19.73l-9-9L4.27 3zM12 4L9.91 6.09 12 8.18V4z"/></svg>',heart:'<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2"><path d="M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z"/></svg>',heartFilled:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z"/></svg>',cart:'<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2"><circle cx="9" cy="21" r="1"/><circle cx="20" cy="21" r="1"/><path d="M1 1h4l2.68 13.39a2 2 0 0 0 2 1.61h9.72a2 2 0 0 0 2-1.61L23 6H6"/></svg>',close:'<svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>',speaker:'<svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor"><path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02z"/></svg>',repeatOff:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M7 7h10v3l4-4-4-4v3H5v6h2V7zm10 10H7v-3l-4 4 4 4v-3h12v-6h-2v4z"/></svg>',repeatAll:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M7 7h10v3l4-4-4-4v3H5v6h2V7zm10 10H7v-3l-4 4 4 4v-3h12v-6h-2v4z"/></svg>',repeatOne:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M7 7h10v3l4-4-4-4v3H5v6h2V7zm10 10H7v-3l-4 4 4 4v-3h12v-6h-2v4z"/><text x="12" y="15" text-anchor="middle" font-size="7" font-weight="bold" fill="currentColor">1</text></svg>'};function d(s){return s?s.split("/").pop().split(".")[0].replace(/[-_]/g," ").replace(/\b\w/g,t=>t.toUpperCase()):"Untitled"}function u(s){if(!s)return"";let t=document.createElement("div");return t.textContent=s,t.innerHTML}function v(s){if(!s||isNaN(s))return"0:00";let t=Math.floor(s/60),e=Math.floor(s%60);return`${t}:${e.toString().padStart(2,"0")}`}function m(s){let t=s.dataset.wbUrl||s.dataset.url;if(!t)return null;let e={};try{e=JSON.parse(s.dataset.wbMeta||s.dataset.meta||"{}")}catch{}let i=null;try{i=JSON.parse(s.dataset.wbMarkers||s.dataset.markers||"null")}catch{}return{url:t,id:s.dataset.wbId||s.dataset.id||t,title:s.dataset.wbTitle||s.dataset.title||d(t),artist:s.dataset.wbArtist||s.dataset.artist||"",artwork:s.dataset.wbArtwork||s.dataset.artwork||"",album:s.dataset.wbAlbum||s.dataset.album||"",link:s.dataset.wbLink||s.dataset.link||"",duration:s.dataset.wbDuration||s.dataset.duration||"",bpm:s.dataset.wbBpm||s.dataset.bpm||"",key:s.dataset.wbKey||s.dataset.key||"",waveform:s.dataset.wbWaveform||s.dataset.waveform||"",markers:i,favorited:s.dataset.wbFavorited==="true",inCart:s.dataset.wbInCart==="true",meta:e}}function g(s,t){try{sessionStorage.setItem(s,JSON.stringify(t))}catch{}}function w(s){try{let t=sessionStorage.getItem(s);if(!t)return null;let e=JSON.parse(t);return!e||!e.queue||!e.queue.length?null:e}catch{return sessionStorage.removeItem(s),null}}function y(s,t,e,i){try{localStorage.setItem(s+"-vol",JSON.stringify({v:t,m:e,b:i}))}catch{}}function E(s){try{let t=JSON.parse(localStorage.getItem(s+"-vol"));return t?{volume:t.v!=null?t.v:1,muted:t.m||!1,volumeBeforeMute:t.b||1}:null}catch{return null}}function p(s,t){try{localStorage.setItem(s+"-favs",JSON.stringify([...t]))}catch{}}function _(s){try{let t=JSON.parse(localStorage.getItem(s+"-favs"));return Array.isArray(t)?new Set(t):new Set}catch{return new Set}}function b(s,t){if(!(!s||!s.endpoint)){if(typeof s.endpoint=="function"){try{s.endpoint(t)}catch(e){console.warn("WaveformBar action callback error:",e)}return}typeof s.endpoint=="string"&&fetch(s.endpoint,{method:s.method||"POST",headers:{"Content-Type":"application/json",...s.headers||{}},body:JSON.stringify(t)}).catch(e=>console.warn("WaveformBar action request failed:",e))}}function k(s){let t='<div class="wb-left">';t+='<div class="wb-controls">',s.showPrevNext&&(t+=`<button class="wb-btn wb-prev" aria-label="Previous" title="Previous">${n.prev}</button>`),t+=`<button class="wb-btn wb-play" aria-label="Play/Pause" title="Play">
+(()=>{var n={play:'<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor"><path d="M8 5v14l11-7z"/></svg>',pause:'<svg viewBox="0 0 24 24" width="20" height="20" fill="currentColor"><path d="M6 4h4v16H6zM14 4h4v16h-4z"/></svg>',prev:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M6 6h2v12H6zm3.5 6l8.5 6V6z"/></svg>',next:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M6 18l8.5-6L6 6v12zM16 6v12h2V6h-2z"/></svg>',queue:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M3 13h2v-2H3v2zm0 4h2v-2H3v2zm0-8h2V7H3v2zm4 4h14v-2H7v2zm0 4h14v-2H7v2zM7 7v2h14V7H7z"/></svg>',music:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor" opacity="0.5"><path d="M12 3v10.55c-.59-.34-1.27-.55-2-.55C7.79 13 6 14.79 6 17s1.79 4 4 4 4-1.79 4-4V7h4V3h-6z"/></svg>',volHigh:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM14 3.23v2.06c2.89.86 5 3.54 5 6.71s-2.11 5.85-5 6.71v2.06c4.01-.91 7-4.49 7-8.77s-2.99-7.86-7-8.77z"/></svg>',volLow:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M18.5 12c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02zM5 9v6h4l5 5V4L9 9H5z"/></svg>',volMute:'<svg viewBox="0 0 24 24" width="18" height="18" fill="currentColor"><path d="M16.5 12c0-1.77-1.02-3.29-2.5-4.03v2.21l2.45 2.45c.03-.2.05-.41.05-.63zm2.5 0c0 .94-.2 1.82-.54 2.64l1.51 1.51C20.63 14.91 21 13.5 21 12c0-4.28-2.99-7.86-7-8.77v2.06c2.89.86 5 3.54 5 6.71zM4.27 3L3 4.27 7.73 9H3v6h4l5 5v-6.73l4.25 4.25c-.67.52-1.42.93-2.25 1.18v2.06c1.38-.31 2.63-.95 3.69-1.81L19.73 21 21 19.73l-9-9L4.27 3zM12 4L9.91 6.09 12 8.18V4z"/></svg>',heart:'<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2"><path d="M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z"/></svg>',heartFilled:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M20.84 4.61a5.5 5.5 0 0 0-7.78 0L12 5.67l-1.06-1.06a5.5 5.5 0 0 0-7.78 7.78l1.06 1.06L12 21.23l7.78-7.78 1.06-1.06a5.5 5.5 0 0 0 0-7.78z"/></svg>',cart:'<svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2"><circle cx="9" cy="21" r="1"/><circle cx="20" cy="21" r="1"/><path d="M1 1h4l2.68 13.39a2 2 0 0 0 2 1.61h9.72a2 2 0 0 0 2-1.61L23 6H6"/></svg>',close:'<svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>',speaker:'<svg viewBox="0 0 24 24" width="14" height="14" fill="currentColor"><path d="M3 9v6h4l5 5V4L7 9H3zm13.5 3c0-1.77-1.02-3.29-2.5-4.03v8.05c1.48-.73 2.5-2.25 2.5-4.02z"/></svg>',repeatOff:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M7 7h10v3l4-4-4-4v3H5v6h2V7zm10 10H7v-3l-4 4 4 4v-3h12v-6h-2v4z"/></svg>',repeatAll:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M7 7h10v3l4-4-4-4v3H5v6h2V7zm10 10H7v-3l-4 4 4 4v-3h12v-6h-2v4z"/></svg>',repeatOne:'<svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M7 7h10v3l4-4-4-4v3H5v6h2V7zm10 10H7v-3l-4 4 4 4v-3h12v-6h-2v4z"/><text x="12" y="15" text-anchor="middle" font-size="7" font-weight="bold" fill="currentColor">1</text></svg>'};function d(s){return s?s.split("/").pop().split(".")[0].replace(/[-_]/g," ").replace(/\b\w/g,t=>t.toUpperCase()):"Untitled"}function h(s){if(!s)return"";let t=document.createElement("div");return t.textContent=s,t.innerHTML}function v(s){if(!s||isNaN(s))return"0:00";let t=Math.floor(s/60),e=Math.floor(s%60);return`${t}:${e.toString().padStart(2,"0")}`}function p(s){let t=s.dataset.wbUrl||s.dataset.url;if(!t)return null;let e={};try{e=JSON.parse(s.dataset.wbMeta||s.dataset.meta||"{}")}catch{}let i=null;try{i=JSON.parse(s.dataset.wbMarkers||s.dataset.markers||"null")}catch{}return{url:t,id:s.dataset.wbId||s.dataset.id||t,title:s.dataset.wbTitle||s.dataset.title||d(t),artist:s.dataset.wbArtist||s.dataset.artist||"",artwork:s.dataset.wbArtwork||s.dataset.artwork||"",album:s.dataset.wbAlbum||s.dataset.album||"",link:s.dataset.wbLink||s.dataset.link||"",duration:s.dataset.wbDuration||s.dataset.duration||"",bpm:s.dataset.wbBpm||s.dataset.bpm||"",key:s.dataset.wbKey||s.dataset.key||"",waveform:s.dataset.wbWaveform||s.dataset.waveform||"",markers:i,favorited:s.dataset.wbFavorited==="true",inCart:s.dataset.wbInCart==="true",meta:e}}function g(s,t){try{sessionStorage.setItem(s,JSON.stringify(t))}catch{}}function w(s){try{let t=sessionStorage.getItem(s);if(!t)return null;let e=JSON.parse(t);return!e||!e.queue||!e.queue.length?null:e}catch{return sessionStorage.removeItem(s),null}}function y(s,t,e,i){try{localStorage.setItem(s+"-vol",JSON.stringify({v:t,m:e,b:i}))}catch{}}function E(s){try{let t=JSON.parse(localStorage.getItem(s+"-vol"));return t?{volume:t.v!=null?t.v:1,muted:t.m||!1,volumeBeforeMute:t.b||1}:null}catch{return null}}function m(s,t){try{localStorage.setItem(s+"-favs",JSON.stringify([...t]))}catch{}}function _(s){try{let t=JSON.parse(localStorage.getItem(s+"-favs"));return Array.isArray(t)?new Set(t):new Set}catch{return new Set}}function b(s,t){if(!(!s||!s.endpoint)){if(typeof s.endpoint=="function"){try{s.endpoint(t)}catch(e){console.warn("WaveformBar action callback error:",e)}return}typeof s.endpoint=="string"&&fetch(s.endpoint,{method:s.method||"POST",headers:{"Content-Type":"application/json",...s.headers||{}},body:JSON.stringify(t)}).catch(e=>console.warn("WaveformBar action request failed:",e))}}function k(s){let t='<div class="wb-left">';t+='<div class="wb-controls">',s.showPrevNext&&(t+=`<button class="wb-btn wb-prev" aria-label="Previous" title="Previous">${n.prev}</button>`),t+=`<button class="wb-btn wb-play" aria-label="Play/Pause" title="Play">
         <span class="wb-icon-play">${n.play}</span>
         <span class="wb-icon-pause" style="display:none">${n.pause}</span>
     </button>`,s.showPrevNext&&(t+=`<button class="wb-btn wb-next" aria-label="Next" title="Next">${n.next}</button>`),s.showRepeat&&(t+=`<button class="wb-btn wb-btn-sm wb-repeat" aria-label="Repeat" title="Repeat: Off">${n.repeatOff}</button>`),t+="</div>",t+=`<div class="wb-track">
@@ -22,26 +22,26 @@
             <button class="wb-btn wb-btn-sm wb-queue-clear" aria-label="Clear queue">Clear</button>
         </div>
         <div class="wb-queue-body"></div>
-    `,s}function B(s,t,e,i,r){if(!s)return;let a=Math.max(0,e.length-1-i);if(t&&(t.textContent=a),e.length===0){s.innerHTML=`<div class="wb-queue-empty">${n.queue}<p>Queue is empty</p></div>`;return}let l="";if(i>=0&&i<e.length){let o=e[i];l+='<div class="wb-queue-label">Now Playing</div>',l+=`<div class="wb-queue-item wb-queue-current" data-qi="${i}">
+    `,s}function x(s,t,e,i,r){if(!s)return;let a=Math.max(0,e.length-1-i);if(t&&(t.textContent=a),e.length===0){s.innerHTML=`<div class="wb-queue-empty">${n.queue}<p>Queue is empty</p></div>`;return}let l="";if(i>=0&&i<e.length){let o=e[i];l+='<div class="wb-queue-label">Now Playing</div>',l+=`<div class="wb-queue-item wb-queue-current" data-qi="${i}">
             <span class="wb-queue-num">${n.speaker}</span>
             <div class="wb-queue-info">
-                <div class="wb-queue-item-title">${u(o.title)}</div>
-                <div class="wb-queue-item-artist">${u(o.artist)}</div>
+                <div class="wb-queue-item-title">${h(o.title)}</div>
+                <div class="wb-queue-item-artist">${h(o.artist)}</div>
             </div>
-        </div>`}let c=!1;for(let o=i+1;o<e.length;o++){c||(l+='<div class="wb-queue-label">Next Up</div>',c=!0);let h=e[o];l+=`<div class="wb-queue-item" data-qi="${o}">
+        </div>`}let u=!1;for(let o=i+1;o<e.length;o++){u||(l+='<div class="wb-queue-label">Next Up</div>',u=!0);let c=e[o];l+=`<div class="wb-queue-item" data-qi="${o}">
             <span class="wb-queue-num">${o-i}</span>
             <div class="wb-queue-info">
-                <div class="wb-queue-item-title">${u(h.title)}</div>
-                <div class="wb-queue-item-artist">${u(h.artist)}</div>
+                <div class="wb-queue-item-title">${h(c.title)}</div>
+                <div class="wb-queue-item-artist">${h(c.artist)}</div>
             </div>
             <button class="wb-queue-remove" data-qi="${o}" aria-label="Remove">${n.close}</button>
-        </div>`}if(i>0){l+='<div class="wb-queue-label">Previously Played</div>';for(let o=i-1;o>=0;o--){let h=e[o];l+=`<div class="wb-queue-item wb-queue-played" data-qi="${o}">
+        </div>`}if(i>0){l+='<div class="wb-queue-label">Previously Played</div>';for(let o=i-1;o>=0;o--){let c=e[o];l+=`<div class="wb-queue-item wb-queue-played" data-qi="${o}">
                 <span class="wb-queue-num">${o+1}</span>
                 <div class="wb-queue-info">
-                    <div class="wb-queue-item-title">${u(h.title)}</div>
-                    <div class="wb-queue-item-artist">${u(h.artist)}</div>
+                    <div class="wb-queue-item-title">${h(c.title)}</div>
+                    <div class="wb-queue-item-artist">${h(c.artist)}</div>
                 </div>
-            </div>`}}s.innerHTML=l,s.querySelectorAll(".wb-queue-item[data-qi]").forEach(o=>{o.addEventListener("click",h=>{h.target.closest(".wb-queue-remove")||r.onSkipTo&&r.onSkipTo(parseInt(o.dataset.qi))})}),s.querySelectorAll(".wb-queue-remove").forEach(o=>{o.addEventListener("click",h=>{h.stopPropagation(),r.onRemove&&r.onRemove(parseInt(o.dataset.qi))})})}var x={persist:!0,autoResume:!0,continuous:!0,repeat:"off",showRepeat:!0,showQueue:!0,showPrevNext:!0,showVolume:!0,showMute:!0,showMeta:!0,showTime:!0,showTrackLink:!0,maxMeta:3,defaultArtwork:null,theme:null,waveformStyle:"mirror",waveformHeight:32,barWidth:2,barSpacing:0,waveformColor:null,progressColor:null,markerColor:"rgba(255, 255, 255, 0.25)",volume:1,storageKey:"waveform-bar",actions:null,onPlay:null,onPause:null,onTrackChange:null,onQueueChange:null,onVolumeChange:null,onFavorite:null,onCart:null},f=class{constructor(){this.config=null,this.player=null,this.queue=[],this.currentIndex=-1,this.isPlaying=!1,this.isInitialized=!1,this.queueOpen=!1,this.volume=1,this.isMuted=!1,this._volumeBeforeMute=1,this._lastPosition=0,this._favorites=new Set,this._cartItems=new Set,this._observer=null,this._activeMarkers=null,this._currentMarkerIndex=-1,this.repeat="off",this.barEl=null,this.queueEl=null,this.waveformContainer=null,this.volumePopupEl=null,this.titleEl=null,this.artistEl=null,this.metaEl=null,this.playBtnEl=null,this.repeatBtnEl=null,this.queueBtnEl=null,this.queueBodyEl=null,this.queueCountEl=null,this.volumeSliderEl=null,this.muteBtnEl=null,this.favBtnEl=null,this.cartBtnEl=null,this.timeCurrentEl=null,this.timeTotalEl=null}init(t={}){return this.isInitialized&&this.destroy(),this.config={...x,...t},this.volume=this.config.volume,typeof window.WaveformPlayer>"u"?(console.error("WaveformBar: WaveformPlayer is required."),this):(this._createBar(),this._createQueue(),this._initPlayer(),this._bindTriggers(),this._observeDOM(),this.config.persist&&(this._restoreVolume(),this._restoreFavorites()),this._seedFromAttributes(),this.config.persist&&this._restoreState(),this.isInitialized=!0,this._beforeUnloadHandler=()=>this._saveState(),window.addEventListener("beforeunload",this._beforeUnloadHandler),this)}destroy(){return this.player&&(this.player.destroy(),this.player=null),this.barEl&&(this.barEl.remove(),this.barEl=null),this.queueEl&&(this.queueEl.remove(),this.queueEl=null),this._observer&&(this._observer.disconnect(),this._observer=null),this._beforeUnloadHandler&&(window.removeEventListener("beforeunload",this._beforeUnloadHandler),this._beforeUnloadHandler=null),document.querySelectorAll("[data-wb-play],[data-wb-queue]").forEach(t=>delete t._wbBound),document.querySelectorAll(".wb-current,.wb-playing").forEach(t=>t.classList.remove("wb-current","wb-playing")),this.queue=[],this.currentIndex=-1,this.isPlaying=!1,this.queueOpen=!1,this.isInitialized=!1,this.config=null,this}_createBar(){this.barEl=document.createElement("div"),this.barEl.className="waveform-bar";let t=this.config.theme||this._detectTheme();t==="light"&&this.barEl.classList.add("wb-light"),this._resolvedTheme=t,this.barEl.id="waveform-bar",this.barEl.innerHTML=k(this.config),document.body.appendChild(this.barEl),this.titleEl=this.barEl.querySelector(".wb-title"),this.artistEl=this.barEl.querySelector(".wb-artist"),this.metaEl=this.barEl.querySelector(".wb-meta"),this.playBtnEl=this.barEl.querySelector(".wb-play"),this.waveformContainer=this.barEl.querySelector(".wb-waveform-container"),this.queueBtnEl=this.barEl.querySelector(".wb-queue-btn"),this.muteBtnEl=this.barEl.querySelector(".wb-mute"),this.volumeSliderEl=this.barEl.querySelector(".wb-volume-slider"),this.favBtnEl=this.barEl.querySelector(".wb-fav"),this.cartBtnEl=this.barEl.querySelector(".wb-cart"),this.timeCurrentEl=this.barEl.querySelector(".wb-time-current"),this.timeTotalEl=this.barEl.querySelector(".wb-time-total"),this.playBtnEl.addEventListener("click",()=>this.togglePlay());let e=this.barEl.querySelector(".wb-prev"),i=this.barEl.querySelector(".wb-next");e&&e.addEventListener("click",()=>this.previous()),i&&i.addEventListener("click",()=>this.next()),this.repeatBtnEl=this.barEl.querySelector(".wb-repeat"),this.repeatBtnEl&&(this.repeat=this.config.repeat||"off",this._updateRepeatButton(),this.repeatBtnEl.addEventListener("click",()=>this.cycleRepeat())),this.queueBtnEl&&this.queueBtnEl.addEventListener("click",()=>this.toggleQueuePanel()),this.volumePopupEl=this.barEl.querySelector(".wb-volume-popup");let r=this.barEl.querySelector(".wb-volume");if(this.muteBtnEl&&this.muteBtnEl.addEventListener("click",a=>{a.stopPropagation(),this.toggleMute()}),r&&this.volumePopupEl){let a;r.addEventListener("mouseenter",()=>{clearTimeout(a),this.openVolumePopup()}),r.addEventListener("mouseleave",()=>{a=setTimeout(()=>this.closeVolumePopup(),300)})}this.volumeSliderEl&&this.volumeSliderEl.addEventListener("input",a=>{a.stopPropagation(),this.setVolume(parseInt(a.target.value)/100)}),document.addEventListener("click",a=>{this.volumePopupEl?.classList.contains("wb-volume-open")&&!this.barEl.querySelector(".wb-volume")?.contains(a.target)&&this.closeVolumePopup()}),this.favBtnEl&&this.favBtnEl.addEventListener("click",()=>this.toggleFavorite()),this.cartBtnEl&&this.cartBtnEl.addEventListener("click",()=>this.addToCart()),this.config.showTrackLink&&this.barEl.querySelector(".wb-track").addEventListener("click",()=>{let a=this.getCurrentTrack();a&&a.link&&(window.location.href=a.link)})}_createQueue(){this.config.showQueue&&(this.queueEl=q(),this._resolvedTheme==="light"&&this.queueEl.classList.add("wb-light"),document.body.appendChild(this.queueEl),this.queueBodyEl=this.queueEl.querySelector(".wb-queue-body"),this.queueCountEl=this.queueEl.querySelector(".wb-queue-count"),this.queueEl.querySelector(".wb-queue-clear").addEventListener("click",()=>this.clearQueue()),document.addEventListener("click",t=>{this.queueOpen&&!this.queueEl.contains(t.target)&&!this.queueBtnEl.contains(t.target)&&this.closeQueuePanel()}))}_initPlayer(){let t={showControls:!1,showInfo:!1,waveformStyle:this.config.waveformStyle,height:this.config.waveformHeight,barWidth:this.config.barWidth,barSpacing:this.config.barSpacing,singlePlay:!1,onPlay:()=>{this.isPlaying=!0,this._updatePlayButton(),this._syncPageState();let e=this.getCurrentTrack();this._emit("play",{track:e}),this.config.onPlay&&this.config.onPlay(e)},onPause:()=>{this.isPlaying=!1,this._updatePlayButton(),this._syncPageState(),this._saveState();let e=this.getCurrentTrack();this._emit("pause",{track:e}),this.config.onPause&&this.config.onPause(e)},onEnd:()=>{if(this.isPlaying=!1,this._updatePlayButton(),this._syncPageState(),this.timeCurrentEl&&(this.timeCurrentEl.textContent="0:00"),this.repeat==="one"){this.player&&(this.player.seekTo(0),this.player.play().catch(()=>{}));return}this.config.continuous&&this.currentIndex<this.queue.length-1?(this.currentIndex++,this._loadCurrentTrack()):this.repeat==="all"&&this.queue.length>0&&(this.currentIndex=0,this._loadCurrentTrack())},onTimeUpdate:(e,i)=>{this._lastPosition=e,this.timeCurrentEl&&(this.timeCurrentEl.textContent=v(e)),this.timeTotalEl&&(this.timeTotalEl.textContent=v(i)),(!this._lastSaveTime||e-this._lastSaveTime>2)&&(this._lastSaveTime=e,this._saveState()),this._activeMarkers&&this._checkMarkerBoundary(e)},onLoad:null};this.config.waveformColor&&(t.waveformColor=this.config.waveformColor),this.config.progressColor&&(t.progressColor=this.config.progressColor),this.player=new window.WaveformPlayer(this.waveformContainer,t),this.player.setVolume(this.volume)}_bindTriggers(){document.querySelectorAll("[data-wb-play]").forEach(t=>{t._wbBound||(t._wbBound=!0,t.addEventListener("click",e=>{e.preventDefault();let i=m(t);i&&this.play(i)}))}),document.querySelectorAll("[data-wb-queue]").forEach(t=>{t._wbBound||(t._wbBound=!0,t.addEventListener("click",e=>{e.preventDefault(),e.stopPropagation();let i=m(t);i&&this.addToQueue(i)}))})}_observeDOM(){typeof MutationObserver>"u"||(this._observer=new MutationObserver(()=>{this._bindTriggers(),this._syncPageState()}),this._observer.observe(document.body,{childList:!0,subtree:!0}))}play(t){let e=typeof t=="string"?{url:t,id:t,title:d(t)}:t;if(!e||!e.url)return this;let i=this.getCurrentTrack();if(i&&i.url===e.url)return this.togglePlay(),this;let r=this.queue.findIndex(a=>a.url===e.url);if(r>=0)this.queue[r]={...this.queue[r],...e},this.currentIndex=r;else{let a=this.currentIndex+1;this.queue.splice(a,0,e),this.currentIndex=a}return this._loadCurrentTrack(),this}addToQueue(t){let e=typeof t=="string"?{url:t,id:t,title:d(t)}:t;return!e||!e.url?this:this.queue.find(i=>i.url===e.url)?this:(this.queue.push(e),this._renderQueue(),this._saveState(),this._updateNavButtons(),this.currentIndex===-1&&(this.currentIndex=0,this._loadCurrentTrack()),this.config.onQueueChange&&this.config.onQueueChange(this.queue,this.currentIndex),this)}togglePlay(){return this.player?(this.isPlaying?this.player.pause():this.player.play(),this):this}pause(){return this.player&&this.isPlaying&&this.player.pause(),this}next(){return this.currentIndex<this.queue.length-1?(this.currentIndex++,this._loadCurrentTrack()):this.repeat==="all"&&this.queue.length>0&&(this.currentIndex=0,this._loadCurrentTrack()),this}previous(){return this.player&&this.player.audio&&this.player.audio.currentTime>3?(this.player.seekTo(0),this):(this.currentIndex>0?(this.currentIndex--,this._loadCurrentTrack()):this.repeat==="all"&&this.queue.length>0&&(this.currentIndex=this.queue.length-1,this._loadCurrentTrack()),this)}skipTo(t){return t<0||t>=this.queue.length?this:t===this.currentIndex?(this.togglePlay(),this):(this.currentIndex=t,this._loadCurrentTrack(),this)}seekToMarker(t){if(!this._activeMarkers||t<0||t>=this._activeMarkers.length)return this;let e=this._activeMarkers[t];return this.player&&(this.player.seekTo(e.time),this.isPlaying||this.togglePlay()),this}seekToMarkerByLabel(t){if(!this._activeMarkers)return this;let e=this._activeMarkers.findIndex(i=>(i.label||i.title||"").toLowerCase()===t.toLowerCase());return e>=0&&this.seekToMarker(e),this}setVolume(t){return this.volume=Math.max(0,Math.min(1,t)),this.isMuted=this.volume===0,this.player&&this.player.setVolume(this.volume),this._updateVolumeUI(),y(this.config.storageKey,this.volume,this.isMuted,this._volumeBeforeMute),this._emit("volumechange",{volume:this.volume}),this.config.onVolumeChange&&this.config.onVolumeChange(this.volume),this}getVolume(){return this.volume}toggleMute(){return this.isMuted?this.setVolume(this._volumeBeforeMute||1):(this._volumeBeforeMute=this.volume,this.isMuted=!0,this.player&&this.player.setVolume(0),this._updateVolumeUI()),this}toggleFavorite(){let t=this.getCurrentTrack();if(!t)return this;let e=t.id||t.url,i=this._favorites.has(e);return i?this._favorites.delete(e):this._favorites.add(e),this._updateFavoriteUI(),this._syncFavoriteAttributes(t.url,!i),p(this.config.storageKey,this._favorites),this._emit("favorite",{track:t,favorited:!i}),this.config.onFavorite&&this.config.onFavorite(t,!i),this.config.actions?.favorite&&b(this.config.actions.favorite,{action:"favorite",id:e,url:t.url,title:t.title,favorited:!i}),this}addToCart(){let t=this.getCurrentTrack();if(!t)return this;let e=t.id||t.url;return this._cartItems.add(e),this.cartBtnEl&&(this.cartBtnEl.classList.add("wb-action-done"),setTimeout(()=>this.cartBtnEl.classList.remove("wb-action-done"),1500)),this._syncCartAttributes(t.url,!0),this._emit("cart",{track:t}),this.config.onCart&&this.config.onCart(t),this.config.actions?.cart&&b(this.config.actions.cart,{action:"cart",id:e,url:t.url,title:t.title}),this}isFavorited(t){if(!t){let e=this.getCurrentTrack();t=e?e.id||e.url:null}return t?this._favorites.has(t):!1}isInCart(t){if(!t){let e=this.getCurrentTrack();t=e?e.id||e.url:null}return t?this._cartItems.has(t):!1}removeFromQueue(t){return t<0||t>=this.queue.length||t===this.currentIndex?this:(this.queue.splice(t,1),t<this.currentIndex&&this.currentIndex--,this._renderQueue(),this._saveState(),this._updateNavButtons(),this._emit("queuechange",{queue:this.queue,currentIndex:this.currentIndex}),this.config.onQueueChange&&this.config.onQueueChange(this.queue,this.currentIndex),this)}clearQueue(){let t=this.getCurrentTrack();return this.queue=t?[t]:[],this.currentIndex=t?0:-1,this._renderQueue(),this._saveState(),this._updateNavButtons(),this._emit("queuechange",{queue:this.queue,currentIndex:this.currentIndex}),this.config.onQueueChange&&this.config.onQueueChange(this.queue,this.currentIndex),this}getCurrentTrack(){return this.currentIndex>=0&&this.currentIndex<this.queue.length?this.queue[this.currentIndex]:null}getQueue(){return[...this.queue]}getCurrentIndex(){return this.currentIndex}isCurrentlyPlaying(t){let e=this.getCurrentTrack();return this.isPlaying&&e&&e.url===t}isCurrentTrack(t){let e=this.getCurrentTrack();return e&&e.url===t}getPlayer(){return this.player}_emit(t,e={}){this.barEl&&this.barEl.dispatchEvent(new CustomEvent("waveformbar:"+t,{bubbles:!0,detail:e}))}show(){return this.barEl&&this.barEl.classList.add("wb-active"),this}hide(){return this.barEl&&this.barEl.classList.remove("wb-active"),this.closeQueuePanel(),this.closeVolumePopup(),this}toggleQueuePanel(){return this.queueOpen?this.closeQueuePanel():this.openQueuePanel()}openQueuePanel(){if(!this.queueEl)return this;if(this.queueOpen=!0,this.closeVolumePopup(),this.queueBtnEl){let t=this.queueBtnEl.getBoundingClientRect();this.queueEl.style.right=window.innerWidth-t.right+"px"}return this.queueEl.classList.add("wb-queue-open"),this.queueBtnEl&&this.queueBtnEl.classList.add("wb-active"),this._renderQueue(),this}closeQueuePanel(){return this.queueEl?(this.queueOpen=!1,this.queueEl.classList.remove("wb-queue-open"),this.queueBtnEl&&this.queueBtnEl.classList.remove("wb-active"),this):this}toggleVolumePopup(){return this.volumePopupEl?.classList.contains("wb-volume-open")?this.closeVolumePopup():this.openVolumePopup(),this}openVolumePopup(){return this.volumePopupEl?(this.closeQueuePanel(),this.volumePopupEl.classList.add("wb-volume-open"),this.muteBtnEl&&this.muteBtnEl.classList.add("wb-active"),this):this}closeVolumePopup(){return this.volumePopupEl?(this.volumePopupEl.classList.remove("wb-volume-open"),this.muteBtnEl&&this.muteBtnEl.classList.remove("wb-active"),this):this}_loadCurrentTrack(){let t=this.getCurrentTrack();if(!t||!this.player)return;this.show(),this._updateTrackDisplay(t),this._updateFavoriteUI();let e={artwork:t.artwork,album:t.album};if(t.waveform&&(e.waveform=t.waveform),t.markers&&t.markers.length){let i=this.config.markerColor;e.markers=t.markers.map(r=>({...r,color:r.color||i}))}else e.markers=[];this.player.loadTrack(t.url,t.title,t.artist,e),this._activeMarkers=t.markers&&t.markers.length?t.markers:null,this._currentMarkerIndex=-1,this.player&&this.player.setVolume(this.isMuted?0:this.volume),this._renderQueue(),this._syncPageState(),this._saveState(),this._updateNavButtons(),this._emit("trackchange",{track:t,index:this.currentIndex}),this.config.onTrackChange&&this.config.onTrackChange(t,this.currentIndex)}_updateTrackDisplay(t){this.titleEl&&this._setScrollText(this.titleEl,t.title||"Untitled"),this.artistEl&&this._setScrollText(this.artistEl,t.artist||"");let e=this.barEl.querySelector(".wb-artwork");if(e){let r=t.artwork||this.config.defaultArtwork;e.innerHTML=r?`<img src="${u(r)}" alt="${u(t.title)}" />`:n.music}this.metaEl&&this.config.showMeta&&this._renderMeta(t);let i=this.barEl.querySelector(".wb-track");i&&(i.style.cursor=t.link?"pointer":"default"),this.timeCurrentEl&&(this.timeCurrentEl.textContent="0:00"),this.timeTotalEl&&(this.timeTotalEl.textContent="0:00")}_setScrollText(t,e){t.classList.remove("wb-scrolling"),t.textContent=e,requestAnimationFrame(()=>{if(t.scrollWidth>t.clientWidth){let i=t.scrollWidth-t.clientWidth,r=Math.max(4,i/20);t.innerHTML=`<span class="wb-scroll-inner">${u(e)}</span>`,t.style.setProperty("--wb-scroll-distance",`-${i+48}px`),t.style.setProperty("--wb-scroll-duration",`${r}s`),t.classList.add("wb-scrolling")}})}_renderMeta(t){if(!this.metaEl)return;let e=[];if(t.bpm&&e.push({label:t.bpm+" BPM",type:"bpm"}),t.key&&e.push({label:t.key,type:"key"}),t.duration&&e.push({label:t.duration,type:"duration"}),t.meta)for(let[r,a]of Object.entries(t.meta))a&&e.length<this.config.maxMeta&&e.push({label:String(a),type:r});let i=e.slice(0,this.config.maxMeta);this.metaEl.style.display=i.length?"flex":"none",this.metaEl.innerHTML=i.map(r=>`<span class="wb-tag wb-tag-${u(r.type)}">${u(r.label)}</span>`).join("")}_updatePlayButton(){if(!this.playBtnEl)return;let t=this.playBtnEl.querySelector(".wb-icon-play"),e=this.playBtnEl.querySelector(".wb-icon-pause");t&&(t.style.display=this.isPlaying?"none":"block"),e&&(e.style.display=this.isPlaying?"block":"none"),this.playBtnEl.title=this.isPlaying?"Pause":"Play"}_updateNavButtons(){let t=this.barEl?.querySelector(".wb-prev"),e=this.barEl?.querySelector(".wb-next");this.repeat==="all"?(t&&t.classList.remove("wb-disabled"),e&&e.classList.remove("wb-disabled")):(t&&t.classList.toggle("wb-disabled",this.currentIndex<=0),e&&e.classList.toggle("wb-disabled",this.currentIndex>=this.queue.length-1))}cycleRepeat(){let t=["off","all","one"],e=t.indexOf(this.repeat);return this.repeat=t[(e+1)%t.length],this._updateRepeatButton(),this._updateNavButtons(),this._emit("repeatchange",{mode:this.repeat}),this}setRepeat(t){return["off","all","one"].includes(t)&&(this.repeat=t,this._updateRepeatButton(),this._updateNavButtons(),this._emit("repeatchange",{mode:this.repeat})),this}_updateRepeatButton(){if(!this.repeatBtnEl)return;let t={off:n.repeatOff,all:n.repeatAll,one:n.repeatOne},e={off:"Repeat: Off",all:"Repeat: All",one:"Repeat: One"};this.repeatBtnEl.innerHTML=t[this.repeat],this.repeatBtnEl.title=e[this.repeat],this.repeatBtnEl.classList.toggle("wb-repeat-active",this.repeat!=="off")}_checkMarkerBoundary(t){if(!this._activeMarkers)return;let e=-1;for(let l=this._activeMarkers.length-1;l>=0;l--)if(t>=this._activeMarkers[l].time){e=l;break}if(e===this._currentMarkerIndex||(this._currentMarkerIndex=e,e<0))return;let i=this._activeMarkers[e],r=this.getCurrentTrack();i.title&&this.titleEl&&this._setScrollText(this.titleEl,i.title),i.artist&&this.artistEl&&this._setScrollText(this.artistEl,i.artist);let a=this.waveformContainer?.querySelectorAll(".waveform-marker");if(a&&a.forEach((l,c)=>l.classList.toggle("wb-marker-active",c===e)),i.artwork){let l=this.barEl.querySelector(".wb-artwork");l&&(l.innerHTML=`<img src="${i.artwork}" alt="${i.title||""}" />`)}if(this.metaEl&&(i.bpm||i.key)){let l={...r||{},bpm:i.bpm||"",key:i.key||""};this._renderMeta(l)}this._emit("markerchange",{marker:i,index:e,track:r})}_updateVolumeUI(){this.volumeSliderEl&&(this.volumeSliderEl.value=this.isMuted?0:Math.round(this.volume*100)),this.muteBtnEl&&(this.isMuted||this.volume===0?(this.muteBtnEl.innerHTML=n.volMute,this.muteBtnEl.classList.add("wb-muted"),this.muteBtnEl.title="Unmute"):this.volume<.5?(this.muteBtnEl.innerHTML=n.volLow,this.muteBtnEl.classList.remove("wb-muted"),this.muteBtnEl.title="Mute"):(this.muteBtnEl.innerHTML=n.volHigh,this.muteBtnEl.classList.remove("wb-muted"),this.muteBtnEl.title="Mute"))}_detectTheme(){let t=document.documentElement,e=document.body,i=["dark","dark-mode","theme-dark"],r=["light","light-mode","theme-light"];for(let a of i)if(t.classList.contains(a)||e.classList.contains(a))return"dark";if(t.getAttribute("data-theme")==="dark"||e.getAttribute("data-theme")==="dark")return"dark";for(let a of r)if(t.classList.contains(a)||e.classList.contains(a))return"light";if(t.getAttribute("data-theme")==="light"||e.getAttribute("data-theme")==="light")return"light";try{let l=getComputedStyle(e).backgroundColor.match(/\d+/g);if(l&&l.length>=3){let c=(l[0]*299+l[1]*587+l[2]*114)/1e3;if(c>128)return"light";if(c<128)return"dark"}}catch{}return window.matchMedia?.("(prefers-color-scheme: light)").matches?"light":"dark"}_updateFavoriteUI(){if(!this.favBtnEl)return;let t=this.isFavorited();this.favBtnEl.innerHTML=t?n.heartFilled:n.heart,this.favBtnEl.classList.toggle("wb-fav-active",t)}_renderQueue(){B(this.queueBodyEl,this.queueCountEl,this.queue,this.currentIndex,{onSkipTo:t=>this.skipTo(t),onRemove:t=>this.removeFromQueue(t)})}_syncPageState(){let t=this.getCurrentTrack(),e=t?t.url:null;document.querySelectorAll("[data-wb-play]").forEach(i=>{let r=i.dataset.wbUrl||i.dataset.url,a=i.dataset.wbId||i.dataset.id||r,l=r&&r===e;i.classList.toggle("wb-current",l),i.classList.toggle("wb-playing",l&&this.isPlaying),i.classList.toggle("wb-favorited",this._favorites.has(a)),i.classList.toggle("wb-in-cart",this._cartItems.has(a))})}_seedFromAttributes(){let t=!1,e=!1;document.querySelectorAll("[data-wb-play]").forEach(i=>{let r=i.dataset.wbId||i.dataset.id||i.dataset.wbUrl||i.dataset.url;r&&(i.dataset.wbFavorited==="true"&&(this._favorites.add(r),t=!0),i.dataset.wbInCart==="true"&&(this._cartItems.add(r),e=!0))}),t&&p(this.config.storageKey,this._favorites)}_syncFavoriteAttributes(t,e){document.querySelectorAll("[data-wb-play]").forEach(i=>{(i.dataset.wbUrl||i.dataset.url)===t&&(i.dataset.wbFavorited=e?"true":"false",i.classList.toggle("wb-favorited",e))})}_syncCartAttributes(t,e){document.querySelectorAll("[data-wb-play]").forEach(i=>{(i.dataset.wbUrl||i.dataset.url)===t&&(i.dataset.wbInCart=e?"true":"false",i.classList.toggle("wb-in-cart",e))})}_saveState(){this.config.persist&&g(this.config.storageKey,{queue:this.queue,currentIndex:this.currentIndex,position:this._lastPosition||0,isPlaying:this.isPlaying})}_restoreState(){if(!this.config.persist)return;let t=w(this.config.storageKey);if(!t)return;this.queue=t.queue,this.currentIndex=t.currentIndex;let e=this.getCurrentTrack();if(e){if(this.show(),this._updateTrackDisplay(e),this._updateFavoriteUI(),this._updateNavButtons(),e.waveform&&(this.player.options.waveform=e.waveform),this.player.options.title=e.title||"",this.player.options.subtitle=e.artist||"",e.markers&&e.markers.length){let i=this.config.markerColor;this.player.options.markers=e.markers.map(r=>({...r,color:r.color||i})),this._activeMarkers=e.markers}else this.player.options.markers=[],this._activeMarkers=null;this._currentMarkerIndex=-1,this.player.load(e.url).then(()=>{if(this.player&&this.player.setVolume(this.isMuted?0:this.volume),t.isPlaying&&this.config.autoResume)try{let i=this.player.play();i&&typeof i.catch=="function"&&i.catch(()=>{this.isPlaying=!1,this._updatePlayButton(),this._syncPageState()})}catch{this.isPlaying=!1,this._updatePlayButton(),this._syncPageState()}t.position>0&&setTimeout(()=>{this.player&&(this.player.seekTo(t.position),this._lastPosition=t.position)},100)}).catch(()=>{}),this._renderQueue(),this._syncPageState()}}_restoreVolume(){let t=E(this.config.storageKey);t&&(this.volume=t.volume,this.isMuted=t.muted,this._volumeBeforeMute=t.volumeBeforeMute,this.player&&this.player.setVolume(this.isMuted?0:this.volume),this._updateVolumeUI())}_restoreFavorites(){this._favorites=_(this.config.storageKey)}};var C=new f;typeof window<"u"&&(window.WaveformBar=C);var W=C;})();
+            </div>`}}s.innerHTML=l,s.querySelectorAll(".wb-queue-item[data-qi]").forEach(o=>{o.addEventListener("click",c=>{c.target.closest(".wb-queue-remove")||r.onSkipTo&&r.onSkipTo(parseInt(o.dataset.qi))})}),s.querySelectorAll(".wb-queue-remove").forEach(o=>{o.addEventListener("click",c=>{c.stopPropagation(),r.onRemove&&r.onRemove(parseInt(o.dataset.qi))})})}var C={persist:!0,autoResume:!0,continuous:!0,repeat:"off",showRepeat:!0,showQueue:!0,showPrevNext:!0,showVolume:!0,showMute:!0,showMeta:!0,showTime:!0,showTrackLink:!0,maxMeta:3,defaultArtwork:null,theme:null,waveformStyle:"mirror",waveformHeight:32,barWidth:2,barSpacing:0,waveformColor:null,progressColor:null,markerColor:"rgba(255, 255, 255, 0.25)",volume:1,storageKey:"waveform-bar",actions:null,onPlay:null,onPause:null,onTrackChange:null,onQueueChange:null,onVolumeChange:null,onFavorite:null,onCart:null},f=class{constructor(){this.config=null,this.player=null,this.queue=[],this.currentIndex=-1,this.isPlaying=!1,this.isInitialized=!1,this.queueOpen=!1,this.volume=1,this.isMuted=!1,this._volumeBeforeMute=1,this._lastPosition=0,this._favorites=new Set,this._cartItems=new Set,this._observer=null,this._activeMarkers=null,this._currentMarkerIndex=-1,this.repeat="off",this.barEl=null,this.queueEl=null,this.waveformContainer=null,this.volumePopupEl=null,this.titleEl=null,this.artistEl=null,this.metaEl=null,this.playBtnEl=null,this.repeatBtnEl=null,this.queueBtnEl=null,this.queueBodyEl=null,this.queueCountEl=null,this.volumeSliderEl=null,this.muteBtnEl=null,this.favBtnEl=null,this.cartBtnEl=null,this.timeCurrentEl=null,this.timeTotalEl=null}init(t={}){return this.isInitialized&&this.destroy(),this.config={...C,...t},this.volume=this.config.volume,typeof window.WaveformPlayer>"u"?(console.error("WaveformBar: WaveformPlayer is required."),this):(this._createBar(),this._createQueue(),this._initPlayer(),this._bindTriggers(),this._observeDOM(),this.config.persist&&(this._restoreVolume(),this._restoreFavorites()),this._seedFromAttributes(),this.config.persist&&this._restoreState(),this.isInitialized=!0,this._beforeUnloadHandler=()=>this._saveState(),window.addEventListener("beforeunload",this._beforeUnloadHandler),this)}destroy(){return this.player&&(this.player.destroy(),this.player=null),this.barEl&&(this.barEl.remove(),this.barEl=null),this.queueEl&&(this.queueEl.remove(),this.queueEl=null),this._observer&&(this._observer.disconnect(),this._observer=null),this._beforeUnloadHandler&&(window.removeEventListener("beforeunload",this._beforeUnloadHandler),this._beforeUnloadHandler=null),document.querySelectorAll("[data-wb-play],[data-wb-queue]").forEach(t=>delete t._wbBound),document.querySelectorAll(".wb-current,.wb-playing").forEach(t=>t.classList.remove("wb-current","wb-playing")),this.queue=[],this.currentIndex=-1,this.isPlaying=!1,this.queueOpen=!1,this.isInitialized=!1,this.config=null,this}_createBar(){this.barEl=document.createElement("div"),this.barEl.className="waveform-bar";let t=this.config.theme||this._detectTheme();t==="light"&&this.barEl.classList.add("wb-light"),this._resolvedTheme=t,this.barEl.id="waveform-bar",this.barEl.innerHTML=k(this.config),document.body.appendChild(this.barEl),this.titleEl=this.barEl.querySelector(".wb-title"),this.artistEl=this.barEl.querySelector(".wb-artist"),this.metaEl=this.barEl.querySelector(".wb-meta"),this.playBtnEl=this.barEl.querySelector(".wb-play"),this.waveformContainer=this.barEl.querySelector(".wb-waveform-container"),this.queueBtnEl=this.barEl.querySelector(".wb-queue-btn"),this.muteBtnEl=this.barEl.querySelector(".wb-mute"),this.volumeSliderEl=this.barEl.querySelector(".wb-volume-slider"),this.favBtnEl=this.barEl.querySelector(".wb-fav"),this.cartBtnEl=this.barEl.querySelector(".wb-cart"),this.timeCurrentEl=this.barEl.querySelector(".wb-time-current"),this.timeTotalEl=this.barEl.querySelector(".wb-time-total"),this.playBtnEl.addEventListener("click",()=>this.togglePlay());let e=this.barEl.querySelector(".wb-prev"),i=this.barEl.querySelector(".wb-next");e&&e.addEventListener("click",()=>this.previous()),i&&i.addEventListener("click",()=>this.next()),this.repeatBtnEl=this.barEl.querySelector(".wb-repeat"),this.repeatBtnEl&&(this.repeat=this.config.repeat||"off",this._updateRepeatButton(),this.repeatBtnEl.addEventListener("click",()=>this.cycleRepeat())),this.queueBtnEl&&this.queueBtnEl.addEventListener("click",()=>this.toggleQueuePanel()),this.volumePopupEl=this.barEl.querySelector(".wb-volume-popup");let r=this.barEl.querySelector(".wb-volume");if(this.muteBtnEl&&this.muteBtnEl.addEventListener("click",a=>{a.stopPropagation(),this.toggleMute()}),r&&this.volumePopupEl){let a;r.addEventListener("mouseenter",()=>{clearTimeout(a),this.openVolumePopup()}),r.addEventListener("mouseleave",()=>{a=setTimeout(()=>this.closeVolumePopup(),300)})}this.volumeSliderEl&&this.volumeSliderEl.addEventListener("input",a=>{a.stopPropagation(),this.setVolume(parseInt(a.target.value)/100)}),document.addEventListener("click",a=>{this.volumePopupEl?.classList.contains("wb-volume-open")&&!this.barEl.querySelector(".wb-volume")?.contains(a.target)&&this.closeVolumePopup()}),this.favBtnEl&&this.favBtnEl.addEventListener("click",()=>this.toggleFavorite()),this.cartBtnEl&&this.cartBtnEl.addEventListener("click",()=>this.addToCart()),this.config.showTrackLink&&this.barEl.querySelector(".wb-track").addEventListener("click",()=>{let a=this.getCurrentTrack();a&&a.link&&(window.location.href=a.link)})}_createQueue(){this.config.showQueue&&(this.queueEl=q(),this._resolvedTheme==="light"&&this.queueEl.classList.add("wb-light"),document.body.appendChild(this.queueEl),this.queueBodyEl=this.queueEl.querySelector(".wb-queue-body"),this.queueCountEl=this.queueEl.querySelector(".wb-queue-count"),this.queueEl.querySelector(".wb-queue-clear").addEventListener("click",()=>this.clearQueue()),document.addEventListener("click",t=>{this.queueOpen&&!this.queueEl.contains(t.target)&&!this.queueBtnEl.contains(t.target)&&this.closeQueuePanel()}))}_initPlayer(){let t={showControls:!1,showInfo:!1,waveformStyle:this.config.waveformStyle,height:this.config.waveformHeight,barWidth:this.config.barWidth,barSpacing:this.config.barSpacing,singlePlay:!1,onPlay:()=>{this.isPlaying=!0,this._updatePlayButton(),this._syncPageState(),this._pumpExternalPlayState(!0);let e=this.getCurrentTrack();this._emit("play",{track:e}),this.config.onPlay&&this.config.onPlay(e)},onPause:()=>{this.isPlaying=!1,this._updatePlayButton(),this._syncPageState(),this._pumpExternalPlayState(!1),this._saveState();let e=this.getCurrentTrack();this._emit("pause",{track:e}),this.config.onPause&&this.config.onPause(e)},onEnd:()=>{if(this.isPlaying=!1,this._updatePlayButton(),this._syncPageState(),this._pumpExternalPlayState(!1),this.timeCurrentEl&&(this.timeCurrentEl.textContent="0:00"),this.repeat==="one"){this.player&&(this.player.seekTo(0),this.player.play().catch(()=>{}));return}this.config.continuous&&this.currentIndex<this.queue.length-1?(this.currentIndex++,this._loadCurrentTrack()):this.repeat==="all"&&this.queue.length>0&&(this.currentIndex=0,this._loadCurrentTrack())},onTimeUpdate:(e,i)=>{this._lastPosition=e,this.timeCurrentEl&&(this.timeCurrentEl.textContent=v(e)),this.timeTotalEl&&(this.timeTotalEl.textContent=v(i)),this._pumpExternalProgress(e,i),(!this._lastSaveTime||e-this._lastSaveTime>2)&&(this._lastSaveTime=e,this._saveState()),this._activeMarkers&&this._checkMarkerBoundary(e)},onLoad:null};this.config.waveformColor&&(t.waveformColor=this.config.waveformColor),this.config.progressColor&&(t.progressColor=this.config.progressColor),this.player=new window.WaveformPlayer(this.waveformContainer,t),this.player.setVolume(this.volume)}_bindTriggers(){document.querySelectorAll("[data-wb-play]").forEach(t=>{t._wbBound||(t._wbBound=!0,t.addEventListener("click",e=>{e.preventDefault();let i=p(t);i&&this.play(i)}))}),document.querySelectorAll("[data-wb-queue]").forEach(t=>{t._wbBound||(t._wbBound=!0,t.addEventListener("click",e=>{e.preventDefault(),e.stopPropagation();let i=p(t);i&&this.addToQueue(i)}))}),this._attachExternalPlayers()}_attachExternalPlayers(){this._externalListenersBound||(this._externalListenersBound=!0,document.addEventListener("waveformplayer:request-play",r=>{let a=r.detail;!a||!a.url||(r.preventDefault(),this.play(a))}),document.addEventListener("waveformplayer:request-pause",r=>{let a=r.detail;if(!a||!a.url)return;let l=this.getCurrentTrack();l&&l.url===a.url&&(r.preventDefault(),this.isPlaying&&this.togglePlay())}),document.addEventListener("waveformplayer:request-seek",r=>{let a=r.detail;if(!a||!a.url||typeof a.percent!="number")return;let l=this.getCurrentTrack();l&&l.url===a.url&&this.player&&this.player.audio&&(r.preventDefault(),this.player.seekToPercent(a.percent))}));let t=this._externalPlayers||new Map;this._externalPlayers=new Map;let e=window.WaveformPlayer;if(!e||!e.instances)return;let i=[];if(document.querySelectorAll('[data-waveform-player][data-audio-mode="external"]').forEach(r=>{let a=e.instances.get(r.id);if(!a||!a.options||!a.options.url)return;let l=a.options.url;this._externalPlayers.has(l)||this._externalPlayers.set(l,new Set),this._externalPlayers.get(l).add(a),t.get(l)&&t.get(l).has(a)||i.push({inst:a,url:l})}),i.length){let r=this.getCurrentTrack(),a=r?r.url:null;i.forEach(({inst:l,url:u})=>{let o=u===a;typeof l.setPlayingState=="function"&&l.setPlayingState(o&&this.isPlaying),o&&typeof l.setProgress=="function"&&this.player&&this.player.audio&&l.setProgress(this.player.audio.currentTime||0,this.player.audio.duration||0)})}}_pumpExternalPlayState(t){if(!this._externalPlayers||this._externalPlayers.size===0)return;let e=this.getCurrentTrack(),i=e?e.url:null;this._externalPlayers.forEach((r,a)=>{let l=a===i;r.forEach(u=>{typeof u.setPlayingState=="function"&&u.setPlayingState(l&&t)})})}_pumpExternalProgress(t,e){if(!this._externalPlayers||this._externalPlayers.size===0)return;let i=this.getCurrentTrack();if(!i)return;let r=this._externalPlayers.get(i.url);r&&r.forEach(a=>{typeof a.setProgress=="function"&&a.setProgress(t,e)})}_observeDOM(){typeof MutationObserver>"u"||(this._observer=new MutationObserver(()=>{this._bindTriggers(),this._syncPageState()}),this._observer.observe(document.body,{childList:!0,subtree:!0}))}play(t){let e=typeof t=="string"?{url:t,id:t,title:d(t)}:t;if(!e||!e.url)return this;let i=this.getCurrentTrack();if(i&&i.url===e.url)return this.togglePlay(),this;let r=this.queue.findIndex(a=>a.url===e.url);if(r>=0)this.queue[r]={...this.queue[r],...e},this.currentIndex=r;else{let a=this.currentIndex+1;this.queue.splice(a,0,e),this.currentIndex=a}return this._loadCurrentTrack(),this}addToQueue(t){let e=typeof t=="string"?{url:t,id:t,title:d(t)}:t;return!e||!e.url?this:this.queue.find(i=>i.url===e.url)?this:(this.queue.push(e),this._renderQueue(),this._saveState(),this._updateNavButtons(),this.currentIndex===-1&&(this.currentIndex=0,this._loadCurrentTrack()),this.config.onQueueChange&&this.config.onQueueChange(this.queue,this.currentIndex),this)}togglePlay(){return this.player?(this.isPlaying?this.player.pause():this.player.play(),this):this}pause(){return this.player&&this.isPlaying&&this.player.pause(),this}next(){return this.currentIndex<this.queue.length-1?(this.currentIndex++,this._loadCurrentTrack()):this.repeat==="all"&&this.queue.length>0&&(this.currentIndex=0,this._loadCurrentTrack()),this}previous(){return this.player&&this.player.audio&&this.player.audio.currentTime>3?(this.player.seekTo(0),this):(this.currentIndex>0?(this.currentIndex--,this._loadCurrentTrack()):this.repeat==="all"&&this.queue.length>0&&(this.currentIndex=this.queue.length-1,this._loadCurrentTrack()),this)}skipTo(t){return t<0||t>=this.queue.length?this:t===this.currentIndex?(this.togglePlay(),this):(this.currentIndex=t,this._loadCurrentTrack(),this)}seekToMarker(t){if(!this._activeMarkers||t<0||t>=this._activeMarkers.length)return this;let e=this._activeMarkers[t];return this.player&&(this.player.seekTo(e.time),this.isPlaying||this.togglePlay()),this}seekToMarkerByLabel(t){if(!this._activeMarkers)return this;let e=this._activeMarkers.findIndex(i=>(i.label||i.title||"").toLowerCase()===t.toLowerCase());return e>=0&&this.seekToMarker(e),this}setVolume(t){return this.volume=Math.max(0,Math.min(1,t)),this.isMuted=this.volume===0,this.player&&this.player.setVolume(this.volume),this._updateVolumeUI(),y(this.config.storageKey,this.volume,this.isMuted,this._volumeBeforeMute),this._emit("volumechange",{volume:this.volume}),this.config.onVolumeChange&&this.config.onVolumeChange(this.volume),this}getVolume(){return this.volume}toggleMute(){return this.isMuted?this.setVolume(this._volumeBeforeMute||1):(this._volumeBeforeMute=this.volume,this.isMuted=!0,this.player&&this.player.setVolume(0),this._updateVolumeUI()),this}toggleFavorite(){let t=this.getCurrentTrack();if(!t)return this;let e=t.id||t.url,i=this._favorites.has(e);return i?this._favorites.delete(e):this._favorites.add(e),this._updateFavoriteUI(),this._syncFavoriteAttributes(t.url,!i),m(this.config.storageKey,this._favorites),this._emit("favorite",{track:t,favorited:!i}),this.config.onFavorite&&this.config.onFavorite(t,!i),this.config.actions?.favorite&&b(this.config.actions.favorite,{action:"favorite",id:e,url:t.url,title:t.title,favorited:!i}),this}addToCart(){let t=this.getCurrentTrack();if(!t)return this;let e=t.id||t.url;return this._cartItems.add(e),this.cartBtnEl&&(this.cartBtnEl.classList.add("wb-action-done"),setTimeout(()=>this.cartBtnEl.classList.remove("wb-action-done"),1500)),this._syncCartAttributes(t.url,!0),this._emit("cart",{track:t}),this.config.onCart&&this.config.onCart(t),this.config.actions?.cart&&b(this.config.actions.cart,{action:"cart",id:e,url:t.url,title:t.title}),this}isFavorited(t){if(!t){let e=this.getCurrentTrack();t=e?e.id||e.url:null}return t?this._favorites.has(t):!1}isInCart(t){if(!t){let e=this.getCurrentTrack();t=e?e.id||e.url:null}return t?this._cartItems.has(t):!1}removeFromQueue(t){return t<0||t>=this.queue.length||t===this.currentIndex?this:(this.queue.splice(t,1),t<this.currentIndex&&this.currentIndex--,this._renderQueue(),this._saveState(),this._updateNavButtons(),this._emit("queuechange",{queue:this.queue,currentIndex:this.currentIndex}),this.config.onQueueChange&&this.config.onQueueChange(this.queue,this.currentIndex),this)}clearQueue(){let t=this.getCurrentTrack();return this.queue=t?[t]:[],this.currentIndex=t?0:-1,this._renderQueue(),this._saveState(),this._updateNavButtons(),this._emit("queuechange",{queue:this.queue,currentIndex:this.currentIndex}),this.config.onQueueChange&&this.config.onQueueChange(this.queue,this.currentIndex),this}getCurrentTrack(){return this.currentIndex>=0&&this.currentIndex<this.queue.length?this.queue[this.currentIndex]:null}getQueue(){return[...this.queue]}getCurrentIndex(){return this.currentIndex}isCurrentlyPlaying(t){let e=this.getCurrentTrack();return this.isPlaying&&e&&e.url===t}isCurrentTrack(t){let e=this.getCurrentTrack();return e&&e.url===t}getPlayer(){return this.player}_emit(t,e={}){this.barEl&&this.barEl.dispatchEvent(new CustomEvent("waveformbar:"+t,{bubbles:!0,detail:e}))}show(){return this.barEl&&this.barEl.classList.add("wb-active"),this}hide(){return this.barEl&&this.barEl.classList.remove("wb-active"),this.closeQueuePanel(),this.closeVolumePopup(),this}toggleQueuePanel(){return this.queueOpen?this.closeQueuePanel():this.openQueuePanel()}openQueuePanel(){if(!this.queueEl)return this;if(this.queueOpen=!0,this.closeVolumePopup(),this.queueBtnEl){let t=this.queueBtnEl.getBoundingClientRect();this.queueEl.style.right=window.innerWidth-t.right+"px"}return this.queueEl.classList.add("wb-queue-open"),this.queueBtnEl&&this.queueBtnEl.classList.add("wb-active"),this._renderQueue(),this}closeQueuePanel(){return this.queueEl?(this.queueOpen=!1,this.queueEl.classList.remove("wb-queue-open"),this.queueBtnEl&&this.queueBtnEl.classList.remove("wb-active"),this):this}toggleVolumePopup(){return this.volumePopupEl?.classList.contains("wb-volume-open")?this.closeVolumePopup():this.openVolumePopup(),this}openVolumePopup(){return this.volumePopupEl?(this.closeQueuePanel(),this.volumePopupEl.classList.add("wb-volume-open"),this.muteBtnEl&&this.muteBtnEl.classList.add("wb-active"),this):this}closeVolumePopup(){return this.volumePopupEl?(this.volumePopupEl.classList.remove("wb-volume-open"),this.muteBtnEl&&this.muteBtnEl.classList.remove("wb-active"),this):this}_loadCurrentTrack(){let t=this.getCurrentTrack();if(!t||!this.player)return;this._pumpExternalPlayState(!1),this.show(),this._updateTrackDisplay(t),this._updateFavoriteUI();let e={artwork:t.artwork,album:t.album};if(t.waveform&&(e.waveform=t.waveform),t.markers&&t.markers.length){let i=this.config.markerColor;e.markers=t.markers.map(r=>({...r,color:r.color||i}))}else e.markers=[];this.player.loadTrack(t.url,t.title,t.artist,e),this._activeMarkers=t.markers&&t.markers.length?t.markers:null,this._currentMarkerIndex=-1,this.player&&this.player.setVolume(this.isMuted?0:this.volume),this._renderQueue(),this._syncPageState(),this._saveState(),this._updateNavButtons(),this._emit("trackchange",{track:t,index:this.currentIndex}),this.config.onTrackChange&&this.config.onTrackChange(t,this.currentIndex)}_updateTrackDisplay(t){this.titleEl&&this._setScrollText(this.titleEl,t.title||"Untitled"),this.artistEl&&this._setScrollText(this.artistEl,t.artist||"");let e=this.barEl.querySelector(".wb-artwork");if(e){let r=t.artwork||this.config.defaultArtwork;e.innerHTML=r?`<img src="${h(r)}" alt="${h(t.title)}" />`:n.music}this.metaEl&&this.config.showMeta&&this._renderMeta(t);let i=this.barEl.querySelector(".wb-track");i&&(i.style.cursor=t.link?"pointer":"default"),this.timeCurrentEl&&(this.timeCurrentEl.textContent="0:00"),this.timeTotalEl&&(this.timeTotalEl.textContent="0:00")}_setScrollText(t,e){t.classList.remove("wb-scrolling"),t.textContent=e,requestAnimationFrame(()=>{if(t.scrollWidth>t.clientWidth){let i=t.scrollWidth-t.clientWidth,r=Math.max(4,i/20);t.innerHTML=`<span class="wb-scroll-inner">${h(e)}</span>`,t.style.setProperty("--wb-scroll-distance",`-${i+48}px`),t.style.setProperty("--wb-scroll-duration",`${r}s`),t.classList.add("wb-scrolling")}})}_renderMeta(t){if(!this.metaEl)return;let e=[];if(t.bpm&&e.push({label:t.bpm+" BPM",type:"bpm"}),t.key&&e.push({label:t.key,type:"key"}),t.duration&&e.push({label:t.duration,type:"duration"}),t.meta)for(let[r,a]of Object.entries(t.meta))a&&e.length<this.config.maxMeta&&e.push({label:String(a),type:r});let i=e.slice(0,this.config.maxMeta);this.metaEl.style.display=i.length?"flex":"none",this.metaEl.innerHTML=i.map(r=>`<span class="wb-tag wb-tag-${h(r.type)}">${h(r.label)}</span>`).join("")}_updatePlayButton(){if(!this.playBtnEl)return;let t=this.playBtnEl.querySelector(".wb-icon-play"),e=this.playBtnEl.querySelector(".wb-icon-pause");t&&(t.style.display=this.isPlaying?"none":"block"),e&&(e.style.display=this.isPlaying?"block":"none"),this.playBtnEl.title=this.isPlaying?"Pause":"Play"}_updateNavButtons(){let t=this.barEl?.querySelector(".wb-prev"),e=this.barEl?.querySelector(".wb-next");this.repeat==="all"?(t&&t.classList.remove("wb-disabled"),e&&e.classList.remove("wb-disabled")):(t&&t.classList.toggle("wb-disabled",this.currentIndex<=0),e&&e.classList.toggle("wb-disabled",this.currentIndex>=this.queue.length-1))}cycleRepeat(){let t=["off","all","one"],e=t.indexOf(this.repeat);return this.repeat=t[(e+1)%t.length],this._updateRepeatButton(),this._updateNavButtons(),this._emit("repeatchange",{mode:this.repeat}),this}setRepeat(t){return["off","all","one"].includes(t)&&(this.repeat=t,this._updateRepeatButton(),this._updateNavButtons(),this._emit("repeatchange",{mode:this.repeat})),this}_updateRepeatButton(){if(!this.repeatBtnEl)return;let t={off:n.repeatOff,all:n.repeatAll,one:n.repeatOne},e={off:"Repeat: Off",all:"Repeat: All",one:"Repeat: One"};this.repeatBtnEl.innerHTML=t[this.repeat],this.repeatBtnEl.title=e[this.repeat],this.repeatBtnEl.classList.toggle("wb-repeat-active",this.repeat!=="off")}_checkMarkerBoundary(t){if(!this._activeMarkers)return;let e=-1;for(let l=this._activeMarkers.length-1;l>=0;l--)if(t>=this._activeMarkers[l].time){e=l;break}if(e===this._currentMarkerIndex||(this._currentMarkerIndex=e,e<0))return;let i=this._activeMarkers[e],r=this.getCurrentTrack();i.title&&this.titleEl&&this._setScrollText(this.titleEl,i.title),i.artist&&this.artistEl&&this._setScrollText(this.artistEl,i.artist);let a=this.waveformContainer?.querySelectorAll(".waveform-marker");if(a&&a.forEach((l,u)=>l.classList.toggle("wb-marker-active",u===e)),i.artwork){let l=this.barEl.querySelector(".wb-artwork");l&&(l.innerHTML=`<img src="${i.artwork}" alt="${i.title||""}" />`)}if(this.metaEl&&(i.bpm||i.key)){let l={...r||{},bpm:i.bpm||"",key:i.key||""};this._renderMeta(l)}this._emit("markerchange",{marker:i,index:e,track:r})}_updateVolumeUI(){this.volumeSliderEl&&(this.volumeSliderEl.value=this.isMuted?0:Math.round(this.volume*100)),this.muteBtnEl&&(this.isMuted||this.volume===0?(this.muteBtnEl.innerHTML=n.volMute,this.muteBtnEl.classList.add("wb-muted"),this.muteBtnEl.title="Unmute"):this.volume<.5?(this.muteBtnEl.innerHTML=n.volLow,this.muteBtnEl.classList.remove("wb-muted"),this.muteBtnEl.title="Mute"):(this.muteBtnEl.innerHTML=n.volHigh,this.muteBtnEl.classList.remove("wb-muted"),this.muteBtnEl.title="Mute"))}_detectTheme(){let t=document.documentElement,e=document.body,i=["dark","dark-mode","theme-dark"],r=["light","light-mode","theme-light"];for(let a of i)if(t.classList.contains(a)||e.classList.contains(a))return"dark";if(t.getAttribute("data-theme")==="dark"||e.getAttribute("data-theme")==="dark")return"dark";for(let a of r)if(t.classList.contains(a)||e.classList.contains(a))return"light";if(t.getAttribute("data-theme")==="light"||e.getAttribute("data-theme")==="light")return"light";try{let l=getComputedStyle(e).backgroundColor.match(/\d+/g);if(l&&l.length>=3){let u=(l[0]*299+l[1]*587+l[2]*114)/1e3;if(u>128)return"light";if(u<128)return"dark"}}catch{}return window.matchMedia?.("(prefers-color-scheme: light)").matches?"light":"dark"}_updateFavoriteUI(){if(!this.favBtnEl)return;let t=this.isFavorited();this.favBtnEl.innerHTML=t?n.heartFilled:n.heart,this.favBtnEl.classList.toggle("wb-fav-active",t)}_renderQueue(){x(this.queueBodyEl,this.queueCountEl,this.queue,this.currentIndex,{onSkipTo:t=>this.skipTo(t),onRemove:t=>this.removeFromQueue(t)})}_syncPageState(){let t=this.getCurrentTrack(),e=t?t.url:null;document.querySelectorAll("[data-wb-play]").forEach(i=>{let r=i.dataset.wbUrl||i.dataset.url,a=i.dataset.wbId||i.dataset.id||r,l=r&&r===e;i.classList.toggle("wb-current",l),i.classList.toggle("wb-playing",l&&this.isPlaying),i.classList.toggle("wb-favorited",this._favorites.has(a)),i.classList.toggle("wb-in-cart",this._cartItems.has(a))})}_seedFromAttributes(){let t=!1,e=!1;document.querySelectorAll("[data-wb-play]").forEach(i=>{let r=i.dataset.wbId||i.dataset.id||i.dataset.wbUrl||i.dataset.url;r&&(i.dataset.wbFavorited==="true"&&(this._favorites.add(r),t=!0),i.dataset.wbInCart==="true"&&(this._cartItems.add(r),e=!0))}),t&&m(this.config.storageKey,this._favorites)}_syncFavoriteAttributes(t,e){document.querySelectorAll("[data-wb-play]").forEach(i=>{(i.dataset.wbUrl||i.dataset.url)===t&&(i.dataset.wbFavorited=e?"true":"false",i.classList.toggle("wb-favorited",e))})}_syncCartAttributes(t,e){document.querySelectorAll("[data-wb-play]").forEach(i=>{(i.dataset.wbUrl||i.dataset.url)===t&&(i.dataset.wbInCart=e?"true":"false",i.classList.toggle("wb-in-cart",e))})}_saveState(){this.config.persist&&g(this.config.storageKey,{queue:this.queue,currentIndex:this.currentIndex,position:this._lastPosition||0,isPlaying:this.isPlaying})}_restoreState(){if(!this.config.persist)return;let t=w(this.config.storageKey);if(!t)return;this.queue=t.queue,this.currentIndex=t.currentIndex;let e=this.getCurrentTrack();if(e){if(this.show(),this._updateTrackDisplay(e),this._updateFavoriteUI(),this._updateNavButtons(),e.waveform&&(this.player.options.waveform=e.waveform),this.player.options.title=e.title||"",this.player.options.subtitle=e.artist||"",e.markers&&e.markers.length){let i=this.config.markerColor;this.player.options.markers=e.markers.map(r=>({...r,color:r.color||i})),this._activeMarkers=e.markers}else this.player.options.markers=[],this._activeMarkers=null;this._currentMarkerIndex=-1,this.player.load(e.url).then(()=>{if(this.player&&this.player.setVolume(this.isMuted?0:this.volume),t.isPlaying&&this.config.autoResume)try{let i=this.player.play();i&&typeof i.catch=="function"&&i.catch(()=>{this.isPlaying=!1,this._updatePlayButton(),this._syncPageState()})}catch{this.isPlaying=!1,this._updatePlayButton(),this._syncPageState()}t.position>0&&setTimeout(()=>{this.player&&(this.player.seekTo(t.position),this._lastPosition=t.position)},100)}).catch(()=>{}),this._renderQueue(),this._syncPageState()}}_restoreVolume(){let t=E(this.config.storageKey);t&&(this.volume=t.volume,this.isMuted=t.muted,this._volumeBeforeMute=t.volumeBeforeMute,this.player&&this.player.setVolume(this.isMuted?0:this.volume),this._updateVolumeUI())}_restoreFavorites(){this._favorites=_(this.config.storageKey)}};var P=new f;typeof window<"u"&&(window.WaveformBar=P);var W=P;})();
 /**
  * WaveformBar v1.0.0
  * Persistent bottom audio player bar for WaveformPlayer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arraypress/waveform-bar",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "Persistent bottom audio player bar for WaveformPlayer - queue management, page persistence, and seamless playback.",
   "main": "dist/waveform-bar.js",
   "module": "dist/waveform-bar.esm.js",

package/src/js/core.js

@@ -311,6 +311,7 @@ export class WaveformBar {
                 this.isPlaying = true;
                 this._updatePlayButton();
                 this._syncPageState();
+                this._pumpExternalPlayState(true);
                 const track = this.getCurrentTrack();
                 this._emit('play', {track});
                 if (this.config.onPlay) this.config.onPlay(track);
@@ -319,6 +320,7 @@ export class WaveformBar {
                 this.isPlaying = false;
                 this._updatePlayButton();
                 this._syncPageState();
+                this._pumpExternalPlayState(false);
                 this._saveState();
                 const track = this.getCurrentTrack();
                 this._emit('pause', {track});
@@ -328,6 +330,7 @@ export class WaveformBar {
                 this.isPlaying = false;
                 this._updatePlayButton();
                 this._syncPageState();
+                this._pumpExternalPlayState(false);
 
                 // Reset time display
                 if (this.timeCurrentEl) this.timeCurrentEl.textContent = '0:00';
@@ -358,6 +361,11 @@ export class WaveformBar {
                 if (this.timeCurrentEl) this.timeCurrentEl.textContent = formatTime(currentTime);
                 if (this.timeTotalEl) this.timeTotalEl.textContent = formatTime(duration);
 
+                // Mirror progress into any external-mode WaveformPlayer
+                // instances tracking this URL — their canvases scrub in
+                // sync with the bar's audio.
+                this._pumpExternalProgress(currentTime, duration);
+
                 // Save state periodically during playback
                 if (!this._lastSaveTime || currentTime - this._lastSaveTime > 2) {
                     this._lastSaveTime = currentTime;
@@ -404,6 +412,149 @@ export class WaveformBar {
                 if (track) this.addToQueue(track);
             });
         });
+
+        // External-mode WaveformPlayer instances on the page act as
+        // visualization surfaces controlled by this bar — see the
+        // `audioMode: 'external'` option in @arraypress/waveform-player.
+        // Each instance dispatches `waveformplayer:request-play`
+        // (cancelable) when its play button is clicked; we route that
+        // into this bar so the audio always lives in one place.
+        this._attachExternalPlayers();
+    }
+
+    /**
+     * Discover external-mode WaveformPlayer instances and listen for
+     * their request-play / request-pause / request-seek events. Also
+     * builds a url → Set<WaveformPlayer> map used by _syncPageState()
+     * and the onTimeUpdate callback to push state into the matching
+     * inline visualizations.
+     *
+     * Idempotent — safe to call repeatedly. Late-mounted players are
+     * picked up by the MutationObserver in _observeDOM().
+     *
+     * @private
+     */
+    _attachExternalPlayers() {
+        // Document-level listeners only bind once.
+        if (!this._externalListenersBound) {
+            this._externalListenersBound = true;
+
+            document.addEventListener('waveformplayer:request-play', (e) => {
+                const t = e.detail;
+                if (!t || !t.url) return;
+                e.preventDefault();
+                this.play(t);
+            });
+
+            document.addEventListener('waveformplayer:request-pause', (e) => {
+                const t = e.detail;
+                if (!t || !t.url) return;
+                // Only honour pause when this is the currently-playing
+                // track — pause requests from other players are noise.
+                const current = this.getCurrentTrack();
+                if (current && current.url === t.url) {
+                    e.preventDefault();
+                    if (this.isPlaying) this.togglePlay();
+                }
+            });
+
+            document.addEventListener('waveformplayer:request-seek', (e) => {
+                const t = e.detail;
+                if (!t || !t.url || typeof t.percent !== 'number') return;
+                const current = this.getCurrentTrack();
+                if (current && current.url === t.url && this.player && this.player.audio) {
+                    e.preventDefault();
+                    this.player.seekToPercent(t.percent);
+                }
+            });
+        }
+
+        // Rebuild the URL → players map from scratch each pass — cheap
+        // (single querySelectorAll + Map insert) and avoids stale entries
+        // for players that have been torn down. Late-mounted players
+        // come in via the MutationObserver tick.
+        const previous = this._externalPlayers || new Map();
+        this._externalPlayers = new Map();
+        const WP = window.WaveformPlayer;
+        if (!WP || !WP.instances) return;
+
+        const newlyDiscovered = [];
+        document.querySelectorAll('[data-waveform-player][data-audio-mode="external"]').forEach((el) => {
+            const inst = WP.instances.get(el.id);
+            if (!inst || !inst.options || !inst.options.url) return;
+            const url = inst.options.url;
+            if (!this._externalPlayers.has(url)) this._externalPlayers.set(url, new Set());
+            this._externalPlayers.get(url).add(inst);
+            // Track players that weren't in the previous map — those need
+            // initial state seeded so cross-page navigation (bar already
+            // playing when an inline player mounts) syncs correctly.
+            const wasKnown = previous.get(url) && previous.get(url).has(inst);
+            if (!wasKnown) newlyDiscovered.push({inst, url});
+        });
+
+        // Seed newly-discovered players with current bar state. Without
+        // this, an inline player that mounts AFTER the bar is already
+        // playing would show "paused" until the next state event fires
+        // (which might never happen if the user just sits on the page).
+        if (newlyDiscovered.length) {
+            const current = this.getCurrentTrack();
+            const currentUrl = current ? current.url : null;
+            newlyDiscovered.forEach(({inst, url}) => {
+                const isCurrent = url === currentUrl;
+                if (typeof inst.setPlayingState === 'function') {
+                    inst.setPlayingState(isCurrent && this.isPlaying);
+                }
+                if (isCurrent && typeof inst.setProgress === 'function' && this.player && this.player.audio) {
+                    inst.setProgress(this.player.audio.currentTime || 0, this.player.audio.duration || 0);
+                }
+            });
+        }
+    }
+
+    /**
+     * Push playing-state into every external-mode player whose URL
+     * matches the currently playing track. Other URLs get set to
+     * false (paused) — covers the case where the bar switched tracks
+     * and the previously-current external player should stop showing
+     * its play indicator.
+     *
+     * @private
+     * @param {boolean} playing
+     */
+    _pumpExternalPlayState(playing) {
+        if (!this._externalPlayers || this._externalPlayers.size === 0) return;
+        const current = this.getCurrentTrack();
+        const currentUrl = current ? current.url : null;
+        this._externalPlayers.forEach((set, url) => {
+            const isCurrent = url === currentUrl;
+            set.forEach((player) => {
+                if (typeof player.setPlayingState === 'function') {
+                    player.setPlayingState(isCurrent && playing);
+                }
+            });
+        });
+    }
+
+    /**
+     * Push progress (currentTime + duration) into the external-mode
+     * player(s) tracking the current URL. Called on every timeupdate
+     * tick of the internal player.
+     *
+     * @private
+     * @param {number} currentTime
+     * @param {number} duration
+     */
+    _pumpExternalProgress(currentTime, duration) {
+        if (!this._externalPlayers || this._externalPlayers.size === 0) return;
+        const current = this.getCurrentTrack();
+        if (!current) return;
+        const set = this._externalPlayers.get(current.url);
+        if (!set) return;
+        set.forEach((player) => {
+            if (typeof player.setProgress === 'function') {
+                player.setProgress(currentTime, duration);
+            }
+        });
     }
 
     _observeDOM() {
@@ -826,6 +977,12 @@ export class WaveformBar {
         const track = this.getCurrentTrack();
         if (!track || !this.player) return;
 
+        // Reset any previously-current external player so its UI flips
+        // back to "paused" while the new track loads. The new track's
+        // onPlay callback will set the matching external to playing
+        // once playback actually starts.
+        this._pumpExternalPlayState(false);
+
         this.show();
         this._updateTrackDisplay(track);
         this._updateFavoriteUI();