spessasynth_lib 0.0.1

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/spessasynth_lib.iml" filepath="$PROJECT_DIR$/.idea/spessasynth_lib.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/spessasynth_lib.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/copy_version.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+
+# Ensure jq is installed
+if ! command -v jq &> /dev/null
+then
+    echo "jq command not found. Please install jq to use this script."
+    exit 1
+fi
+
+# Define source and destination files
+SOURCE_FILE="../SpessaSynth/package.json"
+DEST_FILE="package/package.json"
+
+# Check if source file exists
+if [ ! -f "$SOURCE_FILE" ]; then
+    echo "Source file $SOURCE_FILE does not exist."
+    exit 1
+fi
+
+# Check if destination file exists
+if [ ! -f "$DEST_FILE" ]; then
+    echo "Destination file $DEST_FILE does not exist."
+    exit 1
+fi
+
+# Extract the version from source/package.json
+VERSION=$(jq -r '.version' "$SOURCE_FILE")
+
+# Check if version was extracted successfully
+if [ "$VERSION" == "null" ]; then
+    echo "Version field not found in $SOURCE_FILE."
+    exit 1
+fi
+
+# Update the version field in destination/package.json
+jq --arg ver "$VERSION" '.version = $ver' "$DEST_FILE" > temp.json && mv temp.json "$DEST_FILE"
+
+echo "Version updated successfully in $DEST_FILE."

package/index.js

@@ -0,0 +1,73 @@
+// Import modules
+import { SoundFont2 } from './soundfont/soundfont.js';
+import { MIDI } from './midi_parser/midi_loader.js';
+import { Synthetizer, VOICE_CAP, DEFAULT_PERCUSSION } from './synthetizer/synthetizer.js';
+import { Sequencer } from './sequencer/sequencer.js';
+import { IndexedByteArray } from './utils/indexed_array.js';
+import { writeMIDIFile } from './midi_parser/midi_writer.js';
+import { writeRMIDI } from './midi_parser/rmidi_writer.js'
+import { applySnapshotToMIDI, modifyMIDI } from './midi_parser/midi_editor.js';
+import { audioBufferToWav } from './utils/buffer_to_wav.js';
+import {
+    SpessaSynthInfo,
+    SpessaSynthWarn,
+    SpessaSynthGroupCollapsed,
+    SpessaSynthGroupEnd,
+    SpessaSynthTable,
+    SpessaSynthLogging,
+    SpessaSynthGroup
+} from './utils/loggin.js';
+import { midiControllers, messageTypes } from './midi_parser/midi_message.js';
+import { MIDIDeviceHandler } from './midi_handler/midi_handler.js';
+import { WebMidiLinkHandler } from './midi_handler/web_midi_link.js';
+import { formatTime, formatTitle, consoleColors, arrayToHexString } from './utils/other.js';
+import { readBytesAsUintBigEndian } from './utils/byte_functions/big_endian.js';
+import { NON_CC_INDEX_OFFSET } from './synthetizer/worklet_system/worklet_utilities/worklet_processor_channel.js';
+import { modulatorSources } from './soundfont/read/modulators.js';
+import { ALL_CHANNELS_OR_DIFFERENT_ACTION } from './synthetizer/worklet_system/message_protocol/worklet_message.js';
+import { trimSoundfont } from './soundfont/write/soundfont_trimmer.js';
+import { WORKLET_URL_ABSOLUTE } from './synthetizer/worklet_url.js'
+
+// Export modules
+export {
+    // Synthesizer and Sequencer
+    Sequencer,
+    Synthetizer,
+    DEFAULT_PERCUSSION,
+    VOICE_CAP,
+
+    // SoundFont
+    SoundFont2,
+    trimSoundfont,
+    modulatorSources,
+
+    // MIDI
+    MIDI,
+    IndexedByteArray,
+    writeMIDIFile,
+    writeRMIDI,
+    applySnapshotToMIDI,
+    modifyMIDI,
+
+    // Utilities
+    audioBufferToWav,
+    SpessaSynthLogging,
+    SpessaSynthGroup,
+    SpessaSynthTable,
+    SpessaSynthGroupEnd,
+    SpessaSynthInfo,
+    SpessaSynthWarn,
+    SpessaSynthGroupCollapsed,
+    midiControllers,
+    messageTypes,
+    MIDIDeviceHandler,
+    WebMidiLinkHandler,
+    arrayToHexString,
+    consoleColors,
+    formatTitle,
+    formatTime,
+    readBytesAsUintBigEndian,
+    NON_CC_INDEX_OFFSET,
+    ALL_CHANNELS_OR_DIFFERENT_ACTION,
+    WORKLET_URL_ABSOLUTE
+};

