@adatechnology/game-destruction-three 0.16.0 → 0.17.0

package/dist/index.d.ts

@@ -386,6 +386,11 @@ type DestructionSoundStyle = 'art_scene' | 'game';
  * sends them before its legacy family key, so the first one with a rule plays; a game replaces any of them in `keys`.
  */
 declare const IMPACT_SOUND_KEYS: Readonly<Record<string, SoundKeyRule>>;
+/**
+ * Every sound a blow, ricochet or break on a material can play (`sound`, `above.sound` and `fallback` of each rule of `rules`): a game preloads them on
+ * the first input, so even the first ricochet or impact plays the recording instead of the synthesized recipe while the file is still loading.
+ */
+declare const impactSoundIds: (rules?: Readonly<Record<string, SoundKeyRule>>) => string[];
 /**
  * The keys `createDestructionRenderer` sends to `onSound`, mapped to the sounds the teams delivered. The Cena de Arte has a sound for every material
  * (clang, wood, glass, crumble, thud...); the game has four classes (impact, glass, wood, explosion) and its own explosion thump. Which team sound answers
@@ -492,4 +497,4 @@ declare function blastFireSampleBank(manifest: SfxManifest, options?: BlastFireS
 /** Every particle kind the renderer can emit (the game's sprite kinds, see `@adatechnology/game-vfx`). */
 type ParticleKind = SpriteKind;
 
-export { BIG_BLAST_RADIUS, BLAST_FALLOFF, BLAST_FAR_DISTANCE, BLAST_FAR_FALLOFF, BLAST_FIRE_SAMPLES, BLAST_KINDS, BLAST_KIND_OF, BLAST_SOUNDS, BLAST_SOUND_OF, BURN_LOOP, type BindOptions, type BlastFireSampleBankOptions, type BlastFireSampleDefaults, type BlastKind, DEFAULT_CRACKLES, DEFAULT_FIRE, DEFAULT_INDOOR_CONFINEMENT, DESTRUCTION_SOUND_BANK, DESTRUCTION_SOUND_KEYS, DRAG_SOUNDS, type DestructionRenderer, type DestructionSound, type DestructionSoundOptions, type DestructionSoundStyle, EXPLOSION_BOOM, type ExplodeOptions, FIRE_FALLOFF, FIRE_LOOP, FIRE_SOUNDS, type FragmentLifeRule, IMPACT_FAMILY_TAGS, IMPACT_SOUNDS, IMPACT_SOUND_KEYS, type ImpactFamily, type ImpactKeys, type LooseBody, type Mesh, type MeshRange, type Object3D, type PartHint, type ParticleKind, type Piece, type Quality, type RendererOptions, SCENE_SOUNDS, type SolidBox, type SoundDetail, type SoundKeyRule, type SpecFromObjectOptions, type SpecFromObjectResult, type ThreeNamespace, blastFireSampleBank, breakSoundKeys, createDestructionRenderer, createDestructionSound, dragSoundKey, heatColor, impactFamily, impactKey, impactSoundKeys, ricochetSoundKeys, shotKey, specFromObject3D };
+export { BIG_BLAST_RADIUS, BLAST_FALLOFF, BLAST_FAR_DISTANCE, BLAST_FAR_FALLOFF, BLAST_FIRE_SAMPLES, BLAST_KINDS, BLAST_KIND_OF, BLAST_SOUNDS, BLAST_SOUND_OF, BURN_LOOP, type BindOptions, type BlastFireSampleBankOptions, type BlastFireSampleDefaults, type BlastKind, DEFAULT_CRACKLES, DEFAULT_FIRE, DEFAULT_INDOOR_CONFINEMENT, DESTRUCTION_SOUND_BANK, DESTRUCTION_SOUND_KEYS, DRAG_SOUNDS, type DestructionRenderer, type DestructionSound, type DestructionSoundOptions, type DestructionSoundStyle, EXPLOSION_BOOM, type ExplodeOptions, FIRE_FALLOFF, FIRE_LOOP, FIRE_SOUNDS, type FragmentLifeRule, IMPACT_FAMILY_TAGS, IMPACT_SOUNDS, IMPACT_SOUND_KEYS, type ImpactFamily, type ImpactKeys, type LooseBody, type Mesh, type MeshRange, type Object3D, type PartHint, type ParticleKind, type Piece, type Quality, type RendererOptions, SCENE_SOUNDS, type SolidBox, type SoundDetail, type SoundKeyRule, type SpecFromObjectOptions, type SpecFromObjectResult, type ThreeNamespace, blastFireSampleBank, breakSoundKeys, createDestructionRenderer, createDestructionSound, dragSoundKey, heatColor, impactFamily, impactKey, impactSoundIds, impactSoundKeys, ricochetSoundKeys, shotKey, specFromObject3D };

