spessasynth_core 4.4.6 → 4.4.8

package/dist/index.d.ts

@@ -31,6 +31,35 @@ export interface WaveWriteOptions {
    */
   metadata: Partial<WaveMetadata>;
 }
+/**
+ * The result of reading a WAVE file with {@link wavToAudio}.
+ *
+ * @group Utilities
+ */
+export interface WaveReadResult {
+  /**
+   * The PCM audio data, one array per channel.
+   */
+  audioData: Float32Array[];
+  /**
+   * The sample rate, in Hertz.
+   */
+  sampleRate: number;
+  /**
+   * The loop of the file, undefined if it has none.
+   * The points are in sample frames, not seconds.
+   */
+  loop?: {
+    /**
+     * The loop start, in sample frames.
+     */
+    start: number;
+    /**
+     * The loop end, in sample frames.
+     */
+    end: number;
+  };
+}
 /**
  * Metadata to write into a WAVE file.
  *
@@ -148,6 +177,25 @@ declare function readVariableLengthQuantity(midiByteArray: IndexedByteArray): nu
  * @group Utilities
  */
 export declare function audioToWav(audioData: Float32Array[], sampleRate: number, options?: Partial<WaveWriteOptions>): ArrayBuffer;
+/**
+ * Reads a WAVE file into PCM audio data, the counterpart of {@link audioToWav}.
+ *
+ * It reads 8, 16, 24 and 32-bit integer PCM and 32 and 64-bit float files (including `WAVE_FORMAT_EXTENSIBLE`).
+ * The loop is read from the first loop of the `smpl` chunk. Without one, the first two points of the `cue ` chunk
+ * are taken as the loop start and end, which is how {@link audioToWav} writes it.
+ * Other files may use cue points as plain markers, so such a loop is only reliable for files written by core.
+ *
+ * > **Note**
+ * >
+ * > The returned loop end is exclusive, like the SoundFont loop end.
+ *
+ * @param buffer The binary WAVE file.
+ * @returns The audio data (one array per channel), the sample rate and the loop, if the file has one.
+ * @throws Error if the file is not a valid or supported WAVE file.
+ *
+ * @group Utilities
+ */
+export declare function wavToAudio(buffer: ArrayBuffer): WaveReadResult;
 /**
  * SpessaSynth can print out additional info to the console or print nothing at all.
  *
@@ -353,17 +401,6 @@ export interface GeneratorLimit {
    * SoundFont2 NRPN scale factor for this generator type.
    */
   nrpn: number;
-  /**
-   * Minimum value of this generator in a preset zone.
-   * Preset generators are offsets added to the instrument, so they can go below the instrument range.
-   * If not set, it is the same as `min`.
-   */
-  presetMin?: number;
-  /**
-   * Maximum value of this generator in a preset zone.
-   * If not set, it is the same as `max`.
-   */
-  presetMax?: number;
 }
 /**
  * Limits and defaults for all the {@link BasicSoundBank} generator types.
@@ -524,6 +561,15 @@ export declare class ModulatorSource {
    * This field specifies how the minimum value approaches the maximum value.
    */
   curveType: ModulatorCurveType;
+  /**
+   * Creates a new modulator source.
+   * @param index The controller or MIDI CC number, see `isCC`.
+   * @param curveType How the minimum value approaches the maximum value.
+   * @param isCC If the index is a MIDI CC instead of a general controller.
+   * @param isBipolar If the source is bipolar (-1 to 1) instead of unipolar (0 to 1).
+   * @param isNegative If the direction of the source is flipped.
+   */
+  constructor(index?: ModulatorSourceIndex, curveType?: ModulatorCurveType, isCC?: boolean, isBipolar?: boolean, isNegative?: boolean);
   private get sourceName();
   private get curveTypeName();
   toString(): string;
