polyphon 0.0.0-stage → 0.1.0

package/dist/instruments/dsp/reverb.js

@@ -0,0 +1,47 @@
+// Procedural reverb: a stereo impulse response of decaying noise whose highs fade faster than its lows.
+import { rng } from './core.js';
+/** Generate a stereo impulse response: decaying noise, with the highs eaten away over time */
+export function impulse(sr, o) {
+    const len = Math.floor(sr * Math.min(8, o.size * 1.15 + (o.preDelay ?? 0) + 0.05));
+    const pre = Math.floor((o.preDelay ?? 0.012) * sr);
+    const damp = o.damp ?? 0.45;
+    const out = [new Float32Array(len), new Float32Array(len)];
+    for (let ch = 0; ch < 2; ch++) {
+        const r = rng(1234 + ch * 777);
+        const d = out[ch];
+        const k = Math.pow(10, -3 / (o.size * sr));
+        let env = 1;
+        let lp = 0;
+        for (let i = pre; i < len; i++) {
+            const t = (i - pre) / sr;
+            // The low-pass coefficient shrinks over time: darker toward the end
+            const a = Math.max(0.02, (1 - damp * 0.85) * Math.exp((-t * damp * 3) / Math.max(0.5, o.size)));
+            lp += a * (r() - lp);
+            let v = lp * env;
+            if (o.bloom)
+                v *= 1 - Math.exp(-t / o.bloom);
+            d[i] = v;
+            env *= k;
+        }
+        // Early reflections
+        const er = o.early ?? 0.3;
+        if (er > 0) {
+            for (let j = 0; j < 8; j++) {
+                const at = pre + Math.floor((0.004 + Math.abs(r()) * 0.06) * sr);
+                if (at < len)
+                    d[at] += er * (0.5 + 0.5 * Math.abs(r())) * (r() > 0 ? 1 : -1) * 0.6;
+            }
+        }
+    }
+    // Energy normalization: rooms of different sizes come out equally loud
+    let e = 0;
+    for (const d of out)
+        for (let i = 0; i < d.length; i++)
+            e += d[i] * d[i];
+    const g = 1 / Math.sqrt(e / 2 + 1e-9);
+    for (const d of out)
+        for (let i = 0; i < d.length; i++)
+            d[i] *= g * 0.5;
+    return out;
+}
+//# sourceMappingURL=reverb.js.map

package/dist/instruments/dsp/reverb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverb.js","sourceRoot":"","sources":["../../../src/instruments/dsp/reverb.ts"],"names":[],"mappings":"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"}

