smplr 0.26.0 → 1.0.0

package/README.md

@@ -46,7 +46,8 @@ seq.start();
 import { SplendidGrandPiano, Reverb, renderOffline } from "smplr";
 
 const wav = await renderOffline(async (context) => {
-  const piano = await SplendidGrandPiano(context).load;
+  const piano = SplendidGrandPiano(context);
+  await piano.ready;
   piano.output.addEffect("reverb", Reverb(context), 0.3);
   ["C4", "E4", "G4", "C5"].forEach((note, i) => {
     piano.start({ note, time: i * 0.4, duration: 0.4 });
@@ -144,10 +145,10 @@ const marimba = Soundfont(context, { instrument: "marimba" });
 You can start playing notes as soon as one sample is loaded. To wait for all of them, await either:
 
 - `piano.ready` — resolves to `void` (preferred for new code).
-- `piano.load` — resolves to the instrument itself, so you can create and await in one line:
 
 ```js
-const piano = await SplendidGrandPiano(context).load;
+const piano = SplendidGrandPiano(context);
+await piano.ready;
 ```
 
 > Upgrading from older versions? See [MIGRATE.md](./MIGRATE.md).
@@ -235,7 +236,7 @@ const now = context.currentTime;
 
 #### Looping
 
-You can loop a note by using `loop`, `loopStart` and `loopEnd`:
+You can loop a note by using `loop`, `loopStart` and `loopEnd` (positions in seconds):
 
 ```js
 const context = new AudioContext();
@@ -314,6 +315,8 @@ To change the mix level, use `output.setEffectMix(name, mix)`:
 piano.output.setEffectMix("reverb", 0.5);
 ```
 
+Send buses are **post-fader**: they tap the signal after `output.volume` (and after any inserts), so turning `output.volume` down proportionally reduces what reaches the effect. Set `output.volume` to 0 and the send goes silent too.
+
 ### Events
 
 Two events are available: `onStart` and `onEnded`. Both callbacks receive the started note as a parameter, and can be configured globally:
@@ -721,7 +724,8 @@ Render audio offline (faster than real-time) and export it as a WAV file. Uses `
 import { renderOffline } from "smplr";
 
 const result = await renderOffline(async (context) => {
-  const piano = await SplendidGrandPiano(context).load;
+  const piano = SplendidGrandPiano(context);
+  await piano.ready;
   piano.start({ note: "C4", time: 0, duration: 1 });
   piano.start({ note: "E4", time: 0.5, duration: 1 });
 });
@@ -764,11 +768,12 @@ import { SplendidGrandPiano, SampleLoader, renderOffline } from "smplr";
 
 const loader = SampleLoader(audioContext);
 const piano = SplendidGrandPiano(audioContext, { loader });
-await piano.load;
+await piano.ready;
 
 // Offline render reuses cached buffers — no re-fetch
 const result = await renderOffline(async (context) => {
-  const offlinePiano = await SplendidGrandPiano(context, { loader }).load;
+  const offlinePiano = SplendidGrandPiano(context, { loader });
+  await offlinePiano.ready;
   offlinePiano.start({ note: "C4", time: 0, duration: 1 });
 });
 ```
@@ -782,7 +787,8 @@ const { renderOffline, SplendidGrandPiano } =
   await import("https://esm.sh/smplr");
 
 const result = await renderOffline(async (context) => {
-  const piano = await SplendidGrandPiano(context).load;
+  const piano = SplendidGrandPiano(context);
+  await piano.ready;
   piano.start({ note: "C4", time: 0, duration: 2 });
 });
 result.downloadWav16("bug-report.wav");
@@ -1029,7 +1035,7 @@ const context = new AudioContext();
 const drums = DrumAbuse(context, {
   source: { kind: "machine", machine: "roland-tr-808" },
 });
-await drums.load;
+await drums.ready;
 
 drums.start({ note: "kick" });
 
@@ -1076,7 +1082,8 @@ const instruments = getSmolkenNames(); // => Arco, Pizzicato & Switched
 
 // Create an instrument
 const context = new AudioContext();
-const doubleBass = await Smolken(context, { instrument: "Arco" }).load;
+const doubleBass = Smolken(context, { instrument: "Arco" });
+await doubleBass.ready;
 ```
 
 ### Versilian
@@ -1109,7 +1116,7 @@ const sampler = Soundfont2(context, {
   createSoundfont: (data) => new SoundFont2(data),
 });
 
-sampler.load.then(() => {
+sampler.ready.then(() => {
   // list all available instruments for the soundfont
   console.log(sampler.instrumentNames);
 

package/dist/index.d.mts

@@ -26,6 +26,15 @@ declare class Channel {
     get pan(): number;
     set pan(value: number);
     addInsert(effect: AudioNode | AudioInsert): void;
+    /**
+     * Add a send effect on a parallel bus.
+     *
+     * The send is **post-fader**: it taps the channel signal after the volume
+     * gain (and after any inserts added via {@link addInsert}), before the
+     * panner. Lowering `volume` proportionally lowers the send level; `volume = 0`
+     * silences the send too. Inserts are upstream of the tap, so they are heard
+     * on the send.
+     */
     addEffect(name: string, effect: AudioNode | {
         input: AudioNode;
     }, mixValue: number): void;
@@ -101,7 +110,6 @@ type SmplrRegion = PlaybackParams & {
     group?: number;
     offBy?: number;
     trigger?: "first" | "legato";
-    ampVelCurve?: [number, number];
     /** Auto-compute loop points from buffer duration ratios (0–1). */
     loopAuto?: {
         startRatio: number;
@@ -186,7 +194,7 @@ type LoadProgress = {
 };
 /**
  * Fully resolved playback parameters for a single Voice.
- * Output of resolveParams() — all fields are required, no optionals except ampVelCurve/loopAuto.
+ * Output of resolveParams() — all fields are required, no optionals except loopAuto.
  */
 type VoiceParams = {
     detune: number;
@@ -199,7 +207,6 @@ type VoiceParams = {
     loop: boolean;
     loopStart: number;
     loopEnd: number;
-    ampVelCurve?: [number, number];
     /** If set, loop points are computed from buffer.duration at play time. */
     loopAuto?: {
         startRatio: number;
@@ -1230,7 +1237,7 @@ declare function sf2InstrumentToPreset(sf2Instrument: Sf2Instrument, context: Ba
 };
 type Soundfont2SamplerExtras = {
     readonly instrumentNames: string[];
-    loadInstrument(instrumentName: string): Promise<void> | undefined;
+    loadInstrument(instrumentName: string): Promise<void>;
 };
 declare const Soundfont2: InstrumentFactory<Soundfont2Options, Soundfont2SamplerExtras>;
 /** Instance type returned by the {@link Soundfont2} factory. */

package/dist/index.d.ts

@@ -26,6 +26,15 @@ declare class Channel {
     get pan(): number;
     set pan(value: number);
     addInsert(effect: AudioNode | AudioInsert): void;
+    /**
+     * Add a send effect on a parallel bus.
+     *
+     * The send is **post-fader**: it taps the channel signal after the volume
+     * gain (and after any inserts added via {@link addInsert}), before the
+     * panner. Lowering `volume` proportionally lowers the send level; `volume = 0`
+     * silences the send too. Inserts are upstream of the tap, so they are heard
+     * on the send.
+     */
     addEffect(name: string, effect: AudioNode | {
         input: AudioNode;
     }, mixValue: number): void;
@@ -101,7 +110,6 @@ type SmplrRegion = PlaybackParams & {
     group?: number;
     offBy?: number;
     trigger?: "first" | "legato";
-    ampVelCurve?: [number, number];
     /** Auto-compute loop points from buffer duration ratios (0–1). */
     loopAuto?: {
         startRatio: number;
@@ -186,7 +194,7 @@ type LoadProgress = {
 };
 /**
  * Fully resolved playback parameters for a single Voice.
- * Output of resolveParams() — all fields are required, no optionals except ampVelCurve/loopAuto.
+ * Output of resolveParams() — all fields are required, no optionals except loopAuto.
  */
 type VoiceParams = {
     detune: number;
@@ -199,7 +207,6 @@ type VoiceParams = {
     loop: boolean;
     loopStart: number;
     loopEnd: number;
-    ampVelCurve?: [number, number];
     /** If set, loop points are computed from buffer.duration at play time. */
     loopAuto?: {
         startRatio: number;
@@ -1230,7 +1237,7 @@ declare function sf2InstrumentToPreset(sf2Instrument: Sf2Instrument, context: Ba
 };
 type Soundfont2SamplerExtras = {
     readonly instrumentNames: string[];
-    loadInstrument(instrumentName: string): Promise<void> | undefined;
+    loadInstrument(instrumentName: string): Promise<void>;
 };
 declare const Soundfont2: InstrumentFactory<Soundfont2Options, Soundfont2SamplerExtras>;
 /** Instance type returned by the {@link Soundfont2} factory. */

package/dist/index.js

@@ -136,11 +136,12 @@ var HttpStorage = {
     return fetch(url);
   }
 };
-var _cache, _CacheStorageImpl_instances, tryFromCache_fn, saveResponse_fn;
+var _cache, _warned, _CacheStorageImpl_instances, tryFromCache_fn, saveResponse_fn;
 var CacheStorageImpl = class {
   constructor(name = "smplr") {
     __privateAdd(this, _CacheStorageImpl_instances);
     __privateAdd(this, _cache);
+    __privateAdd(this, _warned, false);
     if (typeof window === "undefined" || !("caches" in window)) {
       __privateSet(this, _cache, Promise.reject("CacheStorage not supported"));
       __privateGet(this, _cache).catch(() => {
@@ -163,6 +164,7 @@ var CacheStorageImpl = class {
   }
 };
 _cache = new WeakMap();
+_warned = new WeakMap();
 _CacheStorageImpl_instances = new WeakSet();
 tryFromCache_fn = function(request) {
   return __async(this, null, function* () {
@@ -178,6 +180,10 @@ saveResponse_fn = function(request, response) {
       const cache = yield __privateGet(this, _cache);
       yield cache.put(request, response.clone());
     } catch (err) {
+      if (!__privateGet(this, _warned)) {
+        __privateSet(this, _warned, true);
+        console.warn("smplr: failed to cache response", err);
+      }
     }
   });
 };
@@ -297,6 +303,15 @@ var Channel = class {
       __privateGet(this, _config).destination
     ]));
   }
+  /**
+   * Add a send effect on a parallel bus.
+   *
+   * The send is **post-fader**: it taps the channel signal after the volume
+   * gain (and after any inserts added via {@link addInsert}), before the
+   * panner. Lowering `volume` proportionally lowers the send level; `volume = 0`
+   * silences the send too. Inserts are upstream of the tap, so they are heard
+   * on the send.
+   */
   addEffect(name, effect, mixValue) {
     var _a;
     if (__privateGet(this, _disconnected)) {
@@ -403,7 +418,6 @@ function resolveParams(defaults, group, region, midi, velocity, overrides) {
     loop: (_e = overrides == null ? void 0 : overrides.loop) != null ? _e : merged.loop,
     loopStart: merged.loopStart,
     loopEnd: merged.loopEnd,
-    ampVelCurve: region.ampVelCurve,
     loopAuto: region.loopAuto,
     reverse: (_f = overrides == null ? void 0 : overrides.reverse) != null ? _f : merged.reverse
   };
@@ -806,7 +820,7 @@ var Voice = class {
     __privateSet(this, _startAt, startAt);
     let offsetSec = 0;
     if (params.offset > 0) {
-      offsetSec = params.reverse ? (buffer.length - params.offset) / buffer.sampleRate : params.offset / buffer.sampleRate;
+      offsetSec = params.reverse ? buffer.duration - params.offset : params.offset;
     }
     source.start(startAt, offsetSec);
     __privateSet(this, _source, source);
@@ -1733,6 +1747,9 @@ function fetchJSON(url, storage) {
       return r.json();
     });
     jsonCache.set(url, p);
+    p.catch(() => {
+      if (jsonCache.get(url) === p) jsonCache.delete(url);
+    });
   }
   return p;
 }
@@ -3057,8 +3074,6 @@ function buildRegion(props, pathFromSampleName) {
   if (tune !== void 0) region.tune = tune / 100;
   const ampRelease = num(props, "ampeg_release");
   if (ampRelease !== void 0) region.ampRelease = ampRelease;
-  const ampVelcurve = numArr(props, "amp_velcurve");
-  if (ampVelcurve) region.ampVelCurve = ampVelcurve;
   return region;
 }
 function resolveDefines(sfz) {
@@ -3136,16 +3151,18 @@ function str(props, key) {
   if (typeof v === "string") return v;
   return void 0;
 }
-function numArr(props, _prefix) {
-  for (const [k, v] of Object.entries(props)) {
-    if (k.startsWith("amp_velcurve_")) {
-      const vel = Number(k.slice("amp_velcurve_".length));
-      if (!isNaN(vel) && typeof v === "number") {
-        return [vel, v];
-      }
+
+// src/fetch-ok.ts
+function fetchOk(url) {
+  return __async(this, null, function* () {
+    const res = yield fetch(url);
+    if (!res.ok) {
+      throw new Error(
+        `smplr: failed to fetch ${url} (${res.status} ${res.statusText})`
+      );
     }
-  }
-  return void 0;
+    return res;
+  });
 }
 
 // src/tremolo.ts
@@ -3247,7 +3264,7 @@ var ElectricPiano = Instrument(
     };
     const tremoloNode = createTremolo(ctx, depth.subscribe);
     smplr.output.addInsert(tremoloNode);
-    const ready = fetch(config.sfzUrl).then((r) => r.text()).then(
+    const ready = fetchOk(config.sfzUrl).then((r) => r.text()).then(
       (sfzText) => {
         var _a;
         return smplr.loadInstrument(
@@ -3267,7 +3284,7 @@ var ElectricPiano = Instrument(
 var VCSL_BASE_URL = "https://smpldsnds.github.io/sgossner-vcsl";
 var instrumentsPromise;
 function getVersilianInstruments() {
-  return instrumentsPromise != null ? instrumentsPromise : instrumentsPromise = fetch(
+  return instrumentsPromise != null ? instrumentsPromise : instrumentsPromise = fetchOk(
     VCSL_BASE_URL + "/sfz_files.json"
   ).then((res) => res.json());
 }
@@ -3280,7 +3297,7 @@ function loadVersilianInstrument(smplr, options) {
   const sfzUrl = `${VCSL_BASE_URL}/${instrument}.sfz`;
   const base = instrument.slice(0, instrument.lastIndexOf("/") + 1);
   const sampleBaseUrl2 = `${VCSL_BASE_URL}/${base}`;
-  return fetch(sfzUrl).then((r) => r.text()).then(
+  return fetchOk(sfzUrl).then((r) => r.text()).then(
     (sfzText) => smplr.loadInstrument(
       sfzToPreset(sfzText, {
         baseUrl: sampleBaseUrl2,
@@ -3385,7 +3402,7 @@ var Mellotron = Instrument(
     const variation = INSTRUMENT_VARIATIONS[instrument];
     const instrumentName = variation ? variation[0] : instrument;
     const baseUrl = `https://smpldsnds.github.io/archiveorg-mellotron/${instrumentName}/`;
-    return fetch(baseUrl + "files.json").then((r) => r.json()).then(
+    return fetchOk(baseUrl + "files.json").then((r) => r.json()).then(
       (names) => smplr.loadInstrument(
         mellotronToPreset(names, {
           instrument: instrumentName,
@@ -3454,7 +3471,7 @@ function createDattorroReverbEffect(context) {
     if (!ready) {
       const blob = new Blob([PROCESSOR], { type: "application/javascript" });
       const url = URL.createObjectURL(blob);
-      ready = context.audioWorklet.addModule(url);
+      ready = context.audioWorklet.addModule(url).finally(() => URL.revokeObjectURL(url));
       init.set(context, ready);
     }
     yield ready;
@@ -3495,11 +3512,13 @@ var ReverbImpl = class {
     return __privateGet(this, _ready);
   }
   connect(output) {
-    if (__privateGet(this, _effect)) {
-      __privateGet(this, _effect).disconnect(__privateGet(this, _output));
-      __privateGet(this, _effect).connect(output);
-    }
     __privateSet(this, _output, output);
+    __privateGet(this, _ready).then(() => {
+      if (__privateGet(this, _effect)) {
+        __privateGet(this, _effect).disconnect();
+        __privateGet(this, _effect).connect(__privateGet(this, _output));
+      }
+    });
   }
 };
 _effect = new WeakMap();
@@ -3646,7 +3665,7 @@ var Smolken = Instrument(
   (ctx, options = {}, smplr) => {
     var _a;
     const sfzUrl = getSmolkenUrl((_a = options.instrument) != null ? _a : "Arco");
-    return fetch(sfzUrl).then((r) => r.text()).then(
+    return fetchOk(sfzUrl).then((r) => r.text()).then(
       (sfzText) => smplr.loadInstrument(
         sfzToPreset(sfzText, {
           baseUrl: SMOLKEN_BASE_URL,
@@ -3807,8 +3826,7 @@ function fetchSoundfontLoopData(url, sampleRate = 44100) {
   return __async(this, null, function* () {
     if (!url) return void 0;
     try {
-      const req = yield fetch(url);
-      if (req.status !== 200) return;
+      const req = yield fetchOk(url);
       const raw = yield req.json();
       const loopData = {};
       Object.keys(raw).forEach((key) => {
@@ -3961,7 +3979,7 @@ function removeBase64Prefix(audioBase64) {
   return audioBase64.slice(audioBase64.indexOf(",") + 1);
 }
 function base64ToArrayBuffer(base64) {
-  const decoded = window.atob(base64);
+  const decoded = atob(base64);
   const len = decoded.length;
   const bytes = new Uint8Array(len);
   for (let i = 0; i < len; i++) {
@@ -4018,7 +4036,11 @@ var Soundfont2 = Instrument(
         const sf2inst = soundfont == null ? void 0 : soundfont.instruments.find(
           (inst) => inst.header.name === instrumentName
         );
-        if (!sf2inst) return void 0;
+        if (!sf2inst) {
+          throw new Error(
+            `Soundfont2: instrument "${instrumentName}" not found`
+          );
+        }
         const { json, buffers } = sf2InstrumentToPreset(sf2inst, ctx);
         return baseLoadInstrument(json, buffers);
       }