@babylonjs/lite 1.4.0 → 1.5.0

package/lib/audio/analyzer.js

@@ -0,0 +1,65 @@
+const Defaults = {
+  fftSize: 2048,
+  minDecibels: -100,
+  maxDecibels: -30,
+  smoothing: 0.8
+};
+function applyAnalyzerOptions(node, options) {
+  if (options.fftSize !== void 0) {
+    node.fftSize = options.fftSize;
+  }
+  if (options.minDecibels !== void 0) {
+    node.minDecibels = options.minDecibels;
+  }
+  if (options.maxDecibels !== void 0) {
+    node.maxDecibels = options.maxDecibels;
+  }
+  if (options.smoothing !== void 0) {
+    node.smoothingTimeConstant = options.smoothing;
+  }
+}
+function createAnalyzerSubNode(engine, options) {
+  const node = new AnalyserNode(engine._ctx);
+  node.fftSize = Defaults.fftSize;
+  node.minDecibels = Defaults.minDecibels;
+  node.maxDecibels = Defaults.maxDecibels;
+  node.smoothingTimeConstant = Defaults.smoothing;
+  applyAnalyzerOptions(node, options);
+  return {
+    _engine: engine,
+    _node: node,
+    _dispose: () => {
+      node.disconnect();
+    }
+  };
+}
+function ensureAnalyzerSubNode(host, options = {}) {
+  const graph = host._graph;
+  if (graph._analyzer) {
+    const existing = graph._analyzer;
+    applyAnalyzerOptions(existing._node, options);
+    return existing;
+  }
+  const node = createAnalyzerSubNode(host._engine, options);
+  graph._volume.connect(node._node);
+  graph._analyzer = node;
+  return node;
+}
+function enableAnalyzer(host, options = {}) {
+  ensureAnalyzerSubNode(host, options);
+}
+function getByteFrequencyData(host, out) {
+  ensureAnalyzerSubNode(host)._node.getByteFrequencyData(out);
+}
+function getFloatFrequencyData(host, out) {
+  ensureAnalyzerSubNode(host)._node.getFloatFrequencyData(out);
+}
+function getByteTimeDomainData(host, out) {
+  ensureAnalyzerSubNode(host)._node.getByteTimeDomainData(out);
+}
+function getFloatTimeDomainData(host, out) {
+  ensureAnalyzerSubNode(host)._node.getFloatTimeDomainData(out);
+}
+
+export { enableAnalyzer, getByteFrequencyData, getByteTimeDomainData, getFloatFrequencyData, getFloatTimeDomainData };
+//# sourceMappingURL=analyzer.js.map

package/lib/audio/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sources":["../../../src/audio/analyzer.ts"],"sourcesContent":["/**\n * Frequency / amplitude analysis — opt-in feature module.\n *\n * Faithful port of AudioV2 `_AudioAnalyzer` / `_WebAudioAnalyzer`, re-architected\n * to Lite idioms (pure state + standalone functions). Building the sub-node is\n * lazy, so importing nothing from here costs nothing.\n *\n * The analyzer wraps a Web Audio `AnalyserNode`. Mirroring AudioV2\n * `_WebAudioBaseSubGraph._onSubNodesChanged`, it is a passive *tap* off the\n * volume node (`_volume.connect(analyser)`); it is never part of the audible\n * through-chain, so it does not affect the sub-graph head.\n */\n\nimport { type AudioEngine } from \"./audio-engine.js\";\nimport { type AudioGraphHost, type AudioGraphHostState } from \"./host-types.js\";\n\n/** Default analyzer settings (match AudioV2 / Web Audio defaults). */\nconst Defaults = {\n    fftSize: 2048,\n    minDecibels: -100,\n    maxDecibels: -30,\n    smoothing: 0.8,\n} as const;\n\n/** Options for {@link enableAnalyzer}. */\nexport interface AudioAnalyzerOptions {\n    /** FFT window size (a power of two, `32`–`32768`). Defaults to `2048`. */\n    fftSize?: number;\n    /** Minimum power value for the dB range, in dBFS. Defaults to `-100`. */\n    minDecibels?: number;\n    /** Maximum power value for the dB range, in dBFS. Defaults to `-30`. */\n    maxDecibels?: number;\n    /** Time-averaging constant in `[0, 1]`. Defaults to `0.8`. */\n    smoothing?: number;\n}\n\n/** Analyzer tap sub-node state. Pure state — driven by the analyzer functions. @internal */\nexport interface AnalyzerSubNode {\n    /** @internal */ _engine: AudioEngine;\n    /** @internal */ _node: AnalyserNode;\n    /** @internal */ _dispose: () => void;\n}\n\nfunction applyAnalyzerOptions(node: AnalyserNode, options: AudioAnalyzerOptions): void {\n    if (options.fftSize !== undefined) {\n        node.fftSize = options.fftSize;\n    }\n    if (options.minDecibels !== undefined) {\n        node.minDecibels = options.minDecibels;\n    }\n    if (options.maxDecibels !== undefined) {\n        node.maxDecibels = options.maxDecibels;\n    }\n    if (options.smoothing !== undefined) {\n        node.smoothingTimeConstant = options.smoothing;\n    }\n}\n\nfunction createAnalyzerSubNode(engine: AudioEngine, options: AudioAnalyzerOptions): AnalyzerSubNode {\n    const node = new AnalyserNode(engine._ctx);\n    node.fftSize = Defaults.fftSize;\n    node.minDecibels = Defaults.minDecibels;\n    node.maxDecibels = Defaults.maxDecibels;\n    node.smoothingTimeConstant = Defaults.smoothing;\n    applyAnalyzerOptions(node, options);\n    return {\n        _engine: engine,\n        _node: node,\n        _dispose: () => {\n            node.disconnect();\n        },\n    };\n}\n\n/**\n * Lazily build the analyzer tap and attach it to the host's volume output.\n * Idempotent; re-applies any supplied options to an existing analyzer.\n */\nfunction ensureAnalyzerSubNode(host: AudioGraphHostState, options: AudioAnalyzerOptions = {}): AnalyzerSubNode {\n    const graph = host._graph;\n    if (graph._analyzer) {\n        // The graph stores a structural slot; this feature module owns the full node.\n        const existing = graph._analyzer as AnalyzerSubNode;\n        applyAnalyzerOptions(existing._node, options);\n        return existing;\n    }\n\n    const node = createAnalyzerSubNode(host._engine, options);\n    graph._volume.connect(node._node);\n    graph._analyzer = node;\n    return node;\n}\n\n// ─── Public API ──────────────────────────────────────────────────────\n\n/**\n * Enables (or reconfigures) frequency/amplitude analysis on a sound or bus,\n * building the analyzer tap on first use. Pulls the analyzer module only when\n * called.\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param options - Analyzer options (fftSize, dB range, smoothing).\n */\nexport function enableAnalyzer(host: AudioGraphHost, options: AudioAnalyzerOptions = {}): void {\n    ensureAnalyzerSubNode(host, options);\n}\n\n/**\n * Writes the current frequency-domain data as unsigned bytes into `out`,\n * building the analyzer tap on first use. `out` should be sized to the\n * analyzer's `frequencyBinCount` (`fftSize / 2`).\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param out - Destination buffer; values are written in place.\n */\nexport function getByteFrequencyData(host: AudioGraphHost, out: Uint8Array): void {\n    ensureAnalyzerSubNode(host)._node.getByteFrequencyData(out as Uint8Array<ArrayBuffer>);\n}\n\n/**\n * Writes the current frequency-domain data as floats (in dBFS) into `out`,\n * building the analyzer tap on first use. `out` should be sized to the\n * analyzer's `frequencyBinCount` (`fftSize / 2`).\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param out - Destination buffer; values are written in place.\n */\nexport function getFloatFrequencyData(host: AudioGraphHost, out: Float32Array): void {\n    ensureAnalyzerSubNode(host)._node.getFloatFrequencyData(out as Float32Array<ArrayBuffer>);\n}\n\n/**\n * Writes the current time-domain (waveform) data as unsigned bytes into `out`,\n * building the analyzer tap on first use. Each sample is centered on `128`.\n * `out` should be sized to the analyzer's `fftSize`.\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param out - Destination buffer; values are written in place.\n */\nexport function getByteTimeDomainData(host: AudioGraphHost, out: Uint8Array): void {\n    ensureAnalyzerSubNode(host)._node.getByteTimeDomainData(out as Uint8Array<ArrayBuffer>);\n}\n\n/**\n * Writes the current time-domain (waveform) data as floats in `[-1, 1]` into\n * `out`, building the analyzer tap on first use. `out` should be sized to the\n * analyzer's `fftSize`.\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param out - Destination buffer; values are written in place.\n */\nexport function getFloatTimeDomainData(host: AudioGraphHost, out: Float32Array): void {\n    ensureAnalyzerSubNode(host)._node.getFloatTimeDomainData(out as Float32Array<ArrayBuffer>);\n}\n"],"names":[],"mappings":"AAiBA,MAAM,QAAA,GAAW;AAAA,EACb,OAAA,EAAS,IAAA;AAAA,EACT,WAAA,EAAa,IAAA;AAAA,EACb,WAAA,EAAa,GAAA;AAAA,EACb,SAAA,EAAW;AACf,CAAA;AAqBA,SAAS,oBAAA,CAAqB,MAAoB,OAAA,EAAqC;AACnF,EAAA,IAAI,OAAA,CAAQ,YAAY,MAAA,EAAW;AAC/B,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AAAA,EAC3B;AACA,EAAA,IAAI,OAAA,CAAQ,gBAAgB,MAAA,EAAW;AACnC,IAAA,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA;AAAA,EAC/B;AACA,EAAA,IAAI,OAAA,CAAQ,gBAAgB,MAAA,EAAW;AACnC,IAAA,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA;AAAA,EAC/B;AACA,EAAA,IAAI,OAAA,CAAQ,cAAc,MAAA,EAAW;AACjC,IAAA,IAAA,CAAK,wBAAwB,OAAA,CAAQ,SAAA;AAAA,EACzC;AACJ;AAEA,SAAS,qBAAA,CAAsB,QAAqB,OAAA,EAAgD;AAChG,EAAA,MAAM,IAAA,GAAO,IAAI,YAAA,CAAa,MAAA,CAAO,IAAI,CAAA;AACzC,EAAA,IAAA,CAAK,UAAU,QAAA,CAAS,OAAA;AACxB,EAAA,IAAA,CAAK,cAAc,QAAA,CAAS,WAAA;AAC5B,EAAA,IAAA,CAAK,cAAc,QAAA,CAAS,WAAA;AAC5B,EAAA,IAAA,CAAK,wBAAwB,QAAA,CAAS,SAAA;AACtC,EAAA,oBAAA,CAAqB,MAAM,OAAO,CAAA;AAClC,EAAA,OAAO;AAAA,IACH,OAAA,EAAS,MAAA;AAAA,IACT,KAAA,EAAO,IAAA;AAAA,IACP,UAAU,MAAM;AACZ,MAAA,IAAA,CAAK,UAAA,EAAW;AAAA,IACpB;AAAA,GACJ;AACJ;AAMA,SAAS,qBAAA,CAAsB,IAAA,EAA2B,OAAA,GAAgC,EAAC,EAAoB;AAC3G,EAAA,MAAM,QAAQ,IAAA,CAAK,MAAA;AACnB,EAAA,IAAI,MAAM,SAAA,EAAW;AAEjB,IAAA,MAAM,WAAW,KAAA,CAAM,SAAA;AACvB,IAAA,oBAAA,CAAqB,QAAA,CAAS,OAAO,OAAO,CAAA;AAC5C,IAAA,OAAO,QAAA;AAAA,EACX;AAEA,EAAA,MAAM,IAAA,GAAO,qBAAA,CAAsB,IAAA,CAAK,OAAA,EAAS,OAAO,CAAA;AACxD,EAAA,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA;AAChC,EAAA,KAAA,CAAM,SAAA,GAAY,IAAA;AAClB,EAAA,OAAO,IAAA;AACX;AAWO,SAAS,cAAA,CAAe,IAAA,EAAsB,OAAA,GAAgC,EAAC,EAAS;AAC3F,EAAA,qBAAA,CAAsB,MAAM,OAAO,CAAA;AACvC;AASO,SAAS,oBAAA,CAAqB,MAAsB,GAAA,EAAuB;AAC9E,EAAA,qBAAA,CAAsB,IAAI,CAAA,CAAE,KAAA,CAAM,oBAAA,CAAqB,GAA8B,CAAA;AACzF;AASO,SAAS,qBAAA,CAAsB,MAAsB,GAAA,EAAyB;AACjF,EAAA,qBAAA,CAAsB,IAAI,CAAA,CAAE,KAAA,CAAM,qBAAA,CAAsB,GAAgC,CAAA;AAC5F;AASO,SAAS,qBAAA,CAAsB,MAAsB,GAAA,EAAuB;AAC/E,EAAA,qBAAA,CAAsB,IAAI,CAAA,CAAE,KAAA,CAAM,qBAAA,CAAsB,GAA8B,CAAA;AAC1F;AASO,SAAS,sBAAA,CAAuB,MAAsB,GAAA,EAAyB;AAClF,EAAA,qBAAA,CAAsB,IAAI,CAAA,CAAE,KAAA,CAAM,sBAAA,CAAuB,GAAgC,CAAA;AAC7F;;;;"}

