@vgai/engine 0.2.0 → 0.3.0

package/src/audio/vehicle.ts

@@ -1,235 +0,0 @@
-/**
- * Vehicle sounds — continuous sounds with real-time parameter control.
- *
- * Each returns play/stop/setX/dispose. Parameters use setTargetAtTime for smooth ramping.
- */
-
-function createNoiseBuffer(ctx: AudioContext, duration = 2): AudioBuffer {
-  const length = ctx.sampleRate * duration;
-  const buffer = ctx.createBuffer(1, length, ctx.sampleRate);
-  const data = buffer.getChannelData(0);
-  for (let i = 0; i < length; i++) data[i] = Math.random() * 2 - 1;
-  return buffer;
-}
-
-/** Engine drone — sawtooth oscillator with throttle-driven pitch and volume. */
-export function engineDrone(
-  ctx: AudioContext,
-  dest: AudioNode,
-  options?: { baseFreq?: number; volume?: number },
-) {
-  const baseFreq = options?.baseFreq ?? 60;
-  const maxVol = options?.volume ?? 0.4;
-
-  const out = ctx.createGain();
-  out.gain.value = 0;
-  out.connect(dest);
-
-  // Subtle waveshaping for grit
-  const shaper = ctx.createWaveShaper();
-  const curve = new Float32Array(256);
-  for (let i = 0; i < 256; i++) {
-    const x = (i / 128 - 1) * 1.5;
-    curve[i] = Math.tanh(x);
-  }
-  shaper.curve = curve;
-  shaper.connect(out);
-
-  let osc: OscillatorNode | null = null;
-
-  return {
-    play() {
-      if (osc) return;
-      osc = ctx.createOscillator();
-      osc.type = 'sawtooth';
-      osc.frequency.value = baseFreq;
-      osc.connect(shaper);
-      osc.start();
-      out.gain.setTargetAtTime(0.1, ctx.currentTime, 0.05);
-    },
-    stop() {
-      if (!osc) return;
-      out.gain.setTargetAtTime(0, ctx.currentTime, 0.05);
-      const ref = osc;
-      osc = null;
-      setTimeout(() => {
-        try {
-          ref.stop();
-        } catch {
-          /* already stopped */
-        }
-        ref.disconnect();
-      }, 200);
-    },
-    /** Set throttle 0–1. Adjusts pitch (1x–3x base) and volume. */
-    setThrottle(t: number) {
-      if (!osc) return;
-      const clamped = Math.max(0, Math.min(1, t));
-      osc.frequency.setTargetAtTime(baseFreq + clamped * baseFreq * 2, ctx.currentTime, 0.05);
-      out.gain.setTargetAtTime(0.1 + clamped * maxVol, ctx.currentTime, 0.05);
-    },
-    dispose() {
-      if (osc) {
-        try {
-          osc.stop();
-        } catch {
-          /* already stopped */
-        }
-        osc.disconnect();
-        osc = null;
-      }
-      shaper.disconnect();
-      out.disconnect();
-    },
-  };
-}
-
-/** Brake squeal — high-frequency oscillator with LFO tremolo. */
-export function brakeSqueal(
-  ctx: AudioContext,
-  dest: AudioNode,
-  options?: { pitch?: number; volume?: number },
-) {
-  const pitch = options?.pitch ?? 2000;
-  const maxVol = options?.volume ?? 0.3;
-
-  const out = ctx.createGain();
-  out.gain.value = 0;
-  out.connect(dest);
-
-  let osc: OscillatorNode | null = null;
-  let lfo: OscillatorNode | null = null;
-  let lfoGain: GainNode | null = null;
-
-  return {
-    play() {
-      if (osc) return;
-      osc = ctx.createOscillator();
-      osc.type = 'sine';
-      osc.frequency.value = pitch;
-
-      // LFO for tremolo effect
-      lfo = ctx.createOscillator();
-      lfo.type = 'sine';
-      lfo.frequency.value = 30;
-      lfoGain = ctx.createGain();
-      lfoGain.gain.value = 0.3;
-      lfo.connect(lfoGain);
-      lfoGain.connect(out.gain);
-
-      osc.connect(out);
-      osc.start();
-      lfo.start();
-    },
-    stop() {
-      if (!osc) return;
-      out.gain.setTargetAtTime(0, ctx.currentTime, 0.02);
-      const refs = { osc, lfo, lfoGain };
-      osc = null;
-      lfo = null;
-      lfoGain = null;
-      setTimeout(() => {
-        try {
-          refs.osc.stop();
-        } catch {
-          /* already stopped */
-        }
-        refs.osc.disconnect();
-        try {
-          refs.lfo?.stop();
-        } catch {
-          /* already stopped */
-        }
-        refs.lfo?.disconnect();
-        refs.lfoGain?.disconnect();
-      }, 100);
-    },
-    /** Set brake intensity 0–1. */
-    setIntensity(i: number) {
-      out.gain.setTargetAtTime(Math.max(0, Math.min(1, i)) * maxVol, ctx.currentTime, 0.02);
-    },
-    dispose() {
-      if (osc) {
-        try {
-          osc.stop();
-        } catch {
-          /* already stopped */
-        }
-        osc.disconnect();
-      }
-      if (lfo) {
-        try {
-          lfo.stop();
-        } catch {
-          /* already stopped */
-        }
-        lfo.disconnect();
-      }
-      lfoGain?.disconnect();
-      osc = null;
-      lfo = null;
-      lfoGain = null;
-      out.disconnect();
-    },
-  };
-}
-
-/** Tire skid — filtered looping noise with intensity control. */
-export function tireSkid(ctx: AudioContext, dest: AudioNode, options?: { volume?: number }) {
-  const maxVol = options?.volume ?? 0.3;
-  const noiseBuffer = createNoiseBuffer(ctx, 2);
-
-  const out = ctx.createGain();
-  out.gain.value = 0;
-  out.connect(dest);
-
-  const filter = ctx.createBiquadFilter();
-  filter.type = 'bandpass';
-  filter.frequency.value = 800;
-  filter.Q.value = 1.5;
-  filter.connect(out);
-
-  let src: AudioBufferSourceNode | null = null;
-
-  return {
-    play() {
-      if (src) return;
-      src = ctx.createBufferSource();
-      src.buffer = noiseBuffer;
-      src.loop = true;
-      src.connect(filter);
-      src.start();
-    },
-    stop() {
-      if (!src) return;
-      out.gain.setTargetAtTime(0, ctx.currentTime, 0.02);
-      const ref = src;
-      src = null;
-      setTimeout(() => {
-        try {
-          ref.stop();
-        } catch {
-          /* already stopped */
-        }
-        ref.disconnect();
-      }, 100);
-    },
-    /** Set skid intensity 0–1. */
-    setIntensity(i: number) {
-      out.gain.setTargetAtTime(Math.max(0, Math.min(1, i)) * maxVol, ctx.currentTime, 0.02);
-    },
-    dispose() {
-      if (src) {
-        try {
-          src.stop();
-        } catch {
-          /* already stopped */
-        }
-        src.disconnect();
-      }
-      src = null;
-      filter.disconnect();
-      out.disconnect();
-    },
-  };
-}

