wavesurfer.js 7.0.0-alpha.4 → 7.0.0-alpha.41

package/dist/wavesurfer.js

@@ -0,0 +1,213 @@
+import Fetcher from './fetcher.js';
+import Decoder from './decoder.js';
+import Renderer from './renderer.js';
+import Player from './player.js';
+import Timer from './timer.js';
+const defaultOptions = {
+    height: 128,
+    waveColor: '#999',
+    progressColor: '#555',
+    cursorWidth: 1,
+    minPxPerSec: 0,
+    fillParent: true,
+    interact: true,
+    autoCenter: true,
+};
+class WaveSurfer extends Player {
+    /** Create a new WaveSurfer instance */
+    static create(options) {
+        return new WaveSurfer(options);
+    }
+    /** Create a new WaveSurfer instance */
+    constructor(options) {
+        super({
+            media: options.media,
+            autoplay: options.autoplay,
+            playbackRate: options.audioRate,
+        });
+        this.plugins = [];
+        this.decodedData = null;
+        this.canPlay = false;
+        this.options = Object.assign({}, defaultOptions, options);
+        this.fetcher = new Fetcher();
+        this.timer = new Timer();
+        this.renderer = new Renderer({
+            container: this.options.container,
+        }, this.options);
+        this.initPlayerEvents();
+        this.initRendererEvents();
+        this.initTimerEvents();
+        this.initReadyEvent();
+        this.initPlugins();
+        const url = this.options.url || this.options.media?.src;
+        if (url) {
+            this.load(url, this.options.peaks, this.options.duration);
+        }
+    }
+    setOptions(options) {
+        this.options = { ...this.options, ...options };
+        this.renderer.setOptions(this.options);
+    }
+    initPlayerEvents() {
+        this.subscriptions.push(this.onMediaEvent('timeupdate', () => {
+            const currentTime = this.getCurrentTime();
+            this.renderer.renderProgress(currentTime / this.getDuration(), this.isPlaying());
+            this.emit('timeupdate', currentTime);
+        }), this.onMediaEvent('play', () => {
+            this.emit('play');
+            this.timer.start();
+        }), this.onMediaEvent('pause', () => {
+            this.emit('pause');
+            this.timer.stop();
+            if (this.getCurrentTime() >= this.getDuration()) {
+                this.emit('finish');
+            }
+        }), this.onMediaEvent('canplay', () => {
+            this.canPlay = true;
+            this.emit('canplay', this.getDuration());
+        }), this.onMediaEvent('seeking', () => {
+            this.emit('seeking', this.getCurrentTime());
+        }));
+    }
+    initRendererEvents() {
+        // Seek on click
+        this.subscriptions.push(this.renderer.on('click', (relativeX) => {
+            if (this.options.interact) {
+                this.canPlay && this.seekTo(relativeX);
+                this.emit('interaction');
+            }
+        }));
+    }
+    initTimerEvents() {
+        // The timer fires every 16ms for a smooth progress animation
+        this.subscriptions.push(this.timer.on('tick', () => {
+            const currentTime = this.getCurrentTime();
+            this.renderer.renderProgress(currentTime / this.getDuration(), true);
+            this.emit('timeupdate', currentTime);
+            this.emit('audioprocess', currentTime);
+        }));
+    }
+    initReadyEvent() {
+        const emitReady = () => {
+            if (this.decodedData && this.canPlay) {
+                this.emit('ready', this.getDuration());
+            }
+        };
+        this.subscriptions.push(this.on('decode', emitReady), this.on('canplay', emitReady));
+    }
+    initPlugins() {
+        if (!this.options.plugins?.length)
+            return;
+        this.options.plugins.forEach((plugin) => {
+            this.registerPlugin(plugin);
+        });
+    }
+    /** Register a wavesurfer.js plugin */
+    registerPlugin(plugin) {
+        plugin.init({
+            wavesurfer: this,
+            container: this.renderer.getContainer(),
+            wrapper: this.renderer.getWrapper(),
+        });
+        this.plugins.push(plugin);
+        return plugin;
+    }
+    /** Get all registered plugins */
+    getActivePlugins() {
+        return this.plugins;
+    }
+    /** Load an audio file by URL, with optional pre-decoded audio data */
+    async load(url, channelData, duration) {
+        this.decodedData = null;
+        this.canPlay = false;
+        this.loadUrl(url);
+        this.emit('load', url);
+        if (channelData) {
+            // Pre-decoded audio data
+            if (!duration) {
+                // Wait for the audio duration
+                duration =
+                    (await new Promise((resolve) => {
+                        this.onceMediaEvent('loadedmetadata', () => resolve(this.getMediaElement().duration));
+                    })) || 0;
+            }
+            this.decodedData = Decoder.createBuffer(channelData, duration);
+        }
+        else {
+            // Fetch and decode the audio of no pre-computed audio data is provided
+            const audio = await this.fetcher.load(url);
+            this.decodedData = await Decoder.decode(audio);
+        }
+        this.renderAudio();
+        this.emit('decode', this.getDuration());
+        this.emit('redraw');
+    }
+    renderAudio() {
+        if (!this.decodedData)
+            return;
+        // Only the first two channels are used
+        const channelData = [this.decodedData.getChannelData(0)];
+        if (this.decodedData.numberOfChannels > 1) {
+            channelData.push(this.decodedData.getChannelData(1));
+        }
+        this.renderer.render(channelData, this.decodedData.duration);
+    }
+    /** Zoom in or out */
+    zoom(minPxPerSec) {
+        if (!this.decodedData) {
+            throw new Error('No audio loaded');
+        }
+        this.renderer.zoom(minPxPerSec);
+        this.emit('zoom', minPxPerSec);
+    }
+    /** Get the decoded audio data */
+    getDecodedData() {
+        return this.decodedData;
+    }
+    /** Get the duration of the audio in seconds */
+    getDuration() {
+        const audioDuration = super.getDuration();
+        return audioDuration > 0 && audioDuration < Infinity ? audioDuration : this.decodedData?.duration || 0;
+    }
+    /** Toggle if the waveform should react to clicks */
+    toggleInteraction(isInteractive) {
+        this.options.interact = isInteractive;
+    }
+    /** Seeks to a percentage of audio as [0..1] (0 = beginning, 1 = end) */
+    seekTo(progress) {
+        const time = this.getDuration() * progress;
+        this.setTime(time);
+    }
+    /** Play or pause the audio */
+    playPause() {
+        if (this.isPlaying()) {
+            this.pause();
+            return Promise.resolve();
+        }
+        else {
+            return this.play();
+        }
+    }
+    /** Stop the audio and go to the beginning */
+    stop() {
+        this.pause();
+        this.setTime(0);
+    }
+    /** Skip N or -N seconds from the current positions */
+    skip(seconds) {
+        this.setTime(this.getCurrentTime() + seconds);
+    }
+    /** Empty the waveform by loading a tiny silent audio */
+    empty() {
+        this.load('', [[0]], 0.001);
+    }
+    /** Unmount wavesurfer */
+    destroy() {
+        this.emit('destroy');
+        this.plugins.forEach((plugin) => plugin.destroy());
+        this.timer.destroy();
+        this.renderer.destroy();
+        super.destroy();
+    }
+}
+export default WaveSurfer;