package/dist/instruments/dsp/staccato.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Spiccato strings: the bow drops onto the string, draws a few periods of sawtooth (Helmholtz) motion, bounces off, and the string rings on freely.
+ * - Bowed for the first 40-65 ms: harmonics falling as 1/k through the body, the bite of the bow lightening as it bounces, and the rustle
+ *   of the hair catching the string.
+ * - Then free: each partial decays at its own rate. The string's internal losses and the bridge take more energy per second from the
+ *   upper partials (the decay rate grows with frequency), so they are gone within ~0.1 s while the fundamental rings on and the note
+ *   darkens as it dies, like a pizzicato. (One envelope on every partial kept the attack's bright tone to the end, like a gated synth.)
+ * - Five players a few cents and a few milliseconds apart: three copies at ±7 cents beat like a chorus.
+ */
+export declare function spicc(sr: number, m: number): Float32Array;
+/**
+ * Brass stab: a short forte blat from two players, a few cents and 12 ms apart. As in the live brass (voices.ts), the lips are a valve whose
+ * harmonics fall as e^(-f/F), with F following the loudness: the harmonics come in one after another during the attack, the note is brassiest
+ * at its peak and darkens as it dies away. The bell radiates the lows poorly and the cup rolls off the top (first-order corners at 1.1 and 6 kHz).
+ * Levelled on its first 250 ms, so every pitch hits equally hard.
+ */
+export declare function brassStab(sr: number, m: number): Float32Array;
+//# sourceMappingURL=staccato.d.ts.map

package/dist/instruments/dsp/staccato.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staccato.d.ts","sourceRoot":"","sources":["../../../src/instruments/dsp/staccato.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CA6CzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CA0E7D"}

package/dist/instruments/dsp/staccato.js

@@ -0,0 +1,147 @@
+// Short sampled notes for fast figures (much cheaper than live synthesis): spiccato strings and brass stabs.
+import { Biquad, rng, tailFade } from './core.js';
+/**
+ * Spiccato strings: the bow drops onto the string, draws a few periods of sawtooth (Helmholtz) motion, bounces off, and the string rings on freely.
+ * - Bowed for the first 40-65 ms: harmonics falling as 1/k through the body, the bite of the bow lightening as it bounces, and the rustle
+ *   of the hair catching the string.
+ * - Then free: each partial decays at its own rate. The string's internal losses and the bridge take more energy per second from the
+ *   upper partials (the decay rate grows with frequency), so they are gone within ~0.1 s while the fundamental rings on and the note
+ *   darkens as it dies, like a pizzicato. (One envelope on every partial kept the attack's bright tone to the end, like a gated synth.)
+ * - Five players a few cents and a few milliseconds apart: three copies at ±7 cents beat like a chorus.
+ */
+export function spicc(sr, m) {
+    const f = 440 * Math.pow(2, (m - 69) / 12);
+    const y = new Float32Array(Math.floor(sr * 0.42));
+    const nyq = sr * 0.42;
+    const body = (hz) => 0.4 + 1.2 / (1 + ((hz - 450) / 250) ** 2) + 0.7 / (1 + ((hz - 1300) / 500) ** 2) + 0.5 / (1 + ((hz - 3000) / 900) ** 2);
+    const r = rng(m * 5 + 1);
+    // The bow bites and lightens as it bounces (shared by every partial)
+    const acc = new Float32Array(y.length);
+    for (let i = 0; i < y.length; i++)
+        acc[i] = Math.min(1, i / sr / 0.008) * (0.25 + 0.75 * Math.exp(-i / sr / 0.06));
+    for (let p = 0; p < 5; p++) {
+        const ff = f * Math.pow(2, (5 * r()) / 1200);
+        const i0 = Math.floor(((r() + 1) / 2) * 0.012 * sr);
+        // The bow leaves the string
+        const i1 = i0 + Math.floor((0.052 + 0.012 * r()) * sr);
+        for (let k = 1; k < 40; k++) {
+            const hz = ff * k;
+            if (hz > nyq)
+                break;
+            // Decay rate of the free string (nepers per second): T60 ≈ 0.5 s for the fundamental of A3, 0.09 s at 3 kHz
+            const dk = Math.exp(-(6 + 0.025 * hz) / sr);
+            let e = (0.77 * body(hz)) / k / (1 + (hz / 4500) ** 2);
+            // A rotating phasor from a random phase (cheaper than Math.sin per sample)
+            const w = (2 * Math.PI * hz) / sr;
+            const c = Math.cos(w);
+            const s = Math.sin(w);
+            const ph = r() * Math.PI;
+            let x = Math.cos(ph);
+            let z = Math.sin(ph);
+            for (let i = i0; i < y.length; i++) {
+                y[i] += z * e * acc[i - i0];
+                const nx = x * c - z * s;
+                z = x * s + z * c;
+                x = nx;
+                if (i >= i1)
+                    e *= dk;
+            }
+        }
+    }
+    const noise = new Biquad(sr, 'bp', Math.min(7000, f * 5), 1.2);
+    for (let i = 0; i < y.length; i++)
+        y[i] += noise.run(r()) * 0.6 * Math.exp(-i / sr / 0.03);
+    // Levelled on the first 150 ms (the old peak normalization left notes ±3 dB apart at random; this is their average)
+    let e = 0;
+    const w = Math.floor(sr * 0.15);
+    for (let i = 0; i < w; i++)
+        e += y[i] * y[i];
+    const g = 0.24 / (Math.sqrt(e / w) || 1);
+    for (let i = 0; i < y.length; i++)
+        y[i] *= g;
+    return tailFade(y, sr);
+}
+/**
+ * Brass stab: a short forte blat from two players, a few cents and 12 ms apart. As in the live brass (voices.ts), the lips are a valve whose
+ * harmonics fall as e^(-f/F), with F following the loudness: the harmonics come in one after another during the attack, the note is brassiest
+ * at its peak and darkens as it dies away. The bell radiates the lows poorly and the cup rolls off the top (first-order corners at 1.1 and 6 kHz).
+ * Levelled on its first 250 ms, so every pitch hits equally hard.
+ */
+export function brassStab(sr, m) {
+    const f = 440 * Math.pow(2, (m - 69) / 12);
+    const y = new Float32Array(Math.floor(sr * 0.55));
+    const nyq = sr * 0.42;
+    const r = rng(m * 3 + 9);
+    const lo = 1100;
+    const hi = 6000;
+    const env = (t) => Math.min(1, t / 0.02) * Math.exp(-t / 0.28);
+    const BLOCK = 32;
+    for (const [det, delay] of [[-6, 0], [6, 0.012]]) {
+        const ff = f * Math.pow(2, det / 1200);
+        const n = Math.min(80, Math.floor(nyq / ff));
+        // Each harmonic is a rotating phasor (cheap sines) from a random phase, with the bell's response and the rotation over one block
+        const bell = new Float64Array(n + 1);
+        const re = new Float64Array(n + 1);
+        const im = new Float64Array(n + 1);
+        const cw = new Float64Array(n + 1);
+        const sw = new Float64Array(n + 1);
+        const cb = new Float64Array(n + 1);
+        const sb = new Float64Array(n + 1);
+        for (let k = 1; k <= n; k++) {
+            const hz = ff * k;
+            bell[k] = ((lo + hi) * hz) / Math.sqrt((hz * hz + lo * lo) * (hz * hz + hi * hi));
+            const ph = r() * Math.PI;
+            const w = (2 * Math.PI * hz) / sr;
+            re[k] = Math.cos(ph);
+            im[k] = Math.sin(ph);
+            cw[k] = Math.cos(w);
+            sw[k] = Math.sin(w);
+            cb[k] = Math.cos(w * BLOCK);
+            sb[k] = Math.sin(w * BLOCK);
+        }
+        const amp = new Float64Array(n + 1);
+        const i0 = Math.floor(delay * sr);
+        // (The last part-block falls inside the tail fade and is left silent)
+        for (let b = i0; b + BLOCK <= y.length; b += BLOCK) {
+            // Per block: the fall-off F from the loudness, then the harmonics' amplitudes, scaled so the loudness follows the envelope
+            const e = env((b - i0) / sr);
+            const rr = Math.exp(-ff / (2400 * (0.25 + 0.75 * Math.pow(e, 0.7))));
+            let rn = 1;
+            let s = 0;
+            for (let k = 1; k <= n; k++) {
+                rn *= rr;
+                amp[k] = rn * bell[k];
+                s += amp[k] * amp[k];
+            }
+            const g = e / (Math.sqrt(s) || 1);
+            for (let k = 1; k <= n; k++) {
+                const a = amp[k] * g;
+                let x = re[k];
+                let z = im[k];
+                if (a < 1e-6) {
+                    // Too weak to hear: just turn the phasor on by a block
+                    re[k] = x * cb[k] - z * sb[k];
+                    im[k] = x * sb[k] + z * cb[k];
+                    continue;
+                }
+                for (let i = b; i < b + BLOCK; i++) {
+                    y[i] += z * a;
+                    const nx = x * cw[k] - z * sw[k];
+                    z = x * sw[k] + z * cw[k];
+                    x = nx;
+                }
+                re[k] = x;
+                im[k] = z;
+            }
+        }
+    }
+    let e = 0;
+    const w = Math.min(y.length, Math.floor(sr * 0.25));
+    for (let i = 0; i < w; i++)
+        e += y[i] * y[i];
+    const k = 0.29 / (Math.sqrt(e / w) || 1);
+    for (let i = 0; i < y.length; i++)
+        y[i] *= k;
+    return tailFade(y, sr);
+}
+//# sourceMappingURL=staccato.js.map

package/dist/instruments/dsp/staccato.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staccato.js","sourceRoot":"","sources":["../../../src/instruments/dsp/staccato.ts"],"names":[],"mappings":"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"}

package/dist/instruments/play.d.ts

@@ -0,0 +1,21 @@
+export interface NoteCall {
+    ctx: BaseAudioContext;
+    out: AudioNode;
+    /** Start time (context seconds) */
+    t: number;
+    /** Held length (seconds) */
+    dur: number;
+    /** MIDI pitch (0 for unpitched drums) */
+    m: number;
+    /** 0-1 */
+    vel: number;
+    /** Glides: [seconds after the start, target MIDI pitch] */
+    bends?: [number, number][];
+    /** The track's instrument parameters */
+    params?: Readonly<Record<string, number>>;
+    /** Bowed strings: the desk (players) of the track, 0 for the first (see deskList in compile.ts) */
+    desk?: number;
+}
+/** Play one note */
+export declare function playNote(name: string, c: NoteCall): void;
+//# sourceMappingURL=play.d.ts.map

package/dist/instruments/play.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"play.d.ts","sourceRoot":"","sources":["../../src/instruments/play.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,EAAE,SAAS,CAAC;IACf,mCAAmC;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,CAAC,EAAE,MAAM,CAAC;IACV,UAAU;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,wCAAwC;IACxC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oBAAoB;AACpB,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAgExD"}

package/dist/instruments/play.js

@@ -0,0 +1,140 @@
+// Play one note on any instrument: a cached sample, a bowed sample with a looping sustain, or a live voice.
+import { DESKS } from './bowed.js';
+import { midiToFrequency } from './definition.js';
+import { getInstrument } from './registry.js';
+import { getSample, hasSample, loopOf, sampleMidi } from './samples.js';
+/** Play one note */
+export function playNote(name, c) {
+    const def = getInstrument(name);
+    const amp = Math.pow(c.vel, 1.4) * def.level;
+    if (def.kind === 'live') {
+        def.voice({ ctx: c.ctx, out: c.out, t: c.t, dur: c.dur, f: midiToFrequency(c.m), vel: amp, touch: c.vel, bends: c.bends?.map(([at, m]) => [at, midiToFrequency(m)]), o: c.params ?? {} });
+        return;
+    }
+    if (def.bow) {
+        playBow(def, name, c, amp);
+        return;
+    }
+    const variant = Math.floor(Math.random() * (def.variants ?? 1));
+    const b = getSample(c.ctx, def, name, c.m, variant);
+    const src = c.ctx.createBufferSource();
+    src.buffer = b;
+    // A fixed-pitch drum given a different note is tuned by changing the playback rate (taiko, tom and others are already rendered by pitch and never reach here)
+    if (def.fixed !== undefined && c.m && c.m !== def.fixed && (c.params?.tune ?? 0) > 0)
+        src.playbackRate.value = Math.pow(2, (c.m - def.fixed) / 12);
+    const g = c.ctx.createGain();
+    if (def.loop) {
+        src.loop = true;
+        const a = c.params?.attack ?? 1.5;
+        const r = c.params?.release ?? 1.5;
+        g.gain.setValueAtTime(0, c.t);
+        g.gain.linearRampToValueAtTime(amp, c.t + a);
+        g.gain.setValueAtTime(amp, c.t + Math.max(a, c.dur));
+        g.gain.linearRampToValueAtTime(0, c.t + Math.max(a, c.dur) + r);
+        src.connect(g).connect(c.out);
+        src.start(c.t, (c.t * 7.3) % b.duration);
+        src.stop(c.t + Math.max(a, c.dur) + r + 0.05);
+        return;
+    }
+    g.gain.value = amp;
+    if (def.choke)
+        choke(c, def.choke, g.gain);
+    let out = c.out;
+    if (def.spread) {
+        const pan = c.ctx.createStereoPanner();
+        pan.pan.value = Math.max(-1, Math.min(1, (c.m - 64) / 36)) * def.spread;
+        pan.connect(c.out);
+        out = pan;
+    }
+    if (def.tone) {
+        const lp = c.ctx.createBiquadFilter();
+        lp.type = 'lowpass';
+        lp.frequency.value = Math.min(c.ctx.sampleRate * 0.45, def.tone(c.m, c.vel));
+        // The Web Audio low-pass Q is the resonance in decibels: -3 dB is roughly Butterworth, with no nasal tone
+        lp.Q.value = -3;
+        src.connect(lp).connect(g).connect(out);
+    }
+    else
+        src.connect(g).connect(out);
+    src.start(c.t);
+    const r = c.params?.release ?? def.damper?.(c.m) ?? def.release ?? 0.2;
+    if (def.hold === 'damp' && !(c.params?.ring ?? 0) && r !== Infinity) {
+        const off = c.t + Math.max(def.minHold ?? 0.03, c.dur);
+        g.gain.setValueAtTime(amp, off);
+        if (def.afterRing) {
+            // The damper stops the string quickly, but a faint ring stays a moment longer
+            const [level, fade] = def.afterRing;
+            g.gain.setTargetAtTime(amp * level, off, r / 4);
+            g.gain.setTargetAtTime(1e-4, off + r, fade / 6.9);
+            src.stop(Math.min(off + r + fade, c.t + b.duration));
+        }
+        else {
+            g.gain.setTargetAtTime(1e-4, off, r / 4);
+            src.stop(Math.min(off + r * 1.5, c.t + b.duration));
+        }
+    }
+    else
+        src.stop(c.t + b.duration);
+}
+/** The gain of the note last started in each choke group, per audio context */
+const chokeGroups = new WeakMap();
+/** Cut off the note still ringing in a choke group as this one starts (notes are scheduled in time order), and make this one the group's */
+function choke(c, group, gain) {
+    let groups = chokeGroups.get(c.ctx);
+    if (!groups)
+        chokeGroups.set(c.ctx, (groups = new Map()));
+    const ringing = groups.get(group);
+    if (ringing) {
+        // The target of setTargetAtTime cannot be 0 (some implementations diverge): fade toward silence, then close
+        ringing.cancelScheduledValues(c.t);
+        ringing.setTargetAtTime(1e-4, c.t, 0.004);
+        ringing.setValueAtTime(0, c.t + 0.04);
+    }
+    groups.set(group, gain);
+}
+/** Bowed strings: pick the soft or hard layer, make up pitch with a rate change, loop the sustain section, and lift the bow when the note ends */
+function playBow(def, name, c, amp) {
+    const bw = def.bow;
+    const o = c.params ?? {};
+    let loud = c.vel * (o.bright ?? 1) > bw.loudAt ? 1 : 0;
+    const root = sampleMidi(def, c.m);
+    // If this layer is not prepared but the other one is: use the other for now, rather than rendering during playback (that would stall);
+    // a desk with neither prepared borrows the first desk's players
+    const has = (layer, desk) => hasSample(c.ctx.sampleRate, def, name, c.m, layer, desk);
+    const seat = DESKS[(c.desk ?? 0) % DESKS.length];
+    let desk = DESKS.indexOf(seat);
+    if (desk && !has(0, desk) && !has(1, desk) && (has(0, 0) || has(1, 0)))
+        desk = 0;
+    if (!has(loud, desk) && has(1 - loud, desk))
+        loud = 1 - loud;
+    const b = getSample(c.ctx, def, name, c.m, loud, desk);
+    const src = c.ctx.createBufferSource();
+    src.buffer = b;
+    const lp = loopOf(b);
+    if (lp) {
+        src.loop = true;
+        src.loopStart = lp[0];
+        src.loopEnd = lp[1];
+    }
+    const rate = src.playbackRate;
+    rate.setValueAtTime(Math.pow(2, (c.m - root) / 12), c.t);
+    const glide = o.glide ?? bw.glide;
+    if (c.bends)
+        for (const [at, m] of c.bends)
+            rate.setTargetAtTime(Math.pow(2, (m - root) / 12), c.t + at, glide / 3);
+    const a = Math.max(0.005, o.attack ?? bw.attack);
+    const r = o.release ?? bw.release;
+    const off = c.t + Math.max(c.dur, 0.06);
+    // A desk after the first lands its bow a little behind the first desk's, by a different amount every note; it lifts it with the others
+    const t = c.t + (seat.lag && seat.lag * (0.5 + Math.random()));
+    const g = c.ctx.createGain();
+    const p = g.gain;
+    p.setValueAtTime(0, t);
+    p.linearRampToValueAtTime(amp, t + Math.min(a, Math.max(0.005, off - t)));
+    p.setValueAtTime(amp, off);
+    p.setTargetAtTime(1e-4, off, r / 4);
+    src.connect(g).connect(c.out);
+    src.start(t);
+    src.stop(off + r * 1.6 + 0.02);
+}
+//# sourceMappingURL=play.js.map

package/dist/instruments/play.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"play.js","sourceRoot":"","sources":["../../src/instruments/play.ts"],"names":[],"mappings":"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"}