@@ -1090,6 +1136,7 @@ export declare class BasicSoundBank {
    * @param options Options associated with setting the sample format.
    * @returns The samples whose sample rate or loop points changed.
    * Compressing resamples samples outside 8000 to 96000 Hz.
+   * @throws Error if `rejectOnFailure` is set and one of the samples has failed to compress.
    */
   setSampleFormat(options: SetSampleFormatOptions): Promise<BasicSample[]>;
   /**
@@ -1187,8 +1234,10 @@ export declare class BasicSoundBank {
   clonePreset(preset: BasicPreset, options?: Partial<SoundBankCloneOptions>): BasicPreset;
   /**
    * Updates internal values. Call after updating the preset list.
+   * @param sort If the presets should be sorted. Set it to `false` to keep a custom order,
+   * only the internal values (like {@link isXGBank}) are then recomputed.
    */
-  flush(): void;
+  flush(sort?: boolean): void;
   /**
    * Trims the sound bank _in-place_ to only contain samples in a given MIDI file.
    *
@@ -1236,6 +1285,7 @@ export declare class BasicSoundBank {
    * Deletes everything irreversibly.
    */
   destroySoundBank(): void;
+  protected addElements<T>(list: T[], elements: readonly T[]): void;
   protected parsingError(error: string): never;
   /**
    * Parses the bank after loading is done
@@ -1254,16 +1304,6 @@ interface LinkableZoneChild<P> {
    * The element's name.
    */
   name: string;
-  /**
-   * Links the element to a parent.
-   * @param parent The parent that uses the element.
-   */
-  linkTo(parent: P): void;
-  /**
-   * Unlinks the element from a parent.
-   * @param parent The parent that no longer uses the element.
-   */
-  unlinkFrom(parent: P): void;
 }
 /**
  * A zone that belongs to a parent and uses a child: a preset zone with its instrument,
@@ -1297,6 +1337,15 @@ export declare abstract class BasicLinkedZone<P, C extends LinkableZoneChild<P>>
    * @param link If the child should be linked to the parent.
    */
   protected constructor(parent: P, child: C, link: boolean);
+  /**
+   * Links the child to the parent, unless this zone was created without linking.
+   * Use it to put a zone back after {@link unlinkChild}, for example when undoing a zone deletion.
+   */
+  linkChild(): void;
+  /**
+   * Unlinks the child from the parent, unless this zone was created without linking.
+   */
+  unlinkChild(): void;
   /**
    * Replaces the child, moving the link from the previous one to the new one.
    * @param child The new child.
@@ -1378,11 +1427,6 @@ export declare class BasicInstrument {
    * > An instrument with unlinked zones must not be added to a sound bank!
    */
   createZone(sample: BasicSample, link?: boolean): BasicInstrumentZone;
-  /**
-   * Unlinks the instrument from a given preset.
-   * @param preset The preset to unlink from.
-   */
-  unlinkFrom(preset: BasicPreset): void;
   /**
    * Unlinks everything from this instrument.
    * This is what {@link BasicSoundBank.deleteInstrument} calls, the instrument itself stays intact.
@@ -1549,6 +1593,12 @@ export declare class BasicSample {
    * How many instruments is this sample used by.
    */
   get useCount(): number;
+  /**
+   * If the decoded float data is currently held in memory.
+   * Check it before {@link getAudioData} to know if the call has to decode,
+   * then use {@link releaseDecoded} to drop the copy again.
+   */
+  get isDecoded(): boolean;
   /**
    * Get raw data for writing the file, either a compressed bit stream or signed 16-bit little endian PCM data.
    * @param allowVorbis if vorbis file data is allowed.
@@ -1603,11 +1653,6 @@ export declare class BasicSample {
    * @param type Either left, right or linked. The linked sample will be set appropriately as well.
    */
   setLinkedSample(sample: BasicSample, type: SampleType): void;
-  /**
-   * Unlinks the sample from a given instrument
-   * @param instrument the instrument to unlink from
-   */
-  unlinkFrom(instrument: BasicInstrument): void;
   /**
    * Get the PCM Float32 audio data of this sample.
    * This either decodes the compressed data or passes the ready sampleData.
@@ -2216,6 +2261,13 @@ export type SetSampleFormatOptions = {
    * It must be provided if `compressed` format is chosen.
    */
   compressionFunction: SampleEncodingFunction;
+  /**
+   * If the returned promise should reject when a sample fails to compress.
+   * By default, such a sample is left uncompressed (and a warning is logged),
+   * but the bank is still set to version 3.0.
+   * With this on, the method throws after trying every sample and the bank's version stays the same.
+   */
+  rejectOnFailure?: boolean;
 });
 /**
  * Options for writing a sound bank file.
@@ -2361,11 +2413,15 @@ export interface SoundBankCloneOptions {
    */
   reuseByName: boolean;
   /**
-   * If the instruments and samples used by a cloned element are reused when one with the same name exists.
-   * When false, they are copied under a free name as well.
+   * How the instruments and samples used by a cloned element are reused instead of copied.
+   * - `name` - reuse the first element in the bank with the same name.
+   * - `identity` - reuse the element itself if it is already in the bank.
+   *   Use it to duplicate elements within one bank, as names often repeat in real banks.
+   * - `none` - always copy them, under a free name if needed.
+   *
    * A stereo partner of a copied sample is always copied with it.
    */
