smplr 0.10.3 → 0.11.1

package/README.md

@@ -68,7 +68,7 @@ You can import directly from the browser. For example:
     <button id="btn">play</button>
   </body>
   <script type="module">
-    import { SplendidGrandPiano } from "https://unpkg.com/smplr@0.10.0/dist/index.mjs"; // needs to be a url
+    import { SplendidGrandPiano } from "https://unpkg.com/smplr/dist/index.mjs"; // needs to be a url
     const context = new AudioContext(); // create the audio context
     const marimba = new SplendidGrandPiano(context); // create and load the instrument
 
@@ -114,6 +114,18 @@ const piano = await new SplendidGrandPiano(context).load;
 
 ⚠️ In versions lower than 0.8.0 a `loaded()` function was exposed instead.
 
+#### Shared configuration options
+
+All instruments share some configuration options that are passed as second argument of the constructor. As it name implies, all fields are optional:
+
+- `volume`: A number from 0 to 127 representing the instrument global volume. 100 by default
+- `destination`: An `AudioNode` that is the output of the instrument. `AudioContext.destination` is used by default
+- `volumeToGain`: a function to convert the volume to gain. It uses MIDI standard as default.
+- `scheduleLookaheadMs`: the lookahead of the scheduler. If the start time of the note is less than current time plus this lookahead time, the note will be started. 200ms by default.
+- `scheduleIntervalMs`: the interval of the scheduler. 50ms by default.
+- `onStart`: a function that is called when starting a note. It receives the note started as parameter. Bear in mind that the time this function is called is not precise, and it's determined by lookahead.
+- `onEnded`: a function that is called when the note ends. It receives the started note as parameter.
+
 ### Play
 
 #### Start and stop notes
@@ -190,7 +202,20 @@ piano.output.setVolume(80);
 
 #### Events
 
-You can add a `onEnded` callback that will be invoked when the note ends:
+Two events are supported `onStart` and `onEnded`. Both callbacks will receive as parameter started note.
+
+Events can be configured globally:
+
+```js
+const context = new AudioContext();
+const sampler = new Sample(context, {
+  onStart: (note) => {
+    console.log(note.time, context.currentTime);
+  },
+});
+```
+
+or per note basis:
 
 ```js
 piano.start({
@@ -202,7 +227,9 @@ piano.start({
 });
 ```
 
-The callback will receive as parameter the same object you pass to the `start` function;
+Global callbacks will be invoked regardless of whether local events are defined.
+
+⚠️ The invocation time of `onStart` is not exact. It triggers slightly before the actual start time and is influenced by the `scheduleLookaheadMs` parameter.
 
 ### Effects
 

package/dist/index.d.mts

@@ -3,7 +3,7 @@ type AudioInsert = {
     output: AudioNode;
 };
 