package/dist/index.global.js

@@ -55,6 +55,7 @@ var GameDestructionThree = (() => {
     heatColor: () => heatColor,
     impactFamily: () => impactFamily,
     impactKey: () => impactKey,
+    impactSoundIds: () => impactSoundIds,
     impactSoundKeys: () => impactSoundKeys,
     ricochetSoundKeys: () => ricochetSoundKeys,
     shotKey: () => shotKey,
@@ -11237,6 +11238,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
           floor: 60
         }
       },
+      ricochetDeg: 12,
       hitDebris: "chips",
       breakDebris: "dust",
       visual: { innerColor: 10197652 },
@@ -11268,6 +11270,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         0.04,
         0.12
       ],
+      ricochetDeg: 10,
       hitDebris: "chips",
       breakDebris: "dust",
       visual: { innerColor: 12085567 },
@@ -11325,6 +11328,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         0.06,
         0.3
       ],
+      ricochetDeg: 15,
       hitDebris: "chips",
       breakDebris: "dust",
       visual: { innerColor: 9407364 },
@@ -11753,6 +11757,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         0.03,
         0.15
       ],
+      ricochetDeg: 8,
       hitDebris: "chips",
       breakDebris: "dust",
       thermal: {
@@ -11852,6 +11857,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         0.02,
         0.08
       ],
+      ricochetDeg: 8,
       hitDebris: "chips",
       breakDebris: "dust",
       thermal: {
@@ -11946,6 +11952,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         0.05,
         0.15
       ],
+      ricochetDeg: 15,
       hitDebris: "chips",
       breakDebris: "chips",
       thermal: {
@@ -11971,6 +11978,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         0.04,
         0.12
       ],
+      ricochetDeg: 12,
       hitDebris: "chips",
       breakDebris: "chips",
       thermal: {
@@ -14231,8 +14239,8 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         }
         case "melt":
           this.activate(ev.object, ev.part);
-          if (this.time - (this.throttles.get(`melt:${ev.object}|${ev.part}`) ?? -9) > 1.5) {
-            this.throttles.set(`melt:${ev.object}|${ev.part}`, this.time);
+          if (this.time - (this.throttles.get(`melt:${ev.object}`) ?? -9) > 1.5) {
+            this.throttles.set(`melt:${ev.object}`, this.time);
             this.sound("melt_sizzle", this.rootPoint(ev.object), 0.4);
           }
           break;
@@ -15082,7 +15090,63 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     }
   };
 
-  // ../game-audio/dist/chunk-C2K7XN2K.js
+  // ../game-audio/dist/chunk-JV5XXCQE.js
+  var SFX_TIERS = { light: 0, medium: 0.34, heavy: 0.67 };
+  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}`)
+      });
+    }
+    return { id: options.id, samples };
+  }
+
+  // ../game-audio/dist/chunk-UUWKSG4J.js
   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). */
     game_sfx: { model: "inverse_square", k: 4e-3, cutoffK: 0.01, minGain: 0.01 },
@@ -15517,60 +15581,6 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     burst: 20,
     burstSpacing: 0.06
   };
-  var SFX_TIERS = { light: 0, medium: 0.34, heavy: 0.67 };
-  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}`)
-      });
-    }
-    return { id: options.id, samples };
-  }
   var CATALOG = new Map([...SFX_CATALOG, ...SFX_IMPACTS].map((entry) => [entry.id, entry]));
   var PT = {
     group: "Som",
@@ -16832,7 +16842,7 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
   };
 
   // src/audio/recipes.ts
