polyphon 0.0.0-stage → 0.1.0

package/dist/engine/jukebox.d.ts

@@ -0,0 +1,113 @@
+import type { Song } from '../song.ts';
+import { Playback } from './playback.ts';
+/** A song, or a function that loads one (`() => import('./songs/title.ts')` works: a module's default export is used) */
+export type SongSource = Song | (() => Promise<Song | {
+    default: Song;
+}>);
+export interface JukeboxOptions {
+    /** Use this AudioContext (default: one is created on first use) */
+    context?: AudioContext;
+    /** Where the music goes (default: the speakers) */
+    destination?: AudioNode;
+    /** Songs that can be played by name */
+    songs?: Record<string, SongSource>;
+    /** 0-1 (default 1) */
+    volume?: number;
+}
+export interface PlayOptions {
+    /** Seconds to fade the previous song out (default 0.9) */
+    fadeOut?: number;
+    /** Seconds to fade this song in (default: 0.05 if it has an intro, otherwise 1.2) */
+    fadeIn?: number;
+    /** Start this many seconds into the song */
+    from?: number;
+    /** How many times the body plays before the song ends (default: forever, or once if `song.loop` is false) */
+    loops?: number;
+}
+export interface DuckOptions {
+    /** Seconds to reach the ducked level (default 0: instantly) */
+    attack?: number;
+    /** Seconds to stay there (default 0) */
+    hold?: number;
+    /** Seconds to come back (default 0.35) */
+    release?: number;
+}
+export type JukeboxState = 'idle' | 'loading' | 'playing' | 'paused';
+export declare class Jukebox {
+    private ctx;
+    private readonly destination?;
+    private readonly songs;
+    private readonly loaded;
+    /** The music buses, each a volume and a duck gain: [into the output stage, around it for songs mastered loud] */
+    private buses;
+    private volumeLevel;
+    private timer;
+    /** Incremented whenever the current song changes: a song still loading only starts if nothing replaced it */
+    private token;
+    /** The song asked for last (it may still be loading) */
+    private wanted;
+    private pending;
+    private song;
+    /** The loop count the current song was asked to play with */
+    private loops;
+    private active;
+    private pausedAt;
+    /** Mute states to carry into the next playback of the same song (after a seek or a pause) */
+    private carry;
+    /** Preloads queue up behind each other, so they never compete with each other for the main thread */
+    private preloads;
+    constructor(options?: JukeboxOptions);
+    /** The audio context (created on first use; it starts on the first click, tap or key press if the browser requires one) */
+    get context(): AudioContext;
+    /** The song playing, paused, or about to start (null when idle) */
+    get current(): Song | null;
+    /** The current playback, for positions, durations and per-track mixing (a new one starts after every seek or resume) */
+    get playback(): Playback | null;
+    get state(): JukeboxState;
+    /** Seconds into the current song */
+    get position(): number;
+    get volume(): number;
+    set volume(value: number);
+    /**
+     * Play a song (by name, or a song / loader), crossfading from the one before.
+     * Asking for the song that is already playing does nothing; asking for a paused one resumes it.
+     * Resolves with the playback once it starts, or null if another song was asked for before this one was ready.
+     */
+    play(song: string | SongSource, options?: PlayOptions): Promise<Playback | null>;
+    /** Fade the music out and go silent */
+    stop(fade?: number): void;
+    /** Pause the current song (resume() continues from the same point) */
+    pause(): void;
+    /** Continue a paused song */
+    resume(): void;
+    /** Jump to a point in the current song (seconds) */
+    seek(seconds: number): void;
+    /** Render a song's samples ahead of time, so playing it later starts without a wait */
+    preload(song: string | SongSource): Promise<void>;
+    /** Play a short song once on top of whatever is playing (victory jingles, fanfares). Its samples are rendered on the spot. */
+    playOnce(song: Song): Playback;
+    /**
+     * Lower the music for a moment, for example under a big sound effect or a line of dialogue.
+     *
+     * @example
+     * jukebox.duck(-10);                                        // a hit: drop 10 dB, recover over 0.35 s
+     * jukebox.duck(-30, { attack: 0.12, hold: 4, release: 0.6 }); // near silence for a cutscene beat
+     */
+    duck(db: number, { attack, hold, release }?: DuckOptions): void;
+    /** Bring ducked music back now */
+    unduck(release?: number): void;
+    /** Resume the audio context; call from a click or key handler if you want sound to start on that exact gesture */
+    unlock(): Promise<void>;
+    private begin;
+    private start;
+    /** Fade out what is playing and cancel anything still loading; the current song is remembered (for resume and seek) */
+    private halt;
+    private resolve;
+    private load;
+    /** Where a song goes in: songs mastered loud have their own limiter, so they go around the output stage */
+    private busFor;
+    /** Build the music buses (volume → duck → output stage, and volume → duck straight out) and arrange for the context to start on the first user gesture */
+    private connect;
+    private runClock;
+}
+//# sourceMappingURL=jukebox.d.ts.map