-  reuseChildrenByName: boolean;
+  reuseChildren: "name" | "identity" | "none";
   /**
    * If the new elements are added to the bank.
    * When false, they are only listed in {@link SoundBankCloner.created}.
@@ -2877,6 +2933,14 @@ export interface GSInsertionParameter {
    * Higher values result in more sound being sent.
    */
   sendLevelToDelay: number;
+  /**
+   * EFX send EQ switch: routes the insertion output through the equalizer (see {@link GSEqualizerProcessor})
+   * when on, or straight to the output when off.
+   * Default is `true` (on).
+   *
+   * In the SysEx message, `0` is off and any other value is on.
+   */
+  sendEQSwitch: boolean;
   /**
    * `0-127`
    *
@@ -2937,7 +3001,8 @@ export interface GSInsertionBlockSnapshot extends GSInsertionParameter {
 }
 /**
  * The Insertion effect (EFX) processes the parts (channels) that have EFX assigned
- * (see {@link ChannelMIDIParameter.efxAssign}) and is routed straight to the output.
+ * (see {@link ChannelMIDIParameter.efxAssign}) and is routed to the output,
+ * through the equalizer unless {@link GSInsertionParameter.sendEQSwitch} is off.
  * It can additionally send its output to the reverb, chorus and delay.
  *
  * This is a Roland GS-compatible insertion interface.
@@ -2962,7 +3027,7 @@ export interface GSInsertionBlock extends GSInsertionParameter {
   /**
    * Sets the EFX type of the block.
    *
-   * Type change resets the parameters and the send levels to their defaults.
+   * Type change resets the parameters, the send levels and the send EQ switch to their defaults.
    * The EFX control sources and depths are kept.
    * Behavior for unsupported types is up to the implementation.
    *
@@ -3015,6 +3080,93 @@ export interface GSInsertionBlock extends GSInsertionParameter {
    */
   applySnapshot(snapshot: GSInsertionBlockSnapshot): void;
 }