package/lib/audio/audio-bus.js

@@ -0,0 +1,38 @@
+import { setMainBusVolume } from './bus.js';
+import { createSoundSubGraph, connectSoundSubGraph, disposeSoundSubGraph, setSoundSubGraphVolume } from './sound-sub-graph.js';
+
+function _isAudioBus(bus) {
+  return "_graph" in bus;
+}
+function getBusInputNode(bus) {
+  return _isAudioBus(bus) ? bus._graph._in : bus._in;
+}
+async function createAudioBusAsync(engine, name, options = {}) {
+  await engine._isReady;
+  const graph = createSoundSubGraph(engine._ctx, engine, options.volume ?? 1);
+  const outBus = options.outBus ?? engine._mainBus;
+  connectSoundSubGraph(graph, getBusInputNode(outBus));
+  const bus = {
+    name,
+    _engine: engine,
+    _graph: graph,
+    _outBus: outBus,
+    _dispose: () => disposeAudioBus(bus)
+  };
+  engine._buses.add(bus);
+  return bus;
+}
+function setBusVolume(bus, value, options) {
+  if (_isAudioBus(bus)) {
+    setSoundSubGraphVolume(bus._graph, value, options);
+  } else {
+    setMainBusVolume(bus, value, options);
+  }
+}
+function disposeAudioBus(bus) {
+  disposeSoundSubGraph(bus._graph);
+  bus._engine._buses.delete(bus);
+}
+
+export { createAudioBusAsync, disposeAudioBus, getBusInputNode, setBusVolume };
+//# sourceMappingURL=audio-bus.js.map

