1681-engine 0.0.0-stage → 0.5.8

package/dist/audio/SoundEngine.js

@@ -0,0 +1,119 @@
+import { engineSettings as m } from "../settings.js";
+import { SampleBank as E, hasTakes as y } from "./sampleBank.js";
+import { SOUNDS as u } from "./soundTable.js";
+import { renderRecipe as R, SYNTH_RATE as k } from "./synth.js";
+const p = 480, _ = 10, q = 6, B = 60, F = 0.45, O = 0.05, w = 80, g = [18e3, 1800], T = { freq: 3500, gainDb: -7 }, V = 11e3;
+class C {
+  ctx = null;
+  master = null;
+  buffers = /* @__PURE__ */ new Map();
+  samples = new E();
+  lastAt = /* @__PURE__ */ new Map();
+  voices = 0;
+  /** Where the local player stands, set by the world scene; null off the world screens. */
+  listener = () => null;
+  onRunning = () => {
+  };
+  constructor() {
+    if (typeof window > "u") return;
+    const t = () => {
+      const s = this.context();
+      if (!s || s.state === "running") return;
+      s.resume();
+      const r = s.createBufferSource();
+      r.buffer = s.createBuffer(1, 1, 22050), r.connect(s.destination), r.start();
+    }, n = ["pointerdown", "pointerup", "touchend", "keydown"], e = (s) => {
+      for (const r of n)
+        s ? window.addEventListener(r, t, { capture: !0 }) : window.removeEventListener(r, t, { capture: !0 });
+    };
+    this.onRunning = (s) => e(!s), e(!0);
+    const i = navigator.audioSession;
+    i && (i.type = "ambient"), m.subscribe((s) => {
+      this.ctx && this.master && this.master.gain.setTargetAtTime(this.level(s.sfxVolume), this.ctx.currentTime, 0.02);
+    });
+  }
+  play(t, n = {}) {
+    if (!t || !u.recipes[t] && !y(t) || m.getState().sfxVolume <= 0) return;
+    const e = this.ctx;
+    if (!e || e.state !== "running" || this.voices >= (n.minor ? q : _)) return;
+    let i = (n.gain ?? 1) * (n.local ? 1 : F), s = 0, r = 0;
+    if (n.x !== void 0 && n.y !== void 0) {
+      const o = this.listener();
+      if (o) {
+        const M = n.x - o.x, d = Math.hypot(M, n.y - o.y), b = Math.min(p, n.range ?? p);
+        if (d >= b) return;
+        i *= Math.pow(1 - d / b, 1.5), r = d / p, s = Math.max(-0.7, Math.min(0.7, M / 320));
+      }
+    }
+    if (i < 0.03) return;
+    const x = performance.now();
+    if (x - (this.lastAt.get(t) ?? -1e9) < B) return;
+    const v = this.samples.take(e, t), l = v ?? this.buffer(e, t);
+    if (!l) return;
+    v && (i *= u.recipes[t]?.fileGain ?? 1), this.lastAt.set(t, x);
+    const c = e.createBufferSource();
+    c.buffer = l;
+    const S = u.recipes[t]?.jitter ?? O;
+    c.playbackRate.value = 1 + (Math.random() * 2 - 1) * S;
+    const a = e.createGain();
+    a.gain.value = Math.min(1, i);
+    const h = e.createStereoPanner();
+    h.pan.value = s;
+    const f = e.createBiquadFilter();
+    f.type = "lowpass", f.frequency.value = g[0] * Math.pow(g[1] / g[0], r), c.connect(f).connect(a).connect(h).connect(this.master), this.voices++, c.onended = () => {
+      this.voices--, c.disconnect(), f.disconnect(), a.disconnect(), h.disconnect();
+    }, c.start();
+    const A = l.duration / c.playbackRate.value * 1e3;
+    if (n.maxMs !== void 0 && A > n.maxMs) {
+      const o = e.currentTime + Math.max(w, n.maxMs) / 1e3;
+      a.gain.setValueAtTime(a.gain.value, o - w / 1e3), a.gain.linearRampToValueAtTime(0, o), c.stop(o);
+    }
+  }
+  level(t) {
+    return Math.max(0, Math.min(1, t)) * u.master;
+  }
+  context() {
+    if (this.ctx) return this.ctx;
+    if (typeof AudioContext > "u") return null;
+    this.ctx = new AudioContext(), this.master = this.ctx.createGain(), this.master.gain.value = this.level(m.getState().sfxVolume);
+    const t = this.ctx.createBiquadFilter();
+    t.type = "highshelf", t.frequency.value = T.freq, t.gain.value = T.gainDb;
+    const n = this.ctx.createBiquadFilter();
+    n.type = "lowpass", n.frequency.value = V, this.master.connect(t).connect(n).connect(this.ctx.destination);
+    const e = this.ctx, i = () => {
+      const s = e.state === "running";
+      this.onRunning(s), s && this.prerender(e);
+    };
+    return e.addEventListener("statechange", i), e.state === "running" && queueMicrotask(i), e;
+  }
+  /**
+   * Starts decoding every recorded take and renders every recipe not rendered yet, one per task, once the context
+   * first runs — so the first swing of a fight does not pay for its sound in that frame.
+   */
+  prerender(t) {
+    for (const i of this.samples.names()) this.samples.load(t, i);
+    const n = Object.keys(u.recipes).filter((i) => !this.buffers.has(i) && !y(i)), e = () => {
+      const i = n.shift();
+      i !== void 0 && (this.buffer(t, i), setTimeout(e, 0));
+    };
+    e();
+  }
+  /** Rendered on first use or by `prerender` (a few ms each), then kept. */
+  buffer(t, n) {
+    const e = this.buffers.get(n);
+    if (e !== void 0) return e;
+    const i = u.recipes[n];
+    let s = null;
+    if (i) {
+      const r = R(i);
+      s = t.createBuffer(1, r.length, k), s.getChannelData(0).set(r);
+    }
+    return this.buffers.set(n, s), s;
+  }
+}
+const H = new C();
+export {
+  C as SoundEngine,
+  H as sound
+};
+//# sourceMappingURL=SoundEngine.js.map

package/dist/audio/SoundEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoundEngine.js","sources":["../../src/audio/SoundEngine.ts"],"sourcesContent":["import { engineSettings } from '../settings';\nimport { hasTakes, SampleBank } from './sampleBank';\nimport { SOUNDS } from './soundTable';\nimport { renderRecipe, SYNTH_RATE } from './synth';\n\n/**\n * Plays sound effects through Web Audio, on a gain of their own (`engineSettings.sfxVolume`, beside the music's).\n * A sound is one of its recorded takes (`registerTakes`, `SampleBank`) when it has\n * any, else its `sounds.json` recipe rendered once into a buffer the first time it is asked for. A sound in the\n * world fades with its distance from the local player, pans with where it happened and loses its highs as it goes\n * (`MUFFLE`); the local player's own swings and blows play at full weight, everyone else's at `OTHERS`.\n *\n * Kept lean on purpose (an earlier, much larger set of effects was taken out for being too busy): one sound per\n * kind per `MIN_GAP_MS`, never more than `MAX_VOICES` at once, and nothing but combat.\n */\n\n/** Beyond this (px) a sound in the world is not heard at all. */\nconst HEARING = 480;\nconst MAX_VOICES = 10;\n/** Minor sounds (footsteps) start only while fewer than this are playing, so they never take a blow's voice. */\nconst MINOR_VOICES = 6;\n/** The same kind twice inside this (ms) is one sound: a cleave clipping six bodies lands once. */\nconst MIN_GAP_MS = 60;\n/** Weight of what other players, pets and monsters do, against the local player's own. */\nconst OTHERS = 0.45;\nconst DEFAULT_JITTER = 0.05;\n/** A sound cut short by `maxMs` fades out over this, so the cut does not click. */\nconst CUT_FADE_MS = 80;\n/** Low-pass cutoff (Hz) right beside the listener and at the edge of hearing: far blows sound dull, not just quiet. */\nconst MUFFLE: [number, number] = [18000, 1800];\n/**\n * The tone of the whole effects bus: the recorded takes came back bright (hiss, glassy ice, blade scrapes) and read\n * as shrill next to the music, so the highs are shelved down and the very top cut, for every sound at once.\n */\nconst TAME_SHELF = { freq: 3500, gainDb: -7 };\nconst TAME_TOP = 11000;\n\nexport interface SoundOptions {\n  /** Where it happened in the world; absent for what happens to or is done by the local player. */\n  x?: number;\n  y?: number;\n  /** Done by (or to) the local player: full weight. */\n  local?: boolean;\n  /** Extra weight (default 1). */\n  gain?: number;\n  /** How far away it can be heard (px), when nearer than `HEARING`. */\n  range?: number;\n  /** Skipped when the mix is busy (footsteps). */\n  minor?: boolean;\n  /** Cut off after this long (ms), faded over `CUT_FADE_MS`: a cast's sound ends with the cast. */\n  maxMs?: number;\n}\n\nexport class SoundEngine {\n  private ctx: AudioContext | null = null;\n  private master: GainNode | null = null;\n  private readonly buffers = new Map<string, AudioBuffer | null>();\n  private readonly samples = new SampleBank();\n  private readonly lastAt = new Map<string, number>();\n  private voices = 0;\n  /** Where the local player stands, set by the world scene; null off the world screens. */\n  listener: () => { x: number; y: number } | null = () => null;\n  private onRunning: (running: boolean) => void = () => {};\n\n  constructor() {\n    if (typeof window === 'undefined') return;\n    // iOS lets a page start sound only inside a gesture, counts `touchend` (not `pointerdown`) as one, and leaves\n    // the context 'interrupted' after the app comes back from the background: every touch retries until it runs\n    const unlock = () => {\n      const ctx = this.context();\n      if (!ctx || ctx.state === 'running') return;\n      void ctx.resume();\n      // one silent sample started inside the gesture is what WebKit needs to open the output\n      const blank = ctx.createBufferSource();\n      blank.buffer = ctx.createBuffer(1, 1, 22050);\n      blank.connect(ctx.destination);\n      blank.start();\n    };\n    // listening only while the context is not running: once it runs a touch has nothing to do, and the listeners\n    // come back the moment it stops (the interrupted iOS case)\n    const types = ['pointerdown', 'pointerup', 'touchend', 'keydown'] as const;\n    const listen = (on: boolean) => {\n      for (const type of types) {\n        if (on) window.addEventListener(type, unlock, { capture: true });\n        else window.removeEventListener(type, unlock, { capture: true });\n      }\n    };\n    this.onRunning = (running) => listen(!running);\n    listen(true);\n    // game sound, not media: it follows the ring/silent switch and mixes with the player's own music (iOS 17+)\n    const session = (navigator as Navigator & { audioSession?: { type: string } }).audioSession;\n    if (session) session.type = 'ambient';\n    engineSettings.subscribe((s) => {\n      if (this.ctx && this.master) this.master.gain.setTargetAtTime(this.level(s.sfxVolume), this.ctx.currentTime, 0.02);\n    });\n  }\n\n  play(name: string | undefined, opts: SoundOptions = {}): void {\n    if (!name || (!SOUNDS.recipes[name] && !hasTakes(name))) return;\n    if (engineSettings.getState().sfxVolume <= 0) return;\n    const ctx = this.ctx;\n    if (!ctx || ctx.state !== 'running' || this.voices >= (opts.minor ? MINOR_VOICES : MAX_VOICES)) return;\n    let gain = (opts.gain ?? 1) * (opts.local ? 1 : OTHERS);\n    let pan = 0;\n    let far = 0;\n    if (opts.x !== undefined && opts.y !== undefined) {\n      const me = this.listener();\n      if (me) {\n        const dx = opts.x - me.x;\n        const d = Math.hypot(dx, opts.y - me.y);\n        const hearing = Math.min(HEARING, opts.range ?? HEARING);\n        if (d >= hearing) return;\n        gain *= Math.pow(1 - d / hearing, 1.5);\n        far = d / HEARING;\n        pan = Math.max(-0.7, Math.min(0.7, dx / 320));\n      }\n    }\n    if (gain < 0.03) return;\n    const now = performance.now();\n    if (now - (this.lastAt.get(name) ?? -1e9) < MIN_GAP_MS) return;\n    const take = this.samples.take(ctx, name);\n    const buffer = take ?? this.buffer(ctx, name);\n    if (!buffer) return;\n    if (take) gain *= SOUNDS.recipes[name]?.fileGain ?? 1;\n    this.lastAt.set(name, now);\n    const src = ctx.createBufferSource();\n    src.buffer = buffer;\n    const jitter = SOUNDS.recipes[name]?.jitter ?? DEFAULT_JITTER;\n    src.playbackRate.value = 1 + (Math.random() * 2 - 1) * jitter;\n    const g = ctx.createGain();\n    g.gain.value = Math.min(1, gain);\n    const p = ctx.createStereoPanner();\n    p.pan.value = pan;\n    const lp = ctx.createBiquadFilter();\n    lp.type = 'lowpass';\n    lp.frequency.value = MUFFLE[0] * Math.pow(MUFFLE[1] / MUFFLE[0], far);\n    src.connect(lp).connect(g).connect(p).connect(this.master!);\n    this.voices++;\n    src.onended = () => {\n      this.voices--;\n      src.disconnect();\n      lp.disconnect();\n      g.disconnect();\n      p.disconnect();\n    };\n    src.start();\n    const lasts = (buffer.duration / src.playbackRate.value) * 1000;\n    if (opts.maxMs !== undefined && lasts > opts.maxMs) {\n      const end = ctx.currentTime + Math.max(CUT_FADE_MS, opts.maxMs) / 1000;\n      g.gain.setValueAtTime(g.gain.value, end - CUT_FADE_MS / 1000);\n      g.gain.linearRampToValueAtTime(0, end);\n      src.stop(end);\n    }\n  }\n\n  private level(volume: number): number {\n    return Math.max(0, Math.min(1, volume)) * SOUNDS.master;\n  }\n\n  private context(): AudioContext | null {\n    if (this.ctx) return this.ctx;\n    if (typeof AudioContext === 'undefined') return null;\n    this.ctx = new AudioContext();\n    this.master = this.ctx.createGain();\n    this.master.gain.value = this.level(engineSettings.getState().sfxVolume);\n    const shelf = this.ctx.createBiquadFilter();\n    shelf.type = 'highshelf';\n    shelf.frequency.value = TAME_SHELF.freq;\n    shelf.gain.value = TAME_SHELF.gainDb;\n    const top = this.ctx.createBiquadFilter();\n    top.type = 'lowpass';\n    top.frequency.value = TAME_TOP;\n    this.master.connect(shelf).connect(top).connect(this.ctx.destination);\n    const ctx = this.ctx;\n    const changed = () => {\n      const running = ctx.state === 'running';\n      this.onRunning(running);\n      if (running) this.prerender(ctx);\n    };\n    ctx.addEventListener('statechange', changed);\n    // a context allowed to run from the start changes no state\n    if (ctx.state === 'running') queueMicrotask(changed);\n    return ctx;\n  }\n\n  /**\n   * Starts decoding every recorded take and renders every recipe not rendered yet, one per task, once the context\n   * first runs — so the first swing of a fight does not pay for its sound in that frame.\n   */\n  private prerender(ctx: AudioContext): void {\n    for (const name of this.samples.names()) this.samples.load(ctx, name);\n    // a sound with recorded takes plays them; its recipe is only the fallback while they decode, not worth a 40 ms task\n    const todo = Object.keys(SOUNDS.recipes).filter((name) => !this.buffers.has(name) && !hasTakes(name));\n    const next = () => {\n      const name = todo.shift();\n      if (name === undefined) return;\n      this.buffer(ctx, name);\n      setTimeout(next, 0);\n    };\n    next();\n  }\n\n  /** Rendered on first use or by `prerender` (a few ms each), then kept. */\n  private buffer(ctx: AudioContext, name: string): AudioBuffer | null {\n    const cached = this.buffers.get(name);\n    if (cached !== undefined) return cached;\n    const recipe = SOUNDS.recipes[name];\n    let buf: AudioBuffer | null = null;\n    if (recipe) {\n      const data = renderRecipe(recipe);\n      buf = ctx.createBuffer(1, data.length, SYNTH_RATE);\n      buf.getChannelData(0).set(data);\n    }\n    this.buffers.set(name, buf);\n    return buf;\n  }\n}\n\nexport const sound = new SoundEngine();\n"],"names":["HEARING","MAX_VOICES","MINOR_VOICES","MIN_GAP_MS","OTHERS","DEFAULT_JITTER","CUT_FADE_MS","MUFFLE","TAME_SHELF","TAME_TOP","SoundEngine","SampleBank","unlock","ctx","blank","types","listen","on","type","running","session","engineSettings","name","opts","SOUNDS","hasTakes","gain","pan","far","me","dx","hearing","now","take","buffer","src","jitter","g","p","lp","lasts","end","volume","shelf","top","changed","todo","next","cached","recipe","buf","data","renderRecipe","SYNTH_RATE","sound"],"mappings":"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"}

package/dist/audio/cleanTake.js

@@ -0,0 +1,30 @@
+function L(c, h) {
+  const l = c[0]?.length ?? 0, E = 1 / Math.max(1, c.length), a = new Float32Array(l);
+  for (const t of c) for (let n = 0; n < l; n++) a[n] += t[n] * E;
+  let s = 0;
+  for (let t = 0; t < l; t++) {
+    const n = Math.abs(a[t]);
+    n > s && (s = n);
+  }
+  if (s < 5e-3) return null;
+  const f = s * 0.01;
+  let e = 0;
+  for (; e < l && Math.abs(a[e]) < f; ) e++;
+  let r = l;
+  for (; r > e && Math.abs(a[r - 1]) < f; ) r--;
+  if (r <= e) return null;
+  e = Math.max(0, e - Math.round(2e-3 * h));
+  const o = a.slice(e, r);
+  let i = 0;
+  for (let t = 0; t < o.length; t++) i += o[t] * o[t];
+  const A = Math.sqrt(i / o.length), u = Math.min(0.16 / Math.max(A, 1e-6), 0.95 / s), M = Math.min(o.length, Math.round(0.01 * h));
+  for (let t = 0; t < o.length; t++) {
+    const n = o.length - t;
+    o[t] *= u * (n < M ? n / M : 1);
+  }
+  return o;
+}
+export {
+  L as cleanSamples
+};
+//# sourceMappingURL=cleanTake.js.map

package/dist/audio/cleanTake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanTake.js","sources":["../../src/audio/cleanTake.ts"],"sourcesContent":["/*\n * Cleans one recorded take (`SampleBank`): folded to mono, the silence an encoder or the model leaves at the start cut\n * (a swing heard 30 ms late reads as lag) and at the end trimmed, and brought to one loudness (`LOUDNESS`, RMS of what\n * is left, never past `PEAK`), so takes from different prompts sit at one level. Pure: run in `takeCleanerWorker.ts`,\n * because on the main thread the first blows of a fight froze the game 70–170 ms a take on a Mac and several times\n * that on a phone (profiled).\n */\n\n/** Below this share of the take's own peak a sample counts as silence when trimming (-40 dB). */\nconst FLOOR = 0.01;\n/** A take whose peak is under this is treated as empty (about -46 dBFS): the model returned near-silence. */\nconst EMPTY = 0.005;\n/** Target RMS of a cleaned take (-16 dBFS) and the peak it may not pass. */\nconst LOUDNESS = 0.16;\nconst PEAK = 0.95;\n/** Kept before the first loud sample, so the attack is not clipped into a click (s). */\nconst LEAD = 0.002;\n/** A short fade over the cut end, so a trimmed tail does not click (s). */\nconst TAIL_FADE = 0.01;\n\n/** The cleaned mono samples, or null for a take that is silence. */\nexport function cleanSamples(channels: Float32Array[], sampleRate: number): Float32Array | null {\n  const n = channels[0]?.length ?? 0;\n  const k0 = 1 / Math.max(1, channels.length);\n  const mono = new Float32Array(n);\n  for (const ch of channels) for (let i = 0; i < n; i++) mono[i]! += ch[i]! * k0;\n  let top = 0;\n  for (let i = 0; i < n; i++) {\n    const a = Math.abs(mono[i]!);\n    if (a > top) top = a;\n  }\n  if (top < EMPTY) return null;\n  const floor = top * FLOOR;\n  let start = 0;\n  while (start < n && Math.abs(mono[start]!) < floor) start++;\n  let end = n;\n  while (end > start && Math.abs(mono[end - 1]!) < floor) end--;\n  if (end <= start) return null;\n  start = Math.max(0, start - Math.round(LEAD * sampleRate));\n  const data = mono.slice(start, end);\n  let power = 0;\n  for (let i = 0; i < data.length; i++) power += data[i]! * data[i]!;\n  const rms = Math.sqrt(power / data.length);\n  const k = Math.min(LOUDNESS / Math.max(rms, 1e-6), PEAK / top);\n  const fade = Math.min(data.length, Math.round(TAIL_FADE * sampleRate));\n  for (let i = 0; i < data.length; i++) {\n    const left = data.length - i;\n    data[i]! *= k * (left < fade ? left / fade : 1);\n  }\n  return data;\n}\n"],"names":["cleanSamples","channels","sampleRate","n","k0","mono","ch","i","top","a","floor","start","end","data","power","rms","k","fade","left"],"mappings":"AAqBO,SAASA,EAAaC,GAA0BC,GAAyC;AAC9F,QAAMC,IAAIF,EAAS,CAAC,GAAG,UAAU,GAC3BG,IAAK,IAAI,KAAK,IAAI,GAAGH,EAAS,MAAM,GACpCI,IAAO,IAAI,aAAaF,CAAC;AAC/B,aAAWG,KAAML,EAAU,UAASM,IAAI,GAAGA,IAAIJ,GAAGI,IAAK,CAAAF,EAAKE,CAAC,KAAMD,EAAGC,CAAC,IAAKH;AAC5E,MAAII,IAAM;AACV,WAASD,IAAI,GAAGA,IAAIJ,GAAGI,KAAK;AAC1B,UAAME,IAAI,KAAK,IAAIJ,EAAKE,CAAC,CAAE;AAC3B,IAAIE,IAAID,MAAKA,IAAMC;AAAA,EACrB;AACA,MAAID,IAAM,KAAO,QAAO;AACxB,QAAME,IAAQF,IAAM;AACpB,MAAIG,IAAQ;AACZ,SAAOA,IAAQR,KAAK,KAAK,IAAIE,EAAKM,CAAK,CAAE,IAAID,IAAO,CAAAC;AACpD,MAAIC,IAAMT;AACV,SAAOS,IAAMD,KAAS,KAAK,IAAIN,EAAKO,IAAM,CAAC,CAAE,IAAIF,IAAO,CAAAE;AACxD,MAAIA,KAAOD,EAAO,QAAO;AACzB,EAAAA,IAAQ,KAAK,IAAI,GAAGA,IAAQ,KAAK,MAAM,OAAOT,CAAU,CAAC;AACzD,QAAMW,IAAOR,EAAK,MAAMM,GAAOC,CAAG;AAClC,MAAIE,IAAQ;AACZ,WAASP,IAAI,GAAGA,IAAIM,EAAK,QAAQN,IAAK,CAAAO,KAASD,EAAKN,CAAC,IAAKM,EAAKN,CAAC;AAChE,QAAMQ,IAAM,KAAK,KAAKD,IAAQD,EAAK,MAAM,GACnCG,IAAI,KAAK,IAAI,OAAW,KAAK,IAAID,GAAK,IAAI,GAAG,OAAOP,CAAG,GACvDS,IAAO,KAAK,IAAIJ,EAAK,QAAQ,KAAK,MAAM,OAAYX,CAAU,CAAC;AACrE,WAASK,IAAI,GAAGA,IAAIM,EAAK,QAAQN,KAAK;AACpC,UAAMW,IAAOL,EAAK,SAASN;AAC3B,IAAAM,EAAKN,CAAC,KAAMS,KAAKE,IAAOD,IAAOC,IAAOD,IAAO;AAAA,EAC/C;AACA,SAAOJ;AACT;"}

package/dist/audio/music/ElementVoice.js

@@ -0,0 +1,35 @@
+import { clamp01 as l } from "./musicVoice.js";
+class m {
+  constructor(e) {
+    this.el = e;
+  }
+  el;
+  fading = null;
+  level() {
+    return this.el.volume;
+  }
+  set(e) {
+    this.stopFade(), this.el.volume = l(e);
+  }
+  fade(e, t, o) {
+    this.stopFade();
+    const i = this.el.volume, a = performance.now(), s = () => {
+      const n = t > 0 ? Math.min(1, (performance.now() - a) / t) : 1;
+      this.el.volume = l(i + (e - i) * n), n < 1 ? this.fading = requestAnimationFrame(s) : (this.fading = null, o?.());
+    };
+    this.fading = requestAnimationFrame(s);
+  }
+  get busy() {
+    return this.fading !== null;
+  }
+  dispose() {
+    this.stopFade(), this.el.pause(), this.el.removeAttribute("src"), this.el.load();
+  }
+  stopFade() {
+    this.fading !== null && cancelAnimationFrame(this.fading), this.fading = null;
+  }
+}
+export {
+  m as ElementVoice
+};
+//# sourceMappingURL=ElementVoice.js.map

package/dist/audio/music/ElementVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementVoice.js","sources":["../../../src/audio/music/ElementVoice.ts"],"sourcesContent":["import { clamp01, type MusicVoice } from './musicVoice';\n\n/** A track on the `<audio>` element's own volume, faded frame by frame: nothing between the file and the speaker. */\nexport class ElementVoice implements MusicVoice {\n  private fading: number | null = null;\n\n  constructor(readonly el: HTMLAudioElement) {}\n\n  level(): number {\n    return this.el.volume;\n  }\n\n  set(level: number): void {\n    this.stopFade();\n    this.el.volume = clamp01(level);\n  }\n\n  fade(to: number, ms: number, done?: () => void): void {\n    this.stopFade();\n    const from = this.el.volume;\n    const start = performance.now();\n    const step = () => {\n      const k = ms > 0 ? Math.min(1, (performance.now() - start) / ms) : 1;\n      this.el.volume = clamp01(from + (to - from) * k);\n      if (k < 1) this.fading = requestAnimationFrame(step);\n      else {\n        this.fading = null;\n        done?.();\n      }\n    };\n    this.fading = requestAnimationFrame(step);\n  }\n\n  get busy(): boolean {\n    return this.fading !== null;\n  }\n\n  dispose(): void {\n    this.stopFade();\n    this.el.pause();\n    this.el.removeAttribute('src');\n    this.el.load();\n  }\n\n  private stopFade(): void {\n    if (this.fading !== null) cancelAnimationFrame(this.fading);\n    this.fading = null;\n  }\n}\n"],"names":["ElementVoice","el","level","clamp01","to","ms","done","from","start","step","k"],"mappings":";AAGO,MAAMA,EAAmC;AAAA,EAG9C,YAAqBC,GAAsB;AAAtB,SAAA,KAAAA;AAAA,EAAuB;AAAA,EAAvB;AAAA,EAFb,SAAwB;AAAA,EAIhC,QAAgB;AACd,WAAO,KAAK,GAAG;AAAA,EACjB;AAAA,EAEA,IAAIC,GAAqB;AACvB,SAAK,SAAA,GACL,KAAK,GAAG,SAASC,EAAQD,CAAK;AAAA,EAChC;AAAA,EAEA,KAAKE,GAAYC,GAAYC,GAAyB;AACpD,SAAK,SAAA;AACL,UAAMC,IAAO,KAAK,GAAG,QACfC,IAAQ,YAAY,IAAA,GACpBC,IAAO,MAAM;AACjB,YAAMC,IAAIL,IAAK,IAAI,KAAK,IAAI,IAAI,YAAY,IAAA,IAAQG,KAASH,CAAE,IAAI;AACnE,WAAK,GAAG,SAASF,EAAQI,KAAQH,IAAKG,KAAQG,CAAC,GAC3CA,IAAI,IAAG,KAAK,SAAS,sBAAsBD,CAAI,KAEjD,KAAK,SAAS,MACdH,IAAA;AAAA,IAEJ;AACA,SAAK,SAAS,sBAAsBG,CAAI;AAAA,EAC1C;AAAA,EAEA,IAAI,OAAgB;AAClB,WAAO,KAAK,WAAW;AAAA,EACzB;AAAA,EAEA,UAAgB;AACd,SAAK,SAAA,GACL,KAAK,GAAG,MAAA,GACR,KAAK,GAAG,gBAAgB,KAAK,GAC7B,KAAK,GAAG,KAAA;AAAA,EACV;AAAA,EAEQ,WAAiB;AACvB,IAAI,KAAK,WAAW,QAAM,qBAAqB,KAAK,MAAM,GAC1D,KAAK,SAAS;AAAA,EAChB;AACF;"}

package/dist/audio/music/GraphVoice.js

@@ -0,0 +1,39 @@
+import { clamp01 as a } from "./musicVoice.js";
+class h {
+  constructor(t, e) {
+    this.el = t, this.graph = e, this.source = e.createMediaElementSource(t), this.gain = e.createGain(), this.gain.gain.value = 0, this.source.connect(this.gain).connect(e.destination);
+  }
+  el;
+  graph;
+  gain;
+  source;
+  timer = null;
+  level() {
+    return this.gain.gain.value;
+  }
+  set(t) {
+    this.stopFade();
+    const e = this.gain.gain;
+    e.cancelScheduledValues(this.graph.currentTime), e.setValueAtTime(a(t), this.graph.currentTime);
+  }
+  fade(t, e, n) {
+    this.stopFade();
+    const i = this.gain.gain, s = this.graph.currentTime;
+    i.cancelScheduledValues(s), i.setValueAtTime(i.value, s), i.linearRampToValueAtTime(a(t), s + e / 1e3), this.timer = setTimeout(() => {
+      this.timer = null, n?.();
+    }, e);
+  }
+  get busy() {
+    return this.timer !== null;
+  }
+  dispose() {
+    this.stopFade(), this.el.pause(), this.source.disconnect(), this.gain.disconnect();
+  }
+  stopFade() {
+    this.timer && clearTimeout(this.timer), this.timer = null;
+  }
+}
+export {
+  h as GraphVoice
+};
+//# sourceMappingURL=GraphVoice.js.map

package/dist/audio/music/GraphVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphVoice.js","sources":["../../../src/audio/music/GraphVoice.ts"],"sourcesContent":["import { clamp01, type MusicVoice } from './musicVoice';\n\n/**\n * A track routed `<audio>` → MediaElementSource → gain → speakers, so its volume and crossfades work where the\n * element's own `volume` is read-only (iOS). The fade is scheduled on the audio clock (a ramp), so it runs even while\n * the page draws no frames. A cross-origin file without CORS headers plays silent this way: serve music from the\n * game's own origin, or keep `ElementVoice` where volume works.\n */\nexport class GraphVoice implements MusicVoice {\n  private readonly gain: GainNode;\n  private readonly source: MediaElementAudioSourceNode;\n  private timer: ReturnType<typeof setTimeout> | null = null;\n\n  constructor(\n    readonly el: HTMLAudioElement,\n    private readonly graph: AudioContext,\n  ) {\n    this.source = graph.createMediaElementSource(el);\n    this.gain = graph.createGain();\n    this.gain.gain.value = 0;\n    this.source.connect(this.gain).connect(graph.destination);\n  }\n\n  level(): number {\n    return this.gain.gain.value;\n  }\n\n  set(level: number): void {\n    this.stopFade();\n    const g = this.gain.gain;\n    g.cancelScheduledValues(this.graph.currentTime);\n    g.setValueAtTime(clamp01(level), this.graph.currentTime);\n  }\n\n  fade(to: number, ms: number, done?: () => void): void {\n    this.stopFade();\n    const g = this.gain.gain;\n    const now = this.graph.currentTime;\n    g.cancelScheduledValues(now);\n    g.setValueAtTime(g.value, now);\n    g.linearRampToValueAtTime(clamp01(to), now + ms / 1000);\n    this.timer = setTimeout(() => {\n      this.timer = null;\n      done?.();\n    }, ms);\n  }\n\n  get busy(): boolean {\n    return this.timer !== null;\n  }\n\n  dispose(): void {\n    this.stopFade();\n    this.el.pause();\n    this.source.disconnect();\n    this.gain.disconnect();\n  }\n\n  private stopFade(): void {\n    if (this.timer) clearTimeout(this.timer);\n    this.timer = null;\n  }\n}\n"],"names":["GraphVoice","el","graph","level","g","clamp01","to","ms","done","now"],"mappings":";AAQO,MAAMA,EAAiC;AAAA,EAK5C,YACWC,GACQC,GACjB;AAFS,SAAA,KAAAD,GACQ,KAAA,QAAAC,GAEjB,KAAK,SAASA,EAAM,yBAAyBD,CAAE,GAC/C,KAAK,OAAOC,EAAM,WAAA,GAClB,KAAK,KAAK,KAAK,QAAQ,GACvB,KAAK,OAAO,QAAQ,KAAK,IAAI,EAAE,QAAQA,EAAM,WAAW;AAAA,EAC1D;AAAA,EAPW;AAAA,EACQ;AAAA,EANF;AAAA,EACA;AAAA,EACT,QAA8C;AAAA,EAYtD,QAAgB;AACd,WAAO,KAAK,KAAK,KAAK;AAAA,EACxB;AAAA,EAEA,IAAIC,GAAqB;AACvB,SAAK,SAAA;AACL,UAAMC,IAAI,KAAK,KAAK;AACpB,IAAAA,EAAE,sBAAsB,KAAK,MAAM,WAAW,GAC9CA,EAAE,eAAeC,EAAQF,CAAK,GAAG,KAAK,MAAM,WAAW;AAAA,EACzD;AAAA,EAEA,KAAKG,GAAYC,GAAYC,GAAyB;AACpD,SAAK,SAAA;AACL,UAAMJ,IAAI,KAAK,KAAK,MACdK,IAAM,KAAK,MAAM;AACvB,IAAAL,EAAE,sBAAsBK,CAAG,GAC3BL,EAAE,eAAeA,EAAE,OAAOK,CAAG,GAC7BL,EAAE,wBAAwBC,EAAQC,CAAE,GAAGG,IAAMF,IAAK,GAAI,GACtD,KAAK,QAAQ,WAAW,MAAM;AAC5B,WAAK,QAAQ,MACbC,IAAA;AAAA,IACF,GAAGD,CAAE;AAAA,EACP;AAAA,EAEA,IAAI,OAAgB;AAClB,WAAO,KAAK,UAAU;AAAA,EACxB;AAAA,EAEA,UAAgB;AACd,SAAK,SAAA,GACL,KAAK,GAAG,MAAA,GACR,KAAK,OAAO,WAAA,GACZ,KAAK,KAAK,WAAA;AAAA,EACZ;AAAA,EAEQ,WAAiB;AACvB,IAAI,KAAK,SAAO,aAAa,KAAK,KAAK,GACvC,KAAK,QAAQ;AAAA,EACf;AACF;"}

package/dist/audio/music/MusicChannel.js

@@ -0,0 +1,58 @@
+class h {
+  constructor(e, t) {
+    this.volume = e, this.makeVoice = t;
+  }
+  volume;
+  makeVoice;
+  voice = null;
+  url = null;
+  level = 1;
+  /** The url of the track playing (or fading in), if any. */
+  get current() {
+    return this.url;
+  }
+  /** Plays `url`, crossfading from what plays now; the track already playing only takes the new `volume`. */
+  play(e, t = {}) {
+    const s = Math.min(1, Math.max(0, t.volume ?? 1));
+    if (e === this.url) {
+      s !== this.level && (this.level = s, this.refresh());
+      return;
+    }
+    if (typeof Audio > "u") return;
+    const o = Math.max(0, t.fadeMs ?? 1200);
+    this.fadeOut(o), this.url = e, this.level = s;
+    const i = new Audio(e);
+    i.loop = t.loop !== !1, i.preload = "auto";
+    const l = this.makeVoice(i);
+    l.set(0), this.voice = l, i.play().catch(() => {
+    }), l.fade(this.target(), o);
+  }
+  /** Fades this channel out and stops it. */
+  stop(e = 1200) {
+    this.fadeOut(Math.max(0, e)), this.url = null;
+  }
+  /** Retries a start the browser refused, and follows the music volume. */
+  refresh() {
+    const e = this.voice;
+    e && (e.el.paused && e.el.play().catch(() => {
+    }), e.busy || e.set(this.target()));
+  }
+  /** Stops where it is (the app went to the background); `refresh` picks it up again. */
+  pause() {
+    this.voice?.el.pause();
+  }
+  dispose() {
+    this.voice?.dispose(), this.voice = null, this.url = null;
+  }
+  target() {
+    return Math.max(0, Math.min(1, this.volume() * this.level));
+  }
+  fadeOut(e) {
+    const t = this.voice;
+    this.voice = null, t && t.fade(0, e, () => t.dispose());
+  }
+}
+export {
+  h as MusicChannel
+};
+//# sourceMappingURL=MusicChannel.js.map

package/dist/audio/music/MusicChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicChannel.js","sources":["../../../src/audio/music/MusicChannel.ts"],"sourcesContent":["import type { MusicVoice } from './musicVoice';\n\nexport interface PlayOptions {\n  /** Crossfade from what this channel plays now, ms (default 1200). */\n  fadeMs?: number;\n  /** Start over at the end (default true). */\n  loop?: boolean;\n  /** This track's own level, 0–1, under the music volume (default 1). */\n  volume?: number;\n}\n\n/**\n * One layer of music (the score, a place's ambience…): one looping track at a time, crossfaded when it changes, at\n * its own level under the player's music volume.\n */\nexport class MusicChannel {\n  private voice: MusicVoice | null = null;\n  private url: string | null = null;\n  private level = 1;\n\n  constructor(\n    private readonly volume: () => number,\n    private readonly makeVoice: (el: HTMLAudioElement) => MusicVoice,\n  ) {}\n\n  /** The url of the track playing (or fading in), if any. */\n  get current(): string | null {\n    return this.url;\n  }\n\n  /** Plays `url`, crossfading from what plays now; the track already playing only takes the new `volume`. */\n  play(url: string, options: PlayOptions = {}): void {\n    const level = Math.min(1, Math.max(0, options.volume ?? 1));\n    if (url === this.url) {\n      if (level !== this.level) {\n        this.level = level;\n        this.refresh();\n      }\n      return;\n    }\n    if (typeof Audio === 'undefined') return;\n    const fadeMs = Math.max(0, options.fadeMs ?? 1200);\n    this.fadeOut(fadeMs);\n    this.url = url;\n    this.level = level;\n    const el = new Audio(url);\n    el.loop = options.loop !== false;\n    el.preload = 'auto';\n    const voice = this.makeVoice(el);\n    voice.set(0);\n    this.voice = voice;\n    void el.play().catch(() => {\n      // refused until the first gesture; the player's unlock retries it\n    });\n    voice.fade(this.target(), fadeMs);\n  }\n\n  /** Fades this channel out and stops it. */\n  stop(fadeMs = 1200): void {\n    this.fadeOut(Math.max(0, fadeMs));\n    this.url = null;\n  }\n\n  /** Retries a start the browser refused, and follows the music volume. */\n  refresh(): void {\n    const v = this.voice;\n    if (!v) return;\n    if (v.el.paused) void v.el.play().catch(() => {});\n    if (!v.busy) v.set(this.target());\n  }\n\n  /** Stops where it is (the app went to the background); `refresh` picks it up again. */\n  pause(): void {\n    this.voice?.el.pause();\n  }\n\n  dispose(): void {\n    this.voice?.dispose();\n    this.voice = null;\n    this.url = null;\n  }\n\n  private target(): number {\n    return Math.max(0, Math.min(1, this.volume() * this.level));\n  }\n\n  private fadeOut(ms: number): void {\n    const old = this.voice;\n    this.voice = null;\n    if (old) old.fade(0, ms, () => old.dispose());\n  }\n}\n"],"names":["MusicChannel","volume","makeVoice","url","options","level","fadeMs","el","voice","v","ms","old"],"mappings":"AAeO,MAAMA,EAAa;AAAA,EAKxB,YACmBC,GACAC,GACjB;AAFiB,SAAA,SAAAD,GACA,KAAA,YAAAC;AAAA,EAChB;AAAA,EAFgB;AAAA,EACA;AAAA,EANX,QAA2B;AAAA,EAC3B,MAAqB;AAAA,EACrB,QAAQ;AAAA;AAAA,EAQhB,IAAI,UAAyB;AAC3B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA,EAGA,KAAKC,GAAaC,IAAuB,IAAU;AACjD,UAAMC,IAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGD,EAAQ,UAAU,CAAC,CAAC;AAC1D,QAAID,MAAQ,KAAK,KAAK;AACpB,MAAIE,MAAU,KAAK,UACjB,KAAK,QAAQA,GACb,KAAK,QAAA;AAEP;AAAA,IACF;AACA,QAAI,OAAO,QAAU,IAAa;AAClC,UAAMC,IAAS,KAAK,IAAI,GAAGF,EAAQ,UAAU,IAAI;AACjD,SAAK,QAAQE,CAAM,GACnB,KAAK,MAAMH,GACX,KAAK,QAAQE;AACb,UAAME,IAAK,IAAI,MAAMJ,CAAG;AACxB,IAAAI,EAAG,OAAOH,EAAQ,SAAS,IAC3BG,EAAG,UAAU;AACb,UAAMC,IAAQ,KAAK,UAAUD,CAAE;AAC/B,IAAAC,EAAM,IAAI,CAAC,GACX,KAAK,QAAQA,GACRD,EAAG,OAAO,MAAM,MAAM;AAAA,IAE3B,CAAC,GACDC,EAAM,KAAK,KAAK,OAAA,GAAUF,CAAM;AAAA,EAClC;AAAA;AAAA,EAGA,KAAKA,IAAS,MAAY;AACxB,SAAK,QAAQ,KAAK,IAAI,GAAGA,CAAM,CAAC,GAChC,KAAK,MAAM;AAAA,EACb;AAAA;AAAA,EAGA,UAAgB;AACd,UAAMG,IAAI,KAAK;AACf,IAAKA,MACDA,EAAE,GAAG,UAAaA,EAAE,GAAG,OAAO,MAAM,MAAM;AAAA,IAAC,CAAC,GAC3CA,EAAE,UAAQ,IAAI,KAAK,QAAQ;AAAA,EAClC;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,OAAO,GAAG,MAAA;AAAA,EACjB;AAAA,EAEA,UAAgB;AACd,SAAK,OAAO,QAAA,GACZ,KAAK,QAAQ,MACb,KAAK,MAAM;AAAA,EACb;AAAA,EAEQ,SAAiB;AACvB,WAAO,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,OAAA,IAAW,KAAK,KAAK,CAAC;AAAA,EAC5D;AAAA,EAEQ,QAAQC,GAAkB;AAChC,UAAMC,IAAM,KAAK;AACjB,SAAK,QAAQ,MACTA,OAAS,KAAK,GAAGD,GAAI,MAAMC,EAAI,SAAS;AAAA,EAC9C;AACF;"}

package/dist/audio/music/musicVoice.js

@@ -0,0 +1,13 @@
+function n() {
+  if (typeof Audio > "u") return !1;
+  const e = typeof navigator < "u" ? navigator : null;
+  if (e && (/iPhone|iPad|iPod/.test(e.userAgent) || /Macintosh/.test(e.userAgent) && e.maxTouchPoints > 1)) return !0;
+  const t = new Audio();
+  return t.volume = 0.5, Math.abs(t.volume - 0.5) > 0.01;
+}
+const o = (e) => Math.max(0, Math.min(1, e));
+export {
+  o as clamp01,
+  n as elementVolumeLocked
+};
+//# sourceMappingURL=musicVoice.js.map

package/dist/audio/music/musicVoice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"musicVoice.js","sources":["../../../src/audio/music/musicVoice.ts"],"sourcesContent":["/**\n * One looping track playing on one channel of `MusicPlayer`, with a volume that can be set and faded. Two ways to get\n * one: `ElementVoice` (the `<audio>` element's own volume) and `GraphVoice` (the element routed through a Web Audio\n * gain, for where an `<audio>`'s `volume` is read-only: iOS).\n */\nexport interface MusicVoice {\n  readonly el: HTMLAudioElement;\n  /** The volume now (0..1). */\n  level(): number;\n  /** Sets it at once, cancelling a fade in flight. */\n  set(level: number): void;\n  /** Fades to `level` over `ms`; `done` runs at the end (not if a later fade or `set` takes over). */\n  fade(level: number, ms: number, done?: () => void): void;\n  /** A fade is in flight: the channel leaves the volume setting alone until it ends. */\n  readonly busy: boolean;\n  /** Stops the sound and lets the element go. */\n  dispose(): void;\n}\n\n/**\n * True where an `<audio>` ignores `volume` (iOS WebKit), so music has to go through Web Audio to be faded at all.\n * Newer iOS reads a set volume back while the speaker ignores it, so the probe alone misses it: an iPhone, iPod or an\n * iPad posing as a Mac is named first.\n */\nexport function elementVolumeLocked(): boolean {\n  if (typeof Audio === 'undefined') return false;\n  const nav = typeof navigator !== 'undefined' ? navigator : null;\n  if (nav && (/iPhone|iPad|iPod/.test(nav.userAgent) || (/Macintosh/.test(nav.userAgent) && nav.maxTouchPoints > 1))) return true;\n  const probe = new Audio();\n  probe.volume = 0.5;\n  return Math.abs(probe.volume - 0.5) > 0.01;\n}\n\nexport const clamp01 = (n: number): number => Math.max(0, Math.min(1, n));\n"],"names":["elementVolumeLocked","nav","probe","clamp01","n"],"mappings":"AAwBO,SAASA,IAA+B;AAC7C,MAAI,OAAO,QAAU,IAAa,QAAO;AACzC,QAAMC,IAAM,OAAO,YAAc,MAAc,YAAY;AAC3D,MAAIA,MAAQ,mBAAmB,KAAKA,EAAI,SAAS,KAAM,YAAY,KAAKA,EAAI,SAAS,KAAKA,EAAI,iBAAiB,GAAK,QAAO;AAC3H,QAAMC,IAAQ,IAAI,MAAA;AAClB,SAAAA,EAAM,SAAS,KACR,KAAK,IAAIA,EAAM,SAAS,GAAG,IAAI;AACxC;AAEO,MAAMC,IAAU,CAACC,MAAsB,KAAK,IAAI,GAAG,KAAK,IAAI,GAAGA,CAAC,CAAC;"}

package/dist/audio/sampleBank.js

@@ -0,0 +1,82 @@
+import { cleanSamples as d } from "./cleanTake.js";
+const c = {};
+function k(e) {
+  for (const [n, t] of Object.entries(e)) {
+    const r = /(?:^|\/)([a-z_]+?)(?:_\d+)?\.mp3$/.exec(n);
+    r && (c[r[1]] ??= []).push(t);
+  }
+}
+const y = (e) => !!c[e];
+class M {
+  decoded = /* @__PURE__ */ new Map();
+  loading = /* @__PURE__ */ new Set();
+  last = /* @__PURE__ */ new Map();
+  names() {
+    return Object.keys(c);
+  }
+  /** A decoded take, or null while none is ready (the caller then synthesises); starts loading on first ask. */
+  take(n, t) {
+    const r = this.decoded.get(t);
+    if (!r?.length)
+      return this.load(n, t), null;
+    let s = Math.floor(Math.random() * r.length);
+    return r.length > 1 && s === this.last.get(t) && (s = (s + 1) % r.length), this.last.set(t, s), r[s];
+  }
+  load(n, t) {
+    const r = c[t];
+    if (!r || this.loading.has(t)) return;
+    this.loading.add(t);
+    const s = [];
+    this.decoded.set(t, s);
+    for (const l of r)
+      fetch(l).then((a) => a.arrayBuffer()).then((a) => n.decodeAudioData(a)).then((a) => p(a)).then((a) => {
+        if (!a) return;
+        const h = n.createBuffer(1, a.length, n.sampleRate);
+        h.copyToChannel(a, 0), s.push(h);
+      }).catch(() => {
+      });
+  }
+}
+let o, f = 0;
+const i = /* @__PURE__ */ new Map();
+function m() {
+  if (o !== void 0) return o;
+  try {
+    o = new Worker(new URL(
+      /* @vite-ignore */
+      "" + new URL("../assets/takeCleanerWorker-DTcI_Jqr.js", import.meta.url).href,
+      import.meta.url
+    ), { type: "module" }), o.onmessage = (e) => {
+      i.get(e.data.id)?.(e.data.data), i.delete(e.data.id);
+    }, o.onerror = () => {
+      o?.terminate(), o = null;
+      for (const e of i.values()) e(null);
+      i.clear();
+    };
+  } catch {
+    o = null;
+  }
+  return o;
+}
+let u = Promise.resolve();
+function p(e) {
+  return new Promise((n) => {
+    u = u.then(() => new Promise((t) => setTimeout(t, 0))).then(() => {
+      g(e).then(n, () => n(null));
+    });
+  });
+}
+function g(e) {
+  const n = Array.from({ length: e.numberOfChannels }, (s, l) => e.getChannelData(l).slice()), t = m();
+  if (!t) return Promise.resolve(d(n, e.sampleRate));
+  const r = f++;
+  return new Promise((s) => {
+    i.set(r, s), t.postMessage({ id: r, channels: n, sampleRate: e.sampleRate }, { transfer: n.map((l) => l.buffer) });
+  });
+}
+export {
+  M as SampleBank,
+  y as hasTakes,
+  k as registerTakes
+};
+//# sourceMappingURL=sampleBank.js.map

package/dist/audio/sampleBank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampleBank.js","sources":["../../src/audio/sampleBank.ts"],"sourcesContent":["/**\n * The recorded takes of the sounds, registered by the game (`registerTakes`): `<sound>.mp3`, and `<sound>_2.mp3`…\n * when a sound has more than one. A\n * sound with takes plays one of them at random, never the same one twice running when it has more; a sound without\n * any — or whose takes have not decoded yet — falls back to its synth recipe in `SoundEngine`.\n *\n * Every take is cleaned once on decode (`cleanTake.ts`: mono, silence trimmed, one loudness), off the main thread\n * in `takeCleanerWorker.ts`, so `sounds.json`'s `fileGain` is the only mix knob. Measured on the first batch, peaks\n * alone left their loudness 20 dB apart.\n */\n\nimport { cleanSamples } from './cleanTake';\n\nconst TAKES: Record<string, string[]> = {};\n\n/**\n * Registers recorded takes by file path → url, e.g. a Vite `import.meta.glob('./sfx/*.mp3', { query: '?url',\n * import: 'default', eager: true })`. `hit.mp3`, `hit_2.mp3`… are takes of `hit`; sound names carry no digits.\n */\nexport function registerTakes(urls: Record<string, string>): void {\n  for (const [path, url] of Object.entries(urls)) {\n    const m = /(?:^|\\/)([a-z_]+?)(?:_\\d+)?\\.mp3$/.exec(path);\n    if (m) (TAKES[m[1]!] ??= []).push(url);\n  }\n}\n\n/** The sound has recorded takes in the build (decoded or not). */\nexport const hasTakes = (name: string): boolean => !!TAKES[name];\n\nexport class SampleBank {\n  private readonly decoded = new Map<string, AudioBuffer[]>();\n  private readonly loading = new Set<string>();\n  private readonly last = new Map<string, number>();\n\n  names(): string[] {\n    return Object.keys(TAKES);\n  }\n\n  /** A decoded take, or null while none is ready (the caller then synthesises); starts loading on first ask. */\n  take(ctx: AudioContext, name: string): AudioBuffer | null {\n    const list = this.decoded.get(name);\n    if (!list?.length) {\n      this.load(ctx, name);\n      return null;\n    }\n    let i = Math.floor(Math.random() * list.length);\n    if (list.length > 1 && i === this.last.get(name)) i = (i + 1) % list.length;\n    this.last.set(name, i);\n    return list[i]!;\n  }\n\n  load(ctx: AudioContext, name: string): void {\n    const urlsOf = TAKES[name];\n    if (!urlsOf || this.loading.has(name)) return;\n    this.loading.add(name);\n    const list: AudioBuffer[] = [];\n    this.decoded.set(name, list);\n    for (const url of urlsOf) {\n      fetch(url)\n        .then((r) => r.arrayBuffer())\n        .then((data) => ctx.decodeAudioData(data))\n        .then((buf) => clean(buf))\n        .then((data) => {\n          if (!data) return;\n          const out = ctx.createBuffer(1, data.length, ctx.sampleRate);\n          out.copyToChannel(data as Float32Array<ArrayBuffer>, 0);\n          list.push(out);\n        })\n        .catch(() => {});\n    }\n  }\n}\n\nlet worker: Worker | null | undefined;\nlet nextId = 0;\nconst waiting = new Map<number, (data: Float32Array | null) => void>();\n\n/** The cleaner worker, started on first use; null where workers cannot start (then takes are cleaned here). */\nfunction cleaner(): Worker | null {\n  if (worker !== undefined) return worker;\n  try {\n    worker = new Worker(new URL('./takeCleanerWorker.ts', import.meta.url), { type: 'module' });\n    worker.onmessage = (e: MessageEvent<{ id: number; data: Float32Array | null }>) => {\n      waiting.get(e.data.id)?.(e.data.data);\n      waiting.delete(e.data.id);\n    };\n    worker.onerror = () => {\n      worker?.terminate();\n      worker = null;\n      for (const done of waiting.values()) done(null);\n      waiting.clear();\n    };\n  } catch {\n    worker = null;\n  }\n  return worker;\n}\n\n/** Takes handed over one per task: a fight's first blows ask for a dozen at once, and copying them all out in one\n *  task still froze a frame. */\nlet turn: Promise<void> = Promise.resolve();\n\n/** A decoded take cleaned at the context's own rate (decodeAudioData resamples to it). */\nfunction clean(buf: AudioBuffer): Promise<Float32Array | null> {\n  return new Promise((resolve) => {\n    turn = turn\n      .then(() => new Promise<void>((r) => setTimeout(r, 0)))\n      .then(() => {\n        send(buf).then(resolve, () => resolve(null));\n      });\n  });\n}\n\nfunction send(buf: AudioBuffer): Promise<Float32Array | null> {\n  const channels = Array.from({ length: buf.numberOfChannels }, (_, c) => buf.getChannelData(c).slice());\n  const w = cleaner();\n  if (!w) return Promise.resolve(cleanSamples(channels, buf.sampleRate));\n  const id = nextId++;\n  return new Promise((resolve) => {\n    waiting.set(id, resolve);\n    w.postMessage({ id, channels, sampleRate: buf.sampleRate }, { transfer: channels.map((c) => c.buffer as ArrayBuffer) });\n  });\n}\n"],"names":["TAKES","registerTakes","urls","path","url","m","hasTakes","name","SampleBank","ctx","list","i","urlsOf","r","data","buf","clean","out","worker","nextId","waiting","cleaner","done","turn","resolve","send","channels","_","c","w","cleanSamples","id"],"mappings":"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"}

package/dist/audio/soundTable.js

@@ -0,0 +1,9 @@
+const s = { master: 1, recipes: {} };
+function r(e) {
+  e.master !== void 0 && (s.master = e.master), e.recipes && Object.assign(s.recipes, e.recipes);
+}
+export {
+  s as SOUNDS,
+  r as registerSounds
+};
+//# sourceMappingURL=soundTable.js.map

package/dist/audio/soundTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soundTable.js","sources":["../../src/audio/soundTable.ts"],"sourcesContent":["import type { SynthRecipe } from './synth';\n\n/**\n * The sounds the engine can play: synthesised recipes by name, plus the master share every sound plays at. Empty\n * until the game registers its own (`registerSounds`); the mapping from game happenings to sound names stays in\n * the game.\n */\nexport interface SoundTable {\n  /** Share of the effects volume everything plays at: keeps full volume modest next to the music. */\n  master: number;\n  recipes: Record<string, SynthRecipe>;\n}\n\nexport const SOUNDS: SoundTable = { master: 1, recipes: {} };\n\nexport function registerSounds(table: Partial<SoundTable>): void {\n  if (table.master !== undefined) SOUNDS.master = table.master;\n  if (table.recipes) Object.assign(SOUNDS.recipes, table.recipes);\n}\n"],"names":["SOUNDS","registerSounds","table"],"mappings":"AAaO,MAAMA,IAAqB,EAAE,QAAQ,GAAG,SAAS,CAAA,EAAC;AAElD,SAASC,EAAeC,GAAkC;AAC/D,EAAIA,EAAM,WAAW,WAAWF,EAAO,SAASE,EAAM,SAClDA,EAAM,WAAS,OAAO,OAAOF,EAAO,SAASE,EAAM,OAAO;AAChE;"}

package/dist/audio/synth.js

@@ -0,0 +1,36 @@
+const Y = 22050, N = {
+  sine: (e) => Math.sin(e * Math.PI * 2),
+  square: (e, a) => e < a ? 1 : -1,
+  tri: (e) => 1 - 4 * Math.abs(e - 0.5),
+  saw: (e) => 2 * e - 1
+}, i = (e, a, n) => e > 0 && a > 0 ? e * Math.pow(a / e, n) : e + (a - e) * n;
+function R(e) {
+  return 1 - Math.exp(-2 * Math.PI * Math.min(e, 22050 * 0.45) / 22050);
+}
+function _(e) {
+  const a = Math.max(...e.layers.map((t) => (t.d ?? 0) + t.t)), n = new Float32Array(Math.ceil(a * 22050) + 1);
+  let s = 2654435769;
+  const S = () => (s ^= s << 13, s ^= s >>> 17, s ^= s << 5, (s >>> 0) / 4294967295 * 2 - 1);
+  for (const t of e.layers) {
+    const u = Math.round((t.d ?? 0) * 22050), f = Math.round(t.t * 22050), l = Math.max(1, Math.round((t.at ?? 4e-3) * 22050));
+    let c = 0, A = 0, M = 0, T = 0;
+    for (let o = 0; o < f && u + o < n.length; o++) {
+      const p = o / f, d = t.f ? i(t.f[0], t.f[1], p) : 0;
+      c += d / 22050;
+      const E = c - Math.floor(c);
+      let h;
+      t.w === "noise" ? ((!t.f || E < d / 22050 || o === 0) && (A = S()), h = t.f ? A : S()) : h = N[t.w](E, t.duty ?? 0.5), t.lp && (M += (h - M) * R(i(t.lp[0], t.lp[1], p)), h = M), t.hp && (T += (h - T) * R(i(t.hp[0], t.hp[1], p)), h -= T);
+      const H = o < l ? o / l : Math.pow(1 - (o - l) / Math.max(1, f - l), t.c ?? 2);
+      n[u + o] += h * H * t.g;
+    }
+  }
+  let r = 0;
+  for (const t of n) r = Math.max(r, Math.abs(t));
+  if (r > 0.95) for (let t = 0; t < n.length; t++) n[t] *= 0.95 / r;
+  return n;
+}
+export {
+  Y as SYNTH_RATE,
+  _ as renderRecipe
+};
+//# sourceMappingURL=synth.js.map

package/dist/audio/synth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synth.js","sources":["../../src/audio/synth.ts"],"sourcesContent":["/**\n * The combat sounds are written, not recorded: a few oscillator or noise layers rendered straight into a buffer\n * (`sounds.json` → `recipes`). Lo-fi on purpose — 22 kHz mono, short and soft — so they sit with the pixel art\n * instead of pretending to be a recording.\n */\nexport const SYNTH_RATE = 22050;\n\nexport interface SynthLayer {\n  /** Waveform; `noise` is white noise, or sample-and-hold noise at `f` Hz when `f` is given (crunchier). */\n  w: 'sine' | 'square' | 'tri' | 'saw' | 'noise';\n  /** Pitch at the start and at the end of the layer (Hz), swept exponentially. */\n  f?: [number, number];\n  /** Length (s). */\n  t: number;\n  /** Delay before the layer starts (s). */\n  d?: number;\n  /** Attack (s). */\n  at?: number;\n  g: number;\n  /** Decay curve exponent: 1 is linear, higher falls away faster. */\n  c?: number;\n  duty?: number;\n  /** Low- and high-pass cutoff at the start and the end (Hz). */\n  lp?: [number, number];\n  hp?: [number, number];\n}\n\nexport interface SynthRecipe {\n  layers: SynthLayer[];\n  /** Random pitch spread per play (share of 1); the engine's default when absent. */\n  jitter?: number;\n  /** Level of the sound's recorded takes (`registerTakes`), which are normalised on decode; default 1. */\n  fileGain?: number;\n}\n\nconst WAVES: Record<Exclude<SynthLayer['w'], 'noise'>, (p: number, duty: number) => number> = {\n  sine: (p) => Math.sin(p * Math.PI * 2),\n  square: (p, duty) => (p < duty ? 1 : -1),\n  tri: (p) => 1 - 4 * Math.abs(p - 0.5),\n  saw: (p) => 2 * p - 1,\n};\n\nconst sweep = (a: number, b: number, k: number): number => (a > 0 && b > 0 ? a * Math.pow(b / a, k) : a + (b - a) * k);\n\n/** A one-pole filter is enough for a stand-in, and it cannot ring or blow up the way a swept biquad can. */\nfunction onePole(cut: number): number {\n  return 1 - Math.exp((-2 * Math.PI * Math.min(cut, SYNTH_RATE * 0.45)) / SYNTH_RATE);\n}\n\nexport function renderRecipe(recipe: SynthRecipe): Float32Array {\n  const total = Math.max(...recipe.layers.map((l) => (l.d ?? 0) + l.t));\n  const out = new Float32Array(Math.ceil(total * SYNTH_RATE) + 1);\n  let seed = 0x9e3779b9;\n  const rand = () => {\n    seed ^= seed << 13;\n    seed ^= seed >>> 17;\n    seed ^= seed << 5;\n    return ((seed >>> 0) / 0xffffffff) * 2 - 1;\n  };\n  for (const l of recipe.layers) {\n    const start = Math.round((l.d ?? 0) * SYNTH_RATE);\n    const n = Math.round(l.t * SYNTH_RATE);\n    const at = Math.max(1, Math.round((l.at ?? 0.004) * SYNTH_RATE));\n    let phase = 0;\n    let held = 0;\n    let lpState = 0;\n    let hpState = 0;\n    for (let i = 0; i < n && start + i < out.length; i++) {\n      const k = i / n;\n      const freq = l.f ? sweep(l.f[0], l.f[1], k) : 0;\n      phase += freq / SYNTH_RATE;\n      const p = phase - Math.floor(phase);\n      let s: number;\n      if (l.w === 'noise') {\n        // sample-and-hold: a new value each time the phase wraps, which is what makes it crunch\n        if (!l.f || p < freq / SYNTH_RATE || i === 0) held = rand();\n        s = l.f ? held : rand();\n      } else s = WAVES[l.w](p, l.duty ?? 0.5);\n      if (l.lp) {\n        lpState += (s - lpState) * onePole(sweep(l.lp[0], l.lp[1], k));\n        s = lpState;\n      }\n      if (l.hp) {\n        hpState += (s - hpState) * onePole(sweep(l.hp[0], l.hp[1], k));\n        s -= hpState;\n      }\n      const env = i < at ? i / at : Math.pow(1 - (i - at) / Math.max(1, n - at), l.c ?? 2);\n      out[start + i]! += s * env * l.g;\n    }\n  }\n  // a stand-in never clips: peaks are brought back under full scale\n  let peak = 0;\n  for (const v of out) peak = Math.max(peak, Math.abs(v));\n  if (peak > 0.95) for (let i = 0; i < out.length; i++) out[i]! *= 0.95 / peak;\n  return out;\n}\n"],"names":["SYNTH_RATE","WAVES","p","duty","sweep","a","b","k","onePole","cut","renderRecipe","recipe","total","l","out","seed","rand","start","n","at","phase","held","lpState","hpState","i","freq","s","env","peak","v"],"mappings":"AAKO,MAAMA,IAAa,OA8BpBC,IAAwF;AAAA,EAC5F,MAAM,CAACC,MAAM,KAAK,IAAIA,IAAI,KAAK,KAAK,CAAC;AAAA,EACrC,QAAQ,CAACA,GAAGC,MAAUD,IAAIC,IAAO,IAAI;AAAA,EACrC,KAAK,CAACD,MAAM,IAAI,IAAI,KAAK,IAAIA,IAAI,GAAG;AAAA,EACpC,KAAK,CAACA,MAAM,IAAIA,IAAI;AACtB,GAEME,IAAQ,CAACC,GAAWC,GAAWC,MAAuBF,IAAI,KAAKC,IAAI,IAAID,IAAI,KAAK,IAAIC,IAAID,GAAGE,CAAC,IAAIF,KAAKC,IAAID,KAAKE;AAGpH,SAASC,EAAQC,GAAqB;AACpC,SAAO,IAAI,KAAK,IAAK,KAAK,KAAK,KAAK,KAAK,IAAIA,GAAK,QAAa,IAAI,IAAK,KAAU;AACpF;AAEO,SAASC,EAAaC,GAAmC;AAC9D,QAAMC,IAAQ,KAAK,IAAI,GAAGD,EAAO,OAAO,IAAI,CAACE,OAAOA,EAAE,KAAK,KAAKA,EAAE,CAAC,CAAC,GAC9DC,IAAM,IAAI,aAAa,KAAK,KAAKF,IAAQ,KAAU,IAAI,CAAC;AAC9D,MAAIG,IAAO;AACX,QAAMC,IAAO,OACXD,KAAQA,KAAQ,IAChBA,KAAQA,MAAS,IACjBA,KAAQA,KAAQ,IACPA,MAAS,KAAK,aAAc,IAAI;AAE3C,aAAWF,KAAKF,EAAO,QAAQ;AAC7B,UAAMM,IAAQ,KAAK,OAAOJ,EAAE,KAAK,KAAK,KAAU,GAC1CK,IAAI,KAAK,MAAML,EAAE,IAAI,KAAU,GAC/BM,IAAK,KAAK,IAAI,GAAG,KAAK,OAAON,EAAE,MAAM,QAAS,KAAU,CAAC;AAC/D,QAAIO,IAAQ,GACRC,IAAO,GACPC,IAAU,GACVC,IAAU;AACd,aAASC,IAAI,GAAGA,IAAIN,KAAKD,IAAQO,IAAIV,EAAI,QAAQU,KAAK;AACpD,YAAMjB,IAAIiB,IAAIN,GACRO,IAAOZ,EAAE,IAAIT,EAAMS,EAAE,EAAE,CAAC,GAAGA,EAAE,EAAE,CAAC,GAAGN,CAAC,IAAI;AAC9C,MAAAa,KAASK,IAAO;AAChB,YAAMvB,IAAIkB,IAAQ,KAAK,MAAMA,CAAK;AAClC,UAAIM;AACJ,MAAIb,EAAE,MAAM,YAEN,CAACA,EAAE,KAAKX,IAAIuB,IAAO,SAAcD,MAAM,OAAGH,IAAOL,EAAA,IACrDU,IAAIb,EAAE,IAAIQ,IAAOL,EAAA,SACRf,EAAMY,EAAE,CAAC,EAAEX,GAAGW,EAAE,QAAQ,GAAG,GAClCA,EAAE,OACJS,MAAYI,IAAIJ,KAAWd,EAAQJ,EAAMS,EAAE,GAAG,CAAC,GAAGA,EAAE,GAAG,CAAC,GAAGN,CAAC,CAAC,GAC7DmB,IAAIJ,IAEFT,EAAE,OACJU,MAAYG,IAAIH,KAAWf,EAAQJ,EAAMS,EAAE,GAAG,CAAC,GAAGA,EAAE,GAAG,CAAC,GAAGN,CAAC,CAAC,GAC7DmB,KAAKH;AAEP,YAAMI,IAAMH,IAAIL,IAAKK,IAAIL,IAAK,KAAK,IAAI,KAAKK,IAAIL,KAAM,KAAK,IAAI,GAAGD,IAAIC,CAAE,GAAGN,EAAE,KAAK,CAAC;AACnF,MAAAC,EAAIG,IAAQO,CAAC,KAAME,IAAIC,IAAMd,EAAE;AAAA,IACjC;AAAA,EACF;AAEA,MAAIe,IAAO;AACX,aAAWC,KAAKf,EAAK,CAAAc,IAAO,KAAK,IAAIA,GAAM,KAAK,IAAIC,CAAC,CAAC;AACtD,MAAID,IAAO,KAAM,UAASJ,IAAI,GAAGA,IAAIV,EAAI,QAAQU,IAAK,CAAAV,EAAIU,CAAC,KAAM,OAAOI;AACxE,SAAOd;AACT;"}

package/dist/core/BitmapLabel.js

@@ -0,0 +1,49 @@
+import { DynamicBitmapFont as S, BitmapFont as d, BitmapText as $ } from "pixi.js";
+import { GameObject as h } from "./gameObject.js";
+const m = /* @__PURE__ */ new Set(), u = [[" ", "~"]];
+function w(s) {
+  u.push(s);
+}
+const x = 128;
+function b(s, t, e, r, c, a, n = "") {
+  const i = `label|${s}|${t}|${e}|${r}|${c}|${a}${n ? `|${n}` : ""}`;
+  if (!m.has(i)) {
+    const o = S.defaultOptions, l = o.textureSize;
+    o.textureSize = x;
+    try {
+      d.install({
+        name: i,
+        chars: n ? [...u, n] : u,
+        resolution: a,
+        style: { fontFamily: s, fontSize: t, fill: e, stroke: { color: r, width: c, join: "round" } }
+      });
+    } finally {
+      o.textureSize = l;
+    }
+    m.add(i);
+  }
+  return i;
+}
+class y extends h($) {
+  /**
+   * `fontFamily` must already be loaded (`document.fonts.load`), or the glyphs bake in the fallback.
+   * Styled like `worldText`: the same font, size, colour and outline, rasterised at the same resolution. `glyphs`:
+   * letters beyond ASCII it prints (see `installLabelFont`).
+   */
+  constructor(t, e, r, c, a, n, i, o, l, f = "") {
+    const p = b(c, a, n, i, o, l, f);
+    super({ text: r, style: { fontFamily: p, fontSize: a } }), this.position.set(t, e);
+  }
+  setOrigin(t = 0.5, e = t) {
+    return this.anchor.set(t, e), this;
+  }
+  setText(t) {
+    return this.text = t, this;
+  }
+}
+export {
+  y as BitmapLabel,
+  w as addLabelGlyphs,
+  b as installLabelFont
+};
+//# sourceMappingURL=BitmapLabel.js.map

package/dist/core/BitmapLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmapLabel.js","sources":["../../src/core/BitmapLabel.ts"],"sourcesContent":["import { BitmapFont, BitmapText, DynamicBitmapFont } from 'pixi.js';\nimport { GameObject } from './gameObject';\n\nconst INSTALLED = new Set<string>();\n\n/**\n * The glyphs baked into every label font: printable ASCII (space to `~`) plus whatever a game adds (`addLabelGlyphs`)\n * for the words its labels print, so no glyph is baked mid-frame onto a fresh page (a new canvas a page, and iOS\n * hands out none once its canvas memory is spent).\n */\nconst CHARS: (string | [string, string])[] = [[' ', '~']];\n\n/**\n * Adds letters every label font made **after this call** bakes ahead — the accented letters of a language the labels\n * print (German's `'äöüß'`, say), an arrow, a star. A font already installed keeps the glyphs it was made with, so\n * call it once at start-up, before the first label or `FloatingText.warm`.\n *\n * Without it, a label font holds ASCII only: a letter outside it is still drawn (Pixi bakes it when first printed),\n * but on that frame, onto a new glyph page — the stall and the canvas memory this module exists to avoid. For one\n * font's own extra letters, pass them to `installLabelFont` (or `Label.bitmap`, `FloatingText`'s `glyphs`) instead.\n */\nexport function addLabelGlyphs(letters: string): void {\n  CHARS.push(letters);\n}\n/**\n * The side of one glyph page in CSS pixels; a page's canvas is this × the resolution. Pixi's default, 512, made every\n * label font a 2048² canvas at resolution 4 (16 MB each, ten of them at boot); the numbers' glyphs fill a few pages of\n * this size instead.\n */\nconst PAGE_SIZE = 128;\n\n/**\n * Rasterises one label font once and returns its name. Called ahead of time for the damage numbers: baking a font on\n * its first number froze the first frame that printed one by ~60 ms. `glyphs` are letters this font bakes besides\n * ASCII and `addLabelGlyphs`' (a font with its own is a font of its own: pass the same `glyphs` wherever it is used).\n */\nexport function installLabelFont(fontFamily: string, size: number, color: string, stroke: string, strokeWidth: number, resolution: number, glyphs = ''): string {\n  const name = `label|${fontFamily}|${size}|${color}|${stroke}|${strokeWidth}|${resolution}${glyphs ? `|${glyphs}` : ''}`;\n  if (!INSTALLED.has(name)) {\n    // `install` takes no page size of its own: it reads the dynamic font's default, set for this call only\n    const defaults = DynamicBitmapFont.defaultOptions;\n    const was = defaults.textureSize;\n    defaults.textureSize = PAGE_SIZE;\n    try {\n      BitmapFont.install({\n        name,\n        chars: glyphs ? [...CHARS, glyphs] : CHARS,\n        resolution,\n        style: { fontFamily, fontSize: size, fill: color, stroke: { color: stroke, width: strokeWidth, join: 'round' } },\n      });\n    } finally {\n      defaults.textureSize = was;\n    }\n    INSTALLED.add(name);\n  }\n  return name;\n}\n\n/**\n * Text drawn from a bitmap font: the glyphs are rasterised once per font, so changing the string costs no canvas\n * redraw and no texture upload, and every label of one font batches with the others. For the floating numbers, which\n * a crowded fight throws dozens of a second — a plain `Text` repaints its canvas at resolution 4 and uploads it on\n * every change.\n */\nexport class BitmapLabel extends GameObject(BitmapText) {\n  /**\n   * `fontFamily` must already be loaded (`document.fonts.load`), or the glyphs bake in the fallback.\n   * Styled like `worldText`: the same font, size, colour and outline, rasterised at the same resolution. `glyphs`:\n   * letters beyond ASCII it prints (see `installLabelFont`).\n   */\n  constructor(x: number, y: number, text: string, fontFamily: string, size: number, color: string, stroke: string, strokeWidth: number, resolution: number, glyphs = '') {\n    const name = installLabelFont(fontFamily, size, color, stroke, strokeWidth, resolution, glyphs);\n    super({ text, style: { fontFamily: name, fontSize: size } });\n    this.position.set(x, y);\n  }\n\n  setOrigin(x = 0.5, y = x): this {\n    this.anchor.set(x, y);\n    return this;\n  }\n\n  setText(text: string): this {\n    this.text = text;\n    return this;\n  }\n}\n"],"names":["INSTALLED","CHARS","addLabelGlyphs","letters","PAGE_SIZE","installLabelFont","fontFamily","size","color","stroke","strokeWidth","resolution","glyphs","name","defaults","DynamicBitmapFont","was","BitmapFont","BitmapLabel","GameObject","BitmapText","x","y","text"],"mappings":";;AAGA,MAAMA,wBAAgB,IAAA,GAOhBC,IAAuC,CAAC,CAAC,KAAK,GAAG,CAAC;AAWjD,SAASC,EAAeC,GAAuB;AACpD,EAAAF,EAAM,KAAKE,CAAO;AACpB;AAMA,MAAMC,IAAY;AAOX,SAASC,EAAiBC,GAAoBC,GAAcC,GAAeC,GAAgBC,GAAqBC,GAAoBC,IAAS,IAAY;AAC9J,QAAMC,IAAO,SAASP,CAAU,IAAIC,CAAI,IAAIC,CAAK,IAAIC,CAAM,IAAIC,CAAW,IAAIC,CAAU,GAAGC,IAAS,IAAIA,CAAM,KAAK,EAAE;AACrH,MAAI,CAACZ,EAAU,IAAIa,CAAI,GAAG;AAExB,UAAMC,IAAWC,EAAkB,gBAC7BC,IAAMF,EAAS;AACrB,IAAAA,EAAS,cAAcV;AACvB,QAAI;AACF,MAAAa,EAAW,QAAQ;AAAA,QACjB,MAAAJ;AAAA,QACA,OAAOD,IAAS,CAAC,GAAGX,GAAOW,CAAM,IAAIX;AAAA,QACrC,YAAAU;AAAA,QACA,OAAO,EAAE,YAAAL,GAAY,UAAUC,GAAM,MAAMC,GAAO,QAAQ,EAAE,OAAOC,GAAQ,OAAOC,GAAa,MAAM,UAAQ;AAAA,MAAE,CAChH;AAAA,IACH,UAAA;AACE,MAAAI,EAAS,cAAcE;AAAA,IACzB;AACA,IAAAhB,EAAU,IAAIa,CAAI;AAAA,EACpB;AACA,SAAOA;AACT;AAQO,MAAMK,UAAoBC,EAAWC,CAAU,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMtD,YAAYC,GAAWC,GAAWC,GAAcjB,GAAoBC,GAAcC,GAAeC,GAAgBC,GAAqBC,GAAoBC,IAAS,IAAI;AACrK,UAAMC,IAAOR,EAAiBC,GAAYC,GAAMC,GAAOC,GAAQC,GAAaC,GAAYC,CAAM;AAC9F,UAAM,EAAE,MAAAW,GAAM,OAAO,EAAE,YAAYV,GAAM,UAAUN,EAAA,GAAQ,GAC3D,KAAK,SAAS,IAAIc,GAAGC,CAAC;AAAA,EACxB;AAAA,EAEA,UAAUD,IAAI,KAAKC,IAAID,GAAS;AAC9B,gBAAK,OAAO,IAAIA,GAAGC,CAAC,GACb;AAAA,EACT;AAAA,EAEA,QAAQC,GAAoB;AAC1B,gBAAK,OAAOA,GACL;AAAA,EACT;AACF;"}