package/package/@types/externals/stbvorbis_sync/stbvorbis_sync.min.d.ts

@@ -0,0 +1 @@
+export const stbvorbis: any;

package/package/@types/index.d.ts

@@ -0,0 +1,34 @@
+import { Sequencer } from './sequencer/sequencer.js';
+import { Synthetizer } from './synthetizer/synthetizer.js';
+import { DEFAULT_PERCUSSION } from './synthetizer/synthetizer.js';
+import { VOICE_CAP } from './synthetizer/synthetizer.js';
+import { SoundFont2 } from './soundfont/soundfont.js';
+import { trimSoundfont } from './soundfont/write/soundfont_trimmer.js';
+import { modulatorSources } from './soundfont/read/modulators.js';
+import { MIDI } from './midi_parser/midi_loader.js';
+import { IndexedByteArray } from './utils/indexed_array.js';
+import { writeMIDIFile } from './midi_parser/midi_writer.js';
+import { writeRMIDI } from './midi_parser/rmidi_writer.js';
+import { applySnapshotToMIDI } from './midi_parser/midi_editor.js';
+import { modifyMIDI } from './midi_parser/midi_editor.js';
+import { audioBufferToWav } from './utils/buffer_to_wav.js';
+import { SpessaSynthLogging } from './utils/loggin.js';
+import { SpessaSynthGroup } from './utils/loggin.js';
+import { SpessaSynthTable } from './utils/loggin.js';
+import { SpessaSynthGroupEnd } from './utils/loggin.js';
+import { SpessaSynthInfo } from './utils/loggin.js';
+import { SpessaSynthWarn } from './utils/loggin.js';
+import { SpessaSynthGroupCollapsed } from './utils/loggin.js';
+import { midiControllers } from './midi_parser/midi_message.js';
+import { messageTypes } from './midi_parser/midi_message.js';
+import { MIDIDeviceHandler } from './midi_handler/midi_handler.js';
+import { WebMidiLinkHandler } from './midi_handler/web_midi_link.js';
+import { arrayToHexString } from './utils/other.js';
+import { consoleColors } from './utils/other.js';
+import { formatTitle } from './utils/other.js';
+import { formatTime } from './utils/other.js';
+import { readBytesAsUintBigEndian } from './utils/byte_functions/big_endian.js';
+import { NON_CC_INDEX_OFFSET } from './synthetizer/worklet_system/worklet_utilities/worklet_processor_channel.js';
+import { ALL_CHANNELS_OR_DIFFERENT_ACTION } from './synthetizer/worklet_system/message_protocol/worklet_message.js';
+import { WORKLET_URL_ABSOLUTE } from './synthetizer/worklet_url.js';
+export { Sequencer, Synthetizer, DEFAULT_PERCUSSION, VOICE_CAP, SoundFont2, trimSoundfont, modulatorSources, MIDI, IndexedByteArray, writeMIDIFile, writeRMIDI, applySnapshotToMIDI, modifyMIDI, audioBufferToWav, SpessaSynthLogging, SpessaSynthGroup, SpessaSynthTable, SpessaSynthGroupEnd, SpessaSynthInfo, SpessaSynthWarn, SpessaSynthGroupCollapsed, midiControllers, messageTypes, MIDIDeviceHandler, WebMidiLinkHandler, arrayToHexString, consoleColors, formatTitle, formatTime, readBytesAsUintBigEndian, NON_CC_INDEX_OFFSET, ALL_CHANNELS_OR_DIFFERENT_ACTION, WORKLET_URL_ABSOLUTE };

package/package/@types/midi_handler/midi_handler.d.ts

@@ -0,0 +1,39 @@
+export class MIDIDeviceHandler {
+    /**
+     * @returns {Promise<boolean>} if succeded
+     */
+    createMIDIDeviceHandler(): Promise<boolean>;
+    /**
+     * @type {MIDIInput}
+     */
+    selectedInput: MIDIInput;
+    /**
+     * @type {MIDIOutput}
+     */
+    selectedOutput: MIDIOutput;
+    inputs: any[] | MIDIInputMap;
+    outputs: any[] | MIDIOutputMap;
+    /**
+     * Connects the sequencer to a given MIDI output port
+     * @param output {MIDIOutput}
+     * @param seq {Sequencer}
+     */
+    connectMIDIOutputToSeq(output: MIDIOutput, seq: Sequencer): void;
+    /**
+     * Disconnects a midi output port from the sequencer
+     * @param seq {Sequencer}
+     */
+    disconnectSeqFromMIDI(seq: Sequencer): void;
+    /**
+     * Connects a MIDI input to the synthesizer
+     * @param input {MIDIInput}
+     * @param synth {Synthetizer}
+     */
+    connectDeviceToSynth(input: MIDIInput, synth: Synthetizer): void;
+    /**
+     * @param input {MIDIInput}
+     */
+    disconnectDeviceFromSynth(input: MIDIInput): void;
+    disconnectAllDevicesFromSynth(): void;
+}
+import { Synthetizer } from '../synthetizer/synthetizer.js';