package/lib/audio/audio-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-bus.js","sources":["../../../src/audio/audio-bus.ts"],"sourcesContent":["/**\n * Generic audio bus (mixer node).\n *\n * Faithful port of AudioV2 `AudioBus` / `_WebAudioBus`, collapsed to pure state\n * + standalone functions. A bus owns a `SoundSubGraph` (Phase 2: a single\n * volume `GainNode`) and routes its output into another bus (`outBus`), forming\n * a mixer tree that ultimately reaches the engine main bus, main out, and the\n * context destination.\n *\n * Signal flow: `upstream` becomes `bus._graph._in` then `bus._graph._out` then\n * the `outBus` input node, and so on up to `mainOut` then `ctx.destination`.\n */\n\nimport { type AudioEngine } from \"./audio-engine.js\";\nimport { type RampOptions } from \"./audio-param.js\";\nimport { type MainBus, setMainBusVolume } from \"./bus.js\";\nimport { type SoundSubGraph, connectSoundSubGraph, createSoundSubGraph, disposeSoundSubGraph, setSoundSubGraphVolume } from \"./sound-sub-graph.js\";\n\n/** A bus that sounds or other buses can output to (the engine main bus or a generic {@link AudioBus}). */\nexport type PrimaryAudioBus = AudioBus | MainBus;\n\n/** Options for {@link createAudioBusAsync}. */\nexport interface AudioBusOptions {\n    /** Initial volume. Defaults to `1`. */\n    volume?: number;\n    /** Output bus. Defaults to the engine's default main bus. */\n    outBus?: PrimaryAudioBus;\n}\n\n/** A generic mixer bus. Pure state — drive it with the bus functions. */\nexport interface AudioBus {\n    /** Bus name. */\n    readonly name: string;\n\n    /** @internal */ _engine: AudioEngine;\n    /** @internal */ _graph: SoundSubGraph;\n    /** @internal */ _outBus: PrimaryAudioBus;\n    /** @internal */ _dispose(): void;\n}\n\n/** Narrows a {@link PrimaryAudioBus} to a generic {@link AudioBus}. */\nfunction _isAudioBus(bus: PrimaryAudioBus): bus is AudioBus {\n    return \"_graph\" in bus;\n}\n\n/** Resolves the Web Audio input node where upstream sounds/buses connect. @internal */\nexport function getBusInputNode(bus: PrimaryAudioBus): AudioNode {\n    return _isAudioBus(bus) ? bus._graph._in : bus._in;\n}\n\n/**\n * Creates a generic mixer bus routed to another bus (defaulting to the engine's\n * default main bus). Multiple sounds/buses can be routed through a bus to mix\n * and control their combined volume.\n * @param engine - The audio engine.\n * @param name - A name for the bus.\n * @param options - Bus options.\n * @returns A promise that resolves with the ready bus.\n */\nexport async function createAudioBusAsync(engine: AudioEngine, name: string, options: AudioBusOptions = {}): Promise<AudioBus> {\n    await engine._isReady;\n\n    const graph = createSoundSubGraph(engine._ctx, engine, options.volume ?? 1);\n    const outBus = options.outBus ?? engine._mainBus;\n    connectSoundSubGraph(graph, getBusInputNode(outBus));\n\n    const bus: AudioBus = {\n        name,\n        _engine: engine,\n        _graph: graph,\n        _outBus: outBus,\n        _dispose: () => disposeAudioBus(bus),\n    };\n\n    engine._buses.add(bus);\n    return bus;\n}\n\n/** Sets a bus's output volume, optionally ramping. Works on a generic bus or the main bus. */\nexport function setBusVolume(bus: PrimaryAudioBus, value: number, options?: RampOptions): void {\n    if (_isAudioBus(bus)) {\n        setSoundSubGraphVolume(bus._graph, value, options);\n    } else {\n        setMainBusVolume(bus, value, options);\n    }\n}\n\n/** Disposes a generic bus, releasing its sub-graph. */\nexport function disposeAudioBus(bus: AudioBus): void {\n    disposeSoundSubGraph(bus._graph);\n    bus._engine._buses.delete(bus);\n}\n"],"names":[],"mappings":";;;AAyCA,SAAS,YAAY,GAAA,EAAuC;AACxD,EAAA,OAAO,QAAA,IAAY,GAAA;AACvB;AAGO,SAAS,gBAAgB,GAAA,EAAiC;AAC7D,EAAA,OAAO,YAAY,GAAG,CAAA,GAAI,GAAA,CAAI,MAAA,CAAO,MAAM,GAAA,CAAI,GAAA;AACnD;AAWA,eAAsB,mBAAA,CAAoB,MAAA,EAAqB,IAAA,EAAc,OAAA,GAA2B,EAAC,EAAsB;AAC3H,EAAA,MAAM,MAAA,CAAO,QAAA;AAEb,EAAA,MAAM,QAAQ,mBAAA,CAAoB,MAAA,CAAO,MAAM,MAAA,EAAQ,OAAA,CAAQ,UAAU,CAAC,CAAA;AAC1E,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,MAAA,CAAO,QAAA;AACxC,EAAA,oBAAA,CAAqB,KAAA,EAAO,eAAA,CAAgB,MAAM,CAAC,CAAA;AAEnD,EAAA,MAAM,GAAA,GAAgB;AAAA,IAClB,IAAA;AAAA,IACA,OAAA,EAAS,MAAA;AAAA,IACT,MAAA,EAAQ,KAAA;AAAA,IACR,OAAA,EAAS,MAAA;AAAA,IACT,QAAA,EAAU,MAAM,eAAA,CAAgB,GAAG;AAAA,GACvC;AAEA,EAAA,MAAA,CAAO,MAAA,CAAO,IAAI,GAAG,CAAA;AACrB,EAAA,OAAO,GAAA;AACX;AAGO,SAAS,YAAA,CAAa,GAAA,EAAsB,KAAA,EAAe,OAAA,EAA6B;AAC3F,EAAA,IAAI,WAAA,CAAY,GAAG,CAAA,EAAG;AAClB,IAAA,sBAAA,CAAuB,GAAA,CAAI,MAAA,EAAQ,KAAA,EAAO,OAAO,CAAA;AAAA,EACrD,CAAA,MAAO;AACH,IAAA,gBAAA,CAAiB,GAAA,EAAK,OAAO,OAAO,CAAA;AAAA,EACxC;AACJ;AAGO,SAAS,gBAAgB,GAAA,EAAqB;AACjD,EAAA,oBAAA,CAAqB,IAAI,MAAM,CAAA;AAC/B,EAAA,GAAA,CAAI,OAAA,CAAQ,MAAA,CAAO,MAAA,CAAO,GAAG,CAAA;AACjC;;;;"}

package/lib/audio/audio-engine.js

@@ -0,0 +1,188 @@
+import { createAudioSignal } from './audio-signal.js';
+import { createMainOut, setMainOutVolume, createMainBus, disposeMainBus, disposeMainOut } from './bus.js';
+
+const FormatMimeTypes = {
+  aac: "audio/aac",
+  ac3: "audio/ac3",
+  flac: "audio/flac",
+  m4a: "audio/mp4",
+  mp3: 'audio/mpeg; codecs="mp3"',
+  mp4: "audio/mp4",
+  ogg: 'audio/ogg; codecs="vorbis"',
+  wav: "audio/wav",
+  webm: 'audio/webm; codecs="vorbis"'
+};
+function isOfflineContext(ctx) {
+  return typeof OfflineAudioContext !== "undefined" && ctx instanceof OfflineAudioContext;
+}
+async function createAudioEngineAsync(options = {}) {
+  const ctx = options.audioContext ?? new AudioContext();
+  const isOffline = isOfflineContext(ctx);
+  const onStateChanged = createAudioSignal();
+  const onUserGesture = createAudioSignal();
+  let resolveReady;
+  const isReady = new Promise((resolve) => {
+    resolveReady = resolve;
+  });
+  const engine = {
+    get state() {
+      return isOffline ? "running" : ctx.state;
+    },
+    get currentTime() {
+      return ctx.currentTime ?? 0;
+    },
+    get _currentTime() {
+      return ctx.currentTime ?? 0;
+    },
+    get onStateChanged() {
+      return onStateChanged;
+    },
+    get onUserGesture() {
+      return onUserGesture;
+    },
+    _ctx: ctx,
+    _isOffline: isOffline,
+    _rampDuration: typeof options.parameterRampDuration === "number" ? Math.max(0, options.parameterRampDuration) : 0.01,
+    _volume: options.volume ?? 1,
+    // Assigned just below once the engine (the ramp clock) exists.
+    _mainOut: void 0,
+    _mainBus: void 0,
+    _validFormats: /* @__PURE__ */ new Set(),
+    _invalidFormats: /* @__PURE__ */ new Set(),
+    _sounds: /* @__PURE__ */ new Set(),
+    _buses: /* @__PURE__ */ new Set(),
+    _listener: null,
+    _spatialUpdaters: /* @__PURE__ */ new Set(),
+    _spatialAutoStop: null,
+    _disposers: [],
+    _onStateChanged: onStateChanged,
+    _onUserGesture: onUserGesture,
+    _isReady: isReady
+  };
+  engine._mainOut = createMainOut(ctx, engine);
+  setMainOutVolume(engine._mainOut, engine._volume);
+  engine._mainBus = createMainBus("default", ctx, engine, engine._mainOut);
+  _wireStateAndResume(engine, options);
+  _wireUserGesture(engine, options);
+  resolveReady();
+  await isReady;
+  return engine;
+}
+function _wireStateAndResume(engine, options) {
+  const ctx = engine._ctx;
+  if (engine._isOffline || typeof ctx.addEventListener !== "function") {
+    return;
+  }
+  const resumeOnPause = options.resumeOnPause !== false;
+  const retryInterval = options.resumeOnPauseRetryInterval ?? 1e3;
+  let started = false;
+  let resumeTimer = null;
+  const clearResumeTimer = () => {
+    if (resumeTimer !== null) {
+      clearInterval(resumeTimer);
+      resumeTimer = null;
+    }
+  };
+  const onStateChange = () => {
+    const state = engine.state;
+    if (state === "running") {
+      clearResumeTimer();
+      started = true;
+    } else if ((state === "suspended" || state === "interrupted") && started && resumeOnPause) {
+      clearResumeTimer();
+      resumeTimer = setInterval(() => {
+        void ctx.resume();
+      }, retryInterval);
+    }
+    engine._onStateChanged._notify(state);
+  };
+  ctx.addEventListener("statechange", onStateChange);
+  engine._disposers.push(() => {
+    clearResumeTimer();
+    ctx.removeEventListener("statechange", onStateChange);
+  });
+}
+function _wireUserGesture(engine, options) {
+  const resumeOnInteraction = options.resumeOnInteraction !== false;
+  if (engine._isOffline || typeof document === "undefined" || typeof document.addEventListener !== "function") {
+    return;
+  }
+  const onGesture = () => {
+    if (resumeOnInteraction) {
+      void engine._ctx.resume();
+    }
+    engine._onUserGesture._notify();
+  };
+  document.addEventListener("click", onGesture);
+  engine._disposers.push(() => document.removeEventListener("click", onGesture));
+}
+async function unlockAudioEngineAsync(engine) {
+  if (engine._isOffline) {
+    return;
+  }
+  const ctx = engine._ctx;
+  if (ctx.state !== "running") {
+    await ctx.resume();
+  }
+}
+function setMasterVolume(engine, value, options) {
+  engine._volume = value;
+  setMainOutVolume(engine._mainOut, value, options);
+}
+function getMasterVolume(engine) {
+  return engine._volume;
+}
+function isAudioFormatValid(engine, format) {
+  if (engine._validFormats.has(format)) {
+    return true;
+  }
+  if (engine._invalidFormats.has(format)) {
+    return false;
+  }
+  const mimeType = FormatMimeTypes[format];
+  if (mimeType === void 0) {
+    return false;
+  }
+  if (typeof Audio === "undefined") {
+    return true;
+  }
+  if (new Audio().canPlayType(mimeType) === "") {
+    engine._invalidFormats.add(format);
+    return false;
+  }
+  engine._validFormats.add(format);
+  return true;
+}
+function disposeAudioEngine(engine) {
+  engine._spatialAutoStop?.();
+  engine._spatialAutoStop = null;
+  engine._spatialUpdaters.clear();
+  engine._listener?._dispose();
+  for (const sound of Array.from(engine._sounds)) {
+    sound._dispose();
+  }
+  engine._sounds.clear();
+  for (const bus of Array.from(engine._buses)) {
+    bus._dispose();
+  }
+  engine._buses.clear();
+  for (const dispose of engine._disposers) {
+    try {
+      dispose();
+    } catch (e) {
+      console.warn(`Audio disposer failed: ${e.message}`);
+    }
+  }
+  engine._disposers.length = 0;
+  disposeMainBus(engine._mainBus);
+  disposeMainOut(engine._mainOut);
+  const ctx = engine._ctx;
+  if (!engine._isOffline && ctx.state !== "closed") {
+    void ctx.close();
+  }
+  engine._onStateChanged._clear();
+  engine._onUserGesture._clear();
+}
+
+export { createAudioEngineAsync, disposeAudioEngine, getMasterVolume, isAudioFormatValid, setMasterVolume, unlockAudioEngineAsync };
+//# sourceMappingURL=audio-engine.js.map