package/dist/instruments/registry.d.ts

@@ -0,0 +1,63 @@
+import { type BuiltInInstrument } from './builtin.ts';
+import type { InstrumentDef } from './definition.ts';
+/** An instrument name. Built-in names autocomplete; any registered name is accepted too. */
+export type InstrumentName = BuiltInInstrument | (string & {});
+/** One note handed to a custom synthesized instrument */
+export interface SynthNote {
+    context: BaseAudioContext;
+    /** Connect the note's output here */
+    destination: AudioNode;
+    /** Start time (context seconds) */
+    time: number;
+    /** How long the note is held (seconds); the release comes after this */
+    duration: number;
+    /** Frequency (Hz) */
+    frequency: number;
+    /** Loudness 0-1, already shaped by the instrument's level */
+    velocity: number;
+    /** Glides: [seconds after the start, target frequency in Hz] */
+    glides: [number, number][];
+    /** The track's `params`, for instrument-specific settings */
+    params: Readonly<Record<string, number>>;
+}
+/** A custom instrument rendered offline, once per pitch, then played back from a buffer */
+export interface CustomSampledInstrument {
+    /** Render one note: mono, or [left, right] */
+    render(sampleRate: number, midi: number): Float32Array | [Float32Array, Float32Array];
+    /** 'ring' (default) plays the whole sample; 'damp' fades it out `release` seconds after the note ends */
+    sustain?: 'ring' | 'damp';
+    /** Release time in seconds for 'damp' (default 0.2) */
+    release?: number;
+    /** Output level (default 1) */
+    level?: number;
+}
+/** A custom instrument synthesized live, note by note */
+export interface CustomSynthInstrument {
+    /** Build the Web Audio graph for one note */
+    play(note: SynthNote): void;
+    /** Output level (default 1) */
+    level?: number;
+    /** Supports glides between notes (the `>` marker in a melody) */
+    glide?: boolean;
+}
+export type CustomInstrument = CustomSampledInstrument | CustomSynthInstrument;
+/**
+ * Add an instrument (or replace one) under a name tracks can use.
+ *
+ * @example
+ * registerInstrument('beep', {
+ *   play({ context, destination, time, duration, frequency, velocity }) {
+ *     const osc = new OscillatorNode(context, { type: 'square', frequency });
+ *     const amp = new GainNode(context, { gain: velocity * 0.2 });
+ *     osc.connect(amp).connect(destination);
+ *     osc.start(time);
+ *     osc.stop(time + duration);
+ *   },
+ * });
+ */
+export declare function registerInstrument(name: string, instrument: CustomInstrument): void;
+/** Every instrument name currently available */
+export declare function instrumentNames(): string[];
+/** Look up an instrument; throws a helpful error for unknown names */
+export declare function getInstrument(name: string): InstrumentDef;
+//# sourceMappingURL=registry.d.ts.map

