@sagl/server 0.0.0-stage → 0.1.0-next.49

package/dist/audio.js

@@ -0,0 +1,353 @@
+import { statSync } from "node:fs";
+import { join } from "node:path";
+import { Player } from "./player.js";
+import { Vehicle } from "./vehicle.js";
+import { encodeEffects } from "./audio_effects.js";
+/** A sound playing (`server.audio.play()`). */
+export class Sound {
+    id;
+    file;
+    /** How long the file plays (ms), read from the server's copy; undefined if it can't be read. */
+    duration;
+    /**
+     * Resolves when it's over: when it has played through (by its duration,
+     * from when the server sent it), or is stopped. A looping one, when
+     * stopped.
+     *
+     * ```ts
+     * await server.audio.play("audio/caller.mp3", { to: [player] }).done;
+     * ```
+     */
+    done;
+    #stop;
+    #playing = true;
+    #ended;
+    #timer = null;
+    /** @internal */
+    constructor(id, file, duration, loop, stop) {
+        this.id = id;
+        this.file = file;
+        this.duration = duration;
+        this.#stop = stop;
+        this.done = new Promise((resolve) => (this.#ended = resolve));
+        if (!loop && duration !== undefined) {
+            this.#timer = setTimeout(() => {
+                this.#playing = false;
+                this.#ended();
+            }, duration);
+        }
+        else if (!loop) {
+            // Unknown length: over as far as the server knows.
+            this.#playing = false;
+            this.#ended();
+        }
+    }
+    /** False once it has played through or been stopped. */
+    get playing() {
+        return this.#playing;
+    }
+    stop() {
+        if (!this.#playing)
+            return;
+        this.#playing = false;
+        if (this.#timer)
+            clearTimeout(this.#timer);
+        this.#stop(this);
+        this.#ended();
+    }
+}
+/**
+ * A line as subtitles: its sentences, short ones together, up to about
+ * `max` characters each (default 70).
+ */
+export function splitSubtitles(text, max = 70) {
+    const out = [];
+    for (const s of text.split(/(?<=[.!?…])\s+/)) {
+        if (!s)
+            continue;
+        if (out.length && out[out.length - 1].length + s.length < max)
+            out[out.length - 1] += " " + s;
+        else
+            out.push(s);
+    }
+    return out;
+}
+/**
+ * Sounds from client files (MP3, WAV, FLAC) on players' games:
+ * `server.audio`. Positioned ones are heard from where they are, fading
+ * with distance, as the game's own sounds.
+ */
+export class ServerAudio {
+    #native;
+    #players;
+    #next = 1;
+    /**
+     * The default for positioned sounds' `realism` (highs fading with
+     * distance, muffled behind buildings). Default false.
+     */
+    realism = false;
+    // Looping sounds for everyone, for players joining later.
+    #loops = new Map();
+    #heard = new Map();
+    #files;
+    #durations = new Map();
+    /** @internal */
+    constructor(native, players, clientFiles) {
+        this.#native = native;
+        this.#players = players;
+        this.#files = clientFiles;
+    }
+    /**
+     * How long a client file plays (ms), from the server's copy (the
+     * `clientFiles` directory); undefined if it isn't there or isn't a sound.
+     */
+    duration(file) {
+        if (!this.#files || file.includes(".."))
+            return undefined;
+        const path = join(this.#files, file);
+        let mtime;
+        try {
+            mtime = statSync(path).mtimeMs;
+        }
+        catch {
+            return undefined;
+        }
+        const known = this.#durations.get(file);
+        if (known && known.mtime === mtime)
+            return known.ms;
+        const ms = this.#native.audioDuration(path);
+        const result = ms >= 0 ? Math.round(ms) : undefined;
+        this.#durations.set(file, { mtime, ms: result });
+        return result;
+    }
+    /**
+     * Plays a recorded line with its subtitles timed to it, as speech (the
+     * radio ducks under it). `at` a ped or vehicle: from them (`muffled`:
+     * from inside the vehicle, through the glass).
+     *
+     * ```ts
+     * await server.audio.speak("audio/benny-my-car.mp3", { at: benny, subtitle: "My car! That's my car!" }).done;
+     * await server.audio.speak("audio/caller.mp3", { to: [player], effects: "phone", subtitle: lines, prefix: "~y~" }).done;
+     * ```
+     */
+    speak(file, options = {}) {
+        const { subtitle, subtitleTo, prefix = "", muffled, ...sound } = options;
+        const effects = muffled
+            ? [...(Array.isArray(sound.effects) ? sound.effects : sound.effects ? [sound.effects] : []),
+                { type: "lowpass", cutoff: 1400 }, { type: "gain", volume: 1.8 }]
+            : sound.effects;
+        const played = this.play(file, { ...sound, effects, speech: true, range: sound.range ?? (sound.at ? 45 : undefined) });
+        const ms = played.duration ?? 4000;
+        const lines = subtitle === undefined ? [] : typeof subtitle === "string" ? splitSubtitles(subtitle) : [...subtitle];
+        const total = lines.reduce((n, l) => n + l.length, 0) || 1;
+        const viewers = () => {
+            if (subtitleTo)
+                return subtitleTo.filter((p) => p.connected);
+            if (sound.to)
+                return sound.to.filter((p) => p.connected);
+            const at = sound.at;
+            if (!at)
+                return this.#players();
+            const pos = "position" in at ? at.position : at;
+            const range = sound.range ?? 45;
+            return this.#players().filter((p) => Math.hypot(p.position.x - pos.x, p.position.y - pos.y) <= range);
+        };
+        const timers = [];
+        let start = 0;
+        for (const line of lines) {
+            const share = Math.round((line.length / total) * ms);
+            timers.push(setTimeout(() => {
+                for (const p of viewers())
+                    p.subtitle(prefix + line, share + 200);
+            }, start));
+            start += share;
+        }
+        let finish;
+        const done = new Promise((resolve) => (finish = resolve));
+        const end = setTimeout(() => finish(), ms + 200);
+        return {
+            sound: played,
+            done,
+            stop: () => {
+                for (const t of timers)
+                    clearTimeout(t);
+                clearTimeout(end);
+                played.stop();
+                finish();
+            },
+        };
+    }
+    /**
+     * Plays a client file. `at` places it (a spot, or a ped, player or
+     * vehicle it follows); `to` picks who hears it.
+     *
+     * ```ts
+     * const ring = server.audio.play("audio/payphone-ring.mp3", { at: phone, loop: true, range: 25 });
+     * ring.stop();
+     * ```
+     */
+    play(file, options = {}) {
+        const id = this.#next++;
+        const spec = {
+            id, file, loop: options.loop ?? false, volume: options.volume ?? 1, effects: encodeEffects(options.effects),
+            realism: options.realism ?? this.realism, speech: options.speech ?? false,
+        };
+        const at = options.at;
+        if (at) {
+            spec.range = options.range ?? 30;
+            if (at instanceof Player)
+                Object.assign(spec, { on: 2, target: at.id });
+            else if (at instanceof Vehicle)
+                Object.assign(spec, { on: 3, target: at.id });
+            else if ("model" in at && "id" in at)
+                Object.assign(spec, { on: 1, target: at.id });
+            else
+                Object.assign(spec, { x: at.x, y: at.y, z: at.z });
+        }
+        const to = options.to ? options.to.filter((p) => p.connected).map((p) => p.id) : null;
+        for (const p of this.#players()) {
+            if (!to || to.includes(p.id))
+                this.#native.sound(p.id, spec);
+        }
+        this.#heard.set(id, to);
+        if (spec.loop && !to)
+            this.#loops.set(id, spec);
+        return new Sound(id, file, this.duration(file), spec.loop ?? false, (s) => {
+            this.#loops.delete(s.id);
+            const who = this.#heard.get(s.id);
+            this.#heard.delete(s.id);
+            for (const p of this.#players()) {
+                if (!who || who.includes(p.id))
+                    this.#native.sound(p.id, { id: s.id, stop: true });
+            }
+        });
+    }
+    /**
+     * Plays one of the game's own sounds (see `GameSound`): a frontend one
+     * (the HUD's: pickups, the Pay 'n' Spray jingle), or, with `at`, one of
+     * the mission script's sounds at a spot. `to` picks who hears it
+     * (default everyone).
+     *
+     * ```ts
+     * server.audio.playGame(GameSound.CarRespray, { to: [player] });
+     * ```
+     */
+    playGame(sound, options = {}) {
+        if (!Number.isInteger(sound) || sound < 0)
+            throw new RangeError(`not a game sound: ${sound}`);
+        const at = options.at;
+        const spec = at ? { sound, atSpot: true, x: at.x, y: at.y, z: at.z } : { sound };
+        for (const p of options.to ?? this.#players()) {
+            if (p.connected)
+                this.#native.gameSound(p.id, spec);
+        }
+    }
+    /**
+     * Plays one of the game's mission audio, by its audio id: the recordings
+     * and effects its missions and machines load (a vending machine's clunk:
+     * 42600). From a player, ped or vehicle (following them), a spot, or
+     * (no `at`) as is. `to` picks who hears it (default everyone). Each
+     * game reads it from its own copy and plays it as the server's sounds,
+     * so `effects` work on it.
+     *
+     * ```ts
+     * server.audio.playMission(42600, { at: player });
+     * ```
+     */
+    playMission(id, options = {}) {
+        if (!Number.isInteger(id) || id < 0)
+            throw new RangeError(`not a mission audio id: ${id}`);
+        const at = options.at;
+        const spec = {
+            sound: id, mission: true, range: options.range ?? 30, effects: encodeEffects(options.effects),
+            realism: options.realism ?? this.realism,
+        };
+        if (at instanceof Player)
+            Object.assign(spec, { on: 2, target: at.id });
+        else if (at instanceof Vehicle)
+            Object.assign(spec, { on: 3, target: at.id });
+        else if (at && "model" in at && "id" in at)
+            Object.assign(spec, { on: 1, target: at.id });
+        else if (at)
+            Object.assign(spec, { atSpot: true, x: at.x, y: at.y, z: at.z });
+        for (const p of options.to ?? this.#players()) {
+            if (p.connected)
+                this.#native.gameSound(p.id, spec);
+        }
+    }
+    /**
+     * The effects every sound of the server's and its scripts' passes through
+     * for this player now: where they are (a hall's reverb, a tunnel's echo).
+     * `null`: none. The game's own world sounds aren't affected.
+     *
+     * ```ts
+     * server.audio.setEnvironment(player, "tunnel");
+     * ```
+     */
+    setEnvironment(player, effects) {
+        this.#chosen.set(player, effects ? encodeEffects(effects) : []);
+        this.#apply(player);
+    }
+    /**
+     * An environment for everyone inside a zone, while they're in it (the
+     * most recently entered, where zones overlap; one set with
+     * `setEnvironment` wins over all).
+     *
+     * ```ts
+     * server.audio.setZoneEnvironment(server.createZone({ ... }), "hall");
+     * ```
+     */
+    setZoneEnvironment(zone, effects) {
+        if (effects)
+            this.#zoneEnv.set(zone, encodeEffects(effects));
+        else
+            this.#zoneEnv.delete(zone);
+        for (const [player, zones] of this.#inZones)
+            if (zones.includes(zone))
+                this.#apply(player);
+    }
+    #chosen = new Map();
+    #zoneEnv = new Map();
+    #inZones = new Map();
+    #sent = new Map();
+    #apply(player) {
+        let effects = this.#chosen.get(player);
+        if (!effects || !effects.length) {
+            const zones = this.#inZones.get(player) ?? [];
+            effects = [];
+            for (let i = zones.length - 1; i >= 0; --i) {
+                const e = this.#zoneEnv.get(zones[i]);
+                if (e) {
+                    effects = e;
+                    break;
+                }
+            }
+        }
+        const key = JSON.stringify(effects);
+        if (this.#sent.get(player) === key || !player.connected)
+            return;
+        this.#sent.set(player, key);
+        this.#native.audioEnvironment(player.id, effects);
+    }
+    /** @internal */
+    zoneEvent(player, zone, entered) {
+        const zones = (this.#inZones.get(player) ?? []).filter((z) => z !== zone);
+        if (entered)
+            zones.push(zone);
+        this.#inZones.set(player, zones);
+        if (this.#zoneEnv.has(zone))
+            this.#apply(player);
+    }
+    /** @internal */
+    forget(player) {
+        this.#chosen.delete(player);
+        this.#inZones.delete(player);
+        this.#sent.delete(player);
+    }
+    /** @internal A player joined: the loops playing for everyone. */
+    replay(player) {
+        for (const spec of this.#loops.values())
+            this.#native.sound(player.id, spec);
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAyC,MAAM,oBAAoB,CAAC;AA2B1F,+CAA+C;AAC/C,MAAM,OAAO,KAAK;IACP,EAAE,CAAS;IACX,IAAI,CAAS;IACtB,gGAAgG;IACvF,QAAQ,CAAqB;IACtC;;;;;;;;OAQG;IACM,IAAI,CAAgB;IAC7B,KAAK,CAAqB;IAC1B,QAAQ,GAAG,IAAI,CAAC;IAChB,MAAM,CAAc;IACpB,MAAM,GAAyC,IAAI,CAAC;IAEpD,gBAAgB;IAChB,YAAY,EAAU,EAAE,IAAY,EAAE,QAA4B,EAAE,IAAa,EAAE,IAAwB;QACzG,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACtB,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC,EAAE,QAAQ,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACjB,mDAAmD;YACnD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,IAAI,CAAC,MAAM;YAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACF;AAID;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAG,GAAG,EAAE;IACnD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,GAAG;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;;YACzF,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AA0BD;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACtB,OAAO,CAAe;IACtB,QAAQ,CAAiB;IACzB,KAAK,GAAG,CAAC,CAAC;IACV;;;OAGG;IACH,OAAO,GAAG,KAAK,CAAC;IAChB,0DAA0D;IAC1D,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;IACjC,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE5C,MAAM,CAAqB;IAC3B,UAAU,GAAG,IAAI,GAAG,EAAqD,CAAC;IAE1E,gBAAgB;IAChB,YAAY,MAAoB,EAAE,OAAuB,EAAE,WAAoB;QAC7E,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,KAAa,CAAC;QAClB,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAY,EAAE,UAAwB,EAAE;QAC5C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QACzE,MAAM,OAAO,GAAG,OAAO;YACrB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzF,EAAE,IAAI,EAAE,SAAkB,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;YACrF,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACvH,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;QACnC,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC;QACpH,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,GAAa,EAAE;YAC7B,IAAI,UAAU;gBAAE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,EAAE;gBAAE,OAAO,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACzD,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE;gBAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;QACxG,CAAC,CAAC;QACF,MAAM,MAAM,GAAoC,EAAE,CAAC;QACnD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACrD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE;gBAC1B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE;oBAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC;YACpE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACX,KAAK,IAAI,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,MAAmB,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC;QACjD,OAAO;YACL,KAAK,EAAE,MAAM;YACb,IAAI;YACJ,IAAI,EAAE,GAAG,EAAE;gBACT,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,YAAY,CAAC,CAAC,CAAC,CAAC;gBACxC,YAAY,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,EAAE,CAAC;YACX,CAAC;SACF,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAY,EAAE,UAAwB,EAAE;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;YAC3G,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;SAC1E,CAAC;QACF,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACtB,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;YACjC,IAAI,EAAE,YAAY,MAAM;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;iBACnE,IAAI,EAAE,YAAY,OAAO;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;iBACzE,IAAI,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;;gBAC/E,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAChD,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE;YACxE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAChC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,KAAa,EAAE,UAAoD,EAAE;QAC5E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;QAC9F,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACjF,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,CAAC,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAU,EAAE,UAEpB,EAAE;QACJ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QAC3F,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,GAA6C;YACrD,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC;YAC7F,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;SACzC,CAAC;QACF,IAAI,EAAE,YAAY,MAAM;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;aACnE,IAAI,EAAE,YAAY,OAAO;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;aACzE,IAAI,EAAE,IAAI,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;aACrF,IAAI,EAAE;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9E,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,CAAC,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAc,EAAE,OAA4B;QACzD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;;;OAQG;IACH,kBAAkB,CAAC,IAAU,EAAE,OAA4B;QACzD,IAAI,OAAO;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAE,CAAC,CAAC;;YACzD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC7C,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAElC,MAAM,CAAC,MAAc;QACnB,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC9C,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC3C,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtC,IAAI,CAAC,EAAE,CAAC;oBAAC,OAAO,GAAG,CAAC,CAAC;oBAAC,MAAM;gBAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO;QAChE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB;IAChB,SAAS,CAAC,MAAc,EAAE,IAAU,EAAE,OAAgB;QACpD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QAC1E,IAAI,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,gBAAgB;IAChB,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,MAAc;QACnB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;CACF"}

package/dist/audio_effects.d.ts

@@ -0,0 +1,219 @@
+/**
+ * One stage of a sound's effects. Stages are layered in order, and each is
+ * mixed with what it was given by `mix` (0: none of it, 1: all of it), so
+ * any effect can be applied lightly or fully.
+ */
+export type AudioEffect = 
+/** Cuts the highs above `cutoff` (Hz): muffled, through a wall. */
+{
+    type: "lowpass";
+    cutoff: number;
+    mix?: number;
+}
+/** Cuts the lows below `cutoff` (Hz): thin, tinny. */
+ | {
+    type: "highpass";
+    cutoff: number;
+    mix?: number;
+}
+/** Keeps only `low`-`high` (Hz): a phone line, a radio. */
+ | {
+    type: "bandpass";
+    low: number;
+    high: number;
+    mix?: number;
+}
+/** Clipping, harsher with `drive` (0-1): a cheap speaker, a megaphone. */
+ | {
+    type: "distortion";
+    drive: number;
+    mix?: number;
+}
+/** Repeats after `delay` (s), each `decay` (0-1) as loud. Default mix 0.4, decay 0.4. */
+ | {
+    type: "echo";
+    delay: number;
+    decay?: number;
+    mix?: number;
+}
+/** A room's reverb: `size` (0-1) small room to cathedral, `damping` (0-1) bright to dull. Default mix 0.35. */
+ | {
+    type: "reverb";
+    size?: number;
+    damping?: number;
+    mix?: number;
+}
+/** Louder or quieter (1: as is, up to 4). */
+ | {
+    type: "gain";
+    volume: number;
+};
+/** The ready-made effects: name -> stages. */
+export declare const AudioPresets: {
+    /** A phone line: thin, a little crackly. */
+    phone: ({
+        type: "bandpass";
+        low: number;
+        high: number;
+        drive?: undefined;
+        mix?: undefined;
+        volume?: undefined;
+    } | {
+        type: "distortion";
+        drive: number;
+        mix: number;
+        low?: undefined;
+        high?: undefined;
+        volume?: undefined;
+    } | {
+        type: "gain";
+        volume: number;
+        low?: undefined;
+        high?: undefined;
+        drive?: undefined;
+        mix?: undefined;
+    })[];
+    /** A two-way radio, a police scanner. */
+    radio: ({
+        type: "bandpass";
+        low: number;
+        high: number;
+        drive?: undefined;
+        mix?: undefined;
+        volume?: undefined;
+    } | {
+        type: "distortion";
+        drive: number;
+        mix: number;
+        low?: undefined;
+        high?: undefined;
+        volume?: undefined;
+    } | {
+        type: "gain";
+        volume: number;
+        low?: undefined;
+        high?: undefined;
+        drive?: undefined;
+        mix?: undefined;
+    })[];
+    /** A megaphone, a PA. */
+    megaphone: ({
+        type: "bandpass";
+        low: number;
+        high: number;
+        drive?: undefined;
+        mix?: undefined;
+        volume?: undefined;
+    } | {
+        type: "distortion";
+        drive: number;
+        mix: number;
+        low?: undefined;
+        high?: undefined;
+        volume?: undefined;
+    } | {
+        type: "gain";
+        volume: number;
+        low?: undefined;
+        high?: undefined;
+        drive?: undefined;
+        mix?: undefined;
+    })[];
+    /** Through a wall or a closed door. */
+    muffled: {
+        type: "lowpass";
+        cutoff: number;
+    }[];
+    /** Underwater. */
+    underwater: ({
+        type: "lowpass";
+        cutoff: number;
+        size?: undefined;
+        damping?: undefined;
+        mix?: undefined;
+    } | {
+        type: "reverb";
+        size: number;
+        damping: number;
+        mix: number;
+        cutoff?: undefined;
+    })[];
+    /** A small room. */
+    room: {
+        type: "reverb";
+        size: number;
+        damping: number;
+        mix: number;
+    }[];
+    /** A large hall, a warehouse. */
+    hall: {
+        type: "reverb";
+        size: number;
+        damping: number;
+        mix: number;
+    }[];
+    /** A cave. */
+    cave: ({
+        type: "reverb";
+        size: number;
+        damping: number;
+        mix: number;
+        delay?: undefined;
+        decay?: undefined;
+    } | {
+        type: "echo";
+        delay: number;
+        decay: number;
+        mix: number;
+        size?: undefined;
+        damping?: undefined;
+    })[];
+    /** A tunnel, a car park. */
+    tunnel: ({
+        type: "echo";
+        delay: number;
+        decay: number;
+        mix: number;
+        size?: undefined;
+        damping?: undefined;
+    } | {
+        type: "reverb";
+        size: number;
+        damping: number;
+        mix: number;
+        delay?: undefined;
+        decay?: undefined;
+    })[];
+    /** A canyon: a long, clear echo. */
+    canyon: {
+        type: "echo";
+        delay: number;
+        decay: number;
+        mix: number;
+    }[];
+};
+export type AudioPreset = keyof typeof AudioPresets;
+/**
+ * A sound's effects: a preset, or a list of presets and stages layered in
+ * order. `{ preset, strength }` is a preset at a strength (0-1: each of its
+ * stages' mix scaled).
+ *
+ * ```ts
+ * "phone"
+ * ["phone", { type: "echo", delay: 0.3, mix: 0.2 }]
+ * [{ preset: "hall", strength: 0.5 }, { type: "lowpass", cutoff: 2000, mix: 0.5 }]
+ * ```
+ */
+export type AudioEffects = AudioPreset | (AudioPreset | {
+    preset: AudioPreset;
+    strength?: number;
+} | AudioEffect)[];
+/** @internal As the client takes them: {kind, a, b, mix}, at most 8. */
+export interface EncodedEffect {
+    kind: number;
+    a: number;
+    b: number;
+    mix: number;
+}
+/** @internal */
+export declare function encodeEffects(effects: AudioEffects | undefined): EncodedEffect[] | undefined;

package/dist/audio_effects.js

@@ -0,0 +1,84 @@
+/** The ready-made effects: name -> stages. */
+export const AudioPresets = {
+    /** A phone line: thin, a little crackly. */
+    phone: [
+        { type: "bandpass", low: 400, high: 3000 },
+        { type: "distortion", drive: 0.15, mix: 0.4 },
+        { type: "gain", volume: 1.4 },
+    ],
+    /** A two-way radio, a police scanner. */
+    radio: [
+        { type: "bandpass", low: 500, high: 4500 },
+        { type: "distortion", drive: 0.3, mix: 0.5 },
+        { type: "gain", volume: 1.3 },
+    ],
+    /** A megaphone, a PA. */
+    megaphone: [
+        { type: "bandpass", low: 800, high: 3500 },
+        { type: "distortion", drive: 0.6, mix: 0.8 },
+        { type: "gain", volume: 1.2 },
+    ],
+    /** Through a wall or a closed door. */
+    muffled: [{ type: "lowpass", cutoff: 500 }],
+    /** Underwater. */
+    underwater: [
+        { type: "lowpass", cutoff: 300 },
+        { type: "reverb", size: 0.5, damping: 0.9, mix: 0.3 },
+    ],
+    /** A small room. */
+    room: [{ type: "reverb", size: 0.3, damping: 0.5, mix: 0.2 }],
+    /** A large hall, a warehouse. */
+    hall: [{ type: "reverb", size: 0.8, damping: 0.3, mix: 0.4 }],
+    /** A cave. */
+    cave: [
+        { type: "reverb", size: 0.95, damping: 0.2, mix: 0.45 },
+        { type: "echo", delay: 0.25, decay: 0.3, mix: 0.25 },
+    ],
+    /** A tunnel, a car park. */
+    tunnel: [
+        { type: "echo", delay: 0.12, decay: 0.5, mix: 0.35 },
+        { type: "reverb", size: 0.6, damping: 0.4, mix: 0.25 },
+    ],
+    /** A canyon: a long, clear echo. */
+    canyon: [{ type: "echo", delay: 0.5, decay: 0.45, mix: 0.4 }],
+};
+const KINDS = { lowpass: 0, highpass: 1, bandpass: 2, distortion: 3, echo: 4, reverb: 5, gain: 6 };
+const MAX_STAGES = 8;
+function encodeOne(e, strength) {
+    const mix = (m, d) => Math.max(0, Math.min(1, (m ?? d) * strength));
+    switch (e.type) {
+        case "lowpass": return { kind: KINDS.lowpass, a: e.cutoff, b: 0, mix: mix(e.mix, 1) };
+        case "highpass": return { kind: KINDS.highpass, a: e.cutoff, b: 0, mix: mix(e.mix, 1) };
+        case "bandpass": return { kind: KINDS.bandpass, a: e.low, b: e.high, mix: mix(e.mix, 1) };
+        case "distortion": return { kind: KINDS.distortion, a: e.drive, b: 0, mix: mix(e.mix, 1) };
+        case "echo": return { kind: KINDS.echo, a: e.delay, b: e.decay ?? 0.4, mix: mix(e.mix, 0.4) };
+        case "reverb": return { kind: KINDS.reverb, a: e.size ?? 0.5, b: e.damping ?? 0.5, mix: mix(e.mix, 0.35) };
+        case "gain": return { kind: KINDS.gain, a: 1 + (e.volume - 1) * strength, b: 0, mix: 1 };
+        default: throw new TypeError(`not an audio effect: ${JSON.stringify(e)}`);
+    }
+}
+/** @internal */
+export function encodeEffects(effects) {
+    if (effects === undefined)
+        return undefined;
+    const out = [];
+    const preset = (name, strength) => {
+        const stages = AudioPresets[name];
+        if (!stages)
+            throw new RangeError(`not an audio preset: "${name}" (${Object.keys(AudioPresets).join(", ")})`);
+        for (const s of stages)
+            out.push(encodeOne(s, strength));
+    };
+    for (const item of typeof effects === "string" ? [effects] : effects) {
+        if (typeof item === "string")
+            preset(item, 1);
+        else if ("preset" in item)
+            preset(item.preset, Math.max(0, Math.min(1, item.strength ?? 1)));
+        else
+            out.push(encodeOne(item, 1));
+    }
+    if (out.length > MAX_STAGES)
+        throw new RangeError(`at most ${MAX_STAGES} effect stages (presets count theirs)`);
+    return out;
+}
+//# sourceMappingURL=audio_effects.js.map

package/dist/audio_effects.js.map

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