package/package/@types/midi_handler/web_midi_link.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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: Synthetizer);
+}
+import { Synthetizer } from '../synthetizer/synthetizer.js';

package/package/@types/midi_parser/midi_data.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 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, which is the track data.
+ */
+export class MidiData {
+    /**
+     * @param midi {MIDI}
+     */
+    constructor(midi: MIDI);
+    /**
+     * The time division of the sequence
+     * @type {number}
+     */
+    timeDivision: number;
+    /**
+     * The duration of the sequence, in seconds
+     * @type {number}
+     */
+    duration: number;
+    /**
+     * The tempo changes in the sequence, ordered from last to first
+     * @type {{ticks: number, tempo: number}[]}
+     */
+    tempoChanges: {
+        ticks: number;
+        tempo: number;
+    }[];
+    /**
+     * Contains the copyright strings
+     * @type {string}
+     */
+    copyright: string;
+    /**
+     * The amount of tracks in the sequence
+     * @type {number}
+     */
+    tracksAmount: number;
+    /**
+     * The lyrics of the sequence as binary chunks
+     * @type {Uint8Array[]}
+     */
+    lyrics: Uint8Array[];
+    firstNoteOn: any;
+    /**
+     * The MIDI's key range
+     * @type {{min: number, max: number}}
+     */
+    keyRange: {
+        min: number;
+        max: number;
+    };
+    /**
+     * The last voice (note on, off, cc change etc.) event tick
+     * @type {number}
+     */
+    lastVoiceEventTick: number;
+    /**
+     * Midi port numbers for each track
+     * @type {number[]}
+     */
+    midiPorts: number[];
+    /**
+     * All channels that each track uses
+     * @type {Set<number>[]}
+     */
+    usedChannelsOnTrack: Set<number>[];
+    /**
+     * The loop points (in ticks) of the sequence
+     * @type {{start: number, end: number}}
+     */
+    loop: {
+        start: number;
+        end: number;
+    };
+    /**
+     * The sequence's name
+     * @type {string}
+     */
+    midiName: string;
+    /**
+     * The file name of the sequence, if provided in the MIDI class
+     * @type {string}
+     */
+    fileName: string;
+    /**
+     * The raw, encoded MIDI name.
+     * @type {Uint8Array}
+     */
+    rawMidiName: Uint8Array;
+}
+/**
+ *
+ * @type {MidiData}
+ */
+export const DUMMY_MIDI_DATA: MidiData;

package/package/@types/midi_parser/midi_editor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @param ticks {number}
+ * @returns {MidiMessage}
+ */
+export function getGsOn(ticks: number): MidiMessage;
+/**
+ * Allows easy editing of the file
+ * @param midi {MIDI}
+ * @param desiredProgramChanges {{
+ *     channel: number,
+ *     program: number,
+ *     bank: number,
+ *     isDrum: boolean
+ * }[]} the programs to set on given channels. Note that the channel may be more than 16, function will adjust midi ports automatically
+ * @param desiredControllerChanges {{
+ *     channel: number,
+ *     controllerNumber: number,
+ *     controllerValue: number,
+ * }[]} the controllers to set on given channels. Note that the channel may be more than 16, function will adjust midi ports automatically
+ * @param desiredChannelsToClear {number[]} the channels to remove from the sequence. Note that the channel may be more than 16, function will adjust midi ports automatically
+ * @param desiredChannelsToTranspose {{
+ *     channel: number,
+ *     keyShift: number
+ * }[]} the channels to transpose. if keyShift is float, rpn fine tuning will be applied as well. Note that the channel may be more than 16, function will adjust midi ports automatically
+ */
+export function modifyMIDI(midi: MIDI, desiredProgramChanges?: {
+    channel: number;
+    program: number;
+    bank: number;
+    isDrum: boolean;
+}[], desiredControllerChanges?: {
+    channel: number;
+    controllerNumber: number;
+    controllerValue: number;
+}[], desiredChannelsToClear?: number[], desiredChannelsToTranspose?: {
+    channel: number;
+    keyShift: number;
+}[]): void;
+/**
+ * Modifies the sequence according to the locked presets and controllers in the given snapshot
+ * @param midi {MIDI}
+ * @param snapshot {SynthesizerSnapshot}
+ */
+export function applySnapshotToMIDI(midi: MIDI, snapshot: SynthesizerSnapshot): void;
+import { MidiMessage } from './midi_message.js';