+/**
+ * GS-compatible equalizer parameters.
+ *
+ * Also see {@link GSEqualizerProcessor} to see how to implement a custom GS-compatible equalizer processor.
+ *
+ * @group Synthesizer.GS Effects
+ */
+export interface GSEqualizerParameter {
+  /**
+   * 0-1
+   * 200 Hz, 400 Hz
+   * This parameter sets the frequency of the low range shelf.
+   */
+  lowFrequency: number;
+  /**
+   * 52-76 (`0x34`-`0x4C`)
+   * -12 dB - 0 dB - +12 dB
+   * This parameter sets the amount of boost or cut for the low frequency range.
+   * 64 is 0 dB, each step is 1 dB.
+   */
+  lowGain: number;
+  /**
+   * 0-1
+   * 3 kHz, 6 kHz
+   * This parameter sets the frequency of the high range shelf.
+   */
+  highFrequency: number;
+  /**
+   * 52-76 (`0x34`-`0x4C`)
+   * -12 dB - 0 dB - +12 dB
+   * This parameter sets the amount of boost or cut for the high frequency range.
+   * 64 is 0 dB, each step is 1 dB.
+   */
+  highGain: number;
+}
+/**
+ * The equalizer is a two-band (low and high) shelving equalizer which boosts or cuts specified frequency
+ * ranges of the sound. An equalizer lets you
+ * boost or cut specified frequency ranges of a sound to adjust the tone. For each range,
+ * high and low, you can specify the frequency and the amount of boost or cut (gain).
+ *
+ * Only the parts with EQ enabled (see {@link ChannelMIDIParameter.eqEnabled}) pass through it,
+ * and the insertion effect passes through it when {@link GSInsertionParameter.sendEQSwitch} is on.
+ * The reverb, chorus and delay outputs do not.
+ *
+ * This is a Roland GS-compatible equalizer interface.
+ *
+ * It is used when {@link GlobalMIDIParameter.system} is `gm` `gm2` or `gs`.
+ *
+ * > **Note**
+ * >
+ * > The equalizer is disabled in XG mode.
+ *
+ * {@link SpessaSynthProcessor} allows you to supply a custom equalizer processor.
+ * A custom equalizer processor must implement this interface.
+ *
+ * ### Editing the parameters
+ *
+ * Editing the parameters can be done via GS system exclusive messages.
+ *
+ * > **Tip**
+ * >
+ * > Refer to [SC-8850 Owner's Manual](https://cdn.roland.com/assets/media/pdf/SC-8850_OM.pdf) (p.78, 86, 236) for more information.
+ *
+ * @group Synthesizer.GS Effects
+ */
+export interface GSEqualizerProcessor extends GSEqualizerParameter {
+  /**
+   * Process the effect and **adds** it to the output.
+   * @param inputLeft The left input buffer to process. It always starts at index 0.
+   * @param inputRight The right input buffer to process. It always starts at index 0.
+   * @param outputLeft The left output buffer.
+   * @param outputRight The right output buffer.
+   * @param startIndex The index to start mixing at into the output buffers.
+   * @param sampleCount The amount of samples to mix. This will never be larger than {@link SynthProcessorOptions.maxBufferSize} of the parent {@link SpessaSynthProcessor} instance.
+   */
+  process(inputLeft: Float32Array, inputRight: Float32Array, outputLeft: Float32Array, outputRight: Float32Array, startIndex: number, sampleCount: number): void;
+  /**
+   * Gets a snapshot of this effect processor instance.
+   */
+  getSnapshot(): GSEqualizerParameter;
+  /**
+   * Restores this effect processor instance from a snapshot.
+   * @param snapshot The snapshot to restore.
+   */
+  applySnapshot(snapshot: GSEqualizerParameter): void;
+}
 /**
  * A snapshot of a {@link XGEffectBlock}.
  *
@@ -3482,6 +3634,17 @@ interface GlobalSystemParameter {
    * the delay parameters then locking it to prevent changes by MIDI files.
    */
   gsDelayLock: boolean;
+  /**
+   * If the synthesizer should prevent editing of the GS equalizer parameters.
+   * This effect is modified using MIDI system exclusive messages, so
+   * the recommended use case would be setting
+   * the equalizer parameters then locking it to prevent changes by MIDI files.
+   *
+   * > **Warning**
+   * >
+   * > To lock the channel equalizer switch, lock the {@link ChannelMIDIParameter.eqEnabled `eqEnabled`} parameter instead.
+   */
+  gsEqualizerLock: boolean;
   /**
    * The XG variation gain when in system mode. {@link XGVariationConnection}
    * From 0 to any number. 1 is 100% variation.
@@ -3624,6 +3787,7 @@ export declare class SoundBankManager {
    */
   soundBankList: SoundBankManagerListEntry[];
   private readonly presetListChangeCallback;
+  private readonly bankRemovedCallback?;
   private selectablePresetList;
   private _presetList;
   /**
@@ -3653,17 +3817,21 @@ export declare class SoundBankManager {
   /**
    * This method removes a sound bank with a given ID from the sound bank list.
    * @param id The ID of the sound bank to delete.
+   * @param reset If the synthesizer should reset (put every channel's controllers back to defaults) after the change.
+   * Set it to `false` to keep a song playing, the channels then only update to the new presets.
    * @throws Error An error if there's no sound bank with the given ID.
    */
-  deleteSoundBank(id: string): void;
+  deleteSoundBank(id: string, reset?: boolean): void;
   /**
    * Adds a new sound bank with a given ID, or replaces an existing one.
    * @param bank The sound bank to add.
    * @param id The unique ID to assign to the sound bank.
    * If a sound bank with this ID already exists, it will be replaced.
    * @param bankOffset The bank offset of the sound bank. Offsets the bank MSB value of all presets in this sound bank.
+   * @param reset If the synthesizer should reset (put every channel's controllers back to defaults) after the change.
+   * Set it to `false` to keep a song playing, the channels then only update to the new presets.
    */
-  addSoundBank(bank: BasicSoundBank, id: string, bankOffset?: number): void;
+  addSoundBank(bank: BasicSoundBank, id: string, bankOffset?: number, reset?: boolean): void;
   /**
    * Rebuilds the preset list from the current sound banks.
    * Call it after editing a sound bank that is already added,
@@ -3673,6 +3841,7 @@ export declare class SoundBankManager {
    * see {@link SpessaSynthProcessor.refreshPresets}.
    */
   refresh(): void;
