@adatechnology/game-audio 0.7.0 → 0.9.0

package/dist/index.js

@@ -23,31 +23,31 @@ import {
   GAME_SFX_BANK,
   GAME_SFX_CLASSES,
   GAME_SFX_FALLBACK,
-  KIT_CATEGORY_BUS,
   KIT_SAMPLES_BANK,
-  KIT_SAMPLE_ALIASES,
   LAYER_FLOOR,
   LIBRARY_BANK,
   LIBRARY_LOOPS,
   LIBRARY_SOUNDS,
+  LOCAL_PACK_LICENSES,
+  LOCAL_PACK_PREFERENCES,
   LOOP_SMOOTHING,
   LOOP_START_ABOVE,
+  LocalSoundPackError,
   MIX_PROFILES,
   OPEN_CUTOFF,
   PAN_LIMIT,
   PAN_MIN_DISTANCE,
   SAMPLE_ENVIRONMENTS,
-  SDK_LICENSES,
   SFX_BLOWS,
   SFX_CATALOG,
   SFX_CATEGORIES,
   SFX_IMPACTS,
-  SFX_LAYERS,
   SFX_MATERIALS,
-  SFX_TIERS,
+  TRIM_FADE,
   USER_SAMPLES_BANK,
   USER_SOUND_PREFIX,
   VOICE_GROUPS,
+  aliasSample,
   audioBenchTextOf,
   balanceOf,
   bufferOf,
@@ -81,19 +81,19 @@ import {
   impactSoundId,
   inlineLoader,
   isCalibrationUrl,
+  isShippableLicense,
   isSilent,
-  kitSampleBank,
-  kitSampleDefaults,
   limiterCurve,
   listenerDistance,
-  loadKitSamples,
   loadUserSamples,
+  localPackSamples,
   loopCrossfade,
+  loopRate,
   measureCriteria,
   noiseClassRecipe,
   onsetIndex,
   panFor,
-  parseSfxName,
+  parseLocalSoundPack,
   peakIndex,
   peakOf,
   pickTake,
@@ -106,20 +106,109 @@ import {
   retunePlan,
   ringSeconds,
   rmsDb,
-  sampleBankFromManifest,
   sampleCutoff,
   sampleLength,
   sampleUrls,
   sfxState,
   soundSourceOf,
-  splitTier,
   streamFor,
   streamSeed,
   tierFor,
   unlockContext,
-  userSampleBank,
+  userSampleBank
+} from "./chunk-UUWKSG4J.js";
+import {
+  KIT_CATEGORY_BUS,
+  KIT_SAMPLE_ALIASES,
+  SDK_LICENSES,
+  SFX_LAYERS,
+  SFX_TIERS,
+  kitSampleBank,
+  kitSampleDefaults,
+  loadKitSamples,
+  parseSfxName,
+  pointSamples,
+  sampleBankFromManifest,
+  splitTier,
   withAliases
-} from "./chunk-BXUGSOPY.js";
+} from "./chunk-JV5XXCQE.js";
+
+// src/local-pack-loader.ts
+var LOCAL_PACK_BANK_ID = "local_sound_pack";
+var STAGING_PREFIX = "local_pack_staging:";
+var defaultIdleScheduler = (task) => {
+  const idle = globalThis;
+  if (idle.requestIdleCallback && idle.cancelIdleCallback) {
+    const handle2 = idle.requestIdleCallback(task);
+    const cancel = idle.cancelIdleCallback;
+    return () => cancel(handle2);
+  }
+  const handle = setTimeout(task, 0);
+  return () => clearTimeout(handle);
+};
+function applyLocalSoundPack(engine, pack, options = {}) {
+  const schedule = options.schedule ?? defaultIdleScheduler;
+  const samples = localPackSamples(pack, options);
+  const statuses = new Map(samples.map((sample) => [sample.id, "pending"]));
+  const priors = /* @__PURE__ */ new Map();
+  const report = { file: [], sdk: [], fallback: [] };
+  const queue = [...samples];
+  let cancel;
+  let disposed = false;
+  let finish = () => void 0;
+  const done = new Promise((resolve) => {
+    finish = resolve;
+  });
+  const swapIn = (sample) => {
+    const prior = engine.registry.sample(sample.id);
+    const bank = engine.registry.bankOf(sample.id);
+    priors.set(sample.id, { ...prior ? { sample: prior } : {}, ...bank ? { bank } : {} });
+    engine.register({ id: LOCAL_PACK_BANK_ID, samples: [{ ...sample, ...prior?.fallback ? { fallback: prior.fallback } : {} }] });
+    statuses.set(sample.id, "file");
+    report.file.push(sample.id);
+  };
+  const loadOne = async (sample) => {
+    if (pack.sounds[sample.id]?.prefer === "sdk" && engine.registry.sample(sample.id)) {
+      statuses.set(sample.id, "sdk");
+      report.sdk.push(sample.id);
+      return;
+    }
+    const staging = `${STAGING_PREFIX}${sample.id}`;
+    engine.register({ id: LOCAL_PACK_BANK_ID, samples: [{ ...sample, id: staging }] });
+    const loaded = await engine.loadSamples([staging]);
+    engine.registry.removeSample(staging);
+    if (disposed) return;
+    if (loaded.failed.length === 0) return swapIn(sample);
+    statuses.set(sample.id, "fallback");
+    report.fallback.push({ id: sample.id, error: loaded.failed.map((entry) => `${entry.url}: ${entry.error}`).join("; ") });
+  };
+  const next = () => {
+    const sample = queue.shift();
+    if (!sample || disposed) {
+      if (!disposed) finish(report);
+      return;
+    }
+    void loadOne(sample).finally(() => {
+      if (!disposed) cancel = schedule(next);
+    });
+  };
+  cancel = schedule(next);
+  return {
+    done,
+    status: (id) => statuses.get(id),
+    unlicensed: () => samples.filter((sample) => statuses.get(sample.id) === "file" && !isShippableLicense(sample.license)).map((sample) => sample.id),
+    dispose() {
+      disposed = true;
+      cancel?.();
+      for (const [id, prior] of priors) {
+        if (prior.sample) engine.register({ id: prior.bank ?? LOCAL_PACK_BANK_ID, samples: [prior.sample] });
+        else engine.registry.removeSample(id);
+      }
+      priors.clear();
+      finish(report);
+    }
+  };
+}
 
 // src/recipes/scene.ts
 var ATTACK = 2e-3;
@@ -270,10 +359,140 @@ var CABIN_SOUNDS = [
     duration: 0.5,
     layers: [{ source: { kind: "osc", wave: "sine", frequency: { set: 880 } }, repeat: { count: 3, spacing: 0.7 }, envelope: [[0, 0.06, "set"], [0.5, 1e-4, "exp", "fixed"]] }],
     falloff: { model: "none" }
+  },
+  {
+    // the parking sensor: a short high beep, repeated by the cabin faster as the obstacle comes close
+    id: "parking_beep",
+    bus: "world",
+    duration: 0.09,
+    layers: [{ source: { kind: "osc", wave: "sine", frequency: { set: 2300 } }, envelope: [[0, 0.07, "set"], [0.08, 1e-4, "exp", "fixed"]] }],
+    falloff: { model: "none" }
+  },
+  {
+    // an emergency siren's wail: a tone rising and falling slowly (one sweep about every 3 s), played again by the cabin as it ends
+    id: "siren_wail",
+    bus: "world",
+    order: "siren",
+    duration: 3,
+    tail: 0.05,
+    layers: [
+      {
+        source: { kind: "osc", wave: "sawtooth", frequency: { set: 1050 } },
+        modulators: [{ target: "frequency", wave: "sine", rate: 0.33, depth: 420 }],
+        filters: { mode: "serial", bank: [{ type: "lowpass", frequency: { set: 2400 } }] },
+        envelope: [[0, 1e-4, "set", "fixed"], [0.08, 0.07, "linear"], [2.95, 0.07, "set"], [3, 1e-4, "exp", "fixed"]]
+      }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    // the yelp: the same tone swept fast, for a junction
+    id: "siren_yelp",
+    bus: "world",
+    order: "siren",
+    duration: 2,
+    tail: 0.05,
+    layers: [
+      {
+        source: { kind: "osc", wave: "sawtooth", frequency: { set: 1100 } },
+        modulators: [{ target: "frequency", wave: "triangle", rate: 4, depth: 380 }],
+        filters: { mode: "serial", bank: [{ type: "lowpass", frequency: { set: 2600 } }] },
+        envelope: [[0, 1e-4, "set", "fixed"], [0.05, 0.07, "linear"], [1.95, 0.07, "set"], [2, 1e-4, "exp", "fixed"]]
+      }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    // the wires under the column touching: a crackle of bright noise
+    id: "hotwire_spark",
+    bus: "world",
+    duration: 0.12,
+    layers: [
+      {
+        source: { kind: "noise", offset: "random" },
+        filters: { mode: "serial", bank: [{ type: "highpass", frequency: { set: 3200 } }] },
+        modulators: [{ target: "gain", wave: "square", rate: 60, depth: 0.1, base: 0.12 }],
+        envelope: [[0, 0.2, "set"], [0.12, 1e-4, "exp", "fixed"]]
+      }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    // the glovebox latch: a small plastic click and the lid dropping
+    id: "glovebox_latch",
+    bus: "world",
+    duration: 0.14,
+    layers: [
+      { source: { kind: "noise", offset: "random" }, filters: { mode: "serial", bank: [{ type: "bandpass", frequency: { set: 1800 }, q: 2 }] }, envelope: [[0, 0.16, "set"], [0.03, 1e-4, "exp", "fixed"]] },
+      { source: { kind: "osc", wave: "triangle", frequency: { set: 240 } }, envelope: [[0, 1e-4, "set", "fixed"], [0.06, 0.08, "linear"], [0.14, 1e-4, "exp", "fixed"]] }
+    ],
+    falloff: { model: "none" }
   }
 ];
 var CABIN_BANK = { id: "vehicle_cabin", sounds: CABIN_SOUNDS, loops: [] };
 
+// src/library/radio.ts
+var hz = (midi) => 440 * 2 ** ((midi - 69) / 12);
+var layer = (note, beat, wave, level) => {
+  const [at, midi, beats] = note;
+  const length = beats * beat;
+  return {
+    at: at * beat,
+    duration: length,
+    source: { kind: "osc", wave, frequency: { set: hz(midi) } },
+    envelope: [[0, 1e-4, "set"], [0.01, level, "linear"], [Math.max(0.02, length * 0.9), level * 0.35, "linear"], [length, 1e-4, "exp", "fixed"]]
+  };
+};
+function radioTrack(spec) {
+  const beat = 60 / spec.bpm;
+  const recipes = Array.from({ length: spec.bars }, (_, bar) => {
+    const inBar = (notes) => notes.filter((n) => n[0] >= bar * 4 && n[0] < bar * 4 + 4).map((n) => [n[0] - bar * 4, n[1], n[2]]);
+    const layers = [
+      ...inBar(spec.bass).map((n) => layer(n, beat, "triangle", 0.16)),
+      ...inBar(spec.chords).map((n) => layer(n, beat, "sine", 0.05)),
+      ...inBar(spec.melody).map((n) => layer(n, beat, spec.wave, 0.07))
+    ];
+    return { id: `${spec.id}_${bar}`, bus: "world", duration: 4 * beat, layers, falloff: { model: "none" } };
+  });
+  return { song: { id: spec.id, barSeconds: 4 * beat, bars: recipes.map((r) => r.id) }, recipes };
+}
+var chord = (bar, root, minor = false) => [[bar * 4, root, 4], [bar * 4, root + (minor ? 3 : 4), 4], [bar * 4, root + 7, 4]];
+var bassLine = (roots, pattern) => roots.flatMap((root, bar) => pattern.map((b) => [bar * 4 + b, root - 12, 0.9]));
+var TRACKS = [
+  // a bright pop loop: I–V–vi–IV in C
+  radioTrack({
+    id: "radio_track_pop",
+    bpm: 112,
+    bars: 4,
+    wave: "square",
+    bass: bassLine([48, 55, 57, 53], [0, 1.5, 2, 3]),
+    chords: [...chord(0, 60), ...chord(1, 55), ...chord(2, 57, true), ...chord(3, 53)],
+    melody: [[0, 76, 1], [1, 74, 0.5], [1.5, 72, 1.5], [4, 74, 1], [5, 76, 1], [6, 79, 2], [8, 76, 1], [9, 74, 1], [10, 72, 2], [12, 72, 1], [13, 74, 1], [14, 72, 2]]
+  }),
+  // a syncopated loop in A minor, the bass on the off-beats
+  radioTrack({
+    id: "radio_track_groove",
+    bpm: 100,
+    bars: 4,
+    wave: "triangle",
+    bass: bassLine([57, 62, 64, 57], [0, 0.75, 1.5, 2.5, 3.25]),
+    chords: [...chord(0, 57, true), ...chord(1, 62, true), ...chord(2, 64), ...chord(3, 57, true)],
+    melody: [[0.5, 72, 0.5], [1.25, 76, 0.75], [2.5, 74, 1], [4.5, 77, 0.5], [5.25, 74, 0.75], [6.5, 72, 1.5], [8.5, 71, 0.5], [9.25, 74, 0.75], [10.5, 76, 1.5], [12.5, 72, 0.5], [13.25, 69, 2]]
+  }),
+  // a slow blues-like loop in F with a swung melody
+  radioTrack({
+    id: "radio_track_slow",
+    bpm: 76,
+    bars: 4,
+    wave: "sine",
+    bass: bassLine([53, 58, 53, 60], [0, 2]),
+    chords: [...chord(0, 65), ...chord(1, 58), ...chord(2, 65), ...chord(3, 60)],
+    melody: [[0, 72, 1.5], [1.67, 75, 0.33], [2, 77, 2], [4, 74, 1], [5, 72, 1], [6, 70, 2], [8, 72, 1.5], [9.67, 69, 0.33], [10, 65, 2], [12, 67, 1], [13, 70, 1], [14, 72, 2]]
+  })
+];
+var RADIO_TRACKS = TRACKS.map((t) => t.song);
+var RADIO_BANK = { id: "vehicle_radio", sounds: TRACKS.flatMap((t) => t.recipes), loops: [] };
+
 // src/recipes/foley.ts
 var FOLEY_FALLOFF = {
   model: "inverse_square",
@@ -925,11 +1144,11 @@ function footLayers(surface, take, gait, weight = 1) {
     ...s.splash ? [sceneNoise({ type: "bandpass", f: s.splash.f * take.f, f2: s.splash.f2 * take.f, q: 1.4, d: s.splash.d * take.t * weight ** 0.4, vol: s.splash.vol * gait.vol * take.v * weight ** 0.5 })] : []
   ];
 }
-var quieter = (level, layers) => layers.map((layer) => {
-  const gain = layer.gain ?? 1;
-  if (typeof gain === "number") return { ...layer, gain: gain * level };
-  if (Array.isArray(gain)) return { ...layer, gain: [gain[0] * level, gain[1] * level] };
-  return layer;
+var quieter = (level, layers) => layers.map((layer2) => {
+  const gain = layer2.gain ?? 1;
+  if (typeof gain === "number") return { ...layer2, gain: gain * level };
+  if (Array.isArray(gain)) return { ...layer2, gain: [gain[0] * level, gain[1] * level] };
+  return layer2;
 });
 var recipe = (id, layers, falloff, bus = "world") => ({ id, bus, pan: true, layers, falloff, sources: ["sdk"] });
 var takeId = (id, index) => `${id}_${String(index + 1).padStart(2, "0")}`;
@@ -945,7 +1164,7 @@ var landing = (surface, landing2) => takes(
   (take) => quieter(LANDING_LEVEL, [
     // both feet, a hair apart, then the knees taking the weight (a low body thump) and the clothes settling
     ...footLayers(surface, take, GAITS.run, LANDINGS[landing2].weight),
-    ...footLayers(surface, { ...take, v: take.v * 0.6 }, GAITS.run, LANDINGS[landing2].weight * 0.6).map((layer) => ({ ...layer, at: (typeof layer.at === "number" ? layer.at : 0) + 0.018 * take.t })),
+    ...footLayers(surface, { ...take, v: take.v * 0.6 }, GAITS.run, LANDINGS[landing2].weight * 0.6).map((layer2) => ({ ...layer2, at: (typeof layer2.at === "number" ? layer2.at : 0) + 0.018 * take.t })),
     sceneTone({ f: 60 * take.f, f2: 38, d: 0.14 * LANDINGS[landing2].weight * take.t, vol: 0.22 * LANDINGS[landing2].weight ** 0.7 * take.v, delay: 0.02 }),
     sceneNoise({ type: "bandpass", f: [1800, 2600], q: 0.8, d: 0.18, vol: LANDINGS[landing2].cloth * take.v, delay: 0.04 })
   ]),
@@ -991,7 +1210,7 @@ var BODY = {
   fall_damage: (take) => [
     ...BODY.body_fall(take),
     sceneNoise({ type: "highpass", f: 2800, d: 0.02, vol: 0.35 * take.v, delay: 0.01 }),
-    ...voice({ f0: 170, f1: 110, d: 0.32, fA: 650, fB: 1150, noise: 0.25, vol: 0.32 })(take).map((layer) => ({ ...layer, at: 0.08 }))
+    ...voice({ f0: 170, f1: 110, d: 0.32, fA: 650, fB: 1150, noise: 0.25, vol: 0.32 })(take).map((layer2) => ({ ...layer2, at: 0.08 }))
   ],
   player_hurt: voice({ f0: 150, f1: 105, d: 0.26, fA: 620, fB: 1100, noise: 0.3, vol: 0.35 }),
   player_breath_run: (take) => [
@@ -1093,6 +1312,9 @@ function createAudioSink(engine) {
     },
     register(bank) {
       engine.register(bank);
+    },
+    preload(sounds) {
+      void engine.loadSamples(sounds).catch(() => void 0);
     }
   };
 }
@@ -1140,13 +1362,19 @@ export {
   LIBRARY_BANK,
   LIBRARY_LOOPS,
   LIBRARY_SOUNDS,
+  LOCAL_PACK_BANK_ID,
+  LOCAL_PACK_LICENSES,
+  LOCAL_PACK_PREFERENCES,
   LOOP_SMOOTHING,
   LOOP_START_ABOVE,
+  LocalSoundPackError,
   MIX_PROFILES,
   OPEN_CUTOFF,
   PAN_LIMIT,
   PAN_MIN_DISTANCE,
   PICKUP_CLASSES,
+  RADIO_BANK,
+  RADIO_TRACKS,
   SAMPLE_ENVIRONMENTS,
   SDK_LICENSES,
   SFX_BLOWS,
@@ -1156,9 +1384,12 @@ export {
   SFX_LAYERS,
   SFX_MATERIALS,
   SFX_TIERS,
+  TRIM_FADE,
   USER_SAMPLES_BANK,
   USER_SOUND_PREFIX,
   VOICE_GROUPS,
+  aliasSample,
+  applyLocalSoundPack,
   audioBenchTextOf,
   balanceOf,
   bufferOf,
@@ -1180,6 +1411,7 @@ export {
   crossGains,
   cutoffDivisor,
   dbOf,
+  defaultIdleScheduler,
   drawBetween,
   encodeWav,
   endDropDb,
@@ -1193,6 +1425,7 @@ export {
   impactSoundId,
   inlineLoader,
   isCalibrationUrl,
+  isShippableLicense,
   isSilent,
   kitSampleBank,
   kitSampleDefaults,
@@ -1200,17 +1433,22 @@ export {
   listenerDistance,
   loadKitSamples,
   loadUserSamples,
+  localPackSamples,
   loopCrossfade,
+  loopRate,
   measureCriteria,
   noiseClassRecipe,
   onsetIndex,
   panFor,
+  parseLocalSoundPack,
   parseSfxName,
   peakIndex,
   peakOf,
   pickTake,
   planSample,
   planSound,
+  pointSamples,
+  radioTrack,
   realize,
   realizeSample,
   recordOutput,