@adatechnology/game-audio 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-import { S as SampleSound, a as SampleLoader, B as BusId, b as SfxManifest, c as SoundBank, d as SampleDefaults, A as AudioEngine, 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, j as AudioLoopHandle, k as LoopEntry, l as Listener, D as DistanceMode, M as MixProfile } from './locale-BJMhMT0G.js';
-export { m as ActionCheck, n as AudioBenchText, o as AudioChannel, p as AudioEngineOptions, q as AudioScenarioLike, r as AudioStats, s as AudioTestModule, t as AudioTestModuleOptions, u as Automation, v as BENCH_BANK, w as BUILD_ORDERS, x as BUS_IDS, y as BUS_PRIORITY, z as BuildOrder, C as BusSetting, E as CRITERIA, G as CRITERIA_TARGETS, H as CriterionId, I as CriterionResult, J as Curve, K as DEFAULT_CROSSOVER, N as DEFAULT_LISTENER, O as DEFAULT_MAX_VOICES, Q as DEFAULT_MIX, T as DEFAULT_SAMPLE_CUTOFF_K, U as DEFAULT_SAMPLE_FALLOFF, V as DEFAULT_SAMPLE_PITCH, W as DEFAULT_TAIL_GAIN, X as DeepPartial, Y as Envelope, Z as EnvelopePoint, _ as FilterBank, $ as FilterSpec, a0 as FormantVoiceSource, a1 as KIT_SAMPLES_BANK, a2 as LAYER_FLOOR, a3 as LayerSource, 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 SampleAlias, ay as SampleBankOptions, az as SampleCrossover, aA as SampleEnvironment, aB as SampleLayerRole, aC as SampleLoadReport, aD as SampleMemory, aE as SampleOptions, aF as SamplePlanInput, aG as SampleRef, aH as SampleStatus, aI as SampleStore, aJ as SampleTail, aK as SampleTier, aL as SdkLicense, aM as SfxBlow, aN as SfxCategory, aO as SfxEntry, aP as SfxFileEntry, aQ as SfxLayer, aR as SfxManifestLike, aS as SfxManifestSound, aT as SfxMaterial, aU as SfxPriority, aV as SfxState, aW as SoundRegistry, aX as SoundSource, aY as StartQueueOptions, aZ as Time, a_ as USER_SAMPLES_BANK, a$ as USER_SOUND_PREFIX, b0 as UserSampleBankOptions, b1 as UserSampleBankResult, b2 as UserSfxFile, b3 as UserSfxManifest, b4 as UserSfxSound, b5 as UserSoundPick, b6 as UserSoundPicks, b7 as UserSoundRole, b8 as VOICE_GROUPS, b9 as VoiceDecision, ba as VoiceGroup, bb as VoiceHandle, bc as VoiceManager, bd as VoiceManagerOptions, be as VoiceRefusal, bf as VoiceRequest, bg as VoiceStartEvent, bh as VoiceStats, bi as aliasSample, bj as audioBenchTextOf, bk as busGain, bl as busPriority, bm as createAudioEngine, bn as createAudioTestModule, bo as createSampleStore, bp as createSoundRegistry, bq as createVoiceManager, br as crossGains, bs as farMixAt, bt as fetchLoader, bu as impactSoundId, bv as inlineLoader, bw as limiterCurve, bx as listenerDistance, by as loadUserSamples, bz as measureCriteria, bA as panFor, bB as parseSfxName, bC as pickTake, bD as planSample, bE as planSound, bF as recordOutput, bG as resolveMix, bH as sampleBankFromManifest, bI as sampleCutoff, bJ as sampleUrls, bK as sfxState, bL as soundSourceOf, bM as splitTier, bN as tierFor, bO as userSampleBank } from './locale-BJMhMT0G.js';
+import { c as SampleSound, B as BusId, a as SoundBank, F as Falloff, L as LoopRecipe, b as SoundRecipe, P as ParamRef, R as Range, d as Layer, e as SoundSet } from './bank-Dsj1VAht.js';
+export { A as Automation, f as BUILD_ORDERS, g as BUS_IDS, h as BuildOrder, C as Curve, D as DeepPartial, E as Envelope, i as EnvelopePoint, j as FilterBank, k as FilterSpec, l as FormantVoiceSource, m as LayerSource, n as LoopOrder, M as Modulator, N as NoiseSource, O as OscSource, o as SampleAlias, p as SampleCrossover, q as SampleEnvironment, r as SampleRef, s as SampleTail, t as SampleTier, S as SoundRegistry, T as Time, u as aliasSample, v as createSoundRegistry } from './bank-Dsj1VAht.js';
+import { S as SampleLoader, a as SfxManifest, b as SampleDefaults, A as AudioEngine, c as SoundPlan, d as SamplePlan, e as AudioLoopHandle, L as LoopEntry, f as Listener, D as DistanceMode, M as MixProfile } from './locale-YHyJwN2P.js';
+export { g as ActionCheck, h as AudioBenchText, i as AudioChannel, j as AudioEngineOptions, k as AudioScenarioLike, l as AudioStats, m as AudioTestModule, n as AudioTestModuleOptions, B as BENCH_BANK, o as BUS_PRIORITY, p as BusSetting, C as CRITERIA, q as CRITERIA_TARGETS, r as CriterionId, s as CriterionResult, t as DEFAULT_CROSSOVER, u as DEFAULT_LISTENER, v as DEFAULT_MAX_VOICES, w as DEFAULT_MIX, x as DEFAULT_SAMPLE_CUTOFF_K, y as DEFAULT_SAMPLE_FALLOFF, z as DEFAULT_SAMPLE_PITCH, E as DEFAULT_TAIL_GAIN, K as KIT_SAMPLES_BANK, F as LAYER_FLOOR, G as LoadUserSamplesOptions, H as LoopSet, I as MIX_PROFILES, J as MeasureOptions, O as OPEN_CUTOFF, P as PAN_LIMIT, N as PAN_MIN_DISTANCE, Q as PlanInput, R as PlannedAutomation, T as PlannedEnvelopePoint, U as PlannedFilter, V as PlannedLayer, W as PlannedModulator, X as PlannedSampleLayer, Y as PlannedSource, Z as PlayOptions, _ as SAMPLE_ENVIRONMENTS, $ as SDK_LICENSES, a0 as SFX_BLOWS, a1 as SFX_CATALOG, a2 as SFX_CATEGORIES, a3 as SFX_IMPACTS, a4 as SFX_LAYERS, a5 as SFX_MATERIALS, a6 as SFX_TIERS, a7 as SampleBankOptions, a8 as SampleLayerRole, a9 as SampleLoadReport, aa as SampleMemory, ab as SampleOptions, ac as SamplePlanInput, ad as SampleStatus, ae as SampleStore, af as SdkLicense, ag as SfxBlow, ah as SfxCategory, ai as SfxEntry, aj as SfxFileEntry, ak as SfxLayer, al as SfxManifestLike, am as SfxManifestSound, an as SfxMaterial, ao as SfxPriority, ap as SfxState, aq as SoundSource, ar as StartQueueOptions, as as USER_SAMPLES_BANK, at as USER_SOUND_PREFIX, au as UserSampleBankOptions, av as UserSampleBankResult, aw as UserSfxFile, ax as UserSfxManifest, ay as UserSfxSound, az as UserSoundPick, aA as UserSoundPicks, aB as UserSoundRole, aC as VOICE_GROUPS, aD as VoiceDecision, aE as VoiceGroup, aF as VoiceHandle, aG as VoiceManager, aH as VoiceManagerOptions, aI as VoiceRefusal, aJ as VoiceRequest, aK as VoiceStartEvent, aL as VoiceStats, aM as audioBenchTextOf, aN as busGain, aO as busPriority, aP as createAudioEngine, aQ as createAudioTestModule, aR as createSampleStore, aS as createVoiceManager, aT as crossGains, aU as farMixAt, aV as fetchLoader, aW as impactSoundId, aX as inlineLoader, aY as limiterCurve, aZ as listenerDistance, a_ as loadUserSamples, a$ as measureCriteria, b0 as panFor, b1 as parseSfxName, b2 as pickTake, b3 as planSample, b4 as planSound, b5 as recordOutput, b6 as resolveMix, b7 as sampleBankFromManifest, b8 as sampleCutoff, b9 as sampleUrls, ba as sfxState, bb as soundSourceOf, bc as splitTier, bd as tierFor, be as userSampleBank } from './locale-YHyJwN2P.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. */
@@ -90,6 +92,29 @@ type Registers = {
  * `file://`, the folder not served): the recipes keep playing, so that is not an error.
  */
 declare function loadKitSamples(engine: Registers, options?: LoadKitSamplesOptions): Promise<SoundBank | null>;