package/dist/instruments/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/instruments/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,4FAA4F;AAC5F,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/D,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,qCAAqC;IACrC,WAAW,EAAE,SAAS,CAAC;IACvB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1C;AAED,2FAA2F;AAC3F,MAAM,WAAW,uBAAuB;IACtC,8CAA8C;IAC9C,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACtF,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAI/E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAmBnF;AAED,gDAAgD;AAChD,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAIzD"}

package/dist/instruments/registry.js

@@ -0,0 +1,50 @@
+// The instrument registry: every name a track can use, built-in or registered by the application.
+import { BUILT_IN } from './builtin.js';
+import { forgetSamples } from './samples.js';
+const registry = new Map(Object.entries(BUILT_IN));
+/**
+ * Add an instrument (or replace one) under a name tracks can use.
+ *
+ * @example
+ * registerInstrument('beep', {
+ *   play({ context, destination, time, duration, frequency, velocity }) {
+ *     const osc = new OscillatorNode(context, { type: 'square', frequency });
+ *     const amp = new GainNode(context, { gain: velocity * 0.2 });
+ *     osc.connect(amp).connect(destination);
+ *     osc.start(time);
+ *     osc.stop(time + duration);
+ *   },
+ * });
+ */
+export function registerInstrument(name, instrument) {
+    forgetSamples(name);
+    if ('play' in instrument) {
+        registry.set(name, {
+            kind: 'live',
+            level: instrument.level ?? 1,
+            glide: instrument.glide ?? false,
+            voice: (c) => instrument.play({ context: c.ctx, destination: c.out, time: c.t, duration: c.dur, frequency: c.f, velocity: c.vel, glides: c.bends ?? [], params: c.o }),
+        });
+    }
+    else {
+        registry.set(name, {
+            kind: 'sample',
+            render: (sampleRate, midi) => instrument.render(sampleRate, midi),
+            hold: instrument.sustain ?? 'ring',
+            release: instrument.release ?? 0.2,
+            level: instrument.level ?? 1,
+        });
+    }
+}
+/** Every instrument name currently available */
+export function instrumentNames() {
+    return [...registry.keys()];
+}
+/** Look up an instrument; throws a helpful error for unknown names */
+export function getInstrument(name) {
+    const def = registry.get(name);
+    if (!def)
+        throw new Error(`Unknown instrument "${name}". Available: ${instrumentNames().join(', ')}`);
+    return def;
+}
+//# sourceMappingURL=registry.js.map