+  private bankRemoved;
   private generatePresetList;
 }
 /**
@@ -3934,6 +4103,10 @@ interface SynthesizerSnapshot {
    * A snapshot of the delay processor.
    */
   gsDelayProcessor: GSDelayParameter;
+  /**
+   * A snapshot of the equalizer processor.
+   */
+  gsEqualizerProcessor: GSEqualizerParameter;
   /**
    * A snapshot of the GS insertion block.
    */
@@ -4004,10 +4177,6 @@ export declare class SpessaSynthProcessor {
    * All MIDI channels of the synthesizer.
    */
   readonly midiChannels: MIDIChannel[];
-  /**
-   * The sound bank manager, which manages all sound banks and presets.
-   */
-  readonly soundBankManager: SoundBankManager;
   /**
    * The sample rate, in Hertz.
    */
@@ -4036,6 +4205,10 @@ export declare class SpessaSynthProcessor {
    * @param event The event that occurred.
    */
   onEventCall?: (event: SynthesizerEventCallback) => unknown;
+  /**
+   * The sound bank manager, which manages all sound banks and presets.
+   */
+  readonly soundBankManager: SoundBankManager;
   /**
    * Left float32 buffer for processing XG insertion effects in-place.
    * (channel outputs are double precision)
@@ -4509,6 +4682,25 @@ export type GSDelayParameterMessage = { [P in keyof GSDelayParameter]: {
    */
   value: number;
 };
+/**
+ * Represents an analyzed GS Equalizer Processor change.
+ *
+ * @group MIDI.Protocol
+ */
+export type GSEqualizerParameterMessage = { [P in keyof GSEqualizerParameter]: {
+  /**
+   * The message type identifier.
+   */
+  type: "GS Equalizer Param";
+  /**
+   * The GS equalizer parameter being modified.
+   */
+  parameter: P;
+  /**
+   * The new value of the GS equalizer parameter.
+   */
+  value: GSEqualizerParameter[P];
+}; }[keyof GSEqualizerParameter];
 /**
  * Represents an analyzed GS Insertion Processor change.
  *
@@ -4535,11 +4727,24 @@ export type GSInsertionParameterMessage = {
   /**
    * The parameter name that was modified in the processor: a send level or an EFX control setting.
    */
-  parameter: keyof GSInsertionParameter;
+  parameter: Exclude<keyof GSInsertionParameter, "sendEQSwitch">;
   /**
    * The new value of the parameter.
    */
   value: number;
+} | {
+  /**
+   * An insertion effect processor parameter message (Roland GS).
+   */
+  type: "GS Insertion Param";
+  /**
+   * The send EQ switch, see {@link GSInsertionParameter.sendEQSwitch}.
+   */
+  parameter: "sendEQSwitch";
+  /**
+   * If the insertion output goes through the equalizer.
+   */
+  value: boolean;
 } | {
   /**
    * An insertion effect processor parameter message (Roland GS).
@@ -4884,7 +5089,7 @@ export type AnalyzedParameter = {
  *
  * @group MIDI.Protocol
  */
-export type AnalyzedMIDIMessage = AnalyzedParameter | GSReverbParameterMessage | GSChorusParameterMessage | GSDelayParameterMessage | GSInsertionParameterMessage | XGReverbParameterMessage | XGChorusParameterMessage | XGVariationParameterMessage | XGInsertionParameterMessage | {
+export type AnalyzedMIDIMessage = AnalyzedParameter | GSReverbParameterMessage | GSChorusParameterMessage | GSDelayParameterMessage | GSEqualizerParameterMessage | GSInsertionParameterMessage | XGReverbParameterMessage | XGChorusParameterMessage | XGVariationParameterMessage | XGInsertionParameterMessage | {
   /**
    * A MIDI program change message configured via System Exclusive.
    */
@@ -5111,6 +5316,7 @@ export type FXType<K> = Exclude<keyof K, "process" | "getSnapshot" | "applySnaps
  * - {@link GSReverbProcessor} (`effect: "gsReverb"`)
  * - {@link GSChorusProcessor} (`effect: "gsChorus"`)
  * - {@link GSDelayProcessor} (`effect: "gsDelay"`)
+ * - {@link GSEqualizerProcessor} (`effect: "gsEqualizer"`)
  * - {@link GSInsertionBlock} (`effect: "gsInsertion"`)
  * - {@link XGReverbBlock} (`effect: "xgReverb"`)
  * - {@link XGChorusBlock} (`effect: "xgChorus"`)
@@ -5159,6 +5365,19 @@ export type EffectChangeEvent = {
    * The new 7-bit value.
    */
   value: number;
+} | {
+  /**
+   * The effect that was changed: Roland GS equalizer.
+   */
+  effect: "gsEqualizer";
+  /**
+   * The parameter, see {@link GSEqualizerParameter}.
+   */
+  parameter: keyof GSEqualizerParameter;
+  /**
+   * The new 7-bit value.
+   */
+  value: number;
 } | {
   /**
    * The effect that was changed: Roland GS insertion.
@@ -5171,11 +5390,24 @@ export type EffectChangeEvent = {
    * - `"controlSource1" | "controlDepth1" | "controlSource2" | "controlDepth2"` - EFX control (7-bit), see {@link GSInsertionParameter}.
    * - `number` - 0-based type-specific EFX parameter index (0-19). EFX parameter 1 is 0. Value is 7-bit.
    */
-  parameter: "type" | keyof GSInsertionParameter | number;
+  parameter: "type" | Exclude<keyof GSInsertionParameter, "sendEQSwitch"> | number;
   /**
    * The new value for the parameter.
    */
   value: number;
+} | {
+  /**
+   * The effect that was changed: Roland GS insertion.
+   */
+  effect: "gsInsertion";
+  /**
+   * The send EQ switch, see {@link GSInsertionParameter.sendEQSwitch}.
+   */
+  parameter: "sendEQSwitch";
+  /**
+   * If the insertion output goes through the equalizer.
+   */
+  value: boolean;
 } | {
   /**
    * The effect that was changed: Yamaha XG reverb block.
@@ -5820,6 +6052,10 @@ export interface SynthProcessorOptions {
    * Optional custom GS delay processor for the synthesizer. Leave undefined to use {@link DefaultGSDelay}.
    */
   gsDelayProcessor?: GSDelayProcessor;
+  /**
+   * Optional custom GS equalizer processor for the synthesizer. Leave undefined to use {@link DefaultGSEqualizer}.
+   */
+  gsEqualizerProcessor?: GSEqualizerProcessor;
   /**
    * Optional custom GS insertion block for the synthesizer. Leave undefined to use {@link DefaultGSInsertion}.
    */
@@ -6082,6 +6318,16 @@ interface ChannelMIDIParameter {
    * Indicates whether this channel uses the GS insertion EFX processor.
    */
   efxAssign: boolean;
+  /**
+   * Indicates whether this channel passes through the GS equalizer (see {@link GSEqualizerProcessor}).
+   * Default is `true`, like on the Sound Canvas.
+   *
+   * > **Note**
+   * >
+   * > Channels with {@link efxAssign} enabled ignore this.
+   * > Their equalizer routing is set by {@link GSInsertionParameter.sendEQSwitch} instead.
+   */
+  eqEnabled: boolean;
   /**
    * CC1 for GS controller matrix.
    * An arbitrary MIDI controller, which can be bound to any synthesis parameter.
@@ -6350,6 +6596,12 @@ interface ModifyMIDIOptions {
    * - {@link GSDelayParameter} - clear + the new parameters are set via System Exclusive messages.
    */
   gsDelayParams?: ClearableParameter<GSDelayParameter>;
+  /**
+   * The GS equalizer parameters.
+   * - `"clear"` - all existing parameter change MIDI messages are cleared.
+   * - {@link GSEqualizerParameter} - clear + the new parameters are set via System Exclusive messages.
+   */
+  gsEqualizerParams?: ClearableParameter<GSEqualizerParameter>;
   /**
    * The GS Insertion Effect parameters.
    * - `"clear"` - all existing parameter change MIDI messages are cleared.
@@ -7515,15 +7767,23 @@ export declare class MIDIUtils {
   static setGSDelayParameter<P extends GSDelayParameterMessage["parameter"]>(ticks: number, parameter: P, value: Extract<GSDelayParameterMessage, {
     parameter: P;
   }>["value"]): MIDIMessage;
+  /**
+   * Returns a MIDI event needed to set the given GS Equalizer Parameter.
+   * @param ticks The MIDI tick time for the output event.
+   * @param parameter The parameter to set.
+   * @param value The value to set it to.
+   * @returns The {@link MIDIMessage} needed to set this GS Equalizer Parameter.
+   */
+  static setGSEqualizerParameter(ticks: number, parameter: GSEqualizerParameterMessage["parameter"], value: number): MIDIMessage;
   /**
    * Returns a MIDI event needed to set the given GS Insertion Parameter.
    * @param ticks The MIDI tick time for the output event.
    * @param parameter The parameter to set: `"type"`, a send level or EFX control name (see {@link GSInsertionParameter}),
    * or a 0-based effect-specific parameter number (0-19).
-   * @param value The value to set it to.
+   * @param value The value to set it to. A boolean for `"sendEQSwitch"`.
    * @returns The {@link MIDIMessage} needed to set this GS Insertion Parameter.
    */
-  static setGSInsertionParameter(ticks: number, parameter: GSInsertionParameterMessage["parameter"], value: number): MIDIMessage;
+  static setGSInsertionParameter(ticks: number, parameter: GSInsertionParameterMessage["parameter"], value: number | boolean): MIDIMessage;
   /**
    * Returns a MIDI event needed to set the given XG Reverb Parameter.
    * @param ticks The MIDI tick time for the output event.
@@ -8325,6 +8585,47 @@ export declare class DefaultGSDelay implements GSDelayProcessor {
   private updateDelayTimes;
   private updateGain;
 }
+/**
+ * The default GS Equalizer implementation for {@link SpessaSynthProcessor}.
+ *
+ * @group Synthesizer.GS Effects
+ */
+export declare class DefaultGSEqualizer implements GSEqualizerProcessor {
+  private readonly sampleRate;
+  private lowB0;
+  private lowB1;
+  private lowA1;
+  private highB0;
+  private highB1;
+  private highA1;
+  private lowZL;
+  private lowZR;
+  private highZL;
+  private highZR;
+  /**
+   * Constructs a new default GS equalizer processor.
+   * @param sampleRate The sample rate, in Hertz.
+   */
+  constructor(sampleRate: number);
+  private _lowFrequency;
+  get lowFrequency(): number;
+  set lowFrequency(value: number);
+  private _lowGain;
+  get lowGain(): number;
+  set lowGain(value: number);
+  private _highFrequency;
+  get highFrequency(): number;
+  set highFrequency(value: number);
+  private _highGain;
+  get highGain(): number;
+  set highGain(value: number);
+  process(inputLeft: Float32Array, inputRight: Float32Array, outputLeft: Float32Array, outputRight: Float32Array, startIndex: number, sampleCount: number): void;
+  getSnapshot(): GSEqualizerParameter;
+  applySnapshot(snapshot: GSEqualizerParameter): void;
+  private getBand;
+  private updateLow;
+  private updateHigh;
+}
 /**
  * The default implementation for {@link GSInsertionBlock}.
  *
@@ -8335,6 +8636,7 @@ export declare class DefaultGSInsertion implements GSInsertionBlock {
   sendLevelToReverb: number;
   sendLevelToChorus: number;
   sendLevelToDelay: number;
+  sendEQSwitch: boolean;
   controlSource1: number;
   controlDepth1: number;
   controlSource2: number;
@@ -8484,6 +8786,19 @@ export declare class SoundBankCloner {
    * @param options The options for this session.
    */
   constructor(bank: BasicSoundBank, options?: Partial<SoundBankCloneOptions>);
+  private get ownReuse();
+  /**
+   * Gets the clone this session made of an element.
+   * @param source The sample or instrument that was cloned.
+   * @returns The clone, or undefined if the session has not cloned the element.
+   */
+  getClone(source: BasicSample): BasicSample | undefined;
+  /**
+   * Gets the clone this session made of an element.
+   * @param source The sample or instrument that was cloned.
+   * @returns The clone, or undefined if the session has not cloned the element.
+   */
+  getClone(source: BasicInstrument): BasicInstrument | undefined;
   /**
    * Clones a sample and its stereo partner.
    * The data is shared with the original, not copied.
@@ -8505,6 +8820,10 @@ export declare class SoundBankCloner {
   clonePreset(preset: BasicPreset): BasicPreset;
   private copyInstrument;
   private copySample;
+  /**
+   * Finds the element to use instead of a copy, if the options allow one.
+   */
+  private findReused;
   private getFreeName;
 }
 /**