+/** A game's own files, by sound id: one url or several takes (relative to `baseUrl`). */
+type SampleFiles = Readonly<Record<string, string | readonly string[]>>;
+type PointSamplesOptions = {
+    /** Put before every url (the game's folder, `./sfx/` say). */
+    readonly baseUrl?: string;
+    /** The bank id (default `game_samples`). */
+    readonly id?: string;
+    /** Bus of an id the kit has no sound for (default `world`). */
+    readonly bus?: BusId;
+};
+type PointsSamples = {
+    register(bank: SoundBank): void;
+    readonly registry: {
+        sample(id: string): SampleSound | undefined;
+    };
+};
+/**
+ * Points sound ids at a game's own files: each id keeps the kit's numbers (bus, level, pitch spread, falloff, choke) and plays the game's takes in
+ * place of the kit's (its far takes, tiers and room tails included, since they are the kit's files); an id the kit has no sound for is added on
+ * `bus`. Call it after the kit's bank (`loadKitSamples`): a later bank wins, so the rest of the kit's sounds stay. For a whole folder laid out like
+ * the kit's (`<categoria>/<nome>.ogg` and a `manifest.json`), `loadKitSamples(engine, { baseUrl: '<folder>/', id: 'game_samples' })` does the same.
+ */
+declare function pointSamples(engine: PointsSamples, files: SampleFiles, options?: PointSamplesOptions): SoundBank;
 
 declare const LOCAL_PACK_LICENSES: readonly ["CC0", "CC-BY", "unknown", "proprietary"];
 type LocalPackLicense = (typeof LOCAL_PACK_LICENSES)[number];
