@adatechnology/game-audio 0.5.0 → 0.6.1

package/dist/index.js

@@ -23,6 +23,9 @@ 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,
@@ -34,11 +37,16 @@ import {
   PAN_LIMIT,
   PAN_MIN_DISTANCE,
   SAMPLE_ENVIRONMENTS,
+  SDK_LICENSES,
   SFX_BLOWS,
   SFX_CATALOG,
   SFX_CATEGORIES,
   SFX_IMPACTS,
+  SFX_LAYERS,
   SFX_MATERIALS,
+  SFX_TIERS,
+  USER_SAMPLES_BANK,
+  USER_SOUND_PREFIX,
   VOICE_GROUPS,
   audioBenchTextOf,
   balanceOf,
@@ -74,13 +82,18 @@ import {
   inlineLoader,
   isCalibrationUrl,
   isSilent,
+  kitSampleBank,
+  kitSampleDefaults,
   limiterCurve,
   listenerDistance,
+  loadKitSamples,
+  loadUserSamples,
   loopCrossfade,
   measureCriteria,
   noiseClassRecipe,
   onsetIndex,
   panFor,
+  parseSfxName,
   peakIndex,
   peakOf,
   pickTake,
@@ -93,151 +106,20 @@ import {
   retunePlan,
   ringSeconds,
   rmsDb,
+  sampleBankFromManifest,
   sampleCutoff,
   sampleLength,
   sampleUrls,
   sfxState,
+  soundSourceOf,
+  splitTier,
   streamFor,
   streamSeed,
   tierFor,
-  unlockContext
-} from "./chunk-7TLFY7VO.js";
-
-// src/manifest.ts
-var SDK_LICENSES = ["CC0", "CC-BY"];
-var SFX_LAYERS = ["close", "far", "tail_in", "tail_out"];
-var SFX_TIERS = { light: 0, medium: 0.34, heavy: 0.67 };
-function parseSfxName(name) {
-  const match = /^(.*?)(?:_(close|far|tail_in|tail_out))?(?:_(\d+))?$/.exec(name);
-  const id = match?.[1] || name;
-  const layer = match?.[2] ?? "close";
-  const take = match?.[3] ? Number(match[3]) : 1;
-  return { id, layer, take };
-}
-function splitTier(id) {
-  const match = /^(.*)_(light|medium|heavy)$/.exec(id);
-  return match ? { base: match[1], tier: match[2] } : { base: id };
-}
-var refsOf = (entries, baseUrl) => (entries ?? []).map((entry) => ({ url: `${baseUrl}${entry.file}` }));
-function sampleBankFromManifest(manifest, options) {
-  const baseUrl = options.baseUrl ?? "";
-  const samples = [];
-  const tiersOf = /* @__PURE__ */ new Map();
-  for (const sound of manifest.sounds) {
-    const { base, tier } = splitTier(sound.id);
-    if (tier) tiersOf.set(base, [...tiersOf.get(base) ?? [], sound]);
-  }
-  const bases = /* @__PURE__ */ new Map();
-  for (const sound of manifest.sounds) {
-    if (!splitTier(sound.id).tier) bases.set(sound.id, sound);
-  }
-  for (const [base, tiers] of tiersOf) {
-    if (!bases.has(base)) bases.set(base, { id: base, category: tiers[0]?.category ?? "", layers: { close: tiers[0]?.layers.close ?? [] } });
-  }
-  for (const sound of bases.values()) {
-    const numbers = options.sounds?.[sound.id] ?? options.defaults?.(sound);
-    const close = refsOf(sound.layers.close, baseUrl);
-    if (!numbers || close.length === 0) continue;
-    const tiers = (tiersOf.get(sound.id) ?? []).map((tier) => {
-      const name = splitTier(tier.id).tier;
-      const tierFar = refsOf(tier.layers.far, baseUrl);
-      return { name, from: SFX_TIERS[name] ?? 0, close: refsOf(tier.layers.close, baseUrl), ...tierFar.length > 0 ? { far: tierFar } : {} };
-    }).sort((a, b) => a.from - b.from);
-    const far = refsOf(sound.layers.far, baseUrl);
-    const indoor = refsOf(sound.layers.tail_in, baseUrl);
-    const outdoor = refsOf(sound.layers.tail_out, baseUrl);
-    const files = [sound, ...tiersOf.get(sound.id) ?? []].flatMap((entry) => Object.values(entry.layers).flatMap((entries) => entries ?? []));
-    samples.push({
-      id: sound.id,
-      bus: numbers.bus,
-      close,
-      ...far.length > 0 ? { far } : {},
-      ...tiers.length > 0 ? { tiers } : {},
-      ...numbers.crossover ? { crossover: numbers.crossover } : {},
-      ...indoor.length > 0 || outdoor.length > 0 ? { tail: { ...indoor.length > 0 ? { indoor } : {}, ...outdoor.length > 0 ? { outdoor } : {}, ...numbers.tailGain === void 0 ? {} : { gain: numbers.tailGain } } } : {},
-      ...numbers.pitch === void 0 ? {} : { pitch: numbers.pitch },
-      ...numbers.gain === void 0 ? {} : { gain: numbers.gain },
-      ...numbers.falloff ? { falloff: numbers.falloff } : {},
-      ...numbers.cutoffK === void 0 ? {} : { cutoffK: numbers.cutoffK },
-      ...numbers.group ? { group: numbers.group } : {},
-      ...numbers.priority === void 0 ? {} : { priority: numbers.priority },
-      ...numbers.fallback ? { fallback: numbers.fallback } : {},
-      sources: files.map((file) => `${file.file}: ${file.source} ${file.author} ${file.license}`)
-    });
-  }
-  return { id: options.id, samples };
-}
-
-// src/kit-samples.ts
-var KIT_CATEGORY_BUS = {
-  armas: "weapons",
-  impactos: "world",
-  "explosoes-fogo": "world",
-  personagem: "world",
-  veiculos: "world",
-  "itens-portas": "world",
-  ambiente: "ambience"
-};
-var VOICE_IDS = /^(player_(hurt|death|effort|breath)|scream|zombie_)/;
-var KIT_SAMPLE_ALIASES = {
-  // a house door: the latch giving, the hinge, the leaf meeting the frame, a locked one shaken; a drawer on its runners
-  latch: "metal_latch",
-  creak_wood: "door_creak",
-  shut_wood: "door_wood_shut",
-  rattle: "door_locked_rattle",
-  // a drawer stays on its recipe: the recorded runs (1 to 1.9 s) outlast a drawer's pull
-  // an item taken in the hand (game-destruction-three grab_* keys)
-  grab_hard: "item_pickup_generic",
-  grab_soft: "item_pickup_leather"
-};
-function kitSampleDefaults(sound) {
-  const bus = VOICE_IDS.test(sound.id) ? "voices" : KIT_CATEGORY_BUS[sound.category];
-  if (!bus) return void 0;
-  return { bus, pitch: sound.category === "ambiente" || /_loop/.test(sound.id) ? 0 : 0.04 };
-}
-function withAliases(manifest, aliases) {
-  const byId = new Map(manifest.sounds.map((sound) => [sound.id, sound]));
-  const extra = [];
-  for (const [alias, target] of Object.entries(aliases)) {
-    const sound = byId.get(target);
-    if (sound && !byId.has(alias)) extra.push({ ...sound, id: alias });
-  }
-  return { ...manifest, sounds: [...manifest.sounds, ...extra] };
-}
-function kitSampleBank(manifest, options = {}) {
-  return sampleBankFromManifest(withAliases(manifest, options.aliases ?? KIT_SAMPLE_ALIASES), {
-    id: options.id ?? "kit_samples",
-    baseUrl: options.baseUrl ?? "",
-    defaults: kitSampleDefaults
-  });
-}
-var isFileUrl = (url) => {
-  const page = globalThis.location?.href;
-  try {
-    return new URL(url, page).protocol === "file:";
-  } catch {
-    return false;
-  }
-};
-var fetchJson = async (url) => {
-  if (isFileUrl(url)) throw new Error(`${url}: file:// is not fetched`);
-  const response = await fetch(url);
-  if (!response.ok) throw new Error(`${url}: ${response.status}`);
-  return await response.json();
-};
-async function loadKitSamples(engine, options = {}) {
-  const baseUrl = options.baseUrl ?? "";
-  let manifest;
-  try {
-    manifest = await (options.fetchManifest ?? fetchJson)(`${baseUrl}manifest.json`);
-  } catch {
-    return null;
-  }
-  const bank = kitSampleBank(manifest, options);
-  engine.register(bank);
-  if (options.preload && engine.loadSamples) void engine.loadSamples(options.preload).catch(() => void 0);
-  return bank;
-}
+  unlockContext,
+  userSampleBank,
+  withAliases
+} from "./chunk-KBTUANNG.js";
 
 // src/recipes/scene.ts
 var ATTACK = 2e-3;
@@ -316,6 +198,82 @@ function sceneRecipe(id, layers, line, options = {}) {
   };
 }
 