-type ChannelOptions = {
+type ChannelConfig = {
     destination: AudioNode;
     volume: number;
     volumeToGain: (volume: number) => number;
@@ -18,7 +18,7 @@ declare class Channel {
     readonly context: BaseAudioContext;
     readonly setVolume: (vol: number) => void;
     readonly input: AudioNode;
-    constructor(context: BaseAudioContext, options: Partial<ChannelOptions>);
+    constructor(context: BaseAudioContext, options?: Partial<ChannelConfig>);
     addInsert(effect: AudioNode | AudioInsert): void;
     addEffect(name: string, effect: AudioNode | {
         input: AudioNode;
@@ -27,28 +27,56 @@ declare class Channel {
     disconnect(): void;
 }
 
-type StorageResponse = {
+type StorageResponse$1 = {
     readonly status: number;
     arrayBuffer(): Promise<ArrayBuffer>;
     json(): Promise<any>;
     text(): Promise<string>;
 };
-type Storage = {
-    fetch: (url: string) => Promise<StorageResponse>;
+type Storage$1 = {
+    fetch: (url: string) => Promise<StorageResponse$1>;
 };
-declare const HttpStorage: Storage;
-declare class CacheStorage implements Storage {
+declare const HttpStorage: Storage$1;
+declare class CacheStorage implements Storage$1 {
     #private;
     constructor(name?: string);
-    fetch(url: string): Promise<StorageResponse>;
+    fetch(url: string): Promise<StorageResponse$1>;
 }
 
+type AudioBuffers$1 = Record<string | number, AudioBuffer | undefined>;
+/**
+ * A function that downloads audio into a AudioBuffers
+ */
+type AudioBuffersLoader$1 = (context: BaseAudioContext, buffers: AudioBuffers$1) => Promise<void>;
+
+type StorageResponse = {
+    readonly status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    json(): Promise<any>;
+    text(): Promise<string>;
+};
+type Storage = {
+    fetch: (url: string) => Promise<StorageResponse>;
+};
+
 type AudioBuffers = Record<string | number, AudioBuffer | undefined>;
 /**
  * A function that downloads audio into a AudioBuffers
  */
 type AudioBuffersLoader = (context: BaseAudioContext, buffers: AudioBuffers) => Promise<void>;
 
+type SamplerConfig$1 = {
+    storage?: Storage;
+    detune: number;
+    volume: number;
+    velocity: number;
+    decayTime?: number;
+    lpfCutoffHz?: number;
+    destination: AudioNode;
+    buffers: Record<string | number, string | AudioBuffers> | AudioBuffersLoader;
+    volumeToGain: (volume: number) => number;
+};
+
 /**
  * A function to unsubscribe from an event or control
  */
@@ -66,7 +94,7 @@ type Subscribe<T> = (listener: Listener<T>) => Unsubscribe;
  * @private
  */
 type InternalPlayer = {
-    readonly buffers: AudioBuffers;
+    readonly buffers: AudioBuffers$1;
     readonly context: BaseAudioContext;
     start(sample: SampleStart): (time?: number) => void;
     stop(sample?: SampleStop): void;
@@ -91,6 +119,7 @@ type SampleStart = {
     name?: string;
     note: string | number;
     onEnded?: (sample: SampleStart) => void;
+    onStart?: (sample: SampleStart) => void;
     stop?: Subscribe<number>;
     stopId?: string | number;
     time?: number;
@@ -185,17 +214,28 @@ type RegionGroup = {
     sample: Partial<SampleOptions>;
 };
 
+type QueuedPlayerConfig = {
+    scheduleLookaheadMs: number;
+    scheduleIntervalMs: number;
+    onStart?: (sample: SampleStart) => void;
+    onEnded?: (sample: SampleStart) => void;
+};
+
+type DefaultPlayerConfig = ChannelConfig & SamplerConfig$1 & QueuedPlayerConfig;
+
 declare function getDrumMachineNames(): string[];
-type DrumMachineConfig = ChannelOptions & SampleOptions & {
+type DrumMachineConfig = {
     instrument: string;
-    storage?: Storage;
+    url: string;
+    storage: Storage$1;
 };
+type DrumMachineOptions = Partial<DrumMachineConfig & DefaultPlayerConfig>;
 declare class DrumMachine {
     #private;
     private readonly player;
     readonly load: Promise<this>;
     readonly output: OutputChannel;
-    constructor(context: AudioContext, options?: Partial<DrumMachineConfig>);
+    constructor(context: AudioContext, options?: DrumMachineOptions);
     loaded(): Promise<this>;
     get sampleNames(): string[];
     getVariations(name: string): string[];
@@ -277,7 +317,7 @@ type WebsfzRegion = {
  */
 type SfzSamplerConfig = {
     instrument: SfzInstrument | Websfz | string;
-    storage?: Storage;
+    storage?: Storage$1;
     destination: AudioNode;
     volume: number;
     velocity: number;
@@ -291,7 +331,7 @@ declare class SfzSampler {
     readonly options: Readonly<Partial<SfzSamplerConfig>>;
     private readonly player;
     readonly load: Promise<this>;
-    constructor(context: AudioContext, options: Partial<SfzSamplerConfig> & Pick<SfzSamplerConfig, "instrument">);
+    constructor(context: AudioContext, options: Partial<SfzSamplerConfig & DefaultPlayerConfig> & Pick<SfzSamplerConfig, "instrument">);
     get output(): OutputChannel;
     loaded(): Promise<this>;
     start(sample: SampleStart | string | number): void;
@@ -310,12 +350,12 @@ declare class ElectricPiano extends SfzSampler {
 }
 
 declare function getVersilianInstruments(): Promise<string[]>;
-declare function VcslInstrumentLoader(instrument: string, buffers: AudioBuffers, group: RegionGroup): (context: BaseAudioContext, storage: Storage) => Promise<void[]>;
+declare function VcslInstrumentLoader(instrument: string, buffers: AudioBuffers$1, group: RegionGroup): (context: BaseAudioContext, storage: Storage$1) => Promise<void[]>;
 type VersilianConfig = {
     instrument: string;
-    storage: Storage;
+    storage: Storage$1;
 };
-type VersilianOptions = Partial<VersilianConfig & SampleOptions & ChannelOptions>;
+type VersilianOptions = Partial<VersilianConfig & DefaultPlayerConfig>;
 /**
  * Versilian
  *
@@ -328,7 +368,7 @@ declare class Versilian implements InternalPlayer {
     private config;
     constructor(context: BaseAudioContext, options?: VersilianOptions);
     get output(): OutputChannel;
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     get context(): BaseAudioContext;
     start(sample: SampleStart | string | number): (time?: number | undefined) => void;
     stop(sample?: SampleStop | string | number): void;
@@ -344,9 +384,9 @@ declare const NAME_TO_PATH: Record<string, string | undefined>;
 declare function getMellotronNames(): string[];
 type MellotronConfig = {
     instrument: string;
-    storage: Storage;
+    storage: Storage$1;
 };
-type MellotronOptions = Partial<SampleOptions & ChannelOptions & MellotronConfig>;
+type MellotronOptions = Partial<MellotronConfig & DefaultPlayerConfig>;
 declare class Mellotron implements InternalPlayer {
     readonly context: BaseAudioContext;
     private readonly config;
@@ -354,7 +394,7 @@ declare class Mellotron implements InternalPlayer {
     private readonly group;
     readonly load: Promise<this>;
     constructor(context: BaseAudioContext, options: MellotronOptions);
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     get output(): OutputChannel;
     start(sample: SampleStart | string | number): (time?: number | undefined) => void;
     stop(sample?: SampleStop | string | number): void;
@@ -374,14 +414,14 @@ declare class Reverb {
 }
 
 type SamplerConfig = {
-    storage?: Storage;
+    storage?: Storage$1;
     detune: number;
     volume: number;
     velocity: number;
     decayTime?: number;
     lpfCutoffHz?: number;
     destination: AudioNode;
-    buffers: Record<string | number, string | AudioBuffers> | AudioBuffersLoader;
+    buffers: Record<string | number, string | AudioBuffers$1> | AudioBuffersLoader$1;
     volumeToGain: (volume: number) => number;
 };
 /**
@@ -405,9 +445,9 @@ declare class Sampler {
 declare function getSmolkenNames(): string[];
 type SmolkenConfig = {
     instrument: string;
-    storage: Storage;
+    storage: Storage$1;
 };
-type SmolkenOptions = Partial<SmolkenConfig & SampleOptions & ChannelOptions>;
+type SmolkenOptions = Partial<SmolkenConfig & DefaultPlayerConfig>;
 declare class Smolken implements InternalPlayer {
     private readonly player;
     private readonly group;
@@ -416,7 +456,7 @@ declare class Smolken implements InternalPlayer {
     private seqNum;
     constructor(context: BaseAudioContext, options?: SmolkenOptions);
     get output(): OutputChannel;
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     get context(): BaseAudioContext;
     start(sample: SampleStart | string | number): (time?: number) => void;
     stop(sample?: SampleStop | string | number): void;
@@ -429,12 +469,12 @@ type SoundfontConfig = {
     kit: "FluidR3_GM" | "MusyngKite" | string;
     instrument?: string;
     instrumentUrl: string;
-    storage: Storage;
+    storage: Storage$1;
     extraGain: number;
     loadLoopData: boolean;
     loopDataUrl?: string;
 };
-type SoundfontOptions = Partial<SoundfontConfig & SampleOptions & ChannelOptions>;
+type SoundfontOptions = Partial<SoundfontConfig & DefaultPlayerConfig>;
 declare class Soundfont {
     #private;
     readonly context: AudioContext;
@@ -456,14 +496,11 @@ declare class Soundfont {
  */
 type SplendidGrandPianoConfig = {
     baseUrl: string;
-    destination: AudioNode;
-    storage: Storage;
+    storage: Storage$1;
     detune: number;
-    volume: number;
     velocity: number;
-    decayTime?: number;
-    lpfCutoffHz?: number;
-};
+    decayTime: number;
+} & Partial<DefaultPlayerConfig>;
 declare class SplendidGrandPiano {
     #private;
     readonly context: AudioContext;
@@ -472,7 +509,7 @@ declare class SplendidGrandPiano {
     readonly load: Promise<this>;
     constructor(context: AudioContext, options?: Partial<SplendidGrandPianoConfig>);
     get output(): OutputChannel;
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     loaded(): Promise<this>;
     start(sampleOrNote: SampleStart | number | string): (time?: number | undefined) => void;
     stop(sample?: SampleStop | number | string): void;
@@ -489,4 +526,4 @@ declare const LAYERS: ({
     cutoff?: undefined;
 })[];
 
-export { CacheStorage, DrumMachine, DrumMachineConfig, ElectricPiano, HttpStorage, LAYERS, Mallet, Mellotron, MellotronConfig, MellotronOptions, NAME_TO_PATH, Reverb, Sampler, SamplerConfig, Smolken, SmolkenConfig, SmolkenOptions, Soundfont, SoundfontOptions, SplendidGrandPiano, SplendidGrandPianoConfig, Storage, StorageResponse, VcslInstrumentLoader, Versilian, VersilianConfig, VersilianOptions, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments };
+export { CacheStorage, DrumMachine, DrumMachineOptions, ElectricPiano, HttpStorage, LAYERS, Mallet, Mellotron, MellotronConfig, MellotronOptions, NAME_TO_PATH, Reverb, Sampler, SamplerConfig, Smolken, SmolkenConfig, SmolkenOptions, Soundfont, SoundfontOptions, SplendidGrandPiano, SplendidGrandPianoConfig, Storage$1 as Storage, StorageResponse$1 as StorageResponse, VcslInstrumentLoader, Versilian, VersilianConfig, VersilianOptions, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments };

package/dist/index.d.ts

@@ -3,7 +3,7 @@ type AudioInsert = {
     output: AudioNode;
 };
 
-type ChannelOptions = {
+type ChannelConfig = {
     destination: AudioNode;
     volume: number;
     volumeToGain: (volume: number) => number;
@@ -18,7 +18,7 @@ declare class Channel {
     readonly context: BaseAudioContext;
     readonly setVolume: (vol: number) => void;
     readonly input: AudioNode;
-    constructor(context: BaseAudioContext, options: Partial<ChannelOptions>);
+    constructor(context: BaseAudioContext, options?: Partial<ChannelConfig>);
     addInsert(effect: AudioNode | AudioInsert): void;
     addEffect(name: string, effect: AudioNode | {
         input: AudioNode;
@@ -27,28 +27,56 @@ declare class Channel {
     disconnect(): void;
 }
 
-type StorageResponse = {
+type StorageResponse$1 = {
     readonly status: number;
     arrayBuffer(): Promise<ArrayBuffer>;
     json(): Promise<any>;
     text(): Promise<string>;
 };
-type Storage = {
-    fetch: (url: string) => Promise<StorageResponse>;
+type Storage$1 = {
+    fetch: (url: string) => Promise<StorageResponse$1>;
 };
-declare const HttpStorage: Storage;
-declare class CacheStorage implements Storage {
+declare const HttpStorage: Storage$1;
+declare class CacheStorage implements Storage$1 {
     #private;
     constructor(name?: string);
-    fetch(url: string): Promise<StorageResponse>;
+    fetch(url: string): Promise<StorageResponse$1>;
 }
 
+type AudioBuffers$1 = Record<string | number, AudioBuffer | undefined>;
+/**
+ * A function that downloads audio into a AudioBuffers
+ */
+type AudioBuffersLoader$1 = (context: BaseAudioContext, buffers: AudioBuffers$1) => Promise<void>;
+
+type StorageResponse = {
+    readonly status: number;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    json(): Promise<any>;
+    text(): Promise<string>;
+};
+type Storage = {
+    fetch: (url: string) => Promise<StorageResponse>;
+};
+
 type AudioBuffers = Record<string | number, AudioBuffer | undefined>;
 /**
  * A function that downloads audio into a AudioBuffers
  */
 type AudioBuffersLoader = (context: BaseAudioContext, buffers: AudioBuffers) => Promise<void>;
 
+type SamplerConfig$1 = {
+    storage?: Storage;
+    detune: number;
+    volume: number;
+    velocity: number;
+    decayTime?: number;
+    lpfCutoffHz?: number;
+    destination: AudioNode;
+    buffers: Record<string | number, string | AudioBuffers> | AudioBuffersLoader;
+    volumeToGain: (volume: number) => number;
+};
+
 /**
  * A function to unsubscribe from an event or control
  */
@@ -66,7 +94,7 @@ type Subscribe<T> = (listener: Listener<T>) => Unsubscribe;
  * @private
  */
 type InternalPlayer = {
-    readonly buffers: AudioBuffers;
+    readonly buffers: AudioBuffers$1;
     readonly context: BaseAudioContext;
     start(sample: SampleStart): (time?: number) => void;
     stop(sample?: SampleStop): void;
@@ -91,6 +119,7 @@ type SampleStart = {
     name?: string;
     note: string | number;
     onEnded?: (sample: SampleStart) => void;
+    onStart?: (sample: SampleStart) => void;
     stop?: Subscribe<number>;
     stopId?: string | number;
     time?: number;
@@ -185,17 +214,28 @@ type RegionGroup = {
     sample: Partial<SampleOptions>;
 };
 
+type QueuedPlayerConfig = {
+    scheduleLookaheadMs: number;
+    scheduleIntervalMs: number;
+    onStart?: (sample: SampleStart) => void;
+    onEnded?: (sample: SampleStart) => void;
+};
+
+type DefaultPlayerConfig = ChannelConfig & SamplerConfig$1 & QueuedPlayerConfig;
+
 declare function getDrumMachineNames(): string[];
-type DrumMachineConfig = ChannelOptions & SampleOptions & {
+type DrumMachineConfig = {
     instrument: string;
-    storage?: Storage;
+    url: string;
+    storage: Storage$1;
 };
+type DrumMachineOptions = Partial<DrumMachineConfig & DefaultPlayerConfig>;
 declare class DrumMachine {
     #private;
     private readonly player;
     readonly load: Promise<this>;
     readonly output: OutputChannel;
-    constructor(context: AudioContext, options?: Partial<DrumMachineConfig>);
+    constructor(context: AudioContext, options?: DrumMachineOptions);
     loaded(): Promise<this>;
     get sampleNames(): string[];
     getVariations(name: string): string[];
@@ -277,7 +317,7 @@ type WebsfzRegion = {
  */
 type SfzSamplerConfig = {
     instrument: SfzInstrument | Websfz | string;
-    storage?: Storage;
+    storage?: Storage$1;
     destination: AudioNode;
     volume: number;
     velocity: number;
@@ -291,7 +331,7 @@ declare class SfzSampler {
     readonly options: Readonly<Partial<SfzSamplerConfig>>;
     private readonly player;
     readonly load: Promise<this>;
-    constructor(context: AudioContext, options: Partial<SfzSamplerConfig> & Pick<SfzSamplerConfig, "instrument">);
+    constructor(context: AudioContext, options: Partial<SfzSamplerConfig & DefaultPlayerConfig> & Pick<SfzSamplerConfig, "instrument">);
     get output(): OutputChannel;
     loaded(): Promise<this>;
     start(sample: SampleStart | string | number): void;
@@ -310,12 +350,12 @@ declare class ElectricPiano extends SfzSampler {
 }
 
 declare function getVersilianInstruments(): Promise<string[]>;
-declare function VcslInstrumentLoader(instrument: string, buffers: AudioBuffers, group: RegionGroup): (context: BaseAudioContext, storage: Storage) => Promise<void[]>;
+declare function VcslInstrumentLoader(instrument: string, buffers: AudioBuffers$1, group: RegionGroup): (context: BaseAudioContext, storage: Storage$1) => Promise<void[]>;
 type VersilianConfig = {
     instrument: string;
-    storage: Storage;
+    storage: Storage$1;
 };
-type VersilianOptions = Partial<VersilianConfig & SampleOptions & ChannelOptions>;
+type VersilianOptions = Partial<VersilianConfig & DefaultPlayerConfig>;
 /**
  * Versilian
  *
@@ -328,7 +368,7 @@ declare class Versilian implements InternalPlayer {
     private config;
     constructor(context: BaseAudioContext, options?: VersilianOptions);
     get output(): OutputChannel;
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     get context(): BaseAudioContext;
     start(sample: SampleStart | string | number): (time?: number | undefined) => void;
     stop(sample?: SampleStop | string | number): void;
@@ -344,9 +384,9 @@ declare const NAME_TO_PATH: Record<string, string | undefined>;
 declare function getMellotronNames(): string[];
 type MellotronConfig = {
     instrument: string;
-    storage: Storage;
+    storage: Storage$1;
 };
-type MellotronOptions = Partial<SampleOptions & ChannelOptions & MellotronConfig>;
+type MellotronOptions = Partial<MellotronConfig & DefaultPlayerConfig>;
 declare class Mellotron implements InternalPlayer {
     readonly context: BaseAudioContext;
     private readonly config;
@@ -354,7 +394,7 @@ declare class Mellotron implements InternalPlayer {
     private readonly group;
     readonly load: Promise<this>;
     constructor(context: BaseAudioContext, options: MellotronOptions);
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     get output(): OutputChannel;
     start(sample: SampleStart | string | number): (time?: number | undefined) => void;
     stop(sample?: SampleStop | string | number): void;
@@ -374,14 +414,14 @@ declare class Reverb {
 }
 
 type SamplerConfig = {
-    storage?: Storage;
+    storage?: Storage$1;
     detune: number;
     volume: number;
     velocity: number;
     decayTime?: number;
     lpfCutoffHz?: number;
     destination: AudioNode;
-    buffers: Record<string | number, string | AudioBuffers> | AudioBuffersLoader;
+    buffers: Record<string | number, string | AudioBuffers$1> | AudioBuffersLoader$1;
     volumeToGain: (volume: number) => number;
 };
 /**
@@ -405,9 +445,9 @@ declare class Sampler {
 declare function getSmolkenNames(): string[];
 type SmolkenConfig = {
     instrument: string;
-    storage: Storage;
+    storage: Storage$1;
 };
-type SmolkenOptions = Partial<SmolkenConfig & SampleOptions & ChannelOptions>;
+type SmolkenOptions = Partial<SmolkenConfig & DefaultPlayerConfig>;
 declare class Smolken implements InternalPlayer {
     private readonly player;
     private readonly group;
@@ -416,7 +456,7 @@ declare class Smolken implements InternalPlayer {
     private seqNum;
     constructor(context: BaseAudioContext, options?: SmolkenOptions);
     get output(): OutputChannel;
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     get context(): BaseAudioContext;
     start(sample: SampleStart | string | number): (time?: number) => void;
     stop(sample?: SampleStop | string | number): void;
@@ -429,12 +469,12 @@ type SoundfontConfig = {
     kit: "FluidR3_GM" | "MusyngKite" | string;
     instrument?: string;
     instrumentUrl: string;
-    storage: Storage;
+    storage: Storage$1;
     extraGain: number;
     loadLoopData: boolean;
     loopDataUrl?: string;
 };
-type SoundfontOptions = Partial<SoundfontConfig & SampleOptions & ChannelOptions>;
+type SoundfontOptions = Partial<SoundfontConfig & DefaultPlayerConfig>;
 declare class Soundfont {
     #private;
     readonly context: AudioContext;
@@ -456,14 +496,11 @@ declare class Soundfont {
  */
 type SplendidGrandPianoConfig = {
     baseUrl: string;
-    destination: AudioNode;
-    storage: Storage;
+    storage: Storage$1;
     detune: number;
-    volume: number;
     velocity: number;
-    decayTime?: number;
-    lpfCutoffHz?: number;
-};
+    decayTime: number;
+} & Partial<DefaultPlayerConfig>;
 declare class SplendidGrandPiano {
     #private;
     readonly context: AudioContext;
@@ -472,7 +509,7 @@ declare class SplendidGrandPiano {
     readonly load: Promise<this>;
     constructor(context: AudioContext, options?: Partial<SplendidGrandPianoConfig>);
     get output(): OutputChannel;
-    get buffers(): AudioBuffers;
+    get buffers(): AudioBuffers$1;
     loaded(): Promise<this>;
     start(sampleOrNote: SampleStart | number | string): (time?: number | undefined) => void;
     stop(sample?: SampleStop | number | string): void;
@@ -489,4 +526,4 @@ declare const LAYERS: ({
     cutoff?: undefined;
 })[];
 
-export { CacheStorage, DrumMachine, DrumMachineConfig, ElectricPiano, HttpStorage, LAYERS, Mallet, Mellotron, MellotronConfig, MellotronOptions, NAME_TO_PATH, Reverb, Sampler, SamplerConfig, Smolken, SmolkenConfig, SmolkenOptions, Soundfont, SoundfontOptions, SplendidGrandPiano, SplendidGrandPianoConfig, Storage, StorageResponse, VcslInstrumentLoader, Versilian, VersilianConfig, VersilianOptions, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments };
+export { CacheStorage, DrumMachine, DrumMachineOptions, ElectricPiano, HttpStorage, LAYERS, Mallet, Mellotron, MellotronConfig, MellotronOptions, NAME_TO_PATH, Reverb, Sampler, SamplerConfig, Smolken, SmolkenConfig, SmolkenOptions, Soundfont, SoundfontOptions, SplendidGrandPiano, SplendidGrandPianoConfig, Storage$1 as Storage, StorageResponse$1 as StorageResponse, VcslInstrumentLoader, Versilian, VersilianConfig, VersilianOptions, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments };