@adatechnology/game-audio 0.4.0 → 0.5.0

package/dist/index.js

@@ -3,52 +3,241 @@ import {
   BUILD_ORDERS,
   BUS_IDS,
   BUS_PRIORITY,
+  CALIBRATION_ID,
+  CALIBRATION_LOOP_ID,
+  CALIBRATION_LOOP_SOUND,
+  CALIBRATION_SOUND,
+  CRITERIA,
+  CRITERIA_TARGETS,
+  CROSSFADE_STEPS,
+  DEFAULT_CROSSOVER,
   DEFAULT_LISTENER,
+  DEFAULT_LOOP_CROSSFADE,
   DEFAULT_MAX_VOICES,
   DEFAULT_MIX,
+  DEFAULT_SAMPLE_CUTOFF_K,
+  DEFAULT_SAMPLE_FALLOFF,
+  DEFAULT_SAMPLE_PITCH,
+  DEFAULT_TAIL_GAIN,
   DISTANCE_CURVES,
   GAME_SFX_BANK,
   GAME_SFX_CLASSES,
   GAME_SFX_FALLBACK,
+  LAYER_FLOOR,
   LIBRARY_BANK,
   LIBRARY_LOOPS,
   LIBRARY_SOUNDS,
   LOOP_SMOOTHING,
   LOOP_START_ABOVE,
   MIX_PROFILES,
+  OPEN_CUTOFF,
   PAN_LIMIT,
   PAN_MIN_DISTANCE,
+  SAMPLE_ENVIRONMENTS,
+  SFX_BLOWS,
+  SFX_CATALOG,
+  SFX_CATEGORIES,
+  SFX_IMPACTS,
+  SFX_MATERIALS,
   VOICE_GROUPS,
   audioBenchTextOf,
+  balanceOf,
   bufferOf,
   buildChain,
   busGain,
   busPriority,
+  calibrationLoader,
+  centroidHz,
+  countHits,
   createAudioEngine,
   createAudioTestModule,
   createLoopState,
   createRng,
+  createSampleStore,
   createSetPicker,
   createSoundRegistry,
   createVoiceManager,
+  crossGains,
   cutoffDivisor,
+  dbOf,
   drawBetween,
+  encodeWav,
+  endDropDb,
+  equalPowerIn,
   falloffGain,
+  farMixAt,
+  fetchLoader,
   fillImpulse,
   fillNoise,
   globalContext,
+  impactSoundId,
+  inlineLoader,
+  isCalibrationUrl,
   isSilent,
+  limiterCurve,
   listenerDistance,
+  loopCrossfade,
+  measureCriteria,
   noiseClassRecipe,
+  onsetIndex,
   panFor,
+  peakIndex,
+  peakOf,
+  pickTake,
+  planSample,
   planSound,
   realize,
+  realizeSample,
+  recordOutput,
   resolveMix,
   retunePlan,
+  ringSeconds,
+  rmsDb,
+  sampleCutoff,
+  sampleLength,
+  sampleUrls,
+  sfxState,
   streamFor,
   streamSeed,
+  tierFor,
   unlockContext
-} from "./chunk-DZITVFMJ.js";
+} 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;
+}
 
 // src/recipes/scene.ts
 var ATTACK = 2e-3;
@@ -127,6 +316,602 @@ function sceneRecipe(id, layers, line, options = {}) {
   };
 }
 
