wavesurfer.js 7.0.0-alpha.9 → 7.0.0-beta.1

package/dist/wavesurfer.d.ts

@@ -0,0 +1,151 @@
+import type { GenericPlugin } from './base-plugin.js';
+import Player from './player.js';
+import { type RendererStyleOptions } from './renderer.js';
+export type WaveSurferOptions = {
+    /** HTML element or CSS selector */
+    container: HTMLElement | string;
+    /** The height of the waveform in pixels */
+    height?: number;
+    /** The color of the waveform */
+    waveColor?: string;
+    /** The color of the progress mask */
+    progressColor?: string;
+    /** The color of the playpack cursor */
+    cursorColor?: string;
+    /** The cursor width */
+    cursorWidth?: number;
+    /** Render the waveform with bars like this: ▁ ▂ ▇ ▃ ▅ ▂ */
+    barWidth?: number;
+    /** Spacing between bars in pixels */
+    barGap?: number;
+    /** Rounded borders for bars */
+    barRadius?: number;
+    /** A vertical scaling factor for the waveform */
+    barHeight?: number;
+    /** Minimum pixels per second of audio (i.e. zoom level) */
+    minPxPerSec?: number;
+    /** Stretch the waveform to fill the container, true by default */
+    fillParent?: boolean;
+    /** Audio URL */
+    url?: string;
+    /** Pre-computed audio data */
+    peaks?: Float32Array[] | Array<number[]>;
+    /** Pre-computed duration */
+    duration?: number;
+    /** Use an existing media element instead of creating one */
+    media?: HTMLMediaElement;
+    /** Play the audio on load */
+    autoplay?: boolean;
+    /** Pass false to disable clicks on the waveform */
+    interact?: boolean;
+    /** Hide the scrollbar */
+    hideScrollbar?: boolean;
+    /** Audio rate */
+    audioRate?: number;
+    /** Automatically scroll the container to keep the current position in viewport */
+    autoScroll?: boolean;
+    /** If autoScroll is enabled, keep the cursor in the center of the waveform during playback */
+    autoCenter?: boolean;
+    /** Decoding sample rate. Doesn't affect the playback. Defaults to 8000 */
+    sampleRate?: number;
+    /** The list of plugins to initialize on start */
+    plugins?: GenericPlugin[];
+};
+declare const defaultOptions: {
+    height: number;
+    waveColor: string;
+    progressColor: string;
+    cursorWidth: number;
+    minPxPerSec: number;
+    fillParent: boolean;
+    interact: boolean;
+    autoScroll: boolean;
+    autoCenter: boolean;
+    sampleRate: number;
+};
+export type WaveSurferEvents = {
+    /** When audio starts loading */
+    load: [url: string];
+    /** When the audio has been decoded */
+    decode: [duration: number];
+    /** When the media element has loaded enough to play */
+    canplay: [duration: number];
+    /** When the audio is both decoded and can play */
+    ready: [duration: number];
+    /** When a waveform is drawn */
+    redraw: [];
+    /** When the audio starts playing */
+    play: [];
+    /** When the audio pauses */
+    pause: [];
+    /** When the audio finishes playing */
+    finish: [];
+    /** On audio position change, fires continuously during playback */
+    timeupdate: [currentTime: number];
+    /** An alias of timeupdate but only when the audio is playing */
+    audioprocess: [currentTime: number];
+    /** When the user seeks to a new position */
+    seeking: [currentTime: number];
+    /** When the user interacts with the waveform (i.g. clicks or drags on it) */
+    interaction: [];
+    /** When the user clicks on the waveform */
+    click: [relativeX: number];
+    /** When the user drags the cursor */
+    drag: [relativeX: number];
+    /** When the waveform is scrolled (panned) */
+    scroll: [visibleStartTime: number, visibleEndTime: number];
+    /** When the zoom level changes */
+    zoom: [minPxPerSec: number];
+    /** Just before the waveform is destroyed so you can clean up your events */
+    destroy: [];
+};
+declare class WaveSurfer extends Player<WaveSurferEvents> {
+    options: WaveSurferOptions & typeof defaultOptions;
+    private renderer;
+    private timer;
+    private plugins;
+    private decodedData;
+    private canPlay;
+    protected subscriptions: Array<() => void>;
+    /** Create a new WaveSurfer instance */
+    static create(options: WaveSurferOptions): WaveSurfer;
+    /** Create a new WaveSurfer instance */
+    constructor(options: WaveSurferOptions);
+    setOptions(options: Partial<RendererStyleOptions> & Pick<WaveSurferOptions, 'interact' | 'audioRate'>): void;
+    private initPlayerEvents;
+    private initRendererEvents;
+    private initTimerEvents;
+    private initReadyEvent;
+    private initPlugins;
+    /** Register a wavesurfer.js plugin */
+    registerPlugin<T extends GenericPlugin>(plugin: T): T;
+    /** For plugins only: get the waveform wrapper div */
+    getWrapper(): HTMLElement;
+    /** Get the current scroll position in pixels */
+    getScroll(): number;
+    /** Get all registered plugins */
+    getActivePlugins(): GenericPlugin[];
+    /** Load an audio file by URL, with optional pre-decoded audio data */
+    load(url: string, channelData?: WaveSurferOptions['peaks'], duration?: number): Promise<void>;
+    /** Zoom in or out */
+    zoom(minPxPerSec: number): void;
+    /** Get the decoded audio data */
+    getDecodedData(): AudioBuffer | null;
+    /** Get the duration of the audio in seconds */
+    getDuration(): number;
+    /** Toggle if the waveform should react to clicks */
+    toggleInteraction(isInteractive: boolean): void;
+    /** Seeks to a percentage of audio as [0..1] (0 = beginning, 1 = end) */
+    seekTo(progress: number): void;
+    /** Play or pause the audio */
+    playPause(): Promise<void>;
+    /** Stop the audio and go to the beginning */
+    stop(): void;
+    /** Skip N or -N seconds from the current positions */
+    skip(seconds: number): void;
+    /** Empty the waveform by loading a tiny silent audio */
+    empty(): void;
+    /** Unmount wavesurfer */
+    destroy(): void;
+}
+export default WaveSurfer;

package/dist/wavesurfer.js

@@ -0,0 +1,241 @@
+import Decoder from './decoder.js';
+import Fetcher from './fetcher.js';
+import Player from './player.js';
+import Renderer from './renderer.js';
+import Timer from './timer.js';
+const defaultOptions = {
+    height: 128,
+    waveColor: '#999',
+    progressColor: '#555',
+    cursorWidth: 1,
+    minPxPerSec: 0,
+    fillParent: true,
+    interact: true,
+    autoScroll: true,
+    autoCenter: true,
+    sampleRate: 8000,
+};
+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.subscriptions = [];
+        this.options = Object.assign({}, defaultOptions, options);
+        this.timer = new Timer();
+        this.renderer = new Renderer(this.options.container, this.options);
+        this.initPlayerEvents();
+        this.initRendererEvents();
+        this.initTimerEvents();
+        this.initReadyEvent();
+        this.initPlugins();
+        const url = this.options.url || this.options.media?.currentSrc || 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);
+        if (options.audioRate) {
+            this.setPlaybackRate(options.audioRate);
+        }
+    }
+    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();
+        }), this.onMediaEvent('ended', () => {
+            this.emit('finish');
+        }), this.onMediaEvent('canplay', () => {
+            this.canPlay = true;
+            this.emit('canplay', this.getDuration());
+        }), this.onMediaEvent('seeking', () => {
+            this.emit('seeking', this.getCurrentTime());
+        }));
+    }
+    initRendererEvents() {
+        this.subscriptions.push(
+        // Seek on click
+        this.renderer.on('click', (relativeX) => {
+            if (this.options.interact) {
+                this.canPlay && this.seekTo(relativeX);
+                this.emit('interaction');
+                this.emit('click', relativeX);
+            }
+        }), 
+        // Scroll
+        this.renderer.on('scroll', (startX, endX) => {
+            const duration = this.getDuration();
+            this.emit('scroll', startX * duration, endX * duration);
+        }), 
+        // Redraw
+        this.renderer.on('render', () => {
+            this.emit('redraw');
+        }));
+        // Drag
+        {
+            let debounce;
+            this.subscriptions.push(this.renderer.on('drag', (relativeX) => {
+                if (!this.options.interact)
+                    return;
+                if (this.canPlay) {
+                    // Update the visual position
+                    this.renderer.renderProgress(relativeX);
+                    // Set the audio position with a debounce
+                    clearTimeout(debounce);
+                    debounce = setTimeout(() => {
+                        this.seekTo(relativeX);
+                    }, this.isPlaying() ? 0 : 200);
+                }
+                this.emit('interaction');
+                this.emit('drag', relativeX);
+            }));
+        }
+    }
+    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(this);
+        this.plugins.push(plugin);
+        return plugin;
+    }
+    /** For plugins only: get the waveform wrapper div */
+    getWrapper() {
+        return this.renderer.getWrapper();
+    }
+    /** Get the current scroll position in pixels */
+    getScroll() {
+        return this.renderer.getScroll();
+    }
+    /** 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.emit('load', url);
+        if (channelData) {
+            // Set the mediaelement source to the URL
+            this.setSrc(url);
+            // 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 Fetcher.fetchArrayBuffer(url);
+            this.setSrc(url, audio);
+            this.decodedData = await Decoder.decode(audio, this.options.sampleRate);
+        }
+        this.emit('decode', this.getDuration());
+        this.renderer.render(this.decodedData);
+    }
+    /** 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.subscriptions.forEach((unsubscribe) => unsubscribe());
+        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 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:()=>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 s=t=>{t instanceof CustomEvent&&e(t.detail)},n=String(t);return this.eventTarget.addEventListener(n,s,{once:i}),()=>this.eventTarget.removeEventListener(n,s)}once(t,e){return this.on(t,e,!0)}};const s=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"),s=i.attachShadow({mode:"open"});s.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 .wrapper {\n          position: relative;\n          width: fit-content;\n          min-width: 100%;\n          z-index: 2;\n        }\n        :host canvas {\n          display: block;\n          height: ${this.options.height}px;\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          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.cursorColor||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=s.querySelector(".scroll"),this.mainCanvas=s.querySelector("canvas"),this.ctx=this.mainCanvas.getContext("2d",{desynchronized:!0}),this.progressCanvas=s.querySelector(".progress"),this.cursor=s.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 s,n,o,r,a;return n=this,o=void 0,a=function*(){const{devicePixelRatio:n}=window,{ctx:o}=this,r=null!=this.options.barWidth?this.options.barWidth*n:1,a=null!=this.options.barGap?this.options.barGap*n:this.options.barWidth?r/2:0,h=null!==(s=this.options.barRadius)&&void 0!==s?s:0,l=t[0],d=l.length,c=Math.floor(e/(r+a))/d,u=i/2,p=1===t.length,m=p?l:t[1],y=p&&m.some((t=>t<0)),v=(t,e)=>{let i=0,s=0,n=0;o.beginPath(),o.fillStyle=this.options.waveColor,o.roundRect||(o.roundRect=o.fillRect);for(let d=t;d<e;d++){const t=Math.round(d*c);if(t>i){const e=Math.round(s*u),l=Math.round(n*u);o.roundRect(i*(r+a),u-e,r,e+l||1,h),i=t,s=0,n=0}const e=y?l[d]:Math.abs(l[d]),p=y?m[d]:Math.abs(m[d]);e>s&&(s=e),(y?p<-n:p>n)&&(n=p<0?-p:p)}o.fill(),o.closePath()};o.clearRect(0,0,e,i);const{scrollLeft:g,scrollWidth:f,clientWidth:C}=this.scrollContainer,w=d/f,b=Math.floor(g*w),P=Math.ceil((g+C)*w);v(b,P),this.createProgressMask(),b>0&&(yield this.delay((()=>{v(0,b)}))),P<d&&(yield this.delay((()=>{v(P,d)}))),this.delay((()=>{this.createProgressMask()}))},new((r=void 0)||(r=Promise))((function(t,e){function i(t){try{h(a.next(t))}catch(t){e(t)}}function s(t){try{h(a.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,s)}h((a=a.apply(n,o||[])).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){const{devicePixelRatio:e}=window,i=this.options.fillParent?this.scrollContainer.clientWidth*e:0,s=t.duration*this.options.minPxPerSec,n=s>i,o=Math.max(1,n?s:i),{height:r}=this.options;this.mainCanvas.width=o,this.mainCanvas.height=r,this.mainCanvas.style.width=Math.floor(s/e)+"px";const a=[t.getChannelData(0)];t.numberOfChannels>1&&a.push(t.getChannelData(1)),this.renderPeaks(a,o,r)}zoom(t,e){const i=this.cursor.getBoundingClientRect().left;this.options.minPxPerSec=e,this.render(t);const s=this.cursor.getBoundingClientRect().left;this.scrollContainer.scrollLeft+=s-i}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)}}},n=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 o={height:128,waveColor:"#999",progressColor:"#555",minPxPerSec:0,fillParent:!0,interactive:!0};class r extends i{static create(t){return new r(t)}constructor(t){var e;super(),this.plugins=[],this.subscriptions=[],this.decodedData=null,this.options=Object.assign({},o,t),this.fetcher=new class{load(t){return e=this,i=void 0,n=function*(){return fetch(t).then((t=>t.arrayBuffer()))},new((s=void 0)||(s=Promise))((function(t,o){function r(t){try{h(n.next(t))}catch(t){o(t)}}function a(t){try{h(n.throw(t))}catch(t){o(t)}}function h(e){var i;e.done?t(e.value):(i=e.value,i instanceof s?i:new s((function(t){t(i)}))).then(r,a)}h((n=n.apply(e,i||[])).next())}));var e,i,s,n}},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,n=function*(){if(!this.audioCtx)throw new Error("AudioContext is not initialized");return this.audioCtx.decodeAudioData(t)},new((s=void 0)||(s=Promise))((function(t,o){function r(t){try{h(n.next(t))}catch(t){o(t)}}function a(t){try{h(n.throw(t))}catch(t){o(t)}}function h(e){var i;e.done?t(e.value):(i=e.value,i instanceof s?i:new s((function(t){t(i)}))).then(r,a)}h((n=n.apply(e,i||[])).next())}));var e,i,s,n}destroy(){var t;null===(t=this.audioCtx)||void 0===t||t.close(),this.audioCtx=null}},this.timer=new n,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,i){return this.media.addEventListener(t,e,i),()=>this.media.removeEventListener(t,e)}destroy(){this.media.pause(),this.isExternalMedia||this.media.remove()}loadUrl(t){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()}}getDuration(){return this.media.duration}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 s({container:this.options.container,height:this.options.height,waveColor:this.options.waveColor,progressColor:this.options.progressColor,cursorColor:this.options.cursorColor,minPxPerSec:this.options.minPxPerSec,fillParent:this.options.fillParent,barWidth:this.options.barWidth,barGap:this.options.barGap,barRadius:this.options.barRadius}),this.initPlayerEvents(),this.initRendererEvents(),this.initTimerEvents(),this.initReadyEvent();const i=this.options.url||(null===(e=this.options.media)||void 0===e?void 0:e.src);i&&this.load(i,this.options.peaks,this.options.duration)}initPlayerEvents(){this.subscriptions.push(this.player.on("timeupdate",(()=>{const t=this.getCurrentTime();this.renderer.renderProgress(t/this.getDuration(),this.isPlaying()),this.emit("timeupdate",{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("seeking",{currentTime:this.getCurrentTime()})})))}initRendererEvents(){this.subscriptions.push(this.renderer.on("click",(({relativeX:t})=>{if(this.options.interactive){const e=this.getDuration()*t;this.seekTo(e),this.emit("seekClick",{currentTime:this.getCurrentTime()})}})))}initTimerEvents(){this.subscriptions.push(this.timer.on("tick",(()=>{const t=this.getCurrentTime();this.renderer.renderProgress(t/this.getDuration(),!0),this.emit("timeupdate",{currentTime:t})})))}initReadyEvent(){let t=!1,e=!1;const i=()=>{t&&e&&this.emit("ready",{duration:this.getDuration()})};this.subscriptions.push(this.on("decode",(()=>{t=!0,i()})),this.on("canplay",(()=>{e=!0,i()})),this.player.on("waiting",(()=>{e=!1,t=!1})))}load(t,e,i){return s=this,n=void 0,r=function*(){if(this.player.loadUrl(t),null==e){const e=yield this.fetcher.load(t),i=yield this.decoder.decode(e);this.decodedData=i}else i||(i=(yield new Promise((t=>{this.player.on("canplay",(()=>t(this.getDuration())),{once:!0})})))||0),this.decodedData={duration:i,numberOfChannels:e.length,sampleRate:e[0].length/i,getChannelData:t=>e[t]};this.renderer.render(this.decodedData),this.emit("decode",{duration:this.decodedData.duration})},new((o=void 0)||(o=Promise))((function(t,e){function i(t){try{h(r.next(t))}catch(t){e(t)}}function a(t){try{h(r.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,a)}h((r=r.apply(s,n||[])).next())}));var s,n,o,r}zoom(t){if(!this.decodedData)throw new Error("No audio loaded");this.renderer.zoom(this.decodedData,t)}play(){this.player.play()}pause(){this.player.pause()}seekTo(t){this.player.seekTo(t)}isPlaying(){return this.player.isPlaying()}getDuration(){var t;return this.player.getDuration()||(null===(t=this.decodedData)||void 0===t?void 0:t.duration)||0}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,e){const i=new t({wavesurfer:this,container:this.renderer.getContainer()},e);return this.plugins.push(i),i}getDecodedData(){return this.decodedData}destroy(){this.emit("destroy"),this.subscriptions.forEach((t=>t())),this.plugins.forEach((t=>t.destroy())),this.timer.destroy(),this.player.destroy(),this.decoder.destroy(),this.renderer.destroy()}}const a=r;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,e){const i=new AudioContext({sampleRate:e}),s=i.decodeAudioData(t);return s.finally((()=>i.close())),s},createBuffer:function(t,e){return"number"==typeof t[0]&&(t=[t]),function(t){const e=t[0];if(e.some((t=>t>1||t<-1))){const i=e.length;let s=0;for(let t=0;t<i;t++){const i=Math.abs(e[t]);i>s&&(s=i)}for(const e of t)for(let t=0;t<i;t++)e[t]/=s}}(t),{duration:e,length:t[0].length,sampleRate:t[0].length/e,numberOfChannels:t.length,getChannelData:e=>t?.[e],copyFromChannel:AudioBuffer.prototype.copyFromChannel,copyToChannel:AudioBuffer.prototype.copyToChannel}}},s=async function(t){return fetch(t).then((t=>t.arrayBuffer()))},n=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)))}},r=class extends n{constructor(t){super(),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})}revokeSrc(){(this.media.currentSrc||this.media.src||"").startsWith("blob:")&&URL.revokeObjectURL(this.media.currentSrc)}setSrc(t,e){if((this.media.currentSrc||this.media.src||"")===t)return;this.revokeSrc();const i=e?URL.createObjectURL(new Blob([e],{type:"audio/wav"})):t;this.media.src=i}destroy(){this.media.pause(),this.revokeSrc(),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)}};class o extends n{constructor(t,e){if(super(),this.options={height:0},this.timeout=null,this.isScrolling=!1,this.audioData=null,this.resizeObserver=null,this.isDragging=!1,this.options={...e},"string"==typeof t&&(t=document.querySelector(t)),!t)throw new Error("Container not found");const[i,s]=this.initHtml();t.appendChild(i),this.container=i,this.scrollContainer=s.querySelector(".scroll"),this.wrapper=s.querySelector(".wrapper"),this.canvasWrapper=s.querySelector(".canvases"),this.progressWrapper=s.querySelector(".progress"),this.cursor=s.querySelector(".cursor"),this.initEvents()}initEvents(){this.wrapper.addEventListener("click",(t=>{const e=this.wrapper.getBoundingClientRect(),i=(t.clientX-e.left)/e.width;this.emit("click",i)})),this.initDrag(),this.scrollContainer.addEventListener("scroll",(()=>{const{scrollLeft:t,scrollWidth:e,clientWidth:i}=this.scrollContainer,s=t/e,n=(t+i)/e;this.emit("scroll",s,n)})),this.resizeObserver=new ResizeObserver((()=>{this.delay((()=>this.reRender()),100)})),this.resizeObserver.observe(this.scrollContainer)}initDrag(){this.wrapper.addEventListener("mousedown",(t=>{const e=t.clientX,i=t=>{if(Math.abs(t.clientX-e)>=5){this.isDragging=!0;const e=this.wrapper.getBoundingClientRect();this.emit("drag",Math.max(0,Math.min(1,(t.clientX-e.left)/e.width)))}},s=()=>{document.removeEventListener("mousemove",i),document.removeEventListener("mouseup",s),this.isDragging=!1};document.addEventListener("mousemove",i),document.addEventListener("mouseup",s)}))}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        }\n        :host .cursor {\n          pointer-events: none;\n          position: absolute;\n          z-index: 2;\n          top: 0;\n          left: 0;\n          height: 100%;\n          border-radius: 2px;\n          width: ${this.options.cursorWidth}px;\n          background-color: ${this.options.cursorColor||this.options.progressColor};\n        }\n      </style>\n\n      <div class="scroll" part="scroll">\n        <div class="wrapper">\n          <div class="canvases"></div>\n          <div class="progress"></div>\n          <div class="cursor" part="cursor"></div>\n        </div>\n      </div>\n    `,[t,e]}setOptions(t){this.options=t,this.reRender()}getWrapper(){return this.wrapper}getScroll(){return this.scrollContainer.scrollLeft}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 n=null==this.options.barWidth||isNaN(this.options.barWidth)?1:this.options.barWidth*s,r=null==this.options.barGap||isNaN(this.options.barGap)?this.options.barWidth?n/2:0:this.options.barGap*s,a=this.options.barRadius||0,h=this.options.barHeight||1,l=t.getChannelData(0),c=l.length,d=Math.floor(e/(n+r))/c,u=i/2,p=1===t.numberOfChannels,m=p?l:t.getChannelData(1),g=p&&m.some((t=>t<0)),y=(t,i)=>{let o=0,p=0,y=0;const f=document.createElement("canvas");f.width=Math.round(e*(i-t)/c),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/c)}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)*d);if(i>o){const t=Math.round(p*u*h),e=Math.round(y*u*h);v.roundRect(o*(n+r),u-t,n,t+(e||1),a),o=i,p=0,y=0}const s=g?l[e]:Math.abs(l[e]),c=g?m[e]:Math.abs(m[e]);s>p&&(p=s),(g?c<-y:c>y)&&(y=c<0?-c:c)}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=c/v;let C=Math.min(o.MAX_CANVAS_WIDTH,b);C-=C%((n+r)/s);const P=Math.floor(Math.abs(f)*w),E=Math.ceil(P+C*w);y(P,E);const M=E-P;for(let t=E;t<c;t+=M)await this.delay((()=>{y(t,Math.min(c,t+M))}));for(let t=P-1;t>=0;t-=M)await this.delay((()=>{y(Math.max(0,t-M),t)}))}render(t){const e=window.devicePixelRatio||1,i=this.scrollContainer.clientWidth,s=Math.ceil(t.duration*(this.options.minPxPerSec||0));this.isScrolling=s>i;const n=this.options.fillParent&&!this.isScrolling,r=(n?i:s)*e,{height:o}=this.options;this.wrapper.style.width=n?"100%":`${s}px`,this.scrollContainer.style.overflowX=this.isScrolling?"auto":"hidden",this.scrollContainer.classList.toggle("noScrollbar",!!this.options.hideScrollbar),this.cursor.style.backgroundColor=`${this.options.cursorColor||this.options.progressColor}`,this.cursor.style.width=`${this.options.cursorWidth}px`,this.canvasWrapper.style.height=`${this.options.height}px`,this.renderPeaks(t,r,o,e),this.audioData=t,this.emit("render")}reRender(){if(!this.audioData)return;const t=this.progressWrapper.clientWidth;this.render(this.audioData);const e=this.progressWrapper.clientWidth;this.scrollContainer.scrollLeft+=e-t}zoom(t){this.options.minPxPerSec=t,this.reRender()}scrollIntoView(t,e=!1){const{clientWidth:i,scrollLeft:s,scrollWidth:n}=this.scrollContainer,r=n*t,o=i/2;if(r>s+(e&&this.options.autoCenter&&!this.isDragging?o:i)||r<s)if(this.options.autoCenter&&!this.isDragging){const t=o/20;r-(s+o)>=t&&r<s+i?this.scrollContainer.scrollLeft+=t:this.scrollContainer.scrollLeft=r-o}else if(this.isDragging){const t=10;this.scrollContainer.scrollLeft=r<s?r-t:r-i+t}else this.scrollContainer.scrollLeft=r;{const{scrollLeft:t}=this.scrollContainer,e=t/n,s=(t+i)/n;this.emit("scroll",e,s)}}renderProgress(t,e){isNaN(t)||(this.progressWrapper.style.width=100*t+"%",this.cursor.style.left=100*t+"%",this.cursor.style.marginLeft=100===Math.round(100*t)?`-${this.options.cursorWidth}px`:"",this.isScrolling&&this.options.autoScroll&&this.scrollIntoView(t,e))}}o.MAX_CANVAS_WIDTH=4e3;const a=o,h=class extends n{constructor(){super(...arguments),this.unsubscribe=()=>{}}start(){this.unsubscribe=this.on("tick",(()=>{requestAnimationFrame((()=>{this.emit("tick")}))})),this.emit("tick")}stop(){this.unsubscribe()}destroy(){this.unsubscribe()}},l={height:128,waveColor:"#999",progressColor:"#555",cursorWidth:1,minPxPerSec:0,fillParent:!0,interact:!0,autoScroll:!0,autoCenter:!0,sampleRate:8e3};class c extends r{static create(t){return new c(t)}constructor(t){super({media:t.media,autoplay:t.autoplay,playbackRate:t.audioRate}),this.plugins=[],this.decodedData=null,this.canPlay=!1,this.subscriptions=[],this.options=Object.assign({},l,t),this.timer=new h,this.renderer=new a(this.options.container,this.options),this.initPlayerEvents(),this.initRendererEvents(),this.initTimerEvents(),this.initReadyEvent(),this.initPlugins();const e=this.options.url||this.options.media?.currentSrc||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),t.audioRate&&this.setPlaybackRate(t.audioRate)}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.onMediaEvent("ended",(()=>{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"),this.emit("click",t))})),this.renderer.on("scroll",((t,e)=>{const i=this.getDuration();this.emit("scroll",t*i,e*i)})),this.renderer.on("render",(()=>{this.emit("redraw")})));{let t;this.subscriptions.push(this.renderer.on("drag",(e=>{this.options.interact&&(this.canPlay&&(this.renderer.renderProgress(e),clearTimeout(t),t=setTimeout((()=>{this.seekTo(e)}),this.isPlaying()?0:200)),this.emit("interaction"),this.emit("drag",e))})))}}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(this),this.plugins.push(t),t}getWrapper(){return this.renderer.getWrapper()}getScroll(){return this.renderer.getScroll()}getActivePlugins(){return this.plugins}async load(t,e,n){if(this.decodedData=null,this.canPlay=!1,this.emit("load",t),e)this.setSrc(t),n||(n=await new Promise((t=>{this.onceMediaEvent("loadedmetadata",(()=>t(this.getMediaElement().duration)))}))||0),this.decodedData=i.createBuffer(e,n);else{const e=await s(t);this.setSrc(t,e),this.decodedData=await i.decode(e,this.options.sampleRate)}this.emit("decode",this.getDuration()),this.renderer.render(this.decodedData)}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.subscriptions.forEach((t=>t())),this.plugins.forEach((t=>t.destroy())),this.timer.destroy(),this.renderer.destroy(),super.destroy()}}const d=c;return e.default})()));

package/package.json

@@ -1,40 +1,67 @@
 {
   "name": "wavesurfer.js",
-  "version": "7.0.0-alpha.9",
-  "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-beta.1",
+  "license": "BSD-3-Clause",
+  "author": "katspaugh",
+  "homepage": "https://wavesurfer-js.org",
+  "keywords": [
+    "waveform",
+    "spectrogram",
+    "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",
+    "build:umd:plugins": "webpack --config webpack.config.plugins.js",
+    "build": "tsc && npm run build:umd && npm run build:umd:plugins",
+    "deploy": "yarn build && yarn docs",
+    "prepublishOnly": "npm run build",
+    "docs": "typedoc src/wavesurfer.ts src/plugins/*.ts --out 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 --e2e",
+    "cypress:canary": "cypress open --e2e -b chrome:canary",
+    "test": "cypress run",
+    "serve": "npx live-server --port=9090",
     "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",
-    "browser-sync": "^2.29.0",
-    "eslint": "^8.35.0",
-    "eslint-config-prettier": "^8.7.0",
+    "@typescript-eslint/eslint-plugin": "^5.57.0",
+    "@typescript-eslint/parser": "^5.57.0",
+    "cypress": "^12.9.0",
+    "cypress-image-snapshot": "^4.0.1",
+    "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.24.6",
+    "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,117 +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;
-    /** The color of the playpack cursort */
-    cursorColor?: 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;
-    /** Stretch the waveform to fill the container, true by default */
-    fillParent?: boolean;
-    /** Audio URL */
-    url?: string;
-    /** Pre-computed audio data */
-    peaks?: Float32Array[];
-    /** Pre-computed duration */
-    duration?: number;
-    /** Use an existing media element instead of creating one */
-    media?: HTMLMediaElement;
-    /** Play the audio on load */
-    autoplay?: boolean;
-    /** Is the waveform clickable? */
-    interactive?: boolean;
-};
-export type WaveSurferEvents = {
-    decode: {
-        duration: number;
-    };
-    canplay: {
-        duration: number;
-    };
-    ready: {
-        duration: number;
-    };
-    play: void;
-    pause: void;
-    timeupdate: {
-        currentTime: number;
-    };
-    seeking: {
-        currentTime: number;
-    };
-    seekClick: {
-        currentTime: number;
-    };
-    destroy: void;
-};
-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 decodedData;
-    /** Create a new WaveSurfer instance */
-    static create(options: WaveSurferOptions): WaveSurfer;
-    /** Create a new WaveSurfer instance */
-    constructor(options: WaveSurferOptions);
-    private initPlayerEvents;
-    private initRendererEvents;
-    private initTimerEvents;
-    private initReadyEvent;
-    /** 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, any>>(CustomPlugin: new (params: WaveSurferPluginParams, options: any) => T, options?: any): T;
-    /** Get the decoded audio data */
-    getDecodedData(): AudioBuffer | null;
-    /** Unmount wavesurfer */
-    destroy(): void;
-}
-export default WaveSurfer;