@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/dist/_stream.js
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { BardLoadError as e } from "./errors.js";
|
|
2
|
+
// src/_stream.ts
|
|
3
|
+
function createStreams(t) {
|
|
4
|
+
let n = /* @__PURE__ */ new Map();
|
|
5
|
+
return {
|
|
6
|
+
dispose() {
|
|
7
|
+
for (let e of n.values()) e.disconnect();
|
|
8
|
+
n.clear();
|
|
9
|
+
},
|
|
10
|
+
ensure(r, i) {
|
|
11
|
+
let a = n.get(r);
|
|
12
|
+
if (a) return a;
|
|
13
|
+
let o = document.createElement("audio");
|
|
14
|
+
o.crossOrigin = "anonymous", o.preload = "auto", o.src = i.src;
|
|
15
|
+
let s = t.createMediaElementSource(o), c, l, u = new Promise((e, t) => {
|
|
16
|
+
c = e, l = t;
|
|
17
|
+
});
|
|
18
|
+
u.catch(() => {});
|
|
19
|
+
let onReady = () => {
|
|
20
|
+
c();
|
|
21
|
+
}, onError = () => {
|
|
22
|
+
l(new e(`Streaming "${r}" failed to load "${i.src}".`));
|
|
23
|
+
};
|
|
24
|
+
o.addEventListener("canplay", onReady, { once: !0 }), o.addEventListener("error", onError, { once: !0 });
|
|
25
|
+
let d = {
|
|
26
|
+
definition: i,
|
|
27
|
+
disconnect() {
|
|
28
|
+
o.removeEventListener("canplay", onReady), o.removeEventListener("error", onError), o.pause(), o.removeAttribute("src"), s.disconnect();
|
|
29
|
+
},
|
|
30
|
+
get duration() {
|
|
31
|
+
return o.duration;
|
|
32
|
+
},
|
|
33
|
+
element: o,
|
|
34
|
+
ready: u,
|
|
35
|
+
source: s
|
|
36
|
+
};
|
|
37
|
+
return n.set(r, d), d;
|
|
38
|
+
},
|
|
39
|
+
get(e) {
|
|
40
|
+
return n.get(e);
|
|
41
|
+
}
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
export { createStreams };
|
|
45
|
+
|
|
46
|
+
//# sourceMappingURL=_stream.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_stream.js","names":["streams","stream","existing","key","element","definition","source","context","settle","reject","outcome","resolve","rejectFn","BardLoadError","asset"],"sources":["../src/_stream.ts"],"sourcesContent":["import { BardLoadError } from './errors';\nimport type { AssetDefinition } from './types';\n\n/** A streamed asset: an owned `<audio>` element wrapped once in a MediaElementSource. */\nexport interface StreamedAsset {\n readonly definition: AssetDefinition;\n disconnect(): void;\n readonly duration: number;\n readonly element: HTMLAudioElement;\n /** Resolves once the element reports playable metadata. */\n readonly ready: Promise<void>;\n readonly source: MediaElementAudioSourceNode;\n}\n\nexport interface StreamManager {\n dispose(): void;\n /** Creates (once) and returns the stream for a key. */\n ensure(key: string, definition: AssetDefinition): StreamedAsset;\n get(key: string): StreamedAsset | undefined;\n}\n\n/**\n * Long-form tracks play through an owned `HTMLAudioElement` so mobile devices\n * never spike RAM decoding a ten-minute ambient file. Bard creates the\n * element, requests CORS, and wraps it exactly once: an element can only ever\n * be routed through `createMediaElementSource` a single time.\n */\nexport function createStreams(context: AudioContext): StreamManager {\n const streams = new Map<string, StreamedAsset>();\n\n return {\n dispose(): void {\n for (const stream of streams.values()) stream.disconnect();\n streams.clear();\n },\n ensure(key, definition): StreamedAsset {\n const existing = streams.get(key);\n if (existing) return existing;\n const element = document.createElement('audio');\n element.crossOrigin = 'anonymous';\n element.preload = 'auto';\n element.src = definition.src;\n // The node must exist before playback or the sound bypasses the graph.\n const source = context.createMediaElementSource(element);\n let settle!: () => void;\n let reject!: (reason: unknown) => void;\n const outcome = new Promise<void>((resolve, rejectFn) => {\n settle = resolve;\n reject = rejectFn;\n });\n // A rejection with no immediate await would surface as an unhandled\n // rejection; the deck awaits it, and the catch here keeps it quiet.\n outcome.catch(() => {});\n const onReady = (): void => {\n settle();\n };\n const onError = (): void => {\n reject(new BardLoadError(`Streaming \"${key}\" failed to load \"${definition.src}\".`));\n };\n element.addEventListener('canplay', onReady, { once: true });\n element.addEventListener('error', onError, { once: true });\n const asset: StreamedAsset = {\n definition,\n disconnect(): void {\n element.removeEventListener('canplay', onReady);\n element.removeEventListener('error', onError);\n element.pause();\n element.removeAttribute('src');\n source.disconnect();\n },\n get duration(): number {\n return element.duration;\n },\n element,\n ready: outcome,\n source,\n };\n streams.set(key, asset);\n return asset;\n },\n get(key): StreamedAsset | undefined {\n return streams.get(key);\n },\n };\n}\n"],"mappings":";;AA2BA,SAAgB,cAAc,GAAsC;CAClE,IAAMA,oBAAU,IAAI,IAA2B;CAE/C,OAAO;EACL,UAAgB;GACd,KAAK,IAAMC,KAAUD,EAAQ,OAAO,GAAG,EAAO,WAAW;GACzD,EAAQ,MAAM;EAChB;EACA,OAAO,GAAK,GAA2B;GACrC,IAAME,IAAWF,EAAQ,IAAIG,CAAG;GAChC,IAAID,GAAU,OAAOA;GACrB,IAAME,IAAU,SAAS,cAAc,OAAO;GAG9C,AAFA,EAAQ,cAAc,aACtB,EAAQ,UAAU,QAClB,EAAQ,MAAMC,EAAW;GAEzB,IAAMC,IAASC,EAAQ,yBAAyBH,CAAO,GACnDI,GACAC,GACEC,IAAU,IAAI,SAAe,GAAS,MAAa;IAEvD,AADA,IAASC,GACT,IAASC;GACX,CAAC;GAGD,EAAQ,YAAY,CAAC,CAAC;GACtB,IAAM,gBAAsB;IAC1B,EAAO;GACT,GACM,gBAAsB;IAC1B,EAAO,IAAIC,EAAc,cAAcV,EAAI,oBAAoBE,EAAW,IAAI,GAAG,CAAC;GACpF;GAEA,AADAD,EAAQ,iBAAiB,WAAW,SAAS,EAAE,MAAM,GAAK,CAAC,GAC3DA,EAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,GAAK,CAAC;GACzD,IAAMU,IAAuB;IAC3B;IACA,aAAmB;KAKjB,AAJAV,EAAQ,oBAAoB,WAAW,OAAO,GAC9CA,EAAQ,oBAAoB,SAAS,OAAO,GAC5CA,EAAQ,MAAM,GACdA,EAAQ,gBAAgB,KAAK,GAC7BE,EAAO,WAAW;IACpB;IACA,IAAI,WAAmB;KACrB,OAAOF,EAAQ;IACjB;IACA;IACA,OAAOM;IACP;GACF;GAEA,OADAV,EAAQ,IAAIG,GAAKW,CAAK,GACfA;EACT;EACA,IAAI,GAAgC;GAClC,OAAOd,EAAQ,IAAIG,CAAG;EACxB;CACF;AACF"}
|
package/dist/_synth.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./_ramp.cjs"),t=require("./errors.cjs");var n=new WeakMap;function noiseBuffer(e){let t=n.get(e);if(t)return t;let r=e.createBuffer(1,e.sampleRate,e.sampleRate),i=r.getChannelData(0);for(let e=0;e<i.length;e+=1)i[e]=Math.random()*2-1;return n.set(e,r),r}function envelopeTimings(n){let r=n.duration??.3;if(r<=0)throw new t.BardError(`Synth duration must be positive, got ${r}.`);let i=n.envelope??{},a=Math.max(i.attack??.005,0),o=Math.max(i.decay??.05,0),s=Math.min(Math.max(i.sustain??.6,0),1),c=Math.max(i.release??.1,e.MICRO_FADE);return{attack:a,decay:o,hold:Math.max(r-a-o-c,0),release:c,sustain:s}}function playSynth(t){return n=>{let r=t.context(),i=n.bus??`sfx`,a=t.buses().get(i),o=envelopeTimings(n),s=Math.min(Math.max(n.volume??1,0),1),c=r.currentTime,l=r.createGain();l.gain.setValueAtTime(0,c),l.gain.linearRampToValueAtTime(Math.max(s,e.MIN_GAIN),c+o.attack),l.gain.linearRampToValueAtTime(Math.max(s*o.sustain,e.MIN_GAIN),c+o.attack+o.decay);let u=c+o.attack+o.decay+o.hold;l.gain.setValueAtTime(Math.max(s*o.sustain,e.MIN_GAIN),u),l.gain.linearRampToValueAtTime(0,u+o.release);let d=null;if(n.filter){d=r.createBiquadFilter(),d.type=n.filter.type,n.filter.q!==void 0&&(d.Q.value=n.filter.q);let[t,i]=typeof n.filter.frequency==`number`?[n.filter.frequency,n.filter.frequency]:n.filter.frequency;d.frequency.setValueAtTime(t,c),i!==t&&e.expRampTo(d.frequency,i,o.attack+o.decay+o.hold,c),d.connect(l)}let f=null;n.pan===void 0?l.connect(a.input):(f=r.createStereoPanner(),f.pan.value=n.pan,l.connect(f),f.connect(a.input));let p=n.type===`noise`,m=p?r.createBufferSource():r.createOscillator();if(p){if(m.buffer=noiseBuffer(r),m.loop=!0,n.freq!==void 0&&!d){d=r.createBiquadFilter(),d.type=`bandpass`;let[t,i]=typeof n.freq==`number`?[n.freq,n.freq]:n.freq;d.frequency.setValueAtTime(t,c),i!==t&&e.expRampTo(d.frequency,i,o.attack+o.decay+o.hold,c),d.connect(l)}}else{let t=m;t.type=n.type??`sine`;let[r,i]=typeof n.freq==`number`||n.freq===void 0?[n.freq??440,n.freq??440]:n.freq;t.frequency.setValueAtTime(Math.max(r,e.MIN_GAIN),c),i!==r&&e.expRampTo(t.frequency,i,o.attack+o.decay+o.hold,c),n.detune!==void 0&&(t.detune.value=n.detune)}d?m.connect(d):m.connect(l);let h=o.attack+o.decay+o.hold+o.release,g,_=new Promise(e=>{g=e}),v=!1,y=!1,teardown=()=>{try{m.disconnect()}catch{}d?.disconnect(),l.disconnect(),f?.disconnect()};t.onStarted(i),m.addEventListener(`ended`,()=>{teardown(),v||(v=!0,t.onEnded(i),g())},{once:!0});let b={dispose(){if(!y){y=!0;try{m.stop()}catch{}teardown(),v||(v=!0,t.onEnded(i),g())}},get disposed(){return y},finished:_,setPan(e){f&&(f.pan.value=Math.min(Math.max(e,-1),1))},setVolume(t,n){e.rampParam(l.gain,Math.min(Math.max(t,0),1),n?.fade??.015,r.currentTime)},stop(t){if(y)return;y=!0;let n=t?.fade??.015;e.rampParam(l.gain,0,n,r.currentTime);try{m.stop(r.currentTime+n)}catch{}},[Symbol.dispose](){b.dispose()}};return m.start(c),m.stop(c+h),b}}exports.playSynth=playSynth;
|
|
2
|
+
//# sourceMappingURL=_synth.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_synth.cjs","names":["BardError","MICRO_FADE","MIN_GAIN","require__ramp","require_errors","noiseCache","cached","ctx","buffer","data","i","duration","options","env","attack","decay","sustain","release","deps","busName","bus","timings","volume","now","gain","releaseAt","filter","from","to","panner","isNoise","source","osc","total","resolveFinished","finished","resolve","settled","stopped","handle","value","fadeOptions","fade"],"sources":["../src/_synth.ts"],"sourcesContent":["import type { BusManager } from './_bus';\nimport { expRampTo, MICRO_FADE, MIN_GAIN, rampParam } from './_ramp';\nimport { BardError } from './errors';\nimport type { SoundHandle, SynthOptions } from './types';\n\n/** Cached white-noise buffer per context, reused by every noise voice. */\nconst noiseCache = new WeakMap<BaseAudioContext, AudioBuffer>();\n\nfunction noiseBuffer(ctx: AudioContext): AudioBuffer {\n const cached = noiseCache.get(ctx);\n if (cached) return cached;\n const buffer = ctx.createBuffer(1, ctx.sampleRate, ctx.sampleRate);\n const data = buffer.getChannelData(0);\n for (let i = 0; i < data.length; i += 1) data[i] = Math.random() * 2 - 1;\n noiseCache.set(ctx, buffer);\n return buffer;\n}\n\ninterface EnvelopeTimings {\n readonly attack: number;\n readonly decay: number;\n readonly hold: number;\n readonly release: number;\n readonly sustain: number;\n}\n\nfunction envelopeTimings(options: SynthOptions): EnvelopeTimings {\n const duration = options.duration ?? 0.3;\n if (duration <= 0) throw new BardError(`Synth duration must be positive, got ${duration}.`);\n const env = options.envelope ?? {};\n const attack = Math.max(env.attack ?? 0.005, 0);\n const decay = Math.max(env.decay ?? 0.05, 0);\n const sustain = Math.min(Math.max(env.sustain ?? 0.6, 0), 1);\n const release = Math.max(env.release ?? 0.1, MICRO_FADE);\n const hold = Math.max(duration - attack - decay - release, 0);\n return { attack, decay, hold, release, sustain };\n}\n\n/**\n * Zero-asset sound generator: oscillator (or cached noise buffer) through an\n * optional biquad into an ADSR gain, straight onto a bus. Nodes disconnect in\n * `onended`, so a fire-and-forget beep leaves nothing behind.\n */\nexport function playSynth(deps: {\n readonly context: () => AudioContext;\n readonly buses: () => BusManager;\n readonly onEnded: (bus: string) => void;\n readonly onStarted: (bus: string) => void;\n}): (options: SynthOptions) => SoundHandle {\n return (options) => {\n const ctx = deps.context();\n const busName = options.bus ?? 'sfx';\n const bus = deps.buses().get(busName);\n const timings = envelopeTimings(options);\n const volume = Math.min(Math.max(options.volume ?? 1, 0), 1);\n const now = ctx.currentTime;\n\n const gain = ctx.createGain();\n gain.gain.setValueAtTime(0, now);\n gain.gain.linearRampToValueAtTime(Math.max(volume, MIN_GAIN), now + timings.attack);\n gain.gain.linearRampToValueAtTime(\n Math.max(volume * timings.sustain, MIN_GAIN),\n now + timings.attack + timings.decay,\n );\n const releaseAt = now + timings.attack + timings.decay + timings.hold;\n gain.gain.setValueAtTime(Math.max(volume * timings.sustain, MIN_GAIN), releaseAt);\n gain.gain.linearRampToValueAtTime(0, releaseAt + timings.release);\n\n let filter: BiquadFilterNode | null = null;\n if (options.filter) {\n filter = ctx.createBiquadFilter();\n filter.type = options.filter.type;\n if (options.filter.q !== undefined) filter.Q.value = options.filter.q;\n const [from, to] =\n typeof options.filter.frequency === 'number'\n ? [options.filter.frequency, options.filter.frequency]\n : options.filter.frequency;\n filter.frequency.setValueAtTime(from, now);\n if (to !== from) expRampTo(filter.frequency, to, timings.attack + timings.decay + timings.hold, now);\n filter.connect(gain);\n }\n\n let panner: StereoPannerNode | null = null;\n if (options.pan !== undefined) {\n panner = ctx.createStereoPanner();\n panner.pan.value = options.pan;\n gain.connect(panner);\n panner.connect(bus.input);\n } else {\n gain.connect(bus.input);\n }\n\n const isNoise = options.type === 'noise';\n const source: AudioBufferSourceNode | OscillatorNode = isNoise ? ctx.createBufferSource() : ctx.createOscillator();\n if (isNoise) {\n (source as AudioBufferSourceNode).buffer = noiseBuffer(ctx);\n (source as AudioBufferSourceNode).loop = true;\n if (options.freq !== undefined && !filter) {\n // Without an explicit filter, noise sweeps through a bandpass.\n filter = ctx.createBiquadFilter();\n filter.type = 'bandpass';\n const [from, to] = typeof options.freq === 'number' ? [options.freq, options.freq] : options.freq;\n filter.frequency.setValueAtTime(from, now);\n if (to !== from) expRampTo(filter.frequency, to, timings.attack + timings.decay + timings.hold, now);\n filter.connect(gain);\n }\n } else {\n const osc = source as OscillatorNode;\n osc.type = (options.type ?? 'sine') as OscillatorType;\n const [from, to] =\n typeof options.freq === 'number' || options.freq === undefined\n ? [options.freq ?? 440, options.freq ?? 440]\n : options.freq;\n osc.frequency.setValueAtTime(Math.max(from, MIN_GAIN), now);\n if (to !== from) expRampTo(osc.frequency, to, timings.attack + timings.decay + timings.hold, now);\n if (options.detune !== undefined) osc.detune.value = options.detune;\n }\n if (filter) {\n source.connect(filter);\n } else {\n source.connect(gain);\n }\n\n const total = timings.attack + timings.decay + timings.hold + timings.release;\n let resolveFinished!: () => void;\n const finished = new Promise<void>((resolve) => {\n resolveFinished = resolve;\n });\n let settled = false;\n let stopped = false;\n\n const teardown = (): void => {\n try {\n source.disconnect();\n } catch {\n // Already disconnected.\n }\n filter?.disconnect();\n gain.disconnect();\n panner?.disconnect();\n };\n\n deps.onStarted(busName);\n source.addEventListener(\n 'ended',\n () => {\n teardown();\n if (!settled) {\n settled = true;\n deps.onEnded(busName);\n resolveFinished();\n }\n },\n { once: true },\n );\n\n const handle: SoundHandle = {\n dispose(): void {\n if (stopped) return;\n stopped = true;\n try {\n source.stop();\n } catch {\n // Already stopped.\n }\n teardown();\n if (!settled) {\n settled = true;\n deps.onEnded(busName);\n resolveFinished();\n }\n },\n get disposed() {\n return stopped;\n },\n finished,\n setPan(value): void {\n if (panner) panner.pan.value = Math.min(Math.max(value, -1), 1);\n },\n setVolume(value, fadeOptions): void {\n rampParam(gain.gain, Math.min(Math.max(value, 0), 1), fadeOptions?.fade ?? MICRO_FADE, ctx.currentTime);\n },\n stop(fadeOptions): void {\n if (stopped) return;\n stopped = true;\n const fade = fadeOptions?.fade ?? MICRO_FADE;\n rampParam(gain.gain, 0, fade, ctx.currentTime);\n try {\n source.stop(ctx.currentTime + fade);\n } catch {\n // Already stopped.\n }\n },\n [Symbol.dispose](): void {\n handle.dispose();\n },\n };\n\n source.start(now);\n // Schedule the natural end so 'ended' fires even for looping noise.\n source.stop(now + total);\n return handle;\n };\n}\n"],"mappings":"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"}
|
package/dist/_synth.d.ts
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { BusManager } from './_bus';
|
|
2
|
+
import type { SoundHandle, SynthOptions } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Zero-asset sound generator: oscillator (or cached noise buffer) through an
|
|
5
|
+
* optional biquad into an ADSR gain, straight onto a bus. Nodes disconnect in
|
|
6
|
+
* `onended`, so a fire-and-forget beep leaves nothing behind.
|
|
7
|
+
*/
|
|
8
|
+
export declare function playSynth(deps: {
|
|
9
|
+
readonly context: () => AudioContext;
|
|
10
|
+
readonly buses: () => BusManager;
|
|
11
|
+
readonly onEnded: (bus: string) => void;
|
|
12
|
+
readonly onStarted: (bus: string) => void;
|
|
13
|
+
}): (options: SynthOptions) => SoundHandle;
|
|
14
|
+
//# sourceMappingURL=_synth.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_synth.d.ts","sourceRoot":"","sources":["../src/_synth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAmCzD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,WAAW,CA2JzC"}
|
package/dist/_synth.js
ADDED
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
import { MICRO_FADE as e, MIN_GAIN as t, expRampTo as n, rampParam as r } from "./_ramp.js";
|
|
2
|
+
import { BardError as i } from "./errors.js";
|
|
3
|
+
// src/_synth.ts
|
|
4
|
+
var a = /* @__PURE__ */ new WeakMap();
|
|
5
|
+
function noiseBuffer(e) {
|
|
6
|
+
let t = a.get(e);
|
|
7
|
+
if (t) return t;
|
|
8
|
+
let n = e.createBuffer(1, e.sampleRate, e.sampleRate), r = n.getChannelData(0);
|
|
9
|
+
for (let e = 0; e < r.length; e += 1) r[e] = Math.random() * 2 - 1;
|
|
10
|
+
return a.set(e, n), n;
|
|
11
|
+
}
|
|
12
|
+
function envelopeTimings(t) {
|
|
13
|
+
let n = t.duration ?? .3;
|
|
14
|
+
if (n <= 0) throw new i(`Synth duration must be positive, got ${n}.`);
|
|
15
|
+
let r = t.envelope ?? {}, a = Math.max(r.attack ?? .005, 0), o = Math.max(r.decay ?? .05, 0), s = Math.min(Math.max(r.sustain ?? .6, 0), 1), c = Math.max(r.release ?? .1, e);
|
|
16
|
+
return {
|
|
17
|
+
attack: a,
|
|
18
|
+
decay: o,
|
|
19
|
+
hold: Math.max(n - a - o - c, 0),
|
|
20
|
+
release: c,
|
|
21
|
+
sustain: s
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
function playSynth(e) {
|
|
25
|
+
return (i) => {
|
|
26
|
+
let a = e.context(), o = i.bus ?? "sfx", s = e.buses().get(o), c = envelopeTimings(i), l = Math.min(Math.max(i.volume ?? 1, 0), 1), u = a.currentTime, d = a.createGain();
|
|
27
|
+
d.gain.setValueAtTime(0, u), d.gain.linearRampToValueAtTime(Math.max(l, t), u + c.attack), d.gain.linearRampToValueAtTime(Math.max(l * c.sustain, t), u + c.attack + c.decay);
|
|
28
|
+
let f = u + c.attack + c.decay + c.hold;
|
|
29
|
+
d.gain.setValueAtTime(Math.max(l * c.sustain, t), f), d.gain.linearRampToValueAtTime(0, f + c.release);
|
|
30
|
+
let p = null;
|
|
31
|
+
if (i.filter) {
|
|
32
|
+
p = a.createBiquadFilter(), p.type = i.filter.type, i.filter.q !== void 0 && (p.Q.value = i.filter.q);
|
|
33
|
+
let [e, t] = typeof i.filter.frequency == "number" ? [i.filter.frequency, i.filter.frequency] : i.filter.frequency;
|
|
34
|
+
p.frequency.setValueAtTime(e, u), t !== e && n(p.frequency, t, c.attack + c.decay + c.hold, u), p.connect(d);
|
|
35
|
+
}
|
|
36
|
+
let m = null;
|
|
37
|
+
i.pan === void 0 ? d.connect(s.input) : (m = a.createStereoPanner(), m.pan.value = i.pan, d.connect(m), m.connect(s.input));
|
|
38
|
+
let h = i.type === "noise", g = h ? a.createBufferSource() : a.createOscillator();
|
|
39
|
+
if (h) {
|
|
40
|
+
if (g.buffer = noiseBuffer(a), g.loop = !0, i.freq !== void 0 && !p) {
|
|
41
|
+
p = a.createBiquadFilter(), p.type = "bandpass";
|
|
42
|
+
let [e, t] = typeof i.freq == "number" ? [i.freq, i.freq] : i.freq;
|
|
43
|
+
p.frequency.setValueAtTime(e, u), t !== e && n(p.frequency, t, c.attack + c.decay + c.hold, u), p.connect(d);
|
|
44
|
+
}
|
|
45
|
+
} else {
|
|
46
|
+
let e = g;
|
|
47
|
+
e.type = i.type ?? "sine";
|
|
48
|
+
let [r, a] = typeof i.freq == "number" || i.freq === void 0 ? [i.freq ?? 440, i.freq ?? 440] : i.freq;
|
|
49
|
+
e.frequency.setValueAtTime(Math.max(r, t), u), a !== r && n(e.frequency, a, c.attack + c.decay + c.hold, u), i.detune !== void 0 && (e.detune.value = i.detune);
|
|
50
|
+
}
|
|
51
|
+
p ? g.connect(p) : g.connect(d);
|
|
52
|
+
let _ = c.attack + c.decay + c.hold + c.release, v, y = new Promise((e) => {
|
|
53
|
+
v = e;
|
|
54
|
+
}), b = !1, x = !1, teardown = () => {
|
|
55
|
+
try {
|
|
56
|
+
g.disconnect();
|
|
57
|
+
} catch {}
|
|
58
|
+
p?.disconnect(), d.disconnect(), m?.disconnect();
|
|
59
|
+
};
|
|
60
|
+
e.onStarted(o), g.addEventListener("ended", () => {
|
|
61
|
+
teardown(), b || (b = !0, e.onEnded(o), v());
|
|
62
|
+
}, { once: !0 });
|
|
63
|
+
let S = {
|
|
64
|
+
dispose() {
|
|
65
|
+
if (!x) {
|
|
66
|
+
x = !0;
|
|
67
|
+
try {
|
|
68
|
+
g.stop();
|
|
69
|
+
} catch {}
|
|
70
|
+
teardown(), b || (b = !0, e.onEnded(o), v());
|
|
71
|
+
}
|
|
72
|
+
},
|
|
73
|
+
get disposed() {
|
|
74
|
+
return x;
|
|
75
|
+
},
|
|
76
|
+
finished: y,
|
|
77
|
+
setPan(e) {
|
|
78
|
+
m && (m.pan.value = Math.min(Math.max(e, -1), 1));
|
|
79
|
+
},
|
|
80
|
+
setVolume(e, t) {
|
|
81
|
+
r(d.gain, Math.min(Math.max(e, 0), 1), t?.fade ?? .015, a.currentTime);
|
|
82
|
+
},
|
|
83
|
+
stop(e) {
|
|
84
|
+
if (x) return;
|
|
85
|
+
x = !0;
|
|
86
|
+
let t = e?.fade ?? .015;
|
|
87
|
+
r(d.gain, 0, t, a.currentTime);
|
|
88
|
+
try {
|
|
89
|
+
g.stop(a.currentTime + t);
|
|
90
|
+
} catch {}
|
|
91
|
+
},
|
|
92
|
+
[Symbol.dispose]() {
|
|
93
|
+
S.dispose();
|
|
94
|
+
}
|
|
95
|
+
};
|
|
96
|
+
return g.start(u), g.stop(u + _), S;
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
export { playSynth };
|
|
100
|
+
|
|
101
|
+
//# sourceMappingURL=_synth.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_synth.js","names":["noiseCache","cached","ctx","buffer","data","i","duration","options","BardError","env","attack","decay","sustain","release","MICRO_FADE","deps","busName","bus","timings","volume","now","gain","MIN_GAIN","releaseAt","filter","from","to","expRampTo","panner","isNoise","source","osc","total","resolveFinished","finished","resolve","settled","stopped","handle","value","fadeOptions","fade"],"sources":["../src/_synth.ts"],"sourcesContent":["import type { BusManager } from './_bus';\nimport { expRampTo, MICRO_FADE, MIN_GAIN, rampParam } from './_ramp';\nimport { BardError } from './errors';\nimport type { SoundHandle, SynthOptions } from './types';\n\n/** Cached white-noise buffer per context, reused by every noise voice. */\nconst noiseCache = new WeakMap<BaseAudioContext, AudioBuffer>();\n\nfunction noiseBuffer(ctx: AudioContext): AudioBuffer {\n const cached = noiseCache.get(ctx);\n if (cached) return cached;\n const buffer = ctx.createBuffer(1, ctx.sampleRate, ctx.sampleRate);\n const data = buffer.getChannelData(0);\n for (let i = 0; i < data.length; i += 1) data[i] = Math.random() * 2 - 1;\n noiseCache.set(ctx, buffer);\n return buffer;\n}\n\ninterface EnvelopeTimings {\n readonly attack: number;\n readonly decay: number;\n readonly hold: number;\n readonly release: number;\n readonly sustain: number;\n}\n\nfunction envelopeTimings(options: SynthOptions): EnvelopeTimings {\n const duration = options.duration ?? 0.3;\n if (duration <= 0) throw new BardError(`Synth duration must be positive, got ${duration}.`);\n const env = options.envelope ?? {};\n const attack = Math.max(env.attack ?? 0.005, 0);\n const decay = Math.max(env.decay ?? 0.05, 0);\n const sustain = Math.min(Math.max(env.sustain ?? 0.6, 0), 1);\n const release = Math.max(env.release ?? 0.1, MICRO_FADE);\n const hold = Math.max(duration - attack - decay - release, 0);\n return { attack, decay, hold, release, sustain };\n}\n\n/**\n * Zero-asset sound generator: oscillator (or cached noise buffer) through an\n * optional biquad into an ADSR gain, straight onto a bus. Nodes disconnect in\n * `onended`, so a fire-and-forget beep leaves nothing behind.\n */\nexport function playSynth(deps: {\n readonly context: () => AudioContext;\n readonly buses: () => BusManager;\n readonly onEnded: (bus: string) => void;\n readonly onStarted: (bus: string) => void;\n}): (options: SynthOptions) => SoundHandle {\n return (options) => {\n const ctx = deps.context();\n const busName = options.bus ?? 'sfx';\n const bus = deps.buses().get(busName);\n const timings = envelopeTimings(options);\n const volume = Math.min(Math.max(options.volume ?? 1, 0), 1);\n const now = ctx.currentTime;\n\n const gain = ctx.createGain();\n gain.gain.setValueAtTime(0, now);\n gain.gain.linearRampToValueAtTime(Math.max(volume, MIN_GAIN), now + timings.attack);\n gain.gain.linearRampToValueAtTime(\n Math.max(volume * timings.sustain, MIN_GAIN),\n now + timings.attack + timings.decay,\n );\n const releaseAt = now + timings.attack + timings.decay + timings.hold;\n gain.gain.setValueAtTime(Math.max(volume * timings.sustain, MIN_GAIN), releaseAt);\n gain.gain.linearRampToValueAtTime(0, releaseAt + timings.release);\n\n let filter: BiquadFilterNode | null = null;\n if (options.filter) {\n filter = ctx.createBiquadFilter();\n filter.type = options.filter.type;\n if (options.filter.q !== undefined) filter.Q.value = options.filter.q;\n const [from, to] =\n typeof options.filter.frequency === 'number'\n ? [options.filter.frequency, options.filter.frequency]\n : options.filter.frequency;\n filter.frequency.setValueAtTime(from, now);\n if (to !== from) expRampTo(filter.frequency, to, timings.attack + timings.decay + timings.hold, now);\n filter.connect(gain);\n }\n\n let panner: StereoPannerNode | null = null;\n if (options.pan !== undefined) {\n panner = ctx.createStereoPanner();\n panner.pan.value = options.pan;\n gain.connect(panner);\n panner.connect(bus.input);\n } else {\n gain.connect(bus.input);\n }\n\n const isNoise = options.type === 'noise';\n const source: AudioBufferSourceNode | OscillatorNode = isNoise ? ctx.createBufferSource() : ctx.createOscillator();\n if (isNoise) {\n (source as AudioBufferSourceNode).buffer = noiseBuffer(ctx);\n (source as AudioBufferSourceNode).loop = true;\n if (options.freq !== undefined && !filter) {\n // Without an explicit filter, noise sweeps through a bandpass.\n filter = ctx.createBiquadFilter();\n filter.type = 'bandpass';\n const [from, to] = typeof options.freq === 'number' ? [options.freq, options.freq] : options.freq;\n filter.frequency.setValueAtTime(from, now);\n if (to !== from) expRampTo(filter.frequency, to, timings.attack + timings.decay + timings.hold, now);\n filter.connect(gain);\n }\n } else {\n const osc = source as OscillatorNode;\n osc.type = (options.type ?? 'sine') as OscillatorType;\n const [from, to] =\n typeof options.freq === 'number' || options.freq === undefined\n ? [options.freq ?? 440, options.freq ?? 440]\n : options.freq;\n osc.frequency.setValueAtTime(Math.max(from, MIN_GAIN), now);\n if (to !== from) expRampTo(osc.frequency, to, timings.attack + timings.decay + timings.hold, now);\n if (options.detune !== undefined) osc.detune.value = options.detune;\n }\n if (filter) {\n source.connect(filter);\n } else {\n source.connect(gain);\n }\n\n const total = timings.attack + timings.decay + timings.hold + timings.release;\n let resolveFinished!: () => void;\n const finished = new Promise<void>((resolve) => {\n resolveFinished = resolve;\n });\n let settled = false;\n let stopped = false;\n\n const teardown = (): void => {\n try {\n source.disconnect();\n } catch {\n // Already disconnected.\n }\n filter?.disconnect();\n gain.disconnect();\n panner?.disconnect();\n };\n\n deps.onStarted(busName);\n source.addEventListener(\n 'ended',\n () => {\n teardown();\n if (!settled) {\n settled = true;\n deps.onEnded(busName);\n resolveFinished();\n }\n },\n { once: true },\n );\n\n const handle: SoundHandle = {\n dispose(): void {\n if (stopped) return;\n stopped = true;\n try {\n source.stop();\n } catch {\n // Already stopped.\n }\n teardown();\n if (!settled) {\n settled = true;\n deps.onEnded(busName);\n resolveFinished();\n }\n },\n get disposed() {\n return stopped;\n },\n finished,\n setPan(value): void {\n if (panner) panner.pan.value = Math.min(Math.max(value, -1), 1);\n },\n setVolume(value, fadeOptions): void {\n rampParam(gain.gain, Math.min(Math.max(value, 0), 1), fadeOptions?.fade ?? MICRO_FADE, ctx.currentTime);\n },\n stop(fadeOptions): void {\n if (stopped) return;\n stopped = true;\n const fade = fadeOptions?.fade ?? MICRO_FADE;\n rampParam(gain.gain, 0, fade, ctx.currentTime);\n try {\n source.stop(ctx.currentTime + fade);\n } catch {\n // Already stopped.\n }\n },\n [Symbol.dispose](): void {\n handle.dispose();\n },\n };\n\n source.start(now);\n // Schedule the natural end so 'ended' fires even for looping noise.\n source.stop(now + total);\n return handle;\n };\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
function createTappers(){let e=new Set,t=!1;return{emit(t){if(e.size!==0)for(let n of e)try{n(t)}catch{}},stop(){t=!0,e.clear()},tap(n,r){if(t||r?.signal?.aborted)return()=>{};let detach=()=>{e.delete(n)};return e.add(n),r?.signal?.addEventListener(`abort`,detach,{once:!0}),detach}}}exports.createTappers=createTappers;
|
|
2
|
+
//# sourceMappingURL=_tappers.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_tappers.cjs","names":["tappers","stopped","tapper","event","options","handler"],"sources":["../src/_tappers.ts"],"sourcesContent":["/**\n * The `tap()` machinery for the engine. Kept private: the public contract is\n * `Bard.tap` and the `BardEvent` union, not this.\n *\n * Follows the repo observability rules: zero overhead with no tappers, handler\n * errors swallowed, auto-detach on an abort signal, and a no-op unsubscribe\n * once stopped.\n */\nexport interface Tappers<E extends { readonly type: string }> {\n /** Emits to every tapper; a no-op when none are registered. */\n emit(event: E): void;\n /** Drops every tapper and makes later `tap` calls no-ops. Idempotent. */\n stop(): void;\n tap(handler: (event: E) => void, options?: { readonly signal?: AbortSignal }): () => void;\n}\n\nexport function createTappers<E extends { readonly type: string }>(): Tappers<E> {\n const tappers = new Set<(event: E) => void>();\n let stopped = false;\n\n return {\n emit(event): void {\n if (tappers.size === 0) return;\n for (const tapper of tappers) {\n try {\n tapper(event);\n } catch {\n // Observability must not affect audio behavior.\n }\n }\n },\n stop(): void {\n stopped = true;\n tappers.clear();\n },\n tap(handler, options): () => void {\n if (stopped || options?.signal?.aborted) return () => {};\n const detach = (): void => {\n tappers.delete(handler);\n };\n tappers.add(handler);\n options?.signal?.addEventListener('abort', detach, { once: true });\n return detach;\n },\n };\n}\n"],"mappings":"AAgBA,SAAgB,eAAiE,CAC/E,IAAMA,EAAU,IAAI,IAChBC,EAAU,GAEd,MAAO,CACL,KAAK,EAAa,CAChB,GAAID,EAAQ,OAAS,EACrB,IAAK,IAAME,KAAUF,EACnB,GAAI,CACFE,EAAOC,CAAK,CACd,MAAQ,CAER,CAEJ,EACA,MAAa,CACX,EAAU,GACVH,EAAQ,MAAM,CAChB,EACA,IAAI,EAAS,EAAqB,CAChC,GAAIC,GAAWG,GAAS,QAAQ,QAAS,UAAa,CAAC,EACvD,IAAM,WAAqB,CACzBJ,EAAQ,OAAOK,CAAO,CACxB,EAGA,OAFAL,EAAQ,IAAIK,CAAO,EACnBD,GAAS,QAAQ,iBAAiB,QAAS,OAAQ,CAAE,KAAM,EAAK,CAAC,EAC1D,MACT,CACF,CACF,C"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `tap()` machinery for the engine. Kept private: the public contract is
|
|
3
|
+
* `Bard.tap` and the `BardEvent` union, not this.
|
|
4
|
+
*
|
|
5
|
+
* Follows the repo observability rules: zero overhead with no tappers, handler
|
|
6
|
+
* errors swallowed, auto-detach on an abort signal, and a no-op unsubscribe
|
|
7
|
+
* once stopped.
|
|
8
|
+
*/
|
|
9
|
+
export interface Tappers<E extends {
|
|
10
|
+
readonly type: string;
|
|
11
|
+
}> {
|
|
12
|
+
/** Emits to every tapper; a no-op when none are registered. */
|
|
13
|
+
emit(event: E): void;
|
|
14
|
+
/** Drops every tapper and makes later `tap` calls no-ops. Idempotent. */
|
|
15
|
+
stop(): void;
|
|
16
|
+
tap(handler: (event: E) => void, options?: {
|
|
17
|
+
readonly signal?: AbortSignal;
|
|
18
|
+
}): () => void;
|
|
19
|
+
}
|
|
20
|
+
export declare function createTappers<E extends {
|
|
21
|
+
readonly type: string;
|
|
22
|
+
}>(): Tappers<E>;
|
|
23
|
+
//# sourceMappingURL=_tappers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_tappers.d.ts","sourceRoot":"","sources":["../src/_tappers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;IAC1D,+DAA+D;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,yEAAyE;IACzE,IAAI,IAAI,IAAI,CAAC;IACb,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,MAAM,IAAI,CAAC;CAC3F;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CA6B/E"}
|
package/dist/_tappers.js
ADDED
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
// src/_tappers.ts
|
|
2
|
+
function createTappers() {
|
|
3
|
+
let e = /* @__PURE__ */ new Set(), t = !1;
|
|
4
|
+
return {
|
|
5
|
+
emit(t) {
|
|
6
|
+
if (e.size !== 0) for (let n of e) try {
|
|
7
|
+
n(t);
|
|
8
|
+
} catch {}
|
|
9
|
+
},
|
|
10
|
+
stop() {
|
|
11
|
+
t = !0, e.clear();
|
|
12
|
+
},
|
|
13
|
+
tap(n, r) {
|
|
14
|
+
if (t || r?.signal?.aborted) return () => {};
|
|
15
|
+
let detach = () => {
|
|
16
|
+
e.delete(n);
|
|
17
|
+
};
|
|
18
|
+
return e.add(n), r?.signal?.addEventListener("abort", detach, { once: !0 }), detach;
|
|
19
|
+
}
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
export { createTappers };
|
|
23
|
+
|
|
24
|
+
//# sourceMappingURL=_tappers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_tappers.js","names":["tappers","stopped","tapper","event","options","handler"],"sources":["../src/_tappers.ts"],"sourcesContent":["/**\n * The `tap()` machinery for the engine. Kept private: the public contract is\n * `Bard.tap` and the `BardEvent` union, not this.\n *\n * Follows the repo observability rules: zero overhead with no tappers, handler\n * errors swallowed, auto-detach on an abort signal, and a no-op unsubscribe\n * once stopped.\n */\nexport interface Tappers<E extends { readonly type: string }> {\n /** Emits to every tapper; a no-op when none are registered. */\n emit(event: E): void;\n /** Drops every tapper and makes later `tap` calls no-ops. Idempotent. */\n stop(): void;\n tap(handler: (event: E) => void, options?: { readonly signal?: AbortSignal }): () => void;\n}\n\nexport function createTappers<E extends { readonly type: string }>(): Tappers<E> {\n const tappers = new Set<(event: E) => void>();\n let stopped = false;\n\n return {\n emit(event): void {\n if (tappers.size === 0) return;\n for (const tapper of tappers) {\n try {\n tapper(event);\n } catch {\n // Observability must not affect audio behavior.\n }\n }\n },\n stop(): void {\n stopped = true;\n tappers.clear();\n },\n tap(handler, options): () => void {\n if (stopped || options?.signal?.aborted) return () => {};\n const detach = (): void => {\n tappers.delete(handler);\n };\n tappers.add(handler);\n options?.signal?.addEventListener('abort', detach, { once: true });\n return detach;\n },\n };\n}\n"],"mappings":";AAgBA,SAAgB,gBAAiE;CAC/E,IAAMA,oBAAU,IAAI,IAAwB,GACxCC,IAAU;CAEd,OAAO;EACL,KAAK,GAAa;GAChB,IAAID,EAAQ,SAAS,GACrB,KAAK,IAAME,KAAUF,GACnB,IAAI;IACF,EAAOG,CAAK;GACd,QAAQ,CAER;EAEJ;EACA,OAAa;GAEX,AADA,IAAU,IACVH,EAAQ,MAAM;EAChB;EACA,IAAI,GAAS,GAAqB;GAChC,IAAIC,KAAWG,GAAS,QAAQ,SAAS,aAAa,CAAC;GACvD,IAAM,eAAqB;IACzB,EAAQ,OAAOC,CAAO;GACxB;GAGA,OAFAL,EAAQ,IAAIK,CAAO,GACnBD,GAAS,QAAQ,iBAAiB,SAAS,QAAQ,EAAE,MAAM,GAAK,CAAC,GAC1D;EACT;CACF;AACF"}
|
package/dist/_voices.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
const e=require("./_loader.cjs"),t=require("./_ramp.cjs"),n=require("./errors.cjs");function createVoicePool(r){let i=new Set,a=!1,release=e=>{i.delete(e)&&(r.buses().voiceCount(e.bus,-1),e.finish())},teardown=e=>{try{e.source.disconnect()}catch{}e.gain.disconnect(),e.panner.disconnect()},fadeOut=(e,n)=>{if(e.stopped)return;e.stopped=!0;let i=r.context();t.rampParam(e.gain.gain,0,n,i.currentTime);let a=i.currentTime+n;try{e.source.stop(a)}catch{}e.source.addEventListener(`ended`,()=>{teardown(e),release(e)},{once:!0})},stealOldest=e=>{for(let n of i)if(e(n)&&!n.stopped)return r.onSteal(n.key),fadeOut(n,t.MICRO_FADE),!0;return!1};return{dispose(){a=!0;for(let e of[...i]){try{e.source.stop()}catch{}teardown(e),release(e)}i.clear()},play(o,s={}){if(a)throw new n.BardError(`The voice pool is disposed.`);let c=r.context(),l=e.parseSpriteKey(o),u=l?.asset??o,d=r.loader.get(u);if(!d)throw new n.BardError(`Sound "${o}" is not loaded.`);let f=s.bus??`sfx`,p=r.buses().get(f),m=l?e.resolveSprite(d,l.sprite,o):void 0,h=s.loop??!1,g=s.offset??m?.offset??0,_=c.createBufferSource();_.buffer=d.buffer,h&&(_.loop=!0,s.loopStart===void 0?m&&(_.loopStart=m.offset):_.loopStart=s.loopStart,s.loopEnd===void 0?m&&(_.loopEnd=m.offset+m.duration):_.loopEnd=s.loopEnd);let v=t.sampleRange(s.rate,s.random??Math.random);v!==void 0&&(_.playbackRate.value=v);let y=t.sampleRange(s.detune,s.random??Math.random);y!==void 0&&(_.detune.value=y);let b=c.createGain(),x=s.volume??1;s.fadeIn&&s.fadeIn>0?(b.gain.setValueAtTime(0,c.currentTime),b.gain.linearRampToValueAtTime(Math.max(x,t.MIN_GAIN),c.currentTime+s.fadeIn)):b.gain.value=x;let S=c.createStereoPanner();S.pan.value=s.pan??0,b.connect(S),S.connect(p.input),_.connect(b);let C,w=new Promise(e=>{C=e}),T=!1,finish=()=>{T||(T=!0,C())},E={bus:f,finish,gain:b,key:o,panner:S,source:_,stopped:!1},D={dispose(){if(E.stopped)finish();else{E.stopped=!0;try{E.source.stop()}catch{}teardown(E),release(E)}},get disposed(){return E.stopped},finished:w,setPan(e){S.pan.value=Math.min(Math.max(e,-1),1)},setVolume(e,n){t.rampParam(b.gain,Math.min(Math.max(e,0),1),n?.fade??.015,c.currentTime)},stop(e){fadeOut(E,e?.fade??.015)},[Symbol.dispose](){D.dispose()}};if(s.maxVoices!==void 0)for(;[...i].filter(e=>e.key===o&&!e.stopped).length>=s.maxVoices&&stealOldest(e=>e.key===o););for(;!([...i].filter(e=>!e.stopped).length<r.maxVoices||!stealOldest(e=>!e.stopped)););return i.add(E),r.buses().voiceCount(f,1),_.addEventListener(`ended`,()=>{teardown(E),release(E)},{once:!0}),_.start(c.currentTime,g,h?void 0:m?.duration),D},stopKeys(n){for(let r of[...i]){let i=e.parseSpriteKey(r.key)?.asset??r.key;n.includes(i)&&fadeOut(r,t.MICRO_FADE)}}}}exports.createVoicePool=createVoicePool;
|
|
2
|
+
//# sourceMappingURL=_voices.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_voices.cjs","names":["MICRO_FADE","BardError","parseSpriteKey","resolveSprite","sampleRange","MIN_GAIN","require__loader","require__ramp","require_errors","voices","disposed","record","deps","ctx","fade","stopAt","predicate","sprite","key","assetKey","asset","busName","options","bus","region","loop","offset","source","rate","detune","gain","volume","panner","resolveFinished","finished","resolve","settled","handle","panValue","volumeValue","fadeOptions","v","keys"],"sources":["../src/_voices.ts"],"sourcesContent":["import type { BusManager } from './_bus';\nimport type { Loader } from './_loader';\nimport { parseSpriteKey, resolveSprite } from './_loader';\nimport { MICRO_FADE, MIN_GAIN, rampParam, sampleRange } from './_ramp';\nimport { BardError } from './errors';\nimport type { PlayOptions, SoundHandle } from './types';\n\ninterface VoiceRecord {\n readonly bus: string;\n readonly finish: () => void;\n readonly gain: GainNode;\n readonly key: string;\n readonly panner: StereoPannerNode;\n readonly source: AudioBufferSourceNode;\n stopped: boolean;\n}\n\nexport interface VoicePool {\n dispose(): void;\n /** Starts a buffered sound; throws `BardError` for unknown keys. */\n play(key: string, options?: PlayOptions): SoundHandle;\n /** Stops every voice for the given asset keys (used by `unload`). */\n stopKeys(keys: readonly string[]): void;\n}\n\n/**\n * Voice registry: per-key and global caps with oldest-first stealing (a 10 ms\n * fade before the hard stop, so stealing does not click), organic detune/rate\n * variance, and the `SoundHandle` contract.\n */\nexport function createVoicePool(deps: {\n readonly context: () => AudioContext;\n readonly loader: Loader;\n readonly buses: () => BusManager;\n readonly maxVoices: number;\n readonly onSteal: (key: string | null) => void;\n}): VoicePool {\n const voices = new Set<VoiceRecord>();\n let disposed = false;\n\n const release = (record: VoiceRecord): void => {\n if (!voices.delete(record)) return;\n deps.buses().voiceCount(record.bus, -1);\n record.finish();\n };\n\n const teardown = (record: VoiceRecord): void => {\n try {\n record.source.disconnect();\n } catch {\n // Already disconnected.\n }\n record.gain.disconnect();\n record.panner.disconnect();\n };\n\n const fadeOut = (record: VoiceRecord, fade: number): void => {\n if (record.stopped) return;\n record.stopped = true;\n const ctx = deps.context();\n rampParam(record.gain.gain, 0, fade, ctx.currentTime);\n const stopAt = ctx.currentTime + fade;\n try {\n record.source.stop(stopAt);\n } catch {\n // Already stopped.\n }\n // Teardown happens on 'ended'; a source that never started ends on its own.\n record.source.addEventListener(\n 'ended',\n () => {\n teardown(record);\n release(record);\n },\n { once: true },\n );\n };\n\n /** Steals the oldest voice matching `predicate`, if any. */\n const stealOldest = (predicate: (v: VoiceRecord) => boolean): boolean => {\n for (const record of voices) {\n if (predicate(record) && !record.stopped) {\n deps.onSteal(record.key);\n fadeOut(record, MICRO_FADE);\n return true;\n }\n }\n return false;\n };\n\n return {\n dispose(): void {\n disposed = true;\n for (const record of [...voices]) {\n try {\n record.source.stop();\n } catch {\n // Already stopped.\n }\n teardown(record);\n release(record);\n }\n voices.clear();\n },\n play(key, options = {}): SoundHandle {\n if (disposed) throw new BardError('The voice pool is disposed.');\n const ctx = deps.context();\n const sprite = parseSpriteKey(key);\n const assetKey = sprite?.asset ?? key;\n const asset = deps.loader.get(assetKey);\n if (!asset) throw new BardError(`Sound \"${key}\" is not loaded.`);\n const busName = options.bus ?? 'sfx';\n const bus = deps.buses().get(busName);\n\n const region = sprite ? resolveSprite(asset, sprite.sprite, key) : undefined;\n const loop = options.loop ?? false;\n const offset = options.offset ?? region?.offset ?? 0;\n\n const source = ctx.createBufferSource();\n source.buffer = asset.buffer;\n if (loop) {\n source.loop = true;\n if (options.loopStart !== undefined) source.loopStart = options.loopStart;\n else if (region) source.loopStart = region.offset;\n if (options.loopEnd !== undefined) source.loopEnd = options.loopEnd;\n else if (region) source.loopEnd = region.offset + region.duration;\n }\n const rate = sampleRange(options.rate, options.random ?? Math.random);\n if (rate !== undefined) source.playbackRate.value = rate;\n const detune = sampleRange(options.detune, options.random ?? Math.random);\n if (detune !== undefined) source.detune.value = detune;\n\n const gain = ctx.createGain();\n const volume = options.volume ?? 1;\n if (options.fadeIn && options.fadeIn > 0) {\n gain.gain.setValueAtTime(0, ctx.currentTime);\n gain.gain.linearRampToValueAtTime(Math.max(volume, MIN_GAIN), ctx.currentTime + options.fadeIn);\n } else {\n gain.gain.value = volume;\n }\n // Every voice gets a panner so `handle.setPan()` always works; the node\n // is cheap and the uniform `gain -> panner -> bus` shape is simpler\n // than a conditional graph.\n const panner = ctx.createStereoPanner();\n panner.pan.value = options.pan ?? 0;\n gain.connect(panner);\n panner.connect(bus.input);\n source.connect(gain);\n\n let resolveFinished!: () => void;\n const finished = new Promise<void>((resolve) => {\n resolveFinished = resolve;\n });\n let settled = false;\n const finish = (): void => {\n if (settled) return;\n settled = true;\n resolveFinished();\n };\n\n const record: VoiceRecord = {\n bus: busName,\n finish,\n gain,\n key,\n panner,\n source,\n stopped: false,\n };\n\n const handle: SoundHandle = {\n dispose(): void {\n if (record.stopped) {\n finish();\n return;\n }\n record.stopped = true;\n try {\n record.source.stop();\n } catch {\n // Already stopped.\n }\n teardown(record);\n release(record);\n },\n get disposed() {\n return record.stopped;\n },\n finished,\n setPan(panValue): void {\n panner.pan.value = Math.min(Math.max(panValue, -1), 1);\n },\n setVolume(volumeValue, fadeOptions): void {\n rampParam(gain.gain, Math.min(Math.max(volumeValue, 0), 1), fadeOptions?.fade ?? MICRO_FADE, ctx.currentTime);\n },\n stop(fadeOptions): void {\n fadeOut(record, fadeOptions?.fade ?? MICRO_FADE);\n },\n [Symbol.dispose](): void {\n handle.dispose();\n },\n };\n\n // Enforce caps before starting: per-key first, then global.\n if (options.maxVoices !== undefined) {\n while ([...voices].filter((v) => v.key === key && !v.stopped).length >= options.maxVoices) {\n if (!stealOldest((v) => v.key === key)) break;\n }\n }\n for (;;) {\n const active = [...voices].filter((v) => !v.stopped).length;\n if (active < deps.maxVoices) break;\n if (!stealOldest((v) => !v.stopped)) break;\n }\n\n voices.add(record);\n deps.buses().voiceCount(busName, 1);\n source.addEventListener(\n 'ended',\n () => {\n teardown(record);\n release(record);\n },\n { once: true },\n );\n // A looping source never ends on its own; it releases on stop/dispose.\n source.start(ctx.currentTime, offset, loop ? undefined : region?.duration);\n return handle;\n },\n stopKeys(keys): void {\n for (const record of [...voices]) {\n const assetKey = parseSpriteKey(record.key)?.asset ?? record.key;\n if (keys.includes(assetKey)) fadeOut(record, MICRO_FADE);\n }\n },\n };\n}\n"],"mappings":"A,oFA8BA,SAAgB,gBAAgB,EAMlB,CACZ,IAAMS,EAAS,IAAI,IACfC,EAAW,GAET,QAAW,GAA8B,CACxCD,EAAO,OAAOE,CAAM,IACzBC,EAAK,MAAM,CAAC,CAAC,WAAWD,EAAO,IAAK,EAAE,EACtCA,EAAO,OAAO,EAChB,EAEM,SAAY,GAA8B,CAC9C,GAAI,CACFA,EAAO,OAAO,WAAW,CAC3B,MAAQ,CAER,CACAA,EAAO,KAAK,WAAW,EACvBA,EAAO,OAAO,WAAW,CAC3B,EAEM,SAAW,EAAqB,IAAuB,CAC3D,GAAIA,EAAO,QAAS,OACpB,EAAO,QAAU,GACjB,IAAME,EAAMD,EAAK,QAAQ,EACzBL,EAAA,UAAUI,EAAO,KAAK,KAAM,EAAGG,EAAMD,EAAI,WAAW,EACpD,IAAME,EAASF,EAAI,YAAcC,EACjC,GAAI,CACFH,EAAO,OAAO,KAAKI,CAAM,CAC3B,MAAQ,CAER,CAEAJ,EAAO,OAAO,iBACZ,YACM,CACJ,SAASA,CAAM,EACf,QAAQA,CAAM,CAChB,EACA,CAAE,KAAM,EAAK,CACf,CACF,EAGM,YAAe,GAAoD,CACvE,IAAK,IAAMA,KAAUF,EACnB,GAAIO,EAAUL,CAAM,GAAK,CAACA,EAAO,QAG/B,OAFAC,EAAK,QAAQD,EAAO,GAAG,EACvB,QAAQA,EAAQX,EAAAA,UAAU,EACnB,GAGX,MAAO,EACT,EAEA,MAAO,CACL,SAAgB,CACd,EAAW,GACX,IAAK,IAAMW,IAAU,CAAC,GAAGF,CAAM,EAAG,CAChC,GAAI,CACFE,EAAO,OAAO,KAAK,CACrB,MAAQ,CAER,CACA,SAASA,CAAM,EACf,QAAQA,CAAM,CAChB,CACAF,EAAO,MAAM,CACf,EACA,KAAK,EAAK,EAAU,CAAC,EAAgB,CACnC,GAAIC,EAAU,MAAM,IAAIT,EAAAA,UAAU,6BAA6B,EAC/D,IAAMY,EAAMD,EAAK,QAAQ,EACnBK,EAASf,EAAAA,eAAegB,CAAG,EAC3BC,EAAWF,GAAQ,OAASC,EAC5BE,EAAQR,EAAK,OAAO,IAAIO,CAAQ,EACtC,GAAI,CAACC,EAAO,MAAM,IAAInB,EAAAA,UAAU,UAAUiB,EAAI,iBAAiB,EAC/D,IAAMG,EAAUC,EAAQ,KAAO,MACzBC,EAAMX,EAAK,MAAM,CAAC,CAAC,IAAIS,CAAO,EAE9BG,EAASP,EAASd,EAAAA,cAAciB,EAAOH,EAAO,OAAQC,CAAG,EAAI,IAAA,GAC7DO,EAAOH,EAAQ,MAAQ,GACvBI,EAASJ,EAAQ,QAAUE,GAAQ,QAAU,EAE7CG,EAASd,EAAI,mBAAmB,EACtC,EAAO,OAASO,EAAM,OAClBK,IACF,EAAO,KAAO,GACVH,EAAQ,YAAc,IAAA,GACjBE,IAAQ,EAAO,UAAYA,EAAO,QADN,EAAO,UAAYF,EAAQ,UAE5DA,EAAQ,UAAY,IAAA,GACfE,IAAQ,EAAO,QAAUA,EAAO,OAASA,EAAO,UADtB,EAAO,QAAUF,EAAQ,SAG9D,IAAMM,EAAOxB,EAAAA,YAAYkB,EAAQ,KAAMA,EAAQ,QAAU,KAAK,MAAM,EAChEM,IAAS,IAAA,KAAW,EAAO,aAAa,MAAQA,GACpD,IAAMC,EAASzB,EAAAA,YAAYkB,EAAQ,OAAQA,EAAQ,QAAU,KAAK,MAAM,EACpEO,IAAW,IAAA,KAAW,EAAO,OAAO,MAAQA,GAEhD,IAAMC,EAAOjB,EAAI,WAAW,EACtBkB,EAAST,EAAQ,QAAU,EAC7BA,EAAQ,QAAUA,EAAQ,OAAS,GACrCQ,EAAK,KAAK,eAAe,EAAGjB,EAAI,WAAW,EAC3CiB,EAAK,KAAK,wBAAwB,KAAK,IAAIC,EAAQ1B,EAAAA,QAAQ,EAAGQ,EAAI,YAAcS,EAAQ,MAAM,GAE9F,EAAK,KAAK,MAAQS,EAKpB,IAAMC,EAASnB,EAAI,mBAAmB,EACtC,EAAO,IAAI,MAAQS,EAAQ,KAAO,EAClCQ,EAAK,QAAQE,CAAM,EACnBA,EAAO,QAAQT,EAAI,KAAK,EACxBI,EAAO,QAAQG,CAAI,EAEnB,IAAIG,EACEC,EAAW,IAAI,QAAe,GAAY,CAC9C,EAAkBC,CACpB,CAAC,EACGC,EAAU,GACR,WAAqB,CACrBA,IACJ,EAAU,GACVH,EAAgB,EAClB,EAEMtB,EAAsB,CAC1B,IAAKU,EACL,OACA,OACA,MACA,SACA,SACA,QAAS,EACX,EAEMgB,EAAsB,CAC1B,SAAgB,CACd,GAAI1B,EAAO,QACT,OAAO,MAGT,GAAO,QAAU,GACjB,GAAI,CACFA,EAAO,OAAO,KAAK,CACrB,MAAQ,CAER,CACA,SAASA,CAAM,EACf,QAAQA,CAAM,CAPG,CAQnB,EACA,IAAI,UAAW,CACb,OAAOA,EAAO,OAChB,EACA,WACA,OAAO,EAAgB,CACrB,EAAO,IAAI,MAAQ,KAAK,IAAI,KAAK,IAAI2B,EAAU,EAAE,EAAG,CAAC,CACvD,EACA,UAAU,EAAa,EAAmB,CACxC/B,EAAA,UAAUuB,EAAK,KAAM,KAAK,IAAI,KAAK,IAAIS,EAAa,CAAC,EAAG,CAAC,EAAGC,GAAa,MAAA,KAAoB3B,EAAI,WAAW,CAC9G,EACA,KAAK,EAAmB,CACtB,QAAQF,EAAQ6B,GAAa,MAAA,IAAkB,CACjD,EACA,CAAC,OAAO,UAAiB,CACvBH,EAAO,QAAQ,CACjB,CACF,EAGA,GAAIf,EAAQ,YAAc,IAAA,GACjB,KAAA,CAAC,GAAGb,CAAM,CAAC,CAAC,OAAQ,GAAMgC,EAAE,MAAQvB,GAAO,CAACuB,EAAE,OAAO,CAAC,CAAC,QAAUnB,EAAQ,WACzE,YAAa,GAAMmB,EAAE,MAAQvB,CAAG,IAGzC,KAGM,EAFW,CAAC,GAAGT,CAAM,CAAC,CAAC,OAAQ,GAAM,CAACgC,EAAE,OAAO,CAAC,CAAC,OACxC7B,EAAK,WACd,CAAC,YAAa,GAAM,CAAC6B,EAAE,OAAO,KAepC,OAZAhC,EAAO,IAAIE,CAAM,EACjBC,EAAK,MAAM,CAAC,CAAC,WAAWS,EAAS,CAAC,EAClCM,EAAO,iBACL,YACM,CACJ,SAAShB,CAAM,EACf,QAAQA,CAAM,CAChB,EACA,CAAE,KAAM,EAAK,CACf,EAEAgB,EAAO,MAAMd,EAAI,YAAaa,EAAQD,EAAO,IAAA,GAAYD,GAAQ,QAAQ,EAClEa,CACT,EACA,SAAS,EAAY,CACnB,IAAK,IAAM1B,IAAU,CAAC,GAAGF,CAAM,EAAG,CAChC,IAAMU,EAAWjB,EAAAA,eAAeS,EAAO,GAAG,CAAC,EAAE,OAASA,EAAO,IACzD+B,EAAK,SAASvB,CAAQ,GAAG,QAAQR,EAAQX,EAAAA,UAAU,CACzD,CACF,CACF,CACF,C"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { BusManager } from './_bus';
|
|
2
|
+
import type { Loader } from './_loader';
|
|
3
|
+
import type { PlayOptions, SoundHandle } from './types';
|
|
4
|
+
export interface VoicePool {
|
|
5
|
+
dispose(): void;
|
|
6
|
+
/** Starts a buffered sound; throws `BardError` for unknown keys. */
|
|
7
|
+
play(key: string, options?: PlayOptions): SoundHandle;
|
|
8
|
+
/** Stops every voice for the given asset keys (used by `unload`). */
|
|
9
|
+
stopKeys(keys: readonly string[]): void;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Voice registry: per-key and global caps with oldest-first stealing (a 10 ms
|
|
13
|
+
* fade before the hard stop, so stealing does not click), organic detune/rate
|
|
14
|
+
* variance, and the `SoundHandle` contract.
|
|
15
|
+
*/
|
|
16
|
+
export declare function createVoicePool(deps: {
|
|
17
|
+
readonly context: () => AudioContext;
|
|
18
|
+
readonly loader: Loader;
|
|
19
|
+
readonly buses: () => BusManager;
|
|
20
|
+
readonly maxVoices: number;
|
|
21
|
+
readonly onSteal: (key: string | null) => void;
|
|
22
|
+
}): VoicePool;
|
|
23
|
+
//# sourceMappingURL=_voices.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_voices.d.ts","sourceRoot":"","sources":["../src/_voices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAYxD,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,IAAI,CAAC;IAChB,oEAAoE;IACpE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACtD,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CACzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAChD,GAAG,SAAS,CAwMZ"}
|
package/dist/_voices.js
ADDED
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { parseSpriteKey as e, resolveSprite as t } from "./_loader.js";
|
|
2
|
+
import { MICRO_FADE as n, MIN_GAIN as r, rampParam as i, sampleRange as a } from "./_ramp.js";
|
|
3
|
+
import { BardError as o } from "./errors.js";
|
|
4
|
+
// src/_voices.ts
|
|
5
|
+
function createVoicePool(s) {
|
|
6
|
+
let c = /* @__PURE__ */ new Set(), l = !1, release = (e) => {
|
|
7
|
+
c.delete(e) && (s.buses().voiceCount(e.bus, -1), e.finish());
|
|
8
|
+
}, teardown = (e) => {
|
|
9
|
+
try {
|
|
10
|
+
e.source.disconnect();
|
|
11
|
+
} catch {}
|
|
12
|
+
e.gain.disconnect(), e.panner.disconnect();
|
|
13
|
+
}, fadeOut = (e, t) => {
|
|
14
|
+
if (e.stopped) return;
|
|
15
|
+
e.stopped = !0;
|
|
16
|
+
let n = s.context();
|
|
17
|
+
i(e.gain.gain, 0, t, n.currentTime);
|
|
18
|
+
let r = n.currentTime + t;
|
|
19
|
+
try {
|
|
20
|
+
e.source.stop(r);
|
|
21
|
+
} catch {}
|
|
22
|
+
e.source.addEventListener("ended", () => {
|
|
23
|
+
teardown(e), release(e);
|
|
24
|
+
}, { once: !0 });
|
|
25
|
+
}, stealOldest = (e) => {
|
|
26
|
+
for (let t of c) if (e(t) && !t.stopped) return s.onSteal(t.key), fadeOut(t, n), !0;
|
|
27
|
+
return !1;
|
|
28
|
+
};
|
|
29
|
+
return {
|
|
30
|
+
dispose() {
|
|
31
|
+
l = !0;
|
|
32
|
+
for (let e of [...c]) {
|
|
33
|
+
try {
|
|
34
|
+
e.source.stop();
|
|
35
|
+
} catch {}
|
|
36
|
+
teardown(e), release(e);
|
|
37
|
+
}
|
|
38
|
+
c.clear();
|
|
39
|
+
},
|
|
40
|
+
play(n, u = {}) {
|
|
41
|
+
if (l) throw new o("The voice pool is disposed.");
|
|
42
|
+
let d = s.context(), f = e(n), p = f?.asset ?? n, m = s.loader.get(p);
|
|
43
|
+
if (!m) throw new o(`Sound "${n}" is not loaded.`);
|
|
44
|
+
let h = u.bus ?? "sfx", g = s.buses().get(h), _ = f ? t(m, f.sprite, n) : void 0, v = u.loop ?? !1, y = u.offset ?? _?.offset ?? 0, b = d.createBufferSource();
|
|
45
|
+
b.buffer = m.buffer, v && (b.loop = !0, u.loopStart === void 0 ? _ && (b.loopStart = _.offset) : b.loopStart = u.loopStart, u.loopEnd === void 0 ? _ && (b.loopEnd = _.offset + _.duration) : b.loopEnd = u.loopEnd);
|
|
46
|
+
let x = a(u.rate, u.random ?? Math.random);
|
|
47
|
+
x !== void 0 && (b.playbackRate.value = x);
|
|
48
|
+
let S = a(u.detune, u.random ?? Math.random);
|
|
49
|
+
S !== void 0 && (b.detune.value = S);
|
|
50
|
+
let C = d.createGain(), w = u.volume ?? 1;
|
|
51
|
+
u.fadeIn && u.fadeIn > 0 ? (C.gain.setValueAtTime(0, d.currentTime), C.gain.linearRampToValueAtTime(Math.max(w, r), d.currentTime + u.fadeIn)) : C.gain.value = w;
|
|
52
|
+
let T = d.createStereoPanner();
|
|
53
|
+
T.pan.value = u.pan ?? 0, C.connect(T), T.connect(g.input), b.connect(C);
|
|
54
|
+
let E, D = new Promise((e) => {
|
|
55
|
+
E = e;
|
|
56
|
+
}), O = !1, finish = () => {
|
|
57
|
+
O || (O = !0, E());
|
|
58
|
+
}, k = {
|
|
59
|
+
bus: h,
|
|
60
|
+
finish,
|
|
61
|
+
gain: C,
|
|
62
|
+
key: n,
|
|
63
|
+
panner: T,
|
|
64
|
+
source: b,
|
|
65
|
+
stopped: !1
|
|
66
|
+
}, A = {
|
|
67
|
+
dispose() {
|
|
68
|
+
if (k.stopped) finish();
|
|
69
|
+
else {
|
|
70
|
+
k.stopped = !0;
|
|
71
|
+
try {
|
|
72
|
+
k.source.stop();
|
|
73
|
+
} catch {}
|
|
74
|
+
teardown(k), release(k);
|
|
75
|
+
}
|
|
76
|
+
},
|
|
77
|
+
get disposed() {
|
|
78
|
+
return k.stopped;
|
|
79
|
+
},
|
|
80
|
+
finished: D,
|
|
81
|
+
setPan(e) {
|
|
82
|
+
T.pan.value = Math.min(Math.max(e, -1), 1);
|
|
83
|
+
},
|
|
84
|
+
setVolume(e, t) {
|
|
85
|
+
i(C.gain, Math.min(Math.max(e, 0), 1), t?.fade ?? .015, d.currentTime);
|
|
86
|
+
},
|
|
87
|
+
stop(e) {
|
|
88
|
+
fadeOut(k, e?.fade ?? .015);
|
|
89
|
+
},
|
|
90
|
+
[Symbol.dispose]() {
|
|
91
|
+
A.dispose();
|
|
92
|
+
}
|
|
93
|
+
};
|
|
94
|
+
if (u.maxVoices !== void 0) for (; [...c].filter((e) => e.key === n && !e.stopped).length >= u.maxVoices && stealOldest((e) => e.key === n););
|
|
95
|
+
for (; !([...c].filter((e) => !e.stopped).length < s.maxVoices || !stealOldest((e) => !e.stopped)););
|
|
96
|
+
return c.add(k), s.buses().voiceCount(h, 1), b.addEventListener("ended", () => {
|
|
97
|
+
teardown(k), release(k);
|
|
98
|
+
}, { once: !0 }), b.start(d.currentTime, y, v ? void 0 : _?.duration), A;
|
|
99
|
+
},
|
|
100
|
+
stopKeys(t) {
|
|
101
|
+
for (let r of [...c]) {
|
|
102
|
+
let i = e(r.key)?.asset ?? r.key;
|
|
103
|
+
t.includes(i) && fadeOut(r, n);
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
export { createVoicePool };
|
|
109
|
+
|
|
110
|
+
//# sourceMappingURL=_voices.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"_voices.js","names":["voices","disposed","record","deps","ctx","fade","stopAt","predicate","MICRO_FADE","BardError","sprite","parseSpriteKey","key","assetKey","asset","busName","options","bus","region","resolveSprite","loop","offset","source","rate","sampleRange","detune","gain","volume","MIN_GAIN","panner","resolveFinished","finished","resolve","settled","handle","panValue","volumeValue","fadeOptions","v","keys"],"sources":["../src/_voices.ts"],"sourcesContent":["import type { BusManager } from './_bus';\nimport type { Loader } from './_loader';\nimport { parseSpriteKey, resolveSprite } from './_loader';\nimport { MICRO_FADE, MIN_GAIN, rampParam, sampleRange } from './_ramp';\nimport { BardError } from './errors';\nimport type { PlayOptions, SoundHandle } from './types';\n\ninterface VoiceRecord {\n readonly bus: string;\n readonly finish: () => void;\n readonly gain: GainNode;\n readonly key: string;\n readonly panner: StereoPannerNode;\n readonly source: AudioBufferSourceNode;\n stopped: boolean;\n}\n\nexport interface VoicePool {\n dispose(): void;\n /** Starts a buffered sound; throws `BardError` for unknown keys. */\n play(key: string, options?: PlayOptions): SoundHandle;\n /** Stops every voice for the given asset keys (used by `unload`). */\n stopKeys(keys: readonly string[]): void;\n}\n\n/**\n * Voice registry: per-key and global caps with oldest-first stealing (a 10 ms\n * fade before the hard stop, so stealing does not click), organic detune/rate\n * variance, and the `SoundHandle` contract.\n */\nexport function createVoicePool(deps: {\n readonly context: () => AudioContext;\n readonly loader: Loader;\n readonly buses: () => BusManager;\n readonly maxVoices: number;\n readonly onSteal: (key: string | null) => void;\n}): VoicePool {\n const voices = new Set<VoiceRecord>();\n let disposed = false;\n\n const release = (record: VoiceRecord): void => {\n if (!voices.delete(record)) return;\n deps.buses().voiceCount(record.bus, -1);\n record.finish();\n };\n\n const teardown = (record: VoiceRecord): void => {\n try {\n record.source.disconnect();\n } catch {\n // Already disconnected.\n }\n record.gain.disconnect();\n record.panner.disconnect();\n };\n\n const fadeOut = (record: VoiceRecord, fade: number): void => {\n if (record.stopped) return;\n record.stopped = true;\n const ctx = deps.context();\n rampParam(record.gain.gain, 0, fade, ctx.currentTime);\n const stopAt = ctx.currentTime + fade;\n try {\n record.source.stop(stopAt);\n } catch {\n // Already stopped.\n }\n // Teardown happens on 'ended'; a source that never started ends on its own.\n record.source.addEventListener(\n 'ended',\n () => {\n teardown(record);\n release(record);\n },\n { once: true },\n );\n };\n\n /** Steals the oldest voice matching `predicate`, if any. */\n const stealOldest = (predicate: (v: VoiceRecord) => boolean): boolean => {\n for (const record of voices) {\n if (predicate(record) && !record.stopped) {\n deps.onSteal(record.key);\n fadeOut(record, MICRO_FADE);\n return true;\n }\n }\n return false;\n };\n\n return {\n dispose(): void {\n disposed = true;\n for (const record of [...voices]) {\n try {\n record.source.stop();\n } catch {\n // Already stopped.\n }\n teardown(record);\n release(record);\n }\n voices.clear();\n },\n play(key, options = {}): SoundHandle {\n if (disposed) throw new BardError('The voice pool is disposed.');\n const ctx = deps.context();\n const sprite = parseSpriteKey(key);\n const assetKey = sprite?.asset ?? key;\n const asset = deps.loader.get(assetKey);\n if (!asset) throw new BardError(`Sound \"${key}\" is not loaded.`);\n const busName = options.bus ?? 'sfx';\n const bus = deps.buses().get(busName);\n\n const region = sprite ? resolveSprite(asset, sprite.sprite, key) : undefined;\n const loop = options.loop ?? false;\n const offset = options.offset ?? region?.offset ?? 0;\n\n const source = ctx.createBufferSource();\n source.buffer = asset.buffer;\n if (loop) {\n source.loop = true;\n if (options.loopStart !== undefined) source.loopStart = options.loopStart;\n else if (region) source.loopStart = region.offset;\n if (options.loopEnd !== undefined) source.loopEnd = options.loopEnd;\n else if (region) source.loopEnd = region.offset + region.duration;\n }\n const rate = sampleRange(options.rate, options.random ?? Math.random);\n if (rate !== undefined) source.playbackRate.value = rate;\n const detune = sampleRange(options.detune, options.random ?? Math.random);\n if (detune !== undefined) source.detune.value = detune;\n\n const gain = ctx.createGain();\n const volume = options.volume ?? 1;\n if (options.fadeIn && options.fadeIn > 0) {\n gain.gain.setValueAtTime(0, ctx.currentTime);\n gain.gain.linearRampToValueAtTime(Math.max(volume, MIN_GAIN), ctx.currentTime + options.fadeIn);\n } else {\n gain.gain.value = volume;\n }\n // Every voice gets a panner so `handle.setPan()` always works; the node\n // is cheap and the uniform `gain -> panner -> bus` shape is simpler\n // than a conditional graph.\n const panner = ctx.createStereoPanner();\n panner.pan.value = options.pan ?? 0;\n gain.connect(panner);\n panner.connect(bus.input);\n source.connect(gain);\n\n let resolveFinished!: () => void;\n const finished = new Promise<void>((resolve) => {\n resolveFinished = resolve;\n });\n let settled = false;\n const finish = (): void => {\n if (settled) return;\n settled = true;\n resolveFinished();\n };\n\n const record: VoiceRecord = {\n bus: busName,\n finish,\n gain,\n key,\n panner,\n source,\n stopped: false,\n };\n\n const handle: SoundHandle = {\n dispose(): void {\n if (record.stopped) {\n finish();\n return;\n }\n record.stopped = true;\n try {\n record.source.stop();\n } catch {\n // Already stopped.\n }\n teardown(record);\n release(record);\n },\n get disposed() {\n return record.stopped;\n },\n finished,\n setPan(panValue): void {\n panner.pan.value = Math.min(Math.max(panValue, -1), 1);\n },\n setVolume(volumeValue, fadeOptions): void {\n rampParam(gain.gain, Math.min(Math.max(volumeValue, 0), 1), fadeOptions?.fade ?? MICRO_FADE, ctx.currentTime);\n },\n stop(fadeOptions): void {\n fadeOut(record, fadeOptions?.fade ?? MICRO_FADE);\n },\n [Symbol.dispose](): void {\n handle.dispose();\n },\n };\n\n // Enforce caps before starting: per-key first, then global.\n if (options.maxVoices !== undefined) {\n while ([...voices].filter((v) => v.key === key && !v.stopped).length >= options.maxVoices) {\n if (!stealOldest((v) => v.key === key)) break;\n }\n }\n for (;;) {\n const active = [...voices].filter((v) => !v.stopped).length;\n if (active < deps.maxVoices) break;\n if (!stealOldest((v) => !v.stopped)) break;\n }\n\n voices.add(record);\n deps.buses().voiceCount(busName, 1);\n source.addEventListener(\n 'ended',\n () => {\n teardown(record);\n release(record);\n },\n { once: true },\n );\n // A looping source never ends on its own; it releases on stop/dispose.\n source.start(ctx.currentTime, offset, loop ? undefined : region?.duration);\n return handle;\n },\n stopKeys(keys): void {\n for (const record of [...voices]) {\n const assetKey = parseSpriteKey(record.key)?.asset ?? record.key;\n if (keys.includes(assetKey)) fadeOut(record, MICRO_FADE);\n }\n },\n };\n}\n"],"mappings":"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"}
|
package/dist/bard.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=1e-4,t=.015;function rampParam(e,t,n,r){let i=e.value;e.cancelScheduledValues(r),e.setValueAtTime(i,r),n<=0||i===t?e.setValueAtTime(t,r):e.linearRampToValueAtTime(t,r+n)}function expRampTo(t,n,r,i){let a=Math.max(t.value,e);t.cancelScheduledValues(i),t.setValueAtTime(a,i),t.exponentialRampToValueAtTime(Math.max(n,e),i+r)}function sampleRange(e,t){if(e===void 0)return;if(typeof e==`number`)return e;let[n,r]=e;return n+(r-n)*Math.min(Math.max(t(),0),1)}var BardError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},BardLoadError=class extends BardError{},BardDisposedError=class extends BardError{},BardUnsupportedError=class extends BardError{};function createBusManager(e){let n=e.context,r=n.createGain();r.gain.value=e.volume,r.connect(n.destination);let i=new Map,createBus=e=>{let i=n.createGain(),a=n.createGain(),o=n.createGain();i.connect(a),a.connect(o),o.connect(r);let s={get controller(){return c},disconnect(){i.disconnect(),a.disconnect(),o.disconnect()},duckGain:a,duckLevel:1,input:i,muted:!1,name:e,userVolume:1,volumeGain:o},c={get duckLevel(){return s.duckLevel},mute(){s.muted=!0,applyVolume()},get muted(){return s.muted},name:e,setVolume(e,t){s.userVolume=Math.min(Math.max(e,0),1),rampParam(o.gain,s.muted?0:s.userVolume,t?.fade??.015,n.currentTime)},unmute(){s.muted=!1,applyVolume()},get volume(){return s.userVolume}},applyVolume=()=>{rampParam(o.gain,s.muted?0:s.userVolume,t,n.currentTime)};return s};for(let t of e.buses)i.set(t,createBus(t));let a=!1,o=e.volume,s={get duckLevel(){return 1},mute(){a=!0,rampParam(r.gain,0,t,n.currentTime)},get muted(){return a},name:`master`,setVolume(e,t){o=Math.min(Math.max(e,0),1),rampParam(r.gain,a?0:o,t?.fade??.015,n.currentTime)},unmute(){a=!1,rampParam(r.gain,o,t,n.currentTime)},get volume(){return o}},c=new Map,l=new Map,applyDuck=t=>{let r=i.get(t);if(!r)return;let a=e.ducking.filter(e=>e.target===t).map(e=>({ducking:(c.get(e.source)??0)>0,rule:e})).filter(e=>e.ducking).map(e=>e.rule.gain),o=a.length>0?Math.min(...a):1,s=l.get(t)??1;if(o===s)return;l.set(t,o),r.duckLevel=o;let u=e.ducking.find(e=>e.target===t&&(e.gain===o||o===1)),d=o<s?u?.attack??.2:u?.release??.8;rampParam(r.duckGain.gain,o,d,n.currentTime),e.onDuck?.(t,o,d)};return{dispose(){for(let e of i.values())e.disconnect();r.disconnect()},get(e){if(e===`master`)return{controller:s,duckLevel:1,input:r,name:`master`};let t=i.get(e);if(!t)throw new BardError(`Unknown bus "${e}".`);return t},voiceCount(t,n){if(!i.has(t))return;let r=Math.max(0,(c.get(t)??0)+n);c.set(t,r);for(let n of new Set(e.ducking.filter(e=>e.source===t).map(e=>e.target)))applyDuck(n)}}}var n=[`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(e){let t=e.factory===void 0,r=null,i=!1,a=!1,o=!1,s=typeof window>`u`?void 0:window,c=typeof document>`u`?void 0:document,detachUnlock=()=>{if(o&&s){o=!1;for(let e of n)s.removeEventListener(e,onUnlock,{capture:!0})}};function onUnlock(){r&&r.state!==`running`&&r.state!==`closed`&&r.resume().catch(()=>{})}let onVisibility=()=>{r&&c&&r.state!==`closed`&&(c.hidden?(a=!0,r.suspend().catch(()=>{})):a&&(a=!1,r.resume().catch(()=>{})))},onStateChange=()=>{if(!r)return;let t=mapState(r.state);e.onState(t),t===`running`&&detachUnlock()};return{get context(){return r},dispose(){i=!0,detachUnlock(),c&&c.removeEventListener(`visibilitychange`,onVisibility),r&&(r.removeEventListener(`statechange`,onStateChange),t&&r.state!==`closed`&&r.close().catch(()=>{}))},ensure(){if(i)throw new BardDisposedError(`The audio engine has been disposed.`);if(r)return r;if(e.factory)r=e.factory();else{if(typeof AudioContext>`u`)throw new BardUnsupportedError(`This runtime does not provide an AudioContext.`);r=new AudioContext}if(r.addEventListener(`statechange`,onStateChange),e.autoUnlock!==!1&&s){o=!0;for(let e of n)s.addEventListener(e,onUnlock,{capture:!0,passive:!0})}return e.autoSuspendOnHidden&&c&&c.addEventListener(`visibilitychange`,onVisibility),e.onState(mapState(r.state)),r},async resume(){let e=this.ensure();e.state!==`running`&&await e.resume()},get state(){return i?`closed`:r?mapState(r.state):`idle`},async suspend(){let e=this.ensure();e.state===`running`&&await e.suspend()}}}function createDeck(e,n={}){let r=n.bus??`music`,i=n.fade??2,a=null,o=[],s=-1,c={},l=0,u=null,d=!1,f=!1,p=null,m=0;n.mediaSession&&(u=e.mediaSession.claim({onNextTrack:()=>h.next(),onPause:()=>h.pause(),onPlay:()=>h.play(),onPreviousTrack:()=>h.previous(),onStop:()=>h.stop()}));let setSessionState=e=>{u?.setPlaybackState(e)},setSessionMeta=t=>{u&&(t===null?u.setMetadata(void 0,``):u.setMetadata(e.loader.definitionOf(t)?.meta,t))},startSlot=(n,i,a)=>{let o=e.context(),s=e.buses().get(r),c=e.loader.definitionOf(n);if(c?.stream){if(i.loopStart!==void 0||i.loopEnd!==void 0)throw new BardError(`Streamed track "${n}" cannot use loopStart/loopEnd; streamed loops cover the whole file.`);let t=e.streams.ensure(n,c),r=o.createGain();t.source.connect(r),r.connect(s.input),a>0?(r.gain.setValueAtTime(0,o.currentTime),r.gain.linearRampToValueAtTime(1,o.currentTime+a)):r.gain.value=1;let l=t.element;l.loop=i.loop??!1,i.offset!==void 0&&(l.currentTime=i.offset),l.play().catch(()=>{});let u=!1;return{key:n,async nearlyOver(e){if(l.loop)return new Promise(()=>{});let t=l.duration;if(Number.isFinite(t)){let n=Math.max(t-l.currentTime-e,0)*1e3;await new Promise(e=>setTimeout(e,n))}else await new Promise(t=>{let onTime=()=>{let n=l.duration;Number.isFinite(n)&&n-l.currentTime<=e&&(l.removeEventListener(`timeupdate`,onTime),t())};l.addEventListener(`timeupdate`,onTime),l.addEventListener(`ended`,()=>{l.removeEventListener(`timeupdate`,onTime),t()},{once:!0})})},pause(){return l.pause(),l.currentTime},stop(e,t){if(u)return;u=!0;let teardown=()=>{t||l.pause();try{r.disconnect()}catch{}};e<=0?(t||l.pause(),r.gain.value=0,teardown()):(rampParam(r.gain,0,e,o.currentTime),setTimeout(teardown,e*1e3))}}}if(!e.loader.has(n))throw new BardError(`Track "${n}" is not loaded.`);let l=o.currentTime,u=e.pool.play(n,{bus:r,fadeIn:a>0?a:void 0,loop:i.loop,loopEnd:i.loopEnd,loopStart:i.loopStart,offset:i.offset}),d=!1;return{key:n,async nearlyOver(t){if(i.loop)return new Promise(()=>{});let r=e.loader.get(n),a=r?r.buffer.duration:1/0,o=Math.max(a-(i.offset??0)-t,0)*1e3;await new Promise(e=>setTimeout(e,o))},pause(){return d?m:(d=!0,u.stop({fade:t}),(i.offset??0)+(o.currentTime-l))},stop(e){d||(d=!0,u.stop({fade:e}))}}},beginTrack=(t,n)=>{let r=n.fade??i,o=a;a=startSlot(t,n,r),f=!1,o&&o.stop(r,o.key===t),e.onTrack(t),setSessionMeta(t),setSessionState(`playing`)},scheduleAdvance=e=>{let t=l,n=c.crossfade??i;e.nearlyOver(n).then(()=>{d||t!==l||a!==e||advance(1)})},advance=e=>{if(o.length===0)return;let t=s+e;if(t>=o.length){if(!c.repeat){o=[];return}t=0}else t<0&&(t=c.repeat?o.length-1:0);s=t;let n=o[t];n!==void 0&&(beginTrack(n,{fade:c.crossfade??i,loop:!1}),a&&scheduleAdvance(a))},h={get current(){return a?.key??null},dispose(){d||(d=!0,l+=1,a&&a.stop(0),a=null,u?.release(),u=null)},get disposed(){return d},next(){if(d)throw new BardError(`The deck is disposed.`);o.length!==0&&(l+=1,advance(1))},pause(){d||!a||f||(l+=1,p=a.key,m=a.pause(),f=!0,setSessionState(`paused`))},play(){if(d||!f||p===null)return;let e=p,n=m;p=null,beginTrack(e,{fade:t,offset:n}),o.length>0&&a&&scheduleAdvance(a)},get playing(){return a!==null&&!f},previous(){if(d)throw new BardError(`The deck is disposed.`);o.length!==0&&(l+=1,advance(-1))},queue(e,t={}){if(d)throw new BardError(`The deck is disposed.`);if(o=[...e],c=t,l+=1,t.shuffle){let e=t.random??Math.random,n=[...o];for(let t=n.length-1;t>0;--t){let r=Math.min(Math.floor(e()*(t+1)),t),i=n[t],a=n[r];i!==void 0&&a!==void 0&&(n[t]=a,n[r]=i)}o=n}s=-1,o.length>0&&advance(1)},stop(t={}){d||(o=[],s=-1,l+=1,a&&a.stop(t.fade??i),a=null,f=!1,p=null,e.onTrack(null),setSessionMeta(null),setSessionState(`none`))},transition(e,t={}){if(d)throw new BardError(`The deck is disposed.`);(e!==a?.key||f)&&(o=[],s=-1,l+=1,beginTrack(e,t))},[Symbol.dispose](){h.dispose()}};return h}function normalizeDefinition(e){return typeof e==`string`?{src:e}:e}function createLoader(e){let t=new Map,n=new Map,r=new Map,i=new Set,fetchDecode=(t,n)=>{let i=r.get(t);if(i)return i;let a=(async()=>{let r=await fetch(t,{signal:n});if(!r.ok)throw new BardLoadError(`Fetching "${t}" failed with status ${r.status}.`,{cause:{status:r.status}});let i=await r.arrayBuffer();try{return await e.decodeAudioData(i)}catch(e){throw new BardLoadError(`Decoding "${t}" failed.`,{cause:e})}})();return r.set(t,a),a.catch(()=>r.delete(t)),a};return{definitionOf(e){return n.get(e)??t.get(e)?.definition},dispose(){for(let e of i)e.abort();i.clear(),t.clear(),n.clear(),r.clear()},get(e){return t.get(e)},has(e){return t.has(e)||n.get(e)?.stream===!0},keys(){return[...new Set([...t.keys(),...n.keys()])]},async load(e,r){let a=new AbortController;i.add(a);let onAbort=()=>a.abort();r?.signal&&(r.signal.aborted?a.abort(r.signal.reason):r.signal.addEventListener(`abort`,onAbort,{once:!0}));try{await Promise.all(Object.entries(e).map(async([e,r])=>{let i=normalizeDefinition(r);if(n.set(e,i),!(i.stream||t.has(e)))try{let n=await fetchDecode(i.src,a.signal);if(a.signal.aborted)return;t.set(e,{buffer:n,definition:i})}catch(t){throw t instanceof BardError?t:new BardLoadError(`Loading "${e}" failed.`,{cause:t})}}))}finally{r?.signal?.removeEventListener(`abort`,onAbort),i.delete(a)}},unload(e){let r=e===void 0?[...new Set([...t.keys(),...n.keys()])]:typeof e==`string`?[e]:[...e];for(let e of r)t.delete(e),n.delete(e);return r}}}function parseSpriteKey(e){let t=e.indexOf(`:`);return t<=0?null:{asset:e.slice(0,t),sprite:e.slice(t+1)}}function resolveSprite(e,t,n){let r=e.definition.sprites?.[t];if(!r)throw new BardError(`Asset "${e.definition.src}" has no sprite "${n}".`);let[i,a]=r;if(i<0||a<=0||i+a>e.buffer.duration+1e-6)throw new BardError(`Sprite "${n}" region [${i}, ${i+a}] exceeds the asset duration.`);return{duration:a,offset:i}}function createMediaSession(){let e=!1;return{claim(t){if(e)throw new BardError(`Another deck already owns navigator.mediaSession.`);let n=typeof navigator>`u`?void 0:navigator.mediaSession;if(!n)throw new BardError(`This runtime does not provide navigator.mediaSession.`);e=!0;let r=[[`play`,t.onPlay],[`pause`,t.onPause],[`stop`,t.onStop],[`nexttrack`,t.onNextTrack],[`previoustrack`,t.onPreviousTrack]];for(let[e,t]of r)try{n.setActionHandler(e,t)}catch{}return{release(){for(let[e]of r)try{n.setActionHandler(e,null)}catch{}n.metadata=null,e=!1},setMetadata(e,t){e?n.metadata=new MediaMetadata({album:e.album??``,artist:e.artist??``,artwork:(e.artwork??[]).map(e=>({sizes:e.sizes??``,src:e.src,type:e.type??``})),title:e.title??t}):n.metadata=null},setPlaybackState(e){try{n.playbackState=e}catch{}}}}}}function createStreams(e){let t=new Map;return{dispose(){for(let e of t.values())e.disconnect();t.clear()},ensure(n,r){let i=t.get(n);if(i)return i;let a=document.createElement(`audio`);a.crossOrigin=`anonymous`,a.preload=`auto`,a.src=r.src;let o=e.createMediaElementSource(a),s,c,l=new Promise((e,t)=>{s=e,c=t});l.catch(()=>{});let onReady=()=>{s()},onError=()=>{c(new BardLoadError(`Streaming "${n}" failed to load "${r.src}".`))};a.addEventListener(`canplay`,onReady,{once:!0}),a.addEventListener(`error`,onError,{once:!0});let u={definition:r,disconnect(){a.removeEventListener(`canplay`,onReady),a.removeEventListener(`error`,onError),a.pause(),a.removeAttribute(`src`),o.disconnect()},get duration(){return a.duration},element:a,ready:l,source:o};return t.set(n,u),u},get(e){return t.get(e)}}}var r=new WeakMap;function noiseBuffer(e){let t=r.get(e);if(t)return t;let n=e.createBuffer(1,e.sampleRate,e.sampleRate),i=n.getChannelData(0);for(let e=0;e<i.length;e+=1)i[e]=Math.random()*2-1;return r.set(e,n),n}function envelopeTimings(e){let n=e.duration??.3;if(n<=0)throw new BardError(`Synth duration must be positive, got ${n}.`);let r=e.envelope??{},i=Math.max(r.attack??.005,0),a=Math.max(r.decay??.05,0),o=Math.min(Math.max(r.sustain??.6,0),1),s=Math.max(r.release??.1,t);return{attack:i,decay:a,hold:Math.max(n-i-a-s,0),release:s,sustain:o}}function playSynth(t){return n=>{let r=t.context(),i=n.bus??`sfx`,a=t.buses().get(i),o=envelopeTimings(n),s=Math.min(Math.max(n.volume??1,0),1),c=r.currentTime,l=r.createGain();l.gain.setValueAtTime(0,c),l.gain.linearRampToValueAtTime(Math.max(s,e),c+o.attack),l.gain.linearRampToValueAtTime(Math.max(s*o.sustain,e),c+o.attack+o.decay);let u=c+o.attack+o.decay+o.hold;l.gain.setValueAtTime(Math.max(s*o.sustain,e),u),l.gain.linearRampToValueAtTime(0,u+o.release);let d=null;if(n.filter){d=r.createBiquadFilter(),d.type=n.filter.type,n.filter.q!==void 0&&(d.Q.value=n.filter.q);let[e,t]=typeof n.filter.frequency==`number`?[n.filter.frequency,n.filter.frequency]:n.filter.frequency;d.frequency.setValueAtTime(e,c),t!==e&&expRampTo(d.frequency,t,o.attack+o.decay+o.hold,c),d.connect(l)}let f=null;n.pan===void 0?l.connect(a.input):(f=r.createStereoPanner(),f.pan.value=n.pan,l.connect(f),f.connect(a.input));let p=n.type===`noise`,m=p?r.createBufferSource():r.createOscillator();if(p){if(m.buffer=noiseBuffer(r),m.loop=!0,n.freq!==void 0&&!d){d=r.createBiquadFilter(),d.type=`bandpass`;let[e,t]=typeof n.freq==`number`?[n.freq,n.freq]:n.freq;d.frequency.setValueAtTime(e,c),t!==e&&expRampTo(d.frequency,t,o.attack+o.decay+o.hold,c),d.connect(l)}}else{let t=m;t.type=n.type??`sine`;let[r,i]=typeof n.freq==`number`||n.freq===void 0?[n.freq??440,n.freq??440]:n.freq;t.frequency.setValueAtTime(Math.max(r,e),c),i!==r&&expRampTo(t.frequency,i,o.attack+o.decay+o.hold,c),n.detune!==void 0&&(t.detune.value=n.detune)}d?m.connect(d):m.connect(l);let h=o.attack+o.decay+o.hold+o.release,g,_=new Promise(e=>{g=e}),v=!1,y=!1,teardown=()=>{try{m.disconnect()}catch{}d?.disconnect(),l.disconnect(),f?.disconnect()};t.onStarted(i),m.addEventListener(`ended`,()=>{teardown(),v||(v=!0,t.onEnded(i),g())},{once:!0});let b={dispose(){if(!y){y=!0;try{m.stop()}catch{}teardown(),v||(v=!0,t.onEnded(i),g())}},get disposed(){return y},finished:_,setPan(e){f&&(f.pan.value=Math.min(Math.max(e,-1),1))},setVolume(e,t){rampParam(l.gain,Math.min(Math.max(e,0),1),t?.fade??.015,r.currentTime)},stop(e){if(y)return;y=!0;let t=e?.fade??.015;rampParam(l.gain,0,t,r.currentTime);try{m.stop(r.currentTime+t)}catch{}},[Symbol.dispose](){b.dispose()}};return m.start(c),m.stop(c+h),b}}function createTappers(){let e=new Set,t=!1;return{emit(t){if(e.size!==0)for(let n of e)try{n(t)}catch{}},stop(){t=!0,e.clear()},tap(n,r){if(t||r?.signal?.aborted)return()=>{};let detach=()=>{e.delete(n)};return e.add(n),r?.signal?.addEventListener(`abort`,detach,{once:!0}),detach}}}function createVoicePool(n){let r=new Set,i=!1,release=e=>{r.delete(e)&&(n.buses().voiceCount(e.bus,-1),e.finish())},teardown=e=>{try{e.source.disconnect()}catch{}e.gain.disconnect(),e.panner.disconnect()},fadeOut=(e,t)=>{if(e.stopped)return;e.stopped=!0;let r=n.context();rampParam(e.gain.gain,0,t,r.currentTime);let i=r.currentTime+t;try{e.source.stop(i)}catch{}e.source.addEventListener(`ended`,()=>{teardown(e),release(e)},{once:!0})},stealOldest=e=>{for(let i of r)if(e(i)&&!i.stopped)return n.onSteal(i.key),fadeOut(i,t),!0;return!1};return{dispose(){i=!0;for(let e of[...r]){try{e.source.stop()}catch{}teardown(e),release(e)}r.clear()},play(t,a={}){if(i)throw new BardError(`The voice pool is disposed.`);let o=n.context(),s=parseSpriteKey(t),c=s?.asset??t,l=n.loader.get(c);if(!l)throw new BardError(`Sound "${t}" is not loaded.`);let u=a.bus??`sfx`,d=n.buses().get(u),f=s?resolveSprite(l,s.sprite,t):void 0,p=a.loop??!1,m=a.offset??f?.offset??0,h=o.createBufferSource();h.buffer=l.buffer,p&&(h.loop=!0,a.loopStart===void 0?f&&(h.loopStart=f.offset):h.loopStart=a.loopStart,a.loopEnd===void 0?f&&(h.loopEnd=f.offset+f.duration):h.loopEnd=a.loopEnd);let g=sampleRange(a.rate,a.random??Math.random);g!==void 0&&(h.playbackRate.value=g);let _=sampleRange(a.detune,a.random??Math.random);_!==void 0&&(h.detune.value=_);let v=o.createGain(),y=a.volume??1;a.fadeIn&&a.fadeIn>0?(v.gain.setValueAtTime(0,o.currentTime),v.gain.linearRampToValueAtTime(Math.max(y,e),o.currentTime+a.fadeIn)):v.gain.value=y;let b=o.createStereoPanner();b.pan.value=a.pan??0,v.connect(b),b.connect(d.input),h.connect(v);let x,S=new Promise(e=>{x=e}),C=!1,finish=()=>{C||(C=!0,x())},w={bus:u,finish,gain:v,key:t,panner:b,source:h,stopped:!1},T={dispose(){if(w.stopped)finish();else{w.stopped=!0;try{w.source.stop()}catch{}teardown(w),release(w)}},get disposed(){return w.stopped},finished:S,setPan(e){b.pan.value=Math.min(Math.max(e,-1),1)},setVolume(e,t){rampParam(v.gain,Math.min(Math.max(e,0),1),t?.fade??.015,o.currentTime)},stop(e){fadeOut(w,e?.fade??.015)},[Symbol.dispose](){T.dispose()}};if(a.maxVoices!==void 0)for(;[...r].filter(e=>e.key===t&&!e.stopped).length>=a.maxVoices&&stealOldest(e=>e.key===t););for(;!([...r].filter(e=>!e.stopped).length<n.maxVoices||!stealOldest(e=>!e.stopped)););return r.add(w),n.buses().voiceCount(u,1),h.addEventListener(`ended`,()=>{teardown(w),release(w)},{once:!0}),h.start(o.currentTime,m,p?void 0:f?.duration),T},stopKeys(e){for(let n of[...r]){let r=parseSpriteKey(n.key)?.asset??n.key;e.includes(r)&&fadeOut(n,t)}}}}var i=[`music`,`sfx`,`voice`];function createBard(e={}){let t=createTappers(),n=new AbortController,r=!1,a=`idle`,o=e.buses?[...e.buses]:[...i];if(o.includes(`master`))throw new BardError(`"master" is a reserved bus name and cannot be declared in options.buses.`);let s=null,c={claim(e){return s??=createMediaSession(),s.claim(e)}},l=null,u=null,d=null,f=null,p=null,m=new Set,ensureContext=()=>{if(r)throw new BardDisposedError(`The audio engine has been disposed.`);l||=createContextManager({autoSuspendOnHidden:e.autoSuspendOnHidden,autoUnlock:e.autoUnlock,factory:e.context,onState:e=>{a=e,t.emit({state:e,type:`state`})}});let n=l.ensure();return u&&f&&p&&d||(u=createLoader(n),d=createStreams(n),f=createBusManager({buses:o,context:n,ducking:e.ducking??[],onDuck:(e,n,r)=>t.emit({bus:e,level:n,ramp:r,type:`duck`}),volume:e.volume??1}),p=createVoicePool({buses:()=>f,context:()=>n,loader:u,maxVoices:e.maxVoices??32,onSteal:e=>t.emit({key:e,type:`steal`})})),n},requirePool=()=>(ensureContext(),p),playSynthSound=e=>{let t=ensureContext();return playSynth({buses:()=>f,context:()=>t,onEnded:e=>f.voiceCount(e,-1),onStarted:e=>f.voiceCount(e,1)})(e)},h={bus(e){return ensureContext(),f.get(e).controller},get context(){return l?.context??null},createDeck(e={}){let n=ensureContext(),r=createDeck({buses:()=>f,context:()=>n,loader:u,mediaSession:c,onTrack:e=>t.emit({key:e,type:`track`}),pool:p,streams:d},e);return m.add(r),r},get disposalSignal(){return n.signal},dispose(){if(!r){r=!0,t.emit({type:`dispose`}),t.stop(),n.abort();for(let e of m)e.dispose();m.clear(),p?.dispose(),d?.dispose(),u?.dispose(),f?.dispose(),l?.dispose(),a=`closed`}},get disposed(){return r},has(e){if(!u)return!1;let t=parseSpriteKey(e)?.asset??e;return u.has(t)},async load(e,n){ensureContext();try{let r=Object.entries(e).filter(([,e])=>typeof e==`object`&&e.stream===!0).map(([e])=>e);await u.load(e,n);for(let e of r){let t=u.definitionOf(e);t&&d.ensure(e,t)}for(let n of Object.keys(e))t.emit({key:n,type:`load`})}catch(n){for(let r of Object.keys(e))t.emit({error:n,key:r,type:`load-error`});throw n}},play(e,t){return requirePool().play(e,t)},async resume(){await l?.resume()},get state(){return l?.state??a},async suspend(){await l?.suspend()},synth(e){return playSynthSound(e)},tap:t.tap,unload(e){if(r)return;let t=e===void 0?u?.keys()??[]:typeof e==`string`?[e]:e;p?.stopKeys(t);for(let e of t){let t=d?.get(e);t&&t.disconnect()}u?.unload(t)},async unlock(){ensureContext(),await l?.resume()},[Symbol.dispose](){h.dispose()}};return h}exports.BardDisposedError=BardDisposedError,exports.BardError=BardError,exports.BardLoadError=BardLoadError,exports.BardUnsupportedError=BardUnsupportedError,exports.createBard=createBard;
|
|
2
|
+
//# sourceMappingURL=bard.cjs.map
|