package/dist/wavesurfer.min.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.WaveSurfer=e():t.WaveSurfer=e()}(this,(()=>(()=>{"use strict";var t={d:(e,i)=>{for(var n in i)t.o(i,n)&&!t.o(e,n)&&Object.defineProperty(e,n,{enumerable:!0,get:i[n]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{default:()=>a});const i=class{constructor(){this.eventTarget=new EventTarget}emit(t,e){const i=new CustomEvent(String(t),{detail:e});this.eventTarget.dispatchEvent(i)}on(t,e,i){const n=t=>{t instanceof CustomEvent&&e(t.detail)},s=String(t);return this.eventTarget.addEventListener(s,n,{once:i}),()=>this.eventTarget.removeEventListener(s,n)}once(t,e){return this.on(t,e,!0)}};const n=class extends i{constructor(t){super(),this.timeout=null,this.options=t;let e=null;if("string"==typeof this.options.container?e=document.querySelector(this.options.container):this.options.container instanceof HTMLElement&&(e=this.options.container),!e)throw new Error("Container not found");const i=document.createElement("div"),n=i.attachShadow({mode:"open"});n.innerHTML=`\n      <style>\n        :host {\n          user-select: none;\n        }\n        :host .scroll {\n          overflow-x: auto;\n          overflow-y: visible;\n          width: 100%;\n          height: ${this.options.height}px;\n          position: relative;\n        }\n        :host .wrapper {\n          position: relative;\n          width: fit-content;\n          min-width: 100%;\n          height: 100%;\n          z-index: 2;\n        }\n        :host canvas {\n          display: block;\n          height: 100%;\n          min-width: 100%;\n          image-rendering: pixelated;\n        }\n        :host .progress {\n          position: absolute;\n          z-index: 2;\n          top: 0;\n          left: 0;\n          height: 100%;\n          pointer-events: none;\n          clip-path: inset(100%);\n        }\n        :host .cursor {\n          position: absolute;\n          z-index: 3;\n          top: 0;\n          left: 0;\n          height: 100%;\n          border-right: 1px solid ${this.options.progressColor};\n          margin-left: -1px;\n        }\n      </style>\n\n      <div class="scroll">\n        <div class="wrapper">\n          <canvas></canvas>\n          <canvas class="progress"></canvas>\n          <div class="cursor"></div>\n        </div>\n      </div>\n    `,this.container=i,this.scrollContainer=n.querySelector(".scroll"),this.mainCanvas=n.querySelector("canvas"),this.ctx=this.mainCanvas.getContext("2d",{desynchronized:!0}),this.progressCanvas=n.querySelector(".progress"),this.cursor=n.querySelector(".cursor"),e.appendChild(i),this.mainCanvas.addEventListener("click",(t=>{const e=this.mainCanvas.getBoundingClientRect(),i=(t.clientX-e.left)/e.width;this.emit("click",{relativeX:i})}))}getContainer(){return this.scrollContainer.querySelector(".wrapper")}destroy(){this.container.remove()}delay(t,e=100){return this.timeout&&clearTimeout(this.timeout),new Promise((i=>{this.timeout=setTimeout((()=>{i(t())}),e)}))}renderPeaks(t,e,i){var n,s,r,o,a;return s=this,r=void 0,a=function*(){const{devicePixelRatio:s}=window,{ctx:r}=this,o=null!=this.options.barWidth?this.options.barWidth*s:1,a=null!=this.options.barGap?this.options.barGap*s:this.options.barWidth?o/2:0,h=null!==(n=this.options.barRadius)&&void 0!==n?n:0,l=t[0],c=l.length,d=Math.floor(e/(o+a))/c,u=i/2,p=1===t.length,m=p?l:t[1],v=p&&m.some((t=>t<0)),y=(t,e)=>{let i=0,n=0,s=0;r.beginPath();for(let c=t;c<e;c++){const t=Math.round(c*d);if(t>i){const e=Math.round(n*u),l=Math.round(s*u);r.roundRect(i*(o+a),u-e,o,e+l||1,h),i=t,n=0,s=0}const e=v?l[c]:Math.abs(l[c]),p=v?m[c]:Math.abs(m[c]);e>n&&(n=e),(v?p<-s:p>s)&&(s=p<0?-p:p)}r.fillStyle=this.options.waveColor,r.fill(),r.closePath()};r.clearRect(0,0,e,i);const{scrollLeft:g,scrollWidth:f,clientWidth:C}=this.scrollContainer,w=c/f,b=Math.floor(g*w),x=Math.ceil((g+C)*w);y(b,x),this.createProgressMask(),b>0&&(yield this.delay((()=>{y(0,b)}))),x<c&&(yield this.delay((()=>{y(x,c)}))),this.delay((()=>{this.createProgressMask()}))},new((o=void 0)||(o=Promise))((function(t,e){function i(t){try{h(a.next(t))}catch(t){e(t)}}function n(t){try{h(a.throw(t))}catch(t){e(t)}}function h(e){var s;e.done?t(e.value):(s=e.value,s instanceof o?s:new o((function(t){t(s)}))).then(i,n)}h((a=a.apply(s,r||[])).next())}))}createProgressMask(){const t=this.progressCanvas.getContext("2d",{desynchronized:!0});this.progressCanvas.width=this.mainCanvas.width,this.progressCanvas.height=this.mainCanvas.height,this.progressCanvas.style.width=this.mainCanvas.style.width,this.progressCanvas.style.height=this.mainCanvas.style.height,t.drawImage(this.mainCanvas,0,0),t.globalCompositeOperation="source-in",t.fillStyle=this.options.progressColor,t.fillRect(0,0,this.progressCanvas.width,this.progressCanvas.height)}render(t,e){const{devicePixelRatio:i}=window,n=this.scrollContainer.clientWidth*i,s=e*this.options.minPxPerSec,r=s>n,o=r?s:n,{height:a}=this.options;this.mainCanvas.width=o,this.mainCanvas.height=a,this.mainCanvas.style.width=r?Math.round(s/i)+"px":"100%",this.renderPeaks(t,o,a)}zoom(t,e,i){const n=this.cursor.getBoundingClientRect().left;this.options.minPxPerSec=i,this.render(t,e);const s=this.cursor.getBoundingClientRect().left;this.scrollContainer.scrollLeft+=s-n}renderProgress(t,e=!1){if(this.progressCanvas.style.clipPath=`inset(0 ${100-100*t}% 0 0)`,this.cursor.style.left=100*t+"%",e){const e=this.container.clientWidth/2,i=this.mainCanvas.clientWidth;i*t>=e&&(this.scrollContainer.scrollLeft=i*t-e)}}},s=class extends i{constructor(){super(...arguments),this.unsubscribe=()=>{}}start(){this.unsubscribe=this.on("tick",(()=>{requestAnimationFrame((()=>{this.emit("tick")}))})),this.emit("tick")}stop(){this.unsubscribe()}destroy(){this.unsubscribe()}};const r={height:128,waveColor:"#999",progressColor:"#555",minPxPerSec:0};class o extends i{static create(t){return new o(t)}constructor(t){var e;super(),this.plugins=[],this.subscriptions=[],this.channelData=null,this.duration=0,this.options=Object.assign({},r,t),this.fetcher=new class{load(t){return e=this,i=void 0,s=function*(){return fetch(t).then((t=>t.arrayBuffer()))},new((n=void 0)||(n=Promise))((function(t,r){function o(t){try{h(s.next(t))}catch(t){r(t)}}function a(t){try{h(s.throw(t))}catch(t){r(t)}}function h(e){var i;e.done?t(e.value):(i=e.value,i instanceof n?i:new n((function(t){t(i)}))).then(o,a)}h((s=s.apply(e,i||[])).next())}));var e,i,n,s}},this.decoder=new class{initAudioContext(t){this.audioCtx=new AudioContext({latencyHint:"playback",sampleRate:t})}constructor(){this.audioCtx=null;try{this.initAudioContext(3e3)}catch(t){this.initAudioContext(8e3)}}decode(t){return e=this,i=void 0,s=function*(){if(!this.audioCtx)throw new Error("AudioContext is not initialized");const e=yield this.audioCtx.decodeAudioData(t),i=[e.getChannelData(0)];return e.numberOfChannels>1&&i.push(e.getChannelData(1)),{duration:e.duration,channelData:i}},new((n=void 0)||(n=Promise))((function(t,r){function o(t){try{h(s.next(t))}catch(t){r(t)}}function a(t){try{h(s.throw(t))}catch(t){r(t)}}function h(e){var i;e.done?t(e.value):(i=e.value,i instanceof n?i:new n((function(t){t(i)}))).then(o,a)}h((s=s.apply(e,i||[])).next())}));var e,i,n,s}destroy(){var t;null===(t=this.audioCtx)||void 0===t||t.close(),this.audioCtx=null}},this.timer=new s,this.player=new class{constructor({media:t,autoplay:e}){this.isExternalMedia=!1,this.hasPlayedOnce=!1,t?(this.media=t,this.isExternalMedia=!0):this.media=document.createElement("audio");const i=this.on("play",(()=>{this.hasPlayedOnce=!0,i()}));e&&(this.media.autoplay=!0)}on(t,e){var i;return null===(i=this.media)||void 0===i||i.addEventListener(t,e),()=>{var i;return null===(i=this.media)||void 0===i?void 0:i.removeEventListener(t,e)}}destroy(){var t,e;null===(t=this.media)||void 0===t||t.pause(),this.isExternalMedia||null===(e=this.media)||void 0===e||e.remove()}loadUrl(t){this.media&&(this.media.src=t)}getCurrentTime(){return this.media.currentTime}play(){this.media.play()}pause(){this.media.pause()}isPlaying(){return this.media.currentTime>0&&!this.media.paused&&!this.media.ended}seekTo(t){if(this.media){const{hasPlayedOnce:e}=this;e||this.media.play(),this.media.currentTime=t,e||this.media.pause()}}getVolume(){return this.media.volume}setVolume(t){this.media.volume=t}getMuted(){return this.media.muted}setMuted(t){this.media.muted=t}getPlaybackRate(){return this.media.playbackRate}setPlaybackRate(t,e){null!=e&&(this.media.preservesPitch=e),this.media.playbackRate=t}}({media:this.options.media,autoplay:this.options.autoplay}),this.renderer=new n({container:this.options.container,height:this.options.height,waveColor:this.options.waveColor,progressColor:this.options.progressColor,minPxPerSec:this.options.minPxPerSec,barWidth:this.options.barWidth,barGap:this.options.barGap,barRadius:this.options.barRadius}),this.initPlayerEvents(),this.initRendererEvents(),this.initTimerEvents();const i=this.options.url||(null===(e=this.options.media)||void 0===e?void 0:e.src);i&&this.load(i,this.options.channelData,this.options.duration)}initPlayerEvents(){this.subscriptions.push(this.player.on("timeupdate",(()=>{const t=this.getCurrentTime();this.renderer.renderProgress(t/this.duration,this.isPlaying()),this.emit("audioprocess",{currentTime:t})})),this.player.on("play",(()=>{this.emit("play"),this.timer.start()})),this.player.on("pause",(()=>{this.emit("pause"),this.timer.stop()})),this.player.on("canplay",(()=>{this.emit("canplay",{duration:this.getDuration()})})),this.player.on("seeking",(()=>{this.emit("seek",{time:this.getCurrentTime()})})))}initRendererEvents(){this.subscriptions.push(this.renderer.on("click",(({relativeX:t})=>{const e=this.getDuration()*t;this.seekTo(e)})))}initTimerEvents(){this.subscriptions.push(this.timer.on("tick",(()=>{const t=this.getCurrentTime();this.renderer.renderProgress(t/this.duration,!0),this.emit("audioprocess",{currentTime:t})})))}destroy(){this.subscriptions.forEach((t=>t())),this.plugins.forEach((t=>t.destroy())),this.timer.destroy(),this.player.destroy(),this.decoder.destroy(),this.renderer.destroy()}load(t,e,i){return n=this,s=void 0,o=function*(){if(this.player.loadUrl(t),null==e||null==i){const n=yield this.fetcher.load(t),s=yield this.decoder.decode(n);e=s.channelData,i=s.duration}this.channelData=e,this.duration=i,this.renderer.render(this.channelData,this.duration),this.emit("decode",{duration:this.duration})},new((r=void 0)||(r=Promise))((function(t,e){function i(t){try{h(o.next(t))}catch(t){e(t)}}function a(t){try{h(o.throw(t))}catch(t){e(t)}}function h(e){var n;e.done?t(e.value):(n=e.value,n instanceof r?n:new r((function(t){t(n)}))).then(i,a)}h((o=o.apply(n,s||[])).next())}));var n,s,r,o}zoom(t){if(null==this.channelData||null==this.duration)throw new Error("No audio loaded");this.renderer.zoom(this.channelData,this.duration,t)}play(){this.player.play()}pause(){this.player.pause()}seekTo(t){this.player.seekTo(t)}isPlaying(){return this.player.isPlaying()}getDuration(){return this.duration}getCurrentTime(){return this.player.getCurrentTime()}getVolume(){return this.player.getVolume()}setVolume(t){this.player.setVolume(t)}getMuted(){return this.player.getMuted()}setMuted(t){this.player.setMuted(t)}getPlaybackRate(){return this.player.getPlaybackRate()}setPlaybackRate(t,e){this.player.setPlaybackRate(t,e)}registerPlugin(t){const e=new t({wavesurfer:this,container:this.renderer.getContainer()});return this.plugins.push(e),e}getAudioData(){return this.channelData}}const a=o;return e.default})()));
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.WaveSurfer=e():t.WaveSurfer=e()}(this,(()=>(()=>{"use strict";var t={d:(e,i)=>{for(var s in i)t.o(i,s)&&!t.o(e,s)&&Object.defineProperty(e,s,{enumerable:!0,get:i[s]})},o:(t,e)=>Object.prototype.hasOwnProperty.call(t,e)},e={};t.d(e,{default:()=>d});const i={decode:async function(t){let e;try{e=new AudioContext({sampleRate:3e3})}catch(t){e=new AudioContext({sampleRate:8e3})}const i=e.decodeAudioData(t);return i.finally((()=>e.close())),i},createBuffer:function(t,e){if("number"==typeof t[0]&&(t=[t]),t[0].some((t=>t>1||t<-1))){const e=Math.max(...t[0]);t=t.map((t=>t.map((t=>t/e))))}return{length:t[0].length,duration:e,numberOfChannels:t.length,sampleRate:t[0].length/e,getChannelData:e=>t?.[e],copyFromChannel:AudioBuffer.prototype.copyFromChannel,copyToChannel:AudioBuffer.prototype.copyToChannel}}},s=class{constructor(){this.listeners={}}on(t,e){return this.listeners[t]||(this.listeners[t]=new Set),this.listeners[t].add(e),()=>this.un(t,e)}once(t,e){const i=this.on(t,e),s=this.on(t,(()=>{i(),s()}));return i}un(t,e){this.listeners[t]&&(e?this.listeners[t].delete(e):delete this.listeners[t])}unAll(){this.listeners={}}emit(t,...e){this.listeners[t]&&this.listeners[t].forEach((t=>t(...e)))}};class n extends s{constructor(t,e){super(),this.options={height:0},this.timeout=null,this.isScrolling=!1,this.channelData=null,this.duration=null,this.resizeObserver=null,this.options={...e};let i=null;if("string"==typeof t.container?i=document.querySelector(t.container):t.container instanceof HTMLElement&&(i=t.container),!i)throw new Error("Container not found");const[s,n]=this.initHtml();i.appendChild(s),this.container=s,this.scrollContainer=n.querySelector(".scroll"),this.wrapper=n.querySelector(".wrapper"),this.canvasWrapper=n.querySelector(".canvases"),this.progressWrapper=n.querySelector(".progress"),this.wrapper.addEventListener("click",(t=>{const e=this.wrapper.getBoundingClientRect(),i=(t.clientX-e.left)/e.width;this.emit("click",i)})),this.resizeObserver=new ResizeObserver((()=>{this.delay((()=>this.reRender()),100)})),this.resizeObserver.observe(this.scrollContainer)}initHtml(){const t=document.createElement("div"),e=t.attachShadow({mode:"open"});return e.innerHTML=`\n      <style>\n        :host {\n          user-select: none;\n        }\n        :host .scroll {\n          overflow-x: auto;\n          overflow-y: hidden;\n          width: 100%;\n          position: relative;\n        }\n        :host .noScrollbar {\n          scrollbar-color: transparent;\n          scrollbar-width: none;\n        }\n        :host .noScrollbar::-webkit-scrollbar {\n          display: none;\n          -webkit-appearance: none;\n        }\n        :host .wrapper {\n          position: relative;\n          overflow: visible;\n          z-index: 2;\n        }\n        :host .canvases {\n          position: relative;\n          height: ${this.options.height}px;\n        }\n        :host canvas {\n          display: block;\n          position: absolute;\n          top: 0;\n          image-rendering: pixelated;\n          height: ${this.options.height}px;\n        }\n        :host .progress {\n          pointer-events: none;\n          position: absolute;\n          z-index: 2;\n          top: 0;\n          left: 0;\n          width: 0;\n          height: 100%;\n          overflow: hidden;\n          box-sizing: border-box;\n        }\n      </style>\n\n      <div class="scroll">\n        <div class="wrapper">\n          <div class="canvases"></div>\n          <div class="progress"></div>\n        </div>\n      </div>\n    `,[t,e]}setOptions(t){this.options=t,this.reRender()}getContainer(){return this.scrollContainer}getWrapper(){return this.wrapper}destroy(){this.container.remove(),this.resizeObserver?.disconnect()}delay(t,e=10){return this.timeout&&clearTimeout(this.timeout),new Promise((i=>{this.timeout=setTimeout((()=>{i(t())}),e)}))}async renderPeaks(t,e,i,s){const r=null!=this.options.barWidth?this.options.barWidth*s:1,o=null!=this.options.barGap?this.options.barGap*s:this.options.barWidth?r/2:0,a=this.options.barRadius??0,h=this.options.barHeight??1,l=t[0],d=l.length,c=Math.floor(e/(r+o))/d,p=i/2,u=1===t.length,m=u?l:t[1],g=u&&m.some((t=>t<0)),y=(t,i)=>{let n=0,u=0,y=0;const f=document.createElement("canvas");f.width=Math.round(e*(i-t)/d),f.height=this.options.height,f.style.width=`${Math.floor(f.width/s)}px`,f.style.height=`${this.options.height}px`,f.style.left=`${Math.floor(t*e/s/d)}px`,this.canvasWrapper.appendChild(f);const v=f.getContext("2d",{desynchronized:!0});v.beginPath(),v.fillStyle=this.options.waveColor??"",v.roundRect||(v.roundRect=v.fillRect);for(let e=t;e<i;e++){const i=Math.round((e-t)*c);if(i>n){const t=Math.round(u*p*h),e=Math.round(y*p*h);v.roundRect(n*(r+o),p-t,r,t+(e||1),a),n=i,u=0,y=0}const s=g?l[e]:Math.abs(l[e]),d=g?m[e]:Math.abs(m[e]);s>u&&(u=s),(g?d<-y:d>y)&&(y=d<0?-d:d)}v.fill(),v.closePath();const b=f.cloneNode();this.progressWrapper.appendChild(b);const w=b.getContext("2d",{desynchronized:!0});f.width>0&&f.height>0&&w.drawImage(f,0,0),w.globalCompositeOperation="source-in",w.fillStyle=this.options.progressColor??"",w.fillRect(0,0,f.width,f.height)};this.canvasWrapper.innerHTML="",this.progressWrapper.innerHTML="";const{scrollLeft:f,scrollWidth:v,clientWidth:b}=this.scrollContainer,w=d/v;let C=Math.min(n.MAX_CANVAS_WIDTH,b);C-=C%((r+o)/s);const P=Math.floor(Math.abs(f)*w),M=Math.ceil(P+C*w);y(P,M);const x=M-P;for(let t=M;t<d;t+=x)await this.delay((()=>{y(t,Math.min(d,t+x))}));for(let t=P-1;t>=0;t-=x)await this.delay((()=>{y(Math.max(0,t-x),t)}))}render(t,e){const i=window.devicePixelRatio||1,s=this.scrollContainer.clientWidth,n=Math.ceil(e*(this.options.minPxPerSec||0));this.isScrolling=n>s;const r=this.options.fillParent&&!this.isScrolling,o=(r?s:n)*i,{height:a}=this.options;this.wrapper.style.width=r?"100%":`${n}px`,this.scrollContainer.style.overflowX=this.isScrolling?"auto":"hidden",this.scrollContainer.classList.toggle("noScrollbar",!!this.options.hideScrollbar),this.progressWrapper.style.borderRightStyle="solid",this.progressWrapper.style.borderRightColor=`${this.options.cursorColor||this.options.progressColor}`,this.progressWrapper.style.borderRightWidth=`${this.options.cursorWidth}px`,this.canvasWrapper.style.height=`${this.options.height}px`,this.renderPeaks(t,o,a,i),this.channelData=t,this.duration=e}reRender(){if(!this.channelData||!this.duration)return;const t=this.progressWrapper.clientWidth;this.render(this.channelData,this.duration);const e=this.progressWrapper.clientWidth;this.scrollContainer.scrollLeft+=e-t}zoom(t){this.options.minPxPerSec=t,this.reRender()}renderProgress(t,e=!1){if(!isNaN(t)&&(this.progressWrapper.style.width=100*t+"%",this.isScrolling&&this.options.autoCenter)){const{clientWidth:i,scrollLeft:s,scrollWidth:n}=this.scrollContainer,r=n*t,o=i/2,a=o/20;(r>s+(e?o:i)||r<s)&&(r-(s+o)>=a&&r<s+i?this.scrollContainer.scrollLeft+=a:this.scrollContainer.scrollLeft=r-o)}}}n.MAX_CANVAS_WIDTH=4e3;const r=n,o=class extends s{constructor(t){super(),this.subscriptions=[],this.isExternalMedia=!1,t.media?(this.media=t.media,this.isExternalMedia=!0):this.media=document.createElement("audio"),t.autoplay&&(this.media.autoplay=!0),null!=t.playbackRate&&(this.media.playbackRate=t.playbackRate)}onMediaEvent(t,e,i){return this.media.addEventListener(t,e,i),()=>this.media.removeEventListener(t,e)}onceMediaEvent(t,e){return this.onMediaEvent(t,e,{once:!0})}loadUrl(t){this.media.src=t}destroy(){this.media.pause(),this.subscriptions.forEach((t=>t())),this.isExternalMedia||this.media.remove()}play(){return this.media.play()}pause(){this.media.pause()}isPlaying(){return this.media.currentTime>0&&!this.media.paused&&!this.media.ended}setTime(t){this.media.currentTime=t}getDuration(){return this.media.duration}getCurrentTime(){return this.media.currentTime}getVolume(){return this.media.volume}setVolume(t){this.media.volume=t}getMuted(){return this.media.muted}setMuted(t){this.media.muted=t}getPlaybackRate(){return this.media.playbackRate}setPlaybackRate(t,e){null!=e&&(this.media.preservesPitch=e),this.media.playbackRate=t}getMediaElement(){return this.media}setSinkId(t){return this.media.setSinkId(t)}},a=class extends s{constructor(){super(...arguments),this.unsubscribe=()=>{}}start(){this.unsubscribe=this.on("tick",(()=>{requestAnimationFrame((()=>{this.emit("tick")}))})),this.emit("tick")}stop(){this.unsubscribe()}destroy(){this.unsubscribe()}},h={height:128,waveColor:"#999",progressColor:"#555",cursorWidth:1,minPxPerSec:0,fillParent:!0,interact:!0,autoCenter:!0};class l extends o{static create(t){return new l(t)}constructor(t){super({media:t.media,autoplay:t.autoplay,playbackRate:t.audioRate}),this.plugins=[],this.decodedData=null,this.canPlay=!1,this.options=Object.assign({},h,t),this.fetcher=new class{async load(t){return fetch(t).then((t=>t.arrayBuffer()))}},this.timer=new a,this.renderer=new r({container:this.options.container},this.options),this.initPlayerEvents(),this.initRendererEvents(),this.initTimerEvents(),this.initReadyEvent(),this.initPlugins();const e=this.options.url||this.options.media?.src;e&&this.load(e,this.options.peaks,this.options.duration)}setOptions(t){this.options={...this.options,...t},this.renderer.setOptions(this.options)}initPlayerEvents(){this.subscriptions.push(this.onMediaEvent("timeupdate",(()=>{const t=this.getCurrentTime();this.renderer.renderProgress(t/this.getDuration(),this.isPlaying()),this.emit("timeupdate",t)})),this.onMediaEvent("play",(()=>{this.emit("play"),this.timer.start()})),this.onMediaEvent("pause",(()=>{this.emit("pause"),this.timer.stop(),this.getCurrentTime()>=this.getDuration()&&this.emit("finish")})),this.onMediaEvent("canplay",(()=>{this.canPlay=!0,this.emit("canplay",this.getDuration())})),this.onMediaEvent("seeking",(()=>{this.emit("seeking",this.getCurrentTime())})))}initRendererEvents(){this.subscriptions.push(this.renderer.on("click",(t=>{this.options.interact&&(this.canPlay&&this.seekTo(t),this.emit("interaction"))})))}initTimerEvents(){this.subscriptions.push(this.timer.on("tick",(()=>{const t=this.getCurrentTime();this.renderer.renderProgress(t/this.getDuration(),!0),this.emit("timeupdate",t),this.emit("audioprocess",t)})))}initReadyEvent(){const t=()=>{this.decodedData&&this.canPlay&&this.emit("ready",this.getDuration())};this.subscriptions.push(this.on("decode",t),this.on("canplay",t))}initPlugins(){this.options.plugins?.length&&this.options.plugins.forEach((t=>{this.registerPlugin(t)}))}registerPlugin(t){return t.init({wavesurfer:this,container:this.renderer.getContainer(),wrapper:this.renderer.getWrapper()}),this.plugins.push(t),t}getActivePlugins(){return this.plugins}async load(t,e,s){if(this.decodedData=null,this.canPlay=!1,this.loadUrl(t),this.emit("load",t),e)s||(s=await new Promise((t=>{this.onceMediaEvent("loadedmetadata",(()=>t(this.getMediaElement().duration)))}))||0),this.decodedData=i.createBuffer(e,s);else{const e=await this.fetcher.load(t);this.decodedData=await i.decode(e)}this.renderAudio(),this.emit("decode",this.getDuration()),this.emit("redraw")}renderAudio(){if(!this.decodedData)return;const t=[this.decodedData.getChannelData(0)];this.decodedData.numberOfChannels>1&&t.push(this.decodedData.getChannelData(1)),this.renderer.render(t,this.decodedData.duration)}zoom(t){if(!this.decodedData)throw new Error("No audio loaded");this.renderer.zoom(t),this.emit("zoom",t)}getDecodedData(){return this.decodedData}getDuration(){const t=super.getDuration();return t>0&&t<1/0?t:this.decodedData?.duration||0}toggleInteraction(t){this.options.interact=t}seekTo(t){const e=this.getDuration()*t;this.setTime(e)}playPause(){return this.isPlaying()?(this.pause(),Promise.resolve()):this.play()}stop(){this.pause(),this.setTime(0)}skip(t){this.setTime(this.getCurrentTime()+t)}empty(){this.load("",[[0]],.001)}destroy(){this.emit("destroy"),this.plugins.forEach((t=>t.destroy())),this.timer.destroy(),this.renderer.destroy(),super.destroy()}}const d=l;return e.default})()));

package/package.json

@@ -1,39 +1,64 @@
 {
   "name": "wavesurfer.js",
-  "version": "7.0.0-alpha.4",
-  "description": "wavesurfer.js is an audio library that draws waveforms and plays audio in the browser.",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "7.0.0-alpha.41",
+  "license": "BSD-3-Clause",
+  "author": "katspaugh",
+  "homepage": "https://wavesurfer-js.org",
+  "keywords": [
+    "waveform",
+    "audio",
+    "player",
+    "music",
+    "linguistics"
+  ],
+  "type": "module",
   "files": [
-    "dist/"
+    "dist"
   ],
+  "types": "./dist/wavesurfer.d.ts",
+  "main": "./dist/wavesurfer.js",
+  "exports": {
+    ".": {
+      "import": "./dist/wavesurfer.js",
+      "require": "./dist/wavesurfer.min.js"
+    },
+    "./dist/plugins/*": {
+      "import": "./dist/plugins/*.js",
+      "require": "./dist/plugins/*.min.js"
+    },
+    "./dist/plugins/*.js": {
+      "import": "./dist/plugins/*.js",
+      "require": "./dist/plugins/*.min.js"
+    }
+  },
   "scripts": {
-    "build": "tsc",
-    "build:dev": "tsc -w",
-    "build:umd": "tsc && webpack && webpack --config webpack.config.plugins.js",
-    "prepublishOnly": "npm run build:umd",
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "build:dev": "tsc -w --target ESNext",
+    "build:umd": "webpack && webpack --config webpack.config.plugins.js",
+    "build": "tsc && npm run build:umd",
+    "deploy": "yarn build && yarn docs && rm public/dist && rm public/examples && mv dist public/ && mv examples public/",
+    "prepublishOnly": "npm run build",
+    "docs": "typedoc src/wavesurfer.ts src/plugins/* --out public/docs",
     "lint": "eslint --ext .ts src --fix",
-    "prettier": "prettier -w src",
-    "docs": "npx typedoc src/index.ts",
-    "serve": "browser-sync start --server --port 9090 --startPath / --watch '*'",
+    "prettier": "prettier -w '**/*.{js,ts,css}' --ignore-path .gitignore",
+    "cypress": "cypress open",
+    "test": "cypress run",
+    "serve": "cd public && browser-sync start --server --port 9090 --watch '*' --no-ghost-mode --no-ui --cwd",
     "start": "npm run build:dev & npm run serve"
   },
-  "author": "katspaugh <katspaugh@gmail.com>",
-  "license": "ISC",
   "devDependencies": {
-    "@types/react": "^18.0.28",
-    "@typescript-eslint/eslint-plugin": "^5.54.0",
-    "@typescript-eslint/parser": "^5.54.0",
+    "@typescript-eslint/eslint-plugin": "^5.57.0",
+    "@typescript-eslint/parser": "^5.57.0",
     "browser-sync": "^2.29.0",
-    "eslint": "^8.35.0",
-    "eslint-config-prettier": "^8.7.0",
+    "cypress": "^12.9.0",
+    "eslint": "^8.37.0",
+    "eslint-config-prettier": "^8.8.0",
     "eslint-plugin-prettier": "^4.2.1",
-    "prettier": "^2.8.4",
+    "prettier": "^2.8.7",
     "ts-loader": "^9.4.2",
-    "typedoc": "^0.23.26",
-    "typescript": "^4.9.5",
-    "webpack": "^5.76.1",
+    "typedoc": "^0.23.28",
+    "typedoc-plugin-rename-defaults": "^0.6.5",
+    "typescript": "^5.0.4",
+    "webpack": "^5.77.0",
     "webpack-cli": "^5.0.1"
   },
   "dependencies": {}

package/dist/index.d.ts

@@ -1,104 +0,0 @@
-import EventEmitter, { type GeneralEventTypes } from './event-emitter.js';
-import BasePlugin from './base-plugin.js';
-export type WaveSurferOptions = {
-    /** HTML element or CSS selector */
-    container: HTMLElement | string | null;
-    /** Height of the waveform in pixels */
-    height?: number;
-    /** The color of the waveform */
-    waveColor?: string;
-    /** The color of the progress mask */
-    progressColor?: string;
-    /** If set, the waveform will be rendered in bars like so: ▁ ▂ ▇ ▃ ▅ ▂ */
-    barWidth?: number;
-    /** Spacing between bars in pixels */
-    barGap?: number;
-    /** Rounded borders for bars */
-    barRadius?: number;
-    /** Minimum pixels per second of audio (zoom) */
-    minPxPerSec?: number;
-    /** Audio URL */
-    url?: string;
-    /** Pre-computed audio data */
-    channelData?: Float32Array[];
-    /** Pre-computed duration */
-    duration?: number;
-    /** Use an existing media element instead of creating one */
-    media?: HTMLMediaElement;
-    /** Play the audio on load */
-    autoplay?: boolean;
-};
-export type WaveSurferEvents = {
-    decode: {
-        duration: number;
-    };
-    canplay: {
-        duration: number;
-    };
-    play: void;
-    pause: void;
-    audioprocess: {
-        currentTime: number;
-    };
-    seek: {
-        time: number;
-    };
-};
-export type WaveSurferPluginParams = {
-    wavesurfer: WaveSurfer;
-    container: HTMLElement;
-};
-export declare class WaveSurfer extends EventEmitter<WaveSurferEvents> {
-    private options;
-    private fetcher;
-    private decoder;
-    private renderer;
-    private player;
-    private timer;
-    private plugins;
-    private subscriptions;
-    private channelData;
-    private duration;
-    /** Create a new WaveSurfer instance */
-    static create(options: WaveSurferOptions): WaveSurfer;
-    /** Create a new WaveSurfer instance */
-    constructor(options: WaveSurferOptions);
-    private initPlayerEvents;
-    private initRendererEvents;
-    private initTimerEvents;
-    /** Unmount wavesurfer */
-    destroy(): void;
-    /** Load an audio file by URL, with optional pre-decoded audio data */
-    load(url: string, channelData?: Float32Array[], duration?: number): Promise<void>;
-    /** Zoom in or out */
-    zoom(minPxPerSec: number): void;
-    /** Start playing the audio */
-    play(): void;
-    /** Pause the audio */
-    pause(): void;
-    /** Skip to a time position in seconds */
-    seekTo(time: number): void;
-    /** Check if the audio is playing */
-    isPlaying(): boolean;
-    /** Get the duration of the audio in seconds */
-    getDuration(): number;
-    /** Get the current audio position in seconds */
-    getCurrentTime(): number;
-    /** Get the audio volume */
-    getVolume(): number;
-    /** Set the audio volume */
-    setVolume(volume: number): void;
-    /** Get the audio muted state */
-    getMuted(): boolean;
-    /** Mute or unmute the audio */
-    setMuted(muted: boolean): void;
-    /** Get playback rate */
-    getPlaybackRate(): number;
-    /** Set playback rate, with an optional parameter to NOT preserve the pitch if false */
-    setPlaybackRate(rate: number, preservePitch?: boolean): void;
-    /** Register and initialize a plugin */
-    registerPlugin<T extends BasePlugin<GeneralEventTypes>>(CustomPlugin: new (params: WaveSurferPluginParams) => T): T;
-    /** Get the decoded audio data */
-    getAudioData(): Float32Array[] | null;
-}
-export default WaveSurfer;

package/dist/index.js

@@ -1,188 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import Fetcher from './fetcher.js';
-import Decoder from './decoder.js';
-import Renderer from './renderer.js';
-import Player from './player.js';
-import EventEmitter from './event-emitter.js';
-import Timer from './timer.js';
-const defaultOptions = {
-    height: 128,
-    waveColor: '#999',
-    progressColor: '#555',
-    minPxPerSec: 0,
-};
-export class WaveSurfer extends EventEmitter {
-    /** Create a new WaveSurfer instance */
-    static create(options) {
-        return new WaveSurfer(options);
-    }
-    /** Create a new WaveSurfer instance */
-    constructor(options) {
-        var _a;
-        super();
-        this.plugins = [];
-        this.subscriptions = [];
-        this.channelData = null;
-        this.duration = 0;
-        this.options = Object.assign({}, defaultOptions, options);
-        this.fetcher = new Fetcher();
-        this.decoder = new Decoder();
-        this.timer = new Timer();
-        this.player = new Player({
-            media: this.options.media,
-            autoplay: this.options.autoplay,
-        });
-        this.renderer = new Renderer({
-            container: this.options.container,
-            height: this.options.height,
-            waveColor: this.options.waveColor,
-            progressColor: this.options.progressColor,
-            minPxPerSec: this.options.minPxPerSec,
-            barWidth: this.options.barWidth,
-            barGap: this.options.barGap,
-            barRadius: this.options.barRadius,
-        });
-        this.initPlayerEvents();
-        this.initRendererEvents();
-        this.initTimerEvents();
-        const url = this.options.url || ((_a = this.options.media) === null || _a === void 0 ? void 0 : _a.src);
-        if (url) {
-            this.load(url, this.options.channelData, this.options.duration);
-        }
-    }
-    initPlayerEvents() {
-        this.subscriptions.push(this.player.on('timeupdate', () => {
-            const currentTime = this.getCurrentTime();
-            this.renderer.renderProgress(currentTime / this.duration, this.isPlaying());
-            this.emit('audioprocess', { currentTime });
-        }), this.player.on('play', () => {
-            this.emit('play');
-            this.timer.start();
-        }), this.player.on('pause', () => {
-            this.emit('pause');
-            this.timer.stop();
-        }), this.player.on('canplay', () => {
-            this.emit('canplay', { duration: this.getDuration() });
-        }), this.player.on('seeking', () => {
-            this.emit('seek', { time: this.getCurrentTime() });
-        }));
-    }
-    initRendererEvents() {
-        // Seek on click
-        this.subscriptions.push(this.renderer.on('click', ({ relativeX }) => {
-            const time = this.getDuration() * relativeX;
-            this.seekTo(time);
-        }));
-    }
-    initTimerEvents() {
-        // The timer fires every 16ms for a smooth progress animation
-        this.subscriptions.push(this.timer.on('tick', () => {
-            const currentTime = this.getCurrentTime();
-            this.renderer.renderProgress(currentTime / this.duration, true);
-            this.emit('audioprocess', { currentTime });
-        }));
-    }
-    /** Unmount wavesurfer */
-    destroy() {
-        this.subscriptions.forEach((unsubscribe) => unsubscribe());
-        this.plugins.forEach((plugin) => plugin.destroy());
-        this.timer.destroy();
-        this.player.destroy();
-        this.decoder.destroy();
-        this.renderer.destroy();
-    }
-    /** Load an audio file by URL, with optional pre-decoded audio data */
-    load(url, channelData, duration) {
-        return __awaiter(this, void 0, void 0, function* () {
-            this.player.loadUrl(url);
-            // Fetch and decode the audio of no pre-computed audio data is provided
-            if (channelData == null || duration == null) {
-                const audio = yield this.fetcher.load(url);
-                const data = yield this.decoder.decode(audio);
-                channelData = data.channelData;
-                duration = data.duration;
-            }
-            this.channelData = channelData;
-            this.duration = duration;
-            this.renderer.render(this.channelData, this.duration);
-            this.emit('decode', { duration: this.duration });
-        });
-    }
-    /** Zoom in or out */
-    zoom(minPxPerSec) {
-        if (this.channelData == null || this.duration == null) {
-            throw new Error('No audio loaded');
-        }
-        this.renderer.zoom(this.channelData, this.duration, minPxPerSec);
-    }
-    /** Start playing the audio */
-    play() {
-        this.player.play();
-    }
-    /** Pause the audio */
-    pause() {
-        this.player.pause();
-    }
-    /** Skip to a time position in seconds */
-    seekTo(time) {
-        this.player.seekTo(time);
-    }
-    /** Check if the audio is playing */
-    isPlaying() {
-        return this.player.isPlaying();
-    }
-    /** Get the duration of the audio in seconds */
-    getDuration() {
-        return this.duration;
-    }
-    /** Get the current audio position in seconds */
-    getCurrentTime() {
-        return this.player.getCurrentTime();
-    }
-    /** Get the audio volume */
-    getVolume() {
-        return this.player.getVolume();
-    }
-    /** Set the audio volume */
-    setVolume(volume) {
-        this.player.setVolume(volume);
-    }
-    /** Get the audio muted state */
-    getMuted() {
-        return this.player.getMuted();
-    }
-    /** Mute or unmute the audio */
-    setMuted(muted) {
-        this.player.setMuted(muted);
-    }
-    /** Get playback rate */
-    getPlaybackRate() {
-        return this.player.getPlaybackRate();
-    }
-    /** Set playback rate, with an optional parameter to NOT preserve the pitch if false */
-    setPlaybackRate(rate, preservePitch) {
-        this.player.setPlaybackRate(rate, preservePitch);
-    }
-    /** Register and initialize a plugin */
-    registerPlugin(CustomPlugin) {
-        const plugin = new CustomPlugin({
-            wavesurfer: this,
-            container: this.renderer.getContainer(),
-        });
-        this.plugins.push(plugin);
-        return plugin;
-    }
-    /** Get the decoded audio data */
-    getAudioData() {
-        return this.channelData;
-    }
-}
-export default WaveSurfer;

package/dist/player-webaudio.d.ts

@@ -1,8 +0,0 @@
-import Player from './player.js';
-declare class WebAudioPlayer extends Player {
-    audioCtx: AudioContext | null;
-    sourceNode: MediaElementAudioSourceNode | null;
-    destroy(): void;
-    loadUrl(url: string): void;
-}
-export default WebAudioPlayer;