@@ -519,4 +544,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 { type ApplyLocalSoundPackOptions, 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, DistanceMode, type EngineSink, FOLEY_BANK, FOLEY_FALLOFF, FOOTSTEP_FALLOFF, Falloff, GAME_SFX_BANK, GAME_SFX_CLASSES, GAME_SFX_FALLBACK, ITEM_FOLEY, type IdleScheduler, KIT_CATEGORY_BUS, KIT_SAMPLE_ALIASES, type KitSampleBankOptions, LEAF_FOLEY, LEAF_FOLEY_SETS, LIBRARY_BANK, LIBRARY_LOOPS, LIBRARY_SOUNDS, LOCAL_PACK_BANK_ID, LOCAL_PACK_LICENSES, LOCAL_PACK_PREFERENCES, LOOP_SMOOTHING, LOOP_START_ABOVE, Layer, type LeafFoley, Listener, type LoadKitSamplesOptions, type LocalPackHandle, type LocalPackLicense, type LocalPackPreference, type LocalPackReport, type LocalPackSampleOptions, type LocalPackStatus, type LocalSoundEntry, type LocalSoundPack, LocalSoundPackError, type LoopAction, LoopRecipe, type LoopState, type MixChain, MixProfile, type NoiseClass, PICKUP_CLASSES, ParamRef, type PickupClass, RADIO_BANK, RADIO_TRACKS, type RadioSong, 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, TRIM_FADE, applyLocalSoundPack, balanceOf, bufferOf, buildChain, calibrationLoader, centroidHz, countHits, createAudioSink, createLoopState, createRng, createSetPicker, cutoffDivisor, dbOf, defaultIdleScheduler, drawBetween, encodeWav, endDropDb, equalPowerIn, falloffGain, fillImpulse, fillNoise, globalContext, isCalibrationUrl, isShippableLicense, isSilent, kitSampleBank, kitSampleDefaults, loadKitSamples, localPackSamples, loopCrossfade, loopRate, noiseClassRecipe, onsetIndex, parseLocalSoundPack, peakIndex, peakOf, radioTrack, realize, realizeSample, retunePlan, ringSeconds, rmsDb, sampleLength, sceneMany, sceneNoise, sceneRecipe, sceneTone, sceneVoice, streamFor, streamSeed, unlockContext, withAliases };
+export { type ApplyLocalSoundPackOptions, 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, DistanceMode, type EngineSink, FOLEY_BANK, FOLEY_FALLOFF, FOOTSTEP_FALLOFF, Falloff, GAME_SFX_BANK, GAME_SFX_CLASSES, GAME_SFX_FALLBACK, ITEM_FOLEY, type IdleScheduler, KIT_CATEGORY_BUS, KIT_SAMPLE_ALIASES, type KitSampleBankOptions, LEAF_FOLEY, LEAF_FOLEY_SETS, LIBRARY_BANK, LIBRARY_LOOPS, LIBRARY_SOUNDS, LOCAL_PACK_BANK_ID, LOCAL_PACK_LICENSES, LOCAL_PACK_PREFERENCES, LOOP_SMOOTHING, LOOP_START_ABOVE, Layer, type LeafFoley, Listener, type LoadKitSamplesOptions, type LocalPackHandle, type LocalPackLicense, type LocalPackPreference, type LocalPackReport, type LocalPackSampleOptions, type LocalPackStatus, type LocalSoundEntry, type LocalSoundPack, LocalSoundPackError, type LoopAction, LoopRecipe, type LoopState, type MixChain, MixProfile, type NoiseClass, PICKUP_CLASSES, ParamRef, type PickupClass, type PointSamplesOptions, RADIO_BANK, RADIO_TRACKS, type RadioSong, Range, type RealizeTarget, type RealizedSampleVoice, type RealizedVoice, SampleDefaults, type SampleFiles, SampleLoader, type SampleLoopHost, SamplePlan, SampleSound, type SampleTarget, type SceneLength, type SceneNoise, type SceneRecipeOptions, type SceneTone, type SceneVoice, type SetPicker, SfxManifest, SoundBank, SoundPlan, SoundRecipe, SoundSet, TRIM_FADE, applyLocalSoundPack, balanceOf, bufferOf, buildChain, calibrationLoader, centroidHz, countHits, createAudioSink, createLoopState, createRng, createSetPicker, cutoffDivisor, dbOf, defaultIdleScheduler, drawBetween, encodeWav, endDropDb, equalPowerIn, falloffGain, fillImpulse, fillNoise, globalContext, isCalibrationUrl, isShippableLicense, isSilent, kitSampleBank, kitSampleDefaults, loadKitSamples, localPackSamples, loopCrossfade, loopRate, noiseClassRecipe, onsetIndex, parseLocalSoundPack, peakIndex, peakOf, pointSamples, radioTrack, realize, realizeSample, retunePlan, ringSeconds, rmsDb, sampleLength, sceneMany, sceneNoise, sceneRecipe, sceneTone, sceneVoice, streamFor, streamSeed, unlockContext, withAliases };

