@adatechnology/game-audio 0.5.0 → 0.6.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SampleSound, a as SampleLoader, B as BusId, b as SampleCrossover, F as Falloff, c as SoundBank, L as LoopRecipe, d as SoundRecipe, P as ParamRef, R as Range, e as Layer, f as SoundSet, g as SoundPlan, h as SamplePlan, A as AudioLoopHandle, i as LoopEntry, M as MixProfile, j as AudioEngine } from './locale-BugSe8dA.js';
-export { k as ActionCheck, l as AudioBenchText, m as AudioChannel, n as AudioEngineOptions, o as AudioScenarioLike, p as AudioStats, q as AudioTestModule, r as AudioTestModuleOptions, s as Automation, t as BENCH_BANK, u as BUILD_ORDERS, v as BUS_IDS, w as BUS_PRIORITY, x as BuildOrder, y as BusSetting, C as CRITERIA, z as CRITERIA_TARGETS, D as CriterionId, E as CriterionResult, G as Curve, H as DEFAULT_CROSSOVER, I as DEFAULT_LISTENER, J as DEFAULT_MAX_VOICES, K as DEFAULT_MIX, N as DEFAULT_SAMPLE_CUTOFF_K, O as DEFAULT_SAMPLE_FALLOFF, Q as DEFAULT_SAMPLE_PITCH, T as DEFAULT_TAIL_GAIN, U as DeepPartial, V as DistanceMode, W as Envelope, X as EnvelopePoint, Y as FilterBank, Z as FilterSpec, _ as FormantVoiceSource, $ as LAYER_FLOOR, a0 as LayerSource, a1 as Listener, a2 as LoopOrder, a3 as LoopSet, a4 as MIX_PROFILES, a5 as MeasureOptions, a6 as Modulator, a7 as NoiseSource, a8 as OPEN_CUTOFF, a9 as OscSource, aa as PAN_LIMIT, ab as PAN_MIN_DISTANCE, ac as PlanInput, ad as PlannedAutomation, ae as PlannedEnvelopePoint, af as PlannedFilter, ag as PlannedLayer, ah as PlannedModulator, ai as PlannedSampleLayer, aj as PlannedSource, ak as PlayOptions, al as SAMPLE_ENVIRONMENTS, am as SFX_BLOWS, an as SFX_CATALOG, ao as SFX_CATEGORIES, ap as SFX_IMPACTS, aq as SFX_MATERIALS, ar as SampleEnvironment, as as SampleLayerRole, at as SampleLoadReport, au as SampleMemory, av as SampleOptions, aw as SamplePlanInput, ax as SampleRef, ay as SampleStatus, az as SampleStore, aA as SampleTail, aB as SampleTier, aC as SfxBlow, aD as SfxCategory, aE as SfxEntry, aF as SfxMaterial, aG as SfxPriority, aH as SfxState, aI as SoundRegistry, aJ as StartQueueOptions, aK as Time, aL as VOICE_GROUPS, aM as VoiceDecision, aN as VoiceGroup, aO as VoiceHandle, aP as VoiceManager, aQ as VoiceManagerOptions, aR as VoiceRefusal, aS as VoiceRequest, aT as VoiceStartEvent, aU as VoiceStats, aV as audioBenchTextOf, aW as busGain, aX as busPriority, aY as createAudioEngine, aZ as createAudioTestModule, a_ as createSampleStore, a$ as createSoundRegistry, b0 as createVoiceManager, b1 as crossGains, b2 as farMixAt, b3 as fetchLoader, b4 as impactSoundId, b5 as inlineLoader, b6 as limiterCurve, b7 as listenerDistance, b8 as measureCriteria, b9 as panFor, ba as pickTake, bb as planSample, bc as planSound, bd as recordOutput, be as resolveMix, bf as sampleCutoff, bg as sampleUrls, bh as sfxState, bi as tierFor } from './locale-BugSe8dA.js';
+import { S as SampleSound, a as SampleLoader, B as BusId, b as SfxManifest, c as SoundBank, d as SampleDefaults, F as Falloff, L as LoopRecipe, e as SoundRecipe, P as ParamRef, R as Range, f as Layer, g as SoundSet, h as SoundPlan, i as SamplePlan, A as AudioLoopHandle, j as LoopEntry, M as MixProfile, k as AudioEngine } from './locale-CJfDpWnI.js';
+export { l as ActionCheck, m as AudioBenchText, n as AudioChannel, o as AudioEngineOptions, p as AudioScenarioLike, q as AudioStats, r as AudioTestModule, s as AudioTestModuleOptions, t as Automation, u as BENCH_BANK, v as BUILD_ORDERS, w as BUS_IDS, x as BUS_PRIORITY, y as BuildOrder, z as BusSetting, C as CRITERIA, D as CRITERIA_TARGETS, E as CriterionId, G as CriterionResult, H as Curve, I as DEFAULT_CROSSOVER, J as DEFAULT_LISTENER, K as DEFAULT_MAX_VOICES, N as DEFAULT_MIX, O as DEFAULT_SAMPLE_CUTOFF_K, Q as DEFAULT_SAMPLE_FALLOFF, T as DEFAULT_SAMPLE_PITCH, U as DEFAULT_TAIL_GAIN, V as DeepPartial, W as DistanceMode, X as Envelope, Y as EnvelopePoint, Z as FilterBank, _ as FilterSpec, $ as FormantVoiceSource, a0 as KIT_SAMPLES_BANK, a1 as LAYER_FLOOR, a2 as LayerSource, a3 as Listener, a4 as LoadUserSamplesOptions, a5 as LoopOrder, a6 as LoopSet, a7 as MIX_PROFILES, a8 as MeasureOptions, a9 as Modulator, aa as NoiseSource, ab as OPEN_CUTOFF, ac as OscSource, ad as PAN_LIMIT, ae as PAN_MIN_DISTANCE, af as PlanInput, ag as PlannedAutomation, ah as PlannedEnvelopePoint, ai as PlannedFilter, aj as PlannedLayer, ak as PlannedModulator, al as PlannedSampleLayer, am as PlannedSource, an as PlayOptions, ao as SAMPLE_ENVIRONMENTS, ap as SDK_LICENSES, aq as SFX_BLOWS, ar as SFX_CATALOG, as as SFX_CATEGORIES, at as SFX_IMPACTS, au as SFX_LAYERS, av as SFX_MATERIALS, aw as SFX_TIERS, ax as SampleBankOptions, ay as SampleCrossover, az as SampleEnvironment, aA as SampleLayerRole, aB as SampleLoadReport, aC as SampleMemory, aD as SampleOptions, aE as SamplePlanInput, aF as SampleRef, aG as SampleStatus, aH as SampleStore, aI as SampleTail, aJ as SampleTier, aK as SdkLicense, aL as SfxBlow, aM as SfxCategory, aN as SfxEntry, aO as SfxFileEntry, aP as SfxLayer, aQ as SfxManifestLike, aR as SfxManifestSound, aS as SfxMaterial, aT as SfxPriority, aU as SfxState, aV as SoundRegistry, aW as SoundSource, aX as StartQueueOptions, aY as Time, aZ as USER_SAMPLES_BANK, a_ as USER_SOUND_PREFIX, a$ as UserSampleBankOptions, b0 as UserSampleBankResult, b1 as UserSfxFile, b2 as UserSfxManifest, b3 as UserSfxSound, b4 as UserSoundPick, b5 as UserSoundPicks, b6 as UserSoundRole, b7 as VOICE_GROUPS, b8 as VoiceDecision, b9 as VoiceGroup, ba as VoiceHandle, bb as VoiceManager, bc as VoiceManagerOptions, bd as VoiceRefusal, be as VoiceRequest, bf as VoiceStartEvent, bg as VoiceStats, bh as audioBenchTextOf, bi as busGain, bj as busPriority, bk as createAudioEngine, bl as createAudioTestModule, bm as createSampleStore, bn as createSoundRegistry, bo as createVoiceManager, bp as crossGains, bq as farMixAt, br as fetchLoader, bs as impactSoundId, bt as inlineLoader, bu as limiterCurve, bv as listenerDistance, bw as loadUserSamples, bx as measureCriteria, by as panFor, bz as parseSfxName, bA as pickTake, bB as planSample, bC as planSound, bD as recordOutput, bE as resolveMix, bF as sampleBankFromManifest, bG as sampleCutoff, bH as sampleUrls, bI as sfxState, bJ as soundSourceOf, bK as splitTier, bL as tierFor, bM as userSampleBank } from './locale-CJfDpWnI.js';
 import { AudioSink } from '@adatechnology/game-contracts';
 
 /** Deterministic mulberry32 generator; floats in [0, 1). The same generator the golden tool seeds `Math.random` with, so a team routine and its recipe draw the same numbers. */
