@adatechnology/game-audio 0.7.0 → 0.8.0

package/README.md

@@ -103,5 +103,48 @@ engine.play('pistol_9mm', { position: [10, 0, -40], environment: 'indoor', delay
 - Each play: a take drawn among all but the last one (round-robin, never twice in a row), the rate ± `pitch` (default 4 %), the level by `falloff`, a lowpass by distance (`cutoffK`) and behind a wall (`occlusion`), the pan.
 - Sample voices of a bus go through a zero-delay limiter (ceiling −1 dBFS); `choke: { voices }` fades the oldest plays of a sound for rapid fire.
 - `onVoiceStart` reports every voice (recipe or sample, the files and takes, `requestedAt` / `startAt`): the event log the criteria measure.
-- Files: drop them in `assets/sfx-inbox/<categoria>/` with a line in its `CREDITOS.md` and run `pnpm --filter @adatechnology/game-audio sfx:convert` (ffmpeg): Ogg Vorbis mono 48 kHz, −1 dBFS peak, attack on the first ms, `manifest.json` and `CREDITOS.md`. Only CC0 and CC-BY go into the SDK.
+- **No audio ships in the kit.** `assets/sfx/manifest.json` is only the references (sound id → path, with source, author and licence) and
+  `assets/sfx/CREDITOS.md` the credits; the files live in the game's repository (ZombiAdA `assets/sfx/<categoria>/`, originals in
+  `assets/sfx-originais/`). A game serves that folder and passes it as `baseUrl`; a take whose file is missing plays the recipe of its id.
+- On this machine, `scripts/sfx-dir.mjs` says where the files are: `KIT_SFX_DIR` / `KIT_SFX_INBOX`, or `.sfx-local.json` at the repo root (ignored
+  by git) `{ "kit": "../zombiada/assets/sfx", "inbox": "../zombiada/assets/sfx-originais" }`, or `.sfx/` and `.sfx-inbox/`. The test room links
+  them into `dist/sfx/`; the tests that read files skip without them; CI fails on any audio file tracked by git.
+- New files: the original in `<inbox>/<categoria>/` with a line in its `CREDITOS.md`, then `pnpm --filter @adatechnology/game-audio sfx:convert`
+  (ffmpeg): Ogg Vorbis mono 48 kHz, −1 dBFS peak, attack on the first ms, written to the game's folder, with the manifest and credits updated here.
+  Only CC0 and CC-BY (the kit and the game are public).
 - Measuring: `measureCriteria({ sound, banks, loader })` renders C1–C9 through the real engine on an `OfflineAudioContext`; the test room's `?area=sound_check_area` (`createSoundCheckModule`) runs it on a button and records 3 s for C10. `CALIBRATION_SOUND` is a kit-made sample sound (no file) with every layer, for checking the path end to end.
+
+## Local sound pack (your own files, by config)
+
+A project can answer any SDK sound id with its own files, kept in its own folders and never in the SDK. A JSON config maps each id to its takes:
+
+```json
+{
+  "version": 1,
+  "baseUrl": "audio/",
+  "sounds": {
+    "pistol_9mm": { "files": ["weapons/pistol_01.ogg", "weapons/pistol_02.ogg"], "license": "CC0" },
+    "door_wood_close": { "files": ["doors/close.ogg"], "license": "CC-BY", "score": 7 }
+  }
+}
+```
+
+```ts
+import { applyLocalSoundPack, parseLocalSoundPack } from '@adatechnology/game-audio'
+
+const pack = applyLocalSoundPack(engine, parseLocalSoundPack(await (await fetch('audio/pack.json')).json()), { baseUrl: 'audio/' })
+await pack.done // { file: ids now playing your files, fallback: ids whose files failed }
+pack.unlicensed() // ids playing a file whose licence is not CC0 / CC-BY
+pack.dispose() // every id gets its previous sound back
+```
+
+- Urls are `baseUrl + file`: a folder served next to the page or any url (`https://cdn.example/sfx/`). `options.baseUrl` overrides the config's.
+- Nothing runs in the frame a sound plays: each id's files are fetched and decoded in idle time (`requestIdleCallback`, one id per slot), once per
+  url and shared by every voice. Until they decode the id plays what it played before (the SDK recording, else the synthesized recipe); a file that
+  fails leaves the id on the SDK sound for good, decided once at load.
+- `license` is `CC0`, `CC-BY`, `unknown` or `proprietary`. The sound panel (`createSoundCheckModule`, metric "File without licence") lists the ids
+  playing a file that is not CC0 / CC-BY: those may be tried locally but cannot ship.
+- `parseLocalSoundPack` validates at the boundary and throws `LocalSoundPackError` with every problem at once.
+- In this repo the test room reads `audio.local.json` at the root (git-ignored; see `examples/test-room/audio.local.example.json`, with `root` the
+  folder of the files): `tools/local-audio/local-audio.mjs link` symlinks it into `dist/local-audio/`, and `guard` / `guard-git` (build, site build,
+  pre-commit and CI) fail if a local file reaches a build or git.

package/assets/sfx/CREDITOS.md

@@ -1,7 +1,7 @@
 # Créditos dos sons
 
-Gerado por `scripts/sfx-convert.mjs` a partir de `assets/sfx-inbox/CREDITOS.md`. Pasta: `packages/game-audio/assets/sfx`.
-Só CC0 e CC-BY entram no SDK; quem usa um som CC-BY credita o autor abaixo.
+Gerado por `scripts/sfx-convert.mjs` a partir do `CREDITOS.md` dos originais. Os arquivos ficam fora do kit (ZombiAdA `assets/sfx/`); aqui só as referências.
+Só CC0 e CC-BY (o kit e o jogo são públicos); quem usa um som CC-BY credita o autor abaixo.
 
 | arquivo | fonte | autor | licença |
 |---|---|---|---|

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

@@ -1,3 +1,7 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
 // 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). */
@@ -380,12 +384,46 @@ function mergeRecords(base, patch) {
   }
   return merged;
 }