package/dist/engine/jukebox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jukebox.d.ts","sourceRoot":"","sources":["../../src/engine/jukebox.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,yHAAyH;AACzH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,mDAAmD;IACnD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6GAA6G;IAC7G,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAMrE,qBAAa,OAAO;IAClB,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,iHAAiH;IACjH,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAA+C;IAC5D,6GAA6G;IAC7G,OAAO,CAAC,KAAK,CAAK;IAClB,wDAAwD;IACxD,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,IAAI,CAAqB;IACjC,6DAA6D;IAC7D,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,6FAA6F;IAC7F,OAAO,CAAC,KAAK,CAAqB;IAClC,qGAAqG;IACrG,OAAO,CAAC,QAAQ,CAAuC;IAEvD,YAAY,OAAO,GAAE,cAAmB,EAKvC;IAED,2HAA2H;IAC3H,IAAI,OAAO,IAAI,YAAY,CAI1B;IAED,mEAAmE;IACnE,IAAI,OAAO,IAAI,IAAI,GAAG,IAAI,CAEzB;IAED,wHAAwH;IACxH,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAE9B;IAED,IAAI,KAAK,IAAI,YAAY,CAIxB;IAED,oCAAoC;IACpC,IAAI,QAAQ,IAAI,MAAM,CAGrB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAGvB;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAgBnF;IAED,uCAAuC;IACvC,IAAI,CAAC,IAAI,SAAM,GAAG,IAAI,CAMrB;IAED,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAMZ;IAED,6BAA6B;IAC7B,MAAM,IAAI,IAAI,CAKb;IAED,oDAAoD;IACpD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS1B;IAED,uFAAuF;IACvF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhD;IAED,8HAA8H;IAC9H,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAM7B;IAED;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,MAAU,EAAE,IAAQ,EAAE,OAAc,EAAE,GAAE,WAAgB,GAAG,IAAI,CAYjF;IAED,kCAAkC;IAClC,MAAM,CAAC,OAAO,SAAM,GAAG,IAAI,CAS1B;IAED,kHAAkH;IAClH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtB;YAEa,KAAK;IAcnB,OAAO,CAAC,KAAK;IAUb,uHAAuH;IACvH,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,IAAI;IAWZ,2GAA2G;IAC3G,OAAO,CAAC,MAAM;IAId,0JAA0J;IAC1J,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,QAAQ;CAQjB"}

package/dist/engine/jukebox.js

