smplr 0.21.0 → 0.22.0

package/README.md

@@ -57,7 +57,7 @@ wav.downloadWav("arpeggio.wav");
 
 See demo: https://danigb.github.io/smplr/
 
-`smplr` is approaching 1.0. The 0.21.0 release is the **1.0 candidate** — the documented surface is intended to ship unchanged into 1.0; the formal stability commitment lands when a handful of coordinated sibling tickets are in (see the 0.21.0 [CHANGELOG](https://github.com/danigb/smplr/blob/main/CHANGELOG.md) entry).
+`smplr` is approaching 1.0. The 0.22.0 release lands the final batch of pre-1.0 API work — every documented `new X(ctx, opts)` keeps working, and the documented surface is intended to ship unchanged into 1.0. The formal stability commitment lands once the narrow `loader`/`scheduler` public interfaces sibling ticket is in (see [CHANGELOG](https://github.com/danigb/smplr/blob/main/CHANGELOG.md)).
 
 > **Upgrading from an earlier 0.x?** No code changes are required — every documented `new X(ctx, opts)` keeps working. New code should drop the `new` (`X(ctx, opts)`) and prefer `await x.ready` over `await x.load`.
 
@@ -291,14 +291,42 @@ If `loop` is true but `loopStart` or `loopEnd` are not specified, 0 and total du
 
 #### Change volume
 
-Instrument `output` attribute represents the main output of the instrument. `output.setVolume` method accepts a number where 0 means no volume, and 127 is max volume without amplification:
+Instrument `output` attribute represents the main output of the instrument. The `output.volume` getter/setter accepts a number where 0 means no volume, and 127 is max volume without amplification:
 
 ```js
-piano.output.setVolume(80);
+piano.output.volume = 80;
+piano.output.volume; // => 80
 ```
 
+`output.setVolume(n)` is kept as a deprecated alias and continues to work.
+
 ⚠️ `volume` is global to the instrument, but `velocity` is specific for each note.
 
+#### MIDI CC
+
+Set and read MIDI Control Change values on the instrument:
+
+```js
+piano.setCC(64, 127); // sustain pedal on
+piano.getCC(64);      // => 127
+piano.setCC(64, 0);   // sustain pedal off
+```
+
+Unset CCs default to `0` (matches MIDI's "undefined controller defaults to 0" convention).
+
+#### Disposing
+
+When you're done with an instrument, call `dispose()` to stop all voices, tear down the audio graph, and stop the scheduler. The instance must not be used after this call.
+
+```js
+useEffect(() => {
+  const piano = SplendidGrandPiano(context);
+  return () => piano.dispose();
+}, []);
+```
+
+`disconnect()` is kept as a deprecated alias and continues to work.
+
 #### Events
 
 Two events are supported `onStart` and `onEnded`. Both callbacks will receive as parameter started note.
@@ -345,12 +373,14 @@ const piano = SplendidGrandPiano(context, { volume });
 piano.output.addEffect("reverb", reverb, 0.2);
 ```
 
-To change the mix level, use `output.sendEffect(name, mix)`:
+To change the mix level, use `output.setEffectMix(name, mix)`:
 
 ```js
-piano.output.sendEffect("reverb", 0.5);
+piano.output.setEffectMix("reverb", 0.5);
 ```
 
+`output.sendEffect(name, mix)` is kept as a deprecated alias and continues to work.
+
 ### Cache requests
 
 The default sample sets are hosted on GitHub Pages, which rate-limits requests per second. That can be a problem, especially in a development environment with hot reload (most React frameworks).
@@ -643,6 +673,22 @@ This will download a WAV file you can attach to your issue or pull request.
 
 ## Instruments
 
+### Available instruments
+
+Each instrument family exposes a synchronous helper that returns the names you can pass to its factory:
+
+| Factory | Names helper |
+|---|---|
+| `Soundfont` | `getSoundfontNames(): string[]` |
+| `ElectricPiano` | `getElectricPianoNames(): string[]` |
+| `Mallet` | `getMalletNames(): string[]` |
+| `Mellotron` | `getMellotronNames(): string[]` |
+| `DrumMachine` | `getDrumMachineNames(): string[]` |
+| `Smolken` | `getSmolkenNames(): string[]` |
+| `Versilian` | `getVersilianInstruments(): Promise<string[]>` |
+
+`getVersilianInstruments` is async because the catalog is fetched from the network on first call (cached thereafter).
+
 ### Sampler
 
 An audio buffer sampler. Pass a `buffers` object with the files to be load:

package/dist/index.d.mts

@@ -17,15 +17,20 @@ type OutputChannel = Omit<Channel, "input">;
 declare class Channel {
     #private;
     readonly context: BaseAudioContext;
+    /** @deprecated Use `output.volume = n` instead. */
     readonly setVolume: (vol: number) => void;
     readonly input: AudioNode;
     constructor(context: BaseAudioContext, options?: Partial<ChannelConfig>);
+    get volume(): number;
+    set volume(value: number);
     get pan(): number;
     set pan(value: number);
     addInsert(effect: AudioNode | AudioInsert): void;
     addEffect(name: string, effect: AudioNode | {
         input: AudioNode;
     }, mixValue: number): void;
+    setEffectMix(name: string, mix: number): void;
+    /** @deprecated Use `setEffectMix(name, mix)` instead. */
     sendEffect(name: string, mix: number): void;
     disconnect(): void;
 }
@@ -110,6 +115,8 @@ type SmplrSamples = {
  * The top-level smplr.json descriptor. Passed to the Smplr constructor.
  */
 type SmplrJson = {
+    /** Schema version. Omit for the current format. Reserved for future migrations. */
+    smplr?: "1.0";
     meta?: {
         name?: string;
         description?: string;
@@ -287,6 +294,19 @@ interface Smplr {
     start(event: NoteEvent): StopFn;
     stop(target?: StopTarget): void;
     setCC(cc: number, value: number): void;
+    /**
+     * Read the latest value set via `setCC`. Returns `0` for any CC that has
+     * not been set (matches MIDI's "undefined controller defaults to 0" convention).
+     */
+    getCC(cc: number): number;
+    /**
+     * Stop all voices, dispose the output channel, and stop the scheduler.
+     * The instance must not be used after this call — subsequent `start`/`stop`/
+     * `setCC`/`getCC`/`setControlValue`/`loadInstrument` calls throw. Subsequent
+     * `dispose()` calls are no-ops.
+     */
+    dispose(): void;
+    /** @deprecated Use `dispose()` instead. */
     disconnect(): void;
 }
 /**
@@ -406,6 +426,8 @@ declare const DrumMachine: InstrumentFactory<Partial<DrumMachineConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, DrumMachineExtras>;
+/** Instance type returned by the {@link DrumMachine} factory. */
+type DrumMachine = ReturnType<typeof DrumMachine>;
 /**
  * Convert a DrumMachineInstrument to a SmplrJson descriptor.
  *
@@ -482,22 +504,6 @@ declare function audioBufferToWav16(buffer: AudioBuffer): Blob;
  */
 declare function trimSilence(buffer: AudioBuffer): AudioBuffer;
 
-/**
- * Given a list of [midi, sampleName] pairs, return one entry per sample with
- * a keyRange that covers all MIDI notes closer to that sample than to any
- * neighbour. The first sample extends down to 0; the last extends up to 127.
- *
- * The boundary between two adjacent samples A and B (A < B) is placed at
- * `floor((A + B) / 2)`, matching the behaviour of the old `findNearestMidiInLayer`
- * which always resolved ties in favour of the lower sample.
- */
-type SpreadResult = {
-    keyRange: [number, number];
-    pitch: number;
-    sample: string;
-};
-declare function spreadKeyRanges(samples: [number, string][]): SpreadResult[];
-
 /**
  * TransportClock
  *
@@ -715,6 +721,8 @@ declare const ElectricPiano: InstrumentFactory<Partial<{
         level: (value: number) => void;
     }>;
 }>;
+/** Instance type returned by the {@link ElectricPiano} factory. */
+type ElectricPiano = ReturnType<typeof ElectricPiano>;
 
 declare function getVersilianInstruments(): Promise<string[]>;
 type VersilianConfig = {
@@ -739,6 +747,8 @@ declare const Versilian: InstrumentFactory<Partial<VersilianConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Versilian} factory. */
+type Versilian = ReturnType<typeof Versilian>;
 /**
  * Fetch the SFZ for a VCSL instrument and load it into `smplr`. Shared by
  * the {@link Versilian} and {@link Mallet} factories — not exported from the
@@ -746,14 +756,15 @@ declare const Versilian: InstrumentFactory<Partial<VersilianConfig & {
  */
 declare function loadVersilianInstrument(smplr: PluginSmplr, options: VersilianOptions): Promise<void>;
 
-declare function getMalletNames(): MalletName[];
+declare function getMalletNames(): string[];
 declare const Mallet: InstrumentFactory<Partial<VersilianConfig & {
     destination?: AudioNode;
     volume?: number;
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
-type MalletName = keyof typeof NAME_TO_PATH;
+/** Instance type returned by the {@link Mallet} factory. */
+type Mallet = ReturnType<typeof Mallet>;
 declare const NAME_TO_PATH: Record<string, string | undefined>;
 
 declare function getMellotronNames(): string[];
@@ -775,6 +786,8 @@ declare const Mellotron: InstrumentFactory<Partial<MellotronConfig & {
     decayTime?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Mellotron} factory. */
+type Mellotron = ReturnType<typeof Mellotron>;
 type MellotronJsonConfig = {
     instrument: string;
     variation?: string;
@@ -819,10 +832,6 @@ type SamplerConfig = {
     volumeToGain: (volume: number) => number;
     onLoadProgress?: (progress: LoadProgress) => void;
 };
-/**
- * A Sampler instrument.
- */
-declare const Sampler: InstrumentFactory<Partial<SamplerConfig>, {}>;
 type SamplerJsonOptions = Pick<SamplerConfig, "decayTime" | "lpfCutoffHz" | "detune">;
 type InternalConvertResult = {
     json: SmplrJson;
@@ -840,6 +849,12 @@ type InternalConvertResult = {
  * - String URL values → urlMap (fetched asynchronously by caller).
  */
 declare function samplerToSmplrJson(source: Record<string | number, string | AudioBuffer>, options?: Partial<SamplerJsonOptions>): InternalConvertResult;
+/**
+ * A Sampler instrument.
+ */
+declare const Sampler: InstrumentFactory<Partial<SamplerConfig>, {}>;
+/** Instance type returned by the {@link Sampler} factory. */
+type Sampler = ReturnType<typeof Sampler>;
 
 declare function getSmolkenNames(): string[];
 type SmolkenConfig = {
@@ -858,6 +873,8 @@ declare const Smolken: InstrumentFactory<Partial<SmolkenConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Smolken} factory. */
+type Smolken = ReturnType<typeof Smolken>;
 
 type LoopData = Record<number, [number, number]>;
 
@@ -884,6 +901,8 @@ declare const Soundfont: InstrumentFactory<Partial<SoundfontConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Soundfont} factory. */
+type Soundfont = ReturnType<typeof Soundfont>;
 /**
  * Convert a list of note names (with optional loop data) to SmplrJson.
  * Uses spreadKeyRanges so notes between recorded pitches pitch-shift correctly.
@@ -935,6 +954,8 @@ type Soundfont2SamplerExtras = {
     loadInstrument(instrumentName: string): Promise<void> | undefined;
 };
 declare const Soundfont2Sampler: InstrumentFactory<Soundfont2Options, Soundfont2SamplerExtras>;
+/** Instance type returned by the {@link Soundfont2Sampler} factory. */
+type Soundfont2Sampler = ReturnType<typeof Soundfont2Sampler>;
 
 /**
  * Configuration options for SplendidGrandPiano.
@@ -963,6 +984,8 @@ type SplendidGrandPianoConfig = {
     };
 };
 declare const SplendidGrandPiano: InstrumentFactory<Partial<SplendidGrandPianoConfig>, {}>;
+/** Instance type returned by the {@link SplendidGrandPiano} factory. */
+type SplendidGrandPiano = ReturnType<typeof SplendidGrandPiano>;
 type PianoJsonOptions = Pick<SplendidGrandPianoConfig, "baseUrl" | "detune" | "decayTime" | "notesToLoad" | "formats">;
 /**
  * Convert the LAYERS array and user options into a SmplrJson descriptor.
@@ -975,7 +998,6 @@ type PianoJsonOptions = Pick<SplendidGrandPianoConfig, "baseUrl" | "detune" | "d
  * covers, replacing the old on-the-fly `findNearestMidiInLayer` logic.
  */
 declare function pianoToSmplrJson(options: PianoJsonOptions): SmplrJson;
-
 declare const LAYERS: ({
     name: string;
     vel_range: number[];
@@ -988,4 +1010,4 @@ declare const LAYERS: ({
     cutoff?: undefined;
 })[];
 
-export { CacheStorage, DrumMachine, type DrumMachineOptions, ElectricPiano, type ElectricPianoOptions, HttpStorage, Instrument, LAYERS, type LoadProgress, Mallet, Mellotron, type MellotronConfig, type MellotronOptions, NAME_TO_PATH, type NoteEvent, type PlaybackParams, type RenderOfflineOptions, RenderResult, Reverb, SampleLoader, Sampler, type SamplerConfig, Scheduler, Sequencer, type SequencerInstrument, type SequencerNote, type SequencerNoteEvent, type SequencerOptions, Smolken, type SmolkenConfig, type SmolkenOptions, type Smplr, type SmplrGroup, type SmplrJson, type SmplrOptions, type SmplrPlugin, type SmplrRegion, type SmplrSamples, Soundfont, type Soundfont2Options, Soundfont2Sampler, type SoundfontOptions, SplendidGrandPiano, type SplendidGrandPianoConfig, type SpreadResult, type StopFn, type StopTarget, type Storage, type StorageResponse, Versilian, type VersilianConfig, type VersilianOptions, type VoiceParams, audioBufferToWav, audioBufferToWav16, drumMachineToSmplrJson, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments, loadVersilianInstrument, mellotronToSmplrJson, pianoToSmplrJson, renderOffline, samplerToSmplrJson, sf2InstrumentToSmplrJson, soundfontToSmplrJson, spreadKeyRanges, trimSilence };
+export { CacheStorage, DrumMachine, type DrumMachineOptions, ElectricPiano, type ElectricPianoOptions, HttpStorage, Instrument, LAYERS, type LoadProgress, Mallet, Mellotron, type MellotronConfig, type MellotronOptions, NAME_TO_PATH, type NoteEvent, type PlaybackParams, type RenderOfflineOptions, RenderResult, Reverb, SampleLoader, Sampler, type SamplerConfig, Scheduler, Sequencer, type SequencerInstrument, type SequencerNote, type SequencerNoteEvent, type SequencerOptions, Smolken, type SmolkenConfig, type SmolkenOptions, type Smplr, type SmplrGroup, type SmplrJson, type SmplrOptions, type SmplrPlugin, type SmplrRegion, type SmplrSamples, Soundfont, type Soundfont2Options, Soundfont2Sampler, type SoundfontOptions, SplendidGrandPiano, type SplendidGrandPianoConfig, type StopFn, type StopTarget, type Storage, type StorageResponse, Versilian, type VersilianConfig, type VersilianOptions, type VoiceParams, audioBufferToWav, audioBufferToWav16, drumMachineToSmplrJson, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments, loadVersilianInstrument, mellotronToSmplrJson, pianoToSmplrJson, renderOffline, samplerToSmplrJson, sf2InstrumentToSmplrJson, soundfontToSmplrJson, trimSilence };

package/dist/index.d.ts

@@ -17,15 +17,20 @@ type OutputChannel = Omit<Channel, "input">;
 declare class Channel {
     #private;
     readonly context: BaseAudioContext;
+    /** @deprecated Use `output.volume = n` instead. */
     readonly setVolume: (vol: number) => void;
     readonly input: AudioNode;
     constructor(context: BaseAudioContext, options?: Partial<ChannelConfig>);
+    get volume(): number;
+    set volume(value: number);
     get pan(): number;
     set pan(value: number);
     addInsert(effect: AudioNode | AudioInsert): void;
     addEffect(name: string, effect: AudioNode | {
         input: AudioNode;
     }, mixValue: number): void;
+    setEffectMix(name: string, mix: number): void;
+    /** @deprecated Use `setEffectMix(name, mix)` instead. */
     sendEffect(name: string, mix: number): void;
     disconnect(): void;
 }
@@ -110,6 +115,8 @@ type SmplrSamples = {
  * The top-level smplr.json descriptor. Passed to the Smplr constructor.
  */
 type SmplrJson = {
+    /** Schema version. Omit for the current format. Reserved for future migrations. */
+    smplr?: "1.0";
     meta?: {
         name?: string;
         description?: string;
@@ -287,6 +294,19 @@ interface Smplr {
     start(event: NoteEvent): StopFn;
     stop(target?: StopTarget): void;
     setCC(cc: number, value: number): void;
+    /**
+     * Read the latest value set via `setCC`. Returns `0` for any CC that has
+     * not been set (matches MIDI's "undefined controller defaults to 0" convention).
+     */
+    getCC(cc: number): number;
+    /**
+     * Stop all voices, dispose the output channel, and stop the scheduler.
+     * The instance must not be used after this call — subsequent `start`/`stop`/
+     * `setCC`/`getCC`/`setControlValue`/`loadInstrument` calls throw. Subsequent
+     * `dispose()` calls are no-ops.
+     */
+    dispose(): void;
+    /** @deprecated Use `dispose()` instead. */
     disconnect(): void;
 }
 /**
@@ -406,6 +426,8 @@ declare const DrumMachine: InstrumentFactory<Partial<DrumMachineConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, DrumMachineExtras>;
+/** Instance type returned by the {@link DrumMachine} factory. */
+type DrumMachine = ReturnType<typeof DrumMachine>;
 /**
  * Convert a DrumMachineInstrument to a SmplrJson descriptor.
  *
@@ -482,22 +504,6 @@ declare function audioBufferToWav16(buffer: AudioBuffer): Blob;
  */
 declare function trimSilence(buffer: AudioBuffer): AudioBuffer;
 
-/**
- * Given a list of [midi, sampleName] pairs, return one entry per sample with
- * a keyRange that covers all MIDI notes closer to that sample than to any
- * neighbour. The first sample extends down to 0; the last extends up to 127.
- *
- * The boundary between two adjacent samples A and B (A < B) is placed at
- * `floor((A + B) / 2)`, matching the behaviour of the old `findNearestMidiInLayer`
- * which always resolved ties in favour of the lower sample.
- */
-type SpreadResult = {
-    keyRange: [number, number];
-    pitch: number;
-    sample: string;
-};
-declare function spreadKeyRanges(samples: [number, string][]): SpreadResult[];
-
 /**
  * TransportClock
  *
@@ -715,6 +721,8 @@ declare const ElectricPiano: InstrumentFactory<Partial<{
         level: (value: number) => void;
     }>;
 }>;
+/** Instance type returned by the {@link ElectricPiano} factory. */
+type ElectricPiano = ReturnType<typeof ElectricPiano>;
 
 declare function getVersilianInstruments(): Promise<string[]>;
 type VersilianConfig = {
@@ -739,6 +747,8 @@ declare const Versilian: InstrumentFactory<Partial<VersilianConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Versilian} factory. */
+type Versilian = ReturnType<typeof Versilian>;
 /**
  * Fetch the SFZ for a VCSL instrument and load it into `smplr`. Shared by
  * the {@link Versilian} and {@link Mallet} factories — not exported from the
@@ -746,14 +756,15 @@ declare const Versilian: InstrumentFactory<Partial<VersilianConfig & {
  */
 declare function loadVersilianInstrument(smplr: PluginSmplr, options: VersilianOptions): Promise<void>;
 
-declare function getMalletNames(): MalletName[];
+declare function getMalletNames(): string[];
 declare const Mallet: InstrumentFactory<Partial<VersilianConfig & {
     destination?: AudioNode;
     volume?: number;
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
-type MalletName = keyof typeof NAME_TO_PATH;
+/** Instance type returned by the {@link Mallet} factory. */
+type Mallet = ReturnType<typeof Mallet>;
 declare const NAME_TO_PATH: Record<string, string | undefined>;
 
 declare function getMellotronNames(): string[];
@@ -775,6 +786,8 @@ declare const Mellotron: InstrumentFactory<Partial<MellotronConfig & {
     decayTime?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Mellotron} factory. */
+type Mellotron = ReturnType<typeof Mellotron>;
 type MellotronJsonConfig = {
     instrument: string;
     variation?: string;
@@ -819,10 +832,6 @@ type SamplerConfig = {
     volumeToGain: (volume: number) => number;
     onLoadProgress?: (progress: LoadProgress) => void;
 };
-/**
- * A Sampler instrument.
- */
-declare const Sampler: InstrumentFactory<Partial<SamplerConfig>, {}>;
 type SamplerJsonOptions = Pick<SamplerConfig, "decayTime" | "lpfCutoffHz" | "detune">;
 type InternalConvertResult = {
     json: SmplrJson;
@@ -840,6 +849,12 @@ type InternalConvertResult = {
  * - String URL values → urlMap (fetched asynchronously by caller).
  */
 declare function samplerToSmplrJson(source: Record<string | number, string | AudioBuffer>, options?: Partial<SamplerJsonOptions>): InternalConvertResult;
+/**
+ * A Sampler instrument.
+ */
+declare const Sampler: InstrumentFactory<Partial<SamplerConfig>, {}>;
+/** Instance type returned by the {@link Sampler} factory. */
+type Sampler = ReturnType<typeof Sampler>;
 
 declare function getSmolkenNames(): string[];
 type SmolkenConfig = {
@@ -858,6 +873,8 @@ declare const Smolken: InstrumentFactory<Partial<SmolkenConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Smolken} factory. */
+type Smolken = ReturnType<typeof Smolken>;
 
 type LoopData = Record<number, [number, number]>;
 
@@ -884,6 +901,8 @@ declare const Soundfont: InstrumentFactory<Partial<SoundfontConfig & {
     velocity?: number;
     onLoadProgress?: (progress: LoadProgress) => void;
 }>, {}>;
+/** Instance type returned by the {@link Soundfont} factory. */
+type Soundfont = ReturnType<typeof Soundfont>;
 /**
  * Convert a list of note names (with optional loop data) to SmplrJson.
  * Uses spreadKeyRanges so notes between recorded pitches pitch-shift correctly.
@@ -935,6 +954,8 @@ type Soundfont2SamplerExtras = {
     loadInstrument(instrumentName: string): Promise<void> | undefined;
 };
 declare const Soundfont2Sampler: InstrumentFactory<Soundfont2Options, Soundfont2SamplerExtras>;
+/** Instance type returned by the {@link Soundfont2Sampler} factory. */
+type Soundfont2Sampler = ReturnType<typeof Soundfont2Sampler>;
 
 /**
  * Configuration options for SplendidGrandPiano.
@@ -963,6 +984,8 @@ type SplendidGrandPianoConfig = {
     };
 };
 declare const SplendidGrandPiano: InstrumentFactory<Partial<SplendidGrandPianoConfig>, {}>;
+/** Instance type returned by the {@link SplendidGrandPiano} factory. */
+type SplendidGrandPiano = ReturnType<typeof SplendidGrandPiano>;
 type PianoJsonOptions = Pick<SplendidGrandPianoConfig, "baseUrl" | "detune" | "decayTime" | "notesToLoad" | "formats">;
 /**
  * Convert the LAYERS array and user options into a SmplrJson descriptor.
@@ -975,7 +998,6 @@ type PianoJsonOptions = Pick<SplendidGrandPianoConfig, "baseUrl" | "detune" | "d
  * covers, replacing the old on-the-fly `findNearestMidiInLayer` logic.
  */
 declare function pianoToSmplrJson(options: PianoJsonOptions): SmplrJson;
-
 declare const LAYERS: ({
     name: string;
     vel_range: number[];
@@ -988,4 +1010,4 @@ declare const LAYERS: ({
     cutoff?: undefined;
 })[];
 
-export { CacheStorage, DrumMachine, type DrumMachineOptions, ElectricPiano, type ElectricPianoOptions, HttpStorage, Instrument, LAYERS, type LoadProgress, Mallet, Mellotron, type MellotronConfig, type MellotronOptions, NAME_TO_PATH, type NoteEvent, type PlaybackParams, type RenderOfflineOptions, RenderResult, Reverb, SampleLoader, Sampler, type SamplerConfig, Scheduler, Sequencer, type SequencerInstrument, type SequencerNote, type SequencerNoteEvent, type SequencerOptions, Smolken, type SmolkenConfig, type SmolkenOptions, type Smplr, type SmplrGroup, type SmplrJson, type SmplrOptions, type SmplrPlugin, type SmplrRegion, type SmplrSamples, Soundfont, type Soundfont2Options, Soundfont2Sampler, type SoundfontOptions, SplendidGrandPiano, type SplendidGrandPianoConfig, type SpreadResult, type StopFn, type StopTarget, type Storage, type StorageResponse, Versilian, type VersilianConfig, type VersilianOptions, type VoiceParams, audioBufferToWav, audioBufferToWav16, drumMachineToSmplrJson, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments, loadVersilianInstrument, mellotronToSmplrJson, pianoToSmplrJson, renderOffline, samplerToSmplrJson, sf2InstrumentToSmplrJson, soundfontToSmplrJson, spreadKeyRanges, trimSilence };
+export { CacheStorage, DrumMachine, type DrumMachineOptions, ElectricPiano, type ElectricPianoOptions, HttpStorage, Instrument, LAYERS, type LoadProgress, Mallet, Mellotron, type MellotronConfig, type MellotronOptions, NAME_TO_PATH, type NoteEvent, type PlaybackParams, type RenderOfflineOptions, RenderResult, Reverb, SampleLoader, Sampler, type SamplerConfig, Scheduler, Sequencer, type SequencerInstrument, type SequencerNote, type SequencerNoteEvent, type SequencerOptions, Smolken, type SmolkenConfig, type SmolkenOptions, type Smplr, type SmplrGroup, type SmplrJson, type SmplrOptions, type SmplrPlugin, type SmplrRegion, type SmplrSamples, Soundfont, type Soundfont2Options, Soundfont2Sampler, type SoundfontOptions, SplendidGrandPiano, type SplendidGrandPianoConfig, type StopFn, type StopTarget, type Storage, type StorageResponse, Versilian, type VersilianConfig, type VersilianOptions, type VoiceParams, audioBufferToWav, audioBufferToWav16, drumMachineToSmplrJson, getDrumMachineNames, getElectricPianoNames, getMalletNames, getMellotronNames, getSmolkenNames, getSoundfontKits, getSoundfontNames, getVersilianInstruments, loadVersilianInstrument, mellotronToSmplrJson, pianoToSmplrJson, renderOffline, samplerToSmplrJson, sf2InstrumentToSmplrJson, soundfontToSmplrJson, trimSilence };