npm - @waveform-playlist/media-element-playout - Versions diffs - 10.0.0 → 10.1.0 - Mend

@waveform-playlist/media-element-playout 10.0.0 → 10.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/LICENSE.md ADDED Viewed

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+Copyright (c) 2015 Naomi
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts CHANGED Viewed

@@ -1,4 +1,5 @@
-import { WaveformDataObject } from '@waveform-playlist/core';
+import { WaveformDataObject, FadeConfig } from '@waveform-playlist/core';
+export { FadeConfig } from '@waveform-playlist/core';
 interface MediaElementTrackOptions {
     /** The audio source - can be a URL, Blob URL, or HTMLAudioElement */
@@ -13,6 +14,22 @@ interface MediaElementTrackOptions {
     volume?: number;
     /** Initial playback rate (0.5 to 2.0, pitch preserved) */
     playbackRate?: number;
+    /**
+     * AudioContext for Web Audio routing.
+     * When provided, audio is routed through Web Audio nodes for fades and effects:
+     *   HTMLAudioElement → MediaElementSourceNode → fadeGain → volumeGain → destination
+     *
+     * Without this, playback uses HTMLAudioElement directly (no fades or effects).
+     *
+     * Note: createMediaElementSource() can only be called once per element.
+     * Once routed, HTMLAudioElement.volume no longer works — volume is controlled
+     * via the Web Audio GainNode instead.
+     */
+    audioContext?: AudioContext;
+    /** Fade in configuration (requires audioContext) */
+    fadeIn?: FadeConfig;
+    /** Fade out configuration (requires audioContext) */
+    fadeOut?: FadeConfig;
 }
 /**
  * Single-track playback using HTMLAudioElement.
@@ -22,10 +39,10 @@ interface MediaElementTrackOptions {
  * - No AudioBuffer decoding required (uses pre-computed peaks for visualization)
  * - Simpler, lighter-weight for single-track use cases
  *
- * Limitations:
- * - Single track only (no multi-track mixing)
- * - No clip-level effects or fades (track-level volume only)
- * - Relies on browser's time-stretching quality
+ * When an AudioContext is provided:
+ * - Audio routes through Web Audio graph for fades and effects
+ * - Volume controlled via GainNode (HTMLAudioElement.volume is bypassed)
+ * - Output node exposed for connecting external effects chains
  */
 declare class MediaElementTrack {
     private audioElement;
@@ -34,13 +51,31 @@ declare class MediaElementTrack {
     private _id;
     private _name;
     private _playbackRate;
+    private _volume;
     private onStopCallback?;
     private onTimeUpdateCallback?;
+    private _audioContext;
+    private _sourceNode;
+    private _fadeGain;
+    private _volumeGain;
+    private _fadeIn;
+    private _fadeOut;
     constructor(options: MediaElementTrackOptions);
     private handleEnded;
     private handleTimeUpdate;
     /**
-     * Start playback from a specific time
+     * Schedule fade automation on the fade GainNode.
+     * Called at the start of each play() — fades are relative to the playback offset.
+     */
+    private _scheduleFades;
+    /**
+     * Cancel any scheduled fade automation.
+     */
+    private _cancelFades;
+    /**
+     * Start playback from a specific time.
+     * Resumes the AudioContext first if suspended, then schedules fades
+     * (fades depend on audioContext.currentTime being non-zero).
      */
     play(offset?: number): void;
     /**
@@ -67,6 +102,14 @@ declare class MediaElementTrack {
      * Set muted state
      */
     setMuted(muted: boolean): void;
+    /**
+     * Set fade in configuration
+     */
+    setFadeIn(fadeIn: FadeConfig | undefined): void;
+    /**
+     * Set fade out configuration
+     */
+    setFadeOut(fadeOut: FadeConfig | undefined): void;
     /**
      * Set callback for when playback ends
      */
@@ -75,6 +118,17 @@ declare class MediaElementTrack {
      * Set callback for time updates
      */
     setOnTimeUpdateCallback(callback: (time: number) => void): void;
+    /**
+     * Connect the output to a different destination (for effects chains).
+     * Disconnects from the current destination first.
+     *
+     * @param destination - The AudioNode to connect to
+     */
+    connectOutput(destination: AudioNode): void;
+    /**
+     * Disconnect the output and reconnect to the default AudioContext destination.
+     */
+    disconnectOutput(): void;
     /**
      * Clean up resources
      */
@@ -92,6 +146,11 @@ declare class MediaElementTrack {
      * Get the underlying audio element (for advanced use cases)
      */
     get element(): HTMLAudioElement;
+    /**
+     * Get the volume GainNode output (for connecting effects chains).
+     * Returns null if no AudioContext was provided.
+     */
+    get outputNode(): GainNode | null;
 }
 interface MediaElementPlayoutOptions {
@@ -113,7 +172,6 @@ interface MediaElementPlayoutOptions {
  *
  * Limitations:
  * - Single track only - will warn if multiple tracks added
- * - No clip-level effects or crossfades
  * - No multi-track mixing
  *
  * For multi-track editing, use TonePlayout from @waveform-playlist/playout instead.
@@ -127,7 +185,9 @@ declare class MediaElementPlayout {
     constructor(options?: MediaElementPlayoutOptions);
     /**
      * Initialize the playout engine.
-     * For MediaElementPlayout this is a no-op (no AudioContext to start).
+     * For MediaElementPlayout this is a no-op — HTMLAudioElement doesn't require
+     * explicit initialization. When an AudioContext is provided for fades/effects,
+     * it resumes automatically on first play via MediaElementTrack.
      */
     init(): Promise<void>;
     /**
@@ -196,6 +256,14 @@ declare class MediaElementPlayout {
     get playbackRate(): number;
     get duration(): number;
     get sampleRate(): number;
+    /**
+     * Get the volume GainNode output for connecting external effects chains.
+     * Returns null if no AudioContext was provided to the track.
+     *
+     * Usage: disconnect from default destination, connect to effect input,
+     * then connect effect output to audioContext.destination.
+     */
+    get outputNode(): GainNode | null;
 }
 /**

package/dist/index.d.ts CHANGED Viewed

@@ -1,4 +1,5 @@
-import { WaveformDataObject } from '@waveform-playlist/core';
+import { WaveformDataObject, FadeConfig } from '@waveform-playlist/core';
+export { FadeConfig } from '@waveform-playlist/core';
 interface MediaElementTrackOptions {
     /** The audio source - can be a URL, Blob URL, or HTMLAudioElement */
@@ -13,6 +14,22 @@ interface MediaElementTrackOptions {
     volume?: number;
     /** Initial playback rate (0.5 to 2.0, pitch preserved) */
     playbackRate?: number;
+    /**
+     * AudioContext for Web Audio routing.
+     * When provided, audio is routed through Web Audio nodes for fades and effects:
+     *   HTMLAudioElement → MediaElementSourceNode → fadeGain → volumeGain → destination
+     *
+     * Without this, playback uses HTMLAudioElement directly (no fades or effects).
+     *
+     * Note: createMediaElementSource() can only be called once per element.
+     * Once routed, HTMLAudioElement.volume no longer works — volume is controlled
+     * via the Web Audio GainNode instead.
+     */
+    audioContext?: AudioContext;
+    /** Fade in configuration (requires audioContext) */
+    fadeIn?: FadeConfig;
+    /** Fade out configuration (requires audioContext) */
+    fadeOut?: FadeConfig;
 }
 /**
  * Single-track playback using HTMLAudioElement.
@@ -22,10 +39,10 @@ interface MediaElementTrackOptions {
  * - No AudioBuffer decoding required (uses pre-computed peaks for visualization)
  * - Simpler, lighter-weight for single-track use cases
  *
- * Limitations:
- * - Single track only (no multi-track mixing)
- * - No clip-level effects or fades (track-level volume only)
- * - Relies on browser's time-stretching quality
+ * When an AudioContext is provided:
+ * - Audio routes through Web Audio graph for fades and effects
+ * - Volume controlled via GainNode (HTMLAudioElement.volume is bypassed)
+ * - Output node exposed for connecting external effects chains
  */
 declare class MediaElementTrack {
     private audioElement;
@@ -34,13 +51,31 @@ declare class MediaElementTrack {
     private _id;
     private _name;
     private _playbackRate;
+    private _volume;
     private onStopCallback?;
     private onTimeUpdateCallback?;
+    private _audioContext;
+    private _sourceNode;
+    private _fadeGain;
+    private _volumeGain;
+    private _fadeIn;
+    private _fadeOut;
     constructor(options: MediaElementTrackOptions);
     private handleEnded;
     private handleTimeUpdate;
     /**
-     * Start playback from a specific time
+     * Schedule fade automation on the fade GainNode.
+     * Called at the start of each play() — fades are relative to the playback offset.
+     */
+    private _scheduleFades;
+    /**
+     * Cancel any scheduled fade automation.
+     */
+    private _cancelFades;
+    /**
+     * Start playback from a specific time.
+     * Resumes the AudioContext first if suspended, then schedules fades
+     * (fades depend on audioContext.currentTime being non-zero).
      */
     play(offset?: number): void;
     /**
@@ -67,6 +102,14 @@ declare class MediaElementTrack {
      * Set muted state
      */
     setMuted(muted: boolean): void;
+    /**
+     * Set fade in configuration
+     */
+    setFadeIn(fadeIn: FadeConfig | undefined): void;
+    /**
+     * Set fade out configuration
+     */
+    setFadeOut(fadeOut: FadeConfig | undefined): void;
     /**
      * Set callback for when playback ends
      */
@@ -75,6 +118,17 @@ declare class MediaElementTrack {
      * Set callback for time updates
      */
     setOnTimeUpdateCallback(callback: (time: number) => void): void;
+    /**
+     * Connect the output to a different destination (for effects chains).
+     * Disconnects from the current destination first.
+     *
+     * @param destination - The AudioNode to connect to
+     */
+    connectOutput(destination: AudioNode): void;
+    /**
+     * Disconnect the output and reconnect to the default AudioContext destination.
+     */
+    disconnectOutput(): void;
     /**
      * Clean up resources
      */
@@ -92,6 +146,11 @@ declare class MediaElementTrack {
      * Get the underlying audio element (for advanced use cases)
      */
     get element(): HTMLAudioElement;
+    /**
+     * Get the volume GainNode output (for connecting effects chains).
+     * Returns null if no AudioContext was provided.
+     */
+    get outputNode(): GainNode | null;
 }
 interface MediaElementPlayoutOptions {
@@ -113,7 +172,6 @@ interface MediaElementPlayoutOptions {
  *
  * Limitations:
  * - Single track only - will warn if multiple tracks added
- * - No clip-level effects or crossfades
  * - No multi-track mixing
  *
  * For multi-track editing, use TonePlayout from @waveform-playlist/playout instead.
@@ -127,7 +185,9 @@ declare class MediaElementPlayout {
     constructor(options?: MediaElementPlayoutOptions);
     /**
      * Initialize the playout engine.
-     * For MediaElementPlayout this is a no-op (no AudioContext to start).
+     * For MediaElementPlayout this is a no-op — HTMLAudioElement doesn't require
+     * explicit initialization. When an AudioContext is provided for fades/effects,
+     * it resumes automatically on first play via MediaElementTrack.
      */
     init(): Promise<void>;
     /**
@@ -196,6 +256,14 @@ declare class MediaElementPlayout {
     get playbackRate(): number;
     get duration(): number;
     get sampleRate(): number;
+    /**
+     * Get the volume GainNode output for connecting external effects chains.
+     * Returns null if no AudioContext was provided to the track.
+     *
+     * Usage: disconnect from default destination, connect to effect input,
+     * then connect effect output to audioContext.destination.
+     */
+    get outputNode(): GainNode | null;
 }
 /**

package/dist/index.js CHANGED Viewed

@@ -27,10 +27,17 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 // src/MediaElementTrack.ts
+var import_core = require("@waveform-playlist/core");
 var MediaElementTrack = class {
   constructor(options) {
     this._playbackRate = 1;
+    // Web Audio nodes (only when audioContext is provided)
+    this._audioContext = null;
+    this._sourceNode = null;
+    this._fadeGain = null;
+    this._volumeGain = null;
     this.handleEnded = () => {
+      this._cancelFades();
       if (this.onStopCallback) {
         this.onStopCallback();
       }
@@ -44,6 +51,9 @@ var MediaElementTrack = class {
     this._id = options.id ?? `track-${Date.now()}`;
     this._name = options.name ?? "Track";
     this._playbackRate = options.playbackRate ?? 1;
+    this._volume = options.volume ?? 1;
+    this._fadeIn = options.fadeIn;
+    this._fadeOut = options.fadeOut;
     if (typeof options.source === "string") {
       this.audioElement = new Audio(options.source);
       this.ownsElement = true;
@@ -52,7 +62,6 @@ var MediaElementTrack = class {
       this.ownsElement = false;
     }
     this.audioElement.preload = "auto";
-    this.audioElement.volume = options.volume ?? 1;
     this.audioElement.playbackRate = this._playbackRate;
     const audio = this.audioElement;
     if ("preservesPitch" in this.audioElement) {
@@ -62,28 +71,125 @@ var MediaElementTrack = class {
     } else if ("webkitPreservesPitch" in this.audioElement) {
       audio.webkitPreservesPitch = true;
     }
+    if (options.audioContext) {
+      this._audioContext = options.audioContext;
+      try {
+        this._sourceNode = options.audioContext.createMediaElementSource(this.audioElement);
+      } catch (err) {
+        throw new Error(
+          "[waveform-playlist] MediaElementTrack: createMediaElementSource() failed. This can happen if the audio element is already connected to another AudioContext. Each audio element can only have one MediaElementSourceNode. Original error: " + String(err)
+        );
+      }
+      this._fadeGain = options.audioContext.createGain();
+      this._volumeGain = options.audioContext.createGain();
+      this._volumeGain.gain.value = this._volume;
+      this._sourceNode.connect(this._fadeGain);
+      this._fadeGain.connect(this._volumeGain);
+      this._volumeGain.connect(options.audioContext.destination);
+      this.audioElement.volume = 1;
+    } else {
+      this.audioElement.volume = this._volume;
+    }
     this.audioElement.addEventListener("ended", this.handleEnded);
     this.audioElement.addEventListener("timeupdate", this.handleTimeUpdate);
   }
   /**
-   * Start playback from a specific time
+   * Schedule fade automation on the fade GainNode.
+   * Called at the start of each play() — fades are relative to the playback offset.
+   */
+  _scheduleFades(offset) {
+    if (!this._fadeGain || !this._audioContext) return;
+    const fadeGain = this._fadeGain.gain;
+    const now = this._audioContext.currentTime;
+    const totalDuration = this.duration;
+    fadeGain.cancelScheduledValues(0);
+    fadeGain.setValueAtTime(1, now);
+    if (this._fadeIn && this._fadeIn.duration > 0) {
+      const fadeInEnd = this._fadeIn.duration;
+      if (offset < fadeInEnd) {
+        const remainingFade = fadeInEnd - offset;
+        const fadeType = this._fadeIn.type ?? "linear";
+        if (offset === 0) {
+          (0, import_core.applyFadeIn)(fadeGain, now, remainingFade, fadeType, 0, 1);
+        } else {
+          const curve = (0, import_core.generateCurve)(fadeType, 1e3, true);
+          const startIndex = Math.round(offset / this._fadeIn.duration * (curve.length - 1));
+          const sliced = curve.slice(startIndex);
+          fadeGain.setValueAtTime(sliced[0], now);
+          fadeGain.setValueCurveAtTime(sliced, now, remainingFade);
+        }
+      }
+    }
+    if (this._fadeOut && this._fadeOut.duration > 0) {
+      const fadeOutStart = totalDuration - this._fadeOut.duration;
+      if (offset < totalDuration && fadeOutStart < totalDuration) {
+        if (offset > fadeOutStart) {
+          const elapsed = offset - fadeOutStart;
+          const fadeType = this._fadeOut.type ?? "linear";
+          const curve = (0, import_core.generateCurve)(fadeType, 1e3, false);
+          const startIndex = Math.round(elapsed / this._fadeOut.duration * (curve.length - 1));
+          const sliced = curve.slice(startIndex);
+          const remainingDuration = this._fadeOut.duration - elapsed;
+          fadeGain.setValueAtTime(sliced[0], now);
+          fadeGain.setValueCurveAtTime(sliced, now, remainingDuration);
+        } else {
+          const delayUntilFadeOut = fadeOutStart - offset;
+          (0, import_core.applyFadeOut)(
+            fadeGain,
+            now + delayUntilFadeOut,
+            this._fadeOut.duration,
+            this._fadeOut.type ?? "linear",
+            1,
+            0
+          );
+        }
+      }
+    }
+  }
+  /**
+   * Cancel any scheduled fade automation.
+   */
+  _cancelFades() {
+    if (this._fadeGain) {
+      this._fadeGain.gain.cancelScheduledValues(0);
+      this._fadeGain.gain.value = 1;
+    }
+  }
+  /**
+   * Start playback from a specific time.
+   * Resumes the AudioContext first if suspended, then schedules fades
+   * (fades depend on audioContext.currentTime being non-zero).
    */
   play(offset = 0) {
-    this.audioElement.currentTime = offset;
-    this.audioElement.play().catch((err) => {
-      console.warn("MediaElementTrack: play() failed:", err);
-    });
+    const startPlayback = () => {
+      this._scheduleFades(offset);
+      this.audioElement.currentTime = offset;
+      this.audioElement.play().catch((err) => {
+        console.warn("[waveform-playlist] MediaElementTrack: play() failed: " + String(err));
+      });
+    };
+    if (this._audioContext && this._audioContext.state === "suspended") {
+      this._audioContext.resume().then(startPlayback).catch((err) => {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: AudioContext.resume() failed: " + String(err)
+        );
+      });
+    } else {
+      startPlayback();
+    }
   }
   /**
    * Pause playback
    */
   pause() {
+    this._cancelFades();
     this.audioElement.pause();
   }
   /**
    * Stop playback and reset to beginning
    */
   stop() {
+    this._cancelFades();
     this.audioElement.pause();
     this.audioElement.currentTime = 0;
   }
@@ -97,7 +203,12 @@ var MediaElementTrack = class {
    * Set volume (0.0 to 1.0)
    */
   setVolume(volume) {
-    this.audioElement.volume = Math.max(0, Math.min(1, volume));
+    this._volume = Math.max(0, Math.min(1, volume));
+    if (this._volumeGain) {
+      this._volumeGain.gain.value = this._volume;
+    } else {
+      this.audioElement.volume = this._volume;
+    }
   }
   /**
    * Set playback rate (0.5 to 2.0, pitch preserved)
@@ -113,6 +224,18 @@ var MediaElementTrack = class {
   setMuted(muted) {
     this.audioElement.muted = muted;
   }
+  /**
+   * Set fade in configuration
+   */
+  setFadeIn(fadeIn) {
+    this._fadeIn = fadeIn;
+  }
+  /**
+   * Set fade out configuration
+   */
+  setFadeOut(fadeOut) {
+    this._fadeOut = fadeOut;
+  }
   /**
    * Set callback for when playback ends
    */
@@ -125,13 +248,77 @@ var MediaElementTrack = class {
   setOnTimeUpdateCallback(callback) {
     this.onTimeUpdateCallback = callback;
   }
+  /**
+   * Connect the output to a different destination (for effects chains).
+   * Disconnects from the current destination first.
+   *
+   * @param destination - The AudioNode to connect to
+   */
+  connectOutput(destination) {
+    if (!this._volumeGain) {
+      console.warn(
+        "[waveform-playlist] MediaElementTrack: connectOutput() requires audioContext. Pass audioContext in constructor options."
+      );
+      return;
+    }
+    try {
+      this._volumeGain.disconnect();
+    } catch (err) {
+      console.warn(
+        "[waveform-playlist] MediaElementTrack: disconnect before connectOutput failed: " + String(err)
+      );
+    }
+    this._volumeGain.connect(destination);
+  }
+  /**
+   * Disconnect the output and reconnect to the default AudioContext destination.
+   */
+  disconnectOutput() {
+    if (!this._volumeGain || !this._audioContext) return;
+    try {
+      this._volumeGain.disconnect();
+    } catch (err) {
+      console.warn(
+        "[waveform-playlist] MediaElementTrack: disconnect before disconnectOutput failed: " + String(err)
+      );
+    }
+    this._volumeGain.connect(this._audioContext.destination);
+  }
   /**
    * Clean up resources
    */
   dispose() {
     this.audioElement.removeEventListener("ended", this.handleEnded);
     this.audioElement.removeEventListener("timeupdate", this.handleTimeUpdate);
+    this._cancelFades();
     this.audioElement.pause();
+    if (this._sourceNode) {
+      try {
+        this._sourceNode.disconnect();
+      } catch (err) {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: sourceNode disconnect failed: " + String(err)
+        );
+      }
+    }
+    if (this._fadeGain) {
+      try {
+        this._fadeGain.disconnect();
+      } catch (err) {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: fadeGain disconnect failed: " + String(err)
+        );
+      }
+    }
+    if (this._volumeGain) {
+      try {
+        this._volumeGain.disconnect();
+      } catch (err) {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: volumeGain disconnect failed: " + String(err)
+        );
+      }
+    }
     if (this.ownsElement) {
       this.audioElement.src = "";
       this.audioElement.load();
@@ -157,7 +344,7 @@ var MediaElementTrack = class {
     return !this.audioElement.paused && !this.audioElement.ended;
   }
   get volume() {
-    return this.audioElement.volume;
+    return this._volume;
   }
   get playbackRate() {
     return this._playbackRate;
@@ -171,6 +358,13 @@ var MediaElementTrack = class {
   get element() {
     return this.audioElement;
   }
+  /**
+   * Get the volume GainNode output (for connecting effects chains).
+   * Returns null if no AudioContext was provided.
+   */
+  get outputNode() {
+    return this._volumeGain;
+  }
 };
 // src/MediaElementPlayout.ts
@@ -183,7 +377,9 @@ var MediaElementPlayout = class {
   }
   /**
    * Initialize the playout engine.
-   * For MediaElementPlayout this is a no-op (no AudioContext to start).
+   * For MediaElementPlayout this is a no-op — HTMLAudioElement doesn't require
+   * explicit initialization. When an AudioContext is provided for fades/effects,
+   * it resumes automatically on first play via MediaElementTrack.
    */
   async init() {
   }
@@ -355,6 +551,16 @@ var MediaElementPlayout = class {
   get sampleRate() {
     return this.track?.peaks.sample_rate ?? 44100;
   }
+  /**
+   * Get the volume GainNode output for connecting external effects chains.
+   * Returns null if no AudioContext was provided to the track.
+   *
+   * Usage: disconnect from default destination, connect to effect input,
+   * then connect effect output to audioContext.destination.
+   */
+  get outputNode() {
+    return this.track?.outputNode ?? null;
+  }
 };
 // src/types.ts

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts","../src/MediaElementTrack.ts","../src/MediaElementPlayout.ts","../src/types.ts"],"sourcesContent":["export { MediaElementPlayout } from './MediaElementPlayout';\nexport { MediaElementTrack } from './MediaElementTrack';\n\nexport type { MediaElementPlayoutOptions } from './MediaElementPlayout';\nexport type { MediaElementTrackOptions } from './MediaElementTrack';\n\n// Common interface types\nexport type { PlayoutEngine, PlaybackRateEngine } from './types';\nexport { supportsPlaybackRate } from './types';\n","import type { WaveformDataObject } from '@waveform-playlist/core';\n\n/*\n Extended HTMLAudioElement with vendor-prefixed preservesPitch properties.\n * `preservesPitch` is standard; the `moz` and `webkit` prefixes are for older browsers.\n /\ninterface VendorPrefixedPitch {\n preservesPitch?: boolean;\n mozPreservesPitch?: boolean;\n webkitPreservesPitch?: boolean;\n}\n\nexport interface MediaElementTrackOptions {\n /* The audio source - can be a URL, Blob URL, or HTMLAudioElement /\n source: string \| HTMLAudioElement;\n /* Pre-computed waveform data for visualization (required - no AudioBuffer decoding) /\n peaks: WaveformDataObject;\n /* Track ID /\n id?: string;\n /* Track name for display /\n name?: string;\n /* Initial volume (0.0 to 1.0) /\n volume?: number;\n /* Initial playback rate (0.5 to 2.0, pitch preserved) /\n playbackRate?: number;\n}\n\n/\n Single-track playback using HTMLAudioElement.\n \n Benefits over AudioBuffer/Tone.js:\n * - Pitch-preserving playback rate (0.5x - 2.0x) via browser's built-in algorithm\n * - No AudioBuffer decoding required (uses pre-computed peaks for visualization)\n * - Simpler, lighter-weight for single-track use cases\n \n Limitations:\n * - Single track only (no multi-track mixing)\n * - No clip-level effects or fades (track-level volume only)\n * - Relies on browser's time-stretching quality\n /\nexport class MediaElementTrack {\n private audioElement: HTMLAudioElement;\n private ownsElement: boolean; // Whether we created the element (need to clean up)\n private _peaks: WaveformDataObject;\n private _id: string;\n private _name: string;\n private _playbackRate: number = 1;\n private onStopCallback?: () => void;\n private onTimeUpdateCallback?: (time: number) => void;\n\n constructor(options: MediaElementTrackOptions) {\n this._peaks = options.peaks;\n this._id = options.id ?? `track-${Date.now()}`;\n this._name = options.name ?? 'Track';\n this._playbackRate = options.playbackRate ?? 1;\n\n // Create or use provided audio element\n if (typeof options.source === 'string') {\n this.audioElement = new Audio(options.source);\n this.ownsElement = true;\n } else {\n this.audioElement = options.source;\n this.ownsElement = false;\n }\n\n // Configure audio element\n this.audioElement.preload = 'auto';\n this.audioElement.volume = options.volume ?? 1;\n this.audioElement.playbackRate = this._playbackRate;\n\n // Preserve pitch when changing playback rate (default in modern browsers)\n // Some older browsers may not support this, but it's the default behavior\n // Vendor-prefixed properties are non-standard; cast once for type safety.\n const audio = this.audioElement as unknown as VendorPrefixedPitch;\n if ('preservesPitch' in this.audioElement) {\n audio.preservesPitch = true;\n } else if ('mozPreservesPitch' in this.audioElement) {\n // Firefox prefix\n audio.mozPreservesPitch = true;\n } else if ('webkitPreservesPitch' in this.audioElement) {\n // Safari prefix\n audio.webkitPreservesPitch = true;\n }\n\n // Set up event listeners\n this.audioElement.addEventListener('ended', this.handleEnded);\n this.audioElement.addEventListener('timeupdate', this.handleTimeUpdate);\n }\n\n private handleEnded = () => {\n if (this.onStopCallback) {\n this.onStopCallback();\n }\n };\n\n private handleTimeUpdate = () => {\n if (this.onTimeUpdateCallback) {\n this.onTimeUpdateCallback(this.audioElement.currentTime);\n }\n };\n\n /\n Start playback from a specific time\n /\n play(offset: number = 0): void {\n this.audioElement.currentTime = offset;\n this.audioElement.play().catch((err) => {\n console.warn('MediaElementTrack: play() failed:', err);\n });\n }\n\n /\n Pause playback\n /\n pause(): void {\n this.audioElement.pause();\n }\n\n /\n Stop playback and reset to beginning\n /\n stop(): void {\n this.audioElement.pause();\n this.audioElement.currentTime = 0;\n }\n\n /\n Seek to a specific time\n /\n seekTo(time: number): void {\n this.audioElement.currentTime = Math.max(0, Math.min(time, this.duration));\n }\n\n /\n Set volume (0.0 to 1.0)\n /\n setVolume(volume: number): void {\n this.audioElement.volume = Math.max(0, Math.min(1, volume));\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved)\n /\n setPlaybackRate(rate: number): void {\n // Clamp to reasonable range for pitch preservation quality\n const clampedRate = Math.max(0.5, Math.min(2.0, rate));\n this._playbackRate = clampedRate;\n this.audioElement.playbackRate = clampedRate;\n }\n\n /\n Set muted state\n /\n setMuted(muted: boolean): void {\n this.audioElement.muted = muted;\n }\n\n /\n Set callback for when playback ends\n /\n setOnStopCallback(callback: () => void): void {\n this.onStopCallback = callback;\n }\n\n /\n Set callback for time updates\n /\n setOnTimeUpdateCallback(callback: (time: number) => void): void {\n this.onTimeUpdateCallback = callback;\n }\n\n /\n Clean up resources\n /\n dispose(): void {\n this.audioElement.removeEventListener('ended', this.handleEnded);\n this.audioElement.removeEventListener('timeupdate', this.handleTimeUpdate);\n this.audioElement.pause();\n\n if (this.ownsElement) {\n this.audioElement.src = '';\n this.audioElement.load(); // Release resources\n }\n }\n\n // Getters\n get id(): string {\n return this._id;\n }\n\n get name(): string {\n return this._name;\n }\n\n get peaks(): WaveformDataObject {\n return this._peaks;\n }\n\n get currentTime(): number {\n return this.audioElement.currentTime;\n }\n\n get duration(): number {\n return this.audioElement.duration \|\| this._peaks.duration;\n }\n\n get isPlaying(): boolean {\n return !this.audioElement.paused && !this.audioElement.ended;\n }\n\n get volume(): number {\n return this.audioElement.volume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get muted(): boolean {\n return this.audioElement.muted;\n }\n\n /\n Get the underlying audio element (for advanced use cases)\n /\n get element(): HTMLAudioElement {\n return this.audioElement;\n }\n}\n","import { MediaElementTrack, type MediaElementTrackOptions } from './MediaElementTrack';\n\nexport interface MediaElementPlayoutOptions {\n /* Initial master volume (0.0 to 1.0) /\n masterVolume?: number;\n /* Initial playback rate (0.5 to 2.0) /\n playbackRate?: number;\n}\n\n/\n Single-track playout engine using HTMLAudioElement.\n \n This is a lightweight alternative to TonePlayout for single-track use cases\n * that need pitch-preserving playback rate control.\n \n Key features:\n * - Pitch-preserving playback rate (0.5x - 2.0x)\n * - Uses pre-computed peaks (no AudioBuffer required)\n * - Simpler API for single-track playback\n \n Limitations:\n * - Single track only - will warn if multiple tracks added\n * - No clip-level effects or crossfades\n * - No multi-track mixing\n \n For multi-track editing, use TonePlayout from @waveform-playlist/playout instead.\n /\nexport class MediaElementPlayout {\n private track: MediaElementTrack \| null = null;\n private _masterVolume: number;\n private _playbackRate: number;\n private _isPlaying: boolean = false;\n private onPlaybackCompleteCallback?: () => void;\n\n constructor(options: MediaElementPlayoutOptions = {}) {\n this._masterVolume = options.masterVolume ?? 1;\n this._playbackRate = options.playbackRate ?? 1;\n }\n\n /\n Initialize the playout engine.\n * For MediaElementPlayout this is a no-op (no AudioContext to start).\n /\n async init(): Promise<void> {\n // No initialization needed for HTMLAudioElement\n // AudioContext requires user gesture, but audio element just works\n }\n\n /\n Add a track to the playout.\n * Note: Only one track is supported. Adding a second track will dispose the first.\n /\n addTrack(options: MediaElementTrackOptions): MediaElementTrack {\n if (this.track) {\n console.warn(\n 'MediaElementPlayout: Only one track is supported. ' +\n 'Disposing previous track. For multi-track, use TonePlayout.'\n );\n this.track.dispose();\n }\n\n this.track = new MediaElementTrack({\n ...options,\n volume: this._masterVolume (options.volume ?? 1),\n playbackRate: this._playbackRate,\n });\n\n // Set up stop callback\n this.track.setOnStopCallback(() => {\n this._isPlaying = false;\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n });\n\n return this.track;\n }\n\n /*\n Remove a track by ID.\n /\n removeTrack(trackId: string): void {\n if (this.track && this.track.id === trackId) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n /\n Get a track by ID.\n /\n getTrack(trackId: string): MediaElementTrack \| undefined {\n if (this.track && this.track.id === trackId) {\n return this.track;\n }\n return undefined;\n }\n\n /\n Start playback.\n * @param _when - Ignored (HTMLAudioElement doesn't support scheduled start)\n * @param offset - Start position in seconds\n * @param duration - Duration to play in seconds (optional)\n /\n play(_when?: number, offset?: number, duration?: number): void {\n if (!this.track) {\n console.warn('MediaElementPlayout: No track to play');\n return;\n }\n\n const startPosition = offset ?? 0;\n this._isPlaying = true;\n\n this.track.play(startPosition);\n\n // If duration is specified, schedule stop\n if (duration !== undefined) {\n const adjustedDuration = duration / this._playbackRate;\n setTimeout(() => {\n if (this._isPlaying) {\n this.pause();\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n }\n }, adjustedDuration 1000);\n }\n }\n\n /*\n Pause playback.\n /\n pause(): void {\n if (this.track) {\n this.track.pause();\n }\n this._isPlaying = false;\n }\n\n /\n Stop playback and reset to start.\n /\n stop(): void {\n if (this.track) {\n this.track.stop();\n }\n this._isPlaying = false;\n }\n\n /\n Seek to a specific time.\n /\n seekTo(time: number): void {\n if (this.track) {\n this.track.seekTo(time);\n }\n }\n\n /\n Get current playback time.\n /\n getCurrentTime(): number {\n if (this.track) {\n return this.track.currentTime;\n }\n return 0;\n }\n\n /\n Set master volume.\n /\n setMasterVolume(volume: number): void {\n this._masterVolume = Math.max(0, Math.min(1, volume));\n if (this.track) {\n this.track.setVolume(this._masterVolume);\n }\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved).\n /\n setPlaybackRate(rate: number): void {\n this._playbackRate = Math.max(0.5, Math.min(2.0, rate));\n if (this.track) {\n this.track.setPlaybackRate(this._playbackRate);\n }\n }\n\n /\n Set mute state for a track.\n /\n setMute(trackId: string, muted: boolean): void {\n const track = this.getTrack(trackId);\n if (track) {\n track.setMuted(muted);\n }\n }\n\n /\n Set solo state for a track.\n * Note: With single track, solo is effectively the same as unmute.\n /\n setSolo(_trackId: string, _soloed: boolean): void {\n // No-op for single track - solo doesn't make sense\n console.warn('MediaElementPlayout: Solo is not applicable for single-track playback');\n }\n\n /\n Set callback for when playback completes.\n /\n setOnPlaybackComplete(callback: () => void): void {\n this.onPlaybackCompleteCallback = callback;\n }\n\n /\n Clean up resources.\n /\n dispose(): void {\n if (this.track) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n // Getters\n get isPlaying(): boolean {\n return this._isPlaying;\n }\n\n get masterVolume(): number {\n return this._masterVolume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get duration(): number {\n return this.track?.duration ?? 0;\n }\n\n get sampleRate(): number {\n // HTMLAudioElement doesn't expose sample rate directly\n // Return a common default - peaks will have the actual sample rate\n return this.track?.peaks.sample_rate ?? 44100;\n }\n}\n","/\n Common interface for playout engines.\n \n Both TonePlayout and MediaElementPlayout implement this interface,\n * allowing the browser package to work with either engine.\n /\nexport interface PlayoutEngine {\n // Lifecycle\n init(): Promise<void>;\n dispose(): void;\n\n // Playback\n play(when?: number, offset?: number, duration?: number): void;\n pause(): void;\n stop(): void;\n seekTo(time: number): void;\n getCurrentTime(): number;\n\n // Volume\n setMasterVolume(volume: number): void;\n\n // Track controls (optional - not all engines support all features)\n setMute?(trackId: string, muted: boolean): void;\n setSolo?(trackId: string, soloed: boolean): void;\n\n // Callbacks\n setOnPlaybackComplete(callback: () => void): void;\n\n // State\n readonly isPlaying: boolean;\n readonly duration: number;\n readonly sampleRate: number;\n}\n\n/\n Extended interface for engines that support playback rate.\n /\nexport interface PlaybackRateEngine extends PlayoutEngine {\n setPlaybackRate(rate: number): void;\n readonly playbackRate: number;\n}\n\n/\n Type guard to check if an engine supports playback rate.\n */\nexport function supportsPlaybackRate(engine: PlayoutEngine): engine is PlaybackRateEngine {\n return (\n 'setPlaybackRate' in engine &&\n typeof (engine as Record<string, unknown>).setPlaybackRate === 'function'\n );\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/index.ts","../src/MediaElementTrack.ts","../src/MediaElementPlayout.ts","../src/types.ts"],"sourcesContent":["export { MediaElementPlayout } from './MediaElementPlayout';\nexport { MediaElementTrack } from './MediaElementTrack';\n\nexport type { MediaElementPlayoutOptions } from './MediaElementPlayout';\nexport type { MediaElementTrackOptions, FadeConfig } from './MediaElementTrack';\n\n// Common interface types\nexport type { PlayoutEngine, PlaybackRateEngine } from './types';\nexport { supportsPlaybackRate } from './types';\n","import type { WaveformDataObject, FadeConfig } from '@waveform-playlist/core';\nimport { applyFadeIn, applyFadeOut, generateCurve } from '@waveform-playlist/core';\n\nexport type { FadeConfig } from '@waveform-playlist/core';\n\n/*\n Extended HTMLAudioElement with vendor-prefixed preservesPitch properties.\n * `preservesPitch` is standard; the `moz` and `webkit` prefixes are for older browsers.\n /\ninterface VendorPrefixedPitch {\n preservesPitch?: boolean;\n mozPreservesPitch?: boolean;\n webkitPreservesPitch?: boolean;\n}\n\nexport interface MediaElementTrackOptions {\n /* The audio source - can be a URL, Blob URL, or HTMLAudioElement /\n source: string \| HTMLAudioElement;\n /* Pre-computed waveform data for visualization (required - no AudioBuffer decoding) /\n peaks: WaveformDataObject;\n /* Track ID /\n id?: string;\n /* Track name for display /\n name?: string;\n /* Initial volume (0.0 to 1.0) /\n volume?: number;\n /* Initial playback rate (0.5 to 2.0, pitch preserved) /\n playbackRate?: number;\n /\n AudioContext for Web Audio routing.\n * When provided, audio is routed through Web Audio nodes for fades and effects:\n * HTMLAudioElement → MediaElementSourceNode → fadeGain → volumeGain → destination\n \n Without this, playback uses HTMLAudioElement directly (no fades or effects).\n \n Note: createMediaElementSource() can only be called once per element.\n * Once routed, HTMLAudioElement.volume no longer works — volume is controlled\n * via the Web Audio GainNode instead.\n /\n audioContext?: AudioContext;\n /* Fade in configuration (requires audioContext) /\n fadeIn?: FadeConfig;\n /* Fade out configuration (requires audioContext) /\n fadeOut?: FadeConfig;\n}\n\n/\n Single-track playback using HTMLAudioElement.\n \n Benefits over AudioBuffer/Tone.js:\n * - Pitch-preserving playback rate (0.5x - 2.0x) via browser's built-in algorithm\n * - No AudioBuffer decoding required (uses pre-computed peaks for visualization)\n * - Simpler, lighter-weight for single-track use cases\n \n When an AudioContext is provided:\n * - Audio routes through Web Audio graph for fades and effects\n * - Volume controlled via GainNode (HTMLAudioElement.volume is bypassed)\n * - Output node exposed for connecting external effects chains\n /\nexport class MediaElementTrack {\n private audioElement: HTMLAudioElement;\n private ownsElement: boolean; // Whether we created the element (need to clean up)\n private _peaks: WaveformDataObject;\n private _id: string;\n private _name: string;\n private _playbackRate: number = 1;\n private _volume: number;\n private onStopCallback?: () => void;\n private onTimeUpdateCallback?: (time: number) => void;\n\n // Web Audio nodes (only when audioContext is provided)\n private _audioContext: AudioContext \| null = null;\n private _sourceNode: MediaElementAudioSourceNode \| null = null;\n private _fadeGain: GainNode \| null = null;\n private _volumeGain: GainNode \| null = null;\n private _fadeIn: FadeConfig \| undefined;\n private _fadeOut: FadeConfig \| undefined;\n\n constructor(options: MediaElementTrackOptions) {\n this._peaks = options.peaks;\n this._id = options.id ?? `track-${Date.now()}`;\n this._name = options.name ?? 'Track';\n this._playbackRate = options.playbackRate ?? 1;\n this._volume = options.volume ?? 1;\n this._fadeIn = options.fadeIn;\n this._fadeOut = options.fadeOut;\n\n // Create or use provided audio element\n if (typeof options.source === 'string') {\n this.audioElement = new Audio(options.source);\n this.ownsElement = true;\n } else {\n this.audioElement = options.source;\n this.ownsElement = false;\n }\n\n // Configure audio element\n this.audioElement.preload = 'auto';\n this.audioElement.playbackRate = this._playbackRate;\n\n // Preserve pitch when changing playback rate (default in modern browsers)\n // Vendor-prefixed properties are non-standard; cast once for type safety.\n const audio = this.audioElement as unknown as VendorPrefixedPitch;\n if ('preservesPitch' in this.audioElement) {\n audio.preservesPitch = true;\n } else if ('mozPreservesPitch' in this.audioElement) {\n audio.mozPreservesPitch = true;\n } else if ('webkitPreservesPitch' in this.audioElement) {\n audio.webkitPreservesPitch = true;\n }\n\n // Set up Web Audio routing if AudioContext provided\n if (options.audioContext) {\n this._audioContext = options.audioContext;\n try {\n this._sourceNode = options.audioContext.createMediaElementSource(this.audioElement);\n } catch (err) {\n throw new Error(\n '[waveform-playlist] MediaElementTrack: createMediaElementSource() failed. ' +\n 'This can happen if the audio element is already connected to another AudioContext. ' +\n 'Each audio element can only have one MediaElementSourceNode. ' +\n 'Original error: ' +\n String(err)\n );\n }\n this._fadeGain = options.audioContext.createGain();\n this._volumeGain = options.audioContext.createGain();\n this._volumeGain.gain.value = this._volume;\n\n this._sourceNode.connect(this._fadeGain);\n this._fadeGain.connect(this._volumeGain);\n this._volumeGain.connect(options.audioContext.destination);\n\n // With Web Audio routing, HTMLAudioElement.volume is bypassed.\n // Set it to 1 so it doesn't attenuate the signal before the source node.\n this.audioElement.volume = 1;\n } else {\n // Without Web Audio, use HTMLAudioElement.volume directly\n this.audioElement.volume = this._volume;\n }\n\n // Set up event listeners\n this.audioElement.addEventListener('ended', this.handleEnded);\n this.audioElement.addEventListener('timeupdate', this.handleTimeUpdate);\n }\n\n private handleEnded = () => {\n this._cancelFades();\n if (this.onStopCallback) {\n this.onStopCallback();\n }\n };\n\n private handleTimeUpdate = () => {\n if (this.onTimeUpdateCallback) {\n this.onTimeUpdateCallback(this.audioElement.currentTime);\n }\n };\n\n /\n Schedule fade automation on the fade GainNode.\n * Called at the start of each play() — fades are relative to the playback offset.\n /\n private _scheduleFades(offset: number): void {\n if (!this._fadeGain \|\| !this._audioContext) return;\n\n const fadeGain = this._fadeGain.gain;\n const now = this._audioContext.currentTime;\n const totalDuration = this.duration;\n\n // Reset fade gain\n fadeGain.cancelScheduledValues(0);\n fadeGain.setValueAtTime(1, now);\n\n // Fade in\n if (this._fadeIn && this._fadeIn.duration > 0) {\n const fadeInEnd = this._fadeIn.duration;\n if (offset < fadeInEnd) {\n const remainingFade = fadeInEnd - offset;\n const fadeType = this._fadeIn.type ?? 'linear';\n if (offset === 0) {\n // Full fade from beginning\n applyFadeIn(fadeGain, now, remainingFade, fadeType, 0, 1);\n } else {\n // Partial fade — slice the original curve to preserve shape\n const curve = generateCurve(fadeType, 1000, true);\n const startIndex = Math.round((offset / this._fadeIn.duration) (curve.length - 1));\n const sliced = curve.slice(startIndex);\n fadeGain.setValueAtTime(sliced[0], now);\n fadeGain.setValueCurveAtTime(sliced, now, remainingFade);\n }\n }\n }\n\n // Fade out\n if (this._fadeOut && this._fadeOut.duration > 0) {\n const fadeOutStart = totalDuration - this._fadeOut.duration;\n if (offset < totalDuration && fadeOutStart < totalDuration) {\n if (offset > fadeOutStart) {\n // Already past the fade-out start — slice original curve to preserve shape\n const elapsed = offset - fadeOutStart;\n const fadeType = this._fadeOut.type ?? 'linear';\n const curve = generateCurve(fadeType, 1000, false);\n const startIndex = Math.round((elapsed / this._fadeOut.duration) * (curve.length - 1));\n const sliced = curve.slice(startIndex);\n const remainingDuration = this._fadeOut.duration - elapsed;\n fadeGain.setValueAtTime(sliced[0], now);\n fadeGain.setValueCurveAtTime(sliced, now, remainingDuration);\n } else {\n // Schedule full fade-out at the right time\n const delayUntilFadeOut = fadeOutStart - offset;\n applyFadeOut(\n fadeGain,\n now + delayUntilFadeOut,\n this._fadeOut.duration,\n this._fadeOut.type ?? 'linear',\n 1,\n 0\n );\n }\n }\n }\n }\n\n /*\n Cancel any scheduled fade automation.\n /\n private _cancelFades(): void {\n if (this._fadeGain) {\n this._fadeGain.gain.cancelScheduledValues(0);\n this._fadeGain.gain.value = 1;\n }\n }\n\n /\n Start playback from a specific time.\n * Resumes the AudioContext first if suspended, then schedules fades\n * (fades depend on audioContext.currentTime being non-zero).\n /\n play(offset: number = 0): void {\n const startPlayback = () => {\n this._scheduleFades(offset);\n this.audioElement.currentTime = offset;\n this.audioElement.play().catch((err) => {\n console.warn('[waveform-playlist] MediaElementTrack: play() failed: ' + String(err));\n });\n };\n\n // Resume AudioContext if suspended (browser autoplay policy).\n // Must await resume before scheduling fades — audioContext.currentTime\n // is 0 while suspended, which would schedule all fades in the past.\n if (this._audioContext && this._audioContext.state === 'suspended') {\n this._audioContext\n .resume()\n .then(startPlayback)\n .catch((err) => {\n console.warn(\n '[waveform-playlist] MediaElementTrack: AudioContext.resume() failed: ' + String(err)\n );\n });\n } else {\n startPlayback();\n }\n }\n\n /\n Pause playback\n /\n pause(): void {\n this._cancelFades();\n this.audioElement.pause();\n }\n\n /\n Stop playback and reset to beginning\n /\n stop(): void {\n this._cancelFades();\n this.audioElement.pause();\n this.audioElement.currentTime = 0;\n }\n\n /\n Seek to a specific time\n /\n seekTo(time: number): void {\n this.audioElement.currentTime = Math.max(0, Math.min(time, this.duration));\n }\n\n /\n Set volume (0.0 to 1.0)\n /\n setVolume(volume: number): void {\n this._volume = Math.max(0, Math.min(1, volume));\n if (this._volumeGain) {\n this._volumeGain.gain.value = this._volume;\n } else {\n this.audioElement.volume = this._volume;\n }\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved)\n /\n setPlaybackRate(rate: number): void {\n const clampedRate = Math.max(0.5, Math.min(2.0, rate));\n this._playbackRate = clampedRate;\n this.audioElement.playbackRate = clampedRate;\n }\n\n /\n Set muted state\n /\n setMuted(muted: boolean): void {\n this.audioElement.muted = muted;\n }\n\n /\n Set fade in configuration\n /\n setFadeIn(fadeIn: FadeConfig \| undefined): void {\n this._fadeIn = fadeIn;\n }\n\n /\n Set fade out configuration\n /\n setFadeOut(fadeOut: FadeConfig \| undefined): void {\n this._fadeOut = fadeOut;\n }\n\n /\n Set callback for when playback ends\n /\n setOnStopCallback(callback: () => void): void {\n this.onStopCallback = callback;\n }\n\n /\n Set callback for time updates\n /\n setOnTimeUpdateCallback(callback: (time: number) => void): void {\n this.onTimeUpdateCallback = callback;\n }\n\n /\n Connect the output to a different destination (for effects chains).\n * Disconnects from the current destination first.\n \n @param destination - The AudioNode to connect to\n /\n connectOutput(destination: AudioNode): void {\n if (!this._volumeGain) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: connectOutput() requires audioContext. ' +\n 'Pass audioContext in constructor options.'\n );\n return;\n }\n try {\n this._volumeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: disconnect before connectOutput failed: ' +\n String(err)\n );\n }\n this._volumeGain.connect(destination);\n }\n\n /\n Disconnect the output and reconnect to the default AudioContext destination.\n /\n disconnectOutput(): void {\n if (!this._volumeGain \|\| !this._audioContext) return;\n try {\n this._volumeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: disconnect before disconnectOutput failed: ' +\n String(err)\n );\n }\n this._volumeGain.connect(this._audioContext.destination);\n }\n\n /\n Clean up resources\n /\n dispose(): void {\n this.audioElement.removeEventListener('ended', this.handleEnded);\n this.audioElement.removeEventListener('timeupdate', this.handleTimeUpdate);\n this._cancelFades();\n this.audioElement.pause();\n\n if (this._sourceNode) {\n try {\n this._sourceNode.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: sourceNode disconnect failed: ' + String(err)\n );\n }\n }\n if (this._fadeGain) {\n try {\n this._fadeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: fadeGain disconnect failed: ' + String(err)\n );\n }\n }\n if (this._volumeGain) {\n try {\n this._volumeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: volumeGain disconnect failed: ' + String(err)\n );\n }\n }\n\n if (this.ownsElement) {\n this.audioElement.src = '';\n this.audioElement.load(); // Release resources\n }\n }\n\n // Getters\n get id(): string {\n return this._id;\n }\n\n get name(): string {\n return this._name;\n }\n\n get peaks(): WaveformDataObject {\n return this._peaks;\n }\n\n get currentTime(): number {\n return this.audioElement.currentTime;\n }\n\n get duration(): number {\n return this.audioElement.duration \|\| this._peaks.duration;\n }\n\n get isPlaying(): boolean {\n return !this.audioElement.paused && !this.audioElement.ended;\n }\n\n get volume(): number {\n return this._volume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get muted(): boolean {\n return this.audioElement.muted;\n }\n\n /\n Get the underlying audio element (for advanced use cases)\n /\n get element(): HTMLAudioElement {\n return this.audioElement;\n }\n\n /\n Get the volume GainNode output (for connecting effects chains).\n * Returns null if no AudioContext was provided.\n /\n get outputNode(): GainNode \| null {\n return this._volumeGain;\n }\n}\n","import { MediaElementTrack, type MediaElementTrackOptions } from './MediaElementTrack';\n\nexport interface MediaElementPlayoutOptions {\n /* Initial master volume (0.0 to 1.0) /\n masterVolume?: number;\n /* Initial playback rate (0.5 to 2.0) /\n playbackRate?: number;\n}\n\n/\n Single-track playout engine using HTMLAudioElement.\n \n This is a lightweight alternative to TonePlayout for single-track use cases\n * that need pitch-preserving playback rate control.\n \n Key features:\n * - Pitch-preserving playback rate (0.5x - 2.0x)\n * - Uses pre-computed peaks (no AudioBuffer required)\n * - Simpler API for single-track playback\n \n Limitations:\n * - Single track only - will warn if multiple tracks added\n * - No multi-track mixing\n \n For multi-track editing, use TonePlayout from @waveform-playlist/playout instead.\n /\nexport class MediaElementPlayout {\n private track: MediaElementTrack \| null = null;\n private _masterVolume: number;\n private _playbackRate: number;\n private _isPlaying: boolean = false;\n private onPlaybackCompleteCallback?: () => void;\n\n constructor(options: MediaElementPlayoutOptions = {}) {\n this._masterVolume = options.masterVolume ?? 1;\n this._playbackRate = options.playbackRate ?? 1;\n }\n\n /\n Initialize the playout engine.\n * For MediaElementPlayout this is a no-op — HTMLAudioElement doesn't require\n * explicit initialization. When an AudioContext is provided for fades/effects,\n * it resumes automatically on first play via MediaElementTrack.\n /\n async init(): Promise<void> {\n // No initialization needed — audio element handles autoplay policy automatically\n }\n\n /\n Add a track to the playout.\n * Note: Only one track is supported. Adding a second track will dispose the first.\n /\n addTrack(options: MediaElementTrackOptions): MediaElementTrack {\n if (this.track) {\n console.warn(\n 'MediaElementPlayout: Only one track is supported. ' +\n 'Disposing previous track. For multi-track, use TonePlayout.'\n );\n this.track.dispose();\n }\n\n this.track = new MediaElementTrack({\n ...options,\n volume: this._masterVolume (options.volume ?? 1),\n playbackRate: this._playbackRate,\n });\n\n // Set up stop callback\n this.track.setOnStopCallback(() => {\n this._isPlaying = false;\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n });\n\n return this.track;\n }\n\n /*\n Remove a track by ID.\n /\n removeTrack(trackId: string): void {\n if (this.track && this.track.id === trackId) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n /\n Get a track by ID.\n /\n getTrack(trackId: string): MediaElementTrack \| undefined {\n if (this.track && this.track.id === trackId) {\n return this.track;\n }\n return undefined;\n }\n\n /\n Start playback.\n * @param _when - Ignored (HTMLAudioElement doesn't support scheduled start)\n * @param offset - Start position in seconds\n * @param duration - Duration to play in seconds (optional)\n /\n play(_when?: number, offset?: number, duration?: number): void {\n if (!this.track) {\n console.warn('MediaElementPlayout: No track to play');\n return;\n }\n\n const startPosition = offset ?? 0;\n this._isPlaying = true;\n\n this.track.play(startPosition);\n\n // If duration is specified, schedule stop\n if (duration !== undefined) {\n const adjustedDuration = duration / this._playbackRate;\n setTimeout(() => {\n if (this._isPlaying) {\n this.pause();\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n }\n }, adjustedDuration 1000);\n }\n }\n\n /*\n Pause playback.\n /\n pause(): void {\n if (this.track) {\n this.track.pause();\n }\n this._isPlaying = false;\n }\n\n /\n Stop playback and reset to start.\n /\n stop(): void {\n if (this.track) {\n this.track.stop();\n }\n this._isPlaying = false;\n }\n\n /\n Seek to a specific time.\n /\n seekTo(time: number): void {\n if (this.track) {\n this.track.seekTo(time);\n }\n }\n\n /\n Get current playback time.\n /\n getCurrentTime(): number {\n if (this.track) {\n return this.track.currentTime;\n }\n return 0;\n }\n\n /\n Set master volume.\n /\n setMasterVolume(volume: number): void {\n this._masterVolume = Math.max(0, Math.min(1, volume));\n if (this.track) {\n this.track.setVolume(this._masterVolume);\n }\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved).\n /\n setPlaybackRate(rate: number): void {\n this._playbackRate = Math.max(0.5, Math.min(2.0, rate));\n if (this.track) {\n this.track.setPlaybackRate(this._playbackRate);\n }\n }\n\n /\n Set mute state for a track.\n /\n setMute(trackId: string, muted: boolean): void {\n const track = this.getTrack(trackId);\n if (track) {\n track.setMuted(muted);\n }\n }\n\n /\n Set solo state for a track.\n * Note: With single track, solo is effectively the same as unmute.\n /\n setSolo(_trackId: string, _soloed: boolean): void {\n // No-op for single track - solo doesn't make sense\n console.warn('MediaElementPlayout: Solo is not applicable for single-track playback');\n }\n\n /\n Set callback for when playback completes.\n /\n setOnPlaybackComplete(callback: () => void): void {\n this.onPlaybackCompleteCallback = callback;\n }\n\n /\n Clean up resources.\n /\n dispose(): void {\n if (this.track) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n // Getters\n get isPlaying(): boolean {\n return this._isPlaying;\n }\n\n get masterVolume(): number {\n return this._masterVolume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get duration(): number {\n return this.track?.duration ?? 0;\n }\n\n get sampleRate(): number {\n // HTMLAudioElement doesn't expose sample rate directly\n // Return a common default - peaks will have the actual sample rate\n return this.track?.peaks.sample_rate ?? 44100;\n }\n\n /\n Get the volume GainNode output for connecting external effects chains.\n * Returns null if no AudioContext was provided to the track.\n \n Usage: disconnect from default destination, connect to effect input,\n * then connect effect output to audioContext.destination.\n /\n get outputNode(): GainNode \| null {\n return this.track?.outputNode ?? null;\n }\n}\n","/\n Common interface for playout engines.\n \n Both TonePlayout and MediaElementPlayout implement this interface,\n * allowing the browser package to work with either engine.\n /\nexport interface PlayoutEngine {\n // Lifecycle\n init(): Promise<void>;\n dispose(): void;\n\n // Playback\n play(when?: number, offset?: number, duration?: number): void;\n pause(): void;\n stop(): void;\n seekTo(time: number): void;\n getCurrentTime(): number;\n\n // Volume\n setMasterVolume(volume: number): void;\n\n // Track controls (optional - not all engines support all features)\n setMute?(trackId: string, muted: boolean): void;\n setSolo?(trackId: string, soloed: boolean): void;\n\n // Callbacks\n setOnPlaybackComplete(callback: () => void): void;\n\n // State\n readonly isPlaying: boolean;\n readonly duration: number;\n readonly sampleRate: number;\n}\n\n/\n Extended interface for engines that support playback rate.\n /\nexport interface PlaybackRateEngine extends PlayoutEngine {\n setPlaybackRate(rate: number): void;\n readonly playbackRate: number;\n}\n\n/\n Type guard to check if an engine supports playback rate.\n */\nexport function supportsPlaybackRate(engine: PlayoutEngine): engine is PlaybackRateEngine {\n return (\n 'setPlaybackRate' in engine &&\n typeof (engine as Record<string, unknown>).setPlaybackRate === 'function'\n );\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs CHANGED Viewed

@@ -1,8 +1,15 @@
 // src/MediaElementTrack.ts
+import { applyFadeIn, applyFadeOut, generateCurve } from "@waveform-playlist/core";
 var MediaElementTrack = class {
   constructor(options) {
     this._playbackRate = 1;
+    // Web Audio nodes (only when audioContext is provided)
+    this._audioContext = null;
+    this._sourceNode = null;
+    this._fadeGain = null;
+    this._volumeGain = null;
     this.handleEnded = () => {
+      this._cancelFades();
       if (this.onStopCallback) {
         this.onStopCallback();
       }
@@ -16,6 +23,9 @@ var MediaElementTrack = class {
     this._id = options.id ?? `track-${Date.now()}`;
     this._name = options.name ?? "Track";
     this._playbackRate = options.playbackRate ?? 1;
+    this._volume = options.volume ?? 1;
+    this._fadeIn = options.fadeIn;
+    this._fadeOut = options.fadeOut;
     if (typeof options.source === "string") {
       this.audioElement = new Audio(options.source);
       this.ownsElement = true;
@@ -24,7 +34,6 @@ var MediaElementTrack = class {
       this.ownsElement = false;
     }
     this.audioElement.preload = "auto";
-    this.audioElement.volume = options.volume ?? 1;
     this.audioElement.playbackRate = this._playbackRate;
     const audio = this.audioElement;
     if ("preservesPitch" in this.audioElement) {
@@ -34,28 +43,125 @@ var MediaElementTrack = class {
     } else if ("webkitPreservesPitch" in this.audioElement) {
       audio.webkitPreservesPitch = true;
     }
+    if (options.audioContext) {
+      this._audioContext = options.audioContext;
+      try {
+        this._sourceNode = options.audioContext.createMediaElementSource(this.audioElement);
+      } catch (err) {
+        throw new Error(
+          "[waveform-playlist] MediaElementTrack: createMediaElementSource() failed. This can happen if the audio element is already connected to another AudioContext. Each audio element can only have one MediaElementSourceNode. Original error: " + String(err)
+        );
+      }
+      this._fadeGain = options.audioContext.createGain();
+      this._volumeGain = options.audioContext.createGain();
+      this._volumeGain.gain.value = this._volume;
+      this._sourceNode.connect(this._fadeGain);
+      this._fadeGain.connect(this._volumeGain);
+      this._volumeGain.connect(options.audioContext.destination);
+      this.audioElement.volume = 1;
+    } else {
+      this.audioElement.volume = this._volume;
+    }
     this.audioElement.addEventListener("ended", this.handleEnded);
     this.audioElement.addEventListener("timeupdate", this.handleTimeUpdate);
   }
   /**
-   * Start playback from a specific time
+   * Schedule fade automation on the fade GainNode.
+   * Called at the start of each play() — fades are relative to the playback offset.
+   */
+  _scheduleFades(offset) {
+    if (!this._fadeGain || !this._audioContext) return;
+    const fadeGain = this._fadeGain.gain;
+    const now = this._audioContext.currentTime;
+    const totalDuration = this.duration;
+    fadeGain.cancelScheduledValues(0);
+    fadeGain.setValueAtTime(1, now);
+    if (this._fadeIn && this._fadeIn.duration > 0) {
+      const fadeInEnd = this._fadeIn.duration;
+      if (offset < fadeInEnd) {
+        const remainingFade = fadeInEnd - offset;
+        const fadeType = this._fadeIn.type ?? "linear";
+        if (offset === 0) {
+          applyFadeIn(fadeGain, now, remainingFade, fadeType, 0, 1);
+        } else {
+          const curve = generateCurve(fadeType, 1e3, true);
+          const startIndex = Math.round(offset / this._fadeIn.duration * (curve.length - 1));
+          const sliced = curve.slice(startIndex);
+          fadeGain.setValueAtTime(sliced[0], now);
+          fadeGain.setValueCurveAtTime(sliced, now, remainingFade);
+        }
+      }
+    }
+    if (this._fadeOut && this._fadeOut.duration > 0) {
+      const fadeOutStart = totalDuration - this._fadeOut.duration;
+      if (offset < totalDuration && fadeOutStart < totalDuration) {
+        if (offset > fadeOutStart) {
+          const elapsed = offset - fadeOutStart;
+          const fadeType = this._fadeOut.type ?? "linear";
+          const curve = generateCurve(fadeType, 1e3, false);
+          const startIndex = Math.round(elapsed / this._fadeOut.duration * (curve.length - 1));
+          const sliced = curve.slice(startIndex);
+          const remainingDuration = this._fadeOut.duration - elapsed;
+          fadeGain.setValueAtTime(sliced[0], now);
+          fadeGain.setValueCurveAtTime(sliced, now, remainingDuration);
+        } else {
+          const delayUntilFadeOut = fadeOutStart - offset;
+          applyFadeOut(
+            fadeGain,
+            now + delayUntilFadeOut,
+            this._fadeOut.duration,
+            this._fadeOut.type ?? "linear",
+            1,
+            0
+          );
+        }
+      }
+    }
+  }
+  /**
+   * Cancel any scheduled fade automation.
+   */
+  _cancelFades() {
+    if (this._fadeGain) {
+      this._fadeGain.gain.cancelScheduledValues(0);
+      this._fadeGain.gain.value = 1;
+    }
+  }
+  /**
+   * Start playback from a specific time.
+   * Resumes the AudioContext first if suspended, then schedules fades
+   * (fades depend on audioContext.currentTime being non-zero).
    */
   play(offset = 0) {
-    this.audioElement.currentTime = offset;
-    this.audioElement.play().catch((err) => {
-      console.warn("MediaElementTrack: play() failed:", err);
-    });
+    const startPlayback = () => {
+      this._scheduleFades(offset);
+      this.audioElement.currentTime = offset;
+      this.audioElement.play().catch((err) => {
+        console.warn("[waveform-playlist] MediaElementTrack: play() failed: " + String(err));
+      });
+    };
+    if (this._audioContext && this._audioContext.state === "suspended") {
+      this._audioContext.resume().then(startPlayback).catch((err) => {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: AudioContext.resume() failed: " + String(err)
+        );
+      });
+    } else {
+      startPlayback();
+    }
   }
   /**
    * Pause playback
    */
   pause() {
+    this._cancelFades();
     this.audioElement.pause();
   }
   /**
    * Stop playback and reset to beginning
    */
   stop() {
+    this._cancelFades();
     this.audioElement.pause();
     this.audioElement.currentTime = 0;
   }
@@ -69,7 +175,12 @@ var MediaElementTrack = class {
    * Set volume (0.0 to 1.0)
    */
   setVolume(volume) {
-    this.audioElement.volume = Math.max(0, Math.min(1, volume));
+    this._volume = Math.max(0, Math.min(1, volume));
+    if (this._volumeGain) {
+      this._volumeGain.gain.value = this._volume;
+    } else {
+      this.audioElement.volume = this._volume;
+    }
   }
   /**
    * Set playback rate (0.5 to 2.0, pitch preserved)
@@ -85,6 +196,18 @@ var MediaElementTrack = class {
   setMuted(muted) {
     this.audioElement.muted = muted;
   }
+  /**
+   * Set fade in configuration
+   */
+  setFadeIn(fadeIn) {
+    this._fadeIn = fadeIn;
+  }
+  /**
+   * Set fade out configuration
+   */
+  setFadeOut(fadeOut) {
+    this._fadeOut = fadeOut;
+  }
   /**
    * Set callback for when playback ends
    */
@@ -97,13 +220,77 @@ var MediaElementTrack = class {
   setOnTimeUpdateCallback(callback) {
     this.onTimeUpdateCallback = callback;
   }
+  /**
+   * Connect the output to a different destination (for effects chains).
+   * Disconnects from the current destination first.
+   *
+   * @param destination - The AudioNode to connect to
+   */
+  connectOutput(destination) {
+    if (!this._volumeGain) {
+      console.warn(
+        "[waveform-playlist] MediaElementTrack: connectOutput() requires audioContext. Pass audioContext in constructor options."
+      );
+      return;
+    }
+    try {
+      this._volumeGain.disconnect();
+    } catch (err) {
+      console.warn(
+        "[waveform-playlist] MediaElementTrack: disconnect before connectOutput failed: " + String(err)
+      );
+    }
+    this._volumeGain.connect(destination);
+  }
+  /**
+   * Disconnect the output and reconnect to the default AudioContext destination.
+   */
+  disconnectOutput() {
+    if (!this._volumeGain || !this._audioContext) return;
+    try {
+      this._volumeGain.disconnect();
+    } catch (err) {
+      console.warn(
+        "[waveform-playlist] MediaElementTrack: disconnect before disconnectOutput failed: " + String(err)
+      );
+    }
+    this._volumeGain.connect(this._audioContext.destination);
+  }
   /**
    * Clean up resources
    */
   dispose() {
     this.audioElement.removeEventListener("ended", this.handleEnded);
     this.audioElement.removeEventListener("timeupdate", this.handleTimeUpdate);
+    this._cancelFades();
     this.audioElement.pause();
+    if (this._sourceNode) {
+      try {
+        this._sourceNode.disconnect();
+      } catch (err) {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: sourceNode disconnect failed: " + String(err)
+        );
+      }
+    }
+    if (this._fadeGain) {
+      try {
+        this._fadeGain.disconnect();
+      } catch (err) {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: fadeGain disconnect failed: " + String(err)
+        );
+      }
+    }
+    if (this._volumeGain) {
+      try {
+        this._volumeGain.disconnect();
+      } catch (err) {
+        console.warn(
+          "[waveform-playlist] MediaElementTrack: volumeGain disconnect failed: " + String(err)
+        );
+      }
+    }
     if (this.ownsElement) {
       this.audioElement.src = "";
       this.audioElement.load();
@@ -129,7 +316,7 @@ var MediaElementTrack = class {
     return !this.audioElement.paused && !this.audioElement.ended;
   }
   get volume() {
-    return this.audioElement.volume;
+    return this._volume;
   }
   get playbackRate() {
     return this._playbackRate;
@@ -143,6 +330,13 @@ var MediaElementTrack = class {
   get element() {
     return this.audioElement;
   }
+  /**
+   * Get the volume GainNode output (for connecting effects chains).
+   * Returns null if no AudioContext was provided.
+   */
+  get outputNode() {
+    return this._volumeGain;
+  }
 };
 // src/MediaElementPlayout.ts
@@ -155,7 +349,9 @@ var MediaElementPlayout = class {
   }
   /**
    * Initialize the playout engine.
-   * For MediaElementPlayout this is a no-op (no AudioContext to start).
+   * For MediaElementPlayout this is a no-op — HTMLAudioElement doesn't require
+   * explicit initialization. When an AudioContext is provided for fades/effects,
+   * it resumes automatically on first play via MediaElementTrack.
    */
   async init() {
   }
@@ -327,6 +523,16 @@ var MediaElementPlayout = class {
   get sampleRate() {
     return this.track?.peaks.sample_rate ?? 44100;
   }
+  /**
+   * Get the volume GainNode output for connecting external effects chains.
+   * Returns null if no AudioContext was provided to the track.
+   *
+   * Usage: disconnect from default destination, connect to effect input,
+   * then connect effect output to audioContext.destination.
+   */
+  get outputNode() {
+    return this.track?.outputNode ?? null;
+  }
 };
 // src/types.ts

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/MediaElementTrack.ts","../src/MediaElementPlayout.ts","../src/types.ts"],"sourcesContent":["import type { WaveformDataObject } from '@waveform-playlist/core';\n\n/*\n Extended HTMLAudioElement with vendor-prefixed preservesPitch properties.\n * `preservesPitch` is standard; the `moz` and `webkit` prefixes are for older browsers.\n /\ninterface VendorPrefixedPitch {\n preservesPitch?: boolean;\n mozPreservesPitch?: boolean;\n webkitPreservesPitch?: boolean;\n}\n\nexport interface MediaElementTrackOptions {\n /* The audio source - can be a URL, Blob URL, or HTMLAudioElement /\n source: string \| HTMLAudioElement;\n /* Pre-computed waveform data for visualization (required - no AudioBuffer decoding) /\n peaks: WaveformDataObject;\n /* Track ID /\n id?: string;\n /* Track name for display /\n name?: string;\n /* Initial volume (0.0 to 1.0) /\n volume?: number;\n /* Initial playback rate (0.5 to 2.0, pitch preserved) /\n playbackRate?: number;\n}\n\n/\n Single-track playback using HTMLAudioElement.\n \n Benefits over AudioBuffer/Tone.js:\n * - Pitch-preserving playback rate (0.5x - 2.0x) via browser's built-in algorithm\n * - No AudioBuffer decoding required (uses pre-computed peaks for visualization)\n * - Simpler, lighter-weight for single-track use cases\n \n Limitations:\n * - Single track only (no multi-track mixing)\n * - No clip-level effects or fades (track-level volume only)\n * - Relies on browser's time-stretching quality\n /\nexport class MediaElementTrack {\n private audioElement: HTMLAudioElement;\n private ownsElement: boolean; // Whether we created the element (need to clean up)\n private _peaks: WaveformDataObject;\n private _id: string;\n private _name: string;\n private _playbackRate: number = 1;\n private onStopCallback?: () => void;\n private onTimeUpdateCallback?: (time: number) => void;\n\n constructor(options: MediaElementTrackOptions) {\n this._peaks = options.peaks;\n this._id = options.id ?? `track-${Date.now()}`;\n this._name = options.name ?? 'Track';\n this._playbackRate = options.playbackRate ?? 1;\n\n // Create or use provided audio element\n if (typeof options.source === 'string') {\n this.audioElement = new Audio(options.source);\n this.ownsElement = true;\n } else {\n this.audioElement = options.source;\n this.ownsElement = false;\n }\n\n // Configure audio element\n this.audioElement.preload = 'auto';\n this.audioElement.volume = options.volume ?? 1;\n this.audioElement.playbackRate = this._playbackRate;\n\n // Preserve pitch when changing playback rate (default in modern browsers)\n // Some older browsers may not support this, but it's the default behavior\n // Vendor-prefixed properties are non-standard; cast once for type safety.\n const audio = this.audioElement as unknown as VendorPrefixedPitch;\n if ('preservesPitch' in this.audioElement) {\n audio.preservesPitch = true;\n } else if ('mozPreservesPitch' in this.audioElement) {\n // Firefox prefix\n audio.mozPreservesPitch = true;\n } else if ('webkitPreservesPitch' in this.audioElement) {\n // Safari prefix\n audio.webkitPreservesPitch = true;\n }\n\n // Set up event listeners\n this.audioElement.addEventListener('ended', this.handleEnded);\n this.audioElement.addEventListener('timeupdate', this.handleTimeUpdate);\n }\n\n private handleEnded = () => {\n if (this.onStopCallback) {\n this.onStopCallback();\n }\n };\n\n private handleTimeUpdate = () => {\n if (this.onTimeUpdateCallback) {\n this.onTimeUpdateCallback(this.audioElement.currentTime);\n }\n };\n\n /\n Start playback from a specific time\n /\n play(offset: number = 0): void {\n this.audioElement.currentTime = offset;\n this.audioElement.play().catch((err) => {\n console.warn('MediaElementTrack: play() failed:', err);\n });\n }\n\n /\n Pause playback\n /\n pause(): void {\n this.audioElement.pause();\n }\n\n /\n Stop playback and reset to beginning\n /\n stop(): void {\n this.audioElement.pause();\n this.audioElement.currentTime = 0;\n }\n\n /\n Seek to a specific time\n /\n seekTo(time: number): void {\n this.audioElement.currentTime = Math.max(0, Math.min(time, this.duration));\n }\n\n /\n Set volume (0.0 to 1.0)\n /\n setVolume(volume: number): void {\n this.audioElement.volume = Math.max(0, Math.min(1, volume));\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved)\n /\n setPlaybackRate(rate: number): void {\n // Clamp to reasonable range for pitch preservation quality\n const clampedRate = Math.max(0.5, Math.min(2.0, rate));\n this._playbackRate = clampedRate;\n this.audioElement.playbackRate = clampedRate;\n }\n\n /\n Set muted state\n /\n setMuted(muted: boolean): void {\n this.audioElement.muted = muted;\n }\n\n /\n Set callback for when playback ends\n /\n setOnStopCallback(callback: () => void): void {\n this.onStopCallback = callback;\n }\n\n /\n Set callback for time updates\n /\n setOnTimeUpdateCallback(callback: (time: number) => void): void {\n this.onTimeUpdateCallback = callback;\n }\n\n /\n Clean up resources\n /\n dispose(): void {\n this.audioElement.removeEventListener('ended', this.handleEnded);\n this.audioElement.removeEventListener('timeupdate', this.handleTimeUpdate);\n this.audioElement.pause();\n\n if (this.ownsElement) {\n this.audioElement.src = '';\n this.audioElement.load(); // Release resources\n }\n }\n\n // Getters\n get id(): string {\n return this._id;\n }\n\n get name(): string {\n return this._name;\n }\n\n get peaks(): WaveformDataObject {\n return this._peaks;\n }\n\n get currentTime(): number {\n return this.audioElement.currentTime;\n }\n\n get duration(): number {\n return this.audioElement.duration \|\| this._peaks.duration;\n }\n\n get isPlaying(): boolean {\n return !this.audioElement.paused && !this.audioElement.ended;\n }\n\n get volume(): number {\n return this.audioElement.volume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get muted(): boolean {\n return this.audioElement.muted;\n }\n\n /\n Get the underlying audio element (for advanced use cases)\n /\n get element(): HTMLAudioElement {\n return this.audioElement;\n }\n}\n","import { MediaElementTrack, type MediaElementTrackOptions } from './MediaElementTrack';\n\nexport interface MediaElementPlayoutOptions {\n /* Initial master volume (0.0 to 1.0) /\n masterVolume?: number;\n /* Initial playback rate (0.5 to 2.0) /\n playbackRate?: number;\n}\n\n/\n Single-track playout engine using HTMLAudioElement.\n \n This is a lightweight alternative to TonePlayout for single-track use cases\n * that need pitch-preserving playback rate control.\n \n Key features:\n * - Pitch-preserving playback rate (0.5x - 2.0x)\n * - Uses pre-computed peaks (no AudioBuffer required)\n * - Simpler API for single-track playback\n \n Limitations:\n * - Single track only - will warn if multiple tracks added\n * - No clip-level effects or crossfades\n * - No multi-track mixing\n \n For multi-track editing, use TonePlayout from @waveform-playlist/playout instead.\n /\nexport class MediaElementPlayout {\n private track: MediaElementTrack \| null = null;\n private _masterVolume: number;\n private _playbackRate: number;\n private _isPlaying: boolean = false;\n private onPlaybackCompleteCallback?: () => void;\n\n constructor(options: MediaElementPlayoutOptions = {}) {\n this._masterVolume = options.masterVolume ?? 1;\n this._playbackRate = options.playbackRate ?? 1;\n }\n\n /\n Initialize the playout engine.\n * For MediaElementPlayout this is a no-op (no AudioContext to start).\n /\n async init(): Promise<void> {\n // No initialization needed for HTMLAudioElement\n // AudioContext requires user gesture, but audio element just works\n }\n\n /\n Add a track to the playout.\n * Note: Only one track is supported. Adding a second track will dispose the first.\n /\n addTrack(options: MediaElementTrackOptions): MediaElementTrack {\n if (this.track) {\n console.warn(\n 'MediaElementPlayout: Only one track is supported. ' +\n 'Disposing previous track. For multi-track, use TonePlayout.'\n );\n this.track.dispose();\n }\n\n this.track = new MediaElementTrack({\n ...options,\n volume: this._masterVolume (options.volume ?? 1),\n playbackRate: this._playbackRate,\n });\n\n // Set up stop callback\n this.track.setOnStopCallback(() => {\n this._isPlaying = false;\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n });\n\n return this.track;\n }\n\n /*\n Remove a track by ID.\n /\n removeTrack(trackId: string): void {\n if (this.track && this.track.id === trackId) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n /\n Get a track by ID.\n /\n getTrack(trackId: string): MediaElementTrack \| undefined {\n if (this.track && this.track.id === trackId) {\n return this.track;\n }\n return undefined;\n }\n\n /\n Start playback.\n * @param _when - Ignored (HTMLAudioElement doesn't support scheduled start)\n * @param offset - Start position in seconds\n * @param duration - Duration to play in seconds (optional)\n /\n play(_when?: number, offset?: number, duration?: number): void {\n if (!this.track) {\n console.warn('MediaElementPlayout: No track to play');\n return;\n }\n\n const startPosition = offset ?? 0;\n this._isPlaying = true;\n\n this.track.play(startPosition);\n\n // If duration is specified, schedule stop\n if (duration !== undefined) {\n const adjustedDuration = duration / this._playbackRate;\n setTimeout(() => {\n if (this._isPlaying) {\n this.pause();\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n }\n }, adjustedDuration 1000);\n }\n }\n\n /*\n Pause playback.\n /\n pause(): void {\n if (this.track) {\n this.track.pause();\n }\n this._isPlaying = false;\n }\n\n /\n Stop playback and reset to start.\n /\n stop(): void {\n if (this.track) {\n this.track.stop();\n }\n this._isPlaying = false;\n }\n\n /\n Seek to a specific time.\n /\n seekTo(time: number): void {\n if (this.track) {\n this.track.seekTo(time);\n }\n }\n\n /\n Get current playback time.\n /\n getCurrentTime(): number {\n if (this.track) {\n return this.track.currentTime;\n }\n return 0;\n }\n\n /\n Set master volume.\n /\n setMasterVolume(volume: number): void {\n this._masterVolume = Math.max(0, Math.min(1, volume));\n if (this.track) {\n this.track.setVolume(this._masterVolume);\n }\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved).\n /\n setPlaybackRate(rate: number): void {\n this._playbackRate = Math.max(0.5, Math.min(2.0, rate));\n if (this.track) {\n this.track.setPlaybackRate(this._playbackRate);\n }\n }\n\n /\n Set mute state for a track.\n /\n setMute(trackId: string, muted: boolean): void {\n const track = this.getTrack(trackId);\n if (track) {\n track.setMuted(muted);\n }\n }\n\n /\n Set solo state for a track.\n * Note: With single track, solo is effectively the same as unmute.\n /\n setSolo(_trackId: string, _soloed: boolean): void {\n // No-op for single track - solo doesn't make sense\n console.warn('MediaElementPlayout: Solo is not applicable for single-track playback');\n }\n\n /\n Set callback for when playback completes.\n /\n setOnPlaybackComplete(callback: () => void): void {\n this.onPlaybackCompleteCallback = callback;\n }\n\n /\n Clean up resources.\n /\n dispose(): void {\n if (this.track) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n // Getters\n get isPlaying(): boolean {\n return this._isPlaying;\n }\n\n get masterVolume(): number {\n return this._masterVolume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get duration(): number {\n return this.track?.duration ?? 0;\n }\n\n get sampleRate(): number {\n // HTMLAudioElement doesn't expose sample rate directly\n // Return a common default - peaks will have the actual sample rate\n return this.track?.peaks.sample_rate ?? 44100;\n }\n}\n","/\n Common interface for playout engines.\n \n Both TonePlayout and MediaElementPlayout implement this interface,\n * allowing the browser package to work with either engine.\n /\nexport interface PlayoutEngine {\n // Lifecycle\n init(): Promise<void>;\n dispose(): void;\n\n // Playback\n play(when?: number, offset?: number, duration?: number): void;\n pause(): void;\n stop(): void;\n seekTo(time: number): void;\n getCurrentTime(): number;\n\n // Volume\n setMasterVolume(volume: number): void;\n\n // Track controls (optional - not all engines support all features)\n setMute?(trackId: string, muted: boolean): void;\n setSolo?(trackId: string, soloed: boolean): void;\n\n // Callbacks\n setOnPlaybackComplete(callback: () => void): void;\n\n // State\n readonly isPlaying: boolean;\n readonly duration: number;\n readonly sampleRate: number;\n}\n\n/\n Extended interface for engines that support playback rate.\n /\nexport interface PlaybackRateEngine extends PlayoutEngine {\n setPlaybackRate(rate: number): void;\n readonly playbackRate: number;\n}\n\n/\n Type guard to check if an engine supports playback rate.\n */\nexport function supportsPlaybackRate(engine: PlayoutEngine): engine is PlaybackRateEngine {\n return (\n 'setPlaybackRate' in engine &&\n typeof (engine as Record<string, unknown>).setPlaybackRate === 'function'\n );\n}\n"],"mappings":"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","names":[]}
1	+ {"version":3,"sources":["../src/MediaElementTrack.ts","../src/MediaElementPlayout.ts","../src/types.ts"],"sourcesContent":["import type { WaveformDataObject, FadeConfig } from '@waveform-playlist/core';\nimport { applyFadeIn, applyFadeOut, generateCurve } from '@waveform-playlist/core';\n\nexport type { FadeConfig } from '@waveform-playlist/core';\n\n/*\n Extended HTMLAudioElement with vendor-prefixed preservesPitch properties.\n * `preservesPitch` is standard; the `moz` and `webkit` prefixes are for older browsers.\n /\ninterface VendorPrefixedPitch {\n preservesPitch?: boolean;\n mozPreservesPitch?: boolean;\n webkitPreservesPitch?: boolean;\n}\n\nexport interface MediaElementTrackOptions {\n /* The audio source - can be a URL, Blob URL, or HTMLAudioElement /\n source: string \| HTMLAudioElement;\n /* Pre-computed waveform data for visualization (required - no AudioBuffer decoding) /\n peaks: WaveformDataObject;\n /* Track ID /\n id?: string;\n /* Track name for display /\n name?: string;\n /* Initial volume (0.0 to 1.0) /\n volume?: number;\n /* Initial playback rate (0.5 to 2.0, pitch preserved) /\n playbackRate?: number;\n /\n AudioContext for Web Audio routing.\n * When provided, audio is routed through Web Audio nodes for fades and effects:\n * HTMLAudioElement → MediaElementSourceNode → fadeGain → volumeGain → destination\n \n Without this, playback uses HTMLAudioElement directly (no fades or effects).\n \n Note: createMediaElementSource() can only be called once per element.\n * Once routed, HTMLAudioElement.volume no longer works — volume is controlled\n * via the Web Audio GainNode instead.\n /\n audioContext?: AudioContext;\n /* Fade in configuration (requires audioContext) /\n fadeIn?: FadeConfig;\n /* Fade out configuration (requires audioContext) /\n fadeOut?: FadeConfig;\n}\n\n/\n Single-track playback using HTMLAudioElement.\n \n Benefits over AudioBuffer/Tone.js:\n * - Pitch-preserving playback rate (0.5x - 2.0x) via browser's built-in algorithm\n * - No AudioBuffer decoding required (uses pre-computed peaks for visualization)\n * - Simpler, lighter-weight for single-track use cases\n \n When an AudioContext is provided:\n * - Audio routes through Web Audio graph for fades and effects\n * - Volume controlled via GainNode (HTMLAudioElement.volume is bypassed)\n * - Output node exposed for connecting external effects chains\n /\nexport class MediaElementTrack {\n private audioElement: HTMLAudioElement;\n private ownsElement: boolean; // Whether we created the element (need to clean up)\n private _peaks: WaveformDataObject;\n private _id: string;\n private _name: string;\n private _playbackRate: number = 1;\n private _volume: number;\n private onStopCallback?: () => void;\n private onTimeUpdateCallback?: (time: number) => void;\n\n // Web Audio nodes (only when audioContext is provided)\n private _audioContext: AudioContext \| null = null;\n private _sourceNode: MediaElementAudioSourceNode \| null = null;\n private _fadeGain: GainNode \| null = null;\n private _volumeGain: GainNode \| null = null;\n private _fadeIn: FadeConfig \| undefined;\n private _fadeOut: FadeConfig \| undefined;\n\n constructor(options: MediaElementTrackOptions) {\n this._peaks = options.peaks;\n this._id = options.id ?? `track-${Date.now()}`;\n this._name = options.name ?? 'Track';\n this._playbackRate = options.playbackRate ?? 1;\n this._volume = options.volume ?? 1;\n this._fadeIn = options.fadeIn;\n this._fadeOut = options.fadeOut;\n\n // Create or use provided audio element\n if (typeof options.source === 'string') {\n this.audioElement = new Audio(options.source);\n this.ownsElement = true;\n } else {\n this.audioElement = options.source;\n this.ownsElement = false;\n }\n\n // Configure audio element\n this.audioElement.preload = 'auto';\n this.audioElement.playbackRate = this._playbackRate;\n\n // Preserve pitch when changing playback rate (default in modern browsers)\n // Vendor-prefixed properties are non-standard; cast once for type safety.\n const audio = this.audioElement as unknown as VendorPrefixedPitch;\n if ('preservesPitch' in this.audioElement) {\n audio.preservesPitch = true;\n } else if ('mozPreservesPitch' in this.audioElement) {\n audio.mozPreservesPitch = true;\n } else if ('webkitPreservesPitch' in this.audioElement) {\n audio.webkitPreservesPitch = true;\n }\n\n // Set up Web Audio routing if AudioContext provided\n if (options.audioContext) {\n this._audioContext = options.audioContext;\n try {\n this._sourceNode = options.audioContext.createMediaElementSource(this.audioElement);\n } catch (err) {\n throw new Error(\n '[waveform-playlist] MediaElementTrack: createMediaElementSource() failed. ' +\n 'This can happen if the audio element is already connected to another AudioContext. ' +\n 'Each audio element can only have one MediaElementSourceNode. ' +\n 'Original error: ' +\n String(err)\n );\n }\n this._fadeGain = options.audioContext.createGain();\n this._volumeGain = options.audioContext.createGain();\n this._volumeGain.gain.value = this._volume;\n\n this._sourceNode.connect(this._fadeGain);\n this._fadeGain.connect(this._volumeGain);\n this._volumeGain.connect(options.audioContext.destination);\n\n // With Web Audio routing, HTMLAudioElement.volume is bypassed.\n // Set it to 1 so it doesn't attenuate the signal before the source node.\n this.audioElement.volume = 1;\n } else {\n // Without Web Audio, use HTMLAudioElement.volume directly\n this.audioElement.volume = this._volume;\n }\n\n // Set up event listeners\n this.audioElement.addEventListener('ended', this.handleEnded);\n this.audioElement.addEventListener('timeupdate', this.handleTimeUpdate);\n }\n\n private handleEnded = () => {\n this._cancelFades();\n if (this.onStopCallback) {\n this.onStopCallback();\n }\n };\n\n private handleTimeUpdate = () => {\n if (this.onTimeUpdateCallback) {\n this.onTimeUpdateCallback(this.audioElement.currentTime);\n }\n };\n\n /\n Schedule fade automation on the fade GainNode.\n * Called at the start of each play() — fades are relative to the playback offset.\n /\n private _scheduleFades(offset: number): void {\n if (!this._fadeGain \|\| !this._audioContext) return;\n\n const fadeGain = this._fadeGain.gain;\n const now = this._audioContext.currentTime;\n const totalDuration = this.duration;\n\n // Reset fade gain\n fadeGain.cancelScheduledValues(0);\n fadeGain.setValueAtTime(1, now);\n\n // Fade in\n if (this._fadeIn && this._fadeIn.duration > 0) {\n const fadeInEnd = this._fadeIn.duration;\n if (offset < fadeInEnd) {\n const remainingFade = fadeInEnd - offset;\n const fadeType = this._fadeIn.type ?? 'linear';\n if (offset === 0) {\n // Full fade from beginning\n applyFadeIn(fadeGain, now, remainingFade, fadeType, 0, 1);\n } else {\n // Partial fade — slice the original curve to preserve shape\n const curve = generateCurve(fadeType, 1000, true);\n const startIndex = Math.round((offset / this._fadeIn.duration) (curve.length - 1));\n const sliced = curve.slice(startIndex);\n fadeGain.setValueAtTime(sliced[0], now);\n fadeGain.setValueCurveAtTime(sliced, now, remainingFade);\n }\n }\n }\n\n // Fade out\n if (this._fadeOut && this._fadeOut.duration > 0) {\n const fadeOutStart = totalDuration - this._fadeOut.duration;\n if (offset < totalDuration && fadeOutStart < totalDuration) {\n if (offset > fadeOutStart) {\n // Already past the fade-out start — slice original curve to preserve shape\n const elapsed = offset - fadeOutStart;\n const fadeType = this._fadeOut.type ?? 'linear';\n const curve = generateCurve(fadeType, 1000, false);\n const startIndex = Math.round((elapsed / this._fadeOut.duration) * (curve.length - 1));\n const sliced = curve.slice(startIndex);\n const remainingDuration = this._fadeOut.duration - elapsed;\n fadeGain.setValueAtTime(sliced[0], now);\n fadeGain.setValueCurveAtTime(sliced, now, remainingDuration);\n } else {\n // Schedule full fade-out at the right time\n const delayUntilFadeOut = fadeOutStart - offset;\n applyFadeOut(\n fadeGain,\n now + delayUntilFadeOut,\n this._fadeOut.duration,\n this._fadeOut.type ?? 'linear',\n 1,\n 0\n );\n }\n }\n }\n }\n\n /*\n Cancel any scheduled fade automation.\n /\n private _cancelFades(): void {\n if (this._fadeGain) {\n this._fadeGain.gain.cancelScheduledValues(0);\n this._fadeGain.gain.value = 1;\n }\n }\n\n /\n Start playback from a specific time.\n * Resumes the AudioContext first if suspended, then schedules fades\n * (fades depend on audioContext.currentTime being non-zero).\n /\n play(offset: number = 0): void {\n const startPlayback = () => {\n this._scheduleFades(offset);\n this.audioElement.currentTime = offset;\n this.audioElement.play().catch((err) => {\n console.warn('[waveform-playlist] MediaElementTrack: play() failed: ' + String(err));\n });\n };\n\n // Resume AudioContext if suspended (browser autoplay policy).\n // Must await resume before scheduling fades — audioContext.currentTime\n // is 0 while suspended, which would schedule all fades in the past.\n if (this._audioContext && this._audioContext.state === 'suspended') {\n this._audioContext\n .resume()\n .then(startPlayback)\n .catch((err) => {\n console.warn(\n '[waveform-playlist] MediaElementTrack: AudioContext.resume() failed: ' + String(err)\n );\n });\n } else {\n startPlayback();\n }\n }\n\n /\n Pause playback\n /\n pause(): void {\n this._cancelFades();\n this.audioElement.pause();\n }\n\n /\n Stop playback and reset to beginning\n /\n stop(): void {\n this._cancelFades();\n this.audioElement.pause();\n this.audioElement.currentTime = 0;\n }\n\n /\n Seek to a specific time\n /\n seekTo(time: number): void {\n this.audioElement.currentTime = Math.max(0, Math.min(time, this.duration));\n }\n\n /\n Set volume (0.0 to 1.0)\n /\n setVolume(volume: number): void {\n this._volume = Math.max(0, Math.min(1, volume));\n if (this._volumeGain) {\n this._volumeGain.gain.value = this._volume;\n } else {\n this.audioElement.volume = this._volume;\n }\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved)\n /\n setPlaybackRate(rate: number): void {\n const clampedRate = Math.max(0.5, Math.min(2.0, rate));\n this._playbackRate = clampedRate;\n this.audioElement.playbackRate = clampedRate;\n }\n\n /\n Set muted state\n /\n setMuted(muted: boolean): void {\n this.audioElement.muted = muted;\n }\n\n /\n Set fade in configuration\n /\n setFadeIn(fadeIn: FadeConfig \| undefined): void {\n this._fadeIn = fadeIn;\n }\n\n /\n Set fade out configuration\n /\n setFadeOut(fadeOut: FadeConfig \| undefined): void {\n this._fadeOut = fadeOut;\n }\n\n /\n Set callback for when playback ends\n /\n setOnStopCallback(callback: () => void): void {\n this.onStopCallback = callback;\n }\n\n /\n Set callback for time updates\n /\n setOnTimeUpdateCallback(callback: (time: number) => void): void {\n this.onTimeUpdateCallback = callback;\n }\n\n /\n Connect the output to a different destination (for effects chains).\n * Disconnects from the current destination first.\n \n @param destination - The AudioNode to connect to\n /\n connectOutput(destination: AudioNode): void {\n if (!this._volumeGain) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: connectOutput() requires audioContext. ' +\n 'Pass audioContext in constructor options.'\n );\n return;\n }\n try {\n this._volumeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: disconnect before connectOutput failed: ' +\n String(err)\n );\n }\n this._volumeGain.connect(destination);\n }\n\n /\n Disconnect the output and reconnect to the default AudioContext destination.\n /\n disconnectOutput(): void {\n if (!this._volumeGain \|\| !this._audioContext) return;\n try {\n this._volumeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: disconnect before disconnectOutput failed: ' +\n String(err)\n );\n }\n this._volumeGain.connect(this._audioContext.destination);\n }\n\n /\n Clean up resources\n /\n dispose(): void {\n this.audioElement.removeEventListener('ended', this.handleEnded);\n this.audioElement.removeEventListener('timeupdate', this.handleTimeUpdate);\n this._cancelFades();\n this.audioElement.pause();\n\n if (this._sourceNode) {\n try {\n this._sourceNode.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: sourceNode disconnect failed: ' + String(err)\n );\n }\n }\n if (this._fadeGain) {\n try {\n this._fadeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: fadeGain disconnect failed: ' + String(err)\n );\n }\n }\n if (this._volumeGain) {\n try {\n this._volumeGain.disconnect();\n } catch (err) {\n console.warn(\n '[waveform-playlist] MediaElementTrack: volumeGain disconnect failed: ' + String(err)\n );\n }\n }\n\n if (this.ownsElement) {\n this.audioElement.src = '';\n this.audioElement.load(); // Release resources\n }\n }\n\n // Getters\n get id(): string {\n return this._id;\n }\n\n get name(): string {\n return this._name;\n }\n\n get peaks(): WaveformDataObject {\n return this._peaks;\n }\n\n get currentTime(): number {\n return this.audioElement.currentTime;\n }\n\n get duration(): number {\n return this.audioElement.duration \|\| this._peaks.duration;\n }\n\n get isPlaying(): boolean {\n return !this.audioElement.paused && !this.audioElement.ended;\n }\n\n get volume(): number {\n return this._volume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get muted(): boolean {\n return this.audioElement.muted;\n }\n\n /\n Get the underlying audio element (for advanced use cases)\n /\n get element(): HTMLAudioElement {\n return this.audioElement;\n }\n\n /\n Get the volume GainNode output (for connecting effects chains).\n * Returns null if no AudioContext was provided.\n /\n get outputNode(): GainNode \| null {\n return this._volumeGain;\n }\n}\n","import { MediaElementTrack, type MediaElementTrackOptions } from './MediaElementTrack';\n\nexport interface MediaElementPlayoutOptions {\n /* Initial master volume (0.0 to 1.0) /\n masterVolume?: number;\n /* Initial playback rate (0.5 to 2.0) /\n playbackRate?: number;\n}\n\n/\n Single-track playout engine using HTMLAudioElement.\n \n This is a lightweight alternative to TonePlayout for single-track use cases\n * that need pitch-preserving playback rate control.\n \n Key features:\n * - Pitch-preserving playback rate (0.5x - 2.0x)\n * - Uses pre-computed peaks (no AudioBuffer required)\n * - Simpler API for single-track playback\n \n Limitations:\n * - Single track only - will warn if multiple tracks added\n * - No multi-track mixing\n \n For multi-track editing, use TonePlayout from @waveform-playlist/playout instead.\n /\nexport class MediaElementPlayout {\n private track: MediaElementTrack \| null = null;\n private _masterVolume: number;\n private _playbackRate: number;\n private _isPlaying: boolean = false;\n private onPlaybackCompleteCallback?: () => void;\n\n constructor(options: MediaElementPlayoutOptions = {}) {\n this._masterVolume = options.masterVolume ?? 1;\n this._playbackRate = options.playbackRate ?? 1;\n }\n\n /\n Initialize the playout engine.\n * For MediaElementPlayout this is a no-op — HTMLAudioElement doesn't require\n * explicit initialization. When an AudioContext is provided for fades/effects,\n * it resumes automatically on first play via MediaElementTrack.\n /\n async init(): Promise<void> {\n // No initialization needed — audio element handles autoplay policy automatically\n }\n\n /\n Add a track to the playout.\n * Note: Only one track is supported. Adding a second track will dispose the first.\n /\n addTrack(options: MediaElementTrackOptions): MediaElementTrack {\n if (this.track) {\n console.warn(\n 'MediaElementPlayout: Only one track is supported. ' +\n 'Disposing previous track. For multi-track, use TonePlayout.'\n );\n this.track.dispose();\n }\n\n this.track = new MediaElementTrack({\n ...options,\n volume: this._masterVolume (options.volume ?? 1),\n playbackRate: this._playbackRate,\n });\n\n // Set up stop callback\n this.track.setOnStopCallback(() => {\n this._isPlaying = false;\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n });\n\n return this.track;\n }\n\n /*\n Remove a track by ID.\n /\n removeTrack(trackId: string): void {\n if (this.track && this.track.id === trackId) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n /\n Get a track by ID.\n /\n getTrack(trackId: string): MediaElementTrack \| undefined {\n if (this.track && this.track.id === trackId) {\n return this.track;\n }\n return undefined;\n }\n\n /\n Start playback.\n * @param _when - Ignored (HTMLAudioElement doesn't support scheduled start)\n * @param offset - Start position in seconds\n * @param duration - Duration to play in seconds (optional)\n /\n play(_when?: number, offset?: number, duration?: number): void {\n if (!this.track) {\n console.warn('MediaElementPlayout: No track to play');\n return;\n }\n\n const startPosition = offset ?? 0;\n this._isPlaying = true;\n\n this.track.play(startPosition);\n\n // If duration is specified, schedule stop\n if (duration !== undefined) {\n const adjustedDuration = duration / this._playbackRate;\n setTimeout(() => {\n if (this._isPlaying) {\n this.pause();\n if (this.onPlaybackCompleteCallback) {\n this.onPlaybackCompleteCallback();\n }\n }\n }, adjustedDuration 1000);\n }\n }\n\n /*\n Pause playback.\n /\n pause(): void {\n if (this.track) {\n this.track.pause();\n }\n this._isPlaying = false;\n }\n\n /\n Stop playback and reset to start.\n /\n stop(): void {\n if (this.track) {\n this.track.stop();\n }\n this._isPlaying = false;\n }\n\n /\n Seek to a specific time.\n /\n seekTo(time: number): void {\n if (this.track) {\n this.track.seekTo(time);\n }\n }\n\n /\n Get current playback time.\n /\n getCurrentTime(): number {\n if (this.track) {\n return this.track.currentTime;\n }\n return 0;\n }\n\n /\n Set master volume.\n /\n setMasterVolume(volume: number): void {\n this._masterVolume = Math.max(0, Math.min(1, volume));\n if (this.track) {\n this.track.setVolume(this._masterVolume);\n }\n }\n\n /\n Set playback rate (0.5 to 2.0, pitch preserved).\n /\n setPlaybackRate(rate: number): void {\n this._playbackRate = Math.max(0.5, Math.min(2.0, rate));\n if (this.track) {\n this.track.setPlaybackRate(this._playbackRate);\n }\n }\n\n /\n Set mute state for a track.\n /\n setMute(trackId: string, muted: boolean): void {\n const track = this.getTrack(trackId);\n if (track) {\n track.setMuted(muted);\n }\n }\n\n /\n Set solo state for a track.\n * Note: With single track, solo is effectively the same as unmute.\n /\n setSolo(_trackId: string, _soloed: boolean): void {\n // No-op for single track - solo doesn't make sense\n console.warn('MediaElementPlayout: Solo is not applicable for single-track playback');\n }\n\n /\n Set callback for when playback completes.\n /\n setOnPlaybackComplete(callback: () => void): void {\n this.onPlaybackCompleteCallback = callback;\n }\n\n /\n Clean up resources.\n /\n dispose(): void {\n if (this.track) {\n this.track.dispose();\n this.track = null;\n }\n }\n\n // Getters\n get isPlaying(): boolean {\n return this._isPlaying;\n }\n\n get masterVolume(): number {\n return this._masterVolume;\n }\n\n get playbackRate(): number {\n return this._playbackRate;\n }\n\n get duration(): number {\n return this.track?.duration ?? 0;\n }\n\n get sampleRate(): number {\n // HTMLAudioElement doesn't expose sample rate directly\n // Return a common default - peaks will have the actual sample rate\n return this.track?.peaks.sample_rate ?? 44100;\n }\n\n /\n Get the volume GainNode output for connecting external effects chains.\n * Returns null if no AudioContext was provided to the track.\n \n Usage: disconnect from default destination, connect to effect input,\n * then connect effect output to audioContext.destination.\n /\n get outputNode(): GainNode \| null {\n return this.track?.outputNode ?? null;\n }\n}\n","/\n Common interface for playout engines.\n \n Both TonePlayout and MediaElementPlayout implement this interface,\n * allowing the browser package to work with either engine.\n /\nexport interface PlayoutEngine {\n // Lifecycle\n init(): Promise<void>;\n dispose(): void;\n\n // Playback\n play(when?: number, offset?: number, duration?: number): void;\n pause(): void;\n stop(): void;\n seekTo(time: number): void;\n getCurrentTime(): number;\n\n // Volume\n setMasterVolume(volume: number): void;\n\n // Track controls (optional - not all engines support all features)\n setMute?(trackId: string, muted: boolean): void;\n setSolo?(trackId: string, soloed: boolean): void;\n\n // Callbacks\n setOnPlaybackComplete(callback: () => void): void;\n\n // State\n readonly isPlaying: boolean;\n readonly duration: number;\n readonly sampleRate: number;\n}\n\n/\n Extended interface for engines that support playback rate.\n /\nexport interface PlaybackRateEngine extends PlayoutEngine {\n setPlaybackRate(rate: number): void;\n readonly playbackRate: number;\n}\n\n/\n Type guard to check if an engine supports playback rate.\n */\nexport function supportsPlaybackRate(engine: PlayoutEngine): engine is PlaybackRateEngine {\n return (\n 'setPlaybackRate' in engine &&\n typeof (engine as Record<string, unknown>).setPlaybackRate === 'function'\n );\n}\n"],"mappings":"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","names":[]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@waveform-playlist/media-element-playout",
-  "version": "10.0.0",
+  "version": "10.1.0",
   "description": "HTMLMediaElement-based playout engine for waveform-playlist with pitch-preserving playback rate",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -13,11 +13,6 @@
     }
   },
   "sideEffects": false,
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit"
-  },
   "keywords": [
     "waveform",
     "audio",
@@ -46,6 +41,11 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@waveform-playlist/core": "workspace:*"
+    "@waveform-playlist/core": "10.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
   }
-}
+}