@@ -0,0 +1,287 @@
+// The Jukebox: the one object a game needs. It owns the clock, crossfades between songs, prepares samples ahead of time,
+// and handles the browser's audio unlock. One song plays at a time; jingles can be layered on top.
+import { createOutputStage, mastersItself } from './output.js';
+import { Playback } from './playback.js';
+import { prepareSong, prepareSongSync } from './prepare.js';
+/** How far ahead notes are scheduled: a little while visible, much more in a background tab (whose timers are throttled to about once a second) */
+const AHEAD = 0.25;
+const AHEAD_HIDDEN = 1.6;
+export class Jukebox {
+    ctx;
+    destination;
+    songs;
+    loaded = new Map();
+    /** The music buses, each a volume and a duck gain: [into the output stage, around it for songs mastered loud] */
+    buses = [];
+    volumeLevel;
+    timer = null;
+    /** Incremented whenever the current song changes: a song still loading only starts if nothing replaced it */
+    token = 0;
+    /** The song asked for last (it may still be loading) */
+    wanted = null;
+    pending = null;
+    song = null;
+    /** The loop count the current song was asked to play with */
+    loops;
+    active = null;
+    pausedAt = null;
+    /** Mute states to carry into the next playback of the same song (after a seek or a pause) */
+    carry = new Set();
+    /** Preloads queue up behind each other, so they never compete with each other for the main thread */
+    preloads = Promise.resolve();
+    constructor(options = {}) {
+        this.ctx = options.context ?? null;
+        this.destination = options.destination;
+        this.songs = options.songs ?? {};
+        this.volumeLevel = options.volume ?? 1;
+    }
+    /** The audio context (created on first use; it starts on the first click, tap or key press if the browser requires one) */
+    get context() {
+        if (!this.ctx)
+            this.ctx = new AudioContext();
+        if (!this.buses.length)
+            this.connect(this.ctx);
+        return this.ctx;
+    }
+    /** The song playing, paused, or about to start (null when idle) */
+    get current() {
+        return this.song;
+    }
+    /** The current playback, for positions, durations and per-track mixing (a new one starts after every seek or resume) */
+    get playback() {
+        return this.active;
+    }
+    get state() {
+        if (this.pausedAt !== null)
+            return 'paused';
+        if (this.pending)
+            return 'loading';
+        return this.active?.playing ? 'playing' : 'idle';
+    }
+    /** Seconds into the current song */
+    get position() {
+        if (this.pausedAt !== null)
+            return this.pausedAt;
+        return this.active ? this.active.position().seconds : 0;
+    }
+    get volume() {
+        return this.volumeLevel;
+    }
+    set volume(value) {
+        this.volumeLevel = Math.min(1, Math.max(0, value));
+        if (this.ctx)
+            for (const { volume } of this.buses)
+                volume.gain.setTargetAtTime(this.volumeLevel, this.ctx.currentTime, 0.02);
+    }
+    /**
+     * Play a song (by name, or a song / loader), crossfading from the one before.
+     * Asking for the song that is already playing does nothing; asking for a paused one resumes it.
+     * Resolves with the playback once it starts, or null if another song was asked for before this one was ready.
+     */
+    play(song, options = {}) {
+        const source = this.resolve(song);
+        if (source === this.wanted) {
+            if (this.pausedAt !== null) {
+                this.resume();
+                return Promise.resolve(this.active);
+            }
+            if (this.pending)
+                return this.pending;
+            if (this.active?.playing)
+                return Promise.resolve(this.active);
+        }
+        this.halt(options.fadeOut ?? 0.9);
+        this.carry = new Set();
+        this.wanted = source;
+        this.loops = options.loops;
+        this.pending = this.begin(source, this.token, options);
+        return this.pending;
+    }
+    /** Fade the music out and go silent */
+    stop(fade = 0.9) {
+        this.halt(fade);
+        this.wanted = null;
+        this.song = null;
+        if (this.timer !== null)
+            clearInterval(this.timer);
+        this.timer = null;
+    }
+    /** Pause the current song (resume() continues from the same point) */
+    pause() {
+        if (!this.active?.playing)
+            return;
+        const at = this.active.position().seconds;
+        this.carry = mutedTracks(this.active);
+        this.halt(0.12);
+        this.pausedAt = at;
+    }
+    /** Continue a paused song */
+    resume() {
+        if (this.pausedAt === null || !this.song)
+            return;
+        const from = this.pausedAt;
+        this.pausedAt = null;
+        this.start(this.song, { fadeIn: 0.05, from });
+    }
+    /** Jump to a point in the current song (seconds) */
+    seek(seconds) {
+        if (this.pausedAt !== null) {
+            this.pausedAt = Math.max(0, seconds);
+            return;
+        }
+        if (!this.song || !this.active)
+            return;
+        this.carry = mutedTracks(this.active);
+        this.active.stop(0.12);
+        this.start(this.song, { fadeIn: 0.08, from: seconds });
+    }
+    /** Render a song's samples ahead of time, so playing it later starts without a wait */
+    preload(song) {
+        const source = this.resolve(song);
+        const ctx = this.context;
+        const job = this.preloads.then(() => this.load(source)).then((def) => prepareSong(ctx, def));
+        this.preloads = job.catch(() => undefined);
+        return job;
+    }
+    /** Play a short song once on top of whatever is playing (victory jingles, fanfares). Its samples are rendered on the spot. */
+    playOnce(song) {
+        const ctx = this.context;
+        prepareSongSync(ctx, song);
+        const active = new Playback(ctx, this.busFor(song), song, { at: ctx.currentTime + 0.03, loops: 1 });
+        active.schedule(active.startTime + active.duration);
+        return active;
+    }
+    /**
+     * Lower the music for a moment, for example under a big sound effect or a line of dialogue.
+     *
+     * @example
+     * jukebox.duck(-10);                                        // a hit: drop 10 dB, recover over 0.35 s
+     * jukebox.duck(-30, { attack: 0.12, hold: 4, release: 0.6 }); // near silence for a cutscene beat
+     */
+    duck(db, { attack = 0, hold = 0, release = 0.35 } = {}) {
+        if (!this.ctx)
+            return;
+        const t = this.ctx.currentTime;
+        const level = Math.pow(10, db / 20);
+        for (const { duck } of this.buses) {
+            const g = duck.gain;
+            g.cancelScheduledValues(t);
+            g.setValueAtTime(attack > 0 ? g.value : level, t);
+            if (attack > 0)
+                g.linearRampToValueAtTime(level, t + attack);
+            g.setValueAtTime(level, t + attack + hold);
+            g.linearRampToValueAtTime(1, t + attack + hold + release);
+        }
+    }
+    /** Bring ducked music back now */
+    unduck(release = 0.3) {
+        if (!this.ctx)
+            return;
+        const t = this.ctx.currentTime;
+        for (const { duck } of this.buses) {
+            const g = duck.gain;
+            g.cancelScheduledValues(t);
+            g.setValueAtTime(g.value, t);
+            g.linearRampToValueAtTime(1, t + release);
+        }
+    }
+    /** Resume the audio context; call from a click or key handler if you want sound to start on that exact gesture */
+    unlock() {
+        return this.context.resume();
+    }
+    async begin(source, token, options) {
+        try {
+            const ctx = this.context;
+            const song = await this.load(source);
+            if (token !== this.token)
+                return null;
+            this.song = song;
+            await prepareSong(ctx, song);
+            if (token !== this.token)
+                return null;
+            return this.start(song, { fadeIn: options.fadeIn ?? (song.intro?.length ? 0.05 : 1.2), from: options.from });
+        }
+        finally {
+            if (token === this.token)
+                this.pending = null;
+        }
+    }
+    start(song, options) {
+        const ctx = this.context;
+        const active = new Playback(ctx, this.busFor(song), song, { ...options, loops: this.loops, at: ctx.currentTime + 0.08 });
+        for (const t of active.tracks)
+            if (this.carry.has(`${t.section}|${t.name}`))
+                t.muted = true;
+        this.carry = new Set();
+        this.active = active;
+        this.runClock();
+        return active;
+    }
+    /** Fade out what is playing and cancel anything still loading; the current song is remembered (for resume and seek) */
+    halt(fade) {
+        this.token++;
+        this.pending = null;
+        this.pausedAt = null;
+        this.active?.stop(fade);
+        this.active = null;
+    }
+    resolve(song) {
+        if (typeof song !== 'string')
+            return song;
+        const source = this.songs[song];
+        if (!source)
+            throw new Error(`Unknown song "${song}". Known: ${Object.keys(this.songs).join(', ') || '(none)'}`);
+        return source;
+    }
+    load(source) {
+        if (typeof source !== 'function')
+            return Promise.resolve(source);
+        let p = this.loaded.get(source);
+        if (!p) {
+            p = source().then((m) => ('default' in m ? m.default : m));
+            p.catch(() => this.loaded.delete(source));
+            this.loaded.set(source, p);
+        }
+        return p;
+    }
+    /** Where a song goes in: songs mastered loud have their own limiter, so they go around the output stage */
+    busFor(song) {
+        return this.buses[mastersItself(song) ? 1 : 0].volume;
+    }
+    /** Build the music buses (volume → duck → output stage, and volume → duck straight out) and arrange for the context to start on the first user gesture */
+    connect(ctx) {
+        const out = this.destination ?? ctx.destination;
+        this.buses = [createOutputStage(ctx, out), out].map((to) => {
+            const volume = ctx.createGain();
+            volume.gain.value = this.volumeLevel;
+            const duck = ctx.createGain();
+            volume.connect(duck).connect(to);
+            return { volume, duck };
+        });
+        if (ctx.state !== 'suspended' || typeof window === 'undefined')
+            return;
+        const events = ['pointerdown', 'keydown', 'touchend'];
+        const unlock = () => void ctx.resume();
+        for (const e of events)
+            window.addEventListener(e, unlock, { capture: true });
+        ctx.addEventListener('statechange', () => {
+            if (ctx.state === 'running')
+                for (const e of events)
+                    window.removeEventListener(e, unlock, { capture: true });
+        });
+    }
+    runClock() {
+        if (this.timer !== null)
+            return;
+        this.timer = setInterval(() => {
+            if (!this.active || !this.ctx)
+                return;
+            const hidden = typeof document !== 'undefined' && document.hidden;
+            this.active.schedule(this.ctx.currentTime + (hidden ? AHEAD_HIDDEN : AHEAD));
+        }, 25);
+    }
+}
+function mutedTracks(active) {
+    return new Set(active.tracks.filter((t) => t.muted).map((t) => `${t.section}|${t.name}`));
+}
+//# sourceMappingURL=jukebox.js.map

