spessasynth_lib 4.2.0 → 4.2.1

package/README.md

@@ -45,7 +45,6 @@ It allows you to:
 - **[Detailed documentation:](https://spessasus.github.io/spessasynth_lib/)** _With [examples!](https://spessasus.github.io/spessasynth_lib/getting-started/#examples)_
 - **Easy to Use:** _Basic setup is just [two lines of code!](https://spessasus.github.io/spessasynth_lib/getting-started/#minimal-setup)_
 - **No external dependencies:** _Just spessasynth_core!_
-- **Reverb and chorus support:** [customizable](https://spessasus.github.io/spessasynth_lib/synthesizer/#effects-configuration-object) and can be used standalone!
 - **Export audio files** using [OfflineAudioContext](https://developer.mozilla.org/en-US/docs/Web/API/OfflineAudioContext)!
 - **AudioWorklet synthesizer:**
     - Runs in a **separate thread** for maximum performance!

package/dist/index.d.ts

@@ -169,7 +169,16 @@ interface SequencerMessageData {
     getMIDI: null;
     setSkipToFirstNote: boolean;
 }
-type SequencerReturnMessage = (SequencerEvent & {
+type SequencerReturnMessage = (Exclude<SequencerEvent, {
+    type: "songListChange";
+}> & {
+    id: number;
+}) | (Extract<SequencerEvent, {
+    type: "songListChange";
+}> & {
+    data: {
+        shuffledSongIndexes: number[];
+    };
     id: number;
 }) | {
     type: "getMIDI";
@@ -975,10 +984,6 @@ declare class SeqEventHandler {
 }
 
 declare class Sequencer {
-    /**
-     * The current MIDI data, with the exclusion of the embedded sound bank and event data.
-     */
-    midiData?: MIDIData;
     /**
      * The current MIDI data for all songs, like the midiData property.
      */
@@ -995,6 +1000,10 @@ declare class Sequencer {
      * The synthesizer attached to this sequencer.
      */
     readonly synth: BasicSynthesizer;
+    /**
+     * The current MIDI data, with the exclusion of the embedded sound bank and event data.
+     */
+    midiData?: MIDIData;
     /**
      * The MIDI port to play to.
      */
@@ -1021,13 +1030,21 @@ declare class Sequencer {
      * @param options the sequencer's options.
      */
     constructor(synth: BasicSynthesizer, options?: Partial<SequencerOptions>);
+    private _shuffledSongIndexes;
+    /**
+     * The shuffled song indexes.
+     * This is used when shuffleMode is enabled.
+     */
+    get shuffledSongIndexes(): number[];
     private _songIndex;
     /**
      * The current song number in the playlist.
+     * If shuffle Mode is enabled, this is the index of the shuffled song list.
      */
     get songIndex(): number;
     /**
      * The current song number in the playlist.
+     * If shuffle Mode is enabled, this is the index of the shuffled song list.
      */
     set songIndex(value: number);
     private _currentTempo;
@@ -1076,11 +1093,17 @@ declare class Sequencer {
     set playbackRate(value: number);
     private _shuffleSongs;
     /**
-     * Indicates if the song order is random.
+     * Controls if the sequencer should shuffle the songs in the song list.
+     * If true, the sequencer will play the songs in a random order.
+     *
+     * Songs are shuffled on a `loadNewSongList` call.
      */
     get shuffleSongs(): boolean;
     /**
-     * Indicates if the song order is random.
+     * Controls if the sequencer should shuffle the songs in the song list.
+     * If true, the sequencer will play the songs in a random order.
+     *
+     * Songs are shuffled on a `loadNewSongList` call.
      */
     set shuffleSongs(value: boolean);
     /**

package/dist/index.js

@@ -1682,7 +1682,10 @@ var BasicSynthesizerCore = class {
           type: "sequencerReturn",
           data: {
             type: e.type,
-            data: { newSongList: midiDatas },
+            data: {
+              newSongList: midiDatas,
+              shuffledSongIndexes: sequencer.shuffledSongIndexes
+            },
             id: sequencerID
           },
           currentTime: this.synthesizer.currentSynthTime
@@ -1722,7 +1725,7 @@ var BasicSynthesizerCore = class {
   destroy() {
     this.synthesizer.destroySynthProcessor();
     delete this.synthesizer;
-    delete this.sequencer;
+    delete this.sequencers;
   }
   handleMessage(m) {
     const channel = m.channelNumber;
@@ -2361,10 +2364,6 @@ var SeqEventHandler = class {
 
 // src/sequencer/sequencer.ts
 var Sequencer = class {
-  /**
-   * The current MIDI data, with the exclusion of the embedded sound bank and event data.
-   */
-  midiData;
   /**
    * The current MIDI data for all songs, like the midiData property.
    */
@@ -2381,6 +2380,10 @@ var Sequencer = class {
    * The synthesizer attached to this sequencer.
    */
   synth;
+  /**
+   * The current MIDI data, with the exclusion of the embedded sound bank and event data.
+   */
+  midiData;
   /**
    * The MIDI port to play to.
    */
@@ -2424,15 +2427,25 @@ var Sequencer = class {
       this.resetMIDIOutput.bind(this)
     );
   }
+  _shuffledSongIndexes = [];
+  /**
+   * The shuffled song indexes.
+   * This is used when shuffleMode is enabled.
+   */
+  get shuffledSongIndexes() {
+    return this._shuffledSongIndexes;
+  }
   _songIndex = 0;
   /**
    * The current song number in the playlist.
+   * If shuffle Mode is enabled, this is the index of the shuffled song list.
    */
   get songIndex() {
     return this._songIndex;
   }
   /**
    * The current song number in the playlist.
+   * If shuffle Mode is enabled, this is the index of the shuffled song list.
    */
   set songIndex(value) {
     const clamped = Math.max(0, value % this._songsAmount);
@@ -2517,13 +2530,19 @@ var Sequencer = class {
   }
   _shuffleSongs = false;
   /**
-   * Indicates if the song order is random.
+   * Controls if the sequencer should shuffle the songs in the song list.
+   * If true, the sequencer will play the songs in a random order.
+   *
+   * Songs are shuffled on a `loadNewSongList` call.
    */
   get shuffleSongs() {
     return this._shuffleSongs;
   }
   /**
-   * Indicates if the song order is random.
+   * Controls if the sequencer should shuffle the songs in the song list.
+   * If true, the sequencer will play the songs in a random order.
+   *
+   * Songs are shuffled on a `loadNewSongList` call.
    */
   set shuffleSongs(value) {
     this._shuffleSongs = value;
@@ -2641,7 +2660,8 @@ var Sequencer = class {
       }
       case "songChange": {
         this._songIndex = m.data.songIndex;
-        const songChangeData = this.songListData[this._songIndex];
+        const idx = this._shuffleSongs ? this._shuffledSongIndexes[this._songIndex] : this._songIndex;
+        const songChangeData = this.songListData[idx];
         this.midiData = songChangeData;
         this.isLoading = false;
         this.absoluteStartTime = 0;
@@ -2738,7 +2758,7 @@ var Sequencer = class {
         this.songListData = m.data.newSongList.map(
           (m2) => new MIDIData(m2)
         );
-        this.midiData = this.songListData[this._songIndex];
+        this._shuffledSongIndexes = m.data.shuffledSongIndexes;
         break;
       }
       default: {