+// src/recipes/foley.ts
+var FOLEY_FALLOFF = {
+  model: "inverse_square",
+  k: 0.02,
+  cutoffK: 0.04,
+  minGain: 4e-3
+};
+var vary = (f, pct = 0.04) => [Math.round(f * (1 - pct)), Math.round(f * (1 + pct))];
+var foley = (id, layers, note) => ({
+  id,
+  bus: "world",
+  pan: true,
+  layers,
+  falloff: FOLEY_FALLOFF,
+  sources: [`sdk: ${note}`]
+});
+var click = (f, vol, delay = 0) => [
+  sceneNoise({
+    type: "bandpass",
+    f: vary(f, 0.08),
+    q: 4,
+    d: [0.018, 0.03],
+    vol: [vol * 0.85, vol * 1.1],
+    delay
+  }),
+  sceneTone({
+    f: vary(f * 0.8, 0.06),
+    f2: Math.round(f * 0.62),
+    d: [0.015, 0.025],
+    vol: vol * 0.18,
+    delay
+  })
+];
+var meet = (body, panel, vol, latch) => [
+  sceneTone({
+    f: vary(body),
+    f2: Math.round(body * 0.5),
+    d: [0.12, 0.16],
+    vol: [vol * 0.9, vol * 1.1]
+  }),
+  sceneNoise({
+    type: "bandpass",
+    f: vary(panel, 0.06),
+    q: 1.2,
+    d: [0.08, 0.12],
+    vol: [vol * 0.9, vol * 1.1],
+    wet: 0.25
+  }),
+  ...click(latch, vol * 0.45, [0.012, 0.028])
+];
+var LEAF_FOLEY = [
+  // a wooden house door or wardrobe door: latch, a short creak, the leaf on the frame (the hard slam adds the frame rattling)
+  foley("door_wood_open", click(2400, 0.4), "the latch of a wooden door giving"),
+  foley(
+    "door_creak",
+    [
+      sceneTone({ f: [190, 240], f2: 310, d: [0.4, 0.55], vol: [0.04, 0.06] }),
+      sceneNoise({
+        type: "bandpass",
+        f: [480, 560],
+        q: 6,
+        a: 0.05,
+        d: [0.35, 0.5],
+        vol: [0.1, 0.14]
+      })
+    ],
+    "a wooden hinge turning"
+  ),
+  foley("door_wood_close", meet(120, 600, 0.55, 2400), "a wooden leaf meeting its frame"),
+  foley(
+    "door_wood_slam",
+    [
+      ...meet(110, 560, 0.85, 2300),
+      ...sceneMany(
+        3,
+        () => sceneNoise({
+          type: "bandpass",
+          f: [900, 1500],
+          q: 3,
+          d: 0.03,
+          vol: [0.08, 0.14],
+          delay: [0.05, 0.18]
+        })
+      )
+    ],
+    "a wooden door slammed: the frame and the hinges rattle after the hit"
+  ),
+  // a metal door or gate: a hollow panel that rings a little
+  foley("door_metal_open_close", [...meet(160, 900, 0.55, 2e3), sceneTone({ f: vary(1250), f2: 1150, d: [0.1, 0.16], vol: 0.06, wet: 0.3 })], "a metal door or gate meeting its frame"),
+  foley(
+    "door_creak_metal",
+    [
+      sceneTone({ f: [620, 760], f2: 900, d: [0.3, 0.4], vol: [0.03, 0.045] }),
+      sceneNoise({
+        type: "bandpass",
+        f: [1300, 1500],
+        q: 8,
+        a: 0.04,
+        d: [0.25, 0.35],
+        vol: [0.07, 0.09]
+      })
+    ],
+    "a metal hinge turning"
+  ),
+  // the handle of a locked door shaken: the latch knocking in its keeper, five to seven times in half a second
+  foley(
+    "door_locked_rattle",
+    [
+      ...sceneMany(
+        6,
+        () => sceneNoise({
+          type: "bandpass",
+          f: [1600, 2600],
+          q: 3,
+          d: [0.025, 0.04],
+          vol: [0.22, 0.34],
+          delay: [0, 0.45]
+        })
+      ),
+      ...sceneMany(
+        3,
+        () => sceneTone({
+          f: [170, 210],
+          f2: 120,
+          d: 0.05,
+          vol: [0.12, 0.18],
+          delay: [0.02, 0.4]
+        })
+      )
+    ],
+    "the handle of a locked door shaken: latch knocks and the leaf thumping in its frame"
+  ),
+  // a fridge: the rubber seal lets go with a soft suck, the bottles in the door clink; closing it is a soft thump and the seal pulling shut
+  foley(
+    "fridge_open",
+    [
+      sceneNoise({
+        type: "lowpass",
+        f: [320, 380],
+        a: 0.03,
+        d: [0.14, 0.2],
+        vol: [0.32, 0.4]
+      }),
+      sceneNoise({
+        type: "bandpass",
+        f: [800, 950],
+        f2: 1400,
+        q: 2,
+        a: 0.02,
+        d: 0.12,
+        vol: [0.08, 0.12]
+      }),
+      ...sceneMany(
+        2,
+        () => sceneTone({
+          f: [2600, 4200],
+          d: [0.04, 0.08],
+          vol: [0.015, 0.03],
+          delay: [0.08, 0.22]
+        })
+      )
+    ],
+    "a fridge door: the seal letting go and the bottles in the door"
+  ),
+  foley(
+    "fridge_close",
+    [
+      sceneTone({ f: vary(85), f2: 45, d: [0.1, 0.13], vol: [0.38, 0.46] }),
+      sceneNoise({
+        type: "lowpass",
+        f: [520, 620],
+        d: [0.08, 0.12],
+        vol: [0.3, 0.36]
+      }),
+      sceneNoise({
+        type: "lowpass",
+        f: [260, 320],
+        a: 0.02,
+        d: 0.1,
+        vol: [0.12, 0.18],
+        delay: [0.04, 0.07]
+      }),
+      ...sceneMany(
+        2,
+        () => sceneTone({
+          f: [2600, 4200],
+          d: [0.04, 0.07],
+          vol: [0.015, 0.03],
+          delay: [0.03, 0.12]
+        })
+      )
+    ],
+    "a fridge door shut: a soft thump, the seal pulling and the bottles"
+  ),
+  // a microwave: the spring catch of the door, plastic on plastic
+  foley(
+    "microwave_open",
+    [
+      ...click(1800, 0.34),
+      sceneTone({
+        f: [3e3, 3400],
+        f2: 2800,
+        d: 0.05,
+        vol: 0.025,
+        delay: [0.01, 0.02]
+      })
+    ],
+    "the spring catch of a microwave door"
+  ),
+  foley(
+    "microwave_close",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [1200, 1450],
+        q: 2.5,
+        d: [0.04, 0.06],
+        vol: [0.36, 0.44]
+      }),
+      sceneTone({ f: vary(180), f2: 120, d: 0.05, vol: [0.16, 0.22] }),
+      ...click(2200, 0.2, [8e-3, 0.016])
+    ],
+    "a microwave door clacking shut"
+  ),
+  foley("microwave_beep", [sceneTone({ wave: "square", f: 2e3, d: 0.12, vol: 0.05 })], "the beep of a microwave"),
+  // drawers and sliding leaves: the runners, then the stop
+  foley(
+    "drawer_open",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [620, 780],
+        q: 2,
+        a: 0.04,
+        d: [0.28, 0.36],
+        vol: [0.18, 0.24]
+      }),
+      sceneNoise({ type: "bandpass", f: [2e3, 2400], q: 5, d: 0.28, vol: 0.04 }),
+      ...click(1400, 0.16, [0.28, 0.34])
+    ],
+    "a drawer on its runners and its stop"
+  ),
+  foley(
+    "drawer_close",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [620, 780],
+        q: 2,
+        a: 0.03,
+        d: [0.2, 0.28],
+        vol: [0.18, 0.24]
+      }),
+      sceneTone({
+        f: vary(150),
+        f2: 90,
+        d: 0.08,
+        vol: [0.22, 0.3],
+        delay: [0.2, 0.26]
+      })
+    ],
+    "a drawer pushed home"
+  )
+];
+var ITEM_FOLEY = [
+  // the hand closing on the item: a touch of skin and cloth, then the item's own small sound
+  foley(
+    "item_pickup_metal",
+    [
+      sceneNoise({ type: "bandpass", f: [700, 900], q: 1, d: 0.06, vol: 0.18 }),
+      sceneTone({
+        f: [1900, 2600],
+        f2: 1700,
+        d: [0.05, 0.08],
+        vol: [0.06, 0.09],
+        delay: [0.01, 0.03]
+      })
+    ],
+    "picking up a metal thing"
+  ),
+  foley(
+    "item_pickup_plastic",
+    [
+      sceneNoise({ type: "bandpass", f: [700, 900], q: 1, d: 0.06, vol: 0.18 }),
+      sceneNoise({
+        type: "bandpass",
+        f: [1500, 1900],
+        q: 3,
+        d: 0.03,
+        vol: [0.15, 0.21],
+        delay: [0.01, 0.03]
+      })
+    ],
+    "picking up a plastic thing"
+  ),
+  foley(
+    "item_pickup_glass",
+    [
+      sceneNoise({ type: "bandpass", f: [700, 900], q: 1, d: 0.06, vol: 0.15 }),
+      sceneTone({
+        f: [3200, 4200],
+        d: [0.05, 0.08],
+        vol: [0.038, 0.06],
+        delay: [0.01, 0.03]
+      })
+    ],
+    "picking up a glass thing"
+  ),
+  foley(
+    "item_pickup_paper",
+    [
+      sceneNoise({
+        type: "highpass",
+        f: [2600, 3400],
+        a: 0.01,
+        d: [0.1, 0.14],
+        vol: [0.12, 0.18]
+      }),
+      sceneNoise({ type: "bandpass", f: [800, 1e3], q: 1, d: 0.05, vol: 0.12 })
+    ],
+    "picking up paper or cardboard"
+  ),
+  foley(
+    "item_pickup_fabric",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [900, 1300],
+        q: 0.8,
+        a: 0.02,
+        d: [0.12, 0.16],
+        vol: [0.15, 0.21]
+      })
+    ],
+    "picking up cloth"
+  ),
+  foley(
+    "item_pickup_wood",
+    [
+      sceneNoise({ type: "bandpass", f: [700, 900], q: 1, d: 0.06, vol: 0.18 }),
+      sceneNoise({
+        type: "bandpass",
+        f: [900, 1100],
+        q: 2,
+        d: 0.04,
+        vol: [0.15, 0.21],
+        delay: [0.01, 0.03]
+      })
+    ],
+    "picking up a wooden thing"
+  ),
+  foley(
+    "item_pickup_food",
+    [
+      sceneNoise({ type: "bandpass", f: [700, 900], q: 1, d: 0.06, vol: 0.18 }),
+      sceneNoise({
+        type: "lowpass",
+        f: [500, 650],
+        d: 0.05,
+        vol: 0.12,
+        delay: [0.01, 0.03]
+      })
+    ],
+    "picking up food"
+  ),
+  foley(
+    "item_throw",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [450, 650],
+        f2: 1400,
+        q: 1.5,
+        a: 0.05,
+        d: 0.18,
+        vol: [0.1, 0.14]
+      })
+    ],
+    "the arm throwing something: air"
+  ),
+  // a can: the tab cracks, the gas hisses out; drinking is gulps; crushing it crumples the sheet
+  foley(
+    "can_open",
+    [
+      ...click(3200, 0.36),
+      sceneNoise({
+        type: "highpass",
+        f: [3600, 4400],
+        a: 5e-3,
+        d: [0.22, 0.3],
+        vol: [0.16, 0.22],
+        delay: [0.012, 0.02]
+      }),
+      ...sceneMany(5, () => sceneTone({ f: [4e3, 7e3], d: 0.02, vol: 0.01, delay: [0.05, 0.4] }))
+    ],
+    "the tab of a can and the gas hissing out"
+  ),
+  foley(
+    "can_crush",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [1600, 2200],
+        q: 1.2,
+        d: [0.18, 0.25],
+        vol: [0.3, 0.38]
+      }),
+      ...sceneMany(
+        6,
+        () => sceneTone({
+          f: [1200, 3400],
+          f2: 900,
+          d: 0.03,
+          vol: [0.03, 0.06],
+          delay: [0, 0.2]
+        })
+      )
+    ],
+    "a can crushed in the hand"
+  ),
+  foley(
+    "can_puncture_spray",
+    [
+      sceneNoise({
+        type: "highpass",
+        f: [2400, 3e3],
+        a: 5e-3,
+        d: [0.5, 0.7],
+        vol: [0.2, 0.26]
+      }),
+      sceneNoise({ type: "bandpass", f: [600, 800], q: 2, d: 0.4, vol: 0.06 })
+    ],
+    "a can holed: the jet hissing out"
+  ),
+  foley(
+    "bottle_open",
+    [
+      ...sceneMany(
+        5,
+        () => sceneNoise({
+          type: "bandpass",
+          f: [2200, 3e3],
+          q: 4,
+          d: 8e-3,
+          vol: [0.1, 0.16],
+          delay: [0, 0.18]
+        })
+      ),
+      sceneNoise({
+        type: "highpass",
+        f: 3800,
+        a: 5e-3,
+        d: 0.12,
+        vol: [0.06, 0.1],
+        delay: [0.18, 0.22]
+      })
+    ],
+    "the screw cap of a bottle turning off"
+  ),
+  foley(
+    "drink_gulp",
+    [
+      sceneNoise({
+        type: "lowpass",
+        f: [280, 360],
+        a: 0.02,
+        d: [0.1, 0.14],
+        vol: [0.24, 0.3]
+      }),
+      sceneTone({ f: [140, 170], f2: 85, d: [0.08, 0.11], vol: [0.12, 0.16] })
+    ],
+    "a gulp"
+  ),
+  foley(
+    "eat_crunch",
+    [
+      ...sceneMany(
+        4,
+        () => sceneNoise({
+          type: "bandpass",
+          f: [1800, 3200],
+          q: 1.5,
+          d: [0.02, 0.04],
+          vol: [0.12, 0.2],
+          delay: [0, 0.12]
+        })
+      )
+    ],
+    "a bite of something crunchy"
+  ),
+  foley(
+    "eat_chew",
+    [
+      sceneNoise({
+        type: "lowpass",
+        f: [450, 600],
+        a: 0.03,
+        d: [0.1, 0.14],
+        vol: [0.12, 0.16]
+      }),
+      sceneNoise({
+        type: "bandpass",
+        f: [1100, 1400],
+        q: 2,
+        d: 0.04,
+        vol: 0.04,
+        delay: [0.03, 0.06]
+      })
+    ],
+    "chewing"
+  ),
+  foley(
+    "bandage_wrap",
+    [
+      sceneNoise({
+        type: "bandpass",
+        f: [1400, 1800],
+        f2: 2400,
+        q: 1,
+        a: 0.04,
+        d: [0.3, 0.4],
+        vol: [0.12, 0.16]
+      })
+    ],
+    "a bandage unrolled round a limb"
+  ),
+  foley(
+    "pills_shake",
+    [
+      ...sceneMany(
+        8,
+        () => sceneTone({
+          f: [2400, 3600],
+          d: 0.015,
+          vol: [0.03, 0.05],
+          delay: [0, 0.25]
+        })
+      ),
+      sceneNoise({ type: "bandpass", f: [1500, 1900], q: 2, d: 0.25, vol: 0.05 })
+    ],
+    "pills shaken in their bottle"
+  ),
+  foley(
+    "medkit_use",
+    [
+      ...click(1700, 0.24),
+      sceneNoise({
+        type: "bandpass",
+        f: [1e3, 1400],
+        q: 1,
+        a: 0.03,
+        d: [0.25, 0.32],
+        vol: [0.08, 0.12],
+        delay: [0.05, 0.08]
+      })
+    ],
+    "a first aid kit opened and rummaged"
+  ),
+  foley("flashlight_click", click(2600, 0.3), "the switch of a flashlight")
+];
+var FOLEY_BANK = {
+  id: "foley",
+  sounds: [...LEAF_FOLEY, ...ITEM_FOLEY]
+};
+var PICKUP_CLASSES = ["metal", "plastic", "glass", "paper", "fabric", "wood", "food"];
+var LEAF_FOLEY_SETS = {
+  wood_door: {
+    open: "door_wood_open",
+    turn: "door_creak",
+    close: "door_wood_close",
+    slam: "door_wood_slam",
+    locked: "door_locked_rattle"
+  },
+  metal_door: {
+    open: "door_wood_open",
+    turn: "door_creak_metal",
+    close: "door_metal_open_close",
+    locked: "door_locked_rattle"
+  },
+  fridge: {
+    open: "fridge_open",
+    close: "fridge_close",
+    locked: "door_locked_rattle"
+  },
+  microwave: {
+    open: "microwave_open",
+    close: "microwave_close",
+    locked: "door_locked_rattle"
+  },
+  drawer: {
+    open: "drawer_open",
+    close: "drawer_close",
+    locked: "door_locked_rattle"
+  }
+};
+
 // src/recipes/body-foley.ts
 import {
   BODY_SOUND_IDS,
@@ -317,7 +1102,8 @@ function createAudioSink(engine) {
         ...request.volume === void 0 ? {} : { volume: request.volume },
         ...request.params ? { params: request.params } : {},
         ...request.seed === void 0 ? {} : { seed: request.seed },
-        ...request.delay === void 0 ? {} : { delay: request.delay }
+        ...request.delay === void 0 ? {} : { delay: request.delay },
+        ...request.urgent ? { urgent: true } : {}
       });
       if (!handle) return null;
       playing.set(handle.id, handle);
@@ -327,9 +1113,22 @@ function createAudioSink(engine) {
       playing.get(handle.id)?.stop();
       playing.delete(handle.id);
     },
-    loop(sound) {
+    loop(sound, options) {
       const loop = engine.loop(sound);
-      return { set: (state) => loop.set({ ...state.volume === void 0 ? {} : { volume: state.volume }, ...state.frequency === void 0 ? {} : { frequency: state.frequency } }), stop: () => loop.stop() };
+      let position = options?.position;
+      return {
+        set: (state) => {
+          position = state.position ?? position;
+          const cutoff = state.params?.["cutoff"];
+          loop.set({
+            ...state.volume === void 0 ? {} : { volume: state.volume },
+            ...state.frequency === void 0 ? {} : { frequency: state.frequency },
+            ...position ? { position } : {},
+            ...cutoff === void 0 ? {} : { cutoff }
+          });
+        },
+        stop: () => loop.stop()
+      };
     },
     setListener(listener) {
       engine.setListener(listener);
@@ -348,57 +1147,128 @@ export {
   BUILD_ORDERS,
   BUS_IDS,
   BUS_PRIORITY,
+  CALIBRATION_ID,
+  CALIBRATION_LOOP_ID,
+  CALIBRATION_LOOP_SOUND,
+  CALIBRATION_SOUND,
+  CRITERIA,
+  CRITERIA_TARGETS,
+  CROSSFADE_STEPS,
+  DEFAULT_CROSSOVER,
   DEFAULT_LISTENER,
+  DEFAULT_LOOP_CROSSFADE,
   DEFAULT_MAX_VOICES,
   DEFAULT_MIX,
+  DEFAULT_SAMPLE_CUTOFF_K,
+  DEFAULT_SAMPLE_FALLOFF,
+  DEFAULT_SAMPLE_PITCH,
+  DEFAULT_TAIL_GAIN,
   DISTANCE_CURVES,
+  FOLEY_BANK,
+  FOLEY_FALLOFF,
   FOOTSTEP_FALLOFF,
   GAME_SFX_BANK,
   GAME_SFX_CLASSES,
   GAME_SFX_FALLBACK,
+  ITEM_FOLEY,
+  KIT_CATEGORY_BUS,
+  KIT_SAMPLE_ALIASES,
+  LAYER_FLOOR,
+  LEAF_FOLEY,
+  LEAF_FOLEY_SETS,
   LIBRARY_BANK,
   LIBRARY_LOOPS,
   LIBRARY_SOUNDS,
   LOOP_SMOOTHING,
   LOOP_START_ABOVE,
   MIX_PROFILES,
+  OPEN_CUTOFF,
   PAN_LIMIT,
   PAN_MIN_DISTANCE,
+  PICKUP_CLASSES,
+  SAMPLE_ENVIRONMENTS,
+  SDK_LICENSES,
+  SFX_BLOWS,
+  SFX_CATALOG,
+  SFX_CATEGORIES,
+  SFX_IMPACTS,
+  SFX_LAYERS,
+  SFX_MATERIALS,
+  SFX_TIERS,
   VOICE_GROUPS,
   audioBenchTextOf,
+  balanceOf,
   bufferOf,
   buildChain,
   busGain,
   busPriority,
+  calibrationLoader,
+  centroidHz,
+  countHits,
   createAudioEngine,
   createAudioSink,
   createAudioTestModule,
   createLoopState,
   createRng,
+  createSampleStore,
   createSetPicker,
   createSoundRegistry,
   createVoiceManager,
+  crossGains,
   cutoffDivisor,
+  dbOf,
   drawBetween,
+  encodeWav,
+  endDropDb,
+  equalPowerIn,
   falloffGain,
+  farMixAt,
+  fetchLoader,
   fillImpulse,
   fillNoise,
   globalContext,
+  impactSoundId,
+  inlineLoader,
+  isCalibrationUrl,
   isSilent,
+  kitSampleBank,
+  kitSampleDefaults,
+  limiterCurve,
   listenerDistance,
+  loadKitSamples,
+  loopCrossfade,
+  measureCriteria,
   noiseClassRecipe,
+  onsetIndex,
   panFor,
+  parseSfxName,
+  peakIndex,
+  peakOf,
+  pickTake,
+  planSample,
   planSound,
   realize,
+  realizeSample,
+  recordOutput,
   resolveMix,
   retunePlan,
+  ringSeconds,
+  rmsDb,
+  sampleBankFromManifest,
+  sampleCutoff,
+  sampleLength,
+  sampleUrls,
   sceneMany,
   sceneNoise,
   sceneRecipe,
   sceneTone,
   sceneVoice,
+  sfxState,
+  splitTier,
   streamFor,
   streamSeed,
-  unlockContext
+  tierFor,
+  unlockContext,
+  withAliases
 };
 //# sourceMappingURL=index.js.map