@adatechnology/game-audio 0.7.0 → 0.9.0

package/dist/{chunk-BXUGSOPY.js → chunk-UUWKSG4J.js}

@@ -1,3 +1,11 @@
+import {
+  SDK_LICENSES,
+  __publicField,
+  kitSampleDefaults,
+  sampleBankFromManifest,
+  splitTier
+} from "./chunk-JV5XXCQE.js";
+
 // src/falloff.ts
 var DISTANCE_CURVES = {
   /** The game's `sfx`: `vol / (1 + d² × 0.004)`, cutoff `/ (1 + d × 0.01)`, silent below 0.01 (jogo L62091–62092, L62101). */
@@ -289,6 +297,20 @@ var voice_groups_default = {
     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)"
+    ]
   }
 };
 
@@ -380,12 +402,48 @@ function mergeRecords(base, patch) {
   }
   return merged;
 }
+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,
+    ...file.far ? { far: trimmed(file.far, alias) } : {},
+    ...alias.loop === void 0 ? {} : { loop: alias.loop },
+    ...alias.baseFrequency === void 0 ? {} : { baseFrequency: alias.baseFrequency },
+    ...alias.gain === void 0 ? {} : { gain: alias.gain },
+    ...alias.pitch === void 0 ? {} : { pitch: alias.pitch },
+    ...alias.falloff ? { falloff: alias.falloff } : {},
+    fallback: alias.id,
+    sources: [...file.sources, `alias: ${alias.id} \u2192 ${alias.file}`]
+  };
+}
 function createSoundRegistry(banks = []) {
   const sounds = /* @__PURE__ */ new Map();
   const loops = /* @__PURE__ */ new Map();
   const sets = /* @__PURE__ */ new Map();
   const samples = /* @__PURE__ */ new Map();
   const owners = /* @__PURE__ */ new Map();
+  const aliases = /* @__PURE__ */ new Map();
+  const derived = /* @__PURE__ */ new Map();
+  const resolveAlias = (id) => {
+    const alias = aliases.get(id);
+    if (!alias) return void 0;
+    const cached = derived.get(id);
+    if (cached) return cached;
+    const file = samples.get(alias.file);
+    if (!file) return void 0;
+    const sample = aliasSample(alias, file);
+    if (sample) derived.set(id, sample);
+    return sample;
+  };
   const registry = {
     register(bank) {
       for (const sound of bank.sounds ?? []) {
@@ -405,6 +463,11 @@ function createSoundRegistry(banks = []) {
         samples.set(sample.id, sample);
         owners.set(sample.id, bank.id);
       }
+      for (const alias of bank.sampleAliases ?? []) {
+        aliases.set(alias.id, alias);
+        if (!owners.has(alias.id)) owners.set(alias.id, bank.id);
+      }
+      derived.clear();
     },
     patch(id, patch) {
       const sound = sounds.get(id);
@@ -413,22 +476,31 @@ function createSoundRegistry(banks = []) {
       if (loop) loops.set(id, mergeRecords(loop, patch));
       const sample = samples.get(id);
       if (sample) samples.set(id, mergeRecords(sample, patch));
+      derived.clear();
     },
     remove(id) {
       sounds.delete(id);
       loops.delete(id);
       sets.delete(id);
       samples.delete(id);
+      aliases.delete(id);
       owners.delete(id);
+      derived.clear();
+    },
+    removeSample(id) {
+      samples.delete(id);
+      aliases.delete(id);
+      if (!sounds.has(id) && !loops.has(id) && !sets.has(id)) owners.delete(id);
+      derived.clear();
     },
     sound: (id) => sounds.get(id),
     loop: (id) => loops.get(id),
     set: (id) => sets.get(id),
-    sample: (id) => samples.get(id),
+    sample: (id) => samples.get(id) ?? resolveAlias(id),
     soundIds: () => [...sounds.keys()],
     setIds: () => [...sets.keys()],
     loopIds: () => [...loops.keys()],
-    sampleIds: () => [...samples.keys()],
+    sampleIds: () => [...samples.keys(), ...[...aliases.keys()].filter((id) => !samples.has(id) && resolveAlias(id) !== void 0)],
     bankOf: (id) => owners.get(id)
   };
   for (const bank of banks) registry.register(bank);
@@ -1071,7 +1143,16 @@ function planSample(sound, input) {
     const index = pickTake(refs.length, input.memory?.get(key), input.random);
     input.memory?.set(key, index);
     const ref = refs[index];
-    layers.push({ role, url: ref.url, take: index, gain: gain * (ref.gain ?? 1) * level, rate, at });
+    layers.push({
+      role,
+      url: ref.url,
+      take: index,
+      gain: gain * (ref.gain ?? 1) * level,
+      rate,
+      at,
+      ...ref.offset === void 0 ? {} : { offset: ref.offset },
+      ...ref.duration === void 0 ? {} : { duration: ref.duration }
+    });
   };
   take("close", close, gains.close, 0);
   take("far", far, gains.far, 0);
@@ -1100,6 +1181,8 @@ function planSample(sound, input) {
 var DEFAULT_LOOP_CROSSFADE = 0.25;
 var LOOKAHEAD = 1.5;
 var VOLUME_SMOOTHING = 0.05;
+var RATE_SMOOTHING = 0.04;
+var RATE_RANGE = [0.25, 4];
 function loopCrossfade(sound) {
   if (!sound.loop) return void 0;
   return sound.loop === true ? DEFAULT_LOOP_CROSSFADE : Math.max(0, sound.loop.crossfade ?? DEFAULT_LOOP_CROSSFADE);
@@ -1111,6 +1194,7 @@ var ramp2 = (param, direction, at, seconds) => {
   param.setValueAtTime(value(0), at);
   for (let step = 1; step <= CROSSFADE_STEPS; step++) param.linearRampToValueAtTime(value(step / CROSSFADE_STEPS), at + seconds * step / CROSSFADE_STEPS);
 };
+var loopRate = (sound, frequency) => sound.baseFrequency && sound.baseFrequency > 0 && frequency > 0 ? Math.max(RATE_RANGE[0], Math.min(RATE_RANGE[1], frequency / sound.baseFrequency)) : 1;
 function createSampleLoopHandle(sound, host, volume = 0) {
   const crossfade = loopCrossfade(sound) ?? DEFAULT_LOOP_CROSSFADE;
   let level = volume;
@@ -1120,13 +1204,17 @@ function createSampleLoopHandle(sound, host, volume = 0) {
   let segments = [];
   let last;
   let timer;
+  let panner;
+  let rate = 1;
+  let position;
   const entry = {
     get created() {
       return master !== void 0;
     },
     rewire() {
-      master?.disconnect();
-      master?.connect(host.output(sound.bus));
+      const out = panner ?? master;
+      out?.disconnect();
+      out?.connect(host.output(sound.bus));
     },
     stop() {
       stopped = true;
@@ -1143,23 +1231,29 @@ function createSampleLoopHandle(sound, host, volume = 0) {
       segments = [];
       master?.disconnect();
       master = void 0;
+      panner?.disconnect();
+      panner = void 0;
       fallback?.stop();
       fallback = void 0;
       host.unregister(entry);
     }
   };
-  const nextBuffer = () => {
+  const nextTake = () => {
     const takes = sound.close;
     const take = pickTake(takes.length, last, host.random);
     last = take;
     const ref = takes[take];
-    return ref ? host.buffer(ref.url) : void 0;
+    const buffer = ref ? host.buffer(ref.url) : void 0;
+    return ref && buffer ? { buffer, ref } : void 0;
   };
   const schedule = (context, output, at, first) => {
-    const buffer = nextBuffer();
-    if (!buffer) return void 0;
+    const next = nextTake();
+    if (!next) return void 0;
+    const { buffer, ref } = next;
+    const offset = Math.max(0, Math.min(ref.offset ?? 0, buffer.duration));
     const source = context.createBufferSource();
     source.buffer = buffer;
+    source.playbackRate.value = rate;
     const gain = context.createGain();
     source.connect(gain);
     gain.connect(output);
@@ -1167,15 +1261,15 @@ function createSampleLoopHandle(sound, host, volume = 0) {
     if (buffer.duration < 2 * crossfade || sound.close.length === 1) {
       source.loop = true;
       if (!first) ramp2(gain.gain, "in", at, Math.max(1e-3, fade));
-      source.start(at);
+      source.start(at, offset);
       segments.push({ source, gain, end: Number.POSITIVE_INFINITY });
       return void 0;
     }
     if (first) gain.gain.setValueAtTime(1, at);
     else ramp2(gain.gain, "in", at, fade);
-    const end3 = at + buffer.duration;
+    const end3 = at + (buffer.duration - offset) / rate;
     ramp2(gain.gain, "out", end3 - fade, fade);
-    source.start(at);
+    source.start(at, offset);
     source.stop(end3);
     segments.push({ source, gain, end: end3 });
     source.onended = () => {
@@ -1196,14 +1290,26 @@ function createSampleLoopHandle(sound, host, volume = 0) {
       pump(context, output, next, false);
     }, wait);
   };
-  const fileLevel = () => level * (sound.gain ?? 1);
+  const spatial = () => {
+    if (!position || !host.listener) return 1;
+    return falloffGain(sound.falloff ?? DEFAULT_SAMPLE_FALLOFF, 1, listenerDistance(host.listener(), position, host.distance));
+  };
+  const fileLevel = () => level * (sound.gain ?? 1) * spatial();
+  const place = (context) => {
+    if (panner && position && host.listener) panner.pan.setTargetAtTime(panFor(host.listener(), position), context.currentTime, VOLUME_SMOOTHING);
+  };
   const startFiles = () => {
     if (stopped || master || !host.isReady(sound)) return master !== void 0;
     const context = host.ready();
     if (!context) return false;
     master = context.createGain();
     master.gain.setValueAtTime(fileLevel(), context.currentTime);
-    master.connect(host.output(sound.bus));
+    if (sound.pan !== false && position && typeof context.createStereoPanner === "function") {
+      panner = context.createStereoPanner();
+      if (host.listener) panner.pan.value = panFor(host.listener(), position);
+      master.connect(panner);
+      panner.connect(host.output(sound.bus));
+    } else master.connect(host.output(sound.bus));
     host.register(entry);
     pump(context, master, context.currentTime, true);
     if (fallback) {
@@ -1229,9 +1335,15 @@ function createSampleLoopHandle(sound, host, volume = 0) {
     set(next) {
       if (stopped) return;
       if (next.volume !== void 0) level = host.muted(sound.bus) ? 0 : Math.max(0, next.volume);
+      if (next.position) position = next.position;
+      if (next.frequency !== void 0 && sound.baseFrequency) rate = loopRate(sound, next.frequency);
       if (level > 0) ensure();
       const context = host.ready();
-      if (master && context) master.gain.setTargetAtTime(fileLevel(), context.currentTime, VOLUME_SMOOTHING);
+      if (master && context) {
+        master.gain.setTargetAtTime(fileLevel(), context.currentTime, VOLUME_SMOOTHING);
+        place(context);
+        if (next.frequency !== void 0 && sound.baseFrequency) for (const segment of segments) segment.source.playbackRate.setTargetAtTime(rate, context.currentTime, RATE_SMOOTHING);
+      }
       fallback?.set(next.volume === void 0 ? next : { ...next, volume: level });
     },
     stop: entry.stop
@@ -1859,6 +1971,7 @@ function createSampleStore(loader = fetchLoader()) {
 }
 
 // src/webaudio/realize-sample.ts
+var TRIM_FADE = 0.04;
 function realizeSample(plan, target) {
   const context = target.context;
   let head = target.output;
@@ -1889,7 +2002,17 @@ function realizeSample(plan, target) {
     const gain = gainNode(context, layer.gain);
     source.connect(gain);
     gain.connect(head);
-    source.start(target.time + layer.at);
+    const at = target.time + layer.at;
+    const offset = Math.max(0, Math.min(layer.offset ?? 0, buffer.duration));
+    if (layer.duration === void 0) source.start(at, offset);
+    else {
+      const duration = Math.max(0, Math.min(layer.duration, buffer.duration - offset));
+      const end3 = at + duration / layer.rate;
+      const fade = Math.min(TRIM_FADE, (end3 - at) / 4);
+      gain.gain.setValueAtTime(layer.gain, end3 - fade);
+      gain.gain.linearRampToValueAtTime(0, end3);
+      source.start(at, offset, duration);
+    }
     sources.push(source);
   }
   const realized = voiceOf(sources);
@@ -1909,7 +2032,11 @@ function realizeSample(plan, target) {
 }
 function sampleLength(plan, seconds) {
   let length = 0;
-  for (const layer of plan.layers) length = Math.max(length, layer.at + (seconds(layer.url) ?? 0) / layer.rate);
+  for (const layer of plan.layers) {
+    const file = seconds(layer.url) ?? 0;
+    const played = layer.duration === void 0 ? file - (layer.offset ?? 0) : Math.min(layer.duration, file - (layer.offset ?? 0));
+    length = Math.max(length, layer.at + Math.max(0, played) / layer.rate);
+  }
   return length;
 }
 
@@ -2118,6 +2245,7 @@ function createAudioEngine(options = {}) {
     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" })) });
@@ -2242,13 +2370,20 @@ function createAudioEngine(options = {}) {
   };
   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);
     },
@@ -2298,7 +2433,9 @@ function createAudioEngine(options = {}) {
           random: engineRandom,
           register: loopHost.register,
           unregister: loopHost.unregister,
-          muted: (bus) => busSettings.get(bus)?.muted === true
+          muted: (bus) => busSettings.get(bus)?.muted === true,
+          listener: () => listener,
+          ...options.distance ? { distance: options.distance } : {}
         },
         loopOptions.volume
       );
@@ -3599,141 +3736,67 @@ async function recordOutput(engine, seconds, act) {
   return new Blob(chunks, { type: recorder.mimeType || "audio/webm" });
 }
 
-// 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 = (entries2, baseUrl) => (entries2 ?? []).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((entries2) => entries2 ?? []));
-    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}`)
-    });
+// src/local-pack.ts
+var LOCAL_PACK_LICENSES = ["CC0", "CC-BY", "unknown", "proprietary"];
+var LOCAL_PACK_PREFERENCES = ["pack", "sdk"];
+var LocalSoundPackError = class extends Error {
+  constructor(problems) {
+    super(`invalid local sound pack: ${problems.join("; ")}`);
+    __publicField(this, "problems");
+    this.name = "LocalSoundPackError";
+    this.problems = problems;
   }
-  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"
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isLicense = (value) => LOCAL_PACK_LICENSES.includes(value);
+var isBus = (value) => BUS_IDS.includes(value);
+function entryProblems(id, entry) {
+  if (!isRecord(entry)) return [`${id}: not an object`];
+  const problems = [];
+  const files = entry.files;
+  if (!Array.isArray(files) || files.length === 0 || !files.every((file) => typeof file === "string" && file.length > 0)) problems.push(`${id}: files must be a non-empty list of paths`);
+  if (!isLicense(entry.license)) problems.push(`${id}: license must be one of ${LOCAL_PACK_LICENSES.join(", ")}`);
+  if (entry.prefer !== void 0 && !LOCAL_PACK_PREFERENCES.includes(entry.prefer)) problems.push(`${id}: prefer must be pack or sdk`);
+  if (entry.bus !== void 0 && !isBus(entry.bus)) problems.push(`${id}: unknown bus ${String(entry.bus)}`);
+  if (entry.gain !== void 0 && (typeof entry.gain !== "number" || entry.gain < 0)) problems.push(`${id}: gain must be a number \u2265 0`);
+  if (entry.score !== void 0 && (typeof entry.score !== "number" || entry.score < 0 || entry.score > 10)) problems.push(`${id}: score must be 0\u201310`);
+  return problems;
+}
+function parseLocalSoundPack(value) {
+  if (!isRecord(value)) throw new LocalSoundPackError(["the pack is not an object"]);
+  const problems = [];
+  if (value.version !== 1) problems.push("version must be 1");
+  if (value.baseUrl !== void 0 && typeof value.baseUrl !== "string") problems.push("baseUrl must be a string");
+  if (!isRecord(value.sounds)) problems.push("sounds must be an object of id \u2192 entry");
+  else for (const [id, entry] of Object.entries(value.sounds)) problems.push(...entryProblems(id, entry));
+  if (problems.length > 0) throw new LocalSoundPackError(problems);
+  return value;
+}
+var isShippableLicense = (license) => SDK_LICENSES.includes(license);
+var CATALOG = new Map([...SFX_CATALOG, ...SFX_IMPACTS].map((entry) => [entry.id, entry]));
+var busOf = (id, entry) => {
+  if (entry.bus) return entry.bus;
+  const category = CATALOG.get(id)?.category ?? "";
+  return kitSampleDefaults({ id, category })?.bus ?? "world";
 };
-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
+function localPackSamples(pack, options = {}) {
+  const baseUrl = options.baseUrl ?? pack.baseUrl ?? "";
+  return Object.entries(pack.sounds).map(([id, entry]) => {
+    const current = CATALOG.get(id)?.current;
+    const isLoop = /_loop(_|$)/.test(id);
+    return {
+      id,
+      bus: busOf(id, entry),
+      close: entry.files.map((file) => ({ url: `${baseUrl}${file}` })),
+      pitch: isLoop ? 0 : 0.04,
+      ...isLoop ? { loop: true } : {},
+      ...entry.gain === void 0 ? {} : { gain: entry.gain },
+      ...current ? { fallback: current } : {},
+      license: entry.license,
+      sources: entry.files.map((file) => `local: ${file} ${entry.license}`)
+    };
   });
 }
-var isFileUrl = (url2) => {
-  const page = globalThis.location?.href;
-  try {
-    return new URL(url2, page).protocol === "file:";
-  } catch {
-    return false;
-  }
-};
-var fetchJson = async (url2) => {
-  if (isFileUrl(url2)) 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 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/user-samples.ts
 var USER_SAMPLES_BANK = "user_samples";
@@ -3863,9 +3926,9 @@ var PT = {
   strengths: { light: "leve", medium: "m\xE9dio", heavy: "forte" },
   states: { file: "A", synth: "S", missing: "F" },
   criteria: { C1: "C1 Sincronia", C2: "C2 Certo p/ a\xE7\xE3o", C3: "C3 Dist\xE2ncia", C4: "C4 Posi\xE7\xE3o", C5: "C5 Varia\xE7\xE3o", C6: "C6 Volume", C7: "C7 Intensidade", C8: "C8 Cauda", C9: "C9 Rajada", C10: "C10 Escuta" },
-  metrics: { source: "1 \xB7 Fonte do que tocou", chosen: "1 \xB7 Escolhido", matrix: "2 \xB7 Matriz", last: "\xDAltimo tocado", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Prefer\xEAncias", state: "5 \xB7 Medi\xE7\xE3o", count: "1 \xB7 Cat\xE1logo" },
+  metrics: { source: "1 \xB7 Fonte do que tocou", chosen: "1 \xB7 Escolhido", matrix: "2 \xB7 Matriz", last: "\xDAltimo tocado", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Prefer\xEAncias", state: "5 \xB7 Medi\xE7\xE3o", count: "1 \xB7 Cat\xE1logo", unlicensed: "1 \xB7 Arquivo sem licen\xE7a" },
   run: { idle: "parada", measuring: "medindo\u2026", done: "pronta", failed: "falhou", recording: "gravando\u2026", recorded: "grava\xE7\xE3o baixada" },
-  words: { none: "\u2014", hidden: "? (revele)", prefers: "prefere", approved: "aprovado pelo dono" },
+  words: { none: "\u2014", hidden: "? (revele)", prefers: "prefere", approved: "aprovado pelo dono", local_file: "arquivo do pacote local", sdk_file: "grava\xE7\xE3o do SDK", synth: "s\xEDntese do SDK" },
   sources: { sdk: "SDK", user: "seu som", synth: "sintetizado" },
   probe: "Fonte do som",
   wall: "Parede (oclus\xE3o)",
@@ -3936,9 +3999,9 @@ var EN2 = {
   environments: { indoor: "indoor", outdoor: "outdoor" },
   strengths: { light: "light", medium: "medium", heavy: "heavy" },
   criteria: { C1: "C1 Sync", C2: "C2 Right sound", C3: "C3 Distance", C4: "C4 Position", C5: "C5 Variation", C6: "C6 Level", C7: "C7 Strength", C8: "C8 Tail", C9: "C9 Burst", C10: "C10 Listening" },
-  metrics: { source: "1 \xB7 Source of what played", chosen: "1 \xB7 Chosen", matrix: "2 \xB7 Matrix", last: "Last played", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Preferences", state: "5 \xB7 Measurement", count: "1 \xB7 Catalogue" },
+  metrics: { source: "1 \xB7 Source of what played", chosen: "1 \xB7 Chosen", matrix: "2 \xB7 Matrix", last: "Last played", ab: "4 \xB7 A \xD7 B", blind: "4 \xB7 X", verdicts: "4 \xB7 Preferences", state: "5 \xB7 Measurement", count: "1 \xB7 Catalogue", unlicensed: "1 \xB7 File without licence" },
   run: { idle: "idle", measuring: "measuring\u2026", done: "done", failed: "failed", recording: "recording\u2026", recorded: "recording downloaded" },
-  words: { none: "\u2014", hidden: "? (reveal)", prefers: "prefers", approved: "approved by the owner" },
+  words: { none: "\u2014", hidden: "? (reveal)", prefers: "prefers", approved: "approved by the owner", local_file: "local pack file", sdk_file: "SDK recording", synth: "SDK synthesis" },
   sources: { sdk: "SDK", user: "your sound", synth: "synthesized" },
   probe: "Sound source",
   wall: "Wall (occlusion)",
@@ -4146,6 +4209,18 @@ function createSoundCheckModule(options = {}) {
     const count = (state) => states.filter((each) => each === state).length;
     return `${text.states.file} ${count("file")} \xB7 ${text.states.synth} ${count("synth")} \xB7 ${text.states.missing} ${count("missing")}`;
   };
+  const sourceOf2 = (id) => {
+    const sample = registry().sample(id);
+    if (!sample) return text.words.synth;
+    return sample.sources.some((source) => source.startsWith("local:")) ? text.words.local_file : text.words.sdk_file;
+  };
+  const unlicensed = () => {
+    const ids = registry().sampleIds().filter((id) => {
+      const license = registry().sample(id)?.license;
+      return license !== void 0 && !isShippableLicense(license);
+    });
+    return ids.length === 0 ? text.words.none : `${ids.length}: ${ids.join(", ")}`;
+  };
   const strikeId = () => impactSoundId(chosen.material, chosen.blow);
   const lastLine = () => {
     const last = log.at(-1);
@@ -4162,7 +4237,8 @@ function createSoundCheckModule(options = {}) {
   const metrics = () => [
     { id: "source", name: text.metrics.source, read: sourceLine },
     { id: "count", name: text.metrics.count, read: counts },
-    { id: "chosen", name: text.metrics.chosen, read: () => `${label(chosen.sound)}${registry().sample(chosen.sound) ? ` (${engine.sampleStatus(chosen.sound)})` : ""}` },
+    { id: "unlicensed", name: text.metrics.unlicensed, read: unlicensed },
+    { id: "chosen", name: text.metrics.chosen, read: () => `${label(chosen.sound)}${registry().sample(chosen.sound) ? ` (${engine.sampleStatus(chosen.sound)})` : ""} \xB7 ${sourceOf2(chosen.sound)}` },
     { id: "matrix", name: text.metrics.matrix, read: () => `${strikeId()} \xB7 ${text.states[stateOf(strikeId())]}${pairOf(strikeId()).a ? ` \xB7 A=${pairOf(strikeId()).a}` : ""}` },
     { id: "ab", name: text.metrics.ab, read: () => `A ${pairOf(chosen.sound).a ?? text.words.none} \xB7 B ${pairOf(chosen.sound).b ?? text.words.none}` },
     { id: "blind_state", name: text.metrics.blind, read: () => !blind ? text.words.none : blind.revealed ? `X = ${blind.side}` : text.words.hidden },
@@ -4405,6 +4481,7 @@ export {
   CALIBRATION_LOOP_SOUND,
   isCalibrationUrl,
   calibrationLoader,
+  aliasSample,
   createSoundRegistry,
   MIX_PROFILES,
   DEFAULT_MIX,
@@ -4423,12 +4500,14 @@ export {
   loopCrossfade,
   CROSSFADE_STEPS,
   equalPowerIn,
+  loopRate,
   realize,
   retunePlan,
   createSetPicker,
   fetchLoader,
   inlineLoader,
   createSampleStore,
+  TRIM_FADE,
   realizeSample,
   sampleLength,
   limiterCurve2 as limiterCurve,
@@ -4454,24 +4533,18 @@ export {
   impactSoundId,
   SFX_IMPACTS,
   sfxState,
-  SDK_LICENSES,
-  SFX_LAYERS,
-  SFX_TIERS,
-  parseSfxName,
-  splitTier,
-  sampleBankFromManifest,
-  KIT_CATEGORY_BUS,
-  KIT_SAMPLE_ALIASES,
-  kitSampleDefaults,
-  withAliases,
-  kitSampleBank,
-  loadKitSamples,
   USER_SAMPLES_BANK,
   KIT_SAMPLES_BANK,
   USER_SOUND_PREFIX,
   soundSourceOf,
   userSampleBank,
   loadUserSamples,
+  LOCAL_PACK_LICENSES,
+  LOCAL_PACK_PREFERENCES,
+  LocalSoundPackError,
+  parseLocalSoundPack,
+  isShippableLicense,
+  localPackSamples,
   GAME_SFX_CLASSES,
   GAME_SFX_FALLBACK,
   noiseClassRecipe,
@@ -4487,4 +4560,4 @@ export {
   CALIBRATION_CATEGORY,
   createSoundCheckModule
 };
-//# sourceMappingURL=chunk-BXUGSOPY.js.map
+//# sourceMappingURL=chunk-UUWKSG4J.js.map