package/dist/engine/jukebox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jukebox.js","sourceRoot":"","sources":["../../src/engine/jukebox.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,mGAAmG;AAGnG,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsC5D,mJAAmJ;AACnJ,MAAM,KAAK,GAAG,IAAI,CAAC;AACnB,MAAM,YAAY,GAAG,GAAG,CAAC;AAEzB,MAAM,OAAO,OAAO;IACV,GAAG,CAAsB;IAChB,WAAW,CAAa;IACxB,KAAK,CAA6B;IAClC,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC/D,iHAAiH;IACzG,KAAK,GAA2C,EAAE,CAAC;IACnD,WAAW,CAAS;IACpB,KAAK,GAA0C,IAAI,CAAC;IAC5D,6GAA6G;IACrG,KAAK,GAAG,CAAC,CAAC;IAClB,wDAAwD;IAChD,MAAM,GAAsB,IAAI,CAAC;IACjC,OAAO,GAAoC,IAAI,CAAC;IAChD,IAAI,GAAgB,IAAI,CAAC;IACjC,6DAA6D;IACrD,KAAK,CAAqB;IAC1B,MAAM,GAAoB,IAAI,CAAC;IAC/B,QAAQ,GAAkB,IAAI,CAAC;IACvC,6FAA6F;IACrF,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,qGAAqG;IAC7F,QAAQ,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEvD,YAAY,OAAO,GAAmB,EAAE;QACtC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,2HAA2H;IAC3H,IAAI,OAAO;QACT,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,mEAAmE;IACnE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,wHAAwH;IACxH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QAC5C,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACnC,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,oCAAoC;IACpC,IAAI,QAAQ;QACV,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,CAAC,KAAa;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,GAAG;YAAE,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC/H,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAyB,EAAE,OAAO,GAAgB,EAAE;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC,OAAO,CAAC;YACtC,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,IAAI,GAAG,GAAG;QACb,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,sEAAsE;IACtE,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO;QAClC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,6BAA6B;IAC7B,MAAM;QACJ,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC,OAAe;QAClB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACvC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,uFAAuF;IACvF,OAAO,CAAC,IAAyB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7F,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,8HAA8H;IAC9H,QAAQ,CAAC,IAAU;QACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACpG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,EAAU,EAAE,EAAE,MAAM,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,EAAE,GAAgB,EAAE;QACzE,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACpC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YACpB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAClD,IAAI,MAAM,GAAG,CAAC;gBAAE,CAAC,CAAC,uBAAuB,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;YAC7D,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,CAAC,OAAO,GAAG,GAAG;QAClB,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,OAAO;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YACpB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC7B,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,kHAAkH;IAClH,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,MAAkB,EAAE,KAAa,EAAE,OAAoB;QACzE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/G,CAAC;gBAAS,CAAC;YACT,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAChD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAU,EAAE,OAA0C;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC,CAAC;QACzH,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;YAAE,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC;QAC5F,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,uHAAuH;IAC/G,IAAI,CAAC,IAAY;QACvB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,OAAO,CAAC,IAAyB;QACvC,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;QACjH,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,IAAI,CAAC,MAAkB;QAC7B,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,2GAA2G;IACnG,MAAM,CAAC,IAAU;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACxD,CAAC;IAED,0JAA0J;IAClJ,OAAO,CAAC,GAAiB;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,WAAW,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACzD,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;YACrC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO;QACvE,MAAM,MAAM,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC;QAC/D,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,MAAM;YAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9E,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,GAAG,EAAE;YACvC,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;gBAAE,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ;QACd,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO;QAChC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,OAAO;YACtC,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC;YAClE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/E,CAAC,EAAE,EAAE,CAAC,CAAC;IACT,CAAC;CACF;AAED,SAAS,WAAW,CAAC,MAAgB;IACnC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5F,CAAC"}