package/lib/audio/audio-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-engine.js","sources":["../../../src/audio/audio-engine.ts"],"sourcesContent":["/**\n * Audio engine — lifecycle, master output, default main bus, autoplay unlock.\n *\n * Faithful port of AudioV2 `_WebAudioEngine` + `CreateAudioEngineAsync`,\n * re-shaped to pure state + standalone functions. Re-architected per Babylon\n * Lite pillars:\n *   - No module-level side effects (no `Instances[]`, no module-scope Observable).\n *   - Caller owns the engine handle (no `LastCreatedAudioEngine`).\n *   - `Observable` becomes `AudioSignal`.\n *   - Global hooks (click listener, resume timer) are registered into\n *     `engine._disposers` and torn down on dispose.\n *   - `OfflineAudioContext` is fully supported for deterministic, headless\n *     PCM rendering (the primary audio test gate).\n */\n\nimport { type AudioSignal, type AudioSignalImpl, createAudioSignal } from \"./audio-signal.js\";\nimport { type RampOptions } from \"./audio-param.js\";\nimport { type MainBus, type MainOut, createMainBus, createMainOut, disposeMainBus, disposeMainOut, setMainOutVolume } from \"./bus.js\";\nimport type { Vec3 } from \"../math/types.js\";\n\n/**\n * Minimal structural view of the spatial listener, kept local so this module\n * does NOT import the spatial feature module (Pillar 4: tree-shaking) and so the\n * `.d.ts` rollup has no `AudioEngine` \\<-\\> `SpatialListener` import cycle. The\n * full listener (assigned by the spatial feature functions) is structurally\n * compatible. @internal\n */\nexport interface SpatialListenerSlot {\n    /** Listener world position, read by source distance attenuation. @internal */ _position: Vec3;\n    /** @internal */ _dispose(): void;\n}\n\n/** Audio context state, mirroring the Web Audio `AudioContextState` plus `\"interrupted\"`. */\nexport type AudioEngineState = \"running\" | \"suspended\" | \"closed\" | \"interrupted\";\n\n/** Options for {@link createAudioEngineAsync}. */\nexport interface AudioEngineOptions {\n    /**\n     * The audio context to use. Pass an `OfflineAudioContext` for deterministic,\n     * faster-than-realtime rendering (used by the audio test suite). When omitted\n     * a real-time `AudioContext` is created.\n     */\n    audioContext?: BaseAudioContext;\n    /** Master output volume. Defaults to `1`. */\n    volume?: number;\n    /** Default parameter ramp smoothing, in seconds. Defaults to `0.01`. */\n    parameterRampDuration?: number;\n    /** Auto-resume the context on user interaction (click). Defaults to `true`. */\n    resumeOnInteraction?: boolean;\n    /** Auto-resume the context if the browser pauses playback. Defaults to `true`. */\n    resumeOnPause?: boolean;\n    /** Retry interval (ms) for `resumeOnPause`. Defaults to `1000`. */\n    resumeOnPauseRetryInterval?: number;\n}\n\n/**\n * A Babylon Lite audio engine. Pure state — operate on it with the audio\n * functions (`createSoundAsync`, `setMasterVolume`, `disposeAudioEngine`, …).\n */\nexport interface AudioEngine {\n    /** Current context state. Always `\"running\"` for an offline context. */\n    readonly state: AudioEngineState;\n    /** The audio context's current time, in seconds. */\n    readonly currentTime: number;\n    /** Fires whenever {@link state} changes. */\n    readonly onStateChanged: AudioSignal<AudioEngineState>;\n    /** Fires on every qualifying user gesture (click), not just the first. */\n    readonly onUserGesture: AudioSignal<void>;\n\n    /** @internal */ readonly _ctx: BaseAudioContext;\n    /** @internal */ readonly _isOffline: boolean;\n    /** Ramp-clock current time (satisfies `RampClock`). @internal */ readonly _currentTime: number;\n    /** Ramp-clock default duration (satisfies `RampClock`). @internal */ _rampDuration: number;\n    /** @internal */ _volume: number;\n    /** @internal */ _mainOut: MainOut;\n    /** @internal */ _mainBus: MainBus;\n    /** @internal */ readonly _validFormats: Set<string>;\n    /** @internal */ readonly _invalidFormats: Set<string>;\n    /** @internal */ readonly _sounds: Set<{ _dispose(): void }>;\n    /** @internal */ readonly _buses: Set<{ _dispose(): void }>;\n    /** Lazily-built spatial listener (only when spatial audio is used). @internal */ _listener: SpatialListenerSlot | null;\n    /** Per-frame spatial update closures, registered while attached. @internal */ readonly _spatialUpdaters: Set<() => void>;\n    /** Stops the spatial auto-update loop, if running. @internal */ _spatialAutoStop: (() => void) | null;\n    /** @internal */ readonly _disposers: Array<() => void>;\n    /** @internal */ readonly _onStateChanged: AudioSignalImpl<AudioEngineState>;\n    /** @internal */ readonly _onUserGesture: AudioSignalImpl<void>;\n    /** @internal */ readonly _isReady: Promise<void>;\n}\n\nconst FormatMimeTypes: { [key: string]: string } = {\n    aac: \"audio/aac\",\n    ac3: \"audio/ac3\",\n    flac: \"audio/flac\",\n    m4a: \"audio/mp4\",\n    mp3: 'audio/mpeg; codecs=\"mp3\"',\n    mp4: \"audio/mp4\",\n    ogg: 'audio/ogg; codecs=\"vorbis\"',\n    wav: \"audio/wav\",\n    webm: 'audio/webm; codecs=\"vorbis\"',\n};\n\nfunction isOfflineContext(ctx: BaseAudioContext): boolean {\n    return typeof OfflineAudioContext !== \"undefined\" && ctx instanceof OfflineAudioContext;\n}\n\n/**\n * Creates and initializes an audio engine.\n * @param options - Engine options.\n * @returns A promise that resolves with the ready-to-use engine.\n */\nexport async function createAudioEngineAsync(options: AudioEngineOptions = {}): Promise<AudioEngine> {\n    const ctx = options.audioContext ?? new AudioContext();\n    const isOffline = isOfflineContext(ctx);\n\n    const onStateChanged = createAudioSignal<AudioEngineState>();\n    const onUserGesture = createAudioSignal<void>();\n\n    let resolveReady!: () => void;\n    const isReady = new Promise<void>((resolve) => {\n        resolveReady = resolve;\n    });\n\n    const engine: AudioEngine = {\n        get state(): AudioEngineState {\n            return isOffline ? \"running\" : ((ctx as AudioContext).state as AudioEngineState);\n        },\n        get currentTime(): number {\n            return ctx.currentTime ?? 0;\n        },\n        get _currentTime(): number {\n            return ctx.currentTime ?? 0;\n        },\n        get onStateChanged(): AudioSignal<AudioEngineState> {\n            return onStateChanged;\n        },\n        get onUserGesture(): AudioSignal<void> {\n            return onUserGesture;\n        },\n        _ctx: ctx,\n        _isOffline: isOffline,\n        _rampDuration: typeof options.parameterRampDuration === \"number\" ? Math.max(0, options.parameterRampDuration) : 0.01,\n        _volume: options.volume ?? 1,\n        // Assigned just below once the engine (the ramp clock) exists.\n        _mainOut: undefined as unknown as MainOut,\n        _mainBus: undefined as unknown as MainBus,\n        _validFormats: new Set<string>(),\n        _invalidFormats: new Set<string>(),\n        _sounds: new Set<{ _dispose(): void }>(),\n        _buses: new Set<{ _dispose(): void }>(),\n        _listener: null,\n        _spatialUpdaters: new Set<() => void>(),\n        _spatialAutoStop: null,\n        _disposers: [],\n        _onStateChanged: onStateChanged,\n        _onUserGesture: onUserGesture,\n        _isReady: isReady,\n    };\n\n    // Build the output graph: mainBus._volume -> mainOut._gain -> destination.\n    engine._mainOut = createMainOut(ctx, engine);\n    setMainOutVolume(engine._mainOut, engine._volume);\n    engine._mainBus = createMainBus(\"default\", ctx, engine, engine._mainOut);\n\n    _wireStateAndResume(engine, options);\n    _wireUserGesture(engine, options);\n\n    resolveReady();\n    await isReady;\n    return engine;\n}\n\nfunction _wireStateAndResume(engine: AudioEngine, options: AudioEngineOptions): void {\n    const ctx = engine._ctx;\n    if (engine._isOffline || typeof (ctx as AudioContext).addEventListener !== \"function\") {\n        return;\n    }\n\n    const resumeOnPause = options.resumeOnPause !== false;\n    const retryInterval = options.resumeOnPauseRetryInterval ?? 1000;\n\n    let started = false;\n    let resumeTimer: ReturnType<typeof setInterval> | null = null;\n\n    const clearResumeTimer = (): void => {\n        if (resumeTimer !== null) {\n            clearInterval(resumeTimer);\n            resumeTimer = null;\n        }\n    };\n\n    const onStateChange = (): void => {\n        const state = engine.state;\n        if (state === \"running\") {\n            clearResumeTimer();\n            started = true;\n        } else if ((state === \"suspended\" || state === \"interrupted\") && started && resumeOnPause) {\n            clearResumeTimer();\n            resumeTimer = setInterval(() => {\n                void (ctx as AudioContext).resume();\n            }, retryInterval);\n        }\n        engine._onStateChanged._notify(state);\n    };\n\n    (ctx as AudioContext).addEventListener(\"statechange\", onStateChange);\n    engine._disposers.push(() => {\n        clearResumeTimer();\n        (ctx as AudioContext).removeEventListener(\"statechange\", onStateChange);\n    });\n}\n\nfunction _wireUserGesture(engine: AudioEngine, options: AudioEngineOptions): void {\n    const resumeOnInteraction = options.resumeOnInteraction !== false;\n    if (engine._isOffline || typeof document === \"undefined\" || typeof document.addEventListener !== \"function\") {\n        return;\n    }\n\n    const onGesture = (): void => {\n        if (resumeOnInteraction) {\n            void (engine._ctx as AudioContext).resume();\n        }\n        engine._onUserGesture._notify();\n    };\n\n    document.addEventListener(\"click\", onGesture);\n    engine._disposers.push(() => document.removeEventListener(\"click\", onGesture));\n}\n\n/**\n * Unlocks (resumes) the audio engine. Browsers require a user gesture before a\n * real-time context can produce sound; call this from a click/tap handler.\n * @param engine - The audio engine.\n */\nexport async function unlockAudioEngineAsync(engine: AudioEngine): Promise<void> {\n    if (engine._isOffline) {\n        return;\n    }\n    const ctx = engine._ctx as AudioContext;\n    if (ctx.state !== \"running\") {\n        await ctx.resume();\n    }\n}\n\n/**\n * Sets the master output volume, optionally ramping to the new value.\n * @param engine - The audio engine.\n * @param value - Target volume (1 = unchanged).\n * @param options - Optional ramp shape/duration.\n */\nexport function setMasterVolume(engine: AudioEngine, value: number, options?: RampOptions): void {\n    engine._volume = value;\n    setMainOutVolume(engine._mainOut, value, options);\n}\n\n/** The master output volume. */\nexport function getMasterVolume(engine: AudioEngine): number {\n    return engine._volume;\n}\n\n/**\n * Whether the given audio file format/extension can be decoded by the browser.\n * In non-browser (offline render / test) environments where no `Audio` element\n * exists, the format is assumed valid.\n * @internal\n */\nexport function isAudioFormatValid(engine: AudioEngine, format: string): boolean {\n    if (engine._validFormats.has(format)) {\n        return true;\n    }\n    if (engine._invalidFormats.has(format)) {\n        return false;\n    }\n\n    const mimeType = FormatMimeTypes[format];\n    if (mimeType === undefined) {\n        return false;\n    }\n\n    if (typeof Audio === \"undefined\") {\n        return true;\n    }\n\n    if (new Audio().canPlayType(mimeType) === \"\") {\n        engine._invalidFormats.add(format);\n        return false;\n    }\n\n    engine._validFormats.add(format);\n    return true;\n}\n\n/**\n * Disposes the audio engine: stops all sounds, tears down global hooks, and\n * closes the (non-offline) audio context.\n * @param engine - The audio engine to dispose.\n */\nexport function disposeAudioEngine(engine: AudioEngine): void {\n    engine._spatialAutoStop?.();\n    engine._spatialAutoStop = null;\n    engine._spatialUpdaters.clear();\n    engine._listener?._dispose();\n\n    for (const sound of Array.from(engine._sounds)) {\n        sound._dispose();\n    }\n    engine._sounds.clear();\n\n    for (const bus of Array.from(engine._buses)) {\n        bus._dispose();\n    }\n    engine._buses.clear();\n\n    for (const dispose of engine._disposers) {\n        try {\n            dispose();\n        } catch (e) {\n            console.warn(`Audio disposer failed: ${(e as Error).message}`);\n        }\n    }\n    engine._disposers.length = 0;\n\n    disposeMainBus(engine._mainBus);\n    disposeMainOut(engine._mainOut);\n\n    const ctx = engine._ctx;\n    if (!engine._isOffline && (ctx as AudioContext).state !== \"closed\") {\n        void (ctx as AudioContext).close();\n    }\n\n    engine._onStateChanged._clear();\n    engine._onUserGesture._clear();\n}\n"],"names":[],"mappings":"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"}

