spessasynth_lib 3.27.8 → 4.0.1

package/package.json

@@ -1,23 +1,24 @@
 {
   "name": "spessasynth_lib",
-  "version": "3.27.8",
+  "version": "4.0.1",
   "description": "MIDI and SoundFont2/DLS library for the browsers with no compromises",
-  "browser": "index.js",
   "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "node build_scripts/build.js",
-    "debug": "node build_scripts/debug_enable.js",
-    "release": "node build_scripts/debug_disable.js",
-    "build:pages": "node build_scripts/build_pages.js",
-    "build:examples": "node examples/build_examples.js",
-    "build:docs": "node build_scripts/build_docs.js"
+    "build": "npm run test:types && npm run local-build && npm run build:pages",
+    "local-build": "npm run build:npm && npm pack",
+    "build:npm": "tsx build_scripts/build_npm.ts",
+    "build:pages": "tsx build_scripts/build_pages.ts",
+    "test:types": "eslint src/ && tsc -b",
+    "debug": "tsx build_scripts/debug_enable.ts",
+    "release": "tsx build_scripts/debug_disable.ts"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/spessasus/spessasynth_lib.git"
   },
-  "main": "index.js",
   "keywords": [
     "soundfont",
     "synthesizer",
@@ -37,9 +38,10 @@
     "audio-buffer-to-wav"
   ],
   "files": [
-    "src",
-    "synthetizer/worklet_processor.min.js",
-    "index.js"
+    "dist",
+    "LICENSE",
+    "README.md",
+    "package.json"
   ],
   "author": {
     "name": "spessasus",
@@ -53,7 +55,17 @@
   },
   "homepage": "https://github.com/spessasus/spessasynth_lib#readme",
   "devDependencies": {
-    "esbuild": "^0.25.2"
+    "@eslint/js": "^9.32.0",
+    "@types/audioworklet": "^0.0.81",
+    "@types/node": "^24.1.0",
+    "esbuild": "^0.25.8",
+    "eslint": "^9.32.0",
+    "globals": "^16.3.0",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.38.0"
   },
   "dependencies": {
     "spessasynth_core": "latest"

package/index.js

@@ -1,29 +0,0 @@
-// Import modules
-
-import { Synthetizer } from "./src/synthetizer/synthetizer.js";
-import { Sequencer } from "./src/sequencer/sequencer.js";
-import { getReverbProcessor } from "./src/synthetizer/audio_effects/reverb.js";
-import { FancyChorus } from "./src/synthetizer/audio_effects/fancy_chorus.js";
-import { audioBufferToWav } from "./src/utils/buffer_to_wav.js";
-import { MIDIDeviceHandler } from "./src/external_midi/midi_handler.js";
-import { WebMIDILinkHandler } from "./src/external_midi/web_midi_link.js";
-import { DEFAULT_SYNTH_CONFIG } from "./src/synthetizer/audio_effects/effects_config.js";
-import { WORKLET_URL_ABSOLUTE } from "./src/synthetizer/worklet_url.js";
-
-// Export modules
-export {
-    // Synthesizer and Sequencer
-    Sequencer,
-    Synthetizer,
-    DEFAULT_SYNTH_CONFIG,
-    
-    // Effects
-    getReverbProcessor,
-    FancyChorus,
-    
-    // Utilities
-    audioBufferToWav,
-    MIDIDeviceHandler,
-    WebMIDILinkHandler,
-    WORKLET_URL_ABSOLUTE
-};

package/src/external_midi/README.md

@@ -1,4 +0,0 @@
-## This is the MIDI handling folder.
-
-The code here is responsible for dealing with MIDI Inputs and outputs
-and also for the WebMidiLink functionality.

package/src/external_midi/midi_handler.js

@@ -1,130 +0,0 @@
-import { Synthetizer } from "../synthetizer/synthetizer.js";
-import { SpessaSynthCoreUtils as util } from "spessasynth_core";
-import { consoleColors } from "../utils/other.js";
-
-/**
- * midi_handler.js
- * purpose: handles the connection between MIDI devices and synthesizer/sequencer via Web MIDI API
- */
-
-const NO_INPUT = null;
-
-// noinspection JSUnusedGlobalSymbols
-/**
- * A class for handling MIDI devices
- */
-export class MIDIDeviceHandler
-{
-    /**
-     * @returns {Promise<boolean>} if succeeded
-     */
-    async createMIDIDeviceHandler()
-    {
-        /**
-         * @type {MIDIInput}
-         */
-        this.selectedInput = NO_INPUT;
-        /**
-         * @type {MIDIOutput}
-         */
-        this.selectedOutput = NO_INPUT;
-        if (navigator.requestMIDIAccess)
-        {
-            // prepare the midi access
-            try
-            {
-                const response = await navigator.requestMIDIAccess({ sysex: true, software: true });
-                this.inputs = response.inputs;
-                this.outputs = response.outputs;
-                util.SpessaSynthInfo("%cMIDI handler created!", consoleColors.recognized);
-                return true;
-            }
-            catch (e)
-            {
-                util.SpessaSynthWarn(`Could not get MIDI Devices:`, e);
-                this.inputs = [];
-                this.outputs = [];
-                return false;
-            }
-        }
-        else
-        {
-            util.SpessaSynthWarn("Web MIDI Api not supported!", consoleColors.unrecognized);
-            this.inputs = [];
-            this.outputs = [];
-            return false;
-        }
-    }
-    
-    /**
-     * Connects the sequencer to a given MIDI output port
-     * @param output {MIDIOutput}
-     * @param seq {Sequencer}
-     */
-    connectMIDIOutputToSeq(output, seq)
-    {
-        this.selectedOutput = output;
-        seq.connectMidiOutput(output);
-        util.SpessaSynthInfo(
-            `%cPlaying MIDI to %c${output.name}`,
-            consoleColors.info,
-            consoleColors.recognized
-        );
-    }
-    
-    /**
-     * Disconnects a midi output port from the sequencer
-     * @param seq {Sequencer}
-     */
-    disconnectSeqFromMIDI(seq)
-    {
-        this.selectedOutput = NO_INPUT;
-        seq.connectMidiOutput(undefined);
-        util.SpessaSynthInfo(
-            "%cDisconnected from MIDI out.",
-            consoleColors.info
-        );
-    }
-    
-    /**
-     * Connects a MIDI input to the synthesizer
-     * @param input {MIDIInput}
-     * @param synth {Synthetizer}
-     */
-    connectDeviceToSynth(input, synth)
-    {
-        this.selectedInput = input;
-        input.onmidimessage = event =>
-        {
-            synth.sendMessage(event.data);
-        };
-        util.SpessaSynthInfo(
-            `%cListening for messages on %c${input.name}`,
-            consoleColors.info,
-            consoleColors.recognized
-        );
-    }
-    
-    /**
-     * @param input {MIDIInput}
-     */
-    disconnectDeviceFromSynth(input)
-    {
-        this.selectedInput = NO_INPUT;
-        input.onmidimessage = undefined;
-        util.SpessaSynthInfo(
-            `%cDisconnected from %c${input.name}`,
-            consoleColors.info,
-            consoleColors.recognized
-        );
-    }
-    
-    disconnectAllDevicesFromSynth()
-    {
-        this.selectedInput = NO_INPUT;
-        for (const i of this.inputs)
-        {
-            i[1].onmidimessage = undefined;
-        }
-    }
-}

package/src/external_midi/web_midi_link.js

@@ -1,43 +0,0 @@
-import { Synthetizer } from "../synthetizer/synthetizer.js";
-import { consoleColors } from "../utils/other.js";
-import { SpessaSynthCoreUtils } from "spessasynth_core";
-
-/**
- * web_midi_link.js
- * purpose: handles the web midi link connection to the synthesizer
- * https://www.g200kg.com/en/docs/webmidilink/
- */
-
-export class WebMIDILinkHandler
-{
-    /**
-     * @param synth {Synthetizer} the synth to play to
-     */
-    constructor(synth)
-    {
-        
-        window.addEventListener("message", msg =>
-        {
-            if (typeof msg.data !== "string")
-            {
-                return;
-            }
-            /**
-             * @type {string[]}
-             */
-            const data = msg.data.split(",");
-            if (data[0] !== "midi")
-            {
-                return;
-            }
-            
-            data.shift(); // remove MIDI
-            
-            const midiData = data.map(byte => parseInt(byte, 16));
-            
-            synth.sendMessage(midiData);
-        });
-        
-        SpessaSynthCoreUtils.SpessaSynthInfo("%cWeb MIDI Link handler created!", consoleColors.recognized);
-    }
-}

package/src/sequencer/README.md

@@ -1,30 +0,0 @@
-## This is the sequencer's folder.
-
-The code here is responsible for wrapping the `SpessaSynthSequencer` from `spessasynth_core`.
-
-### Message protocol:
-
-#### Message structure
-
-```js
-const message = {
-    messageType: number, // WorkletSequencerMessageType
-    messageData: any     // any
-}
-```
-
-#### To worklet
-
-Sequencer uses `Synthetizer`'s `post` method to post a message with `messageData` set to
-`workletMessageType.sequencerSpecific`.
-The `messageData` is set to the sequencer's message.
-
-#### From worklet
-
-`WorkletSequencer` uses `SpessaSynthProcessor`'s post to send a message with `messageData` set to
-`returnMessageType.sequencerSpecific`.
-The `messageData` is set to the sequencer's return message.
-
-### Process tick
-
-`processTick` is called every time the `process` method is called via `sequencer.processTick()` every rendering quantum.

package/src/sequencer/default_sequencer_options.js

@@ -1,9 +0,0 @@
-/**
- * @type {SequencerOptions}
- */
-export const DEFAULT_SEQUENCER_OPTIONS = {
-    skipToFirstNoteOn: true,
-    autoPlay: true,
-    preservePlaybackState: false,
-    initialPlaybackRate: 1
-};

package/src/sequencer/midi_data.js

@@ -1,67 +0,0 @@
-import { BasicMIDI, MIDISequenceData } from "spessasynth_core";
-
-/**
- * A simplified version of the MIDI, accessible at all times from the Sequencer.
- * Use getMIDI() to get the actual sequence.
- * This class contains all properties that MIDI does, except for tracks and the embedded soundfont.
- */
-export class MIDIData extends MIDISequenceData
-{
-    
-    /**
-     * A boolean indicating if the MIDI file contains an embedded soundfont.
-     * If the embedded soundfont is undefined, this will be false.
-     * @type {boolean}
-     */
-    isEmbedded = false;
-    
-    /**
-     * Constructor that copies data from a BasicMIDI instance.
-     * @param {BasicMIDI} midi - The BasicMIDI instance to copy data from.
-     */
-    constructor(midi)
-    {
-        super();
-        this._copyFromSequence(midi);
-        
-        // Set isEmbedded based on the presence of an embeddedSoundFont
-        this.isEmbedded = midi.embeddedSoundFont !== undefined;
-    }
-}
-
-
-/**
- * Temporary MIDI data used when the MIDI is not loaded.
- * @type {MIDIData}
- */
-export const DUMMY_MIDI_DATA = Object.assign({
-    duration: 99999,
-    firstNoteOn: 0,
-    loop: {
-        start: 0,
-        end: 123456
-    },
-    
-    lastVoiceEventTick: 123456,
-    lyrics: [],
-    lyricsTicks: [],
-    copyright: "",
-    midiPorts: [],
-    midiPortChannelOffsets: [],
-    tracksAmount: 0,
-    tempoChanges: [{ ticks: 0, tempo: 120 }],
-    trackNames: [],
-    fileName: "NOT_LOADED.mid",
-    midiName: "Loading...",
-    rawMidiName: new Uint8Array([76, 111, 97, 100, 105, 110, 103, 46, 46, 46]), // "Loading..."
-    usedChannelsOnTrack: [],
-    timeDivision: 0,
-    keyRange: { min: 0, max: 127 },
-    isEmbedded: false,
-    isKaraokeFile: false,
-    isMultiPort: false,
-    RMIDInfo: {},
-    bankOffset: 0,
-    midiNameUsesFileName: false,
-    format: 0
-}, MIDIData.prototype);