package/dist/instruments/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/instruments/registry.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG,OAAO,EAAE,QAAQ,EAA0B,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgD7C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAwB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAA4B;IAC3E,aAAa,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;YACjB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,CAAC;YAC5B,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,KAAK;YAChC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CACX,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3J,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC;YACjE,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,MAAM;YAClC,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,GAAG;YAClC,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,iBAAiB,eAAe,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtG,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/instruments/samples.d.ts

@@ -0,0 +1,30 @@
+import type { SampledInstrument } from './definition.ts';
+/** A sample a song needs rendered before it plays */
+export interface SampleRequest {
+    def: SampledInstrument;
+    name: string;
+    midi: number;
+    /** Only this layer (bowed strings pick soft or hard by velocity) */
+    layer?: number;
+    /** Bowed strings: the desk (players) of the track that plays it, 0 for the first */
+    desk?: number;
+}
+/** The pitch actually rendered: bowed strings sample every few semitones, fixed-pitch drums always use one note */
+export declare function sampleMidi(def: SampledInstrument, midi: number): number;
+/** Which layer a bowed string uses at this velocity (times params.bright); near the threshold both layers are prepared (velocity has a little randomness at playback) */
+export declare function bowLayers(def: SampledInstrument, velocity: number, bright?: number): number[];
+/** How many variants of a sampled instrument to precompute (random variants for drums; the soft and hard layers for bowed strings) */
+export declare const variantsOf: (def: SampledInstrument) => number;
+/** Whether a sample is already rendered */
+export declare function hasSample(sampleRate: number, def: SampledInstrument, name: string, midi: number, variant: number, desk?: number): boolean;
+/** The loop section (seconds) of a bowed sample, if it has one */
+export declare const loopOf: (buffer: AudioBuffer) => [number, number] | undefined;
+/** Render (or fetch from the cache) a sample */
+export declare function getSample(ctx: BaseAudioContext, def: SampledInstrument, name: string, midi: number, variant?: number, desk?: number): AudioBuffer;
+/** Drop every cached sample of an instrument (after it is redefined) */
+export declare function forgetSamples(name: string): void;
+/** Render samples ahead of time; after more than 12 ms of continuous work, yield the main thread for a moment (so the screen does not stall) */
+export declare function prepareSamples(ctx: BaseAudioContext, requests: Iterable<SampleRequest>): Promise<void>;
+/** Synchronous version (offline rendering, short play-once jingles) */
+export declare function prepareSamplesSync(ctx: BaseAudioContext, requests: Iterable<SampleRequest>): void;
+//# sourceMappingURL=samples.d.ts.map

package/dist/instruments/samples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples.d.ts","sourceRoot":"","sources":["../../src/instruments/samples.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,iBAAiB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,mHAAmH;AACnH,wBAAgB,UAAU,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvE;AAkBD,yKAAyK;AACzK,wBAAgB,SAAS,CAAC,GAAG,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,EAAE,CAKxF;AAED,sIAAsI;AACtI,eAAO,MAAM,UAAU,QAAS,iBAAiB,KAAG,MAA6C,CAAC;AAKlG,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAEpI;AAED,kEAAkE;AAClE,eAAO,MAAM,MAAM,WAAY,WAAW,KAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAA8B,CAAC;AAE/F,gDAAgD;AAChD,wBAAgB,SAAS,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAI,EAAE,IAAI,SAAI,GAAG,WAAW,CAmBvI;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhD;AAOD,gJAAgJ;AAChJ,wBAAsB,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5G;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAEjG"}