package/src/audio/weapons.ts

@@ -1,152 +0,0 @@
-/**
- * Weapon sounds — procedural combat audio.
- *
- * gunshot and laser are one-shot. chargeUp is continuous (play/stop).
- */
-
-function createNoiseBuffer(ctx: AudioContext, duration = 1): AudioBuffer {
-  const length = ctx.sampleRate * duration;
-  const buffer = ctx.createBuffer(1, length, ctx.sampleRate);
-  const data = buffer.getChannelData(0);
-  for (let i = 0; i < length; i++) data[i] = Math.random() * 2 - 1;
-  return buffer;
-}
-
-/** Sharp gunshot — highpass-filtered noise click. */
-export function gunshot(
-  ctx: AudioContext,
-  dest: AudioNode,
-  options?: { pitch?: number; volume?: number; duration?: number },
-) {
-  const pitch = options?.pitch ?? 1200;
-  const volume = options?.volume ?? 0.6;
-  const duration = options?.duration ?? 0.08;
-  const noiseBuffer = createNoiseBuffer(ctx, 0.3);
-
-  const out = ctx.createGain();
-  out.gain.value = volume;
-  out.connect(dest);
-
-  return {
-    play() {
-      const now = ctx.currentTime;
-      const src = ctx.createBufferSource();
-      src.buffer = noiseBuffer;
-
-      const hp = ctx.createBiquadFilter();
-      hp.type = 'highpass';
-      hp.frequency.value = pitch;
-
-      const env = ctx.createGain();
-      env.gain.setValueAtTime(1, now);
-      env.gain.exponentialRampToValueAtTime(0.001, now + duration);
-
-      src.connect(hp);
-      hp.connect(env);
-      env.connect(out);
-      src.start(now);
-      src.stop(now + duration + 0.01);
-    },
-    dispose() {
-      out.disconnect();
-    },
-  };
-}
-
-/** Laser — descending sawtooth frequency sweep. */
-export function laser(
-  ctx: AudioContext,
-  dest: AudioNode,
-  options?: { startFreq?: number; endFreq?: number; volume?: number; duration?: number },
-) {
-  const startFreq = options?.startFreq ?? 1200;
-  const endFreq = options?.endFreq ?? 200;
-  const volume = options?.volume ?? 0.4;
-  const duration = options?.duration ?? 0.2;
-
-  const out = ctx.createGain();
-  out.gain.value = volume;
-  out.connect(dest);
-
-  return {
-    play() {
-      const now = ctx.currentTime;
-      const osc = ctx.createOscillator();
-      osc.type = 'sawtooth';
-      osc.frequency.setValueAtTime(startFreq, now);
-      osc.frequency.exponentialRampToValueAtTime(endFreq, now + duration);
-
-      const env = ctx.createGain();
-      env.gain.setValueAtTime(1, now);
-      env.gain.exponentialRampToValueAtTime(0.001, now + duration);
-
-      osc.connect(env);
-      env.connect(out);
-      osc.start(now);
-      osc.stop(now + duration + 0.01);
-    },
-    dispose() {
-      out.disconnect();
-    },
-  };
-}
-
-/** Charge-up tone — ascending pitch, call play() to start and stop() to end. */
-export function chargeUp(
-  ctx: AudioContext,
-  dest: AudioNode,
-  options?: { startFreq?: number; endFreq?: number; volume?: number; duration?: number },
-) {
-  const startFreq = options?.startFreq ?? 100;
-  const endFreq = options?.endFreq ?? 800;
-  const volume = options?.volume ?? 0.3;
-  const duration = options?.duration ?? 2.0;
-
-  const out = ctx.createGain();
-  out.gain.value = 0;
-  out.connect(dest);
-
-  let osc: OscillatorNode | null = null;
-
-  return {
-    play() {
-      if (osc) return;
-      const now = ctx.currentTime;
-      osc = ctx.createOscillator();
-      osc.type = 'sawtooth';
-      osc.frequency.setValueAtTime(startFreq, now);
-      osc.frequency.exponentialRampToValueAtTime(endFreq, now + duration);
-      osc.connect(out);
-      osc.start(now);
-      out.gain.setValueAtTime(0.001, now);
-      out.gain.exponentialRampToValueAtTime(volume, now + 0.05);
-    },
-    stop() {
-      if (!osc) return;
-      const now = ctx.currentTime;
-      out.gain.setTargetAtTime(0, now, 0.02);
-      const ref = osc;
-      osc = null;
-      setTimeout(() => {
-        try {
-          ref.stop();
-        } catch {
-          /* already stopped */
-        }
-        ref.disconnect();
-      }, 100);
-    },
-    dispose() {
-      if (osc) {
-        try {
-          osc.stop();
-        } catch {
-          /* already stopped */
-        }
-        osc.disconnect();
-        osc = null;
-      }
-      out.disconnect();
-    },
-  };
-}