package/dist/index.global.js

@@ -151,6 +151,7 @@ var GameAudio = (() => {
     pickTake: () => pickTake,
     planSample: () => planSample,
     planSound: () => planSound,
+    pointSamples: () => pointSamples,
     radioTrack: () => radioTrack,
     realize: () => realize,
     realizeSample: () => realizeSample,
@@ -286,6 +287,20 @@ var GameAudio = (() => {
       sources: [
         "sdk: the crackles of every fire share four voices"
       ]
+    },
+    debris_knock: {
+      maxConcurrent: 3,
+      cooldown: 0.04,
+      sources: [
+        "sdk: forty parts coming loose in one blast are a few knocks, not forty (room log: thunk x34 in under a second when a molotov broke)"
+      ]
+    },
+    sizzle: {
+      maxConcurrent: 1,
+      cooldown: 0.5,
+      sources: [
+        "sdk: every melting part of a burning bin is one sizzle at a time (room log: hiss x34 in 1.6 s on a plastic bin)"
+      ]
     }
   };
 
@@ -773,17 +788,19 @@ var GameAudio = (() => {
     }
     return merged;
   }
-  var trimmed = (refs, alias) => refs.map((ref) => ({
+  var trimmed = (refs, alias) => refs.filter((ref) => alias.only === void 0 || ref.url.includes(alias.only)).map((ref) => ({
     ...ref,
     ...alias.offset === void 0 ? {} : { offset: alias.offset },
     ...alias.duration === void 0 ? {} : { duration: alias.duration }
   }));
   function aliasSample(alias, file) {
+    const close = trimmed(file.close, alias);
+    if (close.length === 0) return void 0;
     const { tiers: _tiers, fallback: _fallback, choke: _choke, ...rest } = file;
     return {
       ...rest,
       id: alias.id,
-      close: trimmed(file.close, alias),
+      close,
       ...file.far ? { far: trimmed(file.far, alias) } : {},
       ...alias.loop === void 0 ? {} : { loop: alias.loop },
       ...alias.baseFrequency === void 0 ? {} : { baseFrequency: alias.baseFrequency },
@@ -810,7 +827,7 @@ var GameAudio = (() => {
       const file = samples.get(alias.file);
       if (!file) return void 0;
       const sample = aliasSample(alias, file);
-      derived.set(id, sample);
+      if (sample) derived.set(id, sample);
       return sample;
     };
     const registry = {
@@ -2413,6 +2430,7 @@ var GameAudio = (() => {
       const set = registry.set(id);
       return set ? chooser.pick(set, random) : { id, rate: 1 };
     };
+    const wanted = /* @__PURE__ */ new Set();
     const loadSounds = (sounds) => {
       const audio = ready();
       if (!audio) return Promise.resolve({ loaded: [], failed: sounds.flatMap(sampleUrls).map((url2) => ({ url: url2, error: "no audio context" })) });
@@ -2537,13 +2555,20 @@ var GameAudio = (() => {
     };
     return {
       registry,
-      register: (bank) => registry.register(bank),
+      register: (bank) => {
+        registry.register(bank);
+        if (wanted.size === 0) return;
+        const now = [...wanted].map((id) => registry.sample(id)).filter((sample) => sample !== void 0);
+        for (const sample of now) wanted.delete(sample.id);
+        if (now.length > 0) void loadSounds(now).catch(() => void 0);
+      },
       plan: (id, playOptions = {}) => planWith(id, playOptions, createRng(playOptions.seed ?? seed)),
       planSample(id, playOptions = {}) {
         const sample = registry.sample(id);
         return sample ? planSample(sample, sampleInput(playOptions, createRng(playOptions.seed ?? seed), false)) : null;
       },
       loadSamples(ids) {
+        for (const id of ids ?? []) if (!registry.sample(id)) wanted.add(id);
         const chosen = (ids ?? registry.sampleIds()).map((id) => registry.sample(id)).filter((sample) => sample !== void 0);
         return loadSounds(chosen);
       },
@@ -3471,6 +3496,20 @@ var GameAudio = (() => {
     if (options.preload && engine.loadSamples) void engine.loadSamples(options.preload).catch(() => void 0);
     return bank;
   }
+  function pointSamples(engine, files, options = {}) {
+    const baseUrl = options.baseUrl ?? "";
+    const samples = Object.entries(files).map(([id, urls]) => {
+      const close = (typeof urls === "string" ? [urls] : [...urls]).map((url2) => ({ url: `${baseUrl}${url2}` }));
+      if (close.length === 0) throw new Error(`pointSamples: ${id} has no file`);
+      const kit = engine.registry.sample(id);
+      if (!kit) return { id, bus: options.bus ?? "world", close, sources: ["game: pointSamples"] };
+      const { far: _far, tiers: _tiers, tail: _tail, ...numbers } = kit;
+      return { ...numbers, close };
+    });
+    const bank = { id: options.id ?? "game_samples", samples };
+    engine.register(bank);
+    return bank;
+  }
 
   // src/user-samples.ts
   var USER_SAMPLES_BANK = "user_samples";
@@ -3971,6 +4010,66 @@ var GameAudio = (() => {
       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: [] };
@@ -4846,6 +4945,9 @@ var GameAudio = (() => {
       },
       register(bank) {
         engine.register(bank);
+      },
+      preload(sounds) {
+        void engine.loadSamples(sounds).catch(() => void 0);
       }
     };
   }