package/package/@types/midi_parser/midi_loader.d.ts

@@ -0,0 +1,100 @@
+/**
+ * midi_loader.js
+ * purpose: parses a midi file for the seqyencer, including things like marker or CC 2/4 loop detection, copyright detection etc.
+ */
+export class MIDI {
+    /**
+     * Parses a given midi file
+     * @param arrayBuffer {ArrayBuffer}
+     * @param fileName {string} optional, replaces the decoded title if empty
+     */
+    constructor(arrayBuffer: ArrayBuffer, fileName?: string);
+    /**
+     * If the RMI file has an embedded sf2 in it, it will appeear here, otherwise undefined
+     * @type {ArrayBuffer}
+     */
+    embeddedSoundFont: ArrayBuffer;
+    /**
+     * Contains the copyright strings
+     * @type {string}
+     */
+    copyright: string;
+    format: number;
+    tracksAmount: number;
+    timeDivision: number;
+    /**
+     * The MIDI's key range
+     * @type {{min: number, max: number}}
+     */
+    keyRange: {
+        min: number;
+        max: number;
+    };
+    /**
+     * Contains the lyrics as binary chunks
+     * @type {Uint8Array[]}
+     */
+    lyrics: Uint8Array[];
+    /**
+     * Contains all the tempo changes in the file. (Ordered from last to first)
+     * @type {{
+     *     ticks: number,
+     *     tempo: number
+     * }[]}
+     */
+    tempoChanges: {
+        ticks: number;
+        tempo: number;
+    }[];
+    lastVoiceEventTick: number;
+    /**
+     * Midi port numbers for each tracks
+     * @type {number[]}
+     */
+    midiPorts: number[];
+    /**
+     * All channels that each track uses. Note: these channels range from 0 to 15, excluding the port offsets!
+     * @type {Set<number>[]}
+     */
+    usedChannelsOnTrack: Set<number>[];
+    /**
+     * Read all the tracks
+     * @type {MidiMessage[][]}
+     */
+    tracks: MidiMessage[][];
+    firstNoteOn: number;
+    /**
+     *
+     * @type {{start: number, end: number}}
+     */
+    loop: {
+        start: number;
+        end: number;
+    };
+    midiName: string;
+    rawMidiName: Uint8Array;
+    fileName: string;
+    /**
+     * The total playback time, in seconds
+     * @type {number}
+     */
+    duration: number;
+    /**
+     * @param fileByteArray {IndexedByteArray}
+     * @returns {{type: string, size: number, data: IndexedByteArray}}
+     */
+    readMIDIChunk(fileByteArray: IndexedByteArray): {
+        type: string;
+        size: number;
+        data: IndexedByteArray;
+    };
+    /**
+     * Coverts ticks to time in seconds
+     * @param ticks {number}
+     * @returns {number}
+     * @private
+     */
+    private _ticksToSeconds;
+}
+import { MidiMessage } from './midi_message.js';
+import { IndexedByteArray } from '../utils/indexed_array.js';

