smplr 0.12.1 → 0.12.3

package/README.md

@@ -296,16 +296,21 @@ const piano = new SplendidGrandPiano(context, { storage });
 
 ### Sampler
 
-An audio buffer sampler.
+An audio buffer sampler. Pass a `buffers` object with the files to be load:
 
 ```js
 import { Sampler } from "smplr";
 
-const samples = {
+const buffers = {
   kick: "https://danigb.github.io/samples/drum-machines/808-mini/kick.m4a",
   snare: "https://danigb.github.io/samples/drum-machines/808-mini/snare-1.m4a",
 };
-const sampler = new Sampler(new AudioContext(), { samples });
+const sampler = new Sampler(new AudioContext(), { buffers });
+```
+
+And then use the name of the buffer as note name:
+
+```js
 sampler.start({ note: "kick" });
 ```
 

package/dist/index.d.mts

@@ -76,6 +76,9 @@ type SampleStop = {
     stopId?: string | number;
     time?: number;
 };
+/**
+ * Configurable options for a sample
+ */
 type SampleOptions = {
     decayTime?: number;
     detune?: number;
@@ -87,6 +90,9 @@ type SampleOptions = {
     loopEnd?: number;
     gainOffset?: number;
 };
+/**
+ * Start a sample with a specific options
+ */
 type SampleStart = {
     name?: string;
     note: string | number;
@@ -97,6 +103,12 @@ type SampleStart = {
     time?: number;
 } & SampleOptions;
 /**
+ * Represents a playable region for a sample.
+ *
+ * It provides constrains to limit which samples are affected,
+ * and defaults to apply to the affected samples.
+ *
+ *
  * Heavily inspired by SFZ format
  */
 type SampleRegion = {

package/dist/index.d.ts

@@ -76,6 +76,9 @@ type SampleStop = {
     stopId?: string | number;
     time?: number;
 };
+/**
+ * Configurable options for a sample
+ */
 type SampleOptions = {
     decayTime?: number;
     detune?: number;
@@ -87,6 +90,9 @@ type SampleOptions = {
     loopEnd?: number;
     gainOffset?: number;
 };
+/**
+ * Start a sample with a specific options
+ */
 type SampleStart = {
     name?: string;
     note: string | number;
@@ -97,6 +103,12 @@ type SampleStart = {
     time?: number;
 } & SampleOptions;
 /**
+ * Represents a playable region for a sample.
+ *
+ * It provides constrains to limit which samples are affected,
+ * and defaults to apply to the affected samples.
+ *
+ *
  * Heavily inspired by SFZ format
  */
 type SampleRegion = {

package/dist/index.js

@@ -1116,7 +1116,7 @@ function findFirstSampleInRegions(group, sample, seqNumber) {
 }
 function findSampleInRegion(midi, seqNum, sample, region, defaults) {
   var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A;
-  const matchMidi = midi >= ((_a = region.midiLow) != null ? _a : 0) && midi <= ((_b = region.midiHigh) != null ? _b : 127);
+  const matchMidi = midi >= ((_a = region.midiLow) != null ? _a : 0) && midi < ((_b = region.midiHigh) != null ? _b : 127) + 1;
   if (!matchMidi)
     return void 0;
   const matchVelocity = sample.velocity === void 0 || sample.velocity >= ((_c = region.velLow) != null ? _c : 0) && sample.velocity <= ((_d = region.velHigh) != null ? _d : 127);