spessasynth_lib 3.25.23 → 3.26.1

package/README.md

@@ -2,15 +2,20 @@
 
 **A powerful SF2/DLS/MIDI JavaScript library for the browsers.**
 
+*This is a WebAudioAPI wrapper for the [spessasynth_core](https://github.com/spessasus/spessasynth_core) library.*
+
+> **TIP:**
+> Looking for a bare JS version that works without WebAudioAPI? Try [spessasynth_core](https://github.com/spessasus/spessasynth_core)!
+
 ```shell
 npm install --save spessasynth_lib
 ```
 
 ### [Project site (consider giving it a star!)](https://github.com/spessasus/SpessaSynth)
 
-### [Demo](https://spessasus.github.io/SpessaSynth)
+### [Demo](https://spessasus.github.io/spessasynth_lib)
 
-### [Complete documentation](https://github.com/spessasus/SpessaSynth/wiki/Usage-As-Library)
+### [Complete documentation](https://github.com/spessasus/spessasynth_lib/wiki/)
 
 #### Basic example: play a single note
 
@@ -32,126 +37,36 @@ document.getElementById("button").onclick = async () =>
 
 ## Current Features
 
-### Numerous Format Support
-Supported formats list:
-- `.mid` - Standard MIDI File
-- `.kar` - Soft Karaoke MIDI File
-- `.sf2` - SoundFont2 File
-- `.sf3` - SoundFont2 Compressed File
-- `.sfogg` - SF2Pack With Vorbis Compression
-- `.dls` - Downloadable Sounds Levels 1 & 2 (as well as Mobile DLS)
-- `.rmi` - RIFF MIDI File
-- `.rmi` - RIFF MIDI File With Embedded DLS
-- `.rmi` - [RIFF MIDI File With Embedded SF2](https://github.com/spessasus/sf2-rmidi-specification)
-- `.xmf` - eXtensible Music Format
-- `.mxmf` - Mobile eXtensible Music format
-
-*With [an easy way of converting between them!](https://github.com/spessasus/SpessaSynth/wiki/Converting-Between-Formats)*
-
-### Easy Integration
+### [All the features of spessasynth_core!](https://github.com/spessasus/spessasynth_core?#current-features)
+
+### On top of that...
 - **Modular design:** *Easy integration into other projects (load what you need)*
-- **[Detailed documentation:](https://github.com/spessasus/SpessaSynth/wiki/Home)** *With [examples!](https://github.com/spessasus/SpessaSynth/wiki/Usage-As-Library#examples)*
-- **Flexible:** *It's not just a MIDI player!*
-- **Easy to Use:** *Basic setup is just [two lines of code!](https://github.com/spessasus/SpessaSynth/wiki/Usage-As-Library#minimal-setup)*
-- **No dependencies:** *Batteries included!*
-
-### Powerful MIDI Synthesizer
-- Suitable for both **real-time** and **offline** synthesis
-- **Excellent SoundFont support:**
-  - **Full Generator Support**
-  - **Full Modulator Support:** *First (to my knowledge) JavaScript SoundFont synth with that feature!*
-  - **GeneralUserGS Compatible:** *[See more here!](https://github.com/mrbumpy409/GeneralUser-GS/blob/main/documentation/README.md)*
-  - **SoundFont3 Support:** Play compressed SoundFonts!
-  - **Experimental SF2Pack Support:** Play soundfonts compressed with BASSMIDI! (*Note: only works with vorbis compression*)
-  - **Can load very large SoundFonts:** up to 4GB! *Note: Only Firefox handles this well; Chromium has a hard-coded memory limit*
-- **Great DLS Support:**
-  - **DLS Level 1 Support**
-  - **DLS Level 2 Support**
-  - **Mobile DLS Support**
-  - **Correct articulator support:** *Converts articulators to both modulators and generators!*
-  - **Tested and working with gm.dls!**
-  - **Correct volume:** *Properly translated to SoundFont volume!*
-  - **A-Law encoding support**
-  - **Both unsigned 8-bit and signed 16-bit sample support (24-bit theoretically supported as well!)**
-  - **Detects special articulator combinations:** *Such as vibratoLfoToPitch*
-- **Soundfont manager:** Stack multiple soundfonts!
-- **Reverb and chorus support:** [customizable!](https://github.com/spessasus/SpessaSynth/wiki/Synthetizer-Class#effects-configuration-object)
+- **[Detailed documentation:](https://github.com/spessasus/spessasynth_lib/wiki/Home)** *With [examples!](https://github.com/spessasus/spessasynth_lib/wiki/Usage-As-Library#examples)*
+- **Easy to Use:** *Basic setup is just [two lines of code!](https://github.com/spessasus/spessasynth_lib/wiki/Usage-As-Library#minimal-setup)*
+- **No external dependencies:** *Just spessasynth_core!*
+- **Reverb and chorus support:** [customizable!](https://github.com/spessasus/spessasynth_lib/wiki/Synthetizer-Class#effects-configuration-object)
 - **Export audio files** using [OfflineAudioContext](https://developer.mozilla.org/en-US/docs/Web/API/OfflineAudioContext)
-- **[Custom modulators for additional controllers](https://github.com/spessasus/SpessaSynth/wiki/Modulator-Class#default-modulators):** *Why not?*
 - **Written using AudioWorklets:** 
   - Runs in a **separate thread** for maximum performance
   - Doesn't stop playing even when the main thread is frozen
   - Supported by all modern browsers
-- **Unlimited channel count:** Your CPU is the limit!
-- **Excellent MIDI Standards Support:**
-  - **MIDI Controller Support:** Default supported controllers [here](https://github.com/spessasus/SpessaSynth/wiki/MIDI-Implementation#supported-controllers)
-  - **Portamento Support:** Glide the notes!
-  - **Sound Controllers:** Real-time filter and envelope control!
-  - **MIDI Tuning Standard Support:** [more info here](https://github.com/spessasus/SpessaSynth/wiki/MIDI-Implementation#midi-tuning-standard)
-  - [Full **RPN** and limited **NRPN** support](https://github.com/spessasus/SpessaSynth/wiki/MIDI-Implementation#supported-registered-parameters)
-  - Supports some [**Roland GS** and **Yamaha XG** system exclusives](https://github.com/spessasus/SpessaSynth/wiki/MIDI-Implementation#supported-system-exclusives)
 - **High-performance mode:** Play Rush E! *note: may kill your browser ;)*
 
-### Powerful and Fast MIDI Sequencer
-- **Supports MIDI formats 0, 1, and 2:** *note: format 2 support is experimental as it's very, very rare.*
-- **[Multi-Port MIDI](https://github.com/spessasus/SpessaSynth/wiki/About-Multi-Port) support:** More than 16 channels!
-- **Smart preloading:** Only preloads the samples used in the MIDI file for smooth playback *(down to key and velocity!)*
-- **Lyrics support:** Add karaoke to your program!
-- **Raw lyrics available:** Decode in any encoding! *(Kanji? No problem!)*
-- **Runs in Audio Thread as well:** Never blocks the main thread
-- **Loop points support:** Ensures seamless loops
-
-### Read and Write SoundFont and MIDI Files with Ease
-#### Read and write MIDI files
-  - **Smart name detection:** Handles incorrectly formatted and non-standard track names
-  - **Raw name available:** Decode in any encoding! *(Kanji? No problem!)*
-  - **Port detection during load time:** Manage ports and channels easily!
-  - **Used channels on track:** Quickly determine which channels are used
-  - **Key range detection:** Detect the key range of the MIDI
-  - **Easy MIDI editing:** Use [helper functions](https://github.com/spessasus/SpessaSynth/wiki/Writing-MIDI-Files#modifymidi) to modify the song to your needs!
-  - **Loop detection:** Automatically detects loops in MIDIs (e.g., from *Touhou Project*)
-  - **First note detection:** Skip unnecessary silence at the start by jumping to the first note!
-  - **Lyrics support:** Both regular MIDI and .kar files!
-  - **[Write MIDI files from scratch](https://github.com/spessasus/SpessaSynth/wiki/Creating-MIDI-Files)**
-  - **Easy saving:** Save with just [one function!](https://github.com/spessasus/SpessaSynth/wiki/Writing-MIDI-Files#writemidi)
-
-#### Read and write [RMID files with embedded SF2 soundfonts](https://github.com/spessasus/sf2-rmidi-specification#readme)
-  - **[Level 4](https://github.com/spessasus/sf2-rmidi-specification#level-4) compliance:** Reads and writes *everything!*
-  - **Compression and trimming support:** Reduce a MIDI file with a 1GB soundfont to **as small as 5MB**!
-  - **DLS Version support:** The original legacy format with bank offset detection!
-  - **Automatic bank shifting and validation:** Every soundfont *just works!*
-  - **Metadata support:** Add title, artist, album name and cover and more! And of course read them too! *(In any encoding!)*
-  - **Compatible with [Falcosoft Midi Player 6!](https://falcosoft.hu/softwares.html#midiplayer)**
-  - **Easy saving:** [As simple as saving a MIDI file!](https://github.com/spessasus/SpessaSynth/wiki/Writing-MIDI-Files#writermidi)
-
-#### Read and write SoundFont2 files
-  - **Easy info access:** Just an [object of strings!](https://github.com/spessasus/SpessaSynth/wiki/SoundFont2-Class#soundfontinfo)
-  - **Smart trimming:** Trim the SoundFont to only include samples used in the MIDI *(down to key and velocity!)*
-  - **sf3 conversion:** Compress SoundFont2 files to SoundFont3 with variable quality!
-  - **Easy saving:** Also just [one function!](https://github.com/spessasus/SpessaSynth/wiki/SoundFont2-Class#write)
-
-#### Read and write SoundFont3 files
-  - Same features as SoundFont2 but with now with **Ogg Vorbis compression!**
-  - **Variable compression quality:** You choose between file size and quality!
-  - **Compression preserving:** Avoid decompressing and recompressing uncompressed samples for minimal quality loss!
-
-#### Read and write DLS Level One or Two files
-  - Read DLS (DownLoadable Sounds) files as SF2 files!
-  - **Works like a normal soundfont:** *Saving it as sf2 is still [just one function!](https://github.com/spessasus/SpessaSynth/wiki/SoundFont2-Class#write)*
-  - Converts articulators to both **modulators** and **generators**!
-  - Works with both unsigned 8-bit samples and signed 16-bit samples!
-  - A-Law encoding support
-  - **Covers special generator cases:** *such as modLfoToPitch*!
-  - **Correct volume:** *looking at you, Viena and gm.sf2!*
-  - Support built right into the synthesizer!
-  - **Convert SF2 to DLS:** [with limitations](https://github.com/spessasus/SpessaSynth/wiki/DLS-Conversion-Problem)
-
-### Export MIDI as WAV
-  - Save the MIDI file as WAV audio!
-  - **Metadata support:** *Embed metadata such as title, artist, album and more!*
-  - **Cue points:** *Write MIDI loop points as cue points!*
-  - **Loop multiple times:** *Render two (or more) loops into the file for seamless transitions!*
-  - *That's right, saving as WAV is also [just one function!](https://github.com/spessasus/SpessaSynth/wiki/Writing-Wave-Files#audiobuffertowav)*
+#### TODO
+- Enhance the built-in chorus and reverb effects (suggestions welcome!)
+
+### Special Thanks
+- [FluidSynth](https://github.com/FluidSynth/fluidsynth) - for the source code that helped implement functionality and fixes
+- [Polyphone](https://www.polyphone-soundfonts.com/) - for the soundfont testing and editing tool
+- [Meltysynth](https://github.com/sinshu/meltysynth) - for the initial low-pass filter implementation
+- [RecordingBlogs](https://www.recordingblogs.com/) - for detailed explanations on MIDI messages
+- [stbvorbis.js](https://github.com/hajimehoshi/stbvorbis.js) - for the Vorbis decoder
+- [fflate](https://github.com/101arrowz/fflate) - for the MIT DEFLATE implementation
+- [foo_midi](https://github.com/stuerp/foo_midi) - for useful resources on XMF file format
+- [Falcosoft](https://falcosoft.hu) - for help with the RMIDI format
+- [Christian Collins](https://schristiancollins.com) - for various bug reports regarding the synthesizer
+- **And You!** - for checking out this project. I hope you like it :)
+
 
 # License
 Copyright © 2025 Spessasus

package/external_midi/midi_handler.js

@@ -1,6 +1,6 @@
-import { Synthetizer } from "../synthetizer/worklet_wrapper/synthetizer.js";
+import { Synthetizer } from "../synthetizer/synthetizer.js";
+import { SpessaSynthCoreUtils as util } from "spessasynth_core";
 import { consoleColors } from "../utils/other.js";
-import { SpessaSynthInfo, SpessaSynthWarn } from "../utils/loggin.js";
 
 /**
  * midi_handler.js
@@ -9,14 +9,14 @@ import { SpessaSynthInfo, SpessaSynthWarn } from "../utils/loggin.js";
 
 const NO_INPUT = null;
 
+// noinspection JSUnusedGlobalSymbols
+/**
+ * A class for handling MIDI devices
+ */
 export class MIDIDeviceHandler
 {
-    constructor()
-    {
-    }
-    
     /**
-     * @returns {Promise<boolean>} if succeded
+     * @returns {Promise<boolean>} if succeeded
      */
     async createMIDIDeviceHandler()
     {
@@ -36,12 +36,12 @@ export class MIDIDeviceHandler
                 const response = await navigator.requestMIDIAccess({ sysex: true, software: true });
                 this.inputs = response.inputs;
                 this.outputs = response.outputs;
-                SpessaSynthInfo("%cMIDI handler created!", consoleColors.recognized);
+                util.SpessaSynthInfo("%cMIDI handler created!", consoleColors.recognized);
                 return true;
             }
             catch (e)
             {
-                SpessaSynthWarn(`Could not get MIDI Devices:`, e);
+                util.SpessaSynthWarn(`Could not get MIDI Devices:`, e);
                 this.inputs = [];
                 this.outputs = [];
                 return false;
@@ -49,7 +49,7 @@ export class MIDIDeviceHandler
         }
         else
         {
-            SpessaSynthWarn("Web MIDI Api not supported!", consoleColors.unrecognized);
+            util.SpessaSynthWarn("Web MIDI Api not supported!", consoleColors.unrecognized);
             this.inputs = [];
             this.outputs = [];
             return false;
@@ -65,7 +65,7 @@ export class MIDIDeviceHandler
     {
         this.selectedOutput = output;
         seq.connectMidiOutput(output);
-        SpessaSynthInfo(
+        util.SpessaSynthInfo(
             `%cPlaying MIDI to %c${output.name}`,
             consoleColors.info,
             consoleColors.recognized
@@ -80,7 +80,7 @@ export class MIDIDeviceHandler
     {
         this.selectedOutput = NO_INPUT;
         seq.connectMidiOutput(undefined);
-        SpessaSynthInfo(
+        util.SpessaSynthInfo(
             "%cDisconnected from MIDI out.",
             consoleColors.info
         );
@@ -98,7 +98,7 @@ export class MIDIDeviceHandler
         {
             synth.sendMessage(event.data);
         };
-        SpessaSynthInfo(
+        util.SpessaSynthInfo(
             `%cListening for messages on %c${input.name}`,
             consoleColors.info,
             consoleColors.recognized
@@ -112,7 +112,7 @@ export class MIDIDeviceHandler
     {
         this.selectedInput = NO_INPUT;
         input.onmidimessage = undefined;
-        SpessaSynthInfo(
+        util.SpessaSynthInfo(
             `%cDisconnected from %c${input.name}`,
             consoleColors.info,
             consoleColors.recognized

package/external_midi/web_midi_link.js

@@ -1,6 +1,6 @@
-import { Synthetizer } from "../synthetizer/worklet_wrapper/synthetizer.js";
+import { Synthetizer } from "../synthetizer/synthetizer.js";
 import { consoleColors } from "../utils/other.js";
-import { SpessaSynthInfo } from "../utils/loggin.js";
+import { SpessaSynthCoreUtils } from "spessasynth_core";
 
 /**
  * web_midi_link.js
@@ -38,6 +38,6 @@ export class WebMIDILinkHandler
             synth.sendMessage(midiData);
         });
         
-        SpessaSynthInfo("%cWeb MIDI Link handler created!", consoleColors.recognized);
+        SpessaSynthCoreUtils.SpessaSynthInfo("%cWeb MIDI Link handler created!", consoleColors.recognized);
     }
 }

package/index.js

@@ -1,35 +1,38 @@
 // Import modules
-import { loadSoundFont } from "./soundfont/load_soundfont.js";
-import { BasicSoundBank } from "./soundfont/basic_soundfont/basic_soundfont.js";
-import { BasicSample } from "./soundfont/basic_soundfont/basic_sample.js";
-import { BasicInstrumentZone } from "./soundfont/basic_soundfont/basic_zones.js";
-import { BasicInstrument } from "./soundfont/basic_soundfont/basic_instrument.js";
-import { Generator } from "./soundfont/basic_soundfont/generator.js";
-import { Modulator } from "./soundfont/basic_soundfont/modulator.js";
-import { BasicPresetZone } from "./soundfont/basic_soundfont/basic_zones.js";
-import { BasicPreset } from "./soundfont/basic_soundfont/basic_preset.js";
-import { BasicMIDI } from "./midi/basic_midi.js";
-import { MIDIMessage } from "./midi/midi_message.js";
-import { MIDI } from "./midi/midi_loader.js";
-import { RMIDINFOChunks } from "./midi/midi_tools/rmidi_writer.js";
-import { MIDIBuilder } from "./midi/midi_builder.js";
-import { Synthetizer } from "./synthetizer/worklet_wrapper/synthetizer.js";
-import { VOICE_CAP, DEFAULT_PERCUSSION } from "./synthetizer/synth_constants.js";
-import { Sequencer } from "./sequencer/worklet_wrapper/sequencer.js";
-import { IndexedByteArray } from './utils/indexed_array.js';
-import { audioBufferToWav } from './utils/buffer_to_wav.js';
-import { SpessaSynthLogging } from './utils/loggin.js';
-import { midiControllers, messageTypes } from "./midi/midi_message.js";
-import { MIDIDeviceHandler} from "./external_midi/midi_handler.js";
-import { WebMIDILinkHandler} from "./external_midi/web_midi_link.js";
-import { modulatorSources } from "./soundfont/basic_soundfont/modulator.js";
+import {
+    ALL_CHANNELS_OR_DIFFERENT_ACTION,
+    BasicInstrument,
+    BasicInstrumentZone,
+    BasicMIDI,
+    BasicPreset,
+    BasicPresetZone,
+    BasicSample,
+    BasicSoundBank,
+    ChannelSnapshot,
+    DEFAULT_PERCUSSION,
+    Generator,
+    IndexedByteArray,
+    loadSoundFont,
+    messageTypes,
+    MIDI,
+    MIDIBuilder,
+    midiControllers,
+    MIDIMessage,
+    Modulator,
+    modulatorSources,
+    NON_CC_INDEX_OFFSET,
+    RMIDINFOChunks,
+    SpessaSynthLogging,
+    SynthesizerSnapshot,
+    VOICE_CAP
+} from "spessasynth_core";
+import { Synthetizer } from "./synthetizer/synthetizer.js";
+import { Sequencer } from "./sequencer/sequencer.js";
+import { audioBufferToWav } from "./utils/buffer_to_wav.js";
+import { MIDIDeviceHandler } from "./external_midi/midi_handler.js";
+import { WebMIDILinkHandler } from "./external_midi/web_midi_link.js";
 import { DEFAULT_SYNTH_CONFIG } from "./synthetizer/audio_effects/effects_config.js";
-import { WORKLET_URL_ABSOLUTE } from "./synthetizer/worklet_wrapper/worklet_url.js";
-import { SynthesizerSnapshot } from "./synthetizer/audio_engine/snapshot/synthesizer_snapshot.js";
-import { ChannelSnapshot } from "./synthetizer/audio_engine/snapshot/channel_snapshot.js";
-import { SpessaSynthProcessor } from "./synthetizer/audio_engine/main_processor.js";
-import { NON_CC_INDEX_OFFSET } from "./synthetizer/audio_engine/engine_components/controller_tables.js";
-import { ALL_CHANNELS_OR_DIFFERENT_ACTION } from "./synthetizer/audio_engine/message_protocol/worklet_message.js";
+import { WORKLET_URL_ABSOLUTE } from "./synthetizer/worklet_url.js";
 
 // Export modules
 export {
@@ -44,9 +47,6 @@ export {
     ALL_CHANNELS_OR_DIFFERENT_ACTION,
     NON_CC_INDEX_OFFSET,
     
-    // Audio Engine
-    SpessaSynthProcessor,
-    
     // SoundFont
     BasicSoundBank,
     BasicSample,

package/package.json

@@ -1,15 +1,16 @@
 {
   "name": "spessasynth_lib",
-  "version": "3.25.23",
-  "description": "MIDI and SoundFont2/DLS library with no compromises",
+  "version": "3.26.1",
+  "description": "MIDI and SoundFont2/DLS library for the browsers with no compromises",
   "browser": "index.js",
   "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "./minify_processor.sh"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/spessasus/SpessaSynth.git"
+    "url": "git+https://github.com/spessasus/spessasynth_lib.git"
   },
   "main": "index.js",
   "keywords": [
@@ -36,8 +37,20 @@
   },
   "license": "Apache-2.0",
   "bugs": {
-    "url": "https://github.com/spessasus/SpessaSynth/issues",
+    "url": "https://github.com/spessasus/spessasynth_lib/issues",
     "email": "spesekspesek@gmail.com"
   },
-  "homepage": "https://github.com/spessasus/SpessaSynth#readme"
+  "homepage": "https://github.com/spessasus/spessasynth_lib#readme",
+  "files": [
+    "index.js",
+    "LICENSE",
+    "README.md",
+    "sequencer",
+    "synthetizer",
+    "utils",
+    "external_midi"
+  ],
+  "dependencies": {
+    "spessasynth_core": "latest"
+  }
 }

package/{midi → sequencer}/midi_data.js

@@ -1,4 +1,4 @@
-import { MIDISequenceData } from "./midi_sequence.js";
+import { BasicMIDI, MIDISequenceData } from "spessasynth_core";
 
 /**
  * A simplified version of the MIDI, accessible at all times from the Sequencer.

package/sequencer/{worklet_wrapper/sequencer.js → sequencer.js}

@@ -1,18 +1,19 @@
-import { Synthetizer } from "../../synthetizer/worklet_wrapper/synthetizer.js";
-import { messageTypes } from "../../midi/midi_message.js";
+import { Synthetizer } from "../synthetizer/synthetizer.js";
 import {
     ALL_CHANNELS_OR_DIFFERENT_ACTION,
-    workletMessageType
-} from "../../synthetizer/audio_engine/message_protocol/worklet_message.js";
+    BasicMIDI,
+    messageTypes,
+    MIDI,
+    MIDIMessage,
+    SpessaSynthCoreUtils as util
+} from "spessasynth_core";
+import { workletMessageType } from "../synthetizer/worklet_message.js";
 import {
     SongChangeType,
     SpessaSynthSequencerMessageType,
     SpessaSynthSequencerReturnMessageType
 } from "./sequencer_message.js";
-import { SpessaSynthWarn } from "../../utils/loggin.js";
-import { DUMMY_MIDI_DATA, MIDIData } from "../../midi/midi_data.js";
-import { BasicMIDI } from "../../midi/basic_midi.js";
-import { readBytesAsUintBigEndian } from "../../utils/byte_functions/big_endian.js";
+import { DUMMY_MIDI_DATA, MIDIData } from "./midi_data.js";
 import { DEFAULT_SEQUENCER_OPTIONS } from "./default_sequencer_options.js";
 
 /**
@@ -520,7 +521,7 @@ export class Sequencer
             }
             catch (e)
             {
-                SpessaSynthWarn(`Failed to execute callback for ${callback[0]}:`, e);
+                util.SpessaSynthWarn(`Failed to execute callback for ${callback[0]}:`, e);
             }
         }
     }
@@ -570,7 +571,7 @@ export class Sequencer
             
             case SpessaSynthSequencerReturnMessageType.timeChange:
                 // message data is absolute time
-                const time = this.synth.currentTime - messageData;
+                const time = messageData;
                 this._callEvents(this.onTimeChange, time);
                 this._recalculateStartTime(time);
                 if (this.paused && this._preservePlaybackState)
@@ -619,7 +620,7 @@ export class Sequencer
                 {
                     case messageTypes.setTempo:
                         event.messageData.currentIndex = 0;
-                        const bpm = 60000000 / readBytesAsUintBigEndian(event.messageData, 3);
+                        const bpm = 60000000 / util.readBytesAsUintBigEndian(event.messageData, 3);
                         event.messageData.currentIndex = 0;
                         this.currentTempo = Math.round(bpm * 100) / 100;
                         if (this.onTempoChange)
@@ -769,7 +770,7 @@ export class Sequencer
     {
         if (this.paused)
         {
-            SpessaSynthWarn("Already paused");
+            util.SpessaSynthWarn("Already paused");
             return;
         }
         this.pausedTime = this.currentTime;

package/sequencer/{worklet_wrapper/sequencer_message.js → sequencer_message.js}

@@ -43,7 +43,7 @@ export const SpessaSynthSequencerMessageType = {
 export const SpessaSynthSequencerReturnMessageType = {
     midiEvent: 0,               // [...midiEventBytes<number>]
     songChange: 1,              // [songIndex<number>, isAutoPlayed<boolean>]
-    timeChange: 2,              // newAbsoluteTime<number>
+    timeChange: 2,              // newTime<number>
     pause: 3,                   // no data
     getMIDI: 4,                 // midiData<MIDI>
     midiError: 5,               // errorMSG<string>

package/synthetizer/README.md

@@ -7,4 +7,32 @@ This is the heart of the SpessaSynth library.
 - `audio_effects` - the WebAudioAPI audio effects.
 - `worklet_wrapper` - the wrapper for the core synthesis engine using audio worklets.
 
-`worklet_processor.min.js` - the minified worklet processor code to import.
+`worklet_processor.min.js` - the minified worklet processor code to import.
+
+# About the message protocol
+Since spessasynth_lib runs in the audioWorklet thread, here is an explanation of how it works:
+
+There's one processor per synthesizer, with a `MessagePort` for communication.
+Each processor has a single `SpessaSynthequencer` instance that is idle by default.
+
+The `Synthetizer`, 
+`Sequencer` and `SoundFontManager` classes are all interfaces 
+that do not do anything except sending the commands to te processor.
+
+The synthesizer sends the commands (note on, off, etc.) directly to the processor where they are processed and executed.
+
+The sequencer sends the commands through the connected synthesizer's messagePort, which then get processed as sequencer messages and routed properly.
+
+
+## How it works in spessasynth_lib
+Both `Synthetizer` and `Sequencer` are essentially "remote control"
+for the actual sequencer and synthesizer in the audio worklet thread (here)
+These core components are wrapped in the AudioWorkletProcessor, which is receiving both commands and data (MIDIs, sound banks)
+through the message port, and sends data back (events, time changes, status changes, etc.).
+
+For example,
+the playback to WebMIDIAPI is actually the sequencer in the worklet thread
+playing back the sequence and then postMessaging the commands through the synthesizer to the sequencer
+which actually sends them to the specified output.
+
+The wonders of separate audio thread...

package/synthetizer/audio_effects/reverb_as_binary.js

@@ -1,5 +1,5 @@
 import { rbCompressed } from "./rb_compressed.min.js";
-import { inflateSync } from "../../externals/fflate/fflate.min.js";
+import { SpessaSynthCoreUtils } from "spessasynth_core";
 
 // convert the base64 string to array buffer
 const binaryString = atob(rbCompressed);
@@ -14,5 +14,5 @@ for (let i = 0; i < binaryString.length; i++)
  * the reverb is zlib compressed, decompress here
  * @type {ArrayBuffer}
  */
-const reverbBufferBinary = inflateSync(binary).buffer;
+const reverbBufferBinary = SpessaSynthCoreUtils.inflateSync(binary).buffer;
 export { reverbBufferBinary };

package/synthetizer/{worklet_wrapper/key_modifier_manager.js → key_modifier_manager.js}

@@ -1,5 +1,14 @@
-import { workletMessageType } from "../audio_engine/message_protocol/worklet_message.js";
-import { KeyModifier, workletKeyModifierMessageType } from "../audio_engine/engine_components/key_modifier_manager.js";
+import { workletMessageType } from "./worklet_message.js";
+import { KeyModifier } from "spessasynth_core";
+
+/**
+ * @enum {number}
+ */
+export const workletKeyModifierMessageType = {
+    addMapping: 0,    // [channel<number>, midiNote<number>, mapping<KeyModifier>]
+    deleteMapping: 1, // [channel<number>, midiNote<number>]
+    clearMappings: 2 // <no data>
+};
 
 export class WorkletKeyModifierManagerWrapper
 {

package/synthetizer/{worklet_wrapper/synth_event_handler.js → synth_event_handler.js}

@@ -1,6 +1,8 @@
+import { synthDisplayTypes } from "spessasynth_core";
+
 /**
  * synth_event_handler.js
- * purpose: manages the synthesizer's event system, calling assinged functions when synthesizer requests dispatching the event
+ * purpose: manages the synthesizer's event system, calling assigned functions when synthesizer requests dispatching the event
  */
 
 /**
@@ -56,14 +58,14 @@
 /**
  * @typedef {Object} SynthDisplayCallback
  * @property {Uint8Array} displayData - The data to display.
- * @property {SynthDisplayType} displayType - The type of display.
+ * @property {synthDisplayTypes} displayType - The type of display.
  */
 
 /**
  * @typedef {Object} PitchWheelCallback
  * @property {number} channel - The MIDI channel number.
- * @property {number} MSB - The most significant byte of the pitch wheel value.
- * @property {number} LSB - The least significant byte of the pitch wheel value.
+ * @property {number} MSB - The most significant byte of the pitch-wheel value.
+ * @property {number} LSB - The least significant byte of the pitch-wheel value.
  */
 
 /**
@@ -123,15 +125,15 @@ export class EventHandler
          * @type {Object<EventTypes, Object<string, function(EventCallbackData)>>}
          */
         this.events = {
-            "noteoff": {},              // called on note off message
-            "noteon": {},               // called on note on message
-            "pitchwheel": {},           // called on pitch wheel change
-            "controllerchange": {},     // called on controller change
-            "programchange": {},        // called on program change
-            "channelpressure": {},      // called on channel pressure message
-            "polypressure": {},         // called on poly pressure message
-            "drumchange": {},           // called when channel type changes
-            "stopall": {},              // called when synth receives stop all command
+            "noteoff": {},              // called on a note off message
+            "noteon": {},               // called on a note on message
+            "pitchwheel": {},           // called on a pitch-wheel change
+            "controllerchange": {},     // called on a controller change
+            "programchange": {},        // called on a program change
+            "channelpressure": {},      // called on a channel pressure message
+            "polypressure": {},         // called on a poly pressure message
+            "drumchange": {},           // called when a channel type changes
+            "stopall": {},              // called when the synth receives stop all command
             "newchannel": {},           // called when a new channel is created
             "mutechannel": {},          // called when a channel is muted/unmuted
             "presetlistchange": {},     // called when the preset list changes (soundfont gets reloaded)
@@ -158,6 +160,7 @@ export class EventHandler
         this.events[name][id] = callback;
     }
     
+    // noinspection JSUnusedGlobalSymbols
     /**
      * Removes an event listener
      * @param name {EventTypes}