+// src/library/cabin.ts
+var CABIN_SOUNDS = [
+  {
+    id: "blinker_tick",
+    bus: "world",
+    duration: 0.03,
+    layers: [
+      // the relay: a click of bright noise and a short low knock
+      { source: { kind: "noise", offset: "random" }, filters: { mode: "serial", bank: [{ type: "highpass", frequency: { set: 2600 } }] }, envelope: [[0, 0.22, "set"], [0.025, 1e-4, "exp", "fixed"]] },
+      { source: { kind: "osc", wave: "triangle", frequency: { set: 180 } }, envelope: [[0, 0.12, "set"], [0.03, 1e-4, "exp", "fixed"]] }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    id: "starter_crank",
+    bus: "world",
+    duration: 0.9,
+    layers: [
+      // the starter motor turning the engine over: low noise chopped at the compression strokes
+      {
+        source: { kind: "noise", offset: "random" },
+        filters: { mode: "serial", bank: [{ type: "lowpass", frequency: { set: 420 } }] },
+        modulators: [{ target: "gain", wave: "square", rate: 11, depth: 0.08, base: 0.1 }],
+        envelope: [[0, 1e-4, "set", "fixed"], [0.05, 0.25, "linear"], [0.8, 0.22, "set"], [0.9, 1e-4, "exp", "fixed"]]
+      },
+      { source: { kind: "osc", wave: "sawtooth", frequency: { set: 95, to: 120, curve: "linear", over: 0.9 } }, filters: { mode: "serial", bank: [{ type: "lowpass", frequency: { set: 300 } }] }, envelope: [[0, 0.04, "set"], [0.9, 1e-4, "exp", "fixed"]] }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    id: "car_alarm",
+    bus: "world",
+    order: "siren",
+    duration: 3,
+    tail: 0.1,
+    layers: [
+      // the whoop of a car alarm: a square swept up and down three times a second
+      {
+        source: { kind: "osc", wave: "square", frequency: { set: 1100 } },
+        modulators: [{ target: "frequency", wave: "triangle", rate: 3, depth: 420 }],
+        filters: { mode: "serial", bank: [{ type: "lowpass", frequency: { set: 2600 } }] },
+        envelope: [[0, 1e-4, "set", "fixed"], [0.05, 0.05, "linear"], [2.9, 0.05, "set"], [3, 1e-4, "exp", "fixed"]]
+      }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    id: "alarm_chirp",
+    bus: "world",
+    duration: 0.1,
+    layers: [{ source: { kind: "osc", wave: "square", frequency: { set: 2300 } }, repeat: { count: 2, spacing: 0.16 }, envelope: [[0, 0.05, "set"], [0.09, 1e-4, "exp", "fixed"]] }],
+    falloff: { model: "none" }
+  },
+  {
+    id: "wiper_swish",
+    bus: "world",
+    duration: 0.45,
+    layers: [
+      {
+        source: { kind: "noise", offset: "random" },
+        filters: { mode: "serial", bank: [{ type: "bandpass", frequency: { set: 700, to: 1100, curve: "linear", over: 0.45 }, q: 1.2 }] },
+        envelope: [[0, 1e-4, "set", "fixed"], [0.2, 0.06, "linear"], [0.45, 1e-4, "exp", "fixed"]]
+      }
+    ],
+    falloff: { model: "none" }
+  },
+  {
+    id: "seatbelt_chime",
+    bus: "world",
+    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" }
+  }
+];
+var CABIN_BANK = { id: "vehicle_cabin", sounds: CABIN_SOUNDS, loops: [] };
+
 // src/recipes/foley.ts
 var FOLEY_FALLOFF = {
   model: "inverse_square",
@@ -1147,6 +1105,8 @@ export {
   BUILD_ORDERS,
   BUS_IDS,
   BUS_PRIORITY,
+  CABIN_BANK,
+  CABIN_SOUNDS,
   CALIBRATION_ID,
   CALIBRATION_LOOP_ID,
   CALIBRATION_LOOP_SOUND,
@@ -1172,6 +1132,7 @@ export {
   GAME_SFX_FALLBACK,
   ITEM_FOLEY,
   KIT_CATEGORY_BUS,
+  KIT_SAMPLES_BANK,
   KIT_SAMPLE_ALIASES,
   LAYER_FLOOR,
   LEAF_FOLEY,
@@ -1195,6 +1156,8 @@ export {
   SFX_LAYERS,
   SFX_MATERIALS,
   SFX_TIERS,
+  USER_SAMPLES_BANK,
+  USER_SOUND_PREFIX,
   VOICE_GROUPS,
   audioBenchTextOf,
   balanceOf,
@@ -1236,6 +1199,7 @@ export {
   limiterCurve,
   listenerDistance,
   loadKitSamples,
+  loadUserSamples,
   loopCrossfade,
   measureCriteria,
   noiseClassRecipe,
@@ -1264,11 +1228,13 @@ export {
   sceneTone,
   sceneVoice,
   sfxState,
+  soundSourceOf,
   splitTier,
   streamFor,
   streamSeed,
   tierFor,
   unlockContext,
+  userSampleBank,
   withAliases
 };
 //# sourceMappingURL=index.js.map