@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.
Files changed (89) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +53 -2
  3. package/dist/_bus.cjs +2 -0
  4. package/dist/_bus.cjs.map +1 -0
  5. package/dist/_bus.d.ts +28 -0
  6. package/dist/_bus.d.ts.map +1 -0
  7. package/dist/_bus.js +108 -0
  8. package/dist/_bus.js.map +1 -0
  9. package/dist/_context.cjs +2 -0
  10. package/dist/_context.cjs.map +1 -0
  11. package/dist/_context.d.ts +22 -0
  12. package/dist/_context.d.ts.map +1 -0
  13. package/dist/_context.js +73 -0
  14. package/dist/_context.js.map +1 -0
  15. package/dist/_deck.cjs +2 -0
  16. package/dist/_deck.cjs.map +1 -0
  17. package/dist/_deck.d.ts +24 -0
  18. package/dist/_deck.d.ts.map +1 -0
  19. package/dist/_deck.js +166 -0
  20. package/dist/_deck.js.map +1 -0
  21. package/dist/_loader.cjs +2 -0
  22. package/dist/_loader.cjs.map +1 -0
  23. package/dist/_loader.d.ts +37 -0
  24. package/dist/_loader.d.ts.map +1 -0
  25. package/dist/_loader.js +88 -0
  26. package/dist/_loader.js.map +1 -0
  27. package/dist/_media-session.cjs +2 -0
  28. package/dist/_media-session.cjs.map +1 -0
  29. package/dist/_media-session.d.ts +23 -0
  30. package/dist/_media-session.d.ts.map +1 -0
  31. package/dist/_media-session.js +49 -0
  32. package/dist/_media-session.js.map +1 -0
  33. package/dist/_ramp.cjs +2 -0
  34. package/dist/_ramp.cjs.map +1 -0
  35. package/dist/_ramp.d.ts +20 -0
  36. package/dist/_ramp.d.ts.map +1 -0
  37. package/dist/_ramp.js +19 -0
  38. package/dist/_ramp.js.map +1 -0
  39. package/dist/_stream.cjs +2 -0
  40. package/dist/_stream.cjs.map +1 -0
  41. package/dist/_stream.d.ts +25 -0
  42. package/dist/_stream.d.ts.map +1 -0
  43. package/dist/_stream.js +46 -0
  44. package/dist/_stream.js.map +1 -0
  45. package/dist/_synth.cjs +2 -0
  46. package/dist/_synth.cjs.map +1 -0
  47. package/dist/_synth.d.ts +14 -0
  48. package/dist/_synth.d.ts.map +1 -0
  49. package/dist/_synth.js +101 -0
  50. package/dist/_synth.js.map +1 -0
  51. package/dist/_tappers.cjs +2 -0
  52. package/dist/_tappers.cjs.map +1 -0
  53. package/dist/_tappers.d.ts +23 -0
  54. package/dist/_tappers.d.ts.map +1 -0
  55. package/dist/_tappers.js +24 -0
  56. package/dist/_tappers.js.map +1 -0
  57. package/dist/_voices.cjs +2 -0
  58. package/dist/_voices.cjs.map +1 -0
  59. package/dist/_voices.d.ts +23 -0
  60. package/dist/_voices.d.ts.map +1 -0
  61. package/dist/_voices.js +110 -0
  62. package/dist/_voices.js.map +1 -0
  63. package/dist/bard.cjs +2 -0
  64. package/dist/bard.cjs.map +1 -0
  65. package/dist/bard.d.ts +8 -0
  66. package/dist/bard.d.ts.map +1 -0
  67. package/dist/bard.iife.js +2 -0
  68. package/dist/bard.iife.js.map +1 -0
  69. package/dist/bard.js +901 -0
  70. package/dist/bard.js.map +1 -0
  71. package/dist/errors.cjs +2 -0
  72. package/dist/errors.cjs.map +1 -0
  73. package/dist/errors.d.ts +14 -0
  74. package/dist/errors.d.ts.map +1 -0
  75. package/dist/errors.js +9 -0
  76. package/dist/errors.js.map +1 -0
  77. package/dist/index.cjs +1 -0
  78. package/dist/index.d.ts +4 -0
  79. package/dist/index.d.ts.map +1 -0
  80. package/dist/index.js +3 -0
  81. package/dist/testing/index.d.ts +146 -0
  82. package/dist/testing/index.d.ts.map +1 -0
  83. package/dist/testing.cjs +2 -0
  84. package/dist/testing.cjs.map +1 -0
  85. package/dist/testing.js +221 -0
  86. package/dist/testing.js.map +1 -0
  87. package/dist/types.d.ts +269 -0
  88. package/dist/types.d.ts.map +1 -0
  89. package/package.json +58 -4
package/dist/_deck.js ADDED
@@ -0,0 +1,166 @@
1
+ import { MICRO_FADE as e, rampParam as t } from "./_ramp.js";
2
+ import { BardError as n } from "./errors.js";
3
+ // src/_deck.ts
4
+ function createDeck(r, i = {}) {
5
+ let a = i.bus ?? "music", o = i.fade ?? 2, s = null, c = [], l = -1, u = {}, d = 0, f = null, p = !1, m = !1, h = null, g = 0;
6
+ i.mediaSession && (f = r.mediaSession.claim({
7
+ onNextTrack: () => _.next(),
8
+ onPause: () => _.pause(),
9
+ onPlay: () => _.play(),
10
+ onPreviousTrack: () => _.previous(),
11
+ onStop: () => _.stop()
12
+ }));
13
+ let setSessionState = (e) => {
14
+ f?.setPlaybackState(e);
15
+ }, setSessionMeta = (e) => {
16
+ f && (e === null ? f.setMetadata(void 0, "") : f.setMetadata(r.loader.definitionOf(e)?.meta, e));
17
+ }, startSlot = (i, o, s) => {
18
+ let c = r.context(), l = r.buses().get(a), u = r.loader.definitionOf(i);
19
+ if (u?.stream) {
20
+ if (o.loopStart !== void 0 || o.loopEnd !== void 0) throw new n(`Streamed track "${i}" cannot use loopStart/loopEnd; streamed loops cover the whole file.`);
21
+ let e = r.streams.ensure(i, u), a = c.createGain();
22
+ e.source.connect(a), a.connect(l.input), s > 0 ? (a.gain.setValueAtTime(0, c.currentTime), a.gain.linearRampToValueAtTime(1, c.currentTime + s)) : a.gain.value = 1;
23
+ let d = e.element;
24
+ d.loop = o.loop ?? !1, o.offset !== void 0 && (d.currentTime = o.offset), d.play().catch(() => {});
25
+ let f = !1;
26
+ return {
27
+ key: i,
28
+ async nearlyOver(e) {
29
+ if (d.loop) return new Promise(() => {});
30
+ let t = d.duration;
31
+ if (Number.isFinite(t)) {
32
+ let n = Math.max(t - d.currentTime - e, 0) * 1e3;
33
+ await new Promise((e) => setTimeout(e, n));
34
+ } else await new Promise((t) => {
35
+ let onTime = () => {
36
+ let n = d.duration;
37
+ Number.isFinite(n) && n - d.currentTime <= e && (d.removeEventListener("timeupdate", onTime), t());
38
+ };
39
+ d.addEventListener("timeupdate", onTime), d.addEventListener("ended", () => {
40
+ d.removeEventListener("timeupdate", onTime), t();
41
+ }, { once: !0 });
42
+ });
43
+ },
44
+ pause() {
45
+ return d.pause(), d.currentTime;
46
+ },
47
+ stop(e, n) {
48
+ if (f) return;
49
+ f = !0;
50
+ let teardown = () => {
51
+ n || d.pause();
52
+ try {
53
+ a.disconnect();
54
+ } catch {}
55
+ };
56
+ e <= 0 ? (n || d.pause(), a.gain.value = 0, teardown()) : (t(a.gain, 0, e, c.currentTime), setTimeout(teardown, e * 1e3));
57
+ }
58
+ };
59
+ }
60
+ if (!r.loader.has(i)) throw new n(`Track "${i}" is not loaded.`);
61
+ let d = c.currentTime, f = r.pool.play(i, {
62
+ bus: a,
63
+ fadeIn: s > 0 ? s : void 0,
64
+ loop: o.loop,
65
+ loopEnd: o.loopEnd,
66
+ loopStart: o.loopStart,
67
+ offset: o.offset
68
+ }), p = !1;
69
+ return {
70
+ key: i,
71
+ async nearlyOver(e) {
72
+ if (o.loop) return new Promise(() => {});
73
+ let t = r.loader.get(i), n = t ? t.buffer.duration : Infinity, a = Math.max(n - (o.offset ?? 0) - e, 0) * 1e3;
74
+ await new Promise((e) => setTimeout(e, a));
75
+ },
76
+ pause() {
77
+ return p ? g : (p = !0, f.stop({ fade: e }), (o.offset ?? 0) + (c.currentTime - d));
78
+ },
79
+ stop(e) {
80
+ p || (p = !0, f.stop({ fade: e }));
81
+ }
82
+ };
83
+ }, beginTrack = (e, t) => {
84
+ let n = t.fade ?? o, i = s;
85
+ s = startSlot(e, t, n), m = !1, i && i.stop(n, i.key === e), r.onTrack(e), setSessionMeta(e), setSessionState("playing");
86
+ }, scheduleAdvance = (e) => {
87
+ let t = d, n = u.crossfade ?? o;
88
+ e.nearlyOver(n).then(() => {
89
+ p || t !== d || s !== e || advance(1);
90
+ });
91
+ }, advance = (e) => {
92
+ if (c.length === 0) return;
93
+ let t = l + e;
94
+ if (t >= c.length) {
95
+ if (!u.repeat) {
96
+ c = [];
97
+ return;
98
+ }
99
+ t = 0;
100
+ } else t < 0 && (t = u.repeat ? c.length - 1 : 0);
101
+ l = t;
102
+ let n = c[t];
103
+ n !== void 0 && (beginTrack(n, {
104
+ fade: u.crossfade ?? o,
105
+ loop: !1
106
+ }), s && scheduleAdvance(s));
107
+ }, _ = {
108
+ get current() {
109
+ return s?.key ?? null;
110
+ },
111
+ dispose() {
112
+ p || (p = !0, d += 1, s && s.stop(0), s = null, f?.release(), f = null);
113
+ },
114
+ get disposed() {
115
+ return p;
116
+ },
117
+ next() {
118
+ if (p) throw new n("The deck is disposed.");
119
+ c.length !== 0 && (d += 1, advance(1));
120
+ },
121
+ pause() {
122
+ p || !s || m || (d += 1, h = s.key, g = s.pause(), m = !0, setSessionState("paused"));
123
+ },
124
+ play() {
125
+ if (p || !m || h === null) return;
126
+ let t = h, n = g;
127
+ h = null, beginTrack(t, {
128
+ fade: e,
129
+ offset: n
130
+ }), c.length > 0 && s && scheduleAdvance(s);
131
+ },
132
+ get playing() {
133
+ return s !== null && !m;
134
+ },
135
+ previous() {
136
+ if (p) throw new n("The deck is disposed.");
137
+ c.length !== 0 && (d += 1, advance(-1));
138
+ },
139
+ queue(e, t = {}) {
140
+ if (p) throw new n("The deck is disposed.");
141
+ if (c = [...e], u = t, d += 1, t.shuffle) {
142
+ let e = t.random ?? Math.random, n = [...c];
143
+ for (let t = n.length - 1; t > 0; --t) {
144
+ let r = Math.min(Math.floor(e() * (t + 1)), t), i = n[t], a = n[r];
145
+ i !== void 0 && a !== void 0 && (n[t] = a, n[r] = i);
146
+ }
147
+ c = n;
148
+ }
149
+ l = -1, c.length > 0 && advance(1);
150
+ },
151
+ stop(e = {}) {
152
+ p || (c = [], l = -1, d += 1, s && s.stop(e.fade ?? o), s = null, m = !1, h = null, r.onTrack(null), setSessionMeta(null), setSessionState("none"));
153
+ },
154
+ transition(e, t = {}) {
155
+ if (p) throw new n("The deck is disposed.");
156
+ (e !== s?.key || m) && (c = [], l = -1, d += 1, beginTrack(e, t));
157
+ },
158
+ [Symbol.dispose]() {
159
+ _.dispose();
160
+ }
161
+ };
162
+ return _;
163
+ }
164
+ export { createDeck };
165
+
166
+ //# sourceMappingURL=_deck.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_deck.js","names":["busName","options","defaultFade","slot","queue","queueIndex","queueOptions","queueToken","session","disposed","paused","pausedKey","pausedOffset","deps","deck","state","key","ctx","bus","definition","transition","BardError","stream","gain","fadeIn","element","stopped","total","wait","crossfade","resolve","dur","keepElement","fade","rampParam","startedAt","handle","asset","MICRO_FADE","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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"}
@@ -0,0 +1,2 @@
1
+ const e=require("./errors.cjs");function normalizeDefinition(e){return typeof e==`string`?{src:e}:e}function createLoader(t){let n=new Map,r=new Map,i=new Map,a=new Set,fetchDecode=(n,r)=>{let a=i.get(n);if(a)return a;let o=(async()=>{let i=await fetch(n,{signal:r});if(!i.ok)throw new e.BardLoadError(`Fetching "${n}" failed with status ${i.status}.`,{cause:{status:i.status}});let a=await i.arrayBuffer();try{return await t.decodeAudioData(a)}catch(t){throw new e.BardLoadError(`Decoding "${n}" failed.`,{cause:t})}})();return i.set(n,o),o.catch(()=>i.delete(n)),o};return{definitionOf(e){return r.get(e)??n.get(e)?.definition},dispose(){for(let e of a)e.abort();a.clear(),n.clear(),r.clear(),i.clear()},get(e){return n.get(e)},has(e){return n.has(e)||r.get(e)?.stream===!0},keys(){return[...new Set([...n.keys(),...r.keys()])]},async load(t,i){let o=new AbortController;a.add(o);let onAbort=()=>o.abort();i?.signal&&(i.signal.aborted?o.abort(i.signal.reason):i.signal.addEventListener(`abort`,onAbort,{once:!0}));try{await Promise.all(Object.entries(t).map(async([t,i])=>{let a=normalizeDefinition(i);if(r.set(t,a),!(a.stream||n.has(t)))try{let e=await fetchDecode(a.src,o.signal);if(o.signal.aborted)return;n.set(t,{buffer:e,definition:a})}catch(n){throw n instanceof e.BardError?n:new e.BardLoadError(`Loading "${t}" failed.`,{cause:n})}}))}finally{i?.signal?.removeEventListener(`abort`,onAbort),a.delete(o)}},unload(e){let t=e===void 0?[...new Set([...n.keys(),...r.keys()])]:typeof e==`string`?[e]:[...e];for(let e of t)n.delete(e),r.delete(e);return t}}}function parseSpriteKey(e){let t=e.indexOf(`:`);return t<=0?null:{asset:e.slice(0,t),sprite:e.slice(t+1)}}function resolveSprite(t,n,r){let i=t.definition.sprites?.[n];if(!i)throw new e.BardError(`Asset "${t.definition.src}" has no sprite "${r}".`);let[a,o]=i;if(a<0||o<=0||a+o>t.buffer.duration+1e-6)throw new e.BardError(`Sprite "${r}" region [${a}, ${a+o}] exceeds the asset duration.`);return{duration:o,offset:a}}exports.createLoader=createLoader,exports.parseSpriteKey=parseSpriteKey,exports.resolveSprite=resolveSprite;
2
+ //# sourceMappingURL=_loader.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_loader.cjs","names":["BardLoadError","BardError","require_errors","entry","assets","definitions","inflight","controllers","existing","url","work","response","data","context","cause","key","controller","options","manifest","raw","definition","buffer","list","keys","index","region","asset","sprite","offset","duration"],"sources":["../src/_loader.ts"],"sourcesContent":["import { BardError, BardLoadError } from './errors';\nimport type { AssetDefinition, AssetManifest } from './types';\n\n/** A decoded asset: its buffer plus optional sprite regions. */\nexport interface LoadedAsset {\n readonly buffer: AudioBuffer;\n readonly definition: AssetDefinition;\n}\n\nexport interface Loader {\n /** The manifest definition for `key`, including streamed entries. */\n definitionOf(key: string): AssetDefinition | undefined;\n dispose(): void;\n get(key: string): LoadedAsset | undefined;\n has(key: string): boolean;\n /** Every loaded key. */\n keys(): readonly string[];\n /** Decodes every manifest entry; concurrent loads of the same URL share one fetch. */\n load(manifest: AssetManifest, options?: { readonly signal?: AbortSignal }): Promise<void>;\n /** Drops assets (all when omitted); returns the dropped keys. */\n unload(keys?: string | readonly string[]): string[];\n}\n\nfunction normalizeDefinition(entry: string | AssetDefinition): AssetDefinition {\n return typeof entry === 'string' ? { src: entry } : entry;\n}\n\n/**\n * Fetch + `decodeAudioData` cache with per-URL deduplication and abort\n * support. Streamed assets are skipped here; `_stream.ts` owns them.\n */\nexport function createLoader(context: AudioContext): Loader {\n const assets = new Map<string, LoadedAsset>();\n /** Every manifest definition, including streamed entries that never decode. */\n const definitions = new Map<string, AssetDefinition>();\n /** In-flight fetch+decode per URL, shared across keys and calls. */\n const inflight = new Map<string, Promise<AudioBuffer>>();\n const controllers = new Set<AbortController>();\n\n const fetchDecode = (url: string, signal: AbortSignal): Promise<AudioBuffer> => {\n const existing = inflight.get(url);\n if (existing) return existing;\n const work = (async (): Promise<AudioBuffer> => {\n const response = await fetch(url, { signal });\n if (!response.ok) {\n throw new BardLoadError(`Fetching \"${url}\" failed with status ${response.status}.`, {\n cause: { status: response.status },\n });\n }\n const data = await response.arrayBuffer();\n try {\n return await context.decodeAudioData(data);\n } catch (cause) {\n throw new BardLoadError(`Decoding \"${url}\" failed.`, { cause });\n }\n })();\n inflight.set(url, work);\n // A failed shared fetch must not poison later loads of the same URL.\n work.catch(() => inflight.delete(url));\n return work;\n };\n\n return {\n definitionOf(key): AssetDefinition | undefined {\n return definitions.get(key) ?? assets.get(key)?.definition;\n },\n dispose(): void {\n for (const controller of controllers) controller.abort();\n controllers.clear();\n assets.clear();\n definitions.clear();\n inflight.clear();\n },\n get(key): LoadedAsset | undefined {\n return assets.get(key);\n },\n has(key): boolean {\n return assets.has(key) || definitions.get(key)?.stream === true;\n },\n keys(): readonly string[] {\n return [...new Set([...assets.keys(), ...definitions.keys()])];\n },\n async load(manifest, options): Promise<void> {\n const controller = new AbortController();\n controllers.add(controller);\n const onAbort = (): void => controller.abort();\n if (options?.signal) {\n if (options.signal.aborted) {\n controller.abort(options.signal.reason);\n } else {\n options.signal.addEventListener('abort', onAbort, { once: true });\n }\n }\n try {\n await Promise.all(\n Object.entries(manifest).map(async ([key, raw]) => {\n const definition = normalizeDefinition(raw);\n definitions.set(key, definition);\n if (definition.stream || assets.has(key)) return;\n try {\n const buffer = await fetchDecode(definition.src, controller.signal);\n if (controller.signal.aborted) return;\n assets.set(key, { buffer, definition });\n } catch (cause) {\n if (cause instanceof BardError) throw cause;\n throw new BardLoadError(`Loading \"${key}\" failed.`, { cause });\n }\n }),\n );\n } finally {\n options?.signal?.removeEventListener('abort', onAbort);\n controllers.delete(controller);\n }\n },\n unload(keys): string[] {\n const list =\n keys === undefined\n ? [...new Set([...assets.keys(), ...definitions.keys()])]\n : typeof keys === 'string'\n ? [keys]\n : [...keys];\n for (const key of list) {\n assets.delete(key);\n definitions.delete(key);\n }\n return list;\n },\n };\n}\n\n/** Parses a `'key:sprite'` reference into its parts; returns `null` for plain keys. */\nexport function parseSpriteKey(key: string): { asset: string; sprite: string } | null {\n const index = key.indexOf(':');\n if (index <= 0) return null;\n return { asset: key.slice(0, index), sprite: key.slice(index + 1) };\n}\n\n/** Validates a sprite region against its buffer; throws `BardError` when out of bounds. */\nexport function resolveSprite(asset: LoadedAsset, sprite: string, key: string): { offset: number; duration: number } {\n const region = asset.definition.sprites?.[sprite];\n if (!region) throw new BardError(`Asset \"${asset.definition.src}\" has no sprite \"${key}\".`);\n const [offset, duration] = region;\n if (offset < 0 || duration <= 0 || offset + duration > asset.buffer.duration + 1e-6) {\n throw new BardError(`Sprite \"${key}\" region [${offset}, ${offset + duration}] exceeds the asset duration.`);\n }\n return { duration, offset };\n}\n"],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import type { AssetDefinition, AssetManifest } from './types';
2
+ /** A decoded asset: its buffer plus optional sprite regions. */
3
+ export interface LoadedAsset {
4
+ readonly buffer: AudioBuffer;
5
+ readonly definition: AssetDefinition;
6
+ }
7
+ export interface Loader {
8
+ /** The manifest definition for `key`, including streamed entries. */
9
+ definitionOf(key: string): AssetDefinition | undefined;
10
+ dispose(): void;
11
+ get(key: string): LoadedAsset | undefined;
12
+ has(key: string): boolean;
13
+ /** Every loaded key. */
14
+ keys(): readonly string[];
15
+ /** Decodes every manifest entry; concurrent loads of the same URL share one fetch. */
16
+ load(manifest: AssetManifest, options?: {
17
+ readonly signal?: AbortSignal;
18
+ }): Promise<void>;
19
+ /** Drops assets (all when omitted); returns the dropped keys. */
20
+ unload(keys?: string | readonly string[]): string[];
21
+ }
22
+ /**
23
+ * Fetch + `decodeAudioData` cache with per-URL deduplication and abort
24
+ * support. Streamed assets are skipped here; `_stream.ts` owns them.
25
+ */
26
+ export declare function createLoader(context: AudioContext): Loader;
27
+ /** Parses a `'key:sprite'` reference into its parts; returns `null` for plain keys. */
28
+ export declare function parseSpriteKey(key: string): {
29
+ asset: string;
30
+ sprite: string;
31
+ } | null;
32
+ /** Validates a sprite region against its buffer; throws `BardError` when out of bounds. */
33
+ export declare function resolveSprite(asset: LoadedAsset, sprite: string, key: string): {
34
+ offset: number;
35
+ duration: number;
36
+ };
37
+ //# sourceMappingURL=_loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_loader.d.ts","sourceRoot":"","sources":["../src/_loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE9D,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,MAAM;IACrB,qEAAqE;IACrE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACvD,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,wBAAwB;IACxB,IAAI,IAAI,SAAS,MAAM,EAAE,CAAC;IAC1B,sFAAsF;IACtF,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,iEAAiE;IACjE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;CACrD;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAiG1D;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIpF;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAQnH"}
@@ -0,0 +1,88 @@
1
+ import { BardError as e, BardLoadError as t } from "./errors.js";
2
+ // src/_loader.ts
3
+ function normalizeDefinition(e) {
4
+ return typeof e == "string" ? { src: e } : e;
5
+ }
6
+ function createLoader(n) {
7
+ let r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Set(), fetchDecode = (e, r) => {
8
+ let i = a.get(e);
9
+ if (i) return i;
10
+ let o = (async () => {
11
+ let i = await fetch(e, { signal: r });
12
+ if (!i.ok) throw new t(`Fetching "${e}" failed with status ${i.status}.`, { cause: { status: i.status } });
13
+ let a = await i.arrayBuffer();
14
+ try {
15
+ return await n.decodeAudioData(a);
16
+ } catch (n) {
17
+ throw new t(`Decoding "${e}" failed.`, { cause: n });
18
+ }
19
+ })();
20
+ return a.set(e, o), o.catch(() => a.delete(e)), o;
21
+ };
22
+ return {
23
+ definitionOf(e) {
24
+ return i.get(e) ?? r.get(e)?.definition;
25
+ },
26
+ dispose() {
27
+ for (let e of o) e.abort();
28
+ o.clear(), r.clear(), i.clear(), a.clear();
29
+ },
30
+ get(e) {
31
+ return r.get(e);
32
+ },
33
+ has(e) {
34
+ return r.has(e) || i.get(e)?.stream === !0;
35
+ },
36
+ keys() {
37
+ return [.../* @__PURE__ */ new Set([...r.keys(), ...i.keys()])];
38
+ },
39
+ async load(n, a) {
40
+ let s = new AbortController();
41
+ o.add(s);
42
+ let onAbort = () => s.abort();
43
+ a?.signal && (a.signal.aborted ? s.abort(a.signal.reason) : a.signal.addEventListener("abort", onAbort, { once: !0 }));
44
+ try {
45
+ await Promise.all(Object.entries(n).map(async ([n, a]) => {
46
+ let o = normalizeDefinition(a);
47
+ if (i.set(n, o), !(o.stream || r.has(n))) try {
48
+ let e = await fetchDecode(o.src, s.signal);
49
+ if (s.signal.aborted) return;
50
+ r.set(n, {
51
+ buffer: e,
52
+ definition: o
53
+ });
54
+ } catch (r) {
55
+ throw r instanceof e ? r : new t(`Loading "${n}" failed.`, { cause: r });
56
+ }
57
+ }));
58
+ } finally {
59
+ a?.signal?.removeEventListener("abort", onAbort), o.delete(s);
60
+ }
61
+ },
62
+ unload(e) {
63
+ let t = e === void 0 ? [.../* @__PURE__ */ new Set([...r.keys(), ...i.keys()])] : typeof e == "string" ? [e] : [...e];
64
+ for (let e of t) r.delete(e), i.delete(e);
65
+ return t;
66
+ }
67
+ };
68
+ }
69
+ function parseSpriteKey(e) {
70
+ let t = e.indexOf(":");
71
+ return t <= 0 ? null : {
72
+ asset: e.slice(0, t),
73
+ sprite: e.slice(t + 1)
74
+ };
75
+ }
76
+ function resolveSprite(t, n, r) {
77
+ let i = t.definition.sprites?.[n];
78
+ if (!i) throw new e(`Asset "${t.definition.src}" has no sprite "${r}".`);
79
+ let [a, o] = i;
80
+ if (a < 0 || o <= 0 || a + o > t.buffer.duration + 1e-6) throw new e(`Sprite "${r}" region [${a}, ${a + o}] exceeds the asset duration.`);
81
+ return {
82
+ duration: o,
83
+ offset: a
84
+ };
85
+ }
86
+ export { createLoader, parseSpriteKey, resolveSprite };
87
+
88
+ //# sourceMappingURL=_loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_loader.js","names":["entry","assets","definitions","inflight","controllers","existing","url","work","response","BardLoadError","data","context","cause","key","controller","options","manifest","raw","definition","buffer","BardError","list","keys","index","region","asset","sprite","offset","duration"],"sources":["../src/_loader.ts"],"sourcesContent":["import { BardError, BardLoadError } from './errors';\nimport type { AssetDefinition, AssetManifest } from './types';\n\n/** A decoded asset: its buffer plus optional sprite regions. */\nexport interface LoadedAsset {\n readonly buffer: AudioBuffer;\n readonly definition: AssetDefinition;\n}\n\nexport interface Loader {\n /** The manifest definition for `key`, including streamed entries. */\n definitionOf(key: string): AssetDefinition | undefined;\n dispose(): void;\n get(key: string): LoadedAsset | undefined;\n has(key: string): boolean;\n /** Every loaded key. */\n keys(): readonly string[];\n /** Decodes every manifest entry; concurrent loads of the same URL share one fetch. */\n load(manifest: AssetManifest, options?: { readonly signal?: AbortSignal }): Promise<void>;\n /** Drops assets (all when omitted); returns the dropped keys. */\n unload(keys?: string | readonly string[]): string[];\n}\n\nfunction normalizeDefinition(entry: string | AssetDefinition): AssetDefinition {\n return typeof entry === 'string' ? { src: entry } : entry;\n}\n\n/**\n * Fetch + `decodeAudioData` cache with per-URL deduplication and abort\n * support. Streamed assets are skipped here; `_stream.ts` owns them.\n */\nexport function createLoader(context: AudioContext): Loader {\n const assets = new Map<string, LoadedAsset>();\n /** Every manifest definition, including streamed entries that never decode. */\n const definitions = new Map<string, AssetDefinition>();\n /** In-flight fetch+decode per URL, shared across keys and calls. */\n const inflight = new Map<string, Promise<AudioBuffer>>();\n const controllers = new Set<AbortController>();\n\n const fetchDecode = (url: string, signal: AbortSignal): Promise<AudioBuffer> => {\n const existing = inflight.get(url);\n if (existing) return existing;\n const work = (async (): Promise<AudioBuffer> => {\n const response = await fetch(url, { signal });\n if (!response.ok) {\n throw new BardLoadError(`Fetching \"${url}\" failed with status ${response.status}.`, {\n cause: { status: response.status },\n });\n }\n const data = await response.arrayBuffer();\n try {\n return await context.decodeAudioData(data);\n } catch (cause) {\n throw new BardLoadError(`Decoding \"${url}\" failed.`, { cause });\n }\n })();\n inflight.set(url, work);\n // A failed shared fetch must not poison later loads of the same URL.\n work.catch(() => inflight.delete(url));\n return work;\n };\n\n return {\n definitionOf(key): AssetDefinition | undefined {\n return definitions.get(key) ?? assets.get(key)?.definition;\n },\n dispose(): void {\n for (const controller of controllers) controller.abort();\n controllers.clear();\n assets.clear();\n definitions.clear();\n inflight.clear();\n },\n get(key): LoadedAsset | undefined {\n return assets.get(key);\n },\n has(key): boolean {\n return assets.has(key) || definitions.get(key)?.stream === true;\n },\n keys(): readonly string[] {\n return [...new Set([...assets.keys(), ...definitions.keys()])];\n },\n async load(manifest, options): Promise<void> {\n const controller = new AbortController();\n controllers.add(controller);\n const onAbort = (): void => controller.abort();\n if (options?.signal) {\n if (options.signal.aborted) {\n controller.abort(options.signal.reason);\n } else {\n options.signal.addEventListener('abort', onAbort, { once: true });\n }\n }\n try {\n await Promise.all(\n Object.entries(manifest).map(async ([key, raw]) => {\n const definition = normalizeDefinition(raw);\n definitions.set(key, definition);\n if (definition.stream || assets.has(key)) return;\n try {\n const buffer = await fetchDecode(definition.src, controller.signal);\n if (controller.signal.aborted) return;\n assets.set(key, { buffer, definition });\n } catch (cause) {\n if (cause instanceof BardError) throw cause;\n throw new BardLoadError(`Loading \"${key}\" failed.`, { cause });\n }\n }),\n );\n } finally {\n options?.signal?.removeEventListener('abort', onAbort);\n controllers.delete(controller);\n }\n },\n unload(keys): string[] {\n const list =\n keys === undefined\n ? [...new Set([...assets.keys(), ...definitions.keys()])]\n : typeof keys === 'string'\n ? [keys]\n : [...keys];\n for (const key of list) {\n assets.delete(key);\n definitions.delete(key);\n }\n return list;\n },\n };\n}\n\n/** Parses a `'key:sprite'` reference into its parts; returns `null` for plain keys. */\nexport function parseSpriteKey(key: string): { asset: string; sprite: string } | null {\n const index = key.indexOf(':');\n if (index <= 0) return null;\n return { asset: key.slice(0, index), sprite: key.slice(index + 1) };\n}\n\n/** Validates a sprite region against its buffer; throws `BardError` when out of bounds. */\nexport function resolveSprite(asset: LoadedAsset, sprite: string, key: string): { offset: number; duration: number } {\n const region = asset.definition.sprites?.[sprite];\n if (!region) throw new BardError(`Asset \"${asset.definition.src}\" has no sprite \"${key}\".`);\n const [offset, duration] = region;\n if (offset < 0 || duration <= 0 || offset + duration > asset.buffer.duration + 1e-6) {\n throw new BardError(`Sprite \"${key}\" region [${offset}, ${offset + duration}] exceeds the asset duration.`);\n }\n return { duration, offset };\n}\n"],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ const e=require("./errors.cjs");function createMediaSession(){let t=!1;return{claim(n){if(t)throw new e.BardError(`Another deck already owns navigator.mediaSession.`);let r=typeof navigator>`u`?void 0:navigator.mediaSession;if(!r)throw new e.BardError(`This runtime does not provide navigator.mediaSession.`);t=!0;let i=[[`play`,n.onPlay],[`pause`,n.onPause],[`stop`,n.onStop],[`nexttrack`,n.onNextTrack],[`previoustrack`,n.onPreviousTrack]];for(let[e,t]of i)try{r.setActionHandler(e,t)}catch{}return{release(){for(let[e]of i)try{r.setActionHandler(e,null)}catch{}r.metadata=null,t=!1},setMetadata(e,t){e?r.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}):r.metadata=null},setPlaybackState(e){try{r.playbackState=e}catch{}}}}}}exports.createMediaSession=createMediaSession;
2
+ //# sourceMappingURL=_media-session.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_media-session.cjs","names":["BardError","require_errors","claimed","session","bindings","handlers","action","handler","meta","image","key","state"],"sources":["../src/_media-session.ts"],"sourcesContent":["import { BardError } from './errors';\nimport type { AssetMeta } from './types';\n\nexport interface MediaSessionOwner {\n release(): void;\n setMetadata(meta: AssetMeta | undefined, key: string): void;\n setPlaybackState(state: MediaSessionPlaybackState): void;\n}\n\nexport interface MediaSessionManager {\n /** Claims the page-global `navigator.mediaSession`; a second owner throws. */\n claim(handlers: {\n onPlay(): void;\n onPause(): void;\n onStop(): void;\n onNextTrack(): void;\n onPreviousTrack(): void;\n }): MediaSessionOwner;\n}\n\ntype SessionAction = 'play' | 'pause' | 'stop' | 'nexttrack' | 'previoustrack';\n\n/**\n * `navigator.mediaSession` is a page-global singleton, so bard treats it as a\n * claimable resource: at most one deck may own it, and claiming twice throws\n * instead of silently stealing hardware controls from the first owner.\n */\nexport function createMediaSession(): MediaSessionManager {\n let claimed = false;\n return {\n claim(handlers) {\n if (claimed) throw new BardError('Another deck already owns navigator.mediaSession.');\n const session = typeof navigator === 'undefined' ? undefined : navigator.mediaSession;\n if (!session) throw new BardError('This runtime does not provide navigator.mediaSession.');\n claimed = true;\n const bindings: ReadonlyArray<readonly [SessionAction, () => void]> = [\n ['play', handlers.onPlay],\n ['pause', handlers.onPause],\n ['stop', handlers.onStop],\n ['nexttrack', handlers.onNextTrack],\n ['previoustrack', handlers.onPreviousTrack],\n ];\n for (const [action, handler] of bindings) {\n try {\n session.setActionHandler(action, handler);\n } catch {\n // Unsupported action on this platform.\n }\n }\n return {\n release(): void {\n for (const [action] of bindings) {\n try {\n session.setActionHandler(action, null);\n } catch {\n // Already cleared.\n }\n }\n session.metadata = null;\n claimed = false;\n },\n setMetadata(meta, key): void {\n if (!meta) {\n session.metadata = null;\n return;\n }\n session.metadata = new MediaMetadata({\n album: meta.album ?? '',\n artist: meta.artist ?? '',\n artwork: (meta.artwork ?? []).map((image) => ({\n sizes: image.sizes ?? '',\n src: image.src,\n type: image.type ?? '',\n })),\n title: meta.title ?? key,\n });\n },\n setPlaybackState(state): void {\n try {\n session.playbackState = state;\n } catch {\n // Read-only on some platforms.\n }\n },\n };\n },\n };\n}\n"],"mappings":"A,gCA2BA,SAAgB,oBAA0C,CACxD,IAAIE,EAAU,GACd,MAAO,CACL,MAAM,EAAU,CACd,GAAIA,EAAS,MAAM,IAAIF,EAAAA,UAAU,mDAAmD,EACpF,IAAMG,EAAU,OAAO,UAAc,IAAc,IAAA,GAAY,UAAU,aACzE,GAAI,CAACA,EAAS,MAAM,IAAIH,EAAAA,UAAU,uDAAuD,EACzF,EAAU,GACV,IAAMI,EAAgE,CACpE,CAAC,OAAQC,EAAS,MAAM,EACxB,CAAC,QAASA,EAAS,OAAO,EAC1B,CAAC,OAAQA,EAAS,MAAM,EACxB,CAAC,YAAaA,EAAS,WAAW,EAClC,CAAC,gBAAiBA,EAAS,eAAe,CAC5C,EACA,IAAK,GAAM,CAACC,EAAQC,KAAYH,EAC9B,GAAI,CACFD,EAAQ,iBAAiBG,EAAQC,CAAO,CAC1C,MAAQ,CAER,CAEF,MAAO,CACL,SAAgB,CACd,IAAK,GAAM,CAACD,KAAWF,EACrB,GAAI,CACFD,EAAQ,iBAAiBG,EAAQ,IAAI,CACvC,MAAQ,CAER,CAEF,EAAQ,SAAW,KACnB,EAAU,EACZ,EACA,YAAY,EAAM,EAAW,CACtBE,EAIL,EAAQ,SAAW,IAAI,cAAc,CACnC,MAAOA,EAAK,OAAS,GACrB,OAAQA,EAAK,QAAU,GACvB,SAAUA,EAAK,SAAW,CAAC,EAAA,CAAG,IAAK,IAAW,CAC5C,MAAOC,EAAM,OAAS,GACtB,IAAKA,EAAM,IACX,KAAMA,EAAM,MAAQ,EACtB,EAAE,EACF,MAAOD,EAAK,OAASE,CACvB,CAAC,EAZC,EAAQ,SAAW,IAavB,EACA,iBAAiB,EAAa,CAC5B,GAAI,CACF,EAAQ,cAAgBC,CAC1B,MAAQ,CAER,CACF,CACF,CACF,CACF,CACF,C"}
@@ -0,0 +1,23 @@
1
+ import type { AssetMeta } from './types';
2
+ export interface MediaSessionOwner {
3
+ release(): void;
4
+ setMetadata(meta: AssetMeta | undefined, key: string): void;
5
+ setPlaybackState(state: MediaSessionPlaybackState): void;
6
+ }
7
+ export interface MediaSessionManager {
8
+ /** Claims the page-global `navigator.mediaSession`; a second owner throws. */
9
+ claim(handlers: {
10
+ onPlay(): void;
11
+ onPause(): void;
12
+ onStop(): void;
13
+ onNextTrack(): void;
14
+ onPreviousTrack(): void;
15
+ }): MediaSessionOwner;
16
+ }
17
+ /**
18
+ * `navigator.mediaSession` is a page-global singleton, so bard treats it as a
19
+ * claimable resource: at most one deck may own it, and claiming twice throws
20
+ * instead of silently stealing hardware controls from the first owner.
21
+ */
22
+ export declare function createMediaSession(): MediaSessionManager;
23
+ //# sourceMappingURL=_media-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_media-session.d.ts","sourceRoot":"","sources":["../src/_media-session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,OAAO,IAAI,IAAI,CAAC;IAChB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,gBAAgB,CAAC,KAAK,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,KAAK,CAAC,QAAQ,EAAE;QACd,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,IAAI,IAAI,CAAC;QAChB,MAAM,IAAI,IAAI,CAAC;QACf,WAAW,IAAI,IAAI,CAAC;QACpB,eAAe,IAAI,IAAI,CAAC;KACzB,GAAG,iBAAiB,CAAC;CACvB;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,CA4DxD"}
@@ -0,0 +1,49 @@
1
+ import { BardError as e } from "./errors.js";
2
+ // src/_media-session.ts
3
+ function createMediaSession() {
4
+ let t = !1;
5
+ return { claim(n) {
6
+ if (t) throw new e("Another deck already owns navigator.mediaSession.");
7
+ let r = typeof navigator > "u" ? void 0 : navigator.mediaSession;
8
+ if (!r) throw new e("This runtime does not provide navigator.mediaSession.");
9
+ t = !0;
10
+ let i = [
11
+ ["play", n.onPlay],
12
+ ["pause", n.onPause],
13
+ ["stop", n.onStop],
14
+ ["nexttrack", n.onNextTrack],
15
+ ["previoustrack", n.onPreviousTrack]
16
+ ];
17
+ for (let [e, t] of i) try {
18
+ r.setActionHandler(e, t);
19
+ } catch {}
20
+ return {
21
+ release() {
22
+ for (let [e] of i) try {
23
+ r.setActionHandler(e, null);
24
+ } catch {}
25
+ r.metadata = null, t = !1;
26
+ },
27
+ setMetadata(e, t) {
28
+ e ? r.metadata = new MediaMetadata({
29
+ album: e.album ?? "",
30
+ artist: e.artist ?? "",
31
+ artwork: (e.artwork ?? []).map((e) => ({
32
+ sizes: e.sizes ?? "",
33
+ src: e.src,
34
+ type: e.type ?? ""
35
+ })),
36
+ title: e.title ?? t
37
+ }) : r.metadata = null;
38
+ },
39
+ setPlaybackState(e) {
40
+ try {
41
+ r.playbackState = e;
42
+ } catch {}
43
+ }
44
+ };
45
+ } };
46
+ }
47
+ export { createMediaSession };
48
+
49
+ //# sourceMappingURL=_media-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_media-session.js","names":["claimed","BardError","session","bindings","handlers","action","handler","meta","image","key","state"],"sources":["../src/_media-session.ts"],"sourcesContent":["import { BardError } from './errors';\nimport type { AssetMeta } from './types';\n\nexport interface MediaSessionOwner {\n release(): void;\n setMetadata(meta: AssetMeta | undefined, key: string): void;\n setPlaybackState(state: MediaSessionPlaybackState): void;\n}\n\nexport interface MediaSessionManager {\n /** Claims the page-global `navigator.mediaSession`; a second owner throws. */\n claim(handlers: {\n onPlay(): void;\n onPause(): void;\n onStop(): void;\n onNextTrack(): void;\n onPreviousTrack(): void;\n }): MediaSessionOwner;\n}\n\ntype SessionAction = 'play' | 'pause' | 'stop' | 'nexttrack' | 'previoustrack';\n\n/**\n * `navigator.mediaSession` is a page-global singleton, so bard treats it as a\n * claimable resource: at most one deck may own it, and claiming twice throws\n * instead of silently stealing hardware controls from the first owner.\n */\nexport function createMediaSession(): MediaSessionManager {\n let claimed = false;\n return {\n claim(handlers) {\n if (claimed) throw new BardError('Another deck already owns navigator.mediaSession.');\n const session = typeof navigator === 'undefined' ? undefined : navigator.mediaSession;\n if (!session) throw new BardError('This runtime does not provide navigator.mediaSession.');\n claimed = true;\n const bindings: ReadonlyArray<readonly [SessionAction, () => void]> = [\n ['play', handlers.onPlay],\n ['pause', handlers.onPause],\n ['stop', handlers.onStop],\n ['nexttrack', handlers.onNextTrack],\n ['previoustrack', handlers.onPreviousTrack],\n ];\n for (const [action, handler] of bindings) {\n try {\n session.setActionHandler(action, handler);\n } catch {\n // Unsupported action on this platform.\n }\n }\n return {\n release(): void {\n for (const [action] of bindings) {\n try {\n session.setActionHandler(action, null);\n } catch {\n // Already cleared.\n }\n }\n session.metadata = null;\n claimed = false;\n },\n setMetadata(meta, key): void {\n if (!meta) {\n session.metadata = null;\n return;\n }\n session.metadata = new MediaMetadata({\n album: meta.album ?? '',\n artist: meta.artist ?? '',\n artwork: (meta.artwork ?? []).map((image) => ({\n sizes: image.sizes ?? '',\n src: image.src,\n type: image.type ?? '',\n })),\n title: meta.title ?? key,\n });\n },\n setPlaybackState(state): void {\n try {\n session.playbackState = state;\n } catch {\n // Read-only on some platforms.\n }\n },\n };\n },\n };\n}\n"],"mappings":";;AA2BA,SAAgB,qBAA0C;CACxD,IAAIA,IAAU;CACd,OAAO,EACL,MAAM,GAAU;EACd,IAAIA,GAAS,MAAM,IAAIC,EAAU,mDAAmD;EACpF,IAAMC,IAAU,OAAO,YAAc,MAAc,KAAA,IAAY,UAAU;EACzE,IAAI,CAACA,GAAS,MAAM,IAAID,EAAU,uDAAuD;EACzF,IAAU;EACV,IAAME,IAAgE;GACpE,CAAC,QAAQC,EAAS,MAAM;GACxB,CAAC,SAASA,EAAS,OAAO;GAC1B,CAAC,QAAQA,EAAS,MAAM;GACxB,CAAC,aAAaA,EAAS,WAAW;GAClC,CAAC,iBAAiBA,EAAS,eAAe;EAC5C;EACA,KAAK,IAAM,CAACC,GAAQC,MAAYH,GAC9B,IAAI;GACF,EAAQ,iBAAiBE,GAAQC,CAAO;EAC1C,QAAQ,CAER;EAEF,OAAO;GACL,UAAgB;IACd,KAAK,IAAM,CAACD,MAAWF,GACrB,IAAI;KACF,EAAQ,iBAAiBE,GAAQ,IAAI;IACvC,QAAQ,CAER;IAGF,AADA,EAAQ,WAAW,MACnB,IAAU;GACZ;GACA,YAAY,GAAM,GAAW;IAC3B,AAAKE,IAIL,EAAQ,WAAW,IAAI,cAAc;KACnC,OAAOA,EAAK,SAAS;KACrB,QAAQA,EAAK,UAAU;KACvB,UAAUA,EAAK,WAAW,CAAC,EAAA,CAAG,KAAK,OAAW;MAC5C,OAAOC,EAAM,SAAS;MACtB,KAAKA,EAAM;MACX,MAAMA,EAAM,QAAQ;KACtB,EAAE;KACF,OAAOD,EAAK,SAASE;IACvB,CAAC,IAZC,EAAQ,WAAW;GAavB;GACA,iBAAiB,GAAa;IAC5B,IAAI;KACF,EAAQ,gBAAgBC;IAC1B,QAAQ,CAER;GACF;EACF;CACF,EACF;AACF"}
package/dist/_ramp.cjs ADDED
@@ -0,0 +1,2 @@
1
+ var e=1e-4,t=.015,n=.2,r=.8;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)}exports.DEFAULT_ATTACK=n,exports.DEFAULT_RELEASE=r,exports.MICRO_FADE=t,exports.MIN_GAIN=e,exports.expRampTo=expRampTo,exports.rampParam=rampParam,exports.sampleRange=sampleRange;
2
+ //# sourceMappingURL=_ramp.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_ramp.cjs","names":["MIN_GAIN","MICRO_FADE","DEFAULT_ATTACK","DEFAULT_RELEASE","from","param","now","seconds","target","value","min","max","random"],"sources":["../src/_ramp.ts"],"sourcesContent":["/** Shared ramp and sampling helpers. */\n\n/** Smallest gain an exponential ramp may target; 0 throws a `RangeError`. */\nexport const MIN_GAIN = 1e-4;\n\n/** Micro-fade seconds that removes clicks without an audible dip. */\nexport const MICRO_FADE = 0.015;\n\n/** Default ducking attack seconds. */\nexport const DEFAULT_ATTACK = 0.2;\n\n/** Default ducking release seconds. */\nexport const DEFAULT_RELEASE = 0.8;\n\n/**\n * Ramps a gain-like param to `target` over `seconds` using a linear ramp from\n * its current value. Never assigns `param.value` directly while scheduled\n * automation exists, which is what produces clicks.\n */\nexport function rampParam(param: AudioParam, target: number, seconds: number, now: number): void {\n const from = param.value;\n param.cancelScheduledValues(now);\n param.setValueAtTime(from, now);\n if (seconds <= 0 || from === target) {\n param.setValueAtTime(target, now);\n return;\n }\n param.linearRampToValueAtTime(target, now + seconds);\n}\n\n/** Exponentially sweeps a frequency-like param, clamped away from zero. */\nexport function expRampTo(param: AudioParam, target: number, seconds: number, now: number): void {\n const from = Math.max(param.value, MIN_GAIN);\n param.cancelScheduledValues(now);\n param.setValueAtTime(from, now);\n param.exponentialRampToValueAtTime(Math.max(target, MIN_GAIN), now + seconds);\n}\n\n/** Resolves a scalar-or-range option to one sample. */\nexport function sampleRange(\n value: number | readonly [min: number, max: number] | undefined,\n random: () => number,\n): number | undefined {\n if (value === undefined) return undefined;\n if (typeof value === 'number') return value;\n const [min, max] = value;\n return min + (max - min) * Math.min(Math.max(random(), 0), 1);\n}\n"],"mappings":"AAGA,IAAaA,EAAW,KAGXC,EAAa,KAGbC,EAAiB,GAGjBC,EAAkB,GAO/B,SAAgB,UAAU,EAAmB,EAAgB,EAAiB,EAAmB,CAC/F,IAAMC,EAAOC,EAAM,MACnBA,EAAM,sBAAsBC,CAAG,EAC/BD,EAAM,eAAeD,EAAME,CAAG,EAC1BC,GAAW,GAAKH,IAASI,EAC3BH,EAAM,eAAeG,EAAQF,CAAG,EAGlCD,EAAM,wBAAwBG,EAAQF,EAAMC,CAAO,CACrD,CAGA,SAAgB,UAAU,EAAmB,EAAgB,EAAiB,EAAmB,CAC/F,IAAMH,EAAO,KAAK,IAAIC,EAAM,MAAOL,CAAQ,EAC3CK,EAAM,sBAAsBC,CAAG,EAC/BD,EAAM,eAAeD,EAAME,CAAG,EAC9BD,EAAM,6BAA6B,KAAK,IAAIG,EAAQR,CAAQ,EAAGM,EAAMC,CAAO,CAC9E,CAGA,SAAgB,YACd,EACA,EACoB,CACpB,GAAIE,IAAU,IAAA,GAAW,OACzB,GAAI,OAAOA,GAAU,SAAU,OAAOA,EACtC,GAAM,CAACC,EAAKC,GAAOF,EACnB,OAAOC,GAAOC,EAAMD,GAAO,KAAK,IAAI,KAAK,IAAIE,EAAO,EAAG,CAAC,EAAG,CAAC,CAC9D,C"}
@@ -0,0 +1,20 @@
1
+ /** Shared ramp and sampling helpers. */
2
+ /** Smallest gain an exponential ramp may target; 0 throws a `RangeError`. */
3
+ export declare const MIN_GAIN = 0.0001;
4
+ /** Micro-fade seconds that removes clicks without an audible dip. */
5
+ export declare const MICRO_FADE = 0.015;
6
+ /** Default ducking attack seconds. */
7
+ export declare const DEFAULT_ATTACK = 0.2;
8
+ /** Default ducking release seconds. */
9
+ export declare const DEFAULT_RELEASE = 0.8;
10
+ /**
11
+ * Ramps a gain-like param to `target` over `seconds` using a linear ramp from
12
+ * its current value. Never assigns `param.value` directly while scheduled
13
+ * automation exists, which is what produces clicks.
14
+ */
15
+ export declare function rampParam(param: AudioParam, target: number, seconds: number, now: number): void;
16
+ /** Exponentially sweeps a frequency-like param, clamped away from zero. */
17
+ export declare function expRampTo(param: AudioParam, target: number, seconds: number, now: number): void;
18
+ /** Resolves a scalar-or-range option to one sample. */
19
+ export declare function sampleRange(value: number | readonly [min: number, max: number] | undefined, random: () => number): number | undefined;
20
+ //# sourceMappingURL=_ramp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_ramp.d.ts","sourceRoot":"","sources":["../src/_ramp.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,6EAA6E;AAC7E,eAAO,MAAM,QAAQ,SAAO,CAAC;AAE7B,qEAAqE;AACrE,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,sCAAsC;AACtC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,uCAAuC;AACvC,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAS/F;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAK/F;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,SAAS,EAC/D,MAAM,EAAE,MAAM,MAAM,GACnB,MAAM,GAAG,SAAS,CAKpB"}
package/dist/_ramp.js ADDED
@@ -0,0 +1,19 @@
1
+ // src/_ramp.ts
2
+ var e = 1e-4, t = .015, n = .2, r = .8;
3
+ function rampParam(e, t, n, r) {
4
+ let i = e.value;
5
+ e.cancelScheduledValues(r), e.setValueAtTime(i, r), n <= 0 || i === t ? e.setValueAtTime(t, r) : e.linearRampToValueAtTime(t, r + n);
6
+ }
7
+ function expRampTo(t, n, r, i) {
8
+ let a = Math.max(t.value, e);
9
+ t.cancelScheduledValues(i), t.setValueAtTime(a, i), t.exponentialRampToValueAtTime(Math.max(n, e), i + r);
10
+ }
11
+ function sampleRange(e, t) {
12
+ if (e === void 0) return;
13
+ if (typeof e == "number") return e;
14
+ let [n, r] = e;
15
+ return n + (r - n) * Math.min(Math.max(t(), 0), 1);
16
+ }
17
+ export { n as DEFAULT_ATTACK, r as DEFAULT_RELEASE, t as MICRO_FADE, e as MIN_GAIN, expRampTo, rampParam, sampleRange };
18
+
19
+ //# sourceMappingURL=_ramp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_ramp.js","names":["MIN_GAIN","MICRO_FADE","DEFAULT_ATTACK","DEFAULT_RELEASE","from","param","now","seconds","target","value","min","max","random"],"sources":["../src/_ramp.ts"],"sourcesContent":["/** Shared ramp and sampling helpers. */\n\n/** Smallest gain an exponential ramp may target; 0 throws a `RangeError`. */\nexport const MIN_GAIN = 1e-4;\n\n/** Micro-fade seconds that removes clicks without an audible dip. */\nexport const MICRO_FADE = 0.015;\n\n/** Default ducking attack seconds. */\nexport const DEFAULT_ATTACK = 0.2;\n\n/** Default ducking release seconds. */\nexport const DEFAULT_RELEASE = 0.8;\n\n/**\n * Ramps a gain-like param to `target` over `seconds` using a linear ramp from\n * its current value. Never assigns `param.value` directly while scheduled\n * automation exists, which is what produces clicks.\n */\nexport function rampParam(param: AudioParam, target: number, seconds: number, now: number): void {\n const from = param.value;\n param.cancelScheduledValues(now);\n param.setValueAtTime(from, now);\n if (seconds <= 0 || from === target) {\n param.setValueAtTime(target, now);\n return;\n }\n param.linearRampToValueAtTime(target, now + seconds);\n}\n\n/** Exponentially sweeps a frequency-like param, clamped away from zero. */\nexport function expRampTo(param: AudioParam, target: number, seconds: number, now: number): void {\n const from = Math.max(param.value, MIN_GAIN);\n param.cancelScheduledValues(now);\n param.setValueAtTime(from, now);\n param.exponentialRampToValueAtTime(Math.max(target, MIN_GAIN), now + seconds);\n}\n\n/** Resolves a scalar-or-range option to one sample. */\nexport function sampleRange(\n value: number | readonly [min: number, max: number] | undefined,\n random: () => number,\n): number | undefined {\n if (value === undefined) return undefined;\n if (typeof value === 'number') return value;\n const [min, max] = value;\n return min + (max - min) * Math.min(Math.max(random(), 0), 1);\n}\n"],"mappings":";AAGA,IAAaA,IAAW,MAGXC,IAAa,MAGbC,IAAiB,IAGjBC,IAAkB;AAO/B,SAAgB,UAAU,GAAmB,GAAgB,GAAiB,GAAmB;CAC/F,IAAMC,IAAOC,EAAM;CAGnB,AAFAA,EAAM,sBAAsBC,CAAG,GAC/BD,EAAM,eAAeD,GAAME,CAAG,GAC1BC,KAAW,KAAKH,MAASI,IAC3BH,EAAM,eAAeG,GAAQF,CAAG,IAGlCD,EAAM,wBAAwBG,GAAQF,IAAMC,CAAO;AACrD;AAGA,SAAgB,UAAU,GAAmB,GAAgB,GAAiB,GAAmB;CAC/F,IAAMH,IAAO,KAAK,IAAIC,EAAM,OAAOL,CAAQ;CAG3C,AAFAK,EAAM,sBAAsBC,CAAG,GAC/BD,EAAM,eAAeD,GAAME,CAAG,GAC9BD,EAAM,6BAA6B,KAAK,IAAIG,GAAQR,CAAQ,GAAGM,IAAMC,CAAO;AAC9E;AAGA,SAAgB,YACd,GACA,GACoB;CACpB,IAAIE,MAAU,KAAA,GAAW;CACzB,IAAI,OAAOA,KAAU,UAAU,OAAOA;CACtC,IAAM,CAACC,GAAKC,KAAOF;CACnB,OAAOC,KAAOC,IAAMD,KAAO,KAAK,IAAI,KAAK,IAAIE,EAAO,GAAG,CAAC,GAAG,CAAC;AAC9D"}
@@ -0,0 +1,2 @@
1
+ const e=require("./errors.cjs");function createStreams(t){let n=new Map;return{dispose(){for(let e of n.values())e.disconnect();n.clear()},ensure(r,i){let a=n.get(r);if(a)return a;let o=document.createElement(`audio`);o.crossOrigin=`anonymous`,o.preload=`auto`,o.src=i.src;let s=t.createMediaElementSource(o),c,l,u=new Promise((e,t)=>{c=e,l=t});u.catch(()=>{});let onReady=()=>{c()},onError=()=>{l(new e.BardLoadError(`Streaming "${r}" failed to load "${i.src}".`))};o.addEventListener(`canplay`,onReady,{once:!0}),o.addEventListener(`error`,onError,{once:!0});let d={definition:i,disconnect(){o.removeEventListener(`canplay`,onReady),o.removeEventListener(`error`,onError),o.pause(),o.removeAttribute(`src`),s.disconnect()},get duration(){return o.duration},element:o,ready:u,source:s};return n.set(r,d),d},get(e){return n.get(e)}}}exports.createStreams=createStreams;
2
+ //# sourceMappingURL=_stream.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_stream.cjs","names":["BardLoadError","require_errors","streams","stream","existing","key","element","definition","source","context","settle","reject","outcome","resolve","rejectFn","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":"A,gCA2BA,SAAgB,cAAc,EAAsC,CAClE,IAAME,EAAU,IAAI,IAEpB,MAAO,CACL,SAAgB,CACd,IAAK,IAAMC,KAAUD,EAAQ,OAAO,EAAGC,EAAO,WAAW,EACzDD,EAAQ,MAAM,CAChB,EACA,OAAO,EAAK,EAA2B,CACrC,IAAME,EAAWF,EAAQ,IAAIG,CAAG,EAChC,GAAID,EAAU,OAAOA,EACrB,IAAME,EAAU,SAAS,cAAc,OAAO,EAC9C,EAAQ,YAAc,YACtB,EAAQ,QAAU,OAClB,EAAQ,IAAMC,EAAW,IAEzB,IAAMC,EAASC,EAAQ,yBAAyBH,CAAO,EACnDI,EACAC,EACEC,EAAU,IAAI,SAAe,EAAS,IAAa,CACvD,EAASC,EACT,EAASC,CACX,CAAC,EAGDF,EAAQ,UAAY,CAAC,CAAC,EACtB,IAAM,YAAsB,CAC1BF,EAAO,CACT,EACM,YAAsB,CAC1BC,EAAO,IAAIX,EAAAA,cAAc,cAAcK,EAAI,oBAAoBE,EAAW,IAAI,GAAG,CAAC,CACpF,EACAD,EAAQ,iBAAiB,UAAW,QAAS,CAAE,KAAM,EAAK,CAAC,EAC3DA,EAAQ,iBAAiB,QAAS,QAAS,CAAE,KAAM,EAAK,CAAC,EACzD,IAAMS,EAAuB,CAC3B,aACA,YAAmB,CACjBT,EAAQ,oBAAoB,UAAW,OAAO,EAC9CA,EAAQ,oBAAoB,QAAS,OAAO,EAC5CA,EAAQ,MAAM,EACdA,EAAQ,gBAAgB,KAAK,EAC7BE,EAAO,WAAW,CACpB,EACA,IAAI,UAAmB,CACrB,OAAOF,EAAQ,QACjB,EACA,UACA,MAAOM,EACP,QACF,EAEA,OADAV,EAAQ,IAAIG,EAAKU,CAAK,EACfA,CACT,EACA,IAAI,EAAgC,CAClC,OAAOb,EAAQ,IAAIG,CAAG,CACxB,CACF,CACF,C"}
@@ -0,0 +1,25 @@
1
+ import type { AssetDefinition } from './types';
2
+ /** A streamed asset: an owned `<audio>` element wrapped once in a MediaElementSource. */
3
+ export interface StreamedAsset {
4
+ readonly definition: AssetDefinition;
5
+ disconnect(): void;
6
+ readonly duration: number;
7
+ readonly element: HTMLAudioElement;
8
+ /** Resolves once the element reports playable metadata. */
9
+ readonly ready: Promise<void>;
10
+ readonly source: MediaElementAudioSourceNode;
11
+ }
12
+ export interface StreamManager {
13
+ dispose(): void;
14
+ /** Creates (once) and returns the stream for a key. */
15
+ ensure(key: string, definition: AssetDefinition): StreamedAsset;
16
+ get(key: string): StreamedAsset | undefined;
17
+ }
18
+ /**
19
+ * Long-form tracks play through an owned `HTMLAudioElement` so mobile devices
20
+ * never spike RAM decoding a ten-minute ambient file. Bard creates the
21
+ * element, requests CORS, and wraps it exactly once: an element can only ever
22
+ * be routed through `createMediaElementSource` a single time.
23
+ */
24
+ export declare function createStreams(context: AudioContext): StreamManager;
25
+ //# sourceMappingURL=_stream.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"_stream.d.ts","sourceRoot":"","sources":["../src/_stream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,IAAI,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,aAAa,CAAC;IAChE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAyDlE"}