package/lib/audio/audio-fetch.js

@@ -0,0 +1,18 @@
+let fileExtensionRegex = null;
+function getFileExtension(url) {
+  fileExtensionRegex ??= new RegExp("\\.(\\w{3,4})($|\\?)");
+  return url.match(fileExtensionRegex)?.[1];
+}
+function cleanAudioUrl(url) {
+  return url.replace(/#/gm, "%23");
+}
+async function loadAudioArrayBuffer(url) {
+  const response = await fetch(cleanAudioUrl(url));
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status} loading '${url}': ${response.statusText}`);
+  }
+  return await response.arrayBuffer();
+}
+
+export { cleanAudioUrl, getFileExtension, loadAudioArrayBuffer };
+//# sourceMappingURL=audio-fetch.js.map

package/lib/audio/audio-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-fetch.js","sources":["../../../src/audio/audio-fetch.ts"],"sourcesContent":["/**\n * Audio network + decode helpers.\n *\n * Babylon Lite fetches audio with the same plain `fetch()` path every other Lite\n * loader uses (texture, glTF, env, splat). The AudioV2 `WebRequest` custom\n * header / URL-modifier layer is intentionally dropped — Lite has no such layer.\n */\n\nlet fileExtensionRegex: RegExp | null = null;\n\n/**\n * Extracts the 3–4 char file extension (before any query string), exactly as\n * written in the URL — not lowercased, matching AudioV2 `_FileExtensionRegex`.\n * @internal\n */\nexport function getFileExtension(url: string): string | undefined {\n    fileExtensionRegex ??= new RegExp(\"\\\\.(\\\\w{3,4})($|\\\\?)\");\n    return url.match(fileExtensionRegex)?.[1];\n}\n\n/** Escapes `#` so URLs with fragments load correctly. @internal */\nexport function cleanAudioUrl(url: string): string {\n    return url.replace(/#/gm, \"%23\");\n}\n\n/**\n * Loads an `ArrayBuffer` from a URL via plain `fetch()`.\n * @internal\n */\nexport async function loadAudioArrayBuffer(url: string): Promise<ArrayBuffer> {\n    const response = await fetch(cleanAudioUrl(url));\n    if (!response.ok) {\n        throw new Error(`HTTP ${response.status} loading '${url}': ${response.statusText}`);\n    }\n    return await response.arrayBuffer();\n}\n"],"names":[],"mappings":"AAQA,IAAI,kBAAA,GAAoC,IAAA;AAOjC,SAAS,iBAAiB,GAAA,EAAiC;AAC9D,EAAA,kBAAA,KAAuB,IAAI,OAAO,sBAAsB,CAAA;AACxD,EAAA,OAAO,GAAA,CAAI,KAAA,CAAM,kBAAkB,CAAA,GAAI,CAAC,CAAA;AAC5C;AAGO,SAAS,cAAc,GAAA,EAAqB;AAC/C,EAAA,OAAO,GAAA,CAAI,OAAA,CAAQ,KAAA,EAAO,KAAK,CAAA;AACnC;AAMA,eAAsB,qBAAqB,GAAA,EAAmC;AAC1E,EAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,aAAA,CAAc,GAAG,CAAC,CAAA;AAC/C,EAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AACd,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,QAAA,CAAS,MAAM,aAAa,GAAG,CAAA,GAAA,EAAM,QAAA,CAAS,UAAU,CAAA,CAAE,CAAA;AAAA,EACtF;AACA,EAAA,OAAO,MAAM,SAAS,WAAA,EAAY;AACtC;;;;"}

package/lib/audio/audio-param.js

@@ -0,0 +1,96 @@
+const CurveLength = 100;
+const MinRampDuration = 1e-6;
+let TmpCurveValues = null;
+let ExpCurve = null;
+let LogCurve = null;
+const TmpLineValues = new Float32Array([0, 0]);
+function getExpCurve() {
+  if (!ExpCurve) {
+    ExpCurve = new Float32Array(CurveLength);
+    const increment = 1 / (CurveLength - 1);
+    let x = increment;
+    for (let i = 1; i < CurveLength; i++) {
+      ExpCurve[i] = Math.exp(-11.512925464970227 * (1 - x));
+      x += increment;
+    }
+  }
+  return ExpCurve;
+}
+function getLogCurve() {
+  if (!LogCurve) {
+    LogCurve = new Float32Array(CurveLength);
+    const increment = 1 / CurveLength;
+    let x = increment;
+    for (let i = 0; i < CurveLength; i++) {
+      LogCurve[i] = 1 + Math.log10(x) / Math.log10(CurveLength);
+      x += increment;
+    }
+  }
+  return LogCurve;
+}
+function getRampCurveValues(shape, from, to) {
+  if (shape === "linear") {
+    TmpLineValues[0] = from;
+    TmpLineValues[1] = to;
+    return TmpLineValues;
+  }
+  if (!TmpCurveValues) {
+    TmpCurveValues = new Float32Array(CurveLength);
+  }
+  const normalizedCurve = shape === "exponential" ? getExpCurve() : getLogCurve();
+  const direction = Math.sign(to - from);
+  const range = Math.abs(to - from);
+  if (direction === 1) {
+    for (let i = 0; i < normalizedCurve.length; i++) {
+      TmpCurveValues[i] = from + range * normalizedCurve[i];
+    }
+  } else {
+    let j = CurveLength - 1;
+    for (let i = 0; i < normalizedCurve.length; i++, j--) {
+      TmpCurveValues[i] = from - range * (1 - normalizedCurve[j]);
+    }
+  }
+  return TmpCurveValues;
+}
+function createRampParam(param, clock) {
+  return { _param: param, _clock: clock, _targetValue: param.value, _rampEndTime: 0 };
+}
+function isRamping(rp) {
+  return rp._clock._currentTime < rp._rampEndTime;
+}
+let warnedRampFailure = false;
+function setRampTarget(rp, value, options) {
+  if (!Number.isFinite(value)) {
+    console.warn(`Attempted to set audio parameter to non-finite value: ${value}`);
+    return;
+  }
+  rp._param.cancelScheduledValues(0);
+  const shape = typeof options?.shape === "string" ? options.shape : "linear";
+  const startTime = rp._clock._currentTime;
+  if (shape === "none") {
+    rp._param.value = rp._targetValue = value;
+    rp._rampEndTime = startTime;
+    return;
+  }
+  rp._targetValue = value;
+  const rampDuration = rp._clock._rampDuration;
+  let duration = typeof options?.duration === "number" ? Math.max(options.duration, rampDuration) : rampDuration;
+  duration = Math.max(rampDuration, duration);
+  if (duration < MinRampDuration) {
+    rp._param.setValueAtTime(value, startTime);
+    return;
+  }
+  try {
+    const from = Number.isFinite(rp._param.value) ? rp._param.value : 0;
+    rp._param.setValueCurveAtTime(getRampCurveValues(shape, from, value), startTime, duration);
+    rp._rampEndTime = startTime + duration;
+  } catch (e) {
+    if (!warnedRampFailure) {
+      console.warn(`Audio parameter ramping failed: ${e.message}`);
+      warnedRampFailure = true;
+    }
+  }
+}
+
+export { createRampParam, getRampCurveValues, isRamping, setRampTarget };
+//# sourceMappingURL=audio-param.js.map

package/lib/audio/audio-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-param.js","sources":["../../../src/audio/audio-param.ts"],"sourcesContent":["/**\n * Audio parameter ramping — faithful port of Babylon.js AudioV2\n * `audioUtils._GetAudioParamCurveValues` + `_WebAudioParameterComponent`,\n * re-shaped to pure functions + a small pure-state wrapper.\n *\n * The exponential/logarithmic normalized curves are cached via lazy-init\n * (never at module scope) so this module has zero import-time side effects.\n * The curve math is copied verbatim from AudioV2 to preserve identical output.\n */\n\n/** Ramp shape used when changing an audio parameter (volume, pan, position…). */\nexport type AudioRampShape = \"none\" | \"linear\" | \"exponential\" | \"logarithmic\";\n\n/** Options for ramping an audio parameter's value. */\nexport interface RampOptions {\n    /** Ramp time, in seconds. Clamped to at least the engine's `parameterRampDuration`. */\n    duration?: number;\n    /** Ramp shape. Defaults to `\"linear\"`. */\n    shape?: AudioRampShape;\n}\n\n/**\n * Supplies the audio clock and default ramp duration for a parameter ramp.\n * The `AudioEngine` state object satisfies this.\n * @internal\n */\nexport interface RampClock {\n    /** The audio context's `currentTime`, in seconds. @internal */\n    readonly _currentTime: number;\n    /** Default ramp smoothing, in seconds. @internal */\n    readonly _rampDuration: number;\n}\n\nconst CurveLength = 100;\n\n/**\n * Minimum ramp duration in seconds. Below this the value is set immediately —\n * there is no perceptual difference, so a curve is not scheduled.\n */\nconst MinRampDuration = 0.000001;\n\nlet TmpCurveValues: Float32Array | null = null;\nlet ExpCurve: Float32Array | null = null;\nlet LogCurve: Float32Array | null = null;\nconst TmpLineValues = new Float32Array([0, 0]); // typed-array literal — bundler-safe, no side effect.\n\nfunction getExpCurve(): Float32Array {\n    if (!ExpCurve) {\n        ExpCurve = new Float32Array(CurveLength);\n        const increment = 1 / (CurveLength - 1);\n        let x = increment;\n        for (let i = 1; i < CurveLength; i++) {\n            ExpCurve[i] = Math.exp(-11.512925464970227 * (1 - x));\n            x += increment;\n        }\n    }\n    return ExpCurve;\n}\n\nfunction getLogCurve(): Float32Array {\n    if (!LogCurve) {\n        LogCurve = new Float32Array(CurveLength);\n        const increment = 1 / CurveLength;\n        let x = increment;\n        for (let i = 0; i < CurveLength; i++) {\n            LogCurve[i] = 1 + Math.log10(x) / Math.log10(CurveLength);\n            x += increment;\n        }\n    }\n    return LogCurve;\n}\n\n/**\n * Returns the value-curve array for a `setValueCurveAtTime` call ramping from\n * `from` to `to` with the given shape. Linear returns a shared 2-element array;\n * exp/log return a shared 100-element array. Both are reused buffers — copy if\n * you need to retain the values.\n * @internal\n */\nexport function getRampCurveValues(shape: Exclude<AudioRampShape, \"none\">, from: number, to: number): Float32Array {\n    if (shape === \"linear\") {\n        TmpLineValues[0] = from;\n        TmpLineValues[1] = to;\n        return TmpLineValues;\n    }\n\n    if (!TmpCurveValues) {\n        TmpCurveValues = new Float32Array(CurveLength);\n    }\n\n    const normalizedCurve = shape === \"exponential\" ? getExpCurve() : getLogCurve();\n\n    const direction = Math.sign(to - from);\n    const range = Math.abs(to - from);\n\n    if (direction === 1) {\n        for (let i = 0; i < normalizedCurve.length; i++) {\n            TmpCurveValues[i] = from + range * normalizedCurve[i]!;\n        }\n    } else {\n        let j = CurveLength - 1;\n        for (let i = 0; i < normalizedCurve.length; i++, j--) {\n            TmpCurveValues[i] = from - range * (1 - normalizedCurve[j]!);\n        }\n    }\n\n    return TmpCurveValues;\n}\n\n/**\n * Pure-state wrapper around a Web Audio `AudioParam` that performs shaped\n * ramping. Mirrors AudioV2 `_WebAudioParameterComponent`.\n * @internal\n */\nexport interface RampParam {\n    /** @internal */ _param: AudioParam;\n    /** @internal */ _clock: RampClock;\n    /** @internal */ _targetValue: number;\n    /** @internal */ _rampEndTime: number;\n}\n\n/** @internal */\nexport function createRampParam(param: AudioParam, clock: RampClock): RampParam {\n    return { _param: param, _clock: clock, _targetValue: param.value, _rampEndTime: 0 };\n}\n\n/** Whether the parameter is currently mid-ramp. @internal */\nexport function isRamping(rp: RampParam): boolean {\n    return rp._clock._currentTime < rp._rampEndTime;\n}\n\nlet warnedRampFailure = false;\n\n/**\n * Sets the target value of the parameter, ramping with the given shape/duration.\n * Faithful port of `_WebAudioParameterComponent.setTargetValue`.\n * @internal\n */\nexport function setRampTarget(rp: RampParam, value: number, options?: RampOptions): void {\n    if (!Number.isFinite(value)) {\n        console.warn(`Attempted to set audio parameter to non-finite value: ${value}`);\n        return;\n    }\n\n    rp._param.cancelScheduledValues(0);\n\n    const shape: AudioRampShape = typeof options?.shape === \"string\" ? options.shape : \"linear\";\n    const startTime = rp._clock._currentTime;\n\n    if (shape === \"none\") {\n        rp._param.value = rp._targetValue = value;\n        rp._rampEndTime = startTime;\n        return;\n    }\n\n    rp._targetValue = value;\n\n    const rampDuration = rp._clock._rampDuration;\n    let duration = typeof options?.duration === \"number\" ? Math.max(options.duration, rampDuration) : rampDuration;\n    duration = Math.max(rampDuration, duration);\n\n    if (duration < MinRampDuration) {\n        rp._param.setValueAtTime(value, startTime);\n        return;\n    }\n\n    try {\n        const from = Number.isFinite(rp._param.value) ? rp._param.value : 0;\n        rp._param.setValueCurveAtTime(getRampCurveValues(shape, from, value), startTime, duration);\n        rp._rampEndTime = startTime + duration;\n    } catch (e) {\n        if (!warnedRampFailure) {\n            console.warn(`Audio parameter ramping failed: ${(e as Error).message}`);\n            warnedRampFailure = true;\n        }\n    }\n}\n"],"names":[],"mappings":"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"}

