@vielzeug/bard 0.0.0-stage → 26.11.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +53 -2
- package/dist/_bus.cjs +2 -0
- package/dist/_bus.cjs.map +1 -0
- package/dist/_bus.d.ts +28 -0
- package/dist/_bus.d.ts.map +1 -0
- package/dist/_bus.js +108 -0
- package/dist/_bus.js.map +1 -0
- package/dist/_context.cjs +2 -0
- package/dist/_context.cjs.map +1 -0
- package/dist/_context.d.ts +22 -0
- package/dist/_context.d.ts.map +1 -0
- package/dist/_context.js +73 -0
- package/dist/_context.js.map +1 -0
- package/dist/_deck.cjs +2 -0
- package/dist/_deck.cjs.map +1 -0
- package/dist/_deck.d.ts +24 -0
- package/dist/_deck.d.ts.map +1 -0
- package/dist/_deck.js +166 -0
- package/dist/_deck.js.map +1 -0
- package/dist/_loader.cjs +2 -0
- package/dist/_loader.cjs.map +1 -0
- package/dist/_loader.d.ts +37 -0
- package/dist/_loader.d.ts.map +1 -0
- package/dist/_loader.js +88 -0
- package/dist/_loader.js.map +1 -0
- package/dist/_media-session.cjs +2 -0
- package/dist/_media-session.cjs.map +1 -0
- package/dist/_media-session.d.ts +23 -0
- package/dist/_media-session.d.ts.map +1 -0
- package/dist/_media-session.js +49 -0
- package/dist/_media-session.js.map +1 -0
- package/dist/_ramp.cjs +2 -0
- package/dist/_ramp.cjs.map +1 -0
- package/dist/_ramp.d.ts +20 -0
- package/dist/_ramp.d.ts.map +1 -0
- package/dist/_ramp.js +19 -0
- package/dist/_ramp.js.map +1 -0
- package/dist/_stream.cjs +2 -0
- package/dist/_stream.cjs.map +1 -0
- package/dist/_stream.d.ts +25 -0
- package/dist/_stream.d.ts.map +1 -0
- package/dist/_stream.js +46 -0
- package/dist/_stream.js.map +1 -0
- package/dist/_synth.cjs +2 -0
- package/dist/_synth.cjs.map +1 -0
- package/dist/_synth.d.ts +14 -0
- package/dist/_synth.d.ts.map +1 -0
- package/dist/_synth.js +101 -0
- package/dist/_synth.js.map +1 -0
- package/dist/_tappers.cjs +2 -0
- package/dist/_tappers.cjs.map +1 -0
- package/dist/_tappers.d.ts +23 -0
- package/dist/_tappers.d.ts.map +1 -0
- package/dist/_tappers.js +24 -0
- package/dist/_tappers.js.map +1 -0
- package/dist/_voices.cjs +2 -0
- package/dist/_voices.cjs.map +1 -0
- package/dist/_voices.d.ts +23 -0
- package/dist/_voices.d.ts.map +1 -0
- package/dist/_voices.js +110 -0
- package/dist/_voices.js.map +1 -0
- package/dist/bard.cjs +2 -0
- package/dist/bard.cjs.map +1 -0
- package/dist/bard.d.ts +8 -0
- package/dist/bard.d.ts.map +1 -0
- package/dist/bard.iife.js +2 -0
- package/dist/bard.iife.js.map +1 -0
- package/dist/bard.js +901 -0
- package/dist/bard.js.map +1 -0
- package/dist/errors.cjs +2 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.ts +14 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +9 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +3 -0
- package/dist/testing/index.d.ts +146 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing.cjs +2 -0
- package/dist/testing.cjs.map +1 -0
- package/dist/testing.js +221 -0
- package/dist/testing.js.map +1 -0
- package/dist/types.d.ts +269 -0
- package/dist/types.d.ts.map +1 -0
- package/package.json +58 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Helmuth Saatkamp
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,54 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @vielzeug/bard
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Lifecycle-owned Web Audio mixing: buses with ducking, buffered SFX and sprites, procedural synth, streamed tracks, and crossfading music decks
|
|
4
|
+
|
|
5
|
+
## Installation
|
|
6
|
+
|
|
7
|
+
```sh
|
|
8
|
+
pnpm add @vielzeug/bard
|
|
9
|
+
npm install @vielzeug/bard
|
|
10
|
+
yarn add @vielzeug/bard
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Quick Start
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import { createBard } from '@vielzeug/bard';
|
|
17
|
+
|
|
18
|
+
const bard = createBard({
|
|
19
|
+
ducking: [{ source: 'voice', target: 'music', gain: 0.3 }],
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
await bard.load({
|
|
23
|
+
music: { src: '/theme.mp3', stream: true },
|
|
24
|
+
dice: { src: '/sfx.wav', sprites: { roll: [0, 1.2] } },
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
const deck = bard.createDeck();
|
|
28
|
+
deck.transition('music', { loop: true });
|
|
29
|
+
bard.play('dice:roll', { detune: [-60, 60] });
|
|
30
|
+
|
|
31
|
+
bard.dispose(); // stops voices, removes listeners, closes the context
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
The engine owns the `AudioContext` until you dispose it: voices, gesture listeners, pending fetches, and decks are all released by one call. Importing on a server touches nothing until the first audio call.
|
|
35
|
+
|
|
36
|
+
## Features
|
|
37
|
+
|
|
38
|
+
- **`bus()`**: named gain buses with click-free volume ramps and `ducking` rules.
|
|
39
|
+
- **`play()`**: buffered SFX with sprites, voice caps, and detune/rate variance.
|
|
40
|
+
- **`synth()`**: zero-asset oscillator and noise voices with ADSR envelopes.
|
|
41
|
+
- **`createDeck()`**: crossfading music deck with loop points, queue, and Media Session.
|
|
42
|
+
- **`@vielzeug/bard/testing`**: deterministic Web Audio fakes with a manual clock.
|
|
43
|
+
|
|
44
|
+
## Documentation
|
|
45
|
+
|
|
46
|
+
- [Overview](https://vielzeug.dev/bard/)
|
|
47
|
+
- [Usage Guide](https://vielzeug.dev/bard/usage)
|
|
48
|
+
- [API Reference](https://vielzeug.dev/bard/api)
|
|
49
|
+
- [Examples](https://vielzeug.dev/bard/examples)
|
|
50
|
+
- [Migration](https://vielzeug.dev/bard/migration)
|
|
51
|
+
|
|
52
|
+
## License
|
|
53
|
+
|
|
54
|
+
MIT © [Helmuth Saatkamp](https://github.com/helmuthdu): part of the [Vielzeug](https://github.com/helmuthdu/vielzeug) monorepo.
|
package/dist/_bus.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./_ramp.cjs"),t=require("./errors.cjs");function createBusManager(n){let r=n.context,i=r.createGain();i.gain.value=n.volume,i.connect(r.destination);let a=new Map,createBus=t=>{let n=r.createGain(),a=r.createGain(),o=r.createGain();n.connect(a),a.connect(o),o.connect(i);let s={get controller(){return c},disconnect(){n.disconnect(),a.disconnect(),o.disconnect()},duckGain:a,duckLevel:1,input:n,muted:!1,name:t,userVolume:1,volumeGain:o},c={get duckLevel(){return s.duckLevel},mute(){s.muted=!0,applyVolume()},get muted(){return s.muted},name:t,setVolume(t,n){s.userVolume=Math.min(Math.max(t,0),1),e.rampParam(o.gain,s.muted?0:s.userVolume,n?.fade??.015,r.currentTime)},unmute(){s.muted=!1,applyVolume()},get volume(){return s.userVolume}},applyVolume=()=>{e.rampParam(o.gain,s.muted?0:s.userVolume,e.MICRO_FADE,r.currentTime)};return s};for(let e of n.buses)a.set(e,createBus(e));let o=!1,s=n.volume,c={get duckLevel(){return 1},mute(){o=!0,e.rampParam(i.gain,0,e.MICRO_FADE,r.currentTime)},get muted(){return o},name:`master`,setVolume(t,n){s=Math.min(Math.max(t,0),1),e.rampParam(i.gain,o?0:s,n?.fade??.015,r.currentTime)},unmute(){o=!1,e.rampParam(i.gain,s,e.MICRO_FADE,r.currentTime)},get volume(){return s}},l=new Map,u=new Map,applyDuck=t=>{let i=a.get(t);if(!i)return;let o=n.ducking.filter(e=>e.target===t).map(e=>({ducking:(l.get(e.source)??0)>0,rule:e})).filter(e=>e.ducking).map(e=>e.rule.gain),s=o.length>0?Math.min(...o):1,c=u.get(t)??1;if(s===c)return;u.set(t,s),i.duckLevel=s;let d=n.ducking.find(e=>e.target===t&&(e.gain===s||s===1)),f=s<c?d?.attack??.2:d?.release??.8;e.rampParam(i.duckGain.gain,s,f,r.currentTime),n.onDuck?.(t,s,f)};return{dispose(){for(let e of a.values())e.disconnect();i.disconnect()},get(e){if(e===`master`)return{controller:c,duckLevel:1,input:i,name:`master`};let n=a.get(e);if(!n)throw new t.BardError(`Unknown bus "${e}".`);return n},voiceCount(e,t){if(!a.has(e))return;let r=Math.max(0,(l.get(e)??0)+t);l.set(e,r);for(let t of new Set(n.ducking.filter(t=>t.source===e).map(e=>e.target)))applyDuck(t)}}}exports.createBusManager=createBusManager;
|
|
2
|
+
//# sourceMappingURL=_bus.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_bus.cjs","names":["MICRO_FADE","BardError","require__ramp","require_errors","ctx","options","master","buses","input","duckGain","volumeGain","internal","controller","volume","fadeOptions","name","masterMuted","masterVolume","masterController","voiceCounts","duckLevels","bus","target","active","rule","entry","wanted","current","r","ramp","source","next","delta"],"sources":["../src/_bus.ts"],"sourcesContent":["import { DEFAULT_ATTACK, DEFAULT_RELEASE, MICRO_FADE, rampParam } from './_ramp';\nimport { BardError } from './errors';\nimport type { BusController, DuckingRule } from './types';\n\nexport interface Bus {\n readonly controller: BusController;\n /** Current duck level (1 = unducked). */\n readonly duckLevel: number;\n /** Where voices connect; the bus's input gain. */\n readonly input: GainNode;\n readonly name: string;\n}\n\ninterface BusInternal extends Bus {\n /** Active voice count per ducking source (this bus as ducking target's partner). */\n disconnect(): void;\n readonly duckGain: GainNode;\n duckLevel: number;\n muted: boolean;\n userVolume: number;\n readonly volumeGain: GainNode;\n}\n\nexport interface BusManager {\n dispose(): void;\n get(name: string): Bus;\n /** Adjusts the active-voice count on `source` and ramps every ducked target. */\n voiceCount(source: string, delta: number): void;\n}\n\n/**\n * The routing graph: `voice -> [panner] -> bus input -> bus duck -> bus volume\n * -> master -> destination`. Ducking gets its own gain stage so user volume\n * automation and duck automation never fight over one `AudioParam`.\n */\nexport function createBusManager(options: {\n readonly context: AudioContext;\n readonly buses: readonly string[];\n readonly volume: number;\n readonly ducking: readonly DuckingRule[];\n readonly onDuck?: (bus: string, level: number, ramp: number) => void;\n}): BusManager {\n const ctx = options.context;\n const master = ctx.createGain();\n master.gain.value = options.volume;\n master.connect(ctx.destination);\n\n const buses = new Map<string, BusInternal>();\n\n const createBus = (name: string): BusInternal => {\n const input = ctx.createGain();\n const duckGain = ctx.createGain();\n const volumeGain = ctx.createGain();\n input.connect(duckGain);\n duckGain.connect(volumeGain);\n volumeGain.connect(master);\n const internal: BusInternal = {\n get controller(): BusController {\n return controller;\n },\n disconnect(): void {\n input.disconnect();\n duckGain.disconnect();\n volumeGain.disconnect();\n },\n duckGain,\n duckLevel: 1,\n input,\n muted: false,\n name,\n userVolume: 1,\n volumeGain,\n };\n const controller: BusController = {\n get duckLevel() {\n return internal.duckLevel;\n },\n mute(): void {\n internal.muted = true;\n applyVolume();\n },\n get muted() {\n return internal.muted;\n },\n name,\n setVolume(volume, fadeOptions): void {\n internal.userVolume = Math.min(Math.max(volume, 0), 1);\n rampParam(\n volumeGain.gain,\n internal.muted ? 0 : internal.userVolume,\n fadeOptions?.fade ?? MICRO_FADE,\n ctx.currentTime,\n );\n },\n unmute(): void {\n internal.muted = false;\n applyVolume();\n },\n get volume() {\n return internal.userVolume;\n },\n };\n const applyVolume = (): void => {\n rampParam(volumeGain.gain, internal.muted ? 0 : internal.userVolume, MICRO_FADE, ctx.currentTime);\n };\n return internal;\n };\n\n for (const name of options.buses) {\n buses.set(name, createBus(name));\n }\n\n let masterMuted = false;\n let masterVolume = options.volume;\n const masterController: BusController = {\n get duckLevel() {\n return 1;\n },\n mute(): void {\n masterMuted = true;\n rampParam(master.gain, 0, MICRO_FADE, ctx.currentTime);\n },\n get muted() {\n return masterMuted;\n },\n name: 'master',\n setVolume(volume, fadeOptions): void {\n masterVolume = Math.min(Math.max(volume, 0), 1);\n rampParam(master.gain, masterMuted ? 0 : masterVolume, fadeOptions?.fade ?? MICRO_FADE, ctx.currentTime);\n },\n unmute(): void {\n masterMuted = false;\n rampParam(master.gain, masterVolume, MICRO_FADE, ctx.currentTime);\n },\n get volume() {\n return masterVolume;\n },\n };\n\n /** Active voices per bus name, for ducking sources. */\n const voiceCounts = new Map<string, number>();\n /** Current duck multiplier per ducked target bus. */\n const duckLevels = new Map<string, number>();\n\n const applyDuck = (target: string): void => {\n const bus = buses.get(target);\n if (!bus) return;\n const active = options.ducking\n .filter((rule) => rule.target === target)\n .map((rule) => ({ ducking: (voiceCounts.get(rule.source) ?? 0) > 0, rule }))\n .filter((entry) => entry.ducking)\n .map((entry) => entry.rule.gain);\n const wanted = active.length > 0 ? Math.min(...active) : 1;\n const current = duckLevels.get(target) ?? 1;\n if (wanted === current) return;\n duckLevels.set(target, wanted);\n bus.duckLevel = wanted;\n const rule = options.ducking.find((r) => r.target === target && (r.gain === wanted || wanted === 1));\n const ramp = wanted < current ? (rule?.attack ?? DEFAULT_ATTACK) : (rule?.release ?? DEFAULT_RELEASE);\n rampParam(bus.duckGain.gain, wanted, ramp, ctx.currentTime);\n options.onDuck?.(target, wanted, ramp);\n };\n\n return {\n dispose(): void {\n for (const bus of buses.values()) bus.disconnect();\n master.disconnect();\n },\n get(name: string): Bus {\n if (name === 'master') {\n return {\n controller: masterController,\n duckLevel: 1,\n input: master,\n name: 'master',\n };\n }\n const bus = buses.get(name);\n if (!bus) throw new BardError(`Unknown bus \"${name}\".`);\n return bus;\n },\n voiceCount(source, delta): void {\n if (!buses.has(source)) return;\n const next = Math.max(0, (voiceCounts.get(source) ?? 0) + delta);\n voiceCounts.set(source, next);\n for (const target of new Set(\n options.ducking.filter((rule) => rule.source === source).map((rule) => rule.target),\n )) {\n applyDuck(target);\n }\n },\n };\n}\n"],"mappings":"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"}
|
package/dist/_bus.d.ts
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { BusController, DuckingRule } from './types';
|
|
2
|
+
export interface Bus {
|
|
3
|
+
readonly controller: BusController;
|
|
4
|
+
/** Current duck level (1 = unducked). */
|
|
5
|
+
readonly duckLevel: number;
|
|
6
|
+
/** Where voices connect; the bus's input gain. */
|
|
7
|
+
readonly input: GainNode;
|
|
8
|
+
readonly name: string;
|
|
9
|
+
}
|
|
10
|
+
export interface BusManager {
|
|
11
|
+
dispose(): void;
|
|
12
|
+
get(name: string): Bus;
|
|
13
|
+
/** Adjusts the active-voice count on `source` and ramps every ducked target. */
|
|
14
|
+
voiceCount(source: string, delta: number): void;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* The routing graph: `voice -> [panner] -> bus input -> bus duck -> bus volume
|
|
18
|
+
* -> master -> destination`. Ducking gets its own gain stage so user volume
|
|
19
|
+
* automation and duck automation never fight over one `AudioParam`.
|
|
20
|
+
*/
|
|
21
|
+
export declare function createBusManager(options: {
|
|
22
|
+
readonly context: AudioContext;
|
|
23
|
+
readonly buses: readonly string[];
|
|
24
|
+
readonly volume: number;
|
|
25
|
+
readonly ducking: readonly DuckingRule[];
|
|
26
|
+
readonly onDuck?: (bus: string, level: number, ramp: number) => void;
|
|
27
|
+
}): BusManager;
|
|
28
|
+
//# sourceMappingURL=_bus.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_bus.d.ts","sourceRoot":"","sources":["../src/_bus.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAYD,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IACvB,gFAAgF;IAChF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE,GAAG,UAAU,CAuJb"}
|
package/dist/_bus.js
ADDED
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import { MICRO_FADE as e, rampParam as t } from "./_ramp.js";
|
|
2
|
+
import { BardError as n } from "./errors.js";
|
|
3
|
+
// src/_bus.ts
|
|
4
|
+
function createBusManager(r) {
|
|
5
|
+
let i = r.context, a = i.createGain();
|
|
6
|
+
a.gain.value = r.volume, a.connect(i.destination);
|
|
7
|
+
let o = /* @__PURE__ */ new Map(), createBus = (n) => {
|
|
8
|
+
let r = i.createGain(), o = i.createGain(), s = i.createGain();
|
|
9
|
+
r.connect(o), o.connect(s), s.connect(a);
|
|
10
|
+
let c = {
|
|
11
|
+
get controller() {
|
|
12
|
+
return l;
|
|
13
|
+
},
|
|
14
|
+
disconnect() {
|
|
15
|
+
r.disconnect(), o.disconnect(), s.disconnect();
|
|
16
|
+
},
|
|
17
|
+
duckGain: o,
|
|
18
|
+
duckLevel: 1,
|
|
19
|
+
input: r,
|
|
20
|
+
muted: !1,
|
|
21
|
+
name: n,
|
|
22
|
+
userVolume: 1,
|
|
23
|
+
volumeGain: s
|
|
24
|
+
}, l = {
|
|
25
|
+
get duckLevel() {
|
|
26
|
+
return c.duckLevel;
|
|
27
|
+
},
|
|
28
|
+
mute() {
|
|
29
|
+
c.muted = !0, applyVolume();
|
|
30
|
+
},
|
|
31
|
+
get muted() {
|
|
32
|
+
return c.muted;
|
|
33
|
+
},
|
|
34
|
+
name: n,
|
|
35
|
+
setVolume(e, n) {
|
|
36
|
+
c.userVolume = Math.min(Math.max(e, 0), 1), t(s.gain, c.muted ? 0 : c.userVolume, n?.fade ?? .015, i.currentTime);
|
|
37
|
+
},
|
|
38
|
+
unmute() {
|
|
39
|
+
c.muted = !1, applyVolume();
|
|
40
|
+
},
|
|
41
|
+
get volume() {
|
|
42
|
+
return c.userVolume;
|
|
43
|
+
}
|
|
44
|
+
}, applyVolume = () => {
|
|
45
|
+
t(s.gain, c.muted ? 0 : c.userVolume, e, i.currentTime);
|
|
46
|
+
};
|
|
47
|
+
return c;
|
|
48
|
+
};
|
|
49
|
+
for (let e of r.buses) o.set(e, createBus(e));
|
|
50
|
+
let s = !1, c = r.volume, l = {
|
|
51
|
+
get duckLevel() {
|
|
52
|
+
return 1;
|
|
53
|
+
},
|
|
54
|
+
mute() {
|
|
55
|
+
s = !0, t(a.gain, 0, e, i.currentTime);
|
|
56
|
+
},
|
|
57
|
+
get muted() {
|
|
58
|
+
return s;
|
|
59
|
+
},
|
|
60
|
+
name: "master",
|
|
61
|
+
setVolume(e, n) {
|
|
62
|
+
c = Math.min(Math.max(e, 0), 1), t(a.gain, s ? 0 : c, n?.fade ?? .015, i.currentTime);
|
|
63
|
+
},
|
|
64
|
+
unmute() {
|
|
65
|
+
s = !1, t(a.gain, c, e, i.currentTime);
|
|
66
|
+
},
|
|
67
|
+
get volume() {
|
|
68
|
+
return c;
|
|
69
|
+
}
|
|
70
|
+
}, u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), applyDuck = (e) => {
|
|
71
|
+
let n = o.get(e);
|
|
72
|
+
if (!n) return;
|
|
73
|
+
let a = r.ducking.filter((t) => t.target === e).map((e) => ({
|
|
74
|
+
ducking: (u.get(e.source) ?? 0) > 0,
|
|
75
|
+
rule: e
|
|
76
|
+
})).filter((e) => e.ducking).map((e) => e.rule.gain), s = a.length > 0 ? Math.min(...a) : 1, c = d.get(e) ?? 1;
|
|
77
|
+
if (s === c) return;
|
|
78
|
+
d.set(e, s), n.duckLevel = s;
|
|
79
|
+
let l = r.ducking.find((t) => t.target === e && (t.gain === s || s === 1)), f = s < c ? l?.attack ?? .2 : l?.release ?? .8;
|
|
80
|
+
t(n.duckGain.gain, s, f, i.currentTime), r.onDuck?.(e, s, f);
|
|
81
|
+
};
|
|
82
|
+
return {
|
|
83
|
+
dispose() {
|
|
84
|
+
for (let e of o.values()) e.disconnect();
|
|
85
|
+
a.disconnect();
|
|
86
|
+
},
|
|
87
|
+
get(e) {
|
|
88
|
+
if (e === "master") return {
|
|
89
|
+
controller: l,
|
|
90
|
+
duckLevel: 1,
|
|
91
|
+
input: a,
|
|
92
|
+
name: "master"
|
|
93
|
+
};
|
|
94
|
+
let t = o.get(e);
|
|
95
|
+
if (!t) throw new n(`Unknown bus "${e}".`);
|
|
96
|
+
return t;
|
|
97
|
+
},
|
|
98
|
+
voiceCount(e, t) {
|
|
99
|
+
if (!o.has(e)) return;
|
|
100
|
+
let n = Math.max(0, (u.get(e) ?? 0) + t);
|
|
101
|
+
u.set(e, n);
|
|
102
|
+
for (let t of new Set(r.ducking.filter((t) => t.source === e).map((e) => e.target))) applyDuck(t);
|
|
103
|
+
}
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
export { createBusManager };
|
|
107
|
+
|
|
108
|
+
//# sourceMappingURL=_bus.js.map
|
package/dist/_bus.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_bus.js","names":["ctx","options","master","buses","input","duckGain","volumeGain","internal","controller","volume","rampParam","fadeOptions","MICRO_FADE","name","masterMuted","masterVolume","masterController","voiceCounts","duckLevels","bus","target","active","rule","entry","wanted","current","r","ramp","BardError","source","next","delta"],"sources":["../src/_bus.ts"],"sourcesContent":["import { DEFAULT_ATTACK, DEFAULT_RELEASE, MICRO_FADE, rampParam } from './_ramp';\nimport { BardError } from './errors';\nimport type { BusController, DuckingRule } from './types';\n\nexport interface Bus {\n readonly controller: BusController;\n /** Current duck level (1 = unducked). */\n readonly duckLevel: number;\n /** Where voices connect; the bus's input gain. */\n readonly input: GainNode;\n readonly name: string;\n}\n\ninterface BusInternal extends Bus {\n /** Active voice count per ducking source (this bus as ducking target's partner). */\n disconnect(): void;\n readonly duckGain: GainNode;\n duckLevel: number;\n muted: boolean;\n userVolume: number;\n readonly volumeGain: GainNode;\n}\n\nexport interface BusManager {\n dispose(): void;\n get(name: string): Bus;\n /** Adjusts the active-voice count on `source` and ramps every ducked target. */\n voiceCount(source: string, delta: number): void;\n}\n\n/**\n * The routing graph: `voice -> [panner] -> bus input -> bus duck -> bus volume\n * -> master -> destination`. Ducking gets its own gain stage so user volume\n * automation and duck automation never fight over one `AudioParam`.\n */\nexport function createBusManager(options: {\n readonly context: AudioContext;\n readonly buses: readonly string[];\n readonly volume: number;\n readonly ducking: readonly DuckingRule[];\n readonly onDuck?: (bus: string, level: number, ramp: number) => void;\n}): BusManager {\n const ctx = options.context;\n const master = ctx.createGain();\n master.gain.value = options.volume;\n master.connect(ctx.destination);\n\n const buses = new Map<string, BusInternal>();\n\n const createBus = (name: string): BusInternal => {\n const input = ctx.createGain();\n const duckGain = ctx.createGain();\n const volumeGain = ctx.createGain();\n input.connect(duckGain);\n duckGain.connect(volumeGain);\n volumeGain.connect(master);\n const internal: BusInternal = {\n get controller(): BusController {\n return controller;\n },\n disconnect(): void {\n input.disconnect();\n duckGain.disconnect();\n volumeGain.disconnect();\n },\n duckGain,\n duckLevel: 1,\n input,\n muted: false,\n name,\n userVolume: 1,\n volumeGain,\n };\n const controller: BusController = {\n get duckLevel() {\n return internal.duckLevel;\n },\n mute(): void {\n internal.muted = true;\n applyVolume();\n },\n get muted() {\n return internal.muted;\n },\n name,\n setVolume(volume, fadeOptions): void {\n internal.userVolume = Math.min(Math.max(volume, 0), 1);\n rampParam(\n volumeGain.gain,\n internal.muted ? 0 : internal.userVolume,\n fadeOptions?.fade ?? MICRO_FADE,\n ctx.currentTime,\n );\n },\n unmute(): void {\n internal.muted = false;\n applyVolume();\n },\n get volume() {\n return internal.userVolume;\n },\n };\n const applyVolume = (): void => {\n rampParam(volumeGain.gain, internal.muted ? 0 : internal.userVolume, MICRO_FADE, ctx.currentTime);\n };\n return internal;\n };\n\n for (const name of options.buses) {\n buses.set(name, createBus(name));\n }\n\n let masterMuted = false;\n let masterVolume = options.volume;\n const masterController: BusController = {\n get duckLevel() {\n return 1;\n },\n mute(): void {\n masterMuted = true;\n rampParam(master.gain, 0, MICRO_FADE, ctx.currentTime);\n },\n get muted() {\n return masterMuted;\n },\n name: 'master',\n setVolume(volume, fadeOptions): void {\n masterVolume = Math.min(Math.max(volume, 0), 1);\n rampParam(master.gain, masterMuted ? 0 : masterVolume, fadeOptions?.fade ?? MICRO_FADE, ctx.currentTime);\n },\n unmute(): void {\n masterMuted = false;\n rampParam(master.gain, masterVolume, MICRO_FADE, ctx.currentTime);\n },\n get volume() {\n return masterVolume;\n },\n };\n\n /** Active voices per bus name, for ducking sources. */\n const voiceCounts = new Map<string, number>();\n /** Current duck multiplier per ducked target bus. */\n const duckLevels = new Map<string, number>();\n\n const applyDuck = (target: string): void => {\n const bus = buses.get(target);\n if (!bus) return;\n const active = options.ducking\n .filter((rule) => rule.target === target)\n .map((rule) => ({ ducking: (voiceCounts.get(rule.source) ?? 0) > 0, rule }))\n .filter((entry) => entry.ducking)\n .map((entry) => entry.rule.gain);\n const wanted = active.length > 0 ? Math.min(...active) : 1;\n const current = duckLevels.get(target) ?? 1;\n if (wanted === current) return;\n duckLevels.set(target, wanted);\n bus.duckLevel = wanted;\n const rule = options.ducking.find((r) => r.target === target && (r.gain === wanted || wanted === 1));\n const ramp = wanted < current ? (rule?.attack ?? DEFAULT_ATTACK) : (rule?.release ?? DEFAULT_RELEASE);\n rampParam(bus.duckGain.gain, wanted, ramp, ctx.currentTime);\n options.onDuck?.(target, wanted, ramp);\n };\n\n return {\n dispose(): void {\n for (const bus of buses.values()) bus.disconnect();\n master.disconnect();\n },\n get(name: string): Bus {\n if (name === 'master') {\n return {\n controller: masterController,\n duckLevel: 1,\n input: master,\n name: 'master',\n };\n }\n const bus = buses.get(name);\n if (!bus) throw new BardError(`Unknown bus \"${name}\".`);\n return bus;\n },\n voiceCount(source, delta): void {\n if (!buses.has(source)) return;\n const next = Math.max(0, (voiceCounts.get(source) ?? 0) + delta);\n voiceCounts.set(source, next);\n for (const target of new Set(\n options.ducking.filter((rule) => rule.source === source).map((rule) => rule.target),\n )) {\n applyDuck(target);\n }\n },\n };\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./errors.cjs");var t=[`pointerup`,`touchend`,`keydown`,`click`];function mapState(e){switch(e){case`running`:return`running`;case`interrupted`:return`interrupted`;case`closed`:return`closed`;default:return`suspended`}}function createContextManager(n){let r=n.factory===void 0,i=null,a=!1,o=!1,s=!1,c=typeof window>`u`?void 0:window,l=typeof document>`u`?void 0:document,detachUnlock=()=>{if(s&&c){s=!1;for(let e of t)c.removeEventListener(e,onUnlock,{capture:!0})}};function onUnlock(){i&&i.state!==`running`&&i.state!==`closed`&&i.resume().catch(()=>{})}let onVisibility=()=>{i&&l&&i.state!==`closed`&&(l.hidden?(o=!0,i.suspend().catch(()=>{})):o&&(o=!1,i.resume().catch(()=>{})))},onStateChange=()=>{if(!i)return;let e=mapState(i.state);n.onState(e),e===`running`&&detachUnlock()};return{get context(){return i},dispose(){a=!0,detachUnlock(),l&&l.removeEventListener(`visibilitychange`,onVisibility),i&&(i.removeEventListener(`statechange`,onStateChange),r&&i.state!==`closed`&&i.close().catch(()=>{}))},ensure(){if(a)throw new e.BardDisposedError(`The audio engine has been disposed.`);if(i)return i;if(n.factory)i=n.factory();else{if(typeof AudioContext>`u`)throw new e.BardUnsupportedError(`This runtime does not provide an AudioContext.`);i=new AudioContext}if(i.addEventListener(`statechange`,onStateChange),n.autoUnlock!==!1&&c){s=!0;for(let e of t)c.addEventListener(e,onUnlock,{capture:!0,passive:!0})}return n.autoSuspendOnHidden&&l&&l.addEventListener(`visibilitychange`,onVisibility),n.onState(mapState(i.state)),i},async resume(){let e=this.ensure();e.state!==`running`&&await e.resume()},get state(){return a?`closed`:i?mapState(i.state):`idle`},async suspend(){let e=this.ensure();e.state===`running`&&await e.suspend()}}}exports.createContextManager=createContextManager;
|
|
2
|
+
//# sourceMappingURL=_context.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_context.cjs","names":["BardDisposedError","BardUnsupportedError","require_errors","UNLOCK_EVENTS","state","owned","options","ctx","disposed","suspendedByVisibility","unlockAttached","win","doc","type","context"],"sources":["../src/_context.ts"],"sourcesContent":["import { BardDisposedError, BardUnsupportedError } from './errors';\nimport type { BardState } from './types';\n\n/** Gestures that count as user activation for audio unlock on every engine. */\nconst UNLOCK_EVENTS = ['pointerup', 'touchend', 'keydown', 'click'] as const;\n\nfunction mapState(state: string): BardState {\n switch (state) {\n case 'running':\n return 'running';\n case 'interrupted':\n return 'interrupted';\n case 'closed':\n return 'closed';\n default:\n return 'suspended';\n }\n}\n\nexport interface ContextManager {\n readonly context: AudioContext | null;\n dispose(): void;\n /** Lazily creates the context; throws `BardUnsupportedError` without Web Audio. */\n ensure(): AudioContext;\n resume(): Promise<void>;\n readonly state: BardState;\n suspend(): Promise<void>;\n}\n\n/**\n * Owns the lazy `AudioContext`: creation, gesture unlock, visibility handling,\n * state reporting, and teardown. Listeners attach only once a context exists,\n * so importing and constructing on a server touches nothing global.\n */\nexport function createContextManager(options: {\n readonly factory?: () => AudioContext;\n readonly autoUnlock?: boolean;\n readonly autoSuspendOnHidden?: boolean;\n readonly onState: (state: BardState) => void;\n}): ContextManager {\n const owned = options.factory === undefined;\n let ctx: AudioContext | null = null;\n let disposed = false;\n let suspendedByVisibility = false;\n let unlockAttached = false;\n\n const win: Window | undefined = typeof window === 'undefined' ? undefined : window;\n const doc: Document | undefined = typeof document === 'undefined' ? undefined : document;\n\n const detachUnlock = (): void => {\n if (!unlockAttached || !win) return;\n unlockAttached = false;\n for (const type of UNLOCK_EVENTS) {\n win.removeEventListener(type, onUnlock, { capture: true });\n }\n };\n\n function onUnlock(): void {\n // resume() must be called synchronously inside the gesture handler to\n // count as user activation; the rejection (autoplay still blocked) is\n // retried on the next gesture.\n if (ctx && ctx.state !== 'running' && ctx.state !== 'closed') {\n void ctx.resume().catch(() => {});\n }\n }\n\n const onVisibility = (): void => {\n if (!ctx || !doc || ctx.state === 'closed') return;\n if (doc.hidden) {\n suspendedByVisibility = true;\n void ctx.suspend().catch(() => {});\n } else if (suspendedByVisibility) {\n suspendedByVisibility = false;\n void ctx.resume().catch(() => {});\n }\n };\n\n const onStateChange = (): void => {\n if (!ctx) return;\n const state = mapState(ctx.state);\n options.onState(state);\n if (state === 'running') detachUnlock();\n };\n\n return {\n get context() {\n return ctx;\n },\n dispose(): void {\n disposed = true;\n detachUnlock();\n if (doc) doc.removeEventListener('visibilitychange', onVisibility);\n if (ctx) {\n ctx.removeEventListener('statechange', onStateChange);\n // Closing is fire-and-forget; a context that fails to close is\n // abandoned by the browser once the graph is disconnected.\n if (owned && ctx.state !== 'closed') void ctx.close().catch(() => {});\n }\n },\n ensure(): AudioContext {\n if (disposed) throw new BardDisposedError('The audio engine has been disposed.');\n if (ctx) return ctx;\n if (options.factory) {\n ctx = options.factory();\n } else {\n if (typeof AudioContext === 'undefined') {\n throw new BardUnsupportedError('This runtime does not provide an AudioContext.');\n }\n ctx = new AudioContext();\n }\n ctx.addEventListener('statechange', onStateChange);\n if (options.autoUnlock !== false && win) {\n unlockAttached = true;\n for (const type of UNLOCK_EVENTS) {\n win.addEventListener(type, onUnlock, { capture: true, passive: true });\n }\n }\n if (options.autoSuspendOnHidden && doc) {\n doc.addEventListener('visibilitychange', onVisibility);\n }\n options.onState(mapState(ctx.state));\n return ctx;\n },\n async resume(): Promise<void> {\n const context = this.ensure();\n if (context.state !== 'running') await context.resume();\n },\n get state(): BardState {\n if (disposed) return 'closed';\n return ctx ? mapState(ctx.state) : 'idle';\n },\n async suspend(): Promise<void> {\n const context = this.ensure();\n if (context.state === 'running') await context.suspend();\n },\n };\n}\n"],"mappings":"A,gCAIA,IAAMG,EAAgB,CAAC,YAAa,WAAY,UAAW,OAAO,EAElE,SAAS,SAAS,EAA0B,CAC1C,OAAQC,EAAR,CACE,IAAK,UACH,MAAO,UACT,IAAK,cACH,MAAO,cACT,IAAK,SACH,MAAO,SACT,QACE,MAAO,WACX,CACF,CAiBA,SAAgB,qBAAqB,EAKlB,CACjB,IAAMC,EAAQC,EAAQ,UAAY,IAAA,GAC9BC,EAA2B,KAC3BC,EAAW,GACXC,EAAwB,GACxBC,EAAiB,GAEfC,EAA0B,OAAO,OAAW,IAAc,IAAA,GAAY,OACtEC,EAA4B,OAAO,SAAa,IAAc,IAAA,GAAY,SAE1E,iBAA2B,CAC/B,GAAKF,GAAmBC,EACxB,GAAiB,GACjB,IAAK,IAAME,KAAQV,EACjBQ,EAAI,oBAAoBE,EAAM,SAAU,CAAE,QAAS,EAAK,CAAC,CAF1C,CAInB,EAEA,SAAS,UAAiB,CAIpBN,GAAOA,EAAI,QAAU,WAAaA,EAAI,QAAU,UAClDA,EAAS,OAAO,CAAC,CAAC,UAAY,CAAC,CAAC,CAEpC,CAEA,IAAM,iBAA2B,CAC1BA,GAAQK,GAAOL,EAAI,QAAU,WAC9BK,EAAI,QACN,EAAwB,GACxBL,EAAS,QAAQ,CAAC,CAAC,UAAY,CAAC,CAAC,GACxBE,IACT,EAAwB,GACxBF,EAAS,OAAO,CAAC,CAAC,UAAY,CAAC,CAAC,GAEpC,EAEM,kBAA4B,CAChC,GAAI,CAACA,EAAK,OACV,IAAMH,EAAQ,SAASG,EAAI,KAAK,EAChCD,EAAQ,QAAQF,CAAK,EACjBA,IAAU,WAAW,aAAa,CACxC,EAEA,MAAO,CACL,IAAI,SAAU,CACZ,OAAOG,CACT,EACA,SAAgB,CACd,EAAW,GACX,aAAa,EACTK,GAAKA,EAAI,oBAAoB,mBAAoB,YAAY,EAC7DL,IACFA,EAAI,oBAAoB,cAAe,aAAa,EAGhDF,GAASE,EAAI,QAAU,UAAUA,EAAS,MAAM,CAAC,CAAC,UAAY,CAAC,CAAC,EAExE,EACA,QAAuB,CACrB,GAAIC,EAAU,MAAM,IAAIR,EAAAA,kBAAkB,qCAAqC,EAC/E,GAAIO,EAAK,OAAOA,EAChB,GAAID,EAAQ,QACV,EAAMA,EAAQ,QAAQ,MACjB,CACL,GAAI,OAAO,aAAiB,IAC1B,MAAM,IAAIL,EAAAA,qBAAqB,gDAAgD,EAEjF,EAAM,IAAI,YACZ,CAEA,GADAM,EAAI,iBAAiB,cAAe,aAAa,EAC7CD,EAAQ,aAAe,IAASK,EAAK,CACvC,EAAiB,GACjB,IAAK,IAAME,KAAQV,EACjBQ,EAAI,iBAAiBE,EAAM,SAAU,CAAE,QAAS,GAAM,QAAS,EAAK,CAAC,CAEzE,CAKA,OAJIP,EAAQ,qBAAuBM,GACjCA,EAAI,iBAAiB,mBAAoB,YAAY,EAEvDN,EAAQ,QAAQ,SAASC,EAAI,KAAK,CAAC,EAC5BA,CACT,EACA,MAAM,QAAwB,CAC5B,IAAMO,EAAU,KAAK,OAAO,EACxBA,EAAQ,QAAU,WAAW,MAAMA,EAAQ,OAAO,CACxD,EACA,IAAI,OAAmB,CAErB,OADIN,EAAiB,SACdD,EAAM,SAASA,EAAI,KAAK,EAAI,MACrC,EACA,MAAM,SAAyB,CAC7B,IAAMO,EAAU,KAAK,OAAO,EACxBA,EAAQ,QAAU,WAAW,MAAMA,EAAQ,QAAQ,CACzD,CACF,CACF,C"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { BardState } from './types';
|
|
2
|
+
export interface ContextManager {
|
|
3
|
+
readonly context: AudioContext | null;
|
|
4
|
+
dispose(): void;
|
|
5
|
+
/** Lazily creates the context; throws `BardUnsupportedError` without Web Audio. */
|
|
6
|
+
ensure(): AudioContext;
|
|
7
|
+
resume(): Promise<void>;
|
|
8
|
+
readonly state: BardState;
|
|
9
|
+
suspend(): Promise<void>;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Owns the lazy `AudioContext`: creation, gesture unlock, visibility handling,
|
|
13
|
+
* state reporting, and teardown. Listeners attach only once a context exists,
|
|
14
|
+
* so importing and constructing on a server touches nothing global.
|
|
15
|
+
*/
|
|
16
|
+
export declare function createContextManager(options: {
|
|
17
|
+
readonly factory?: () => AudioContext;
|
|
18
|
+
readonly autoUnlock?: boolean;
|
|
19
|
+
readonly autoSuspendOnHidden?: boolean;
|
|
20
|
+
readonly onState: (state: BardState) => void;
|
|
21
|
+
}): ContextManager;
|
|
22
|
+
//# sourceMappingURL=_context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_context.d.ts","sourceRoot":"","sources":["../src/_context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAkBzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,OAAO,IAAI,IAAI,CAAC;IAChB,mFAAmF;IACnF,MAAM,IAAI,YAAY,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CAC9C,GAAG,cAAc,CAiGjB"}
|
package/dist/_context.js
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { BardDisposedError as e, BardUnsupportedError as t } from "./errors.js";
|
|
2
|
+
// src/_context.ts
|
|
3
|
+
var n = [
|
|
4
|
+
"pointerup",
|
|
5
|
+
"touchend",
|
|
6
|
+
"keydown",
|
|
7
|
+
"click"
|
|
8
|
+
];
|
|
9
|
+
function mapState(e) {
|
|
10
|
+
switch (e) {
|
|
11
|
+
case "running": return "running";
|
|
12
|
+
case "interrupted": return "interrupted";
|
|
13
|
+
case "closed": return "closed";
|
|
14
|
+
default: return "suspended";
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
function createContextManager(r) {
|
|
18
|
+
let i = r.factory === void 0, a = null, o = !1, s = !1, c = !1, l = typeof window > "u" ? void 0 : window, u = typeof document > "u" ? void 0 : document, detachUnlock = () => {
|
|
19
|
+
if (c && l) {
|
|
20
|
+
c = !1;
|
|
21
|
+
for (let e of n) l.removeEventListener(e, onUnlock, { capture: !0 });
|
|
22
|
+
}
|
|
23
|
+
};
|
|
24
|
+
function onUnlock() {
|
|
25
|
+
a && a.state !== "running" && a.state !== "closed" && a.resume().catch(() => {});
|
|
26
|
+
}
|
|
27
|
+
let onVisibility = () => {
|
|
28
|
+
a && u && a.state !== "closed" && (u.hidden ? (s = !0, a.suspend().catch(() => {})) : s && (s = !1, a.resume().catch(() => {})));
|
|
29
|
+
}, onStateChange = () => {
|
|
30
|
+
if (!a) return;
|
|
31
|
+
let e = mapState(a.state);
|
|
32
|
+
r.onState(e), e === "running" && detachUnlock();
|
|
33
|
+
};
|
|
34
|
+
return {
|
|
35
|
+
get context() {
|
|
36
|
+
return a;
|
|
37
|
+
},
|
|
38
|
+
dispose() {
|
|
39
|
+
o = !0, detachUnlock(), u && u.removeEventListener("visibilitychange", onVisibility), a && (a.removeEventListener("statechange", onStateChange), i && a.state !== "closed" && a.close().catch(() => {}));
|
|
40
|
+
},
|
|
41
|
+
ensure() {
|
|
42
|
+
if (o) throw new e("The audio engine has been disposed.");
|
|
43
|
+
if (a) return a;
|
|
44
|
+
if (r.factory) a = r.factory();
|
|
45
|
+
else {
|
|
46
|
+
if (typeof AudioContext > "u") throw new t("This runtime does not provide an AudioContext.");
|
|
47
|
+
a = new AudioContext();
|
|
48
|
+
}
|
|
49
|
+
if (a.addEventListener("statechange", onStateChange), r.autoUnlock !== !1 && l) {
|
|
50
|
+
c = !0;
|
|
51
|
+
for (let e of n) l.addEventListener(e, onUnlock, {
|
|
52
|
+
capture: !0,
|
|
53
|
+
passive: !0
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
return r.autoSuspendOnHidden && u && u.addEventListener("visibilitychange", onVisibility), r.onState(mapState(a.state)), a;
|
|
57
|
+
},
|
|
58
|
+
async resume() {
|
|
59
|
+
let e = this.ensure();
|
|
60
|
+
e.state !== "running" && await e.resume();
|
|
61
|
+
},
|
|
62
|
+
get state() {
|
|
63
|
+
return o ? "closed" : a ? mapState(a.state) : "idle";
|
|
64
|
+
},
|
|
65
|
+
async suspend() {
|
|
66
|
+
let e = this.ensure();
|
|
67
|
+
e.state === "running" && await e.suspend();
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
export { createContextManager };
|
|
72
|
+
|
|
73
|
+
//# sourceMappingURL=_context.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_context.js","names":["UNLOCK_EVENTS","state","owned","options","ctx","disposed","suspendedByVisibility","unlockAttached","win","doc","type","BardDisposedError","BardUnsupportedError","context"],"sources":["../src/_context.ts"],"sourcesContent":["import { BardDisposedError, BardUnsupportedError } from './errors';\nimport type { BardState } from './types';\n\n/** Gestures that count as user activation for audio unlock on every engine. */\nconst UNLOCK_EVENTS = ['pointerup', 'touchend', 'keydown', 'click'] as const;\n\nfunction mapState(state: string): BardState {\n switch (state) {\n case 'running':\n return 'running';\n case 'interrupted':\n return 'interrupted';\n case 'closed':\n return 'closed';\n default:\n return 'suspended';\n }\n}\n\nexport interface ContextManager {\n readonly context: AudioContext | null;\n dispose(): void;\n /** Lazily creates the context; throws `BardUnsupportedError` without Web Audio. */\n ensure(): AudioContext;\n resume(): Promise<void>;\n readonly state: BardState;\n suspend(): Promise<void>;\n}\n\n/**\n * Owns the lazy `AudioContext`: creation, gesture unlock, visibility handling,\n * state reporting, and teardown. Listeners attach only once a context exists,\n * so importing and constructing on a server touches nothing global.\n */\nexport function createContextManager(options: {\n readonly factory?: () => AudioContext;\n readonly autoUnlock?: boolean;\n readonly autoSuspendOnHidden?: boolean;\n readonly onState: (state: BardState) => void;\n}): ContextManager {\n const owned = options.factory === undefined;\n let ctx: AudioContext | null = null;\n let disposed = false;\n let suspendedByVisibility = false;\n let unlockAttached = false;\n\n const win: Window | undefined = typeof window === 'undefined' ? undefined : window;\n const doc: Document | undefined = typeof document === 'undefined' ? undefined : document;\n\n const detachUnlock = (): void => {\n if (!unlockAttached || !win) return;\n unlockAttached = false;\n for (const type of UNLOCK_EVENTS) {\n win.removeEventListener(type, onUnlock, { capture: true });\n }\n };\n\n function onUnlock(): void {\n // resume() must be called synchronously inside the gesture handler to\n // count as user activation; the rejection (autoplay still blocked) is\n // retried on the next gesture.\n if (ctx && ctx.state !== 'running' && ctx.state !== 'closed') {\n void ctx.resume().catch(() => {});\n }\n }\n\n const onVisibility = (): void => {\n if (!ctx || !doc || ctx.state === 'closed') return;\n if (doc.hidden) {\n suspendedByVisibility = true;\n void ctx.suspend().catch(() => {});\n } else if (suspendedByVisibility) {\n suspendedByVisibility = false;\n void ctx.resume().catch(() => {});\n }\n };\n\n const onStateChange = (): void => {\n if (!ctx) return;\n const state = mapState(ctx.state);\n options.onState(state);\n if (state === 'running') detachUnlock();\n };\n\n return {\n get context() {\n return ctx;\n },\n dispose(): void {\n disposed = true;\n detachUnlock();\n if (doc) doc.removeEventListener('visibilitychange', onVisibility);\n if (ctx) {\n ctx.removeEventListener('statechange', onStateChange);\n // Closing is fire-and-forget; a context that fails to close is\n // abandoned by the browser once the graph is disconnected.\n if (owned && ctx.state !== 'closed') void ctx.close().catch(() => {});\n }\n },\n ensure(): AudioContext {\n if (disposed) throw new BardDisposedError('The audio engine has been disposed.');\n if (ctx) return ctx;\n if (options.factory) {\n ctx = options.factory();\n } else {\n if (typeof AudioContext === 'undefined') {\n throw new BardUnsupportedError('This runtime does not provide an AudioContext.');\n }\n ctx = new AudioContext();\n }\n ctx.addEventListener('statechange', onStateChange);\n if (options.autoUnlock !== false && win) {\n unlockAttached = true;\n for (const type of UNLOCK_EVENTS) {\n win.addEventListener(type, onUnlock, { capture: true, passive: true });\n }\n }\n if (options.autoSuspendOnHidden && doc) {\n doc.addEventListener('visibilitychange', onVisibility);\n }\n options.onState(mapState(ctx.state));\n return ctx;\n },\n async resume(): Promise<void> {\n const context = this.ensure();\n if (context.state !== 'running') await context.resume();\n },\n get state(): BardState {\n if (disposed) return 'closed';\n return ctx ? mapState(ctx.state) : 'idle';\n },\n async suspend(): Promise<void> {\n const context = this.ensure();\n if (context.state === 'running') await context.suspend();\n },\n };\n}\n"],"mappings":";;AAIA,IAAMA,IAAgB;CAAC;CAAa;CAAY;CAAW;AAAO;AAElE,SAAS,SAAS,GAA0B;CAC1C,QAAQC,GAAR;EACE,KAAK,WACH,OAAO;EACT,KAAK,eACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,SACE,OAAO;CACX;AACF;AAiBA,SAAgB,qBAAqB,GAKlB;CACjB,IAAMC,IAAQC,EAAQ,YAAY,KAAA,GAC9BC,IAA2B,MAC3BC,IAAW,IACXC,IAAwB,IACxBC,IAAiB,IAEfC,IAA0B,OAAO,SAAW,MAAc,KAAA,IAAY,QACtEC,IAA4B,OAAO,WAAa,MAAc,KAAA,IAAY,UAE1E,qBAA2B;EAC/B,IAAKF,KAAmBC,GACxB;OAAiB;GACjB,KAAK,IAAME,KAAQV,GACjB,EAAI,oBAAoBU,GAAM,UAAU,EAAE,SAAS,GAAK,CAAC;EAF1C;CAInB;CAEA,SAAS,WAAiB;EAIxB,AAAIN,KAAOA,EAAI,UAAU,aAAaA,EAAI,UAAU,YAClDA,EAAS,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;CAEpC;CAEA,IAAM,qBAA2B;EAC/B,AAAKA,KAAQK,KAAOL,EAAI,UAAU,aAC9BK,EAAI,UACN,IAAwB,IACxBL,EAAS,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,KACxBE,MACT,IAAwB,IACxBF,EAAS,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;CAEpC,GAEM,sBAA4B;EAChC,IAAI,CAACA,GAAK;EACV,IAAMH,IAAQ,SAASG,EAAI,KAAK;EAEhC,AADAD,EAAQ,QAAQF,CAAK,GACjBA,MAAU,aAAW,aAAa;CACxC;CAEA,OAAO;EACL,IAAI,UAAU;GACZ,OAAOG;EACT;EACA,UAAgB;GAId,AAHA,IAAW,IACX,aAAa,GACTK,KAAKA,EAAI,oBAAoB,oBAAoB,YAAY,GAC7DL,MACFA,EAAI,oBAAoB,eAAe,aAAa,GAGhDF,KAASE,EAAI,UAAU,YAAUA,EAAS,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;EAExE;EACA,SAAuB;GACrB,IAAIC,GAAU,MAAM,IAAIM,EAAkB,qCAAqC;GAC/E,IAAIP,GAAK,OAAOA;GAChB,IAAID,EAAQ,SACV,IAAMA,EAAQ,QAAQ;QACjB;IACL,IAAI,OAAO,eAAiB,KAC1B,MAAM,IAAIS,EAAqB,gDAAgD;IAEjF,IAAM,IAAI,aAAa;GACzB;GAEA,IADAR,EAAI,iBAAiB,eAAe,aAAa,GAC7CD,EAAQ,eAAe,MAASK,GAAK;IACvC,IAAiB;IACjB,KAAK,IAAME,KAAQV,GACjB,EAAI,iBAAiBU,GAAM,UAAU;KAAE,SAAS;KAAM,SAAS;IAAK,CAAC;GAEzE;GAKA,OAJIP,EAAQ,uBAAuBM,KACjCA,EAAI,iBAAiB,oBAAoB,YAAY,GAEvDN,EAAQ,QAAQ,SAASC,EAAI,KAAK,CAAC,GAC5BA;EACT;EACA,MAAM,SAAwB;GAC5B,IAAMS,IAAU,KAAK,OAAO;GAC5B,AAAIA,EAAQ,UAAU,aAAW,MAAMA,EAAQ,OAAO;EACxD;EACA,IAAI,QAAmB;GAErB,OADIR,IAAiB,WACdD,IAAM,SAASA,EAAI,KAAK,IAAI;EACrC;EACA,MAAM,UAAyB;GAC7B,IAAMS,IAAU,KAAK,OAAO;GAC5B,AAAIA,EAAQ,UAAU,aAAW,MAAMA,EAAQ,QAAQ;EACzD;CACF;AACF"}
|
package/dist/_deck.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./_ramp.cjs"),t=require("./errors.cjs");function createDeck(n,r={}){let i=r.bus??`music`,a=r.fade??2,o=null,s=[],c=-1,l={},u=0,d=null,f=!1,p=!1,m=null,h=0;r.mediaSession&&(d=n.mediaSession.claim({onNextTrack:()=>g.next(),onPause:()=>g.pause(),onPlay:()=>g.play(),onPreviousTrack:()=>g.previous(),onStop:()=>g.stop()}));let setSessionState=e=>{d?.setPlaybackState(e)},setSessionMeta=e=>{d&&(e===null?d.setMetadata(void 0,``):d.setMetadata(n.loader.definitionOf(e)?.meta,e))},startSlot=(r,a,o)=>{let s=n.context(),c=n.buses().get(i),l=n.loader.definitionOf(r);if(l?.stream){if(a.loopStart!==void 0||a.loopEnd!==void 0)throw new t.BardError(`Streamed track "${r}" cannot use loopStart/loopEnd; streamed loops cover the whole file.`);let i=n.streams.ensure(r,l),u=s.createGain();i.source.connect(u),u.connect(c.input),o>0?(u.gain.setValueAtTime(0,s.currentTime),u.gain.linearRampToValueAtTime(1,s.currentTime+o)):u.gain.value=1;let d=i.element;d.loop=a.loop??!1,a.offset!==void 0&&(d.currentTime=a.offset),d.play().catch(()=>{});let f=!1;return{key:r,async nearlyOver(e){if(d.loop)return new Promise(()=>{});let t=d.duration;if(Number.isFinite(t)){let n=Math.max(t-d.currentTime-e,0)*1e3;await new Promise(e=>setTimeout(e,n))}else await new Promise(t=>{let onTime=()=>{let n=d.duration;Number.isFinite(n)&&n-d.currentTime<=e&&(d.removeEventListener(`timeupdate`,onTime),t())};d.addEventListener(`timeupdate`,onTime),d.addEventListener(`ended`,()=>{d.removeEventListener(`timeupdate`,onTime),t()},{once:!0})})},pause(){return d.pause(),d.currentTime},stop(t,n){if(f)return;f=!0;let teardown=()=>{n||d.pause();try{u.disconnect()}catch{}};t<=0?(n||d.pause(),u.gain.value=0,teardown()):(e.rampParam(u.gain,0,t,s.currentTime),setTimeout(teardown,t*1e3))}}}if(!n.loader.has(r))throw new t.BardError(`Track "${r}" is not loaded.`);let u=s.currentTime,d=n.pool.play(r,{bus:i,fadeIn:o>0?o:void 0,loop:a.loop,loopEnd:a.loopEnd,loopStart:a.loopStart,offset:a.offset}),f=!1;return{key:r,async nearlyOver(e){if(a.loop)return new Promise(()=>{});let t=n.loader.get(r),i=t?t.buffer.duration:1/0,o=Math.max(i-(a.offset??0)-e,0)*1e3;await new Promise(e=>setTimeout(e,o))},pause(){return f?h:(f=!0,d.stop({fade:e.MICRO_FADE}),(a.offset??0)+(s.currentTime-u))},stop(e){f||(f=!0,d.stop({fade:e}))}}},beginTrack=(e,t)=>{let r=t.fade??a,i=o;o=startSlot(e,t,r),p=!1,i&&i.stop(r,i.key===e),n.onTrack(e),setSessionMeta(e),setSessionState(`playing`)},scheduleAdvance=e=>{let t=u,n=l.crossfade??a;e.nearlyOver(n).then(()=>{f||t!==u||o!==e||advance(1)})},advance=e=>{if(s.length===0)return;let t=c+e;if(t>=s.length){if(!l.repeat){s=[];return}t=0}else t<0&&(t=l.repeat?s.length-1:0);c=t;let n=s[t];n!==void 0&&(beginTrack(n,{fade:l.crossfade??a,loop:!1}),o&&scheduleAdvance(o))},g={get current(){return o?.key??null},dispose(){f||(f=!0,u+=1,o&&o.stop(0),o=null,d?.release(),d=null)},get disposed(){return f},next(){if(f)throw new t.BardError(`The deck is disposed.`);s.length!==0&&(u+=1,advance(1))},pause(){f||!o||p||(u+=1,m=o.key,h=o.pause(),p=!0,setSessionState(`paused`))},play(){if(f||!p||m===null)return;let t=m,n=h;m=null,beginTrack(t,{fade:e.MICRO_FADE,offset:n}),s.length>0&&o&&scheduleAdvance(o)},get playing(){return o!==null&&!p},previous(){if(f)throw new t.BardError(`The deck is disposed.`);s.length!==0&&(u+=1,advance(-1))},queue(e,n={}){if(f)throw new t.BardError(`The deck is disposed.`);if(s=[...e],l=n,u+=1,n.shuffle){let e=n.random??Math.random,t=[...s];for(let n=t.length-1;n>0;--n){let r=Math.min(Math.floor(e()*(n+1)),n),i=t[n],a=t[r];i!==void 0&&a!==void 0&&(t[n]=a,t[r]=i)}s=t}c=-1,s.length>0&&advance(1)},stop(e={}){f||(s=[],c=-1,u+=1,o&&o.stop(e.fade??a),o=null,p=!1,m=null,n.onTrack(null),setSessionMeta(null),setSessionState(`none`))},transition(e,n={}){if(f)throw new t.BardError(`The deck is disposed.`);(e!==o?.key||p)&&(s=[],c=-1,u+=1,beginTrack(e,n))},[Symbol.dispose](){g.dispose()}};return g}exports.createDeck=createDeck;
|
|
2
|
+
//# sourceMappingURL=_deck.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_deck.cjs","names":["BardError","MICRO_FADE","require__ramp","require_errors","busName","options","defaultFade","slot","queue","queueIndex","queueOptions","queueToken","session","disposed","paused","pausedKey","pausedOffset","deps","deck","state","key","ctx","bus","definition","transition","stream","gain","fadeIn","element","stopped","total","wait","crossfade","resolve","dur","keepElement","fade","startedAt","handle","asset","previous","token","active","index","delta","offset","keys","queueOpts","random","shuffled","i","j","a","b"],"sources":["../src/_deck.ts"],"sourcesContent":["import type { BusManager } from './_bus';\nimport type { Loader } from './_loader';\nimport type { MediaSessionManager, MediaSessionOwner } from './_media-session';\nimport { MICRO_FADE, rampParam } from './_ramp';\nimport type { StreamManager } from './_stream';\nimport type { VoicePool } from './_voices';\nimport { BardError } from './errors';\nimport type { DeckOptions, MusicDeck, QueueOptions, TransitionOptions } from './types';\n\ninterface Slot {\n readonly key: string;\n /** Resolves `crossfade` seconds before the track ends; never resolves for loops. */\n nearlyOver(crossfade: number): Promise<void>;\n /** Pauses playback and returns the current offset in seconds. */\n pause(): number;\n /**\n * Fades out and releases the slot's audible output. `keepElement` tells a\n * streamed slot its element was handed to a replacement slot for the same\n * track (pause -> play reuses the cached `<audio>` element), so teardown must\n * disconnect the old gain stage without pausing the shared element.\n */\n stop(fade: number, keepElement?: boolean): void;\n}\n\ninterface DeckDeps {\n readonly buses: () => BusManager;\n readonly context: () => AudioContext;\n readonly loader: Loader;\n readonly mediaSession: MediaSessionManager;\n readonly onTrack: (key: string | null) => void;\n readonly pool: VoicePool;\n readonly streams: StreamManager;\n}\n\n/**\n * Two-slot crossfading music deck: game-state transitions (`transition`),\n * continuous ambient playback (`queue`), and optional Media Session ownership.\n * Buffered assets play through the voice pool; streamed assets through their\n * owned `<audio>` element with a per-slot gain stage.\n */\nexport function createDeck(deps: DeckDeps, options: DeckOptions = {}): MusicDeck {\n const busName = options.bus ?? 'music';\n const defaultFade = options.fade ?? 2;\n let slot: Slot | null = null;\n let queue: readonly string[] = [];\n let queueIndex = -1;\n let queueOptions: QueueOptions = {};\n let queueToken = 0;\n let session: MediaSessionOwner | null = null;\n let disposed = false;\n let paused = false;\n let pausedKey: string | null = null;\n let pausedOffset = 0;\n\n if (options.mediaSession) {\n session = deps.mediaSession.claim({\n onNextTrack: () => deck.next(),\n onPause: () => deck.pause(),\n onPlay: () => deck.play(),\n onPreviousTrack: () => deck.previous(),\n onStop: () => deck.stop(),\n });\n }\n\n const setSessionState = (state: MediaSessionPlaybackState): void => {\n session?.setPlaybackState(state);\n };\n\n const setSessionMeta = (key: string | null): void => {\n if (!session) return;\n if (key === null) {\n session.setMetadata(undefined, '');\n return;\n }\n session.setMetadata(deps.loader.definitionOf(key)?.meta, key);\n };\n\n /** Starts one asset into a new slot; throws for unknown keys. */\n const startSlot = (key: string, transition: TransitionOptions, fadeIn: number): Slot => {\n const ctx = deps.context();\n const bus = deps.buses().get(busName);\n const definition = deps.loader.definitionOf(key);\n if (definition?.stream) {\n if (transition.loopStart !== undefined || transition.loopEnd !== undefined) {\n throw new BardError(\n `Streamed track \"${key}\" cannot use loopStart/loopEnd; streamed loops cover the whole file.`,\n );\n }\n const stream = deps.streams.ensure(key, definition);\n const gain = ctx.createGain();\n stream.source.connect(gain);\n gain.connect(bus.input);\n if (fadeIn > 0) {\n gain.gain.setValueAtTime(0, ctx.currentTime);\n gain.gain.linearRampToValueAtTime(1, ctx.currentTime + fadeIn);\n } else {\n gain.gain.value = 1;\n }\n const element = stream.element;\n element.loop = transition.loop ?? false;\n if (transition.offset !== undefined) element.currentTime = transition.offset;\n void element.play().catch(() => {\n // Autoplay rejection; the unlock gesture path retries playback.\n });\n let stopped = false;\n return {\n key,\n async nearlyOver(crossfade): Promise<void> {\n if (element.loop) return new Promise<void>(() => {});\n const total = element.duration;\n if (Number.isFinite(total)) {\n const wait = Math.max(total - element.currentTime - crossfade, 0) * 1000;\n await new Promise<void>((resolve) => setTimeout(resolve, wait));\n return;\n }\n // Metadata not ready yet: fall back to timeupdate polling.\n await new Promise<void>((resolve) => {\n const onTime = (): void => {\n const dur = element.duration;\n if (Number.isFinite(dur) && dur - element.currentTime <= crossfade) {\n element.removeEventListener('timeupdate', onTime);\n resolve();\n }\n };\n element.addEventListener('timeupdate', onTime);\n element.addEventListener(\n 'ended',\n () => {\n element.removeEventListener('timeupdate', onTime);\n resolve();\n },\n { once: true },\n );\n });\n },\n pause(): number {\n element.pause();\n return element.currentTime;\n },\n stop(fade, keepElement): void {\n if (stopped) return;\n stopped = true;\n const teardown = (): void => {\n if (!keepElement) element.pause();\n try {\n gain.disconnect();\n } catch {\n // Already disconnected.\n }\n };\n if (fade <= 0) {\n if (!keepElement) element.pause();\n gain.gain.value = 0;\n teardown();\n return;\n }\n rampParam(gain.gain, 0, fade, ctx.currentTime);\n setTimeout(teardown, fade * 1000);\n },\n };\n }\n\n // Buffered path through the voice pool.\n if (!deps.loader.has(key)) throw new BardError(`Track \"${key}\" is not loaded.`);\n const startedAt = ctx.currentTime;\n const handle = deps.pool.play(key, {\n bus: busName,\n fadeIn: fadeIn > 0 ? fadeIn : undefined,\n loop: transition.loop,\n loopEnd: transition.loopEnd,\n loopStart: transition.loopStart,\n offset: transition.offset,\n });\n let stopped = false;\n return {\n key,\n async nearlyOver(crossfade): Promise<void> {\n if (transition.loop) return new Promise<void>(() => {});\n const asset = deps.loader.get(key);\n const total = asset ? asset.buffer.duration : Infinity;\n const wait = Math.max(total - (transition.offset ?? 0) - crossfade, 0) * 1000;\n await new Promise<void>((resolve) => setTimeout(resolve, wait));\n },\n pause(): number {\n if (stopped) return pausedOffset;\n stopped = true;\n handle.stop({ fade: MICRO_FADE });\n return (transition.offset ?? 0) + (ctx.currentTime - startedAt);\n },\n stop(fade): void {\n if (stopped) return;\n stopped = true;\n handle.stop({ fade });\n },\n };\n };\n\n const beginTrack = (key: string, transition: TransitionOptions): void => {\n const fade = transition.fade ?? defaultFade;\n const previous = slot;\n slot = startSlot(key, transition, fade);\n paused = false;\n // Restarting the same key (pause -> play, or transition while paused) reuses the\n // cached stream element: the outgoing slot must not pause what the new slot just resumed.\n if (previous) previous.stop(fade, previous.key === key);\n deps.onTrack(key);\n setSessionMeta(key);\n setSessionState('playing');\n };\n\n /** Schedules the automatic crossfade to the next queued track. */\n const scheduleAdvance = (active: Slot): void => {\n const token = queueToken;\n const crossfade = queueOptions.crossfade ?? defaultFade;\n void active.nearlyOver(crossfade).then(() => {\n if (disposed || token !== queueToken || slot !== active) return;\n advance(1);\n });\n };\n\n const advance = (delta: number): void => {\n if (queue.length === 0) return;\n let index = queueIndex + delta;\n if (index >= queue.length) {\n if (!queueOptions.repeat) {\n queue = [];\n return;\n }\n index = 0;\n } else if (index < 0) {\n index = queueOptions.repeat ? queue.length - 1 : 0;\n }\n queueIndex = index;\n const key = queue[index];\n if (key === undefined) return;\n beginTrack(key, { fade: queueOptions.crossfade ?? defaultFade, loop: false });\n if (slot) scheduleAdvance(slot);\n };\n\n const deck: MusicDeck = {\n get current() {\n return slot?.key ?? null;\n },\n dispose(): void {\n if (disposed) return;\n disposed = true;\n queueToken += 1;\n if (slot) slot.stop(0);\n slot = null;\n session?.release();\n session = null;\n },\n get disposed() {\n return disposed;\n },\n next(): void {\n if (disposed) throw new BardError('The deck is disposed.');\n if (queue.length === 0) return;\n queueToken += 1;\n advance(1);\n },\n pause(): void {\n if (disposed || !slot || paused) return;\n // Invalidate any pending queue auto-advance: a track \"ending\" while paused\n // must not silently resume playback with the next queued track.\n queueToken += 1;\n pausedKey = slot.key;\n pausedOffset = slot.pause();\n paused = true;\n setSessionState('paused');\n },\n play(): void {\n if (disposed || !paused || pausedKey === null) return;\n const key = pausedKey;\n const offset = pausedOffset;\n pausedKey = null;\n beginTrack(key, { fade: MICRO_FADE, offset });\n // Reschedule the queue auto-advance that pause() cancelled, for the fresh slot.\n if (queue.length > 0 && slot) scheduleAdvance(slot);\n },\n get playing() {\n return slot !== null && !paused;\n },\n previous(): void {\n if (disposed) throw new BardError('The deck is disposed.');\n if (queue.length === 0) return;\n queueToken += 1;\n advance(-1);\n },\n queue(keys, queueOpts = {}): void {\n if (disposed) throw new BardError('The deck is disposed.');\n queue = [...keys];\n queueOptions = queueOpts;\n queueToken += 1;\n if (queueOpts.shuffle) {\n const random = queueOpts.random ?? Math.random;\n const shuffled = [...queue];\n for (let i = shuffled.length - 1; i > 0; i -= 1) {\n const j = Math.min(Math.floor(random() * (i + 1)), i);\n const a = shuffled[i];\n const b = shuffled[j];\n if (a !== undefined && b !== undefined) {\n shuffled[i] = b;\n shuffled[j] = a;\n }\n }\n queue = shuffled;\n }\n queueIndex = -1;\n if (queue.length > 0) advance(1);\n },\n stop(options = {}): void {\n if (disposed) return;\n queue = [];\n queueIndex = -1;\n queueToken += 1;\n if (slot) slot.stop(options.fade ?? defaultFade);\n slot = null;\n paused = false;\n pausedKey = null;\n deps.onTrack(null);\n setSessionMeta(null);\n setSessionState('none');\n },\n transition(key, transition = {}): void {\n if (disposed) throw new BardError('The deck is disposed.');\n if (key === slot?.key && !paused) return;\n // A manual transition takes over from the queue.\n queue = [];\n queueIndex = -1;\n queueToken += 1;\n beginTrack(key, transition);\n },\n [Symbol.dispose](): void {\n deck.dispose();\n },\n };\n return deck;\n}\n"],"mappings":"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"}
|
package/dist/_deck.d.ts
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { BusManager } from './_bus';
|
|
2
|
+
import type { Loader } from './_loader';
|
|
3
|
+
import type { MediaSessionManager } from './_media-session';
|
|
4
|
+
import type { StreamManager } from './_stream';
|
|
5
|
+
import type { VoicePool } from './_voices';
|
|
6
|
+
import type { DeckOptions, MusicDeck } from './types';
|
|
7
|
+
interface DeckDeps {
|
|
8
|
+
readonly buses: () => BusManager;
|
|
9
|
+
readonly context: () => AudioContext;
|
|
10
|
+
readonly loader: Loader;
|
|
11
|
+
readonly mediaSession: MediaSessionManager;
|
|
12
|
+
readonly onTrack: (key: string | null) => void;
|
|
13
|
+
readonly pool: VoicePool;
|
|
14
|
+
readonly streams: StreamManager;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Two-slot crossfading music deck: game-state transitions (`transition`),
|
|
18
|
+
* continuous ambient playback (`queue`), and optional Media Session ownership.
|
|
19
|
+
* Buffered assets play through the voice pool; streamed assets through their
|
|
20
|
+
* owned `<audio>` element with a per-slot gain stage.
|
|
21
|
+
*/
|
|
22
|
+
export declare function createDeck(deps: DeckDeps, options?: DeckOptions): MusicDeck;
|
|
23
|
+
export {};
|
|
24
|
+
//# sourceMappingURL=_deck.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_deck.d.ts","sourceRoot":"","sources":["../src/_deck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAqB,MAAM,kBAAkB,CAAC;AAE/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAmC,MAAM,SAAS,CAAC;AAiBvF,UAAU,QAAQ;IAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,CA0S/E"}
|