spessasynth_core 4.3.20 → 4.3.22

package/dist/index.d.ts

@@ -2091,6 +2091,157 @@ type ChannelMIDIParameterChange = { [P in keyof ChannelMIDIParameter]: {
   value: ChannelMIDIParameter[P];
 } }[keyof ChannelMIDIParameter];
 //#endregion
+//#region src/synthesizer/audio_engine/sound_bank_manager.d.ts
+declare class SoundBankManager {
+  /**
+   * All the sound banks, ordered from the most important to the least.
+   */
+  soundBankList: SoundBankManagerListEntry[];
+  private readonly presetListChangeCallback;
+  private selectablePresetList;
+  /**
+   * @param presetListChangeCallback Supplied by the parent synthesizer class,
+   * this is called whenever the preset list changes.
+   */
+  constructor(presetListChangeCallback: () => unknown);
+  private _presetList;
+  /**
+   * The list of all presets in the sound bank stack.
+   */
+  get presetList(): MIDIPatchFull[];
+  /**
+   * The current sound bank priority order.
+   * @returns The IDs of the sound banks in the current order.
+   */
+  get priorityOrder(): string[];
+  /**
+   * The current sound bank priority order.
+   * @param newList The new order of sound bank IDs.
+   */
+  set priorityOrder(newList: string[]);
+  /**
+   * Deletes a given sound bank by its ID.
+   * @param id the ID of the sound bank to delete.
+   */
+  deleteSoundBank(id: string): void;
+  /**
+   * Adds a new sound bank with a given ID, or replaces an existing one.
+   * @param font the sound bank to add.
+   * @param id the ID of the sound bank.
+   * @param bankOffset the bank offset of the sound bank.
+   */
+  addSoundBank(font: BasicSoundBank, id: string, bankOffset?: number): void;
+  destroy(): void;
+  private generatePresetList;
+}
+//#endregion
+//#region src/synthesizer/audio_engine/key_modifier_manager.d.ts
+declare class KeyModifier {
+  /**
+   * The new override velocity. -1 means unchanged.
+   */
+  velocity: number;
+  /**
+   * The MIDI patch this key uses. -1 on any property means unchanged.
+   */
+  patch: MIDIPatch;
+  /**
+   * Linear gain override for the voice.
+   */
+  gain: number;
+}
+declare class KeyModifierManager {
+  /**
+   * The velocity override mappings for MIDI keys
+   * stored as [channelNumber][midiNote].
+   */
+  private keyMappings;
+  /**
+   * Add a mapping for a MIDI key to a KeyModifier.
+   * @param channel The MIDI channel number.
+   * @param midiNote The MIDI note number (0-127).
+   * @param mapping The KeyModifier to apply for this key.
+   */
+  addMapping(channel: number, midiNote: number, mapping: KeyModifier): void;
+  /**
+   * Delete a mapping for a MIDI key.
+   * @param channel The MIDI channel number.
+   * @param midiNote The MIDI note number (0-127).
+   */
+  deleteMapping(channel: number, midiNote: number): void;
+  /**
+   * Clear all key mappings.
+   */
+  clearMappings(): void;
+  /**
+   * Sets the key mappings to a new array.
+   * @param mappings A 2D array where the first dimension is the channel number and the second dimension is the MIDI note number.
+   */
+  setMappings(mappings: (KeyModifier | undefined)[][]): void;
+  /**
+   * Returns the current key mappings.
+   */
+  getMappings(): (KeyModifier | undefined)[][];
+  /**
+   * Gets the velocity override for a MIDI key.
+   * @param channel The MIDI channel number.
+   * @param midiNote The MIDI note number (0-127).
+   * @returns The velocity override, or -1 if no override is set.
+   */
+  getVelocity(channel: number, midiNote: number): number;
+  /**
+   * Gets the gain override for a MIDI key.
+   * @param channel The MIDI channel number.
+   * @param midiNote The MIDI note number (0-127).
+   * @returns The gain override, or 1 if no override is set.
+   */
+  getGain(channel: number, midiNote: number): number;
+  /**
+   * Checks if a MIDI key has an override for the patch.
+   * @param channel The MIDI channel number.
+   * @param midiNote The MIDI note number (0-127).
+   * @returns True if the key has an override patch, false otherwise.
+   */
+  hasOverridePatch(channel: number, midiNote: number): boolean;
+  /**
+   * Gets the patch override for a MIDI key.
+   * @param channel The MIDI channel number.
+   * @param midiNote The MIDI note number (0-127).
+   * @returns An object containing the bank and program numbers.
+   * @throws Error if no modifier is set for the key.
+   */
+  getPatch(channel: number, midiNote: number): MIDIPatch;
+}
+//#endregion
+//#region src/synthesizer/audio_engine/channel/channel_snapshot.d.ts
+interface DrumParameterSnapshot {
+  pitch: number;
+  gain: number;
+  exclusiveClass: number;
+  pan: number;
+  reverbGain: number;
+  chorusGain: number;
+  delayGain: number;
+  rxNoteOn: boolean;
+  rxNoteOff: boolean;
+}
+interface ChannelSnapshot {
+  patch?: MIDIPatchFull;
+  lockedSystem: MIDISystem;
+  midiControllers: Int16Array;
+  lockedControllers: boolean[];
+  pitchWheels: Int16Array;
+  generators: ChannelGenerators;
+  midiParameters: ChannelMIDIParameter;
+  lockedMIDIParameters: Record<keyof ChannelMIDIParameter, boolean>;
+  systemParameters: ChannelSystemParameter;
+  octaveTuning: Int8Array;
+  perNotePitch: boolean;
+  drumParams: DrumParameterSnapshot[];
+  drumChannel: boolean;
+  channel: number;
+}
+//#endregion
 //#region src/synthesizer/audio_engine/parameters/system.d.ts
 /**
  * The global parameters of the synthesizer.
@@ -2218,126 +2369,20 @@ interface GlobalSystemParameter {
 }
 declare const DEFAULT_GLOBAL_SYSTEM_PARAMETERS: GlobalSystemParameter;
 //#endregion
-//#region src/synthesizer/audio_engine/sound_bank_manager.d.ts
-declare class SoundBankManager {
-  /**
-   * All the sound banks, ordered from the most important to the least.
-   */
-  soundBankList: SoundBankManagerListEntry[];
-  private readonly presetListChangeCallback;
-  private selectablePresetList;
-  /**
-   * @param presetListChangeCallback Supplied by the parent synthesizer class,
-   * this is called whenever the preset list changes.
-   */
-  constructor(presetListChangeCallback: () => unknown);
-  private _presetList;
-  /**
-   * The list of all presets in the sound bank stack.
-   */
-  get presetList(): MIDIPatchFull[];
-  /**
-   * The current sound bank priority order.
-   * @returns The IDs of the sound banks in the current order.
-   */
-  get priorityOrder(): string[];
-  /**
-   * The current sound bank priority order.
-   * @param newList The new order of sound bank IDs.
-   */
-  set priorityOrder(newList: string[]);
-  /**
-   * Deletes a given sound bank by its ID.
-   * @param id the ID of the sound bank to delete.
-   */
-  deleteSoundBank(id: string): void;
-  /**
-   * Adds a new sound bank with a given ID, or replaces an existing one.
-   * @param font the sound bank to add.
-   * @param id the ID of the sound bank.
-   * @param bankOffset the bank offset of the sound bank.
-   */
-  addSoundBank(font: BasicSoundBank, id: string, bankOffset?: number): void;
-  destroy(): void;
-  private generatePresetList;
-}
-//#endregion
-//#region src/synthesizer/audio_engine/key_modifier_manager.d.ts
-declare class KeyModifier {
-  /**
-   * The new override velocity. -1 means unchanged.
-   */
-  velocity: number;
-  /**
-   * The MIDI patch this key uses. -1 on any property means unchanged.
-   */
-  patch: MIDIPatch;
-  /**
-   * Linear gain override for the voice.
-   */
-  gain: number;
-}
-declare class KeyModifierManager {
-  /**
-   * The velocity override mappings for MIDI keys
-   * stored as [channelNumber][midiNote].
-   */
-  private keyMappings;
-  /**
-   * Add a mapping for a MIDI key to a KeyModifier.
-   * @param channel The MIDI channel number.
-   * @param midiNote The MIDI note number (0-127).
-   * @param mapping The KeyModifier to apply for this key.
-   */
-  addMapping(channel: number, midiNote: number, mapping: KeyModifier): void;
-  /**
-   * Delete a mapping for a MIDI key.
-   * @param channel The MIDI channel number.
-   * @param midiNote The MIDI note number (0-127).
-   */
-  deleteMapping(channel: number, midiNote: number): void;
-  /**
-   * Clear all key mappings.
-   */
-  clearMappings(): void;
-  /**
-   * Sets the key mappings to a new array.
-   * @param mappings A 2D array where the first dimension is the channel number and the second dimension is the MIDI note number.
-   */
-  setMappings(mappings: (KeyModifier | undefined)[][]): void;
-  /**
-   * Returns the current key mappings.
-   */
-  getMappings(): (KeyModifier | undefined)[][];
-  /**
-   * Gets the velocity override for a MIDI key.
-   * @param channel The MIDI channel number.
-   * @param midiNote The MIDI note number (0-127).
-   * @returns The velocity override, or -1 if no override is set.
-   */
-  getVelocity(channel: number, midiNote: number): number;
-  /**
-   * Gets the gain override for a MIDI key.
-   * @param channel The MIDI channel number.
-   * @param midiNote The MIDI note number (0-127).
-   * @returns The gain override, or 1 if no override is set.
-   */
-  getGain(channel: number, midiNote: number): number;
-  /**
-   * Checks if a MIDI key has an override for the patch.
-   * @param channel The MIDI channel number.
-   * @param midiNote The MIDI note number (0-127).
-   * @returns True if the key has an override patch, false otherwise.
-   */
-  hasOverridePatch(channel: number, midiNote: number): boolean;
+//#region src/synthesizer/audio_engine/synthesizer_snapshot.d.ts
+interface SynthesizerSnapshot {
+  midiChannels: ChannelSnapshot[];
   /**
-   * Gets the patch override for a MIDI key.
-   * @param channel The MIDI channel number.
-   * @param midiNote The MIDI note number (0-127).
-   * @returns An object containing the bank and program numbers.
-   * @throws Error if no modifier is set for the key.
+   * Key modifiers.
    */
-  getPatch(channel: number, midiNote: number): MIDIPatch;
+  keyMappings: (KeyModifier | undefined)[][];
+  midiParameters: GlobalMIDIParameter;
+  lockedMIDIParameters: Record<keyof GlobalMIDIParameter, boolean>;
+  systemParameters: GlobalSystemParameter;
+  reverbProcessor: ReverbProcessorSnapshot;
+  chorusProcessor: ChorusProcessorSnapshot;
+  delayProcessor: DelayProcessorSnapshot;
+  insertionProcessor: InsertionProcessorSnapshot;
 }
 //#endregion
 //#region src/midi/types.d.ts
@@ -2479,49 +2524,71 @@ interface TimelineEvent {
 }
 type SysExAcceptedArray = number[] | Uint8Array | Int8Array | Uint8ClampedArray;
 //#endregion
-//#region src/synthesizer/audio_engine/channel/channel_snapshot.d.ts
-interface DrumParameterSnapshot {
-  pitch: number;
-  gain: number;
-  exclusiveClass: number;
-  pan: number;
-  reverbGain: number;
-  chorusGain: number;
-  delayGain: number;
-  rxNoteOn: boolean;
-  rxNoteOff: boolean;
-}
-interface ChannelSnapshot {
-  patch?: MIDIPatchFull;
-  lockedSystem: MIDISystem;
-  midiControllers: Int16Array;
-  lockedControllers: boolean[];
-  pitchWheels: Int16Array;
-  generators: ChannelGenerators;
-  midiParameters: ChannelMIDIParameter;
-  lockedMIDIParameters: Record<keyof ChannelMIDIParameter, boolean>;
-  systemParameters: ChannelSystemParameter;
-  octaveTuning: Int8Array;
-  perNotePitch: boolean;
-  drumParams: DrumParameterSnapshot[];
-  drumChannel: boolean;
-  channel: number;
-}
-//#endregion
-//#region src/synthesizer/audio_engine/synthesizer_snapshot.d.ts
-interface SynthesizerSnapshot {
-  midiChannels: ChannelSnapshot[];
+//#region src/midi/midi_message.d.ts
+declare class MIDIMessage {
   /**
-   * Key modifiers.
+   * Absolute number of MIDI ticks from the start of the track.
    */
-  keyMappings: (KeyModifier | undefined)[][];
-  midiParameters: GlobalMIDIParameter;
-  lockedMIDIParameters: Record<keyof GlobalMIDIParameter, boolean>;
-  systemParameters: GlobalSystemParameter;
-  reverbProcessor: ReverbProcessorSnapshot;
-  chorusProcessor: ChorusProcessorSnapshot;
-  delayProcessor: DelayProcessorSnapshot;
-  insertionProcessor: InsertionProcessorSnapshot;
+  ticks: number;
+  /**
+   * The MIDI message status byte. Note that for meta events, it is the second byte. (not 0xFF).
+   */
+  statusByte: MIDIMessageType;
+  /**
+   * Message's binary data.
+   */
+  data: Uint8Array<ArrayBuffer>;
+  /**
+   * Creates a new MIDI message.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param byte the message status byte.
+   * @param data the message's binary data.
+   */
+  constructor(ticks: number, byte: MIDIMessageType, data: Uint8Array<ArrayBuffer>);
+  /**
+   * Returns a new MIDI Pitch Wheel message.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param channel the channel number of this message.
+   * @param value the new value, between 0 and 16383, where 8192 is the center (no pitch change).
+   */
+  static pitchWheel(ticks: number, channel: number, value: number): MIDIMessage;
+  /**
+   * Returns a new MIDI Channel Pressure message.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param channel the channel number of this message.
+   * @param value the new value, between 0 and 127.
+   */
+  static channelPressure(ticks: number, channel: number, value: number): MIDIMessage;
+  /**
+   * Returns a new MIDI Program Change message.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param channel the channel number of this message.
+   * @param program the new MIDI program number, between 0 and 127.
+   */
+  static programChange(ticks: number, channel: number, program: number): MIDIMessage;
+  /**
+   * Returns a new MIDI Controller Change message.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param channel the channel number of this message.
+   * @param controller the MIDI controller.
+   * @param value the new value.
+   */
+  static controllerChange(ticks: number, channel: number, controller: MIDIController, value: number): MIDIMessage;
+  /**
+   * Returns a new MIDI System Exclusive message.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param data the data of the system exclusive message,
+   * excluding the starting 0xF0 byte.
+   */
+  static systemExclusive(ticks: number, data: number[]): MIDIMessage;
+  /**
+   * Returns a new MIDI Registered Parameter message. Sends both data MSB and LSB.
+   * @param ticks time of this message in absolute MIDI ticks.
+   * @param channel the channel number of this message.
+   * @param parameter the 14-bit MIDI registered parameter number.
+   * @param value the 14-bit new value.
+   */
+  static registeredParameter(ticks: number, channel: number, parameter: number, value: number): MIDIMessage[];
 }
 //#endregion
 //#region src/synthesizer/processor.d.ts
@@ -2625,7 +2692,14 @@ declare class SpessaSynthProcessor {
    * @param channelOffset The channel offset for the message. It will be added to message's channel number if applicable.
    * @param options Additional options for scheduling the message.
    */
-  readonly processMessage: (message: SysExAcceptedArray, channelOffset?: number, options?: SynthMethodOptions) => void;
+  readonly processMessage: (message: SysExAcceptedArray | MIDIMessage, channelOffset?: number, options?: SynthMethodOptions) => void;
+  /**
+   * Processes multiple MIDI messages and allows scheduling them at a specific time.
+   * @param message The MIDI messages to process.
+   * @param channelOffset The channel offset for the messages. It will be added to messages' channel number if applicable.
+   * @param options Additional options for scheduling the message.
+   */
+  readonly processMessages: (message: (SysExAcceptedArray | MIDIMessage)[], channelOffset?: number, options?: SynthMethodOptions) => void;
   /**
    * Core synthesis engine.
    */
@@ -3804,73 +3878,6 @@ interface WaveMetadata {
   genre: string;
 }
 //#endregion
-//#region src/midi/midi_message.d.ts
-declare class MIDIMessage {
-  /**
-   * Absolute number of MIDI ticks from the start of the track.
-   */
-  ticks: number;
-  /**
-   * The MIDI message status byte. Note that for meta events, it is the second byte. (not 0xFF).
-   */
-  statusByte: MIDIMessageType;
-  /**
-   * Message's binary data.
-   */
-  data: Uint8Array<ArrayBuffer>;
-  /**
-   * Creates a new MIDI message.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param byte the message status byte.
-   * @param data the message's binary data.
-   */
-  constructor(ticks: number, byte: MIDIMessageType, data: Uint8Array<ArrayBuffer>);
-  /**
-   * Returns a new MIDI Pitch Wheel message.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param channel the channel number of this message.
-   * @param value the new value, between 0 and 16383, where 8192 is the center (no pitch change).
-   */
-  static pitchWheel(ticks: number, channel: number, value: number): MIDIMessage;
-  /**
-   * Returns a new MIDI Channel Pressure message.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param channel the channel number of this message.
-   * @param value the new value, between 0 and 127.
-   */
-  static channelPressure(ticks: number, channel: number, value: number): MIDIMessage;
-  /**
-   * Returns a new MIDI Program Change message.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param channel the channel number of this message.
-   * @param program the new MIDI program number, between 0 and 127.
-   */
-  static programChange(ticks: number, channel: number, program: number): MIDIMessage;
-  /**
-   * Returns a new MIDI Controller Change message.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param channel the channel number of this message.
-   * @param controller the MIDI controller.
-   * @param value the new value.
-   */
-  static controllerChange(ticks: number, channel: number, controller: MIDIController, value: number): MIDIMessage;
-  /**
-   * Returns a new MIDI System Exclusive message.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param data the data of the system exclusive message,
-   * excluding the starting 0xF0 byte.
-   */
-  static systemExclusive(ticks: number, data: number[]): MIDIMessage;
-  /**
-   * Returns a new MIDI Registered Parameter message. Sends both data MSB and LSB.
-   * @param ticks time of this message in absolute MIDI ticks.
-   * @param channel the channel number of this message.
-   * @param parameter the 14-bit MIDI registered parameter number.
-   * @param value the 14-bit new value.
-   */
-  static registeredParameter(ticks: number, channel: number, parameter: number, value: number): MIDIMessage[];
-}
-//#endregion
 //#region src/midi/midi_tools/modify_midi.d.ts
 /**
  * Represents a value that means "clear this parameter" instead of "replace this parameter with".