package/dist/engine/mixer.d.ts

@@ -0,0 +1,29 @@
+import { type Room } from '../instruments/dsp/reverb.ts';
+import { type Song } from '../song.ts';
+import { type Pump } from './automation.ts';
+export interface Mixer {
+    /** The song's output (its fades are applied here) */
+    output: GainNode;
+    /** Closes for the song's silences: after the reverb and delay, so their tails stop dead too */
+    gate: GainNode;
+    /** One strip per track, per section: [intro tracks, body tracks] */
+    strips: [Strip[], Strip[]];
+}
+/** A track's channel on the console */
+export interface Strip {
+    /** Where its notes go: the track's level (and mute) */
+    input: GainNode;
+    /** After its filters and ducking, before pan and effects */
+    output: AudioNode;
+    /** Its duck gain, when it ducks under another track */
+    pump?: Pump;
+    /** Its filters' cutoffs that sweep, with their breakpoints */
+    sweeps: {
+        cutoff: AudioParam;
+        points: [number, number][];
+    }[];
+}
+export declare function createMixer(ctx: BaseAudioContext, song: Song, destination: AudioNode): Mixer;
+/** Impulse response of a room (each room is computed once per sample rate) */
+export declare function impulseBuffer(ctx: BaseAudioContext, room: Room): AudioBuffer;
+//# sourceMappingURL=mixer.d.ts.map