package/package/@types/midi_parser/midi_message.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Gets the status byte's channel
+ * @param statusByte
+ * @returns {number} channel is -1 for system messages -2 for meta and -3 for sysex
+ */
+export function getChannel(statusByte: any): number;
+/**
+ * Gets the event's status and channel from the status byte
+ * @param statusByte {number} the status byte
+ * @returns {{channel: number, status: number}} channel will be -1 for sysex and meta
+ */
+export function getEvent(statusByte: number): {
+    channel: number;
+    status: number;
+};
+/**
+ * midi_message.js
+ * purpose: contains enums for midi events and controllers and functions to parse them
+ */
+export class MidiMessage {
+    /**
+     * @param ticks {number}
+     * @param byte {number} the message status byte
+     * @param data {IndexedByteArray}
+     */
+    constructor(ticks: number, byte: number, data: IndexedByteArray);
+    ticks: number;
+    messageStatusByte: number;
+    /**
+     * @type {IndexedByteArray}
+     */
+    messageData: IndexedByteArray;
+}
+export namespace messageTypes {
+    export let noteOff: number;
+    export let noteOn: number;
+    export let polyPressure: number;
+    export let controllerChange: number;
+    export let programChange: number;
+    export let channelPressure: number;
+    export let pitchBend: number;
+    export let systemExclusive: number;
+    export let timecode: number;
+    export let songPosition: number;
+    export let songSelect: number;
+    export let tuneRequest: number;
+    export let clock: number;
+    export let start: number;
+    let _continue: number;
+    export { _continue as continue };
+    export let stop: number;
+    export let activeSensing: number;
+    export let reset: number;
+    export let sequenceNumber: number;
+    export let text: number;
+    export let copyright: number;
+    export let trackName: number;
+    export let instrumentName: number;
+    export let lyric: number;
+    export let marker: number;
+    export let cuePoint: number;
+    export let midiChannelPrefix: number;
+    export let midiPort: number;
+    export let endOfTrack: number;
+    export let setTempo: number;
+    export let smpteOffset: number;
+    export let timeSignature: number;
+    export let keySignature: number;
+    export let sequenceSpecific: number;
+}
+export type midiControllers = number;
+export namespace midiControllers {
+    let bankSelect: number;
+    let modulationWheel: number;
+    let breathController: number;
+    let footController: number;
+    let portamentoTime: number;
+    let dataEntryMsb: number;
+    let mainVolume: number;
+    let balance: number;
+    let pan: number;
+    let expressionController: number;
+    let effectControl1: number;
+    let effectControl2: number;
+    let generalPurposeController1: number;
+    let generalPurposeController2: number;
+    let generalPurposeController3: number;
+    let generalPurposeController4: number;
+    let lsbForControl0BankSelect: number;
+    let lsbForControl1ModulationWheel: number;
+    let lsbForControl2BreathController: number;
+    let lsbForControl4FootController: number;
+    let lsbForControl5PortamentoTime: number;
+    let lsbForControl6DataEntry: number;
+    let lsbForControl7MainVolume: number;
+    let lsbForControl8Balance: number;
+    let lsbForControl10Pan: number;
+    let lsbForControl11ExpressionController: number;
+    let lsbForControl12EffectControl1: number;
+    let lsbForControl13EffectControl2: number;
+    let sustainPedal: number;
+    let portamentoOnOff: number;
+    let sostenutoPedal: number;
+    let softPedal: number;
+    let legatoFootswitch: number;
+    let hold2Pedal: number;
+    let soundVariation: number;
+    let timbreHarmonicContent: number;
+    let releaseTime: number;
+    let attackTime: number;
+    let brightness: number;
+    let soundController6: number;
+    let soundController7: number;
+    let soundController8: number;
+    let soundController9: number;
+    let soundController10: number;
+    let generalPurposeController5: number;
+    let generalPurposeController6: number;
+    let generalPurposeController7: number;
+    let generalPurposeController8: number;
+    let portamentoControl: number;
+    let effects1Depth: number;
+    let effects2Depth: number;
+    let effects3Depth: number;
+    let effects4Depth: number;
+    let effects5Depth: number;
+    let dataIncrement: number;
+    let dataDecrement: number;
+    let NRPNLsb: number;
+    let NRPNMsb: number;
+    let RPNLsb: number;
+    let RPNMsb: number;
+    let allSoundOff: number;
+    let resetAllControllers: number;
+    let localControlOnOff: number;
+    let allNotesOff: number;
+    let omniModeOff: number;
+    let omniModeOn: number;
+    let monoModeOn: number;
+    let polyModeOn: number;
+}
+/**
+ * @type {{"11": number, "12": number, "13": number, "14": number, "8": number, "9": number, "10": number}}
+ */
+export const dataBytesAmount: {
+    "11": number;
+    "12": number;
+    "13": number;
+    "14": number;
+    "8": number;
+    "9": number;
+    "10": number;
+};
+import { IndexedByteArray } from "../utils/indexed_array.js";

package/package/@types/midi_parser/midi_writer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Exports the midi as a .mid file
+ * @param midi {MIDI}
+ * @returns {Uint8Array} the binary .mid file data
+ */
+export function writeMIDIFile(midi: MIDI): Uint8Array;

package/package/@types/midi_parser/rmidi_writer.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @param soundfontBinary {Uint8Array}
+ * @param mid {MIDI}
+ * @param soundfont {SoundFont2}
+ * @returns {IndexedByteArray}
+ */
+export function writeRMIDI(soundfontBinary: Uint8Array, mid: MIDI, soundfont: SoundFont2): IndexedByteArray;
+import { IndexedByteArray } from '../utils/indexed_array.js';

package/package/@types/midi_parser/used_keys_loaded.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @param mid {MIDI}
+ * @param soundfont {SoundFont2}
+ */
+export function getUsedProgramsAndKeys(mid: MIDI, soundfont: SoundFont2): {
+    [x: string]: Set<string>;
+};