@@ -52,82 +52,6 @@ declare function countHits(channels: Channels, sampleRate: number, threshold: nu
 /** Peak of the last `seconds` of a file against its own peak, dB (≤ −40: it fades out, it does not end on a cut). */
 declare function endDropDb(channels: Channels, sampleRate: number, seconds?: number): number;
 
-/**
- * The manifest the converter (`scripts/sfx-convert.mjs`) writes next to the converted files: every sound id with its takes per layer, the file
- * facts the criteria check (rate, channels, peak, length) and where each file came from. `sampleBankFromManifest` turns it into a `SoundBank`
- * of `SampleSound`s, with the bus and the numbers of each sound given by the caller.
- */
-
-/** Licences the SDK accepts (the files are redistributed on npm): public domain or attribution only. */
-declare const SDK_LICENSES: readonly ["CC0", "CC-BY"];
-type SdkLicense = (typeof SDK_LICENSES)[number];
-type SfxFileEntry = {
-    /** Path from the manifest's folder: `armas/pistol_9mm_close_01.ogg`. */
-    readonly file: string;
-    readonly sampleRate: number;
-    readonly channels: number;
-    /** dBFS. */
-    readonly peak: number;
-    readonly seconds: number;
-    readonly source: string;
-    readonly author: string;
-    readonly license: SdkLicense;
-};
-/** The layers a file name can end in: `<id>_<layer>_<nn>` (`pistol_9mm_close_01`); a name without one is a `close` take. */
-declare const SFX_LAYERS: readonly ["close", "far", "tail_in", "tail_out"];
-type SfxLayer = (typeof SFX_LAYERS)[number];
-type SfxManifestSound = {
-    readonly id: string;
-    readonly category: string;
-    readonly layers: Partial<Readonly<Record<SfxLayer, readonly SfxFileEntry[]>>>;
-};
-type SfxManifest = {
-    readonly version: 1;
-    readonly format: {
-        readonly codec: 'vorbis';
-        readonly sampleRate: number;
-        readonly channels: number;
-        readonly peakDb: number;
-    };
-    readonly sounds: readonly SfxManifestSound[];
-};
-/** The numbers of one sound that the files do not say (bus, curve, pitch...). */
-type SampleDefaults = {
-    readonly bus: BusId;
-    readonly gain?: number;
-    readonly pitch?: number;
-    readonly crossover?: SampleCrossover;
-    readonly tailGain?: number;
-    readonly falloff?: Falloff;
-    readonly cutoffK?: number;
-    readonly group?: string;
-    readonly priority?: number;
-    readonly fallback?: string;
-};
-type SampleBankOptions = {
-    readonly id: string;
-    /** Prefix of every url (where the manifest's folder is served: `/sfx/`). Default ''. */
-    readonly baseUrl?: string;
-    /** Numbers per sound id, or one function; a sound with neither is left out (it has no bus). */
-    readonly sounds?: Readonly<Record<string, SampleDefaults>>;
-    readonly defaults?: (sound: SfxManifestSound) => SampleDefaults | undefined;
-};
-/** The strength suffixes of a sound id (`kick_hit_heavy`): takes of the tiers of `kick_hit`, from these intensities. */
-declare const SFX_TIERS: Readonly<Record<string, number>>;
-/** Splits a file name (no extension) into its sound id, layer and take number. */
-declare function parseSfxName(name: string): {
-    readonly id: string;
-    readonly layer: SfxLayer;
-    readonly take: number;
-};
-/** The base id and tier of a sound id: `kick_hit_heavy` → `kick_hit`, `heavy`. */
-declare function splitTier(id: string): {
-    readonly base: string;
-    readonly tier?: string;
-};
-/** A bank of sample sounds from a manifest. */
-declare function sampleBankFromManifest(manifest: SfxManifest, options: SampleBankOptions): SoundBank;
-
 /** The bus of a manifest category (the folder the file sits in). */
 declare const KIT_CATEGORY_BUS: Readonly<Record<string, BusId>>;
 /**
@@ -136,7 +60,10 @@ declare const KIT_CATEGORY_BUS: Readonly<Record<string, BusId>>;
  */
 declare const KIT_SAMPLE_ALIASES: Readonly<Record<string, string>>;
 /** The numbers of a sound the files do not say: the bus of its folder, a little pitch spread. */
-declare function kitSampleDefaults(sound: SfxManifestSound): SampleDefaults | undefined;
+declare function kitSampleDefaults(sound: {
+    readonly id: string;
+    readonly category: string;
+}): SampleDefaults | undefined;
 type KitSampleBankOptions = {
     /** Where the `assets/sfx/` folder is served (`./sfx/`). */
     readonly baseUrl?: string;
@@ -326,6 +253,9 @@ declare const LIBRARY_SOUNDS: readonly SoundRecipe[];
 declare const LIBRARY_LOOPS: readonly LoopRecipe[];
 declare const LIBRARY_BANK: SoundBank;
 
+declare const CABIN_SOUNDS: readonly SoundRecipe[];
+declare const CABIN_BANK: SoundBank;
+
 /** Small sounds of the hand: `vol / (1 + d² × 0.02)`, lowpass cutoffs `/ (1 + d × 0.04)`, silent below 0.004 (a latch at 10 m is a third, at 50 m gone). */
 declare const FOLEY_FALLOFF: Falloff;
 /** The doors and lids of furniture and vehicles, by what the leaf is (the room picks one from the item, else from the leaf's material). */
@@ -479,4 +409,4 @@ type EngineSink = AudioSink & {
 /** Lends an engine as the host's `audio`: sounds by key, loops, the listener, and banks registered into the same engine. */
 declare function createAudioSink(engine: AudioEngine): EngineSink;
 
-export { AudioEngine, AudioLoopHandle, BODY_FALLOFF, BODY_FOLEY_BANK, BODY_FOLEY_SET_IDS, BODY_FOLEY_TAKES, BusId, CALIBRATION_ID, CALIBRATION_LOOP_ID, CALIBRATION_LOOP_SOUND, CALIBRATION_SOUND, CROSSFADE_STEPS, DEFAULT_LOOP_CROSSFADE, DISTANCE_CURVES, type DistanceCurveName, type EngineSink, FOLEY_BANK, FOLEY_FALLOFF, FOOTSTEP_FALLOFF, Falloff, GAME_SFX_BANK, GAME_SFX_CLASSES, GAME_SFX_FALLBACK, ITEM_FOLEY, KIT_CATEGORY_BUS, KIT_SAMPLE_ALIASES, type KitSampleBankOptions, LEAF_FOLEY, LEAF_FOLEY_SETS, LIBRARY_BANK, LIBRARY_LOOPS, LIBRARY_SOUNDS, LOOP_SMOOTHING, LOOP_START_ABOVE, Layer, type LeafFoley, type LoadKitSamplesOptions, type LoopAction, LoopRecipe, type LoopState, type MixChain, MixProfile, type NoiseClass, PICKUP_CLASSES, ParamRef, type PickupClass, Range, type RealizeTarget, type RealizedSampleVoice, type RealizedVoice, SDK_LICENSES, SFX_LAYERS, SFX_TIERS, type SampleBankOptions, SampleCrossover, type SampleDefaults, SampleLoader, type SampleLoopHost, SamplePlan, SampleSound, type SampleTarget, type SceneLength, type SceneNoise, type SceneRecipeOptions, type SceneTone, type SceneVoice, type SdkLicense, type SetPicker, type SfxFileEntry, type SfxLayer, type SfxManifest, type SfxManifestSound, SoundBank, SoundPlan, SoundRecipe, SoundSet, balanceOf, bufferOf, buildChain, calibrationLoader, centroidHz, countHits, createAudioSink, createLoopState, createRng, createSetPicker, cutoffDivisor, dbOf, drawBetween, encodeWav, endDropDb, equalPowerIn, falloffGain, fillImpulse, fillNoise, globalContext, isCalibrationUrl, isSilent, kitSampleBank, kitSampleDefaults, loadKitSamples, loopCrossfade, noiseClassRecipe, onsetIndex, parseSfxName, peakIndex, peakOf, realize, realizeSample, retunePlan, ringSeconds, rmsDb, sampleBankFromManifest, sampleLength, sceneMany, sceneNoise, sceneRecipe, sceneTone, sceneVoice, splitTier, streamFor, streamSeed, unlockContext, withAliases };
+export { AudioEngine, AudioLoopHandle, BODY_FALLOFF, BODY_FOLEY_BANK, BODY_FOLEY_SET_IDS, BODY_FOLEY_TAKES, BusId, CABIN_BANK, CABIN_SOUNDS, CALIBRATION_ID, CALIBRATION_LOOP_ID, CALIBRATION_LOOP_SOUND, CALIBRATION_SOUND, CROSSFADE_STEPS, DEFAULT_LOOP_CROSSFADE, DISTANCE_CURVES, type DistanceCurveName, type EngineSink, FOLEY_BANK, FOLEY_FALLOFF, FOOTSTEP_FALLOFF, Falloff, GAME_SFX_BANK, GAME_SFX_CLASSES, GAME_SFX_FALLBACK, ITEM_FOLEY, KIT_CATEGORY_BUS, KIT_SAMPLE_ALIASES, type KitSampleBankOptions, LEAF_FOLEY, LEAF_FOLEY_SETS, LIBRARY_BANK, LIBRARY_LOOPS, LIBRARY_SOUNDS, LOOP_SMOOTHING, LOOP_START_ABOVE, Layer, type LeafFoley, type LoadKitSamplesOptions, type LoopAction, LoopRecipe, type LoopState, type MixChain, MixProfile, type NoiseClass, PICKUP_CLASSES, ParamRef, type PickupClass, Range, type RealizeTarget, type RealizedSampleVoice, type RealizedVoice, SampleDefaults, SampleLoader, type SampleLoopHost, SamplePlan, SampleSound, type SampleTarget, type SceneLength, type SceneNoise, type SceneRecipeOptions, type SceneTone, type SceneVoice, type SetPicker, SfxManifest, SoundBank, SoundPlan, SoundRecipe, SoundSet, balanceOf, bufferOf, buildChain, calibrationLoader, centroidHz, countHits, createAudioSink, createLoopState, createRng, createSetPicker, cutoffDivisor, dbOf, drawBetween, encodeWav, endDropDb, equalPowerIn, falloffGain, fillImpulse, fillNoise, globalContext, isCalibrationUrl, isSilent, kitSampleBank, kitSampleDefaults, loadKitSamples, loopCrossfade, noiseClassRecipe, onsetIndex, peakIndex, peakOf, realize, realizeSample, retunePlan, ringSeconds, rmsDb, sampleLength, sceneMany, sceneNoise, sceneRecipe, sceneTone, sceneVoice, streamFor, streamSeed, unlockContext, withAliases };

package/dist/index.global.js

@@ -29,6 +29,8 @@ var GameAudio = (() => {
     BUILD_ORDERS: () => BUILD_ORDERS,
     BUS_IDS: () => BUS_IDS,
     BUS_PRIORITY: () => BUS_PRIORITY,
+    CABIN_BANK: () => CABIN_BANK,
+    CABIN_SOUNDS: () => CABIN_SOUNDS,
     CALIBRATION_ID: () => CALIBRATION_ID,
     CALIBRATION_LOOP_ID: () => CALIBRATION_LOOP_ID,
     CALIBRATION_LOOP_SOUND: () => CALIBRATION_LOOP_SOUND,
@@ -54,6 +56,7 @@ var GameAudio = (() => {
     GAME_SFX_FALLBACK: () => GAME_SFX_FALLBACK,
     ITEM_FOLEY: () => ITEM_FOLEY,
     KIT_CATEGORY_BUS: () => KIT_CATEGORY_BUS,
+    KIT_SAMPLES_BANK: () => KIT_SAMPLES_BANK,
     KIT_SAMPLE_ALIASES: () => KIT_SAMPLE_ALIASES,
     LAYER_FLOOR: () => LAYER_FLOOR,
     LEAF_FOLEY: () => LEAF_FOLEY,
@@ -77,6 +80,8 @@ var GameAudio = (() => {
     SFX_LAYERS: () => SFX_LAYERS,
     SFX_MATERIALS: () => SFX_MATERIALS,
     SFX_TIERS: () => SFX_TIERS,
+    USER_SAMPLES_BANK: () => USER_SAMPLES_BANK,
+    USER_SOUND_PREFIX: () => USER_SOUND_PREFIX,
     VOICE_GROUPS: () => VOICE_GROUPS,
     audioBenchTextOf: () => audioBenchTextOf,
     balanceOf: () => balanceOf,
@@ -118,6 +123,7 @@ var GameAudio = (() => {
     limiterCurve: () => limiterCurve2,
     listenerDistance: () => listenerDistance,
     loadKitSamples: () => loadKitSamples,
+    loadUserSamples: () => loadUserSamples,
     loopCrossfade: () => loopCrossfade,
     measureCriteria: () => measureCriteria,
     noiseClassRecipe: () => noiseClassRecipe,
@@ -146,11 +152,13 @@ var GameAudio = (() => {
     sceneTone: () => sceneTone,
     sceneVoice: () => sceneVoice,
     sfxState: () => sfxState,
+    soundSourceOf: () => soundSourceOf,
     splitTier: () => splitTier,
     streamFor: () => streamFor,
     streamSeed: () => streamSeed,
     tierFor: () => tierFor,
     unlockContext: () => unlockContext,
+    userSampleBank: () => userSampleBank,
     withAliases: () => withAliases
   });
 
@@ -1375,6 +1383,7 @@ var GameAudio = (() => {
   }
 
   // ../game-contracts/dist/index.js
+  var DEFAULT_BLAST_IMPULSE = { bodyArea: 0.7, lift: 0.15, minSpeed: 0.3, tntPerJoule: 0.24 / 2e5 };
   var DEFAULT_COST_ALLOCATION_BYTES = 1024 * 1024;
   var DEFERRED_QUEUE_ID = {
     DESTRUCTION_EVENTS: "destruction.events",
@@ -2213,10 +2222,12 @@ var GameAudio = (() => {
         noise: () => noiseBuffer(store, audio, mix.noise.seconds),
         time
       });
+      const recipeBank = registry.bankOf(plan.id);
       announce({
         id: plan.id,
         kind: "recipe",
         ...fallbackOf ? { fallbackOf } : {},
+        ...recipeBank ? { bank: recipeBank } : {},
         requestedAt,
         startAt: time,
         outputLatency: latencyOf(audio),
@@ -2318,9 +2329,11 @@ var GameAudio = (() => {
       const time = requestedAt + (playOptions.delay ?? 0);
       const chokeList = sample.choke ? choked(sample.id) : void 0;
       const realized = realizeSample(plan, { context: audio, output: sampleOutput(plan.bus), buffer: (url2) => sampleStore.buffer(url2), time });
+      const sampleBank = registry.bankOf(plan.id);
       announce({
         id: plan.id,
         kind: "sample",
+        ...sampleBank ? { bank: sampleBank } : {},
         requestedAt,
         startAt: time,
         outputLatency: latencyOf(audio),
@@ -3009,7 +3022,11 @@ var GameAudio = (() => {
       ["casing_drop_terra_pistol", 1],
       ["casing_drop_terra_rifle", 1],
       ["casing_drop_terra_shell", 1],
-      ["rocket_fire", 2]
+      ["rocket_fire", 2],
+      ["smg_45_auto", 2, "sfx_pistol"],
+      ["weapon_draw", 2],
+      ["suppressor_attach", 3],
+      ["suppressor_detach", 3]
     ]),
     ...entries("explosoes-fogo", [
       ["explosion_grenade", 1, "boom"],
@@ -3023,7 +3040,11 @@ var GameAudio = (() => {
       ["fire_loop_large", 1],
       ["fire_extinguish", 2, "hiss"],
       ["gas_leak_hiss", 2],
-      ["structure_collapse", 2, "crumble"]
+      ["structure_collapse", 2, "crumble"],
+      ["grenade_bounce", 1],
+      ["c4_plant", 2],
+      ["c4_beep", 2],
+      ["c4_disarm", 2]
     ]),
     ...entries("personagem", [
       ["footstep_concrete_walk", 1, "sfx_step"],
@@ -3039,7 +3060,19 @@ var GameAudio = (() => {
       ["blunt_hit", 1],
       ["bite", 1, "sfx_flesh"],
       ["body_fall", 1],
-      ["player_hurt", 2]
+      ["player_hurt", 2],
+      ["footstep_tile_walk", 1, "sfx_step"],
+      ["footstep_water_walk", 1, "sfx_step"],
+      ["footstep_grate_walk", 2, "sfx_step"],
+      ["footstep_duct_walk", 3, "sfx_step"],
+      ["ladder_climb", 2],
+      ["swim", 2],
+      ["zombie_groan", 1],
+      ["zombie_alert", 1],
+      ["zombie_attack", 1],
+      ["zombie_pain", 1],
+      ["zombie_claw_hit", 1, "sfx_flesh"],
+      ["zombie_claw_miss", 2]
     ]),
     ...entries("veiculos", [
       ["engine_loop_car", 1],
@@ -3067,7 +3100,8 @@ var GameAudio = (() => {
       ["wind_loop", 2],
       ["thunder_near", 2],
       ["thunder_far", 2],
-      ["water_splash", 2]
+      ["water_splash", 2],
+      ["helicopter_loop", 3]
     ])
   ];
   var SFX_MATERIALS = [
@@ -3246,6 +3280,59 @@ var GameAudio = (() => {
     return bank;
   }
 
+  // src/user-samples.ts
+  var USER_SAMPLES_BANK = "user_samples";
+  var KIT_SAMPLES_BANK = "kit_samples";
+  var USER_SOUND_PREFIX = "user:";
+  function soundSourceOf(event) {
+    if (event.kind === "recipe") return "synth";
+    return event.bank === USER_SAMPLES_BANK ? "user" : "sdk";
+  }
+  function userSampleBank(manifest, options = {}) {
+    const playing = [];
+    const behindKit = [];
+    const sounds = [];
+    for (const picked of manifest.sounds) {
+      const sound = { ...picked, id: splitTier(picked.id).base };
+      sounds.push({ ...sound, id: `${USER_SOUND_PREFIX}${sound.id}` });
+      if (sound.role === "fallback" && options.kitHas?.(sound.id)) {
+        behindKit.push(sound.id);
+        continue;
+      }
+      sounds.push(sound);
+      playing.push(sound.id);
+    }
+    const bank = sampleBankFromManifest(
+      { sounds },
+      {
+        id: USER_SAMPLES_BANK,
+        baseUrl: options.baseUrl ?? "",
+        defaults: (sound) => kitSampleDefaults({ id: sound.id.replace(USER_SOUND_PREFIX, ""), category: sound.category })
+      }
+    );
+    return { bank, playing, behindKit };
+  }
+  var fetchManifestJson = async (url2) => {
+    const page = globalThis.location?.href;
+    if (new URL(url2, page ?? "http://localhost/").protocol === "file:") throw new Error(`${url2}: file:// is not fetched`);
+    const response = await fetch(url2);
+    if (!response.ok) throw new Error(`${url2}: ${response.status}`);
+    return await response.json();
+  };
+  async function loadUserSamples(engine, options = {}) {
+    const baseUrl = options.baseUrl ?? "./sfx-local/";
+    let manifest;
+    try {
+      manifest = await (options.fetchManifest ?? fetchManifestJson)(`${baseUrl}manifest.json`);
+    } catch {
+      return null;
+    }
+    const kitHas = options.kitHas ?? ((id) => Boolean(engine.registry?.sample(id)));
+    const result = userSampleBank(manifest, { baseUrl, kitHas });
+    engine.register(result.bank);
+    return result;
+  }
+
   // src/data/game-sfx.json
   var game_sfx_default = {
     sources: ["jogo:L62089-62107"],
@@ -3473,6 +3560,82 @@ var GameAudio = (() => {
   var LIBRARY_LOOPS = [engine_saw_default, rotor_blades_default, crowd_rumble_default];
   var LIBRARY_BANK = { id: "library", sounds: LIBRARY_SOUNDS, loops: LIBRARY_LOOPS };
 
+  // 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",