package/dist/engine/mixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixer.d.ts","sourceRoot":"","sources":["../../src/engine/mixer.ts"],"names":[],"mappings":"AAQA,OAAO,EAAW,KAAK,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAkB,KAAK,IAAI,EAAc,MAAM,YAAY,CAAC;AACnE,OAAO,EAAyB,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,WAAW,KAAK;IACpB,qDAAqD;IACrD,MAAM,EAAE,QAAQ,CAAC;IACjB,+FAA+F;IAC/F,IAAI,EAAE,QAAQ,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;CAC5B;AAED,uCAAuC;AACvC,MAAM,WAAW,KAAK;IACpB,uDAAuD;IACvD,KAAK,EAAE,QAAQ,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,SAAS,CAAC;IAClB,uDAAuD;IACvD,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,8DAA8D;IAC9D,MAAM,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;KAAE,EAAE,CAAC;CAC9D;AAKD,wBAAgB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,GAAG,KAAK,CAwC5F;AA4ED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAW5E"}

package/dist/engine/mixer.js

@@ -0,0 +1,141 @@
+// Each song brings its own mixing console: per-track level, filters, ducking, pan and effect sends, a convolution reverb, a ping-pong delay
+// and the mastering (EQ, glue compression, and a limiter of its own for songs mastered loud).
+//
+//   track input ── filters ── duck ─┬─ pan ───────────────────────┐
+//                                   ├─ reverb send ── reverb ─────┤
+//                                   └─ delay send ─── delay ──────┼── master ── EQ ── glue ── (loud stage) ── gate ── output
+//                                                       └→ reverb │
+import { impulse } from '../instruments/dsp/reverb.js';
+import { DEFAULT_REVERB } from '../song.js';
+import { breakpoints, cutoffAt } from './automation.js';
+import { createLoudStage } from './output.js';
+/** Q of the two stages of a 24 dB/octave filter, in dB as Web Audio reads it for low- and high-pass: Butterworth, with a touch of resonance */
+const FILTER_Q = [-5.3, 4];
+export function createMixer(ctx, song, destination) {
+    // The delay and the ducking keep time with the opening tempo
+    const stepSeconds = 60 / song.bpm / 4;
+    const output = ctx.createGain();
+    output.connect(destination);
+    const gate = ctx.createGain();
+    gate.connect(output);
+    const master = createMaster(ctx, song, gate);
+    const reverb = createReverb(ctx, song, master);
+    const delay = song.delay ? createDelay(ctx, song.delay, stepSeconds, master, reverb) : null;
+    const strip = (track) => {
+        const input = ctx.createGain();
+        input.gain.value = track.gain ?? 1;
+        let out = input;
+        const sweeps = [];
+        for (const type of ['lowpass', 'highpass']) {
+            const setting = track[type];
+            if (setting === undefined)
+                continue;
+            const points = breakpoints(typeof setting === 'number' ? { 0: setting } : setting);
+            for (const q of FILTER_Q) {
+                const f = biquad(ctx, type, cutoffAt(points, 0), q);
+                out = out.connect(f);
+                if (points.length > 1)
+                    sweeps.push({ cutoff: f.frequency, points });
+            }
+        }
+        let pump;
+        if (track.duck) {
+            const duck = ctx.createGain();
+            out = out.connect(duck);
+            const { depth = 0.7, release = 4 } = typeof track.duck === 'string' ? {} : track.duck;
+            pump = { gain: duck.gain, depth, release: release * stepSeconds };
+        }
+        const pan = ctx.createStereoPanner();
+        pan.pan.value = track.pan ?? 0;
+        out.connect(pan).connect(master);
+        send(ctx, out, reverb, track.reverb ?? 0.25);
+        if (delay && track.delay)
+            send(ctx, out, delay, track.delay);
+        return { input, output: out, pump, sweeps };
+    };
+    return { output, gate, strips: [(song.intro ?? []).map(strip), song.tracks.map(strip)] };
+}
+function send(ctx, from, to, amount) {
+    const g = ctx.createGain();
+    g.gain.value = amount;
+    from.connect(g).connect(to);
+}
+/** Master bus: overall level, then (each only when asked for) the mastering EQ, glue compression and the loud stage */
+function createMaster(ctx, song, output) {
+    const master = ctx.createGain();
+    const m = song.master ?? {};
+    master.gain.value = (song.gain ?? 1) * Math.pow(10, (m.trim ?? 0) / 20);
+    let out = master;
+    if (m.warm || m.cut) {
+        // Cut the rumble below 30 Hz first, so adding body does not eat the dynamics
+        const hp = biquad(ctx, 'highpass', 30, 0.6);
+        const warm = biquad(ctx, 'peaking', 150, 0.7, m.warm ?? 0);
+        const cut = biquad(ctx, 'peaking', 1300, 0.9, -(m.cut ?? 0));
+        out = out.connect(hp).connect(warm).connect(cut);
+    }
+    // Glue: the more of it, the lower the threshold and the higher the ratio; the slow attack lets the drums' hits through
+    if (m.glue)
+        out = out.connect(new DynamicsCompressorNode(ctx, { threshold: -4 - 12 * m.glue, knee: 6, ratio: 2 + 2 * m.glue, attack: 0.02, release: 0.25 }));
+    out.connect(m.loud === undefined ? output : createLoudStage(ctx, m.loud, output));
+    return master;
+}
+function biquad(ctx, type, frequency, q, gain = 0) {
+    const f = ctx.createBiquadFilter();
+    f.type = type;
+    f.frequency.value = frequency;
+    f.Q.value = q;
+    f.gain.value = gain;
+    return f;
+}
+/** Convolution reverb with the song's room; returns its input */
+function createReverb(ctx, song, master) {
+    const room = song.reverb ?? DEFAULT_REVERB;
+    const rev = ctx.createConvolver();
+    rev.normalize = false;
+    rev.buffer = impulseBuffer(ctx, room);
+    const ret = ctx.createGain();
+    ret.gain.value = room.mix ?? 1;
+    rev.connect(ret).connect(master);
+    return rev;
+}
+/** Tempo-synced ping-pong delay (left, then right); its echoes also feed a little into the reverb. Returns its input */
+function createDelay(ctx, d, stepSeconds, master, reverb) {
+    const time = Math.min(1.9, d.steps * stepSeconds);
+    const input = ctx.createGain();
+    const left = ctx.createDelay(2);
+    const right = ctx.createDelay(2);
+    left.delayTime.value = time;
+    right.delayTime.value = time;
+    const tone = biquad(ctx, 'lowpass', d.tone ?? 2800, 1);
+    const feedback = ctx.createGain();
+    feedback.gain.value = d.feedback ?? 0.35;
+    const ret = ctx.createGain();
+    ret.gain.value = d.mix ?? 0.8;
+    const panL = ctx.createStereoPanner();
+    const panR = ctx.createStereoPanner();
+    panL.pan.value = -0.7;
+    panR.pan.value = 0.7;
+    input.connect(tone).connect(left);
+    left.connect(panL).connect(ret);
+    left.connect(right);
+    right.connect(panR).connect(ret);
+    right.connect(feedback).connect(left);
+    ret.connect(master);
+    send(ctx, ret, reverb, 0.3);
+    return input;
+}
+const irCache = new Map();
+/** Impulse response of a room (each room is computed once per sample rate) */
+export function impulseBuffer(ctx, room) {
+    const key = `${ctx.sampleRate}|${room.size}|${room.damp}|${room.preDelay}|${room.early}|${room.bloom}`;
+    let b = irCache.get(key);
+    if (!b) {
+        const [l, r] = impulse(ctx.sampleRate, room);
+        b = ctx.createBuffer(2, l.length, ctx.sampleRate);
+        b.getChannelData(0).set(l);
+        b.getChannelData(1).set(r);
+        irCache.set(key, b);
+    }
+    return b;
+}
+//# sourceMappingURL=mixer.js.map

