@yali-engine/audio 0.0.0-stage → 0.4.0

package/dist/plugin.js

@@ -0,0 +1,530 @@
+import { registerTransforms, YaliError } from '@yali-engine/core';
+import { AudioMixer, modelOf } from "./audio.js";
+import { cameraPose, dopplerFactor, poseOf, relative, rotate, rotateTo, zoneWeight } from "./space.js";
+/** `audio.Source`'s fields (ADR-0096). */
+export const SOURCE_FIELDS = {
+    clip: 'u32',
+    volume: 'f32',
+    pitch: 'f32',
+    loop: 'u8',
+    /** 1: playing (set it to start); the plugin sets 0 when a clip that does not loop ends. */
+    play: 'u8',
+    spatial: 'u8',
+    distanceModel: 'u8',
+    refDistance: 'f32',
+    maxDistance: 'f32',
+    rolloff: 'f32',
+    coneInner: 'f32',
+    coneOuter: 'f32',
+    coneOuterGain: 'f32',
+};
+/** `audio.ReverbZone`'s fields (ADR-0116). */
+export const REVERB_ZONE_FIELDS = {
+    /** 0: a sphere of radius `x`; 1: a box of half extents `x`, `y`, `z` (turned with the entity). */
+    shape: 'u8',
+    x: 'f32',
+    y: 'f32',
+    z: 'f32',
+    /** How far inside the edge it reaches full strength, m. */
+    fade: 'f32',
+    /** Seconds to fall 60 dB. */
+    decay: 'f32',
+    /** Its level at full strength (linear). */
+    wet: 'f32',
+};
+/** Registers the audio components on `world` (the same ids every call). */
+export function registerAudioComponents(world) {
+    return {
+        Source: world.registerComponent({ name: 'audio.Source', fields: SOURCE_FIELDS }),
+        Listener: world.registerComponent({ name: 'audio.Listener', fields: { active: 'u8' } }),
+        ReverbZone: world.registerComponent({ name: 'audio.ReverbZone', fields: REVERB_ZONE_FIELDS }),
+    };
+}
+/**
+ * `audio.ReverbZone` values (ADR-0116): put on an entity with a transform; while the listener is
+ * inside, every spatial sound also plays through this reverb, faded in over `fade` metres. Zones may
+ * overlap (each is heard at its own weight).
+ *
+ * @example
+ * world.insert(hall, audio.ReverbZone, reverbZone({ box: [12, 6, 20], decay: 2.2, wet: 0.5 }));
+ */
+export function reverbZone(o) {
+    const box = o.box;
+    if ((o.sphere === undefined) === (box === undefined)) {
+        throw Object.assign(new YaliError('AUDIO_INVALID', 'A reverb zone needs exactly one of sphere or box.', 'Pass { sphere: radius } or { box: [x, y, z] } (half extents, m).'), { path: o.sphere === undefined ? 'sphere' : 'box' });
+    }
+    const dims = box ?? [o.sphere, 0, 0];
+    if (!dims.slice(0, box ? 3 : 1).every((d) => d > 0)) {
+        throw Object.assign(new YaliError('AUDIO_INVALID', `Reverb zone size ${dims.join(', ')}.`, 'Give sizes above 0 m.'), { path: box ? 'box' : 'sphere' });
+    }
+    return { shape: box ? 1 : 0, x: dims[0], y: dims[1], z: dims[2], fade: o.fade ?? 2, decay: o.decay ?? 1.5, wet: o.wet ?? 0.4 };
+}
+/** Encoded audio formats the clip loader serves. */
+const AUDIO_EXTENSIONS = ['.ogg', '.oga', '.opus', '.wav', '.mp3', '.flac', '.m4a', '.aac'];
+/**
+ * An asset-server loader for clips (ADR-0116): `assets.load<ClipId>('sounds/step.ogg')` decodes into
+ * `clips`, and a hot reload of the file swaps the sound under the same id. `audioPlugin` registers
+ * it with the app's asset server itself when there is one.
+ */
+export function audioClipLoader(clips) {
+    return {
+        type: 'audio',
+        extensions: AUDIO_EXTENSIONS,
+        decode: (bytes, ctx) => clips.decodeFor(ctx.path, bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength)),
+        byteSize: (id) => {
+            const b = clips.get(id);
+            return b ? b.length * b.numberOfChannels * 4 : 0;
+        },
+        fallback: () => 0,
+    };
+}
+/**
+ * `audio.Source` values (ADR-0096) for clip `clip`: put on an entity with a transform; it plays
+ * from there. Set `play` to 0 to stop it, 1 to start it again.
+ *
+ * @example
+ * world.insert(engine, audio.Source, audioSource(hum, { loop: true, refDistance: 3 }));
+ */
+export function audioSource(clip, o = {}) {
+    if (!Number.isInteger(clip) || clip < 1) {
+        throw Object.assign(new YaliError('AUDIO_INVALID', `Clip ${clip} is not a clip id.`, 'Pass the id audio.clips.load(url) or audio.clips.add(buffer) resolved to.'), { path: 'clip' });
+    }
+    return {
+        clip,
+        volume: o.volume ?? 1,
+        pitch: o.pitch ?? 1,
+        loop: o.loop ? 1 : 0,
+        play: (o.play ?? true) ? 1 : 0,
+        spatial: (o.spatial ?? true) ? 1 : 0,
+        distanceModel: o.distanceModel === 'linear' ? 0 : o.distanceModel === 'exponential' ? 2 : 1,
+        refDistance: o.refDistance ?? 1,
+        maxDistance: o.maxDistance ?? 100,
+        rolloff: o.rolloff ?? 1,
+        coneInner: o.cone?.inner ?? 360,
+        coneOuter: o.cone?.outer ?? 360,
+        coneOuterGain: o.cone?.outerGain ?? 0,
+    };
+}
+/**
+ * Diffraction's four detours (ADR-0130) for a source `dist` m from the listener at `lp` along `u`: through
+ * points `DETOUR` m around the source, across the line to it; for each, a ray from the listener to the
+ * point and one from the point to the source (8 rays, in pairs), handed to `push`.
+ */
+function detours(lp, u, dist, push, radius, margin) {
+    // Two directions across the line: u × up (or u × x when the line is vertical), and u × that.
+    let a = Math.abs(u[1]) < 0.95 ? [-u[2], 0, u[0]] : [0, u[2], -u[1]];
+    const al = Math.hypot(a[0], a[1], a[2]);
+    a = [a[0] / al, a[1] / al, a[2] / al];
+    const b = [u[1] * a[2] - u[2] * a[1], u[2] * a[0] - u[0] * a[2], u[0] * a[1] - u[1] * a[0]];
+    const src = [lp[0] + u[0] * dist, lp[1] + u[1] * dist, lp[2] + u[2] * dist];
+    for (const [d, sign] of [[a, 1], [a, -1], [b, 1], [b, -1]]) {
+        const pt = [src[0] + d[0] * radius * sign, src[1] + d[1] * radius * sign, src[2] + d[2] * radius * sign];
+        // Listener → point (margin short of the listener), then point → source (margin short of the source).
+        const l1 = Math.hypot(pt[0] - lp[0], pt[1] - lp[1], pt[2] - lp[2]);
+        const v1 = [(pt[0] - lp[0]) / l1, (pt[1] - lp[1]) / l1, (pt[2] - lp[2]) / l1];
+        push([lp[0] + v1[0] * margin, lp[1] + v1[1] * margin, lp[2] + v1[2] * margin], v1, Math.max(0, l1 - margin));
+        const v2 = [(src[0] - pt[0]) / radius, (src[1] - pt[1]) / radius, (src[2] - pt[2]) / radius];
+        push(pt, v2, Math.max(0, radius - margin));
+    }
+}
+/**
+ * Spatial audio (ADR-0096): every entity with `audio.Source` and a `GlobalTransform` plays its
+ * clip from where it is, heard from the `audio.Listener` entity or, without one, the render
+ * camera. Runs in Extract, after transforms propagate. Provides `audio`; tools `audio.voices`
+ * and `audio.volume`.
+ *
+ * @example
+ * App.create({ core, plugins: [renderPlugin({ canvas }), audioPlugin(), transformsPlugin(), game] });
+ * const audio = app.resource<AudioContextResource>('audio');
+ * world.insert(e, audio.Source, audioSource(await audio.clips.load('hum.ogg'), { loop: true }));
+ */
+export function audioPlugin(options = {}) {
+    return {
+        name: '@yali-engine/audio',
+        version: '0.4.0',
+        // Built after the asset server when there is one, so its clip loader can register (ADR-0116), and
+        // after physics, whose rays occlusion casts (ADR-0127).
+        dependencies: [
+            { name: '@yali-engine/assets', range: '^0.4.0', optional: true },
+            { name: '@yali-engine/physics', range: '^0.4.0', optional: true },
+        ],
+        build(b) {
+            const world = b.app.world;
+            const context = options.context ?? newContext();
+            const mixer = new AudioMixer(context, undefined, options.element);
+            if ((options.assets ?? true) && b.app.hasResource('assets'))
+                b.app.resource('assets').register(audioClipLoader(mixer.clips));
+            mixer.volume = options.volume ?? 1;
+            const comps = registerAudioComponents(world);
+            const { GlobalTransform } = registerTransforms(world);
+            const sources = world.query({
+                with: [comps.Source, GlobalTransform],
+                columns: [
+                    [comps.Source, 'clip'],
+                    [comps.Source, 'volume'],
+                    [comps.Source, 'pitch'],
+                    [comps.Source, 'loop'],
+                    [comps.Source, 'play', 'write'],
+                    [comps.Source, 'spatial'],
+                    [comps.Source, 'distanceModel'],
+                    [comps.Source, 'refDistance'],
+                    [comps.Source, 'maxDistance'],
+                    [comps.Source, 'rolloff'],
+                    [comps.Source, 'coneInner'],
+                    [comps.Source, 'coneOuter'],
+                    [comps.Source, 'coneOuterGain'],
+                    [GlobalTransform, 't'],
+                    [GlobalTransform, 'r'],
+                ],
+            });
+            const listeners = world.query({ with: [comps.Listener, GlobalTransform], columns: [[GlobalTransform, 't'], [GlobalTransform, 'r']] });
+            const zones = world.query({
+                with: [comps.ReverbZone, GlobalTransform],
+                columns: [
+                    [comps.ReverbZone, 'shape'],
+                    [comps.ReverbZone, 'x'],
+                    [comps.ReverbZone, 'y'],
+                    [comps.ReverbZone, 'z'],
+                    [comps.ReverbZone, 'fade'],
+                    [comps.ReverbZone, 'decay'],
+                    [comps.ReverbZone, 'wet'],
+                    [GlobalTransform, 't'],
+                    [GlobalTransform, 'r'],
+                ],
+            });
+            const dims = [0, 0, 0];
+            const local = [0, 0, 0];
+            const inv = [0, 0, 0, 1];
+            const resource = { ...comps, context, clips: mixer.clips, mixer };
+            b.provide('audio', resource);
+            const p = { clip: 0, volume: 1, pitch: 1, loop: false, spatial: true, distanceModel: 'inverse', refDistance: 1, maxDistance: 100, rolloff: 1, coneInner: 360, coneOuter: 360, coneOuterGain: 0, occlusion: 0 };
+            // Doppler (ADR-0127): each entity's last position and smoothed velocity, the listener's too.
+            const dop = options.doppler === false ? null : { scale: 1, speedOfSound: 343, maxSpeed: 150, ...(typeof options.doppler === 'object' ? options.doppler : {}) };
+            const motion = new Map();
+            const listenerMotion = new Float64Array(7);
+            const seen = new Set();
+            // Occlusion (ADR-0127): physics' rays unless a query is given; the smoothed level per source.
+            const occOpts = typeof options.occlusion === 'object' ? options.occlusion : {};
+            const physics = b.app.hasResource('physics') ? b.app.resource('physics') : null;
+            // On unless `false`: through the query when given, else physics' rays (an options object without a query
+            // used to turn it off, ADR-0130).
+            const occluding = options.occlusion !== false && (occOpts.query !== undefined || typeof physics?.raycasts === 'function');
+            mixer.occlusion = occluding;
+            const occlusion = new Map();
+            const margin = occOpts.margin ?? 0.25;
+            const mask = occOpts.mask ?? 0xffffffff;
+            // ADR-0130: thickness (physics' distances only), diffraction around the wall, early reflections.
+            const thickness = Math.max(1e-3, occOpts.thickness ?? 0.25);
+            const diffraction = Math.min(1, Math.max(0, occOpts.diffraction ?? 0.6));
+            const radius = occOpts.radius ?? 1.5;
+            const refOpts = typeof options.reflections === 'object' ? options.reflections : {};
+            const reflecting = options.reflections !== false && typeof physics?.raycasts === 'function';
+            const refDistance = refOpts.distance ?? 30;
+            const refGain = refOpts.gain ?? 0.5;
+            const refMask = refOpts.mask ?? 0xffffffff;
+            /** Per source cast this frame: its key, its forward and back rays, their length, its first detour ray (−1: none). */
+            const srcKey = [];
+            const srcFwd = [];
+            const srcBack = [];
+            const srcLen = [];
+            const srcDet = [];
+            /** The listener's right when the reflection rays were cast (for panning). */
+            const refRight = [1, 0, 0];
+            /**
+             * Tracks entity `key`'s velocity in `m` (x, y, z last position; vx, vy, vz; 1 once seen), from its
+             * position `at` after `dt` seconds: the move's velocity, smoothed over ~0.1 s; a teleport resets it.
+             */
+            const track = (m, at, dt) => {
+                if (m[6] && dt > 0) {
+                    const vx = (at[0] - m[0]) / dt;
+                    const vy = (at[1] - m[1]) / dt;
+                    const vz = (at[2] - m[2]) / dt;
+                    if (Math.hypot(vx, vy, vz) > dop.maxSpeed) {
+                        m[3] = m[4] = m[5] = 0;
+                    }
+                    else {
+                        const k = 1 - Math.exp(-dt / 0.1);
+                        m[3] += (vx - m[3]) * k;
+                        m[4] += (vy - m[4]) * k;
+                        m[5] += (vz - m[5]) * k;
+                    }
+                }
+                m[0] = at[0];
+                m[1] = at[1];
+                m[2] = at[2];
+                m[6] = 1;
+            };
+            const rays = [];
+            /** This frame's reflection rays (ADR-0130), cast with the occlusion rays when physics casts both. */
+            const refRays = [];
+            const offset = [0, 0, 0];
+            const pos = new Float64Array(3);
+            const fallback = { position: [0, 0, 0], forward: [0, 0, -1], up: [0, 1, 0] };
+            const listenerPose = () => {
+                let pose = null;
+                listeners.forEachChunk((c) => {
+                    if (pose || c.length === 0)
+                        return;
+                    const t = c.f64(0);
+                    const r = c.f32(1);
+                    pose = poseOf([t[0], t[1], t[2]], [r[0], r[1], r[2], r[3]]);
+                });
+                if (pose)
+                    return pose;
+                const cam = b.app.hasResource('render') ? b.app.resource('render').camera : undefined;
+                return cam ? cameraPose(cam.eye, cam.target) : fallback;
+            };
+            b.system({
+                name: 'audio.mix',
+                stage: 'Extract',
+                run: (f) => {
+                    const pose = listenerPose();
+                    const dt = f.time.virtualDelta;
+                    if (dop)
+                        track(listenerMotion, pose.position, dt);
+                    // Last frame's rays (cast after the sources were read): each source's level, the reflections.
+                    if (rays.length || refRays.length) {
+                        let hits;
+                        let refHits = [];
+                        if (occOpts.query) {
+                            hits = rays.length ? occOpts.query(rays.map((r) => [r[0], r[1], r[2]])) : [];
+                            if (refRays.length)
+                                refHits = physics.raycasts(refRays);
+                        }
+                        else {
+                            const all = physics.raycasts(refRays.length ? rays.concat(refRays) : rays);
+                            hits = all;
+                            refHits = all.slice(rays.length);
+                        }
+                        const blocked = (i) => (i >= 0 ? hits[i] !== null && hits[i] !== false : false);
+                        const k = 1 - Math.exp(-dt / 0.08);
+                        for (let s = 0; s < srcKey.length; s++) {
+                            let target = 0;
+                            const fh = hits[srcFwd[s]];
+                            if (fh !== null && fh !== false) {
+                                const bh = srcBack[s] >= 0 ? hits[srcBack[s]] : null;
+                                if (typeof fh === 'object' && bh !== null && typeof bh === 'object') {
+                                    // The solid between the first wall's near side and the last wall's far side (ADR-0130);
+                                    // a surface with no depth (a single-sided sheet) has an unknown thickness: fully occluding.
+                                    const span = srcLen[s] - fh.distance - bh.distance;
+                                    target = span > 1e-3 ? 1 - Math.exp(-span / thickness) : 1;
+                                }
+                                else
+                                    target = 1;
+                                // Diffraction: the share of the detours clear both ways lets that much around the wall.
+                                if (srcDet[s] >= 0) {
+                                    let clear = 0;
+                                    for (let d = 0; d < 4; d++)
+                                        if (!blocked(srcDet[s] + 2 * d) && !blocked(srcDet[s] + 2 * d + 1))
+                                            clear++;
+                                    target *= 1 - (diffraction * clear) / 4;
+                                }
+                            }
+                            const o = occlusion.get(srcKey[s]) ?? 0;
+                            occlusion.set(srcKey[s], o + (target - o) * k);
+                        }
+                        if (refHits.length === 6) {
+                            for (let i = 0; i < 6; i++) {
+                                const h = refHits[i];
+                                const axis = i >> 1;
+                                const pan = (i & 1 ? -1 : 1) * refRight[axis];
+                                if (h)
+                                    mixer.reflection(i, (2 * h.distance) / (dop?.speedOfSound ?? 343), refGain / (1 + 2 * h.distance), pan);
+                                else
+                                    mixer.reflection(i, 0, 0, 0);
+                            }
+                        }
+                    }
+                    rays.length = 0;
+                    refRays.length = 0;
+                    srcKey.length = srcFwd.length = srcBack.length = srcLen.length = srcDet.length = 0;
+                    // This frame's reflection rays: ±x, ±y, ±z from the listener, panned by the listener's right.
+                    if (reflecting) {
+                        const fw = pose.forward;
+                        const up = pose.up;
+                        refRight[0] = fw[1] * up[2] - fw[2] * up[1];
+                        refRight[1] = fw[2] * up[0] - fw[0] * up[2];
+                        refRight[2] = fw[0] * up[1] - fw[1] * up[0];
+                        for (let i = 0; i < 6; i++) {
+                            const dir = [0, 0, 0];
+                            dir[i >> 1] = i & 1 ? -1 : 1;
+                            refRays.push([[pose.position[0], pose.position[1], pose.position[2]], dir, refDistance, refMask]);
+                        }
+                    }
+                    seen.clear();
+                    mixer.beginFrame(pose);
+                    // Reverb zones (ADR-0116): each at the listener's weight in it (the listener in the zone's frame).
+                    mixer.beginZones();
+                    zones.forEachChunk((c) => {
+                        const shape = c.u8(0);
+                        const x = c.f32(1);
+                        const y = c.f32(2);
+                        const z = c.f32(3);
+                        const fade = c.f32(4);
+                        const decay = c.f32(5);
+                        const wet = c.f32(6);
+                        const t = c.f64(7);
+                        const r = c.f32(8);
+                        for (let i = 0; i < c.length; i++) {
+                            inv[0] = -r[i * 4];
+                            inv[1] = -r[i * 4 + 1];
+                            inv[2] = -r[i * 4 + 2];
+                            inv[3] = r[i * 4 + 3];
+                            rotateTo(inv, pose.position[0] - t[i * 3], pose.position[1] - t[i * 3 + 1], pose.position[2] - t[i * 3 + 2], local);
+                            dims[0] = x[i];
+                            dims[1] = y[i];
+                            dims[2] = z[i];
+                            mixer.zone(c.entity(i), decay[i], wet[i], zoneWeight(shape[i], dims, fade[i], local));
+                        }
+                    });
+                    mixer.endZones();
+                    sources.forEachChunk((c) => {
+                        const clip = c.u32(0);
+                        const volume = c.f32(1);
+                        const pitch = c.f32(2);
+                        const loop = c.u8(3);
+                        const play = c.u8(4);
+                        const spatial = c.u8(5);
+                        const model = c.u8(6);
+                        const ref = c.f32(7);
+                        const max = c.f32(8);
+                        const rolloff = c.f32(9);
+                        const inner = c.f32(10);
+                        const outer = c.f32(11);
+                        const outerGain = c.f32(12);
+                        const t = c.f64(13);
+                        const r = c.f32(14);
+                        for (let i = 0; i < c.length; i++) {
+                            if (!play[i])
+                                continue;
+                            const key = c.entity(i);
+                            p.clip = clip[i];
+                            p.volume = volume[i];
+                            p.pitch = pitch[i];
+                            p.loop = loop[i] !== 0;
+                            p.spatial = spatial[i] !== 0;
+                            p.distanceModel = modelOf(model[i]);
+                            p.refDistance = ref[i];
+                            p.maxDistance = max[i];
+                            p.rolloff = rolloff[i];
+                            p.coneInner = inner[i];
+                            p.coneOuter = outer[i];
+                            p.coneOuterGain = outerGain[i];
+                            pos[0] = t[i * 3];
+                            pos[1] = t[i * 3 + 1];
+                            pos[2] = t[i * 3 + 2];
+                            const forward = rotate([r[i * 4], r[i * 4 + 1], r[i * 4 + 2], r[i * 4 + 3]], [0, 0, -1]);
+                            seen.add(key);
+                            if (p.spatial) {
+                                relative(pos, pose.position, offset);
+                                const dist = Math.hypot(offset[0], offset[1], offset[2]);
+                                if (dop && dop.scale > 0) {
+                                    let m = motion.get(key);
+                                    if (!m)
+                                        motion.set(key, (m = new Float64Array(7)));
+                                    track(m, pos, dt);
+                                    p.pitch *= dopplerFactor(offset, [m[3], m[4], m[5]], [listenerMotion[3], listenerMotion[4], listenerMotion[5]], dop.speedOfSound) ** dop.scale;
+                                }
+                                p.occlusion = occlusion.get(key) ?? 0;
+                                // This frame's rays, cast at the next frame's start (one batched query a frame).
+                                if (occluding && dist > 2 * margin) {
+                                    const s = 1 / dist;
+                                    const u = [offset[0] * s, offset[1] * s, offset[2] * s];
+                                    const lp = pose.position;
+                                    const len = dist - 2 * margin;
+                                    srcKey.push(key);
+                                    srcLen.push(len);
+                                    srcFwd.push(rays.length);
+                                    rays.push([[lp[0] + u[0] * margin, lp[1] + u[1] * margin, lp[2] + u[2] * margin], u, len, mask]);
+                                    // From the source back (ADR-0130): the last wall's far side, for its thickness.
+                                    srcBack.push(occOpts.query ? -1 : rays.length);
+                                    if (!occOpts.query)
+                                        rays.push([[lp[0] + u[0] * (dist - margin), lp[1] + u[1] * (dist - margin), lp[2] + u[2] * (dist - margin)], [-u[0], -u[1], -u[2]], len, mask]);
+                                    // Occluded now: four detours through points `radius` m around the source, across the line.
+                                    if (diffraction > 0 && (p.occlusion ?? 0) > 0.02) {
+                                        srcDet.push(rays.length);
+                                        detours(lp, u, dist, (from, dir, d) => rays.push([from, dir, d, mask]), radius, margin);
+                                    }
+                                    else
+                                        srcDet.push(-1);
+                                }
+                            }
+                            else
+                                p.occlusion = 0;
+                            // Played to its end (and not looping): the source says so, and lets the voice go.
+                            if (!mixer.update(key, p, pos, forward)) {
+                                play[i] = 0;
+                                mixer.stop(key);
+                            }
+                        }
+                    });
+                    mixer.endFrame();
+                    // Sources that stopped or went: their motion and occlusion go too.
+                    for (const k of motion.keys())
+                        if (!seen.has(k))
+                            motion.delete(k);
+                    for (const k of occlusion.keys())
+                        if (!seen.has(k))
+                            occlusion.delete(k);
+                },
+            });
+            if (options.resumeOnGesture ?? true) {
+                const ctx = context;
+                if (typeof ctx.resume === 'function' && typeof addEventListener === 'function') {
+                    const resume = () => {
+                        if (ctx.state === 'suspended')
+                            void ctx.resume();
+                    };
+                    addEventListener('pointerdown', resume, { capture: true });
+                    addEventListener('keydown', resume, { capture: true });
+                    b.onDispose(() => {
+                        removeEventListener('pointerdown', resume, { capture: true });
+                        removeEventListener('keydown', resume, { capture: true });
+                    });
+                }
+            }
+            b.counter('audio.voices', () => mixer.voices);
+            b.tool({
+                name: 'audio.voices',
+                description: 'The playing voices, the clips loaded, the master volume and the context state.',
+                input: { type: 'object', properties: {} },
+                run: () => ({
+                    voices: mixer.voices,
+                    started: mixer.started,
+                    clips: mixer.clips.count,
+                    volume: mixer.volume,
+                    zones: mixer.zones,
+                    state: context.state ?? 'offline',
+                    // ADR-0127: whether occlusion runs, and the sources more than half occluded now.
+                    occlusion: occluding,
+                    occluded: [...occlusion.values()].filter((o) => o > 0.5).length,
+                    doppler: dop ? dop.scale : 0,
+                }),
+            });
+            b.tool({
+                name: 'audio.volume',
+                description: 'Sets the master volume (linear, 0 = silent).',
+                input: { type: 'object', properties: { volume: { type: 'number', description: 'Linear gain, 0 or more.' } }, required: ['volume'] },
+                run: (args) => {
+                    const v = Number(args.volume);
+                    if (!(v >= 0))
+                        throw Object.assign(new YaliError('AUDIO_INVALID', `Volume ${args.volume}.`, 'Pass a number 0 or more.'), { path: 'volume' });
+                    mixer.volume = v;
+                    return { volume: v };
+                },
+            });
+            b.onDispose(() => {
+                mixer.dispose();
+                if (!options.context && 'close' in context)
+                    void context.close();
+            });
+        },
+    };
+}
+function newContext() {
+    if (typeof AudioContext === 'undefined') {
+        throw new YaliError('AUDIO_UNAVAILABLE', 'There is no Web Audio here (no AudioContext).', 'Run in a browser page, or pass audioPlugin({ context }) (an OfflineAudioContext in tests).');
+    }
+    return new AudioContext();
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/space.d.ts

@@ -0,0 +1,52 @@
+/** Where the listener is and which way it faces (f64 position, unit vectors). */
+export interface ListenerPose {
+    readonly position: ArrayLike<number>;
+    readonly forward: readonly [number, number, number];
+    readonly up: readonly [number, number, number];
+}
+/**
+ * A source's position relative to the listener, in f32 range: the listener sits at the origin of
+ * the audio graph and sources are placed relative to it, so a scene 10,000 km out sounds the same
+ * as one at the origin (Web Audio's positions are f32).
+ */
+export declare function relative(source: ArrayLike<number>, listener: ArrayLike<number>, out?: number[]): number[];
+/**
+ * The Doppler factor (ADR-0127): how much faster a sound plays heard by a listener moving at
+ * `listenerVel` from a source moving at `sourceVel` (m/s, world), the source `offset` from the listener
+ * (source − listener): (c − v_listener·u) / (c − v_source·u), u the unit vector from the source to the
+ * listener, c the speed of sound. Each speed along u is held within ±0.9 c (a supersonic source has no
+ * finite answer), so the factor stays between 1/19 and 19.
+ *
+ * @example
+ * dopplerFactor([10, 0, 0], [0, 0, 0], [0, 0, 0], 343); // 1: nothing moves
+ * dopplerFactor([-10, 0, 0], [-20, 0, 0], [0, 0, 0], 343); // > 1: a source 10 m away coming at 20 m/s
+ */
+export declare function dopplerFactor(offset: ArrayLike<number>, sourceVel: ArrayLike<number>, listenerVel: ArrayLike<number>, c?: number): number;
+/** `v` rotated by unit quaternion `q` (x, y, z, w). */
+export declare function rotate(q: ArrayLike<number>, v: readonly number[]): [number, number, number];
+/** `v` (x, y, z) rotated by unit quaternion `q` into `out` (no allocation: per-frame paths). */
+export declare function rotateTo(q: ArrayLike<number>, x: number, y: number, z: number, out: number[]): number[];
+/** An entity's facing from its rotation: forward −Z, up +Y (glTF's and the camera's convention). */
+export declare function poseOf(position: ArrayLike<number>, q: ArrayLike<number>): ListenerPose;
+/** The listener at an orbit camera: at its eye, facing its target, up +Y (orthogonalised). */
+export declare function cameraPose(eye: ArrayLike<number>, target: ArrayLike<number>): ListenerPose;
+/** Web Audio's distance models (the panner's `distanceModel`). */
+export type DistanceModel = 'linear' | 'inverse' | 'exponential';
+/**
+ * The gain a distance model gives at `d` (Web Audio's formulas, so tests and tools can predict
+ * what the panner does): `ref` the distance of full volume, `max` where `linear` reaches the end,
+ * `rolloff` how fast it falls.
+ */
+export declare function distanceGain(model: DistanceModel, d: number, ref: number, max: number, rolloff: number): number;
+/**
+ * How much of a reverb zone the listener hears (ADR-0116): 1 at least `fade` metres inside it,
+ * falling to 0 at its edge. `local` is the listener in the zone's frame (its rotation undone);
+ * `shape` 0 is a sphere of radius `dims[0]`, 1 a box of half extents `dims`.
+ */
+export declare function zoneWeight(shape: number, dims: ArrayLike<number>, fade: number, local: ArrayLike<number>): number;
+/**
+ * A reverb's impulse response (ADR-0116): stereo noise under an exponential decay that reaches −60 dB
+ * at `decay` seconds, the two channels decorrelated, written into `left` and `right` (each
+ * `decay × rate` samples, at most 6 s). Deterministic for a seed, so a run sounds the same.
+ */
+export declare function impulseResponse(left: Float32Array, right: Float32Array, rate: number, decay: number, seed?: number): void;