package/lib/audio/audio-signal.js

@@ -0,0 +1,46 @@
+function createAudioSignal() {
+  let entries = null;
+  const remove = (callback) => {
+    if (!entries) {
+      return;
+    }
+    const i = entries.findIndex((e) => e.cb === callback);
+    if (i !== -1) {
+      entries.splice(i, 1);
+    }
+  };
+  return {
+    add(callback) {
+      (entries ??= []).push({ cb: callback, once: false });
+      return () => remove(callback);
+    },
+    addOnce(callback) {
+      (entries ??= []).push({ cb: callback, once: true });
+      return () => remove(callback);
+    },
+    _removeCallback(callback) {
+      remove(callback);
+    },
+    _notify(value) {
+      if (!entries || entries.length === 0) {
+        return;
+      }
+      const snapshot = entries.slice();
+      for (const entry of snapshot) {
+        if (entry.once) {
+          remove(entry.cb);
+        }
+        entry.cb(value);
+      }
+    },
+    _clear() {
+      entries = null;
+    },
+    _hasObservers() {
+      return !!entries && entries.length > 0;
+    }
+  };
+}
+
+export { createAudioSignal };
+//# sourceMappingURL=audio-signal.js.map

package/lib/audio/audio-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-signal.js","sources":["../../../src/audio/audio-signal.ts"],"sourcesContent":["/**\n * Lightweight event signal — Babylon Lite's tree-shakable replacement for the\n * core `Observable`. Pure state + standalone-ish callback set. No module-level\n * side effects: the callback set is created lazily on first `add`.\n *\n * Behavioural parity with the subset of `Observable` the audio engine uses:\n * `add`, `addOnce`, `removeCallback`, `notifyObservers`, `clear`, `hasObservers`.\n */\n\n/** Public read surface of a signal — consumers can only subscribe. */\nexport interface AudioSignal<T> {\n    /** Subscribe. Returns an unsubscribe function. */\n    add(callback: (value: T) => void): () => void;\n    /** Subscribe for a single notification. Returns an unsubscribe function. */\n    addOnce(callback: (value: T) => void): () => void;\n}\n\n/** Full read/write signal — held internally by the engine/sounds. @internal */\nexport interface AudioSignalImpl<T> extends AudioSignal<T> {\n    /** @internal */ _removeCallback(callback: (value: T) => void): void;\n    /** @internal */ _notify(value: T): void;\n    /** @internal */ _clear(): void;\n    /** @internal */ _hasObservers(): boolean;\n}\n\ninterface Entry<T> {\n    cb: (value: T) => void;\n    once: boolean;\n}\n\n/** Create a new signal. No allocation happens until the first subscriber. @internal */\nexport function createAudioSignal<T>(): AudioSignalImpl<T> {\n    let entries: Entry<T>[] | null = null;\n\n    const remove = (callback: (value: T) => void): void => {\n        if (!entries) {\n            return;\n        }\n        const i = entries.findIndex((e) => e.cb === callback);\n        if (i !== -1) {\n            entries.splice(i, 1);\n        }\n    };\n\n    return {\n        add(callback) {\n            (entries ??= []).push({ cb: callback, once: false });\n            return () => remove(callback);\n        },\n        addOnce(callback) {\n            (entries ??= []).push({ cb: callback, once: true });\n            return () => remove(callback);\n        },\n        _removeCallback(callback) {\n            remove(callback);\n        },\n        _notify(value) {\n            if (!entries || entries.length === 0) {\n                return;\n            }\n            // Snapshot so callbacks may add/remove during iteration.\n            const snapshot = entries.slice();\n            for (const entry of snapshot) {\n                if (entry.once) {\n                    remove(entry.cb);\n                }\n                entry.cb(value);\n            }\n        },\n        _clear() {\n            entries = null;\n        },\n        _hasObservers() {\n            return !!entries && entries.length > 0;\n        },\n    };\n}\n"],"names":[],"mappings":"AA+BO,SAAS,iBAAA,GAA2C;AACvD,EAAA,IAAI,OAAA,GAA6B,IAAA;AAEjC,EAAA,MAAM,MAAA,GAAS,CAAC,QAAA,KAAuC;AACnD,IAAA,IAAI,CAAC,OAAA,EAAS;AACV,MAAA;AAAA,IACJ;AACA,IAAA,MAAM,IAAI,OAAA,CAAQ,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,QAAQ,CAAA;AACpD,IAAA,IAAI,MAAM,EAAA,EAAI;AACV,MAAA,OAAA,CAAQ,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,IACvB;AAAA,EACJ,CAAA;AAEA,EAAA,OAAO;AAAA,IACH,IAAI,QAAA,EAAU;AACV,MAAA,CAAC,OAAA,KAAY,EAAC,EAAG,IAAA,CAAK,EAAE,EAAA,EAAI,QAAA,EAAU,IAAA,EAAM,KAAA,EAAO,CAAA;AACnD,MAAA,OAAO,MAAM,OAAO,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,IACA,QAAQ,QAAA,EAAU;AACd,MAAA,CAAC,OAAA,KAAY,EAAC,EAAG,IAAA,CAAK,EAAE,EAAA,EAAI,QAAA,EAAU,IAAA,EAAM,IAAA,EAAM,CAAA;AAClD,MAAA,OAAO,MAAM,OAAO,QAAQ,CAAA;AAAA,IAChC,CAAA;AAAA,IACA,gBAAgB,QAAA,EAAU;AACtB,MAAA,MAAA,CAAO,QAAQ,CAAA;AAAA,IACnB,CAAA;AAAA,IACA,QAAQ,KAAA,EAAO;AACX,MAAA,IAAI,CAAC,OAAA,IAAW,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG;AAClC,QAAA;AAAA,MACJ;AAEA,MAAA,MAAM,QAAA,GAAW,QAAQ,KAAA,EAAM;AAC/B,MAAA,KAAA,MAAW,SAAS,QAAA,EAAU;AAC1B,QAAA,IAAI,MAAM,IAAA,EAAM;AACZ,UAAA,MAAA,CAAO,MAAM,EAAE,CAAA;AAAA,QACnB;AACA,QAAA,KAAA,CAAM,GAAG,KAAK,CAAA;AAAA,MAClB;AAAA,IACJ,CAAA;AAAA,IACA,MAAA,GAAS;AACL,MAAA,OAAA,GAAU,IAAA;AAAA,IACd,CAAA;AAAA,IACA,aAAA,GAAgB;AACZ,MAAA,OAAO,CAAC,CAAC,OAAA,IAAW,OAAA,CAAQ,MAAA,GAAS,CAAA;AAAA,IACzC;AAAA,GACJ;AACJ;;;;"}

package/lib/audio/bus.js

@@ -0,0 +1,33 @@
+import { createRampParam, setRampTarget } from './audio-param.js';
+
+function createMainOut(ctx, clock) {
+  const gain = new GainNode(ctx);
+  gain.connect(ctx.destination);
+  return { _gain: gain, _volumeRamp: createRampParam(gain.gain, clock) };
+}
+function setMainOutVolume(mainOut, value, options) {
+  setRampTarget(mainOut._volumeRamp, value, options);
+}
+function disposeMainOut(mainOut) {
+  mainOut._gain.disconnect();
+}
+function createMainBus(name, ctx, clock, mainOut) {
+  const volume = new GainNode(ctx);
+  volume.connect(mainOut._gain);
+  return {
+    name,
+    _volume: volume,
+    _volumeRamp: createRampParam(volume.gain, clock),
+    _in: volume,
+    _out: volume
+  };
+}
+function setMainBusVolume(bus, value, options) {
+  setRampTarget(bus._volumeRamp, value, options);
+}
+function disposeMainBus(bus) {
+  bus._volume.disconnect();
+}
+
+export { createMainBus, createMainOut, disposeMainBus, disposeMainOut, setMainBusVolume, setMainOutVolume };
+//# sourceMappingURL=bus.js.map

package/lib/audio/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sources":["../../../src/audio/bus.ts"],"sourcesContent":["/**\n * Main output + main bus.\n *\n * Faithful port of AudioV2 `_WebAudioMainOut` and `_WebAudioMainBus` collapsed\n * to pure state + functions. Graph (Phase 1):\n *\n * `mainBus._volume (GainNode)` -\\> `mainOut._gain (GainNode)` -\\> `ctx.destination`\n *\n * Sounds connect their sub-graph output into `mainBus._in`.\n */\n\nimport { type RampClock, type RampOptions, type RampParam, createRampParam, setRampTarget } from \"./audio-param.js\";\n\n/** Engine master output node. @internal */\nexport interface MainOut {\n    /** @internal */ _gain: GainNode;\n    /** @internal */ _volumeRamp: RampParam;\n}\n\n/** A main audio bus. Sounds route here by default. Pure state — drive it with the bus functions. */\nexport interface MainBus {\n    /** Bus name. */\n    readonly name: string;\n\n    /** @internal */ _volume: GainNode;\n    /** @internal */ _volumeRamp: RampParam;\n    /** Input node where upstream sounds/buses connect. @internal */ _in: AudioNode;\n    /** Output node feeding the main out. @internal */ _out: AudioNode;\n}\n\n/** @internal */\nexport function createMainOut(ctx: BaseAudioContext, clock: RampClock): MainOut {\n    const gain = new GainNode(ctx);\n    gain.connect(ctx.destination);\n    return { _gain: gain, _volumeRamp: createRampParam(gain.gain, clock) };\n}\n\n/** @internal */\nexport function setMainOutVolume(mainOut: MainOut, value: number, options?: RampOptions): void {\n    setRampTarget(mainOut._volumeRamp, value, options);\n}\n\n/** @internal */\nexport function disposeMainOut(mainOut: MainOut): void {\n    mainOut._gain.disconnect();\n}\n\n/** @internal */\nexport function createMainBus(name: string, ctx: BaseAudioContext, clock: RampClock, mainOut: MainOut): MainBus {\n    const volume = new GainNode(ctx);\n    volume.connect(mainOut._gain);\n    return {\n        name,\n        _volume: volume,\n        _volumeRamp: createRampParam(volume.gain, clock),\n        _in: volume,\n        _out: volume,\n    };\n}\n\n/** @internal */\nexport function setMainBusVolume(bus: MainBus, value: number, options?: RampOptions): void {\n    setRampTarget(bus._volumeRamp, value, options);\n}\n\n/** @internal */\nexport function disposeMainBus(bus: MainBus): void {\n    bus._volume.disconnect();\n}\n"],"names":[],"mappings":";;AA+BO,SAAS,aAAA,CAAc,KAAuB,KAAA,EAA2B;AAC5E,EAAA,MAAM,IAAA,GAAO,IAAI,QAAA,CAAS,GAAG,CAAA;AAC7B,EAAA,IAAA,CAAK,OAAA,CAAQ,IAAI,WAAW,CAAA;AAC5B,EAAA,OAAO,EAAE,OAAO,IAAA,EAAM,WAAA,EAAa,gBAAgB,IAAA,CAAK,IAAA,EAAM,KAAK,CAAA,EAAE;AACzE;AAGO,SAAS,gBAAA,CAAiB,OAAA,EAAkB,KAAA,EAAe,OAAA,EAA6B;AAC3F,EAAA,aAAA,CAAc,OAAA,CAAQ,WAAA,EAAa,KAAA,EAAO,OAAO,CAAA;AACrD;AAGO,SAAS,eAAe,OAAA,EAAwB;AACnD,EAAA,OAAA,CAAQ,MAAM,UAAA,EAAW;AAC7B;AAGO,SAAS,aAAA,CAAc,IAAA,EAAc,GAAA,EAAuB,KAAA,EAAkB,OAAA,EAA2B;AAC5G,EAAA,MAAM,MAAA,GAAS,IAAI,QAAA,CAAS,GAAG,CAAA;AAC/B,EAAA,MAAA,CAAO,OAAA,CAAQ,QAAQ,KAAK,CAAA;AAC5B,EAAA,OAAO;AAAA,IACH,IAAA;AAAA,IACA,OAAA,EAAS,MAAA;AAAA,IACT,WAAA,EAAa,eAAA,CAAgB,MAAA,CAAO,IAAA,EAAM,KAAK,CAAA;AAAA,IAC/C,GAAA,EAAK,MAAA;AAAA,IACL,IAAA,EAAM;AAAA,GACV;AACJ;AAGO,SAAS,gBAAA,CAAiB,GAAA,EAAc,KAAA,EAAe,OAAA,EAA6B;AACvF,EAAA,aAAA,CAAc,GAAA,CAAI,WAAA,EAAa,KAAA,EAAO,OAAO,CAAA;AACjD;AAGO,SAAS,eAAe,GAAA,EAAoB;AAC/C,EAAA,GAAA,CAAI,QAAQ,UAAA,EAAW;AAC3B;;;;"}

package/lib/audio/host-types.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=host-types.js.map

package/lib/audio/host-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-types.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/audio/index.js

@@ -0,0 +1,12 @@
+export { createAudioEngineAsync, disposeAudioEngine, getMasterVolume, setMasterVolume, unlockAudioEngineAsync } from './audio-engine.js';
+export { SoundState, createSoundAsync, disposeSound, pauseSound, playSound, resumeSound, setSoundVolume, stopSound } from './static-sound.js';
+export { createStreamingSoundAsync, disposeStreamingSound, pauseStreamingSound, playStreamingSound, preloadStreamingInstanceAsync, preloadStreamingInstancesAsync, resumeStreamingSound, setStreamingSoundVolume, stopStreamingSound } from './streaming-sound.js';
+export { createAudioBusAsync, disposeAudioBus, setBusVolume } from './audio-bus.js';
+export { attachSpatialTarget, detachSpatialTarget, enableSpatial, setSpatialAutoUpdate, setSpatialListener, setSpatialListenerPosition, setSpatialOrientation, setSpatialPosition, updateSpatialAudio } from './spatial.js';
+export { enableStereo, setStereoPan } from './stereo.js';
+export { enableAnalyzer, getByteFrequencyData, getByteTimeDomainData, getFloatFrequencyData, getFloatTimeDomainData } from './analyzer.js';
+export { createMicrophoneSoundSourceAsync, createSoundSourceAsync, disposeSoundSource, setSoundSourceVolume } from './sound-source.js';
+export { createUnmuteUI, disposeUnmuteUI, setUnmuteUIEnabled } from './unmute-ui.js';
+export { createAudioVisualizer, disposeAudioVisualizer, renderAudioVisualizerFrame, startAudioVisualizer, stopAudioVisualizer } from './visualizer.js';
+export { createSoundBufferAsync } from './sound-buffer.js';
+//# sourceMappingURL=index.js.map

package/lib/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}