package/dist/engine/mixer.js.map

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

package/dist/engine/output.d.ts

@@ -0,0 +1,14 @@
+import type { Song } from '../song.ts';
+/** Songs are mixed to sound right at this bus level */
+export declare const MIX_LEVEL = 0.36;
+/** Level and limiter in front of a destination; returns the stage's input */
+export declare function createOutputStage(ctx: BaseAudioContext, destination: AudioNode): GainNode;
+/** Songs mastered loud end in a limiter of their own, so they skip the output stage */
+export declare function mastersItself(song: Song): boolean;
+/**
+ * The final stage of a song mastered loud: `loud` dB of drive into a brickwall limiter (songs peak around full scale before the
+ * bus level, so that is about how much their loudest moments are turned down), then a soft clipper that rounds off whatever gets
+ * past it, under the ceiling. Returns its input.
+ */
+export declare function createLoudStage(ctx: BaseAudioContext, loud: number, destination: AudioNode): GainNode;
+//# sourceMappingURL=output.d.ts.map

package/dist/engine/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/engine/output.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,uDAAuD;AACvD,eAAO,MAAM,SAAS,OAAO,CAAC;AAE9B,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,EAAE,WAAW,EAAE,SAAS,GAAG,QAAQ,CAQzF;AAED,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAEjD;AAKD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,GAAG,QAAQ,CAarG"}