+var trimmed = (refs, alias) => refs.map((ref) => ({
+  ...ref,
+  ...alias.offset === void 0 ? {} : { offset: alias.offset },
+  ...alias.duration === void 0 ? {} : { duration: alias.duration }
+}));
+function aliasSample(alias, file) {
+  const { tiers: _tiers, fallback: _fallback, choke: _choke, ...rest } = file;
+  return {
+    ...rest,
+    id: alias.id,
+    close: trimmed(file.close, alias),
+    ...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);
+    derived.set(id, sample);
+    return sample;
+  };
   const registry = {
     register(bank) {
       for (const sound of bank.sounds ?? []) {
@@ -405,6 +443,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 +456,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 +1123,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 +1161,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 +1174,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 +1184,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 +1211,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 +1241,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 +1270,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 +1315,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 +1951,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 +1982,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 +2012,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;
 }
 
@@ -2298,7 +2405,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
       );
@@ -3684,7 +3793,16 @@ var KIT_SAMPLE_ALIASES = {
   // 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"
+  grab_soft: "item_pickup_leather",
+  // the hand foley of the test room (game-audio FOLEY_BANK) whose id is not a file id: a wooden leaf shut and slammed, an item picked up by material.
+  // The metal door stays on its recipe (two of its takes run 10 s), and so do the fridge, the microwave and paper (no file for them).
+  door_wood_close: "door_wood_shut",
+  door_wood_slam: "door_slam_wood",
+  item_pickup_metal: "item_pickup_generic",
+  item_pickup_plastic: "item_pickup_generic",
+  item_pickup_glass: "item_pickup_generic",
+  item_pickup_wood: "item_pickup_generic",
+  item_pickup_fabric: "item_pickup_leather"
 };
 function kitSampleDefaults(sound) {
   const bus = VOICE_IDS.test(sound.id) ? "voices" : KIT_CATEGORY_BUS[sound.category];
@@ -3735,6 +3853,68 @@ async function loadKitSamples(engine, options = {}) {
   return bank;
 }
 
+// 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;
+  }
+};
+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 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}`)
+    };
+  });
+}
+
 // src/user-samples.ts
 var USER_SAMPLES_BANK = "user_samples";
 var KIT_SAMPLES_BANK = "kit_samples";
@@ -3863,9 +4043,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 +4116,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 +4326,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 +4354,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 +4598,7 @@ export {
   CALIBRATION_LOOP_SOUND,
   isCalibrationUrl,
   calibrationLoader,
+  aliasSample,
   createSoundRegistry,
   MIX_PROFILES,
   DEFAULT_MIX,
@@ -4423,12 +4617,14 @@ export {
   loopCrossfade,
   CROSSFADE_STEPS,
   equalPowerIn,
+  loopRate,
   realize,
   retunePlan,
   createSetPicker,
   fetchLoader,
   inlineLoader,
   createSampleStore,
+  TRIM_FADE,
   realizeSample,
   sampleLength,
   limiterCurve2 as limiterCurve,
@@ -4472,6 +4668,12 @@ export {
   soundSourceOf,
   userSampleBank,
   loadUserSamples,
+  LOCAL_PACK_LICENSES,
+  LOCAL_PACK_PREFERENCES,
+  LocalSoundPackError,
+  parseLocalSoundPack,
+  isShippableLicense,
+  localPackSamples,
   GAME_SFX_CLASSES,
   GAME_SFX_FALLBACK,
   noiseClassRecipe,
@@ -4487,4 +4689,4 @@ export {
   CALIBRATION_CATEGORY,
   createSoundCheckModule
 };
-//# sourceMappingURL=chunk-BXUGSOPY.js.map
+//# sourceMappingURL=chunk-C2K7XN2K.js.map