@arraypress/waveform-player 1.24.4 → 1.25.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,10 +1,10 @@
1
- (()=>{function B(e){let t=-1/0;for(let i=0;i<e.length;i++)e[i]>t&&(t=e[i]);return t}function S(e){return String(e??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function O(e){return S(typeof e=="number"?`${e}px`:e)}function G(e){if(typeof e!="string"||e==="")return!1;try{let t=new URL(e,"http://localhost/");return t.protocol==="http:"||t.protocol==="https:"}catch{return!1}}function m(e,t=0,i=1){return Math.max(t,Math.min(e,i))}function ht(e){return e===void 0?void 0:e==="true"}function j(e){if(typeof e=="string"&&e.trim().startsWith("["))try{return JSON.parse(e)}catch{}return e}function H(e){let t={},i=(o,l=o)=>{let n=ht(e.dataset[l]);n!==void 0&&(t[o]=n)},r=(o,l=o,n=!1)=>{let h=e.dataset[l];h&&(t[o]=n?parseFloat(h):parseInt(h,10))},s=(o,l=o)=>{let n=e.dataset[l];n&&(t[o]=/^\d+(\.\d+)?$/.test(n.trim())?parseFloat(n):n)},a=(o,l=o)=>{let n=e.dataset[l];if(n)try{t[o]=JSON.parse(n)}catch(h){console.warn(`[WaveformPlayer] Invalid ${l} JSON:`,h)}};return e.dataset.src&&(t.url=e.dataset.src),e.dataset.url&&(t.url=e.dataset.url),r("height"),r("samples"),e.dataset.preload&&(t.preload=e.dataset.preload),e.dataset.crossOrigin&&(t.crossOrigin=e.dataset.crossOrigin),e.dataset.audioMode&&(t.audioMode=e.dataset.audioMode),e.dataset.style&&(t.waveformStyle=e.dataset.style),e.dataset.waveformStyle&&(t.waveformStyle=e.dataset.waveformStyle),e.dataset.waveformGradient&&(t.waveformGradient=e.dataset.waveformGradient),r("barWidth"),r("barSpacing"),r("barRadius"),e.dataset.buttonAlign&&(t.buttonAlign=e.dataset.buttonAlign),e.dataset.layout&&(t.layout=e.dataset.layout),e.dataset.buttonStyle&&(t.buttonStyle=e.dataset.buttonStyle),s("buttonSize"),s("buttonRadius"),e.dataset.colorPreset&&(t.colorPreset=e.dataset.colorPreset),e.dataset.waveformColor&&(t.waveformColor=j(e.dataset.waveformColor)),e.dataset.progressColor&&(t.progressColor=j(e.dataset.progressColor)),e.dataset.color&&(t.waveformColor=e.dataset.color),e.dataset.theme&&(t.colorPreset=e.dataset.theme),i("autoplay"),i("showControls"),i("showInfo"),i("showTime"),i("showHoverTime"),i("seekHandle"),i("showBPM","showBpm"),r("bpm"),i("singlePlay"),i("playOnSeek"),e.dataset.title&&(t.title=e.dataset.title),e.dataset.artist&&(t.artist=e.dataset.artist),e.dataset.album&&(t.album=e.dataset.album),e.dataset.artwork&&(t.artwork=e.dataset.artwork),e.dataset.artworkPosition&&(t.artworkPosition=e.dataset.artworkPosition),e.dataset.waveform&&(t.waveform=e.dataset.waveform),a("markers"),r("playbackRate","playbackRate",!0),i("showPlaybackSpeed"),a("playbackRates"),i("enableMediaSession"),i("showMarkers"),i("accessibleSeek"),e.dataset.seekLabel&&(t.seekLabel=e.dataset.seekLabel),e.dataset.seekValueText&&(t.seekValueText=e.dataset.seekValueText),e.dataset.errorText&&(t.errorText=e.dataset.errorText),e.dataset.playPauseLabel&&(t.playPauseLabel=e.dataset.playPauseLabel),e.dataset.speedLabel&&(t.speedLabel=e.dataset.speedLabel),e.dataset.artworkAlt&&(t.artworkAlt=e.dataset.artworkAlt),e.dataset.unknownTrackText&&(t.unknownTrackText=e.dataset.unknownTrackText),e.dataset.playIcon&&(t.playIcon=e.dataset.playIcon),e.dataset.pauseIcon&&(t.pauseIcon=e.dataset.pauseIcon),t}function J(e,...t){let i=0;return e.replace(/%(?:(\d+)\$)?s/g,(r,s)=>{let a=s?Number(s)-1:i++;return t[a]??r})}function E(e){let t=Number(e);if(!t||!Number.isFinite(t)||t<0)return"0:00";let i=Math.floor(t/3600),r=Math.floor(t%3600/60),s=Math.floor(t%60);return i>0?`${i}:${r.toString().padStart(2,"0")}:${s.toString().padStart(2,"0")}`:`${r}:${s.toString().padStart(2,"0")}`}var ct=0;function K(e){let t=e||"audio",i=5381;for(let r=0;r<t.length;r++)i=(i<<5)+i+t.charCodeAt(r)|0;return`wp_${(i>>>0).toString(36)}_${(ct++).toString(36)}`}function R(e){if(!e)return"Audio";let t=e.split("/");return t[t.length-1].split(".")[0].replace(/[-_]/g," ").replace(/\b\w/g,s=>s.toUpperCase())}function W(e){if(typeof e!="string")return null;let t=e.match(/rgba?\(\s*([\d.]+)\s*[,\s]\s*([\d.]+)\s*[,\s]\s*([\d.]+)\s*(?:[,/]\s*([\d.]+)(%?))?/i);if(!t)return null;let i=Number(t[1]),r=Number(t[2]),s=Number(t[3]);if(!Number.isFinite(i)||!Number.isFinite(r)||!Number.isFinite(s))return null;let a=t[4]===void 0?1:Number(t[4]);return Number.isFinite(a)?(t[5]==="%"&&(a/=100),{r:i,g:r,b:s,a:m(a,0,1)}):null}function Y(e){let t=W(e);return!t||t.a<=0?null:(t.r*299+t.g*587+t.b*114)/1e3}function I(...e){let t={};for(let i of e)for(let r in i)i[r]!==null&&i[r]!==void 0&&(t[r]=i[r]);return t}function X(e,t){let i;return function(...s){let a=()=>{clearTimeout(i),e(...s)};clearTimeout(i),i=setTimeout(a,t)}}function D(e,t){if(e.length===t)return e;if(e.length===0||t===0)return[];let i=[];if(t>e.length){let r=(e.length-1)/(t-1);for(let s=0;s<t;s++){let a=s*r,o=Math.floor(a),l=Math.ceil(a),n=a-o;if(l>=e.length)i.push(e[e.length-1]);else if(o===l)i.push(e[o]);else{let h=e[o]*(1-n)+e[l]*n;i.push(h)}}}else{let r=e.length/t;for(let s=0;s<t;s++){let a=Math.floor(s*r),o=Math.floor((s+1)*r),l=0,n=0;for(let h=a;h<=o&&h<e.length;h++)e[h]>l&&(l=e[h]),n++;if(n===0){let h=Math.min(Math.round(s*r),e.length-1);l=e[h]}i.push(l)}}return i}function T(e,t,i,r){if(!Array.isArray(t))return t;if(t.length<2)return t[0];let s=i.width,a=i.height,o=r&&r.waveformGradient,[l,n,h,c]=o==="horizontal"?[0,0,s,0]:o==="diagonal"?[0,0,s,a]:[0,0,0,a];try{let u=e.createLinearGradient(l,n,h,c);return t.forEach((w,g)=>u.addColorStop(g/(t.length-1),w)),u}catch{return t[0]}}function L(e,t,i,r,s,a){if((Array.isArray(a)?a.some(l=>l>0):a>0)&&typeof e.roundRect=="function"){let l=Math.min(r/2,Math.abs(s)/2),n=h=>m(h,0,l);e.beginPath(),e.roundRect(t,i,r,s,Array.isArray(a)?a.map(n):n(a)),e.fill()}else e.fillRect(t,i,r,s)}function et(e,t){return(e.barRadius||0)*t}function dt(e,t){let i=et(e,t);return[i,i,0,0]}function Q(e,t,i,r,s){let a=s/2;e.beginPath(),e.moveTo(t,r-a),e.lineTo(i-a,r-a),e.arc(i-a,r,a,-Math.PI/2,Math.PI/2),e.lineTo(t,r+a),e.arc(t,r,a,Math.PI/2,-Math.PI/2),e.closePath()}function F(e,t,i,r,s){let a=window.devicePixelRatio||1,o=s.barWidth*a,l=s.barSpacing*a,n=Math.floor(t.width/(o+l)),h=D(i,n),c=t.height,u=r*t.width,w=dt(s,a),g=T(e,s.color,t,s),k=T(e,s.progressColor,t,s);e.clearRect(0,0,t.width,t.height),e.fillStyle=g;for(let f=0;f<h.length;f++){let p=f*(o+l);if(p+o>t.width)break;let y=h[f]*c*.9,d=c-y;L(e,p,d,o,y,w)}e.save(),e.beginPath(),e.rect(0,0,u,c),e.clip(),e.fillStyle=k;for(let f=0;f<h.length;f++){let p=f*(o+l);if(p>u)break;let y=h[f]*c*.9,d=c-y;L(e,p,d,o,y,w)}e.restore()}function ut(e,t,i,r,s){let a=window.devicePixelRatio||1,o=s.barWidth*a,l=s.barSpacing*a,n=Math.floor(t.width/(o+l)),h=D(i,n),c=t.height,u=c/2,w=r*t.width,g=et(s,a),k=[g,g,0,0],f=[0,0,g,g],p=T(e,s.color,t,s),y=T(e,s.progressColor,t,s);e.clearRect(0,0,t.width,t.height),e.fillStyle=p;for(let d=0;d<h.length;d++){let b=d*(o+l);if(b+o>t.width)break;let v=h[d]*c*.45;L(e,b,u-v,o,v,k),L(e,b,u,o,v,f)}e.save(),e.beginPath(),e.rect(0,0,w,c),e.clip(),e.fillStyle=y;for(let d=0;d<h.length;d++){let b=d*(o+l);if(b>w)break;let v=h[d]*c*.45;L(e,b,u-v,o,v,k),L(e,b,u,o,v,f)}e.restore()}function pt(e,t,i,r,s){let a=t.width,o=t.height,l=o/2,n=o*.35;e.clearRect(0,0,a,o);let h=(c,u,w=1,g=!1)=>{let k=T(e,c,t,s),f=Array.isArray(c)?c[c.length-1]:c;g&&(e.shadowBlur=12,e.shadowColor=f),e.strokeStyle=k,e.lineWidth=u,e.lineCap="round",e.lineJoin="round",e.beginPath(),e.moveTo(0,l);let p=[],y=Math.floor(i.length*w);for(let d=0;d<y;d++){let b=d/(i.length-1)*a,v=i[d],A=Math.sin(d*.1)*v,C=l+A*n;p.push({x:b,y:C})}for(let d=0;d<p.length-1;d++){let b=p[d].x+(p[d+1].x-p[d].x)*.5,v=p[d].y,A=p[d+1].x-(p[d+1].x-p[d].x)*.5,C=p[d+1].y;e.bezierCurveTo(b,v,A,C,p[d+1].x,p[d+1].y)}e.stroke(),g&&(e.shadowBlur=0)};e.strokeStyle="rgba(255, 255, 255, 0.03)",e.lineWidth=.5,e.beginPath(),e.moveTo(0,l),e.lineTo(a,l),e.stroke();for(let c=0;c<=10;c++){let u=a/10*c;e.beginPath(),e.moveTo(u,0),e.lineTo(u,o),e.stroke()}h(s.color,2,1,!1),r>0&&h(s.progressColor,3,r,!0)}function Z(e,t,i,r,s){let a=window.devicePixelRatio||1,o=(s.barWidth||3)*a,l=(s.barSpacing||1)*a,n=Math.floor(t.width/(o+l)),h=D(i,n),c=t.height,u=4*a,w=2*a,g=r*t.width,k=c/2,f=T(e,s.color,t,s),p=T(e,s.progressColor,t,s);e.clearRect(0,0,t.width,t.height);for(let y=0;y<h.length;y++){let d=y*(o+l);if(d+o>t.width)break;let b=h[y]*c*.9,v=Math.floor(b/(u+w));e.fillStyle=d<g?p:f;for(let A=0;A<v;A++){let C=A*(u+w);e.fillRect(d,k-C-u,o,u),A>0&&e.fillRect(d,k+C,o,u)}}}function tt(e,t,i,r,s){let a=window.devicePixelRatio||1,o=(s.barWidth||2)*a,l=(s.barSpacing||3)*a,n=Math.floor(t.width/(o+l)),h=D(i,n),c=t.height,u=Math.max(1.5*a,o/2),w=r*t.width,g=c/2,k=T(e,s.color,t,s),f=T(e,s.progressColor,t,s);e.clearRect(0,0,t.width,t.height);for(let p=0;p<h.length;p++){let y=p*(o+l)+o/2;if(y>t.width)break;let d=h[p]*c*.9;e.fillStyle=y<w?f:k,e.beginPath(),e.arc(y,g-d/2,u,0,Math.PI*2),e.fill(),e.beginPath(),e.arc(y,g+d/2,u,0,Math.PI*2),e.fill()}}function ft(e,t,i,r,s){let a=t.width,o=t.height,l=o/2,n=4,h=n/2,c=!!s.seekActive;if(e.clearRect(0,0,a,o),e.fillStyle=T(e,s.color,t,s)||"rgba(255, 255, 255, 0.2)",Q(e,h,a,l,n),e.fill(),r>0){let u=Math.max(h*2,r*a);e.save(),e.globalAlpha=s.seekHandle&&!c?.7:1,e.fillStyle=T(e,s.progressColor,t,s)||"rgba(255, 255, 255, 0.9)",Q(e,h,u,l,n),e.fill(),e.restore()}}var mt={bars:F,bar:F,mirror:ut,line:pt,blocks:Z,block:Z,dots:tt,dot:tt,seekbar:ft};function it(e,t,i,r,s){(mt[s.waveformStyle]||F)(e,t,i,r,s)}function st(e){try{let t=e.getChannelData(0),i=e.sampleRate,r=gt(t,i);if(r.length<2)return 120;let s=[];for(let n=1;n<r.length;n++)s.push((r[n]-r[n-1])/i);let a={};s.forEach(n=>{let h=60/n,c=Math.round(h/3)*3;c>60&&c<200&&(a[c]=(a[c]||0)+1)});let o=0,l=120;for(let[n,h]of Object.entries(a))h>o&&(o=h,l=parseInt(n));return l<70&&a[l*2]?l*=2:l>160&&a[Math.round(l/2)]&&(l=Math.round(l/2)),l-1}catch(t){return console.warn("[WaveformPlayer] BPM detection failed:",t),null}}function gt(e,t){let s=[],a=0;for(let o=0;o<e.length-2048;o+=1024){let l=0;for(let c=o;c<o+2048;c++)l+=e[c]*e[c];l=l/2048;let n=l-a,h=a*1.8+.01;if(n>h&&l>.01){let c=s[s.length-1]||0,u=t*.15;o-c>u&&s.push(o)}a=l*.8+a*.2}return s}function yt(e,t=1800){let i=e.length/t,r=e.numberOfChannels,s=[];for(let o=0;o<r;o++){let l=e.getChannelData(o);for(let n=0;n<t;n++){let h=~~(n*i),c=~~(h+i),u=0,w=0;for(let k=h;k<c;k++){let f=l[k];f>w&&(w=f),f<u&&(u=f)}let g=Math.max(Math.abs(w),Math.abs(u));(o===0||g>s[n])&&(s[n]=g)}}let a=B(s);return a>0?s.map(o=>o/a):s}async function $(e,t=1800,i=!1){let r;try{let s=window.AudioContext||window.webkitAudioContext;r=new s;let o=await(await fetch(e)).arrayBuffer(),l=await r.decodeAudioData(o),n=yt(l,t);n=wt(n);let h=null;return i&&(h=st(l)),{peaks:n,bpm:h}}finally{r&&r.close()}}function rt(e=1800){let t=[];for(let i=0;i<e;i++){let r=Math.random()*.5+.3,s=Math.sin(i/e*Math.PI*4)*.2;t.push(m(r+s,.1,1))}return t}function wt(e,t=.95){let i=B(e);if(i===0||i>t)return e;let r=t/i;return e.map(s=>s*r)}var z=128;function at(e){let t=document.documentElement,i=document.body;return t.classList.contains(e)||t.classList.contains(`${e}-mode`)||t.classList.contains(`theme-${e}`)||t.getAttribute("data-theme")===e||t.getAttribute("data-color-scheme")===e||i.classList.contains(e)||i.classList.contains(`${e}-mode`)||i.getAttribute("data-theme")===e}function kt(e){let t=0,i=0;for(let r=e;r&&r.nodeType===1&&i<.995;r=r.parentElement){let s=W(getComputedStyle(r).backgroundColor);if(!s||s.a<=0)continue;let a=s.a*(1-i);t+=(s.r*299+s.g*587+s.b*114)/1e3*a,i+=a}return{sum:t,alpha:i}}function bt(){let e=Y(getComputedStyle(document.body).color);if(e!==null)return e>z?"dark":"light";if(window.matchMedia){if(window.matchMedia("(prefers-color-scheme: dark)").matches)return"dark";if(window.matchMedia("(prefers-color-scheme: light)").matches)return"light"}return"dark"}function x(e){if(at("dark"))return"dark";if(at("light"))return"light";try{let t=e&&e.nodeType===1?e:document.body,{sum:i,alpha:r}=kt(t),s=bt(),a=i+(s==="dark"?0:255)*(1-r);return a>z?"light":a<z?"dark":s}catch{return"dark"}}var _={dark:{waveformColor:"rgba(255, 255, 255, 0.3)",progressColor:"rgba(255, 255, 255, 0.9)"},light:{waveformColor:"rgba(0, 0, 0, 0.2)",progressColor:"rgba(0, 0, 0, 0.8)"}};function N(e,t){if(e&&_[e])return _[e];let i=x(t);return _[i]}var q={url:"",height:64,samples:1800,preload:"metadata",crossOrigin:null,audioMode:"self",playbackRate:1,showPlaybackSpeed:!1,playbackRates:[.5,.75,1,1.25,1.5,1.75,2],buttonAlign:"auto",layout:"default",buttonStyle:"circle",buttonSize:null,buttonRadius:null,waveformStyle:"mirror",barWidth:2,barSpacing:0,barRadius:1,waveformGradient:"vertical",colorPreset:null,waveformColor:null,progressColor:null,autoplay:!1,showControls:!0,showInfo:!0,showTime:!0,showHoverTime:!1,seekHandle:!1,showBPM:!1,bpm:null,singlePlay:!0,playOnSeek:!0,enableMediaSession:!0,markers:[],showMarkers:!0,accessibleSeek:!0,seekLabel:null,seekValueText:null,title:null,artist:null,artwork:null,artworkPosition:"info",album:"",errorText:"Unable to load audio",playPauseLabel:"Play/Pause",speedLabel:"Playback speed",artworkAlt:"Album artwork",unknownTrackText:"Unknown Track",playIcon:'<svg viewBox="0 0 24 24" width="16" height="16"><path d="M8 5v14l11-7z"/></svg>',pauseIcon:'<svg viewBox="0 0 24 24" width="16" height="16"><path d="M6 4h4v16H6zM14 4h4v16h-4z"/></svg>',onLoad:null,onPlay:null,onPause:null,onEnd:null,onError:null,onTimeUpdate:null,onNextTrack:null,onPreviousTrack:null},ot={bars:{barWidth:3,barSpacing:1},mirror:{barWidth:2,barSpacing:2},line:{barWidth:2,barSpacing:0},blocks:{barWidth:4,barSpacing:2},dots:{barWidth:3,barSpacing:3},seekbar:{barWidth:1,barSpacing:0}};var vt="data:image/svg+xml,"+encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><rect width="24" height="24" rx="4" fill="#71717a" fill-opacity="0.15"/><g fill="none" stroke="#a1a1aa" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><circle cx="8" cy="17" r="2.2"/><circle cx="17" cy="15" r="2.2"/><path d="M10.2 17V7l9-1.6v9"/></g></svg>'),nt=5,lt=10,St='button, a[href], input, [role="slider"]',Et=["auto","top","center","bottom"],P=class e{static instances=new Map;static currentlyPlaying=null;constructor(t,i={}){if(this.container=typeof t=="string"?document.querySelector(t):t,!this.container)throw new Error("[WaveformPlayer] Container element not found");let r=H(this.container),s={...i};s.style&&!s.waveformStyle&&(s.waveformStyle=s.style),s.src&&!s.url&&(s.url=s.src),this.options=I(q,r,s);let a=N(this.options.colorPreset,this.container);this._autoTheme=this.options.colorPreset==null||!_[this.options.colorPreset],this._presetKeys=[],this._scheme=this.options.colorPreset&&_[this.options.colorPreset]?this.options.colorPreset:x(this.container);for(let[l,n]of Object.entries(a))(this.options[l]===null||this.options[l]===void 0)&&(this.options[l]=n,this._presetKeys.push(l));let o=ot[this.options.waveformStyle];o&&(r.barWidth===void 0&&i.barWidth===void 0&&(this.options.barWidth=o.barWidth),r.barSpacing===void 0&&i.barSpacing===void 0&&(this.options.barSpacing=o.barSpacing)),this.audio=null,this.canvas=null,this.ctx=null,this.waveformData=[],this.progress=0,this._activeMarkerIndex=-1,this._markerLabelTimer=null,this.isPlaying=!1,this.isLoading=!1,this.hasError=!1,this.updateTimer=null,this.resizeObserver=null,this._ac=new AbortController,this.id=this.container.id||K(this.options.url),e.instances.set(this.id,this),e._watchTheme(),this.init(),setTimeout(()=>{this._emit("waveformplayer:ready",{player:this,url:this.options.url})},100)}_emit(t,i,r=!1){let s=new CustomEvent(t,{bubbles:!0,cancelable:r,detail:i});return this.container.dispatchEvent(s),s}_requestSeek(t){this._emit("waveformplayer:request-seek",{...this._buildTrackDetail(),percent:t},!0).defaultPrevented||(this.progress=t,this.drawWaveform?.())}init(){this.createDOM(),this.createAudio(),this.initPlaybackSpeed(),this.initKeyboardControls(),this.initSeekControl(),this.bindEvents(),this.setupResizeObserver(),requestAnimationFrame(()=>{this.resizeCanvas(),this.options.url&&this.load(this.options.url).then(()=>{this.options.autoplay&&this.play()?.catch(()=>{})}).catch(t=>{console.error("[WaveformPlayer] Failed to load audio:",t)})})}createDOM(){this.container.innerHTML="",this.container.className="waveform-player";let t=Et.includes(this.options.buttonAlign)?this.options.buttonAlign:"auto";t==="auto"&&(this.options.waveformStyle==="bars"?t="bottom":t="center"),this.options.layout==="preview"&&this.container.classList.add("waveform-layout-preview"),this.container.classList.toggle("waveform-theme-light",this._scheme==="light");let r=[];this.options.buttonSize!=null&&r.push(`--wfp-btn-size: ${O(this.options.buttonSize)}`),this.options.buttonRadius!=null&&r.push(`--wfp-btn-radius: ${O(this.options.buttonRadius)}`);let s=r.length?` style="${r.join("; ")};"`:"",a=this.options.artworkPosition==="button"&&this.options.artwork,o=a?`<img class="waveform-btn-artwork" src="${S(this.options.artwork)}" alt="" aria-hidden="true">`:"",l=this.options.showControls?`
2
- <button class="waveform-btn${this.options.buttonStyle==="minimal"?" waveform-btn-minimal":""}${a?" waveform-btn-has-artwork":""}" aria-label="${S(this.options.playPauseLabel)}"${s}>
1
+ (()=>{function $(e){let t=-1/0;for(let i=0;i<e.length;i++)e[i]>t&&(t=e[i]);return t}function S(e){return String(e??"").replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#39;")}function q(e){return S(typeof e=="number"?`${e}px`:e)}function st(e){if(typeof e!="string"||e==="")return!1;try{let t=new URL(e,"http://localhost/");return t.protocol==="http:"||t.protocol==="https:"}catch{return!1}}function m(e,t=0,i=1){return Math.max(t,Math.min(e,i))}function _(e,t=null,i={}){let{min:s=-1/0,max:r=1/0,integer:a=!1}=i,o=typeof e=="number"?e:typeof e=="string"&&e.trim()!==""?Number(e):NaN;if(!Number.isFinite(o))return t;let n=m(o,s,r);return a?Math.round(n):n}function H(e,t=null){if(Array.isArray(e))return e;if(typeof e=="string"&&e.trim().startsWith("["))try{let i=JSON.parse(e);if(Array.isArray(i))return i}catch{}return t}function D(e,t={}){let{min:i=-1/0,max:s=1/0,fallback:r=null}=t,a=H(e);if(!a&&typeof e=="string"&&e.trim()!==""&&(a=e.split(/[,\s]+/)),!a)return r;let o=a.map(n=>_(n)).filter(n=>n!==null&&n>=i&&n<=s);return o.length?o:r}function rt(e,t,i=null){return t.includes(e)?e:i}function at(e){if(typeof e=="string"){let t=e.trim().toLowerCase();return t!==""&&t!=="false"&&t!=="0"}return!!e}function kt(e){return e===void 0?void 0:e==="true"}function it(e){if(typeof e=="string"&&e.trim().startsWith("["))try{return JSON.parse(e)}catch{}return e}function O(e){let t={},i=(o,n=o)=>{let l=kt(e.dataset[n]);l!==void 0&&(t[o]=l)},s=(o,n=o,l=!1)=>{let h=e.dataset[n];h&&(t[o]=l?parseFloat(h):parseInt(h,10))},r=(o,n=o)=>{let l=e.dataset[n];l&&(t[o]=/^\d+(\.\d+)?$/.test(l.trim())?parseFloat(l):l)},a=(o,n=o)=>{let l=e.dataset[n];if(!l)return;let h=H(l);h?t[o]=h:console.warn(`[WaveformPlayer] Invalid ${n} attribute, expected a JSON array:`,l)};if(e.dataset.src&&(t.url=e.dataset.src),e.dataset.url&&(t.url=e.dataset.url),s("height"),s("samples"),e.dataset.preload&&(t.preload=e.dataset.preload),e.dataset.crossOrigin&&(t.crossOrigin=e.dataset.crossOrigin),e.dataset.audioMode&&(t.audioMode=e.dataset.audioMode),e.dataset.style&&(t.waveformStyle=e.dataset.style),e.dataset.waveformStyle&&(t.waveformStyle=e.dataset.waveformStyle),e.dataset.waveformGradient&&(t.waveformGradient=e.dataset.waveformGradient),s("barWidth"),s("barSpacing"),s("barRadius"),e.dataset.buttonAlign&&(t.buttonAlign=e.dataset.buttonAlign),e.dataset.layout&&(t.layout=e.dataset.layout),e.dataset.buttonStyle&&(t.buttonStyle=e.dataset.buttonStyle),r("buttonSize"),r("buttonRadius"),e.dataset.colorPreset&&(t.colorPreset=e.dataset.colorPreset),e.dataset.waveformColor&&(t.waveformColor=it(e.dataset.waveformColor)),e.dataset.progressColor&&(t.progressColor=it(e.dataset.progressColor)),e.dataset.color&&(t.waveformColor=e.dataset.color),e.dataset.theme&&(t.colorPreset=e.dataset.theme),i("autoplay"),i("showControls"),i("showInfo"),i("showTime"),i("showHoverTime"),i("seekHandle"),i("showBPM","showBpm"),s("bpm"),i("singlePlay"),i("playOnSeek"),e.dataset.title&&(t.title=e.dataset.title),e.dataset.artist&&(t.artist=e.dataset.artist),e.dataset.album&&(t.album=e.dataset.album),e.dataset.artwork&&(t.artwork=e.dataset.artwork),e.dataset.artworkPosition&&(t.artworkPosition=e.dataset.artworkPosition),e.dataset.waveform&&(t.waveform=e.dataset.waveform),a("markers"),s("playbackRate","playbackRate",!0),i("showPlaybackSpeed"),e.dataset.playbackRates){let o=D(e.dataset.playbackRates);o?t.playbackRates=o:console.warn("[WaveformPlayer] Invalid playbackRates attribute:",e.dataset.playbackRates)}return i("enableMediaSession"),i("showMarkers"),i("accessibleSeek"),e.dataset.seekLabel&&(t.seekLabel=e.dataset.seekLabel),e.dataset.seekValueText&&(t.seekValueText=e.dataset.seekValueText),e.dataset.errorText&&(t.errorText=e.dataset.errorText),e.dataset.playPauseLabel&&(t.playPauseLabel=e.dataset.playPauseLabel),e.dataset.speedLabel&&(t.speedLabel=e.dataset.speedLabel),e.dataset.artworkAlt&&(t.artworkAlt=e.dataset.artworkAlt),e.dataset.unknownTrackText&&(t.unknownTrackText=e.dataset.unknownTrackText),e.dataset.playIcon&&(t.playIcon=e.dataset.playIcon),e.dataset.pauseIcon&&(t.pauseIcon=e.dataset.pauseIcon),t}function ot(e,...t){let i=0;return e.replace(/%(?:(\d+)\$)?s/g,(s,r)=>{let a=r?Number(r)-1:i++;return t[a]??s})}function E(e){let t=Number(e);if(!t||!Number.isFinite(t)||t<0)return"0:00";let i=Math.floor(t/3600),s=Math.floor(t%3600/60),r=Math.floor(t%60);return i>0?`${i}:${s.toString().padStart(2,"0")}:${r.toString().padStart(2,"0")}`:`${s}:${r.toString().padStart(2,"0")}`}var vt=0;function nt(e){let t=e||"audio",i=5381;for(let s=0;s<t.length;s++)i=(i<<5)+i+t.charCodeAt(s)|0;return`wp_${(i>>>0).toString(36)}_${(vt++).toString(36)}`}function I(e){if(!e)return"Audio";let t=e.split("/");return t[t.length-1].split(".")[0].replace(/[-_]/g," ").replace(/\b\w/g,r=>r.toUpperCase())}function U(e){if(typeof e!="string")return null;let t=e.match(/rgba?\(\s*([\d.]+)\s*[,\s]\s*([\d.]+)\s*[,\s]\s*([\d.]+)\s*(?:[,/]\s*([\d.]+)(%?))?/i);if(!t)return null;let i=Number(t[1]),s=Number(t[2]),r=Number(t[3]);if(!Number.isFinite(i)||!Number.isFinite(s)||!Number.isFinite(r))return null;let a=t[4]===void 0?1:Number(t[4]);return Number.isFinite(a)?(t[5]==="%"&&(a/=100),{r:i,g:s,b:r,a:m(a,0,1)}):null}function lt(e){let t=U(e);return!t||t.a<=0?null:(t.r*299+t.g*587+t.b*114)/1e3}function j(...e){let t={};for(let i of e)for(let s in i)i[s]!==null&&i[s]!==void 0&&(t[s]=i[s]);return t}function ht(e,t){let i;return function(...r){let a=()=>{clearTimeout(i),e(...r)};clearTimeout(i),i=setTimeout(a,t)}}function B(e,t){if(e.length===t)return e;if(e.length===0||t===0)return[];let i=[];if(t>e.length){let s=(e.length-1)/(t-1);for(let r=0;r<t;r++){let a=r*s,o=Math.floor(a),n=Math.ceil(a),l=a-o;if(n>=e.length)i.push(e[e.length-1]);else if(o===n)i.push(e[o]);else{let h=e[o]*(1-l)+e[n]*l;i.push(h)}}}else{let s=e.length/t;for(let r=0;r<t;r++){let a=Math.floor(r*s),o=Math.floor((r+1)*s),n=0,l=0;for(let h=a;h<=o&&h<e.length;h++)e[h]>n&&(n=e[h]),l++;if(l===0){let h=Math.min(Math.round(r*s),e.length-1);n=e[h]}i.push(n)}}return i}function P(e,t,i,s){if(!Array.isArray(t))return t;if(t.length<2)return t[0];let r=i.width,a=i.height,o=s&&s.waveformGradient,[n,l,h,c]=o==="horizontal"?[0,0,r,0]:o==="diagonal"?[0,0,r,a]:[0,0,0,a];try{let d=e.createLinearGradient(n,l,h,c);return t.forEach((b,y)=>d.addColorStop(y/(t.length-1),b)),d}catch{return t[0]}}function x(e,t,i,s,r,a){if((Array.isArray(a)?a.some(n=>n>0):a>0)&&typeof e.roundRect=="function"){let n=Math.min(s/2,Math.abs(r)/2),l=h=>m(h,0,n);e.beginPath(),e.roundRect(t,i,s,r,Array.isArray(a)?a.map(l):l(a)),e.fill()}else e.fillRect(t,i,s,r)}function pt(e,t){return(e.barRadius||0)*t}function St(e,t){let i=pt(e,t);return[i,i,0,0]}function ct(e,t,i,s,r){let a=r/2;e.beginPath(),e.moveTo(t,s-a),e.lineTo(i-a,s-a),e.arc(i-a,s,a,-Math.PI/2,Math.PI/2),e.lineTo(t,s+a),e.arc(t,s,a,Math.PI/2,-Math.PI/2),e.closePath()}function V(e,t,i,s,r){let a=window.devicePixelRatio||1,o=r.barWidth*a,n=r.barSpacing*a,l=Math.floor(t.width/(o+n)),h=B(i,l),c=t.height,d=s*t.width,b=St(r,a),y=P(e,r.color,t,r),w=P(e,r.progressColor,t,r);e.clearRect(0,0,t.width,t.height),e.fillStyle=y;for(let f=0;f<h.length;f++){let p=f*(o+n);if(p+o>t.width)break;let g=h[f]*c*.9,u=c-g;x(e,p,u,o,g,b)}e.save(),e.beginPath(),e.rect(0,0,d,c),e.clip(),e.fillStyle=w;for(let f=0;f<h.length;f++){let p=f*(o+n);if(p>d)break;let g=h[f]*c*.9,u=c-g;x(e,p,u,o,g,b)}e.restore()}function Et(e,t,i,s,r){let a=window.devicePixelRatio||1,o=r.barWidth*a,n=r.barSpacing*a,l=Math.floor(t.width/(o+n)),h=B(i,l),c=t.height,d=c/2,b=s*t.width,y=pt(r,a),w=[y,y,0,0],f=[0,0,y,y],p=P(e,r.color,t,r),g=P(e,r.progressColor,t,r);e.clearRect(0,0,t.width,t.height),e.fillStyle=p;for(let u=0;u<h.length;u++){let k=u*(o+n);if(k+o>t.width)break;let v=h[u]*c*.45;x(e,k,d-v,o,v,w),x(e,k,d,o,v,f)}e.save(),e.beginPath(),e.rect(0,0,b,c),e.clip(),e.fillStyle=g;for(let u=0;u<h.length;u++){let k=u*(o+n);if(k>b)break;let v=h[u]*c*.45;x(e,k,d-v,o,v,w),x(e,k,d,o,v,f)}e.restore()}function Pt(e,t,i,s,r){let a=t.width,o=t.height,n=o/2,l=o*.35;e.clearRect(0,0,a,o);let h=(c,d,b=1,y=!1)=>{let w=P(e,c,t,r),f=Array.isArray(c)?c[c.length-1]:c;y&&(e.shadowBlur=12,e.shadowColor=f),e.strokeStyle=w,e.lineWidth=d,e.lineCap="round",e.lineJoin="round",e.beginPath(),e.moveTo(0,n);let p=[],g=Math.floor(i.length*b);for(let u=0;u<g;u++){let k=u/(i.length-1)*a,v=i[u],A=Math.sin(u*.1)*v,L=n+A*l;p.push({x:k,y:L})}for(let u=0;u<p.length-1;u++){let k=p[u].x+(p[u+1].x-p[u].x)*.5,v=p[u].y,A=p[u+1].x-(p[u+1].x-p[u].x)*.5,L=p[u+1].y;e.bezierCurveTo(k,v,A,L,p[u+1].x,p[u+1].y)}e.stroke(),y&&(e.shadowBlur=0)};e.strokeStyle="rgba(255, 255, 255, 0.03)",e.lineWidth=.5,e.beginPath(),e.moveTo(0,n),e.lineTo(a,n),e.stroke();for(let c=0;c<=10;c++){let d=a/10*c;e.beginPath(),e.moveTo(d,0),e.lineTo(d,o),e.stroke()}h(r.color,2,1,!1),s>0&&h(r.progressColor,3,s,!0)}function ut(e,t,i,s,r){let a=window.devicePixelRatio||1,o=(r.barWidth||3)*a,n=(r.barSpacing||1)*a,l=Math.floor(t.width/(o+n)),h=B(i,l),c=t.height,d=4*a,b=2*a,y=s*t.width,w=c/2,f=P(e,r.color,t,r),p=P(e,r.progressColor,t,r);e.clearRect(0,0,t.width,t.height);for(let g=0;g<h.length;g++){let u=g*(o+n);if(u+o>t.width)break;let k=h[g]*c*.9,v=Math.floor(k/(d+b));e.fillStyle=u<y?p:f;for(let A=0;A<v;A++){let L=A*(d+b);e.fillRect(u,w-L-d,o,d),A>0&&e.fillRect(u,w+L,o,d)}}}function dt(e,t,i,s,r){let a=window.devicePixelRatio||1,o=(r.barWidth||2)*a,n=(r.barSpacing||3)*a,l=Math.floor(t.width/(o+n)),h=B(i,l),c=t.height,d=Math.max(1.5*a,o/2),b=s*t.width,y=c/2,w=P(e,r.color,t,r),f=P(e,r.progressColor,t,r);e.clearRect(0,0,t.width,t.height);for(let p=0;p<h.length;p++){let g=p*(o+n)+o/2;if(g>t.width)break;let u=h[p]*c*.9;e.fillStyle=g<b?f:w,e.beginPath(),e.arc(g,y-u/2,d,0,Math.PI*2),e.fill(),e.beginPath(),e.arc(g,y+u/2,d,0,Math.PI*2),e.fill()}}function Tt(e,t,i,s,r){let a=t.width,o=t.height,n=o/2,l=4,h=l/2,c=!!r.seekActive;if(e.clearRect(0,0,a,o),e.fillStyle=P(e,r.color,t,r)||"rgba(255, 255, 255, 0.2)",ct(e,h,a,n,l),e.fill(),s>0){let d=Math.max(h*2,s*a);e.save(),e.globalAlpha=r.seekHandle&&!c?.7:1,e.fillStyle=P(e,r.progressColor,t,r)||"rgba(255, 255, 255, 0.9)",ct(e,h,d,n,l),e.fill(),e.restore()}}var At={bars:V,bar:V,mirror:Et,line:Pt,blocks:ut,block:ut,dots:dt,dot:dt,seekbar:Tt};function ft(e,t,i,s,r){(At[r.waveformStyle]||V)(e,t,i,s,r)}function mt(e){try{let t=e.getChannelData(0),i=e.sampleRate,s=Mt(t,i);if(s.length<2)return 120;let r=[];for(let l=1;l<s.length;l++)r.push((s[l]-s[l-1])/i);let a={};r.forEach(l=>{let h=60/l,c=Math.round(h/3)*3;c>60&&c<200&&(a[c]=(a[c]||0)+1)});let o=0,n=120;for(let[l,h]of Object.entries(a))h>o&&(o=h,n=parseInt(l));return n<70&&a[n*2]?n*=2:n>160&&a[Math.round(n/2)]&&(n=Math.round(n/2)),n-1}catch(t){return console.warn("[WaveformPlayer] BPM detection failed:",t),null}}function Mt(e,t){let r=[],a=0;for(let o=0;o<e.length-2048;o+=1024){let n=0;for(let c=o;c<o+2048;c++)n+=e[c]*e[c];n=n/2048;let l=n-a,h=a*1.8+.01;if(l>h&&n>.01){let c=r[r.length-1]||0,d=t*.15;o-c>d&&r.push(o)}a=n*.8+a*.2}return r}function Ct(e,t=1800){let i=e.length/t,s=e.numberOfChannels,r=[];for(let o=0;o<s;o++){let n=e.getChannelData(o);for(let l=0;l<t;l++){let h=~~(l*i),c=~~(h+i),d=0,b=0;for(let w=h;w<c;w++){let f=n[w];f>b&&(b=f),f<d&&(d=f)}let y=Math.max(Math.abs(b),Math.abs(d));(o===0||y>r[l])&&(r[l]=y)}}let a=$(r);return a>0?r.map(o=>o/a):r}async function G(e,t=1800,i=!1){let s;try{let r=window.AudioContext||window.webkitAudioContext;s=new r;let o=await(await fetch(e)).arrayBuffer(),n=await s.decodeAudioData(o),l=Ct(n,t);l=Lt(l);let h=null;return i&&(h=mt(n)),{peaks:l,bpm:h}}finally{s&&s.close()}}function yt(e=1800){let t=[];for(let i=0;i<e;i++){let s=Math.random()*.5+.3,r=Math.sin(i/e*Math.PI*4)*.2;t.push(m(s+r,.1,1))}return t}function Lt(e,t=.95){let i=$(e);if(i===0||i>t)return e;let s=t/i;return e.map(r=>r*s)}var K=128;function gt(e){let t=document.documentElement,i=document.body;return t.classList.contains(e)||t.classList.contains(`${e}-mode`)||t.classList.contains(`theme-${e}`)||t.getAttribute("data-theme")===e||t.getAttribute("data-color-scheme")===e||i.classList.contains(e)||i.classList.contains(`${e}-mode`)||i.getAttribute("data-theme")===e}function _t(e){let t=0,i=0;for(let s=e;s&&s.nodeType===1&&i<.995;s=s.parentElement){let r=U(getComputedStyle(s).backgroundColor);if(!r||r.a<=0)continue;let a=r.a*(1-i);t+=(r.r*299+r.g*587+r.b*114)/1e3*a,i+=a}return{sum:t,alpha:i}}function xt(){let e=lt(getComputedStyle(document.body).color);if(e!==null)return e>K?"dark":"light";if(window.matchMedia){if(window.matchMedia("(prefers-color-scheme: dark)").matches)return"dark";if(window.matchMedia("(prefers-color-scheme: light)").matches)return"light"}return"dark"}function R(e){if(gt("dark"))return"dark";if(gt("light"))return"light";try{let t=e&&e.nodeType===1?e:document.body,{sum:i,alpha:s}=_t(t),r=xt(),a=i+(r==="dark"?0:255)*(1-s);return a>K?"light":a<K?"dark":r}catch{return"dark"}}var C={dark:{waveformColor:"rgba(255, 255, 255, 0.3)",progressColor:"rgba(255, 255, 255, 0.9)"},light:{waveformColor:"rgba(0, 0, 0, 0.2)",progressColor:"rgba(0, 0, 0, 0.8)"}};function J(e,t){if(e&&C[e])return C[e];let i=R(t);return C[i]}var W={url:"",height:64,samples:1800,preload:"metadata",crossOrigin:null,audioMode:"self",playbackRate:1,showPlaybackSpeed:!1,playbackRates:[.5,.75,1,1.25,1.5,1.75,2],buttonAlign:"auto",layout:"default",buttonStyle:"circle",buttonSize:null,buttonRadius:null,waveformStyle:"mirror",barWidth:2,barSpacing:0,barRadius:1,waveformGradient:"vertical",colorPreset:null,waveformColor:null,progressColor:null,autoplay:!1,showControls:!0,showInfo:!0,showTime:!0,showHoverTime:!1,seekHandle:!1,showBPM:!1,bpm:null,singlePlay:!0,playOnSeek:!0,enableMediaSession:!0,markers:[],showMarkers:!0,accessibleSeek:!0,seekLabel:null,seekValueText:null,title:null,artist:null,artwork:null,artworkPosition:"info",album:"",errorText:"Unable to load audio",playPauseLabel:"Play/Pause",speedLabel:"Playback speed",artworkAlt:"Album artwork",unknownTrackText:"Unknown Track",playIcon:'<svg viewBox="0 0 24 24" width="16" height="16"><path d="M8 5v14l11-7z"/></svg>',pauseIcon:'<svg viewBox="0 0 24 24" width="16" height="16"><path d="M6 4h4v16H6zM14 4h4v16h-4z"/></svg>',onLoad:null,onPlay:null,onPause:null,onEnd:null,onError:null,onTimeUpdate:null,onNextTrack:null,onPreviousTrack:null},X={bars:{barWidth:3,barSpacing:1},mirror:{barWidth:2,barSpacing:2},line:{barWidth:2,barSpacing:0},blocks:{barWidth:4,barSpacing:2},dots:{barWidth:3,barSpacing:3},seekbar:{barWidth:1,barSpacing:0}},Q=["auto","top","center","bottom"],N=.25,F=4,Rt={buttonAlign:Q,layout:["default","preview"],buttonStyle:["circle","minimal"],artworkPosition:["info","button"],waveformStyle:Object.keys(X),waveformGradient:["vertical","horizontal","diagonal"],audioMode:["self","external"],preload:["none","metadata","auto"],colorPreset:Object.keys(C),crossOrigin:["anonymous","use-credentials"]},Dt={height:{min:1,integer:!0},samples:{min:1,integer:!0},barWidth:{min:0},barSpacing:{min:0},barRadius:{min:0},bpm:{min:1},playbackRate:{min:N,max:F}},Bt=["autoplay","showControls","showInfo","showTime","showHoverTime","seekHandle","showBPM","singlePlay","playOnSeek","enableMediaSession","showMarkers","accessibleSeek","showPlaybackSpeed"],Ht=["onLoad","onPlay","onPause","onEnd","onError","onTimeUpdate","onNextTrack","onPreviousTrack"];function Y(e,t){console.warn(`[WaveformPlayer] Invalid ${e} option, using default:`,t)}function z(e){let t=H(e);return t?t.reduce((i,s)=>{let r=s&&typeof s=="object"?_(s.time,null,{min:0}):null;return r===null?(Y("marker",s),i):(i.push({...s,time:r,label:s.label==null?"":s.label}),i)},[]):(e!=null&&Y("markers",e),[])}function Z(e){let t=s=>e[s]!=null,i=s=>{Y(s,e[s]),e[s]=W[s]};for(let[s,r]of Object.entries(Dt)){if(!t(s))continue;let a=_(e[s],null,r);a===null?i(s):e[s]=a}for(let[s,r]of Object.entries(Rt))t(s)&&rt(e[s],r)===null&&i(s);for(let s of Bt)e[s]=at(e[s]);for(let s of Ht)t(s)&&typeof e[s]!="function"&&i(s);if(t("playbackRates")){let s=D(e.playbackRates,{min:N,max:F,fallback:null});s===null?i("playbackRates"):e.playbackRates=s}e.markers=z(e.markers);for(let s of["buttonSize","buttonRadius"]){if(!t(s))continue;let r=e[s];(typeof r=="number"?Number.isFinite(r):typeof r=="string"&&r.trim()!=="")||i(s)}for(let s of["waveformColor","progressColor"]){if(!t(s))continue;let r=e[s];!(typeof r=="string"&&r.trim()!=="")&&!Array.isArray(r)&&i(s)}return e}var Ot="data:image/svg+xml,"+encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><rect width="24" height="24" rx="4" fill="#71717a" fill-opacity="0.15"/><g fill="none" stroke="#a1a1aa" stroke-width="1.4" stroke-linecap="round" stroke-linejoin="round"><circle cx="8" cy="17" r="2.2"/><circle cx="17" cy="15" r="2.2"/><path d="M10.2 17V7l9-1.6v9"/></g></svg>'),bt=5,wt=10,It='button, a[href], input, [role="slider"]',T=class e{static instances=new Map;static currentlyPlaying=null;constructor(t,i={}){if(this.container=typeof t=="string"?document.querySelector(t):t,!this.container)throw new Error("[WaveformPlayer] Container element not found");let s=O(this.container),r={...i};r.style&&!r.waveformStyle&&(r.waveformStyle=r.style),r.src&&!r.url&&(r.url=r.src),this.options=Z(j(W,s,r));let a=J(this.options.colorPreset,this.container);this._autoTheme=this.options.colorPreset==null||!C[this.options.colorPreset],this._presetKeys=[],this._scheme=this.options.colorPreset&&C[this.options.colorPreset]?this.options.colorPreset:R(this.container);for(let[n,l]of Object.entries(a))(this.options[n]===null||this.options[n]===void 0)&&(this.options[n]=l,this._presetKeys.push(n));let o=X[this.options.waveformStyle];o&&(s.barWidth===void 0&&i.barWidth===void 0&&(this.options.barWidth=o.barWidth),s.barSpacing===void 0&&i.barSpacing===void 0&&(this.options.barSpacing=o.barSpacing)),this.audio=null,this.canvas=null,this.ctx=null,this.waveformData=[],this.progress=0,this._activeMarkerIndex=-1,this._markerLabelTimer=null,this.isPlaying=!1,this.isLoading=!1,this.hasError=!1,this.updateTimer=null,this.resizeObserver=null,this._ac=new AbortController,this.id=this.container.id||nt(this.options.url),e.instances.set(this.id,this),e._watchTheme(),this.init(),setTimeout(()=>{this._emit("waveformplayer:ready",{player:this,url:this.options.url})},100)}_emit(t,i,s=!1){let r=new CustomEvent(t,{bubbles:!0,cancelable:s,detail:i});return this.container.dispatchEvent(r),r}_requestSeek(t){this._emit("waveformplayer:request-seek",{...this._buildTrackDetail(),percent:t},!0).defaultPrevented||(this.progress=t,this.drawWaveform?.())}init(){this.createDOM(),this.createAudio(),this.initPlaybackSpeed(),this.initKeyboardControls(),this.initSeekControl(),this.bindEvents(),this.setupResizeObserver(),requestAnimationFrame(()=>{this.resizeCanvas(),this.options.url&&this.load(this.options.url).then(()=>{this.options.autoplay&&this.play()?.catch(()=>{})}).catch(t=>{console.error("[WaveformPlayer] Failed to load audio:",t)})})}createDOM(){this.container.innerHTML="",this.container.className="waveform-player";let t=Q.includes(this.options.buttonAlign)?this.options.buttonAlign:"auto";t==="auto"&&(this.options.waveformStyle==="bars"?t="bottom":t="center"),this.options.layout==="preview"&&this.container.classList.add("waveform-layout-preview"),this.container.classList.toggle("waveform-theme-light",this._scheme==="light");let s=[];this.options.buttonSize!=null&&s.push(`--wfp-btn-size: ${q(this.options.buttonSize)}`),this.options.buttonRadius!=null&&s.push(`--wfp-btn-radius: ${q(this.options.buttonRadius)}`);let r=s.length?` style="${s.join("; ")};"`:"",a=this.options.artworkPosition==="button"&&this.options.artwork,o=a?`<img class="waveform-btn-artwork" src="${S(this.options.artwork)}" alt="" aria-hidden="true">`:"",n=this.options.showControls?`
2
+ <button class="waveform-btn${this.options.buttonStyle==="minimal"?" waveform-btn-minimal":""}${a?" waveform-btn-has-artwork":""}" aria-label="${S(this.options.playPauseLabel)}"${r}>
3
3
  ${o}
4
4
  <span class="waveform-icon-play">${this.options.playIcon}</span>
5
5
  <span class="waveform-icon-pause" style="display:none;">${this.options.pauseIcon}</span>
6
6
  </button>
7
- `:"",n=this.options.showInfo?`
7
+ `:"",l=this.options.showInfo?`
8
8
  <div class="waveform-info">
9
9
  ${this.options.artworkPosition!=="button"&&this.options.artwork?`
10
10
  <img class="waveform-artwork" src="${S(this.options.artwork)}" alt="${S(this.options.artworkAlt)}" style="
@@ -46,7 +46,7 @@
46
46
  <div class="waveform-player-inner">
47
47
  <div class="waveform-body">
48
48
  <div class="waveform-track waveform-align-${t}">
49
- ${l}
49
+ ${n}
50
50
 
51
51
  <div class="waveform-container">
52
52
  <canvas></canvas>
@@ -58,7 +58,7 @@
58
58
  </div>
59
59
  </div>
60
60
 
61
- ${n}
61
+ ${l}
62
62
  </div>
63
63
  </div>
64
- `,this.playBtn=this.container.querySelector(".waveform-btn"),this.canvas=this.container.querySelector("canvas"),this.ctx=this.canvas.getContext("2d"),this.titleEl=this.container.querySelector(".waveform-title"),this.artistEl=this.container.querySelector(".waveform-artist"),this.artworkEl=this.container.querySelector(".waveform-artwork, .waveform-btn-artwork"),this.bindArtworkFallback(this.artworkEl),this.currentTimeEl=this.container.querySelector(".time-current"),this.totalTimeEl=this.container.querySelector(".time-total"),this.bpmEl=this.container.querySelector(".waveform-bpm"),this.bpmValueEl=this.container.querySelector(".bpm-value"),this.loadingEl=this.container.querySelector(".waveform-loading"),this.errorEl=this.container.querySelector(".waveform-error"),this.markersContainer=this.container.querySelector(".waveform-markers"),this.speedBtn=this.container.querySelector(".speed-btn"),this.speedMenu=this.container.querySelector(".speed-menu"),this.resizeCanvas(),this.updateBPMDisplay()}bindArtworkFallback(t){t&&t.addEventListener("error",()=>{t.src.startsWith("data:")||(t.src=vt)},{signal:this._ac.signal})}createArtworkElement(){let t=document.createElement("img");return t.className="waveform-artwork",t.style.width="40px",t.style.height="40px",t.style.borderRadius="4px",t.style.objectFit="cover",t.style.flexShrink="0",this.bindArtworkFallback(t),t}createButtonArtworkElement(){let t=document.createElement("img");return t.className="waveform-btn-artwork",t.alt="",t.setAttribute("aria-hidden","true"),this.bindArtworkFallback(t),t}createArtistElement(){let t=document.createElement("span");return t.className="waveform-artist",t}syncArtist(t){if(this.options.artist=t||null,!!this.options.showInfo){if(!t){this.artistEl?.remove(),this.artistEl=null;return}if(!this.artistEl){let i=this.container.querySelector(".waveform-title");if(!i)return;this.artistEl=this.createArtistElement(),i.after(this.artistEl)}this.artistEl.textContent=t,this.artistEl.style.display=""}}syncButtonArtwork(t){if(this.playBtn){if(!t){this.artworkEl?.remove(),this.artworkEl=null,this.playBtn.classList.remove("waveform-btn-has-artwork");return}this.artworkEl||(this.artworkEl=this.createButtonArtworkElement(),this.playBtn.prepend(this.artworkEl)),this.artworkEl.src=t,this.playBtn.classList.add("waveform-btn-has-artwork")}}syncArtwork(t,i=""){if(this.options.artwork=t||null,this.options.artworkAlt=i||"",this.options.artworkPosition==="button"){this.syncButtonArtwork(this.options.artwork);return}if(this.options.showInfo){if(!t){this.artworkEl?.remove(),this.artworkEl=null;return}if(!this.artworkEl){let r=this.container.querySelector(".waveform-text");if(!r)return;this.artworkEl=this.createArtworkElement(),r.before(this.artworkEl)}this.artworkEl.src=t,this.artworkEl.alt=i||""}}createAudio(){if(this.options.audioMode==="external"){this.audio=null;return}this.audio=new Audio,this.audio.preload=this.options.preload||"metadata",this.options.crossOrigin&&(this.audio.crossOrigin=this.options.crossOrigin)}initPlaybackSpeed(){this.audio&&this.options.playbackRate&&this.options.playbackRate!==1&&(this.audio.playbackRate=this.options.playbackRate),this.options.showPlaybackSpeed&&this.initSpeedControls()}initSpeedControls(){let t=this.container.querySelector(".speed-btn"),i=this.container.querySelector(".speed-menu");if(!t||!i)return;let r=()=>Array.from(i.querySelectorAll(".speed-option")),s=()=>i.style.display!=="none",a=n=>{if(i.style.display=n?"block":"none",t.setAttribute("aria-expanded",n?"true":"false"),n){let h=r();(h.find(c=>c.getAttribute("aria-checked")==="true")||h[0])?.focus()}},o=n=>{let h=r();h.length&&h[(n+h.length)%h.length].focus()},l=n=>{this.setPlaybackRate(parseFloat(n.dataset.rate)),a(!1),t.focus()};t.addEventListener("click",n=>{n.stopPropagation(),a(!s())},{signal:this._ac.signal}),document.addEventListener("click",()=>a(!1),{signal:this._ac.signal}),i.addEventListener("click",n=>{n.stopPropagation();let h=n.target.closest(".speed-option");h&&l(h)},{signal:this._ac.signal}),t.closest(".waveform-speed")?.addEventListener("keydown",n=>{let h=r(),c=h.indexOf(document.activeElement);if(!s()){(n.key==="ArrowDown"||n.key==="ArrowUp")&&document.activeElement===t&&(n.preventDefault(),a(!0));return}switch(n.key){case"ArrowDown":n.preventDefault(),o(c<0?0:c+1);break;case"ArrowUp":n.preventDefault(),o(c<0?h.length-1:c-1);break;case"Home":n.preventDefault(),o(0);break;case"End":n.preventDefault(),o(h.length-1);break;case"Escape":n.preventDefault(),a(!1),t.focus();break;case"Tab":a(!1);break}},{signal:this._ac.signal}),this.updateSpeedUI()}initKeyboardControls(){this.container.setAttribute("tabindex","-1"),this.container.addEventListener("click",t=>{t.target.closest(St)||(e.getAllInstances().forEach(i=>{i!==this&&i.container.setAttribute("tabindex","-1")}),this.container.setAttribute("tabindex","0"),this.container.focus())},{signal:this._ac.signal}),this.container.addEventListener("keydown",t=>{if(document.activeElement!==this.container)return;let i=t.key,r=!!this.audio,s=r?this.audio.currentTime:0;if(r&&i>="0"&&i<="9"){t.preventDefault(),this.seekToPercent(parseInt(i)/10);return}let a={" ":()=>this.togglePlay()};r&&(a.ArrowLeft=()=>this.seekTo(m(s-5,0,this.audio.duration)),a.ArrowRight=()=>this.seekTo(m(s+5,0,this.audio.duration)),a.ArrowUp=()=>this.setVolume(m(this.audio.volume+.1)),a.ArrowDown=()=>this.setVolume(m(this.audio.volume-.1)),a.m=a.M=()=>this.audio.muted=!this.audio.muted),a[i]&&(t.preventDefault(),a[i]())},{signal:this._ac.signal})}initSeekControl(){this.options.accessibleSeek&&(this.seekEl=this.container.querySelector(".waveform-container"),this.seekEl&&(this.seekEl.setAttribute("role","slider"),this.seekEl.setAttribute("tabindex","0"),this.seekEl.setAttribute("aria-valuemin","0"),this.applySeekLabel(),this.updateSeekAccessibility(),this.seekEl.addEventListener("keydown",t=>{if(t.key===" "||t.key==="Spacebar"){t.preventDefault(),t.stopPropagation(),this.togglePlay();return}let i=this.getSeekDuration();if(!i)return;let r=this.getSeekCurrentTime(),s;switch(t.key){case"ArrowLeft":case"ArrowDown":s=r-nt;break;case"ArrowRight":case"ArrowUp":s=r+nt;break;case"PageDown":s=r-lt;break;case"PageUp":s=r+lt;break;case"Home":s=0;break;case"End":s=i;break;default:return}t.preventDefault(),t.stopPropagation(),this.seekToSeconds(s)},{signal:this._ac.signal})))}getSeekDuration(){return this.options.audioMode==="external"?this._extDuration||0:this.audio&&Number.isFinite(this.audio.duration)?this.audio.duration:0}getSeekCurrentTime(){return this.options.audioMode==="external"?this.progress*(this._extDuration||0):this.audio&&Number.isFinite(this.audio.currentTime)?this.audio.currentTime:0}seekToSeconds(t){let i=this.getSeekDuration();if(!i)return;let r=m(t,0,i);if(this.options.audioMode==="external"){this._requestSeek(r/i),this.updateSeekAccessibility();return}this.seekTo(r)}applySeekLabel(t=this.options.title){if(!this.seekEl)return;let i=this.options.seekLabel||t||"Seek";this.seekEl.setAttribute("aria-label",i)}updateSeekAccessibility(){if(!this.seekEl)return;let t=this.getSeekDuration(),i=Math.min(this.getSeekCurrentTime(),t);this.seekEl.setAttribute("aria-valuemax",String(Math.round(t))),this.seekEl.setAttribute("aria-valuenow",String(Math.round(i))),this.seekEl.setAttribute("aria-valuetext",J(this.options.seekValueText||"%1$s of %2$s",E(i),E(t)))}initMediaSession(){if(!("mediaSession"in navigator)||!this.options.enableMediaSession||!this.audio)return;this._applyMediaMetadata(),navigator.mediaSession.setActionHandler("play",()=>this.play()),navigator.mediaSession.setActionHandler("pause",()=>this.pause()),navigator.mediaSession.setActionHandler("seekbackward",()=>{this.seekTo(m(this.audio.currentTime-10,0,this.audio.duration))}),navigator.mediaSession.setActionHandler("seekforward",()=>{this.seekTo(m(this.audio.currentTime+10,0,this.audio.duration))}),navigator.mediaSession.setActionHandler("seekto",r=>{r.seekTime!==null&&this.seekTo(r.seekTime)});let t=this.options.onNextTrack,i=this.options.onPreviousTrack;try{navigator.mediaSession.setActionHandler("nexttrack",typeof t=="function"?()=>t(this):null)}catch{}try{navigator.mediaSession.setActionHandler("previoustrack",typeof i=="function"?()=>i(this):null)}catch{}}_applyMediaMetadata(){!("mediaSession"in navigator)||!this.options.enableMediaSession||(navigator.mediaSession.metadata=new MediaMetadata({title:this.options.title||this.options.unknownTrackText,artist:this.options.artist||"",album:this.options.album||"",artwork:this.options.artwork?[{src:this.options.artwork,sizes:"512x512",type:"image/jpeg"}]:[]}))}_updateMediaSession(t){if(!(!("mediaSession"in navigator)||!this.options.enableMediaSession||!this.audio))try{t==="playing"&&this.initMediaSession(),navigator.mediaSession.playbackState=t;let i=this.audio.duration;navigator.mediaSession.setPositionState&&i&&isFinite(i)&&navigator.mediaSession.setPositionState({duration:i,playbackRate:this.audio.playbackRate||1,position:m(this.audio.currentTime,0,i)})}catch{}}bindEvents(){this.playBtn&&this.playBtn.addEventListener("click",()=>this.togglePlay()),this.audio&&(this.audio.addEventListener("loadstart",()=>this.setLoading(!0)),this.audio.addEventListener("loadedmetadata",()=>this.onMetadataLoaded()),this.audio.addEventListener("canplay",()=>this.setLoading(!1)),this.audio.addEventListener("play",()=>this.onPlay()),this.audio.addEventListener("pause",()=>this.onPause()),this.audio.addEventListener("ended",()=>this.onEnded()),this.audio.addEventListener("error",i=>this.onError(i))),this.canvas.addEventListener("click",i=>this.handleCanvasClick(i)),this._dragging=!1,this._seekHover=!1,this._handleNear=!1,this.canvas.addEventListener("pointerenter",()=>{this._seekHover=!0,this.drawWaveform(),this._updateSeekHandle()}),this.canvas.addEventListener("pointerleave",()=>{this._seekHover=!1,this._handleNear=!1,this._dragging||this._hideHoverTip(),this.drawWaveform(),this._updateSeekHandle()}),this.canvas.addEventListener("pointerdown",i=>{if(!(i.pointerType==="mouse"&&i.button!==0)){this._dragging=!0;try{this.canvas.setPointerCapture(i.pointerId)}catch{}this._scrubTo(i.clientX)}}),this.canvas.addEventListener("pointermove",i=>{if(this._dragging){this._scrubTo(i.clientX);return}let r=this.canvas.getBoundingClientRect();r.width&&(this._handleNear=Math.abs(i.clientX-r.left-this.progress*r.width)<=10,this._updateSeekHandle())});let t=i=>{if(this._dragging){this._dragging=!1,this._suppressClick=!0;try{this.canvas.releasePointerCapture(i.pointerId)}catch{}this._seekFromPointer(i.clientX),!this._seekHover&&!this.options.showHoverTime&&this._hideHoverTip(),this._updateSeekHandle()}};this.canvas.addEventListener("pointerup",t),this.canvas.addEventListener("pointercancel",t),this.setupHoverTime(),this.setupSeekHandle(),this.resizeHandler=X(()=>this.resizeCanvas(),100),window.addEventListener("resize",this.resizeHandler)}setupResizeObserver(){"ResizeObserver"in window&&(this.resizeObserver=new ResizeObserver(()=>{this.resizeCanvas()}),this.canvas?.parentElement&&this.resizeObserver.observe(this.canvas.parentElement))}async load(t){try{this.setLoading(!0),this.progress=0,this.hasError=!1,this.container.classList.remove("waveform-is-placeholder"),this.audio&&(this.audio.src=t,await new Promise((r,s)=>{let a=()=>{this.audio.removeEventListener("loadedmetadata",a),this.audio.removeEventListener("error",o),r()},o=l=>{this.audio.removeEventListener("loadedmetadata",a),this.audio.removeEventListener("error",o),s(l)};this.audio.addEventListener("loadedmetadata",a),this.audio.addEventListener("error",o)}));let i=this.options.title||R(t);if(this.titleEl&&(this.titleEl.textContent=i),this.applySeekLabel(i),this.options.waveform)this.setWaveformData(this.options.waveform);else try{let r=await $(t,this.options.samples,this.options.showBPM);this.waveformData=r.peaks,r.bpm&&(this.detectedBPM=r.bpm,this.updateBPMDisplay())}catch(r){console.warn("[WaveformPlayer] Using placeholder waveform:",r),this.waveformData=rt(this.options.samples),this.container.classList.add("waveform-is-placeholder")}this.drawWaveform(),this.renderMarkers(),this.options.onLoad&&this.options.onLoad(this)}catch(i){this.onError(i)}finally{this.setLoading(!1)}}async loadTrack(t,i=null,r=null,s={}){let a=Object.prototype.hasOwnProperty.call(s,"artwork"),o=Object.prototype.hasOwnProperty.call(s,"artworkAlt");this.isPlaying&&this.pause(),this.audio&&(this.audio.src="",this.audio.load()),this.hasError=!1,this.errorEl&&(this.errorEl.style.display="none"),this.canvas&&(this.canvas.style.opacity="1"),this.playBtn&&(this.playBtn.disabled=!1),this.progress=0,this.waveformData=[],this.options=I(this.options,{url:t,title:i===null?this.options.title:i,artist:r===null?this.options.artist:r,...s}),a&&(this.options.artwork=s.artwork||null),o?this.options.artworkAlt=s.artworkAlt||"":a&&(this.options.artworkAlt=this.options.artwork?q.artworkAlt:""),s.preload&&this.audio&&(this.audio.preload=s.preload),s.crossOrigin&&this.audio&&(this.audio.crossOrigin=s.crossOrigin),r!==null&&this.syncArtist(r),(a||o)&&this.syncArtwork(a?s.artwork:this.options.artwork,o?s.artworkAlt:this.options.artworkAlt),this.options.markers=s.markers||[],this.options.waveform=s.waveform||null,await this.load(t),s.autoplay!==!1&&this.play()?.catch(()=>{})}setWaveformData(t){if(typeof t=="string"&&t.trim().endsWith(".json")){fetch(t.trim()).then(i=>i.json()).then(i=>{this.waveformData=Array.isArray(i)?i:i.peaks||[],i.markers&&!this.options.markers?.length&&(this.options.markers=i.markers,this.renderMarkers()),this.drawWaveform()}).catch(()=>{});return}if(typeof t=="string")try{let i=JSON.parse(t);this.waveformData=Array.isArray(i)?i:[]}catch{this.waveformData=t.split(",").map(Number)}else this.waveformData=Array.isArray(t)?t:[];this.drawWaveform()}drawWaveform(){!this.ctx||this.waveformData.length===0||it(this.ctx,this.canvas,this.waveformData,this.progress,{...this.options,waveformStyle:this.options.waveformStyle||"bars",color:this.options.waveformColor,progressColor:this.options.progressColor,seekActive:this._seekHover||this._dragging})}resizeCanvas(){if(!this.canvas||this.isDestroying)return;let t=window.devicePixelRatio||1,i=this.canvas.parentElement.getBoundingClientRect();this.canvas.width=i.width*t,this.canvas.height=this.options.height*t,this.canvas.parentElement.style.height=this.options.height+"px",this.drawWaveform()}renderMarkers(){if(!this.markersContainer||(this.markersContainer.innerHTML="",this._activeMarkerIndex=-1,clearTimeout(this._markerLabelTimer),!this.options.showMarkers||!this.options.markers?.length))return;let t=this.getSeekDuration();t&&this.options.markers.forEach((i,r)=>{if(i.time>t){console.warn(`[WaveformPlayer] Marker "${i.label}" at ${i.time}s exceeds audio duration of ${t}s`);return}let s=i.time/t*100,a=document.createElement("button");a.className="waveform-marker",a.style.left=`${s}%`,a.style.backgroundColor=i.color||"rgba(255, 255, 255, 0.5)",a.setAttribute("aria-label",i.label),a.setAttribute("data-time",i.time);let o=document.createElement("span");o.className="waveform-marker-tooltip",o.textContent=i.label,a.appendChild(o),a.addEventListener("click",l=>{l.stopPropagation(),this.seekTo(i.time),this.options.playOnSeek&&!this.isPlaying&&this.play()}),this.markersContainer.appendChild(a)})}setActiveMarker(t){if(!this.markersContainer)return;this.markersContainer.querySelectorAll(".waveform-marker").forEach((r,s)=>r.classList.toggle("active",s===t))}updateActiveMarker(){if(!this.markersContainer)return;let t=this.markersContainer.querySelectorAll(".waveform-marker");if(!t.length)return;let i=this.getSeekDuration(),r=i?this.progress*i:0,s=-1,a=-1/0;t.forEach((o,l)=>{let n=parseFloat(o.getAttribute("data-time"));Number.isFinite(n)&&n<=r+.05&&n>a&&(a=n,s=l)}),s!==this._activeMarkerIndex&&(this._activeMarkerIndex=s,this.setActiveMarker(s),clearTimeout(this._markerLabelTimer),t.forEach((o,l)=>o.classList.toggle("show-label",l===s)),s>=0&&(this._markerLabelTimer=setTimeout(()=>{this.markersContainer?.querySelectorAll(".waveform-marker").forEach(o=>o.classList.remove("show-label"))},2500)))}setupHoverTime(){if(!this.seekEl)return;let t=document.createElement("div");t.className="waveform-hover-time",t.setAttribute("aria-hidden","true"),this.seekEl.appendChild(t),this.hoverTimeEl=t,this.options.showHoverTime&&(this.seekEl.addEventListener("pointermove",i=>{this._dragging||this._updateHoverTip(i.clientX)}),this.seekEl.addEventListener("pointerleave",()=>{this._dragging||this._hideHoverTip()}))}_updateHoverTip(t){let i=this.hoverTimeEl;if(!i)return;let r=this.getSeekDuration();if(!r){i.style.opacity="0";return}let s=this.canvas.getBoundingClientRect(),a=m((t-s.left)/s.width);i.textContent=E(a*r),i.style.left=a*100+"%",i.style.opacity="1"}_hideHoverTip(){this.hoverTimeEl&&(this.hoverTimeEl.style.opacity="0")}_scrubTo(t){let i=this.canvas.getBoundingClientRect();if(!i.width)return;this.progress=m((t-i.left)/i.width),this.drawWaveform(),this._updateSeekHandle();let r=this.getSeekDuration();r&&this.currentTimeEl?(this.currentTimeEl.textContent=E(this.progress*r),this._hideHoverTip()):this._updateHoverTip(t)}setupSeekHandle(){if(!this.options.seekHandle||this.options.waveformStyle!=="seekbar"||!this.seekEl)return;let t=document.createElement("div");t.className="waveform-seek-handle",t.setAttribute("aria-hidden","true"),this.seekEl.appendChild(t),this.seekHandleEl=t}_updateSeekHandle(){let t=this.seekHandleEl;t&&(t.style.left=this.progress*100+"%",t.classList.toggle("is-visible",this._seekHover||this._dragging),t.classList.toggle("is-active",this._dragging||this._handleNear))}handleCanvasClick(t){if(this._suppressClick){this._suppressClick=!1;return}this._seekFromPointer(t.clientX)}_seekFromPointer(t){let i=this.canvas.getBoundingClientRect();if(!i.width)return;let r=m((t-i.left)/i.width);if(this.options.audioMode==="external"){this._requestSeek(r);return}!this.audio||!this.audio.duration||this.seekToPercent(r)}setLoading(t){this.isLoading=t,this.loadingEl&&(this.loadingEl.style.display=t?"block":"none"),this.seekEl&&this.seekEl.setAttribute("aria-busy",t?"true":"false")}onMetadataLoaded(){this.isDestroying||(this.totalTimeEl&&(this.totalTimeEl.textContent=E(this.audio.duration)),this.renderMarkers(),this.updateSeekAccessibility())}setPlayButtonState(t){if(!this.playBtn)return;this.playBtn.classList.toggle("playing",t);let i=this.playBtn.querySelector(".waveform-icon-play"),r=this.playBtn.querySelector(".waveform-icon-pause");i&&(i.style.display=t?"none":"flex"),r&&(r.style.display=t?"flex":"none")}onPlay(){this.isDestroying||(this.isPlaying=!0,this.setPlayButtonState(!0),this.startSmoothUpdate(),this._updateMediaSession("playing"),this._emit("waveformplayer:play",{player:this,url:this.options.url}),this.options.onPlay&&this.options.onPlay(this))}onPause(){this.isDestroying||(this.isPlaying=!1,this.setPlayButtonState(!1),this.stopSmoothUpdate(),this._updateMediaSession("paused"),this._emit("waveformplayer:pause",{player:this,url:this.options.url}),this.options.onPause&&this.options.onPause(this))}onEnded(){if(this.isDestroying)return;let t=this.audio.duration;this.progress=0,this.audio.currentTime=0,this.drawWaveform(),this.currentTimeEl&&(this.currentTimeEl.textContent="0:00"),this._emit("waveformplayer:ended",{player:this,url:this.options.url,currentTime:t,duration:t}),this.onPause(),this.options.onEnd&&this.options.onEnd(this)}onError(t){this.isDestroying||(console.error("[WaveformPlayer] Audio error:",t),this.hasError=!0,this.setLoading(!1),this.errorEl&&(this.errorEl.style.display="flex"),this.canvas&&(this.canvas.style.opacity="0.2"),this.playBtn&&(this.playBtn.disabled=!0),this.options.onError&&this.options.onError(t,this))}startSmoothUpdate(){this.stopSmoothUpdate();let t=()=>{this.isPlaying&&this.audio&&this.audio.duration&&(this.updateProgress(),this.updateTimer=requestAnimationFrame(t))};this.updateTimer=requestAnimationFrame(t)}stopSmoothUpdate(){this.updateTimer&&(cancelAnimationFrame(this.updateTimer),this.updateTimer=null)}updateProgress(){if(!this.audio||!this.audio.duration||this._dragging)return;let t=this.audio.currentTime/this.audio.duration;Math.abs(t-this.progress)>.001&&(this.progress=t,this.drawWaveform(),this._updateSeekHandle()),this.currentTimeEl&&(this.currentTimeEl.textContent=E(this.audio.currentTime)),this._emit("waveformplayer:timeupdate",{player:this,currentTime:this.audio.currentTime,duration:this.audio.duration,progress:this.progress,url:this.options.url}),this.options.onTimeUpdate&&this.options.onTimeUpdate(this.audio.currentTime,this.audio.duration,this),this.updateActiveMarker(),this.updateSeekAccessibility()}updateBPMDisplay(){let t=this.options.bpm||this.detectedBPM;this.bpmEl&&this.bpmValueEl&&t&&(this.bpmValueEl.textContent=Math.round(t),this.bpmEl.style.display="inline-flex")}refreshTheme(){if(!this._autoTheme)return;this._scheme=x(this.container);let t=N(this.options.colorPreset,this.container);for(let i of this._presetKeys||[])i in t&&(this.options[i]=t[i]);this._applyThemeColors()}_applyThemeColors(){this.container.classList.toggle("waveform-theme-light",this._scheme==="light"),this.canvas&&this.drawWaveform()}static _watchTheme(){if(e._themeWatch||typeof document>"u")return;let t=()=>requestAnimationFrame(()=>{e.instances.forEach(a=>{try{a.refreshTheme()}catch{}})}),i={attributes:!0,attributeFilter:["class","data-theme","data-color-scheme","style"]},r=new MutationObserver(t);r.observe(document.documentElement,i),document.body&&r.observe(document.body,i);let s=null;try{s=window.matchMedia("(prefers-color-scheme: dark)"),s.addEventListener("change",t)}catch{}e._themeWatch={obs:r,mq:s,refresh:t}}updateSpeedUI(){if(!this.audio)return;let t=this.container.querySelector(".speed-value");if(t){let i=this.audio.playbackRate;t.textContent=i===1?"1x":`${i}x`}this.container.querySelectorAll(".speed-option").forEach(i=>{let r=parseFloat(i.dataset.rate)===this.audio.playbackRate;i.classList.toggle("active",r),i.setAttribute("aria-checked",r?"true":"false")})}play(){if(this.options.singlePlay&&e.currentlyPlaying&&e.currentlyPlaying!==this&&e.currentlyPlaying.pause(),this.options.audioMode==="external"){this._emit("waveformplayer:request-play",this._buildTrackDetail(),!0).defaultPrevented||(e.currentlyPlaying=this);return}return e.currentlyPlaying=this,this.audio.play()}pause(){if(e.currentlyPlaying===this&&(e.currentlyPlaying=null),this.options.audioMode==="external"){this._emit("waveformplayer:request-pause",this._buildTrackDetail(),!0);return}this.audio.pause()}_buildTrackDetail(){return{url:this.options.url,title:this.options.title,artist:this.options.artist,artwork:this.options.artwork,markers:this.options.markers,waveform:this.options.waveform,id:this.id,player:this}}setPlayingState(t){let i=this.isPlaying;this.isPlaying=!!t,this.setPlayButtonState(this.isPlaying),this.isPlaying&&!i?(this.startSmoothUpdate?.(),this._emit("waveformplayer:play",{player:this,url:this.options.url}),this.options.onPlay&&this.options.onPlay(this)):!this.isPlaying&&i&&(this.stopSmoothUpdate?.(),this._emit("waveformplayer:pause",{player:this,url:this.options.url}),this.options.onPause&&this.options.onPause(this))}setProgress(t,i){!i||i<=0||(this.progress=m(t/i),this.currentTimeEl&&(this.currentTimeEl.textContent=E(t)),this._extDuration=i,this.totalTimeEl&&(!this.totalTimeEl.dataset._extSet||this.totalTimeEl.dataset._extDur!==String(i))&&(this.totalTimeEl.textContent=E(i),this.totalTimeEl.dataset._extSet="1",this.totalTimeEl.dataset._extDur=String(i)),this.drawWaveform?.(),this.updateActiveMarker(),this._emit("waveformplayer:timeupdate",{player:this,currentTime:t,duration:i,progress:this.progress,url:this.options.url}),this.options.onTimeUpdate&&this.options.onTimeUpdate(t,i,this),this.progress>=1?this._extEnded||(this._extEnded=!0,this._emit("waveformplayer:ended",{player:this,url:this.options.url,currentTime:i,duration:i}),this.options.onEnd&&this.options.onEnd(this)):this._extEnded=!1,this.updateSeekAccessibility())}togglePlay(){this.isPlaying?this.pause():this.play()}seekTo(t){this.audio&&this.audio.duration&&(this.audio.currentTime=m(t,0,this.audio.duration),this.updateProgress())}seekToPercent(t){this.audio&&this.audio.duration&&(this.audio.currentTime=this.audio.duration*m(t),this.updateProgress())}setVolume(t){let i=Number(t);this.audio&&Number.isFinite(i)&&(this.audio.volume=m(i))}setPlaybackRate(t){if(!this.audio)return;let i=m(t,.5,2);this.audio.playbackRate=i,this.options.playbackRate=i,this.updateSpeedUI()}destroy(){this.isDestroying=!0,this._emit("waveformplayer:destroy",{player:this,url:this.options.url}),this.pause(),this.stopSmoothUpdate(),clearTimeout(this._markerLabelTimer),this._ac?.abort(),this.resizeObserver&&(this.resizeObserver.disconnect(),this.resizeObserver=null),this.resizeHandler&&(window.removeEventListener("resize",this.resizeHandler),this.resizeHandler=null),e.instances.delete(this.id),e.currentlyPlaying===this&&(e.currentlyPlaying=null),this.audio&&(this.audio.pause(),this.audio.src="",this.audio.load(),this.audio=null),this.container.innerHTML="",this.canvas=null,this.ctx=null,this.playBtn=null,this.waveformData=[]}static getInstance(t){if(typeof t=="string"){let i=this.instances.get(t);if(i)return i;let r=document.getElementById(t);if(r)return Array.from(this.instances.values()).find(s=>s.container===r)}if(t instanceof HTMLElement)return Array.from(this.instances.values()).find(i=>i.container===t)}static getAllInstances(){return Array.from(this.instances.values())}static destroyAll(){this.instances.forEach(t=>t.destroy()),this.instances.clear()}static async generateWaveformData(t,i=1800){try{return(await $(t,i)).peaks}catch(r){throw console.error("[WaveformPlayer] Failed to generate waveform:",r),r}}static getPeaksUrl(t){if(!t)return;let i=t.replace(/\.(mp3|wav|ogg|flac|m4a|aac)(\?[^#]*)?(#.*)?$/i,".json$2$3");return i===t?void 0:i}};P.utils={formatTime:E,extractTitleFromUrl:R,escapeHtml:S,isSafeHref:G,parseDataAttributes:H,detectColorScheme:x};var V=()=>typeof window<"u"&&typeof document<"u";function U(){if(!V())return;document.querySelectorAll("[data-waveform-player]").forEach(t=>{if(!(t.dataset.waveformInitialized==="true"||P.getInstance(t)))try{new P(t),t.dataset.waveformInitialized="true"}catch(i){console.error("[WaveformPlayer] Failed to initialize:",i,t)}})}V()&&(document.readyState==="loading"?document.addEventListener("DOMContentLoaded",U):U());P.init=U;V()&&(window.WaveformPlayer=P);var zt=P;})();
64
+ `,this.playBtn=this.container.querySelector(".waveform-btn"),this.canvas=this.container.querySelector("canvas"),this.ctx=this.canvas.getContext("2d"),this.titleEl=this.container.querySelector(".waveform-title"),this.artistEl=this.container.querySelector(".waveform-artist"),this.artworkEl=this.container.querySelector(".waveform-artwork, .waveform-btn-artwork"),this.bindArtworkFallback(this.artworkEl),this.currentTimeEl=this.container.querySelector(".time-current"),this.totalTimeEl=this.container.querySelector(".time-total"),this.bpmEl=this.container.querySelector(".waveform-bpm"),this.bpmValueEl=this.container.querySelector(".bpm-value"),this.loadingEl=this.container.querySelector(".waveform-loading"),this.errorEl=this.container.querySelector(".waveform-error"),this.markersContainer=this.container.querySelector(".waveform-markers"),this.speedBtn=this.container.querySelector(".speed-btn"),this.speedMenu=this.container.querySelector(".speed-menu"),this.resizeCanvas(),this.updateBPMDisplay()}bindArtworkFallback(t){t&&t.addEventListener("error",()=>{t.src.startsWith("data:")||(t.src=Ot)},{signal:this._ac.signal})}createArtworkElement(){let t=document.createElement("img");return t.className="waveform-artwork",t.style.width="40px",t.style.height="40px",t.style.borderRadius="4px",t.style.objectFit="cover",t.style.flexShrink="0",this.bindArtworkFallback(t),t}createButtonArtworkElement(){let t=document.createElement("img");return t.className="waveform-btn-artwork",t.alt="",t.setAttribute("aria-hidden","true"),this.bindArtworkFallback(t),t}createArtistElement(){let t=document.createElement("span");return t.className="waveform-artist",t}syncArtist(t){if(this.options.artist=t||null,!!this.options.showInfo){if(!t){this.artistEl?.remove(),this.artistEl=null;return}if(!this.artistEl){let i=this.container.querySelector(".waveform-title");if(!i)return;this.artistEl=this.createArtistElement(),i.after(this.artistEl)}this.artistEl.textContent=t,this.artistEl.style.display=""}}syncButtonArtwork(t){if(this.playBtn){if(!t){this.artworkEl?.remove(),this.artworkEl=null,this.playBtn.classList.remove("waveform-btn-has-artwork");return}this.artworkEl||(this.artworkEl=this.createButtonArtworkElement(),this.playBtn.prepend(this.artworkEl)),this.artworkEl.src=t,this.playBtn.classList.add("waveform-btn-has-artwork")}}syncArtwork(t,i=""){if(this.options.artwork=t||null,this.options.artworkAlt=i||"",this.options.artworkPosition==="button"){this.syncButtonArtwork(this.options.artwork);return}if(this.options.showInfo){if(!t){this.artworkEl?.remove(),this.artworkEl=null;return}if(!this.artworkEl){let s=this.container.querySelector(".waveform-text");if(!s)return;this.artworkEl=this.createArtworkElement(),s.before(this.artworkEl)}this.artworkEl.src=t,this.artworkEl.alt=i||""}}createAudio(){if(this.options.audioMode==="external"){this.audio=null;return}this.audio=new Audio,this.audio.preload=this.options.preload||"metadata",this.options.crossOrigin&&(this.audio.crossOrigin=this.options.crossOrigin)}initPlaybackSpeed(){this.audio&&this.options.playbackRate&&this.options.playbackRate!==1&&(this.audio.playbackRate=this.options.playbackRate),this.options.showPlaybackSpeed&&this.initSpeedControls()}initSpeedControls(){let t=this.container.querySelector(".speed-btn"),i=this.container.querySelector(".speed-menu");if(!t||!i)return;let s=()=>Array.from(i.querySelectorAll(".speed-option")),r=()=>i.style.display!=="none",a=l=>{if(i.style.display=l?"block":"none",t.setAttribute("aria-expanded",l?"true":"false"),l){let h=s();(h.find(c=>c.getAttribute("aria-checked")==="true")||h[0])?.focus()}},o=l=>{let h=s();h.length&&h[(l+h.length)%h.length].focus()},n=l=>{this.setPlaybackRate(parseFloat(l.dataset.rate)),a(!1),t.focus()};t.addEventListener("click",l=>{l.stopPropagation(),a(!r())},{signal:this._ac.signal}),document.addEventListener("click",()=>a(!1),{signal:this._ac.signal}),i.addEventListener("click",l=>{l.stopPropagation();let h=l.target.closest(".speed-option");h&&n(h)},{signal:this._ac.signal}),t.closest(".waveform-speed")?.addEventListener("keydown",l=>{let h=s(),c=h.indexOf(document.activeElement);if(!r()){(l.key==="ArrowDown"||l.key==="ArrowUp")&&document.activeElement===t&&(l.preventDefault(),a(!0));return}switch(l.key){case"ArrowDown":l.preventDefault(),o(c<0?0:c+1);break;case"ArrowUp":l.preventDefault(),o(c<0?h.length-1:c-1);break;case"Home":l.preventDefault(),o(0);break;case"End":l.preventDefault(),o(h.length-1);break;case"Escape":l.preventDefault(),a(!1),t.focus();break;case"Tab":a(!1);break}},{signal:this._ac.signal}),this.updateSpeedUI()}initKeyboardControls(){this.container.setAttribute("tabindex","-1"),this.container.addEventListener("click",t=>{t.target.closest(It)||(e.getAllInstances().forEach(i=>{i!==this&&i.container.setAttribute("tabindex","-1")}),this.container.setAttribute("tabindex","0"),this.container.focus())},{signal:this._ac.signal}),this.container.addEventListener("keydown",t=>{if(document.activeElement!==this.container)return;let i=t.key,s=!!this.audio,r=s?this.audio.currentTime:0;if(s&&i>="0"&&i<="9"){t.preventDefault(),this.seekToPercent(parseInt(i)/10);return}let a={" ":()=>this.togglePlay()};s&&(a.ArrowLeft=()=>this.seekTo(m(r-5,0,this.audio.duration)),a.ArrowRight=()=>this.seekTo(m(r+5,0,this.audio.duration)),a.ArrowUp=()=>this.setVolume(m(this.audio.volume+.1)),a.ArrowDown=()=>this.setVolume(m(this.audio.volume-.1)),a.m=a.M=()=>this.audio.muted=!this.audio.muted),a[i]&&(t.preventDefault(),a[i]())},{signal:this._ac.signal})}initSeekControl(){this.options.accessibleSeek&&(this.seekEl=this.container.querySelector(".waveform-container"),this.seekEl&&(this.seekEl.setAttribute("role","slider"),this.seekEl.setAttribute("tabindex","0"),this.seekEl.setAttribute("aria-valuemin","0"),this.applySeekLabel(),this.updateSeekAccessibility(),this.seekEl.addEventListener("keydown",t=>{if(t.key===" "||t.key==="Spacebar"){t.preventDefault(),t.stopPropagation(),this.togglePlay();return}let i=this.getSeekDuration();if(!i)return;let s=this.getSeekCurrentTime(),r;switch(t.key){case"ArrowLeft":case"ArrowDown":r=s-bt;break;case"ArrowRight":case"ArrowUp":r=s+bt;break;case"PageDown":r=s-wt;break;case"PageUp":r=s+wt;break;case"Home":r=0;break;case"End":r=i;break;default:return}t.preventDefault(),t.stopPropagation(),this.seekToSeconds(r)},{signal:this._ac.signal})))}getSeekDuration(){return this.options.audioMode==="external"?this._extDuration||0:this.audio&&Number.isFinite(this.audio.duration)?this.audio.duration:0}getSeekCurrentTime(){return this.options.audioMode==="external"?this.progress*(this._extDuration||0):this.audio&&Number.isFinite(this.audio.currentTime)?this.audio.currentTime:0}seekToSeconds(t){let i=this.getSeekDuration();if(!i)return;let s=m(t,0,i);if(this.options.audioMode==="external"){this._requestSeek(s/i),this.updateSeekAccessibility();return}this.seekTo(s)}applySeekLabel(t=this.options.title){if(!this.seekEl)return;let i=this.options.seekLabel||t||"Seek";this.seekEl.setAttribute("aria-label",i)}updateSeekAccessibility(){if(!this.seekEl)return;let t=this.getSeekDuration(),i=Math.min(this.getSeekCurrentTime(),t);this.seekEl.setAttribute("aria-valuemax",String(Math.round(t))),this.seekEl.setAttribute("aria-valuenow",String(Math.round(i))),this.seekEl.setAttribute("aria-valuetext",ot(this.options.seekValueText||"%1$s of %2$s",E(i),E(t)))}initMediaSession(){if(!("mediaSession"in navigator)||!this.options.enableMediaSession||!this.audio)return;this._applyMediaMetadata(),navigator.mediaSession.setActionHandler("play",()=>this.play()),navigator.mediaSession.setActionHandler("pause",()=>this.pause()),navigator.mediaSession.setActionHandler("seekbackward",()=>{this.seekTo(m(this.audio.currentTime-10,0,this.audio.duration))}),navigator.mediaSession.setActionHandler("seekforward",()=>{this.seekTo(m(this.audio.currentTime+10,0,this.audio.duration))}),navigator.mediaSession.setActionHandler("seekto",s=>{s.seekTime!==null&&this.seekTo(s.seekTime)});let t=this.options.onNextTrack,i=this.options.onPreviousTrack;try{navigator.mediaSession.setActionHandler("nexttrack",typeof t=="function"?()=>t(this):null)}catch{}try{navigator.mediaSession.setActionHandler("previoustrack",typeof i=="function"?()=>i(this):null)}catch{}}_applyMediaMetadata(){!("mediaSession"in navigator)||!this.options.enableMediaSession||(navigator.mediaSession.metadata=new MediaMetadata({title:this.options.title||this.options.unknownTrackText,artist:this.options.artist||"",album:this.options.album||"",artwork:this.options.artwork?[{src:this.options.artwork,sizes:"512x512",type:"image/jpeg"}]:[]}))}_updateMediaSession(t){if(!(!("mediaSession"in navigator)||!this.options.enableMediaSession||!this.audio))try{t==="playing"&&this.initMediaSession(),navigator.mediaSession.playbackState=t;let i=this.audio.duration;navigator.mediaSession.setPositionState&&i&&isFinite(i)&&navigator.mediaSession.setPositionState({duration:i,playbackRate:this.audio.playbackRate||1,position:m(this.audio.currentTime,0,i)})}catch{}}bindEvents(){this.playBtn&&this.playBtn.addEventListener("click",()=>this.togglePlay()),this.audio&&(this.audio.addEventListener("loadstart",()=>this.setLoading(!0)),this.audio.addEventListener("loadedmetadata",()=>this.onMetadataLoaded()),this.audio.addEventListener("canplay",()=>this.setLoading(!1)),this.audio.addEventListener("play",()=>this.onPlay()),this.audio.addEventListener("pause",()=>this.onPause()),this.audio.addEventListener("ended",()=>this.onEnded()),this.audio.addEventListener("error",i=>this.onError(i))),this.canvas.addEventListener("click",i=>this.handleCanvasClick(i)),this._dragging=!1,this._seekHover=!1,this._handleNear=!1,this.canvas.addEventListener("pointerenter",()=>{this._seekHover=!0,this.drawWaveform(),this._updateSeekHandle()}),this.canvas.addEventListener("pointerleave",()=>{this._seekHover=!1,this._handleNear=!1,this._dragging||this._hideHoverTip(),this.drawWaveform(),this._updateSeekHandle()}),this.canvas.addEventListener("pointerdown",i=>{if(!(i.pointerType==="mouse"&&i.button!==0)){this._dragging=!0;try{this.canvas.setPointerCapture(i.pointerId)}catch{}this._scrubTo(i.clientX)}}),this.canvas.addEventListener("pointermove",i=>{if(this._dragging){this._scrubTo(i.clientX);return}let s=this.canvas.getBoundingClientRect();s.width&&(this._handleNear=Math.abs(i.clientX-s.left-this.progress*s.width)<=10,this._updateSeekHandle())});let t=i=>{if(this._dragging){this._dragging=!1,this._suppressClick=!0;try{this.canvas.releasePointerCapture(i.pointerId)}catch{}this._seekFromPointer(i.clientX),!this._seekHover&&!this.options.showHoverTime&&this._hideHoverTip(),this._updateSeekHandle()}};this.canvas.addEventListener("pointerup",t),this.canvas.addEventListener("pointercancel",t),this.setupHoverTime(),this.setupSeekHandle(),this.resizeHandler=ht(()=>this.resizeCanvas(),100),window.addEventListener("resize",this.resizeHandler)}setupResizeObserver(){"ResizeObserver"in window&&(this.resizeObserver=new ResizeObserver(()=>{this.resizeCanvas()}),this.canvas?.parentElement&&this.resizeObserver.observe(this.canvas.parentElement))}async load(t){try{this.setLoading(!0),this.progress=0,this.hasError=!1,this.container.classList.remove("waveform-is-placeholder");let i=!!this.options.waveform;i&&this.setWaveformData(this.options.waveform),this.audio&&(this.audio.src=t,this.audio.preload!=="none"&&await new Promise((r,a)=>{let o=()=>{this.audio.removeEventListener("loadedmetadata",o),this.audio.removeEventListener("error",n),r()},n=l=>{this.audio.removeEventListener("loadedmetadata",o),this.audio.removeEventListener("error",n),a(l)};this.audio.addEventListener("loadedmetadata",o),this.audio.addEventListener("error",n)}));let s=this.options.title||I(t);if(this.titleEl&&(this.titleEl.textContent=s),this.applySeekLabel(s),!i)try{let r=await G(t,this.options.samples,this.options.showBPM);this.waveformData=r.peaks,r.bpm&&(this.detectedBPM=r.bpm,this.updateBPMDisplay())}catch(r){console.warn("[WaveformPlayer] Using placeholder waveform:",r),this.waveformData=yt(this.options.samples),this.container.classList.add("waveform-is-placeholder")}this.drawWaveform(),this.renderMarkers(),this.options.onLoad&&this.options.onLoad(this)}catch(i){this.onError(i)}finally{this.setLoading(!1)}}async loadTrack(t,i=null,s=null,r={}){let a=Object.prototype.hasOwnProperty.call(r,"artwork"),o=Object.prototype.hasOwnProperty.call(r,"artworkAlt");this.isPlaying&&this.pause(),this.audio&&(this.audio.src="",this.audio.load()),this.hasError=!1,this.errorEl&&(this.errorEl.style.display="none"),this.canvas&&(this.canvas.style.opacity="1"),this.playBtn&&(this.playBtn.disabled=!1),this.progress=0,this.waveformData=[],this.options=Z(j(this.options,{url:t,title:i===null?this.options.title:i,artist:s===null?this.options.artist:s,...r})),a&&(this.options.artwork=r.artwork||null),o?this.options.artworkAlt=r.artworkAlt||"":a&&(this.options.artworkAlt=this.options.artwork?W.artworkAlt:""),r.preload&&this.audio&&(this.audio.preload=this.options.preload),r.crossOrigin&&this.audio&&(this.audio.crossOrigin=this.options.crossOrigin),s!==null&&this.syncArtist(s),(a||o)&&this.syncArtwork(a?r.artwork:this.options.artwork,o?r.artworkAlt:this.options.artworkAlt),this.options.markers=r.markers?z(r.markers):[],this.options.waveform=r.waveform||null,await this.load(t),r.autoplay!==!1&&this.play()?.catch(()=>{})}setWaveformData(t){if(typeof t=="string"&&t.trim().endsWith(".json")){fetch(t.trim()).then(i=>i.json()).then(i=>{this.waveformData=Array.isArray(i)?i:i.peaks||[],i.markers&&!this.options.markers?.length&&(this.options.markers=z(i.markers),this.renderMarkers()),this.drawWaveform()}).catch(()=>{});return}this.waveformData=D(t,{fallback:[]}),this.drawWaveform()}drawWaveform(){!this.ctx||this.waveformData.length===0||ft(this.ctx,this.canvas,this.waveformData,this.progress,{...this.options,waveformStyle:this.options.waveformStyle||"bars",color:this.options.waveformColor,progressColor:this.options.progressColor,seekActive:this._seekHover||this._dragging})}resizeCanvas(){if(!this.canvas||this.isDestroying)return;let t=window.devicePixelRatio||1,i=this.canvas.parentElement.getBoundingClientRect();this.canvas.width=i.width*t,this.canvas.height=this.options.height*t,this.canvas.parentElement.style.height=this.options.height+"px",this.drawWaveform()}renderMarkers(){if(!this.markersContainer||(this.markersContainer.innerHTML="",this._activeMarkerIndex=-1,clearTimeout(this._markerLabelTimer),!this.options.showMarkers||!this.options.markers?.length))return;let t=this.getSeekDuration();t&&this.options.markers.forEach((i,s)=>{if(i.time>t){console.warn(`[WaveformPlayer] Marker "${i.label}" at ${i.time}s exceeds audio duration of ${t}s`);return}let r=i.time/t*100,a=document.createElement("button");a.className="waveform-marker",a.style.left=`${r}%`,a.style.backgroundColor=i.color||"rgba(255, 255, 255, 0.5)",a.setAttribute("aria-label",i.label),a.setAttribute("data-time",i.time);let o=document.createElement("span");o.className="waveform-marker-tooltip",o.textContent=i.label,a.appendChild(o),a.addEventListener("click",n=>{n.stopPropagation(),this.seekTo(i.time),this.options.playOnSeek&&!this.isPlaying&&this.play()}),this.markersContainer.appendChild(a)})}setActiveMarker(t){if(!this.markersContainer)return;this.markersContainer.querySelectorAll(".waveform-marker").forEach((s,r)=>s.classList.toggle("active",r===t))}updateActiveMarker(){if(!this.markersContainer)return;let t=this.markersContainer.querySelectorAll(".waveform-marker");if(!t.length)return;let i=this.getSeekDuration(),s=i?this.progress*i:0,r=-1,a=-1/0;t.forEach((o,n)=>{let l=parseFloat(o.getAttribute("data-time"));Number.isFinite(l)&&l<=s+.05&&l>a&&(a=l,r=n)}),r!==this._activeMarkerIndex&&(this._activeMarkerIndex=r,this.setActiveMarker(r),clearTimeout(this._markerLabelTimer),t.forEach((o,n)=>o.classList.toggle("show-label",n===r)),r>=0&&(this._markerLabelTimer=setTimeout(()=>{this.markersContainer?.querySelectorAll(".waveform-marker").forEach(o=>o.classList.remove("show-label"))},2500)))}setupHoverTime(){if(!this.seekEl)return;let t=document.createElement("div");t.className="waveform-hover-time",t.setAttribute("aria-hidden","true"),this.seekEl.appendChild(t),this.hoverTimeEl=t,this.options.showHoverTime&&(this.seekEl.addEventListener("pointermove",i=>{this._dragging||this._updateHoverTip(i.clientX)}),this.seekEl.addEventListener("pointerleave",()=>{this._dragging||this._hideHoverTip()}))}_updateHoverTip(t){let i=this.hoverTimeEl;if(!i)return;let s=this.getSeekDuration();if(!s){i.style.opacity="0";return}let r=this.canvas.getBoundingClientRect(),a=m((t-r.left)/r.width);i.textContent=E(a*s),i.style.left=a*100+"%",i.style.opacity="1"}_hideHoverTip(){this.hoverTimeEl&&(this.hoverTimeEl.style.opacity="0")}_scrubTo(t){let i=this.canvas.getBoundingClientRect();if(!i.width)return;this.progress=m((t-i.left)/i.width),this.drawWaveform(),this._updateSeekHandle();let s=this.getSeekDuration();s&&this.currentTimeEl?(this.currentTimeEl.textContent=E(this.progress*s),this._hideHoverTip()):this._updateHoverTip(t)}setupSeekHandle(){if(!this.options.seekHandle||this.options.waveformStyle!=="seekbar"||!this.seekEl)return;let t=document.createElement("div");t.className="waveform-seek-handle",t.setAttribute("aria-hidden","true"),this.seekEl.appendChild(t),this.seekHandleEl=t}_updateSeekHandle(){let t=this.seekHandleEl;t&&(t.style.left=this.progress*100+"%",t.classList.toggle("is-visible",this._seekHover||this._dragging),t.classList.toggle("is-active",this._dragging||this._handleNear))}handleCanvasClick(t){if(this._suppressClick){this._suppressClick=!1;return}this._seekFromPointer(t.clientX)}_seekFromPointer(t){let i=this.canvas.getBoundingClientRect();if(!i.width)return;let s=m((t-i.left)/i.width);if(this.options.audioMode==="external"){this._requestSeek(s);return}!this.audio||!this.audio.duration||this.seekToPercent(s)}setLoading(t){if(this.isLoading=t,this.loadingEl){let i=t&&this.waveformData.length===0;this.loadingEl.style.display=i?"block":"none"}this.seekEl&&this.seekEl.setAttribute("aria-busy",t?"true":"false")}onMetadataLoaded(){this.isDestroying||(this.totalTimeEl&&(this.totalTimeEl.textContent=E(this.audio.duration)),this.renderMarkers(),this.updateSeekAccessibility())}setPlayButtonState(t){if(!this.playBtn)return;this.playBtn.classList.toggle("playing",t);let i=this.playBtn.querySelector(".waveform-icon-play"),s=this.playBtn.querySelector(".waveform-icon-pause");i&&(i.style.display=t?"none":"flex"),s&&(s.style.display=t?"flex":"none")}onPlay(){this.isDestroying||(this.isPlaying=!0,this.setPlayButtonState(!0),this.startSmoothUpdate(),this._updateMediaSession("playing"),this._emit("waveformplayer:play",{player:this,url:this.options.url}),this.options.onPlay&&this.options.onPlay(this))}onPause(){this.isDestroying||(this.isPlaying=!1,this.setPlayButtonState(!1),this.stopSmoothUpdate(),this._updateMediaSession("paused"),this._emit("waveformplayer:pause",{player:this,url:this.options.url}),this.options.onPause&&this.options.onPause(this))}onEnded(){if(this.isDestroying)return;let t=this.audio.duration;this.progress=0,this.audio.currentTime=0,this.drawWaveform(),this.currentTimeEl&&(this.currentTimeEl.textContent="0:00"),this._emit("waveformplayer:ended",{player:this,url:this.options.url,currentTime:t,duration:t}),this.onPause(),this.options.onEnd&&this.options.onEnd(this)}onError(t){this.isDestroying||(console.error("[WaveformPlayer] Audio error:",t),this.hasError=!0,this.setLoading(!1),this.errorEl&&(this.errorEl.style.display="flex"),this.canvas&&(this.canvas.style.opacity="0.2"),this.playBtn&&(this.playBtn.disabled=!0),this.options.onError&&this.options.onError(t,this))}startSmoothUpdate(){this.stopSmoothUpdate();let t=()=>{this.isPlaying&&this.audio&&this.audio.duration&&(this.updateProgress(),this.updateTimer=requestAnimationFrame(t))};this.updateTimer=requestAnimationFrame(t)}stopSmoothUpdate(){this.updateTimer&&(cancelAnimationFrame(this.updateTimer),this.updateTimer=null)}updateProgress(){if(!this.audio||!this.audio.duration||this._dragging)return;let t=this.audio.currentTime/this.audio.duration;Math.abs(t-this.progress)>.001&&(this.progress=t,this.drawWaveform(),this._updateSeekHandle()),this.currentTimeEl&&(this.currentTimeEl.textContent=E(this.audio.currentTime)),this._emit("waveformplayer:timeupdate",{player:this,currentTime:this.audio.currentTime,duration:this.audio.duration,progress:this.progress,url:this.options.url}),this.options.onTimeUpdate&&this.options.onTimeUpdate(this.audio.currentTime,this.audio.duration,this),this.updateActiveMarker(),this.updateSeekAccessibility()}updateBPMDisplay(){let t=this.options.bpm||this.detectedBPM;this.bpmEl&&this.bpmValueEl&&t&&(this.bpmValueEl.textContent=Math.round(t),this.bpmEl.style.display="inline-flex")}refreshTheme(){if(!this._autoTheme)return;this._scheme=R(this.container);let t=J(this.options.colorPreset,this.container);for(let i of this._presetKeys||[])i in t&&(this.options[i]=t[i]);this._applyThemeColors()}_applyThemeColors(){this.container.classList.toggle("waveform-theme-light",this._scheme==="light"),this.canvas&&this.drawWaveform()}static _watchTheme(){if(e._themeWatch||typeof document>"u")return;let t=()=>requestAnimationFrame(()=>{e.instances.forEach(a=>{try{a.refreshTheme()}catch{}})}),i={attributes:!0,attributeFilter:["class","data-theme","data-color-scheme","style"]},s=new MutationObserver(t);s.observe(document.documentElement,i),document.body&&s.observe(document.body,i);let r=null;try{r=window.matchMedia("(prefers-color-scheme: dark)"),r.addEventListener("change",t)}catch{}e._themeWatch={obs:s,mq:r,refresh:t}}updateSpeedUI(){if(!this.audio)return;let t=this.container.querySelector(".speed-value");if(t){let i=this.audio.playbackRate;t.textContent=i===1?"1x":`${i}x`}this.container.querySelectorAll(".speed-option").forEach(i=>{let s=parseFloat(i.dataset.rate)===this.audio.playbackRate;i.classList.toggle("active",s),i.setAttribute("aria-checked",s?"true":"false")})}play(){if(this.options.singlePlay&&e.currentlyPlaying&&e.currentlyPlaying!==this&&e.currentlyPlaying.pause(),this.options.audioMode==="external"){this._emit("waveformplayer:request-play",this._buildTrackDetail(),!0).defaultPrevented||(e.currentlyPlaying=this);return}return e.currentlyPlaying=this,this.audio.play()}pause(){if(e.currentlyPlaying===this&&(e.currentlyPlaying=null),this.options.audioMode==="external"){this._emit("waveformplayer:request-pause",this._buildTrackDetail(),!0);return}this.audio.pause()}_buildTrackDetail(){return{url:this.options.url,title:this.options.title,artist:this.options.artist,artwork:this.options.artwork,markers:this.options.markers,waveform:this.options.waveform,id:this.id,player:this}}setPlayingState(t){let i=this.isPlaying;this.isPlaying=!!t,this.setPlayButtonState(this.isPlaying),this.isPlaying&&!i?(this.startSmoothUpdate?.(),this._emit("waveformplayer:play",{player:this,url:this.options.url}),this.options.onPlay&&this.options.onPlay(this)):!this.isPlaying&&i&&(this.stopSmoothUpdate?.(),this._emit("waveformplayer:pause",{player:this,url:this.options.url}),this.options.onPause&&this.options.onPause(this))}setProgress(t,i){!i||i<=0||(this.progress=m(t/i),this.currentTimeEl&&(this.currentTimeEl.textContent=E(t)),this._extDuration=i,this.totalTimeEl&&(!this.totalTimeEl.dataset._extSet||this.totalTimeEl.dataset._extDur!==String(i))&&(this.totalTimeEl.textContent=E(i),this.totalTimeEl.dataset._extSet="1",this.totalTimeEl.dataset._extDur=String(i)),this.drawWaveform?.(),this.updateActiveMarker(),this._emit("waveformplayer:timeupdate",{player:this,currentTime:t,duration:i,progress:this.progress,url:this.options.url}),this.options.onTimeUpdate&&this.options.onTimeUpdate(t,i,this),this.progress>=1?this._extEnded||(this._extEnded=!0,this._emit("waveformplayer:ended",{player:this,url:this.options.url,currentTime:i,duration:i}),this.options.onEnd&&this.options.onEnd(this)):this._extEnded=!1,this.updateSeekAccessibility())}togglePlay(){this.isPlaying?this.pause():this.play()}seekTo(t){this.audio&&this.audio.duration&&(this.audio.currentTime=m(t,0,this.audio.duration),this.updateProgress())}seekToPercent(t){this.audio&&this.audio.duration&&(this.audio.currentTime=this.audio.duration*m(t),this.updateProgress())}setVolume(t){let i=Number(t);this.audio&&Number.isFinite(i)&&(this.audio.volume=m(i))}setPlaybackRate(t){if(!this.audio)return;let i=_(t,null,{min:N,max:F});i!==null&&(this.audio.playbackRate=i,this.options.playbackRate=i,this.updateSpeedUI())}destroy(){this.isDestroying=!0,this._emit("waveformplayer:destroy",{player:this,url:this.options.url}),this.pause(),this.stopSmoothUpdate(),clearTimeout(this._markerLabelTimer),this._ac?.abort(),this.resizeObserver&&(this.resizeObserver.disconnect(),this.resizeObserver=null),this.resizeHandler&&(window.removeEventListener("resize",this.resizeHandler),this.resizeHandler=null),e.instances.delete(this.id),e.currentlyPlaying===this&&(e.currentlyPlaying=null),this.audio&&(this.audio.pause(),this.audio.src="",this.audio.load(),this.audio=null),this.container.innerHTML="",this.canvas=null,this.ctx=null,this.playBtn=null,this.waveformData=[]}static getInstance(t){if(typeof t=="string"){let i=this.instances.get(t);if(i)return i;let s=document.getElementById(t);if(s)return Array.from(this.instances.values()).find(r=>r.container===s)}if(t instanceof HTMLElement)return Array.from(this.instances.values()).find(i=>i.container===t)}static getAllInstances(){return Array.from(this.instances.values())}static destroyAll(){this.instances.forEach(t=>t.destroy()),this.instances.clear()}static async generateWaveformData(t,i=1800){try{return(await G(t,i)).peaks}catch(s){throw console.error("[WaveformPlayer] Failed to generate waveform:",s),s}}static getPeaksUrl(t){if(!t)return;let i=t.replace(/\.(mp3|wav|ogg|flac|m4a|aac)(\?[^#]*)?(#.*)?$/i,".json$2$3");return i===t?void 0:i}};T.utils={formatTime:E,extractTitleFromUrl:I,escapeHtml:S,isSafeHref:st,parseDataAttributes:O,detectColorScheme:R};var et=()=>typeof window<"u"&&typeof document<"u";function tt(){if(!et())return;document.querySelectorAll("[data-waveform-player]").forEach(t=>{if(!(t.dataset.waveformInitialized==="true"||T.getInstance(t)))try{new T(t),t.dataset.waveformInitialized="true"}catch(i){console.error("[WaveformPlayer] Failed to initialize:",i,t)}})}et()&&(document.readyState==="loading"?document.addEventListener("DOMContentLoaded",tt):tt());T.init=tt;et()&&(window.WaveformPlayer=T);var ee=T;})();
package/index.d.ts CHANGED
@@ -136,7 +136,11 @@ export interface WaveformPlayerOptions {
136
136
  playbackRate?: number;
137
137
  /** Show the playback-speed control. @default false */
138
138
  showPlaybackSpeed?: boolean;
139
- /** Selectable playback rates. @default [0.5, 0.75, 1, 1.25, 1.5, 1.75, 2] */
139
+ /**
140
+ * Selectable playback rates. Entries outside 0.25–4 (the range browsers keep
141
+ * audible, and the range `setPlaybackRate` clamps to) are dropped.
142
+ * @default [0.5, 0.75, 1, 1.25, 1.5, 1.75, 2]
143
+ */
140
144
  playbackRates?: number[];
141
145
 
142
146
  // ── Layout / UI toggles ───────────────────────────────────────
@@ -364,7 +368,7 @@ export declare class WaveformPlayer {
364
368
  seekToPercent(percent: number): void;
365
369
  /** Set output volume, 0..1 (self mode). */
366
370
  setVolume(volume: number): void;
367
- /** Set the playback rate (self mode). */
371
+ /** Set the playback rate, clamped to 0.25–4 (self mode). */
368
372
  setPlaybackRate(rate: number): void;
369
373
  /** Provide pre-computed peaks directly. */
370
374
  setWaveformData(data: WaveformPeaks): void;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@arraypress/waveform-player",
3
- "version": "1.24.4",
3
+ "version": "1.25.0",
4
4
  "description": "Lightweight, customizable audio player with waveform visualization",
5
5
  "type": "module",
6
6
  "types": "./index.d.ts",
package/src/js/core.js CHANGED
@@ -16,10 +16,23 @@ import {
16
16
  clamp,
17
17
  escapeHtml,
18
18
  formatCssLength,
19
+ toFiniteNumber,
20
+ toNumberArray,
19
21
  DEFAULT_SAMPLES
20
22
  } from './utils.js';
21
23
 
22
- import {DEFAULT_OPTIONS, STYLE_DEFAULTS, getColorPreset, COLOR_PRESETS, detectColorScheme} from './themes.js';
24
+ import {
25
+ DEFAULT_OPTIONS,
26
+ STYLE_DEFAULTS,
27
+ getColorPreset,
28
+ COLOR_PRESETS,
29
+ detectColorScheme,
30
+ normalizeOptions,
31
+ normalizeMarkers,
32
+ BUTTON_ALIGNMENTS,
33
+ PLAYBACK_RATE_MIN,
34
+ PLAYBACK_RATE_MAX
35
+ } from './themes.js';
23
36
 
24
37
  /**
25
38
  * Placeholder shown when an artwork URL fails to load (404 / broken) — a muted
@@ -40,12 +53,6 @@ const SEEK_PAGE_SECONDS = 10;
40
53
  // wrapper, moving it off the control the user just operated.
41
54
  const INTERACTIVE_ELEMENTS = 'button, a[href], input, [role="slider"]';
42
55
 
43
- // Recognised `buttonAlign` values. `createDOM` interpolates the resolved value
44
- // into a class name, so an unrecognised value is coerced back to 'auto' rather
45
- // than reaching the template — that guards both configuration paths (constructor
46
- // options and `data-button-align`) at the single point of use.
47
- const BUTTON_ALIGNMENTS = ['auto', 'top', 'center', 'bottom'];
48
-
49
56
  /**
50
57
  * WaveformPlayer - Modern audio player with waveform visualization
51
58
  * @class
@@ -93,8 +100,12 @@ export class WaveformPlayer {
93
100
  if (userOptions.style && !userOptions.waveformStyle) userOptions.waveformStyle = userOptions.style;
94
101
  if (userOptions.src && !userOptions.url) userOptions.url = userOptions.src;
95
102
 
96
- // Merge options: defaults < data attributes < constructor options
97
- this.options = mergeOptions(DEFAULT_OPTIONS, dataOptions, userOptions);
103
+ // Merge options: defaults < data attributes < constructor options, then
104
+ // normalize the result. Both configuration paths are untyped, so this is
105
+ // the single point where an unusable value (non-array `playbackRates`,
106
+ // NaN geometry, an unrecognised enum) resolves to its default instead of
107
+ // reaching a consumer that assumes a shape it never checked.
108
+ this.options = normalizeOptions(mergeOptions(DEFAULT_OPTIONS, dataOptions, userOptions));
98
109
 
99
110
  // Apply color preset (auto-detect if not specified). Detection reads
100
111
  // the backdrop behind THIS container, so a player dropped into a themed
@@ -253,7 +264,10 @@ export class WaveformPlayer {
253
264
  this.container.innerHTML = '';
254
265
  this.container.className = 'waveform-player';
255
266
 
256
- // Determine button alignment
267
+ // Determine button alignment. normalizeOptions() has already rejected
268
+ // unrecognised values, but the resolved name is interpolated into a
269
+ // class name, so the allowlist is re-checked at the point of use —
270
+ // options stay publicly mutable after construction.
257
271
  let buttonAlign = BUTTON_ALIGNMENTS.includes(this.options.buttonAlign)
258
272
  ? this.options.buttonAlign
259
273
  : 'auto';
@@ -1148,9 +1162,10 @@ export class WaveformPlayer {
1148
1162
  * element, so the src/metadata step is skipped and only the visualization
1149
1163
  * is built (duration/time come from the controller via
1150
1164
  * {@link WaveformPlayer#setProgress}). Peaks come from the `waveform`
1151
- * option when provided, otherwise they are decoded from the audio; a
1152
- * decode failure falls back to a placeholder waveform. The `onLoad`
1153
- * callback fires on success.
1165
+ * option when provided — painted *before* the metadata wait, since they
1166
+ * need nothing from the audio element — otherwise they are decoded from
1167
+ * the audio; a decode failure falls back to a placeholder waveform. The
1168
+ * `onLoad` callback fires on success.
1154
1169
  * @param {string} url - Audio URL.
1155
1170
  * @returns {Promise<void>} Resolves once loading settles (errors are caught
1156
1171
  * internally and surfaced through {@link WaveformPlayer#onError}).
@@ -1162,6 +1177,16 @@ export class WaveformPlayer {
1162
1177
  this.hasError = false;
1163
1178
  this.container.classList.remove('waveform-is-placeholder');
1164
1179
 
1180
+ // Caller-supplied peaks describe the file, not the element's
1181
+ // playback state, so draw them up front rather than behind the
1182
+ // metadata wait below. On a slow (or non-Range-capable) audio
1183
+ // origin that wait is seconds long, and the canvas used to sit
1184
+ // blank for all of it. See issue #23.
1185
+ const hasInlinePeaks = !!this.options.waveform;
1186
+ if (hasInlinePeaks) {
1187
+ this.setWaveformData(this.options.waveform);
1188
+ }
1189
+
1165
1190
  // In external mode we don't own an <audio> element — skip
1166
1191
  // src assignment + metadata-wait, but still generate the
1167
1192
  // waveform peaks so the canvas can render the visualization.
@@ -1171,21 +1196,30 @@ export class WaveformPlayer {
1171
1196
  // Set audio source
1172
1197
  this.audio.src = url;
1173
1198
 
1174
- // Wait for metadata to load
1175
- await new Promise((resolve, reject) => {
1176
- const metadataHandler = () => {
1177
- this.audio.removeEventListener('loadedmetadata', metadataHandler);
1178
- this.audio.removeEventListener('error', errorHandler);
1179
- resolve();
1180
- };
1181
- const errorHandler = (e) => {
1182
- this.audio.removeEventListener('loadedmetadata', metadataHandler);
1183
- this.audio.removeEventListener('error', errorHandler);
1184
- reject(e);
1185
- };
1186
- this.audio.addEventListener('loadedmetadata', metadataHandler);
1187
- this.audio.addEventListener('error', errorHandler);
1188
- });
1199
+ // preload="none" tells the browser to fetch nothing until
1200
+ // play(), so `loadedmetadata` will never arrive and awaiting
1201
+ // it would strand the rest of this method forever (no title,
1202
+ // no markers, no onLoad, loading state stuck on). Skip the
1203
+ // wait; the bindEvents() `loadedmetadata` listener still
1204
+ // fires whenever metadata does land, and onMetadataLoaded()
1205
+ // fills in duration + markers then.
1206
+ if (this.audio.preload !== 'none') {
1207
+ // Wait for metadata to load
1208
+ await new Promise((resolve, reject) => {
1209
+ const metadataHandler = () => {
1210
+ this.audio.removeEventListener('loadedmetadata', metadataHandler);
1211
+ this.audio.removeEventListener('error', errorHandler);
1212
+ resolve();
1213
+ };
1214
+ const errorHandler = (e) => {
1215
+ this.audio.removeEventListener('loadedmetadata', metadataHandler);
1216
+ this.audio.removeEventListener('error', errorHandler);
1217
+ reject(e);
1218
+ };
1219
+ this.audio.addEventListener('loadedmetadata', metadataHandler);
1220
+ this.audio.addEventListener('error', errorHandler);
1221
+ });
1222
+ }
1189
1223
  }
1190
1224
 
1191
1225
  // Set title
@@ -1196,10 +1230,8 @@ export class WaveformPlayer {
1196
1230
  // Keep the seek slider's accessible name in sync with the track.
1197
1231
  this.applySeekLabel(title);
1198
1232
 
1199
- // Load or generate waveform
1200
- if (this.options.waveform) {
1201
- this.setWaveformData(this.options.waveform);
1202
- } else {
1233
+ // Peaks were drawn above; only the decode path is left.
1234
+ if (!hasInlinePeaks) {
1203
1235
  // Generate waveform
1204
1236
  try {
1205
1237
  const result = await generateWaveform(url, this.options.samples, this.options.showBPM);
@@ -1280,13 +1312,15 @@ export class WaveformPlayer {
1280
1312
  this.progress = 0;
1281
1313
  this.waveformData = [];
1282
1314
 
1283
- // Update options (including preload if specified)
1284
- this.options = mergeOptions(this.options, {
1315
+ // Update options (including preload if specified). Normalized on the
1316
+ // same terms as the constructor — loadTrack takes a fresh, caller-
1317
+ // supplied option set, so it's the second untyped entry point.
1318
+ this.options = normalizeOptions(mergeOptions(this.options, {
1285
1319
  url,
1286
1320
  title: title === null ? this.options.title : title,
1287
1321
  artist: artist === null ? this.options.artist : artist,
1288
1322
  ...options
1289
- });
1323
+ }));
1290
1324
  if (hasArtworkOption) {
1291
1325
  this.options.artwork = options.artwork || null;
1292
1326
  }
@@ -1296,14 +1330,16 @@ export class WaveformPlayer {
1296
1330
  this.options.artworkAlt = this.options.artwork ? DEFAULT_OPTIONS.artworkAlt : '';
1297
1331
  }
1298
1332
 
1299
- // Apply preload setting if it was changed
1333
+ // Apply preload setting if it was changed. The caller's value decides
1334
+ // WHETHER to apply; the normalized one decides WHAT to apply, so an
1335
+ // unsupported value can't reach the media element.
1300
1336
  if (options.preload && this.audio) {
1301
- this.audio.preload = options.preload;
1337
+ this.audio.preload = this.options.preload;
1302
1338
  }
1303
1339
 
1304
1340
  // Apply crossOrigin if it was changed for this track
1305
1341
  if (options.crossOrigin && this.audio) {
1306
- this.audio.crossOrigin = options.crossOrigin;
1342
+ this.audio.crossOrigin = this.options.crossOrigin;
1307
1343
  }
1308
1344
 
1309
1345
  // Update artist only when explicitly provided. A null artist keeps the
@@ -1322,7 +1358,7 @@ export class WaveformPlayer {
1322
1358
  }
1323
1359
 
1324
1360
  // Clear or update markers
1325
- this.options.markers = options.markers || [];
1361
+ this.options.markers = options.markers ? normalizeMarkers(options.markers) : [];
1326
1362
 
1327
1363
  // Reset the waveform to the NEW track's peaks, or null to regenerate
1328
1364
  // from the URL. mergeOptions() above keeps the previous track's
@@ -1365,8 +1401,10 @@ export class WaveformPlayer {
1365
1401
  .then(r => r.json())
1366
1402
  .then(json => {
1367
1403
  this.waveformData = Array.isArray(json) ? json : (json.peaks || []);
1404
+ // A peaks sidecar is a third source of markers, and a remote
1405
+ // one — normalize it on the same terms as the option paths.
1368
1406
  if (json.markers && !this.options.markers?.length) {
1369
- this.options.markers = json.markers;
1407
+ this.options.markers = normalizeMarkers(json.markers);
1370
1408
  this.renderMarkers();
1371
1409
  }
1372
1410
  this.drawWaveform();
@@ -1375,16 +1413,11 @@ export class WaveformPlayer {
1375
1413
  return;
1376
1414
  }
1377
1415
 
1378
- if (typeof data === 'string') {
1379
- try {
1380
- const parsed = JSON.parse(data);
1381
- this.waveformData = Array.isArray(parsed) ? parsed : [];
1382
- } catch {
1383
- this.waveformData = data.split(',').map(Number);
1384
- }
1385
- } else {
1386
- this.waveformData = Array.isArray(data) ? data : [];
1387
- }
1416
+ // Peaks may arrive as an array, a JSON array string, or a bare
1417
+ // comma-separated list — all three collapse into one coercion, which
1418
+ // also drops non-numeric members (the old comma path mapped them to
1419
+ // NaN, and a NaN peak draws as a gap rather than an error).
1420
+ this.waveformData = toNumberArray(data, {fallback: []});
1388
1421
  this.drawWaveform();
1389
1422
  }
1390
1423
 
@@ -1716,9 +1749,17 @@ export class WaveformPlayer {
1716
1749
  setLoading(loading) {
1717
1750
  this.isLoading = loading;
1718
1751
  if (this.loadingEl) {
1719
- this.loadingEl.style.display = loading ? 'block' : 'none';
1720
- }
1721
- // Let assistive tech know the player is busy fetching/decoding.
1752
+ // The indicator stands in for a waveform that isn't there yet, so
1753
+ // it only earns its place while the canvas is empty. Flashing it
1754
+ // over already-drawn peaks — the inline-`waveform` case, where the
1755
+ // wait is just the audio element fetching metadata — reads as a
1756
+ // flicker rather than as progress (issue #23). The decode path
1757
+ // still shows it: waveformData stays empty until peaks resolve.
1758
+ const showIndicator = loading && this.waveformData.length === 0;
1759
+ this.loadingEl.style.display = showIndicator ? 'block' : 'none';
1760
+ }
1761
+ // Let assistive tech know the player is busy fetching/decoding —
1762
+ // true whether or not the visual indicator is warranted.
1722
1763
  if (this.seekEl) {
1723
1764
  this.seekEl.setAttribute('aria-busy', loading ? 'true' : 'false');
1724
1765
  }
@@ -2294,15 +2335,21 @@ export class WaveformPlayer {
2294
2335
  }
2295
2336
 
2296
2337
  /**
2297
- * Set the owned `<audio>` element's playback rate (clamped to 0.5–2),
2338
+ * Set the owned `<audio>` element's playback rate (clamped to 0.25–4),
2298
2339
  * persist it onto `this.options.playbackRate`, and refresh the speed UI.
2299
2340
  * Self mode only — a no-op in external mode.
2300
- * @param {number} rate - Desired playback rate; clamped to the 0.5–2 range.
2341
+ *
2342
+ * The clamp bounds the range browsers keep audible; the default speed menu
2343
+ * offers a narrower 0.5–2, which `playbackRates` can widen up to these
2344
+ * bounds. A non-numeric rate is ignored rather than assigned, since
2345
+ * `audio.playbackRate = NaN` throws.
2346
+ * @param {number} rate - Desired playback rate; clamped to the 0.25–4 range.
2301
2347
  */
2302
2348
  setPlaybackRate(rate) {
2303
2349
  if (!this.audio) return;
2304
2350
 
2305
- const clampedRate = clamp(rate, 0.5, 2);
2351
+ const clampedRate = toFiniteNumber(rate, null, {min: PLAYBACK_RATE_MIN, max: PLAYBACK_RATE_MAX});
2352
+ if (clampedRate === null) return;
2306
2353
  this.audio.playbackRate = clampedRate;
2307
2354
  this.options.playbackRate = clampedRate;
2308
2355