-  var scene = (id, layers, line, vars) => sceneRecipe(id, layers, line, vars ? { vars } : {});
+  var scene = (id, layers, line, vars, group) => sceneRecipe(id, layers, line, { ...vars ? { vars } : {}, ...group ? { group } : {} });
   var boomLayers = (big) => [
     sceneNoise({ f: 1200, f2: 120, d: 1.8, vol: 2, wet: 1.2 }),
     sceneTone({ f: 65, f2: 24, d: 1, vol: 1.8 }),
@@ -16851,7 +16861,8 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
       [sceneNoise({ type: "bandpass", f: 850, q: 1, d: 0.25, vol: 0.9, wet: 0.3 }), sceneTone({ f: 210, f2: 90, d: 0.1, vol: 0.6 }), sceneNoise({ type: "highpass", f: 2e3, d: 0.04, vol: 0.5 })],
       "L1360 wood"
     ),
-    scene("thunk", [sceneNoise({ type: "bandpass", f: 700, q: 2, d: 0.07, vol: 0.4 })], "L1361 thunk"),
+    // many parts coming loose at once share the `debris_knock` voices (game-audio voice-groups.json)
+    scene("thunk", [sceneNoise({ type: "bandpass", f: 700, q: 2, d: 0.07, vol: 0.4 })], "L1361 thunk", void 0, "debris_knock"),
     scene("ping", [sceneTone({ f: [2600, 3500], f2: 1400, d: 0.14, vol: 0.18, wet: 0.3 })], "L1362 ping"),
     scene("clang", [sceneTone({ f: [520, 720], f2: 480, d: 0.5, vol: 0.35, wet: 0.4 }), sceneTone({ f: 1370, f2: 1300, d: 0.3, vol: 0.15 }), sceneNoise({ type: "highpass", f: 2e3, d: 0.05, vol: 0.5 })], "L1363 clang"),
     scene("chip", [sceneNoise({ type: "bandpass", f: 1600, q: 1.2, d: 0.06, vol: 0.5 })], "L1364 chip"),
@@ -16863,7 +16874,8 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     // `thud(x, z, v)`: `v` is the `scale` param (default 1)
     scene("thud", [sceneTone({ f: 75, f2: 38, d: 0.22, vol: { param: "scale", scale: 0.6 } }), sceneNoise({ f: 420, d: 0.16, vol: { param: "scale", scale: 0.45 } })], "L1358 thud", { scale: 1 }),
     // `hiss(x, z, d)`: `seconds` is the param `d` (default 1.2)
-    scene("hiss", [sceneNoise({ type: "highpass", f: 3500, a: 0.05, d: { param: "seconds" }, vol: 0.35 })], "L1366 hiss", { seconds: 1.2 }),
+    // every melting part shares one `sizzle` voice
+    scene("hiss", [sceneNoise({ type: "highpass", f: 3500, a: 0.05, d: { param: "seconds" }, vol: 0.35 })], "L1366 hiss", { seconds: 1.2 }, "sizzle"),
     scene("boom", boomLayers(false), "L1367 boom"),
     scene("boom_big", boomLayers(true), "L1367 boom (big)"),
     scene("burst", [sceneNoise({ f: 700, f2: 120, d: 0.7, vol: 1.4, wet: 0.5 }), sceneNoise({ type: "highpass", f: 3e3, a: 0.05, d: 1.2, vol: 0.4, delay: 0.1 })], "L1357 burst"),
@@ -17018,6 +17030,15 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
     break_paper: { sound: "paper_tear" },
     break_plant: { sound: "branch_cut" }
   };
+  var impactSoundIds = (rules = IMPACT_SOUND_KEYS) => {
+    const ids = /* @__PURE__ */ new Set();
+    for (const rule of Object.values(rules)) {
+      ids.add(rule.sound);
+      if (rule.above) ids.add(rule.above.sound);
+      if (rule.fallback) ids.add(rule.fallback);
+    }
+    return [...ids];
+  };
   var DESTRUCTION_SOUND_KEYS = {
     art_scene: {
       impact_metal: { sound: "clang" },