@adatechnology/game-weapons-three 0.14.2 → 0.16.0

package/dist/index.js

@@ -10,6 +10,7 @@ import {
   DEFAULT_THUMBNAIL_BASE,
   EXPLOSIVES_AREA_ID,
   EXPLOSIVES_TEXT,
+  EXPLOSIVE_MODEL_IDS,
   GAME_DISTANCE_CURVE,
   GAME_SOUND_CLASSES,
   GUNSHOT_PROFILES,
@@ -31,11 +32,13 @@ import {
   applyCondition,
   buildCartridge,
   buildCasing,
+  buildExplosiveModel,
   buildFlyingRocket,
   buildItemWeaponModel,
   buildModeledProp,
   buildProp,
   buildRound,
+  buildThrowableModel,
   buildToolClips,
   buildTripodMountedProp,
   buildWeaponModel,
@@ -54,6 +57,8 @@ import {
   deriveFrames,
   explosivesTextOf,
   fitAttachmentModels,
+  hasExplosiveModel,
+  hasThrowableModel,
   hasWeaponModel,
   itemModelOfWeapon,
   mechanicalSoundOf,
@@ -74,16 +79,27 @@ import {
   worldExplosiveItem,
   worldExplosiveShell,
   worldExplosiveValve
-} from "./chunk-XMVSA7UT.js";
+} from "./chunk-KWJQO6JS.js";
 
 // src/projectile-model.ts
+import { markKitOrigin } from "@adatechnology/game-contracts";
 function projectileModel(THREE, query) {
-  if (query.kind !== "rocket") return null;
+  if (query.kind !== "rocket") return explosiveProjectile(THREE, query);
   const launcher = buildWeaponModelById(THREE, query.weapon);
   if (!launcher || launcher.parts.family !== "rocket") return null;
   const round = launcher.parts.makeRound ? launcher.parts.makeRound() : buildFlyingRocket(modelKit(THREE), launcher.parts.launcherType);
   return { model: round, axis: [1, 0, 0] };
 }
+function explosiveProjectile(THREE, query) {
+  const model = query.explosive === void 0 ? void 0 : buildExplosiveModel(THREE, query.explosive);
+  if (!model) return null;
+  const centre = new THREE.Box3().setFromObject(model).getCenter(new THREE.Vector3());
+  const holder = markKitOrigin(new THREE.Group(), { owner: "game-weapons-three", kind: "explosive", id: model.name });
+  holder.name = model.name;
+  model.position.sub(centre);
+  holder.add(model);
+  return { model: holder, axis: [0, 1, 0] };
+}
 
 // src/weapon-props.ts
 import { applyPatches, mergeById, removeIds } from "@adatechnology/game-contracts";
@@ -108,6 +124,7 @@ export {
   DEFAULT_THUMBNAIL_BASE,
   EXPLOSIVES_AREA_ID,
   EXPLOSIVES_TEXT,
+  EXPLOSIVE_MODEL_IDS,
   GAME_DISTANCE_CURVE,
   GAME_SOUND_CLASSES,
   GUNSHOT_PROFILES,
@@ -128,10 +145,12 @@ export {
   applyCondition,
   buildCartridge,
   buildCasing,
+  buildExplosiveModel,
   buildItemWeaponModel,
   buildModeledProp,
   buildProp,
   buildRound,
+  buildThrowableModel,
   buildToolClips,
   buildTripodMountedProp,
   buildWeaponModel,
@@ -151,6 +170,8 @@ export {
   deriveFrames,
   explosivesTextOf,
   fitAttachmentModels,
+  hasExplosiveModel,
+  hasThrowableModel,
   hasWeaponModel,
   itemModelOfWeapon,
   mechanicalSoundOf,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/projectile-model.ts","../src/weapon-props.ts"],"sourcesContent":["import type * as THREE_NS from 'three'\n\nimport { buildWeaponModelById } from './models'\nimport { modelKit } from './models/kit'\nimport { buildFlyingRocket } from './models/launcher-rounds'\n\n/** What a host asks for a thrown or set down explosive: the weapon in the hand, the explosive it carries and how it is used (`rocket`, `grenade`, `molotov`, `charge`). */\nexport interface ProjectileQuery {\n  readonly weapon: string\n  readonly explosive?: string | undefined\n  readonly kind: string\n}\n\n/** The model of a projectile and the axis along its length. */\nexport interface ProjectileModel {\n  readonly model: THREE_NS.Object3D\n  readonly axis: [number, number, number]\n}\n\n/**\n * The model of what a weapon throws or fires, drawn by the same code as the weapon itself: the round of a rocket launcher (the RPG-7's PG-7V, the Carl Gustaf's 84 mm round, the rocket of\n * the disposable tubes), long axis +x. Answers `null` where the gallery has no model: the throwables (grenades, molotovs, dynamite, C4, the Claymore) and the grenade launchers are\n * still the plain props of `weaponProp`, and a host keeps its primitive for them.\n */\nexport function projectileModel(THREE: typeof THREE_NS, query: ProjectileQuery): ProjectileModel | null {\n  if (query.kind !== 'rocket') return null\n  const launcher = buildWeaponModelById(THREE, query.weapon)\n  if (!launcher || launcher.parts.family !== 'rocket') return null\n  const round = launcher.parts.makeRound ? launcher.parts.makeRound() : buildFlyingRocket(modelKit(THREE), launcher.parts.launcherType)\n  return { model: round, axis: [1, 0, 0] }\n}\n","import { applyPatches, mergeById, removeIds } from '@adatechnology/game-contracts'\nimport type { DeepPartial } from '@adatechnology/game-contracts'\n\nimport { SHIPPED_WEAPON_ITEM_MODELS, weaponPropsOver } from './weapon-item-model'\nimport type { WeaponItemModel, WeaponProps } from './weapon-item-model'\n\nexport interface WeaponPropsOptions {\n  /** Item model overrides by weapon id, added to the shipped ones (`null` keeps the low-poly prop); later packs replace earlier ones. */\n  readonly packs?: readonly Readonly<Record<string, WeaponItemModel | null>>[]\n  /** Changes to an override by weapon id, merged field by field. */\n  readonly patch?: Readonly<Record<string, DeepPartial<WeaponItemModel>>>\n  /** Weapon ids whose override is taken out (the weapon id itself is then the item model id). */\n  readonly remove?: readonly string[]\n}\n\ntype Entry = { readonly id: string; readonly model: WeaponItemModel }\n\n/** A set of weapon prop overrides of its own: the shipped ones plus `packs`, `patch` and `remove`. Nothing is shared with any other set on the page. */\nexport function createWeaponProps(options: WeaponPropsOptions = {}): WeaponProps {\n  const entryOf = ([id, model]: readonly [string, WeaponItemModel | null]): Entry => ({ id, model: model ?? { item: '' } })\n  const entries = mergeById<Entry>(SHIPPED_WEAPON_ITEM_MODELS.map(entryOf), (options.packs ?? []).flatMap((pack) => Object.entries(pack).map(entryOf)))\n  const patches: Record<string, { model: DeepPartial<WeaponItemModel> }> = {}\n  for (const [id, model] of Object.entries(options.patch ?? {})) patches[id] = { model }\n  applyPatches(entries, patches)\n  removeIds(entries, options.remove)\n  return weaponPropsOver(new Map([...entries].map(([id, entry]) => [id, entry.model])))\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBO,SAAS,gBAAgB,OAAwB,OAAgD;AACtG,MAAI,MAAM,SAAS,SAAU,QAAO;AACpC,QAAM,WAAW,qBAAqB,OAAO,MAAM,MAAM;AACzD,MAAI,CAAC,YAAY,SAAS,MAAM,WAAW,SAAU,QAAO;AAC5D,QAAM,QAAQ,SAAS,MAAM,YAAY,SAAS,MAAM,UAAU,IAAI,kBAAkB,SAAS,KAAK,GAAG,SAAS,MAAM,YAAY;AACpI,SAAO,EAAE,OAAO,OAAO,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE;AACzC;;;AC9BA,SAAS,cAAc,WAAW,iBAAiB;AAkB5C,SAAS,kBAAkB,UAA8B,CAAC,GAAgB;AAC/E,QAAM,UAAU,CAAC,CAAC,IAAI,KAAK,OAAyD,EAAE,IAAI,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE;AACvH,QAAM,UAAU,UAAiB,2BAA2B,IAAI,OAAO,IAAI,QAAQ,SAAS,CAAC,GAAG,QAAQ,CAAC,SAAS,OAAO,QAAQ,IAAI,EAAE,IAAI,OAAO,CAAC,CAAC;AACpJ,QAAM,UAAmE,CAAC;AAC1E,aAAW,CAAC,IAAI,KAAK,KAAK,OAAO,QAAQ,QAAQ,SAAS,CAAC,CAAC,EAAG,SAAQ,EAAE,IAAI,EAAE,MAAM;AACrF,eAAa,SAAS,OAAO;AAC7B,YAAU,SAAS,QAAQ,MAAM;AACjC,SAAO,gBAAgB,IAAI,IAAI,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC;AACtF;","names":[]}
+{"version":3,"sources":["../src/projectile-model.ts","../src/weapon-props.ts"],"sourcesContent":["import { markKitOrigin } from '@adatechnology/game-contracts'\nimport type * as THREE_NS from 'three'\n\nimport { buildWeaponModelById } from './models'\nimport { buildExplosiveModel } from './models/explosives'\nimport { modelKit } from './models/kit'\nimport { buildFlyingRocket } from './models/launcher-rounds'\n\n/** What a host asks for a thrown or set down explosive: the weapon in the hand, the explosive it carries and how it is used (`rocket`, `grenade`, `molotov`, `charge`). */\nexport interface ProjectileQuery {\n  readonly weapon: string\n  readonly explosive?: string | undefined\n  readonly kind: string\n}\n\n/** The model of a projectile and the axis along its length. */\nexport interface ProjectileModel {\n  readonly model: THREE_NS.Object3D\n  readonly axis: [number, number, number]\n}\n\n/**\n * The model of what a weapon throws or fires, drawn by the same code as the weapon itself: the round of a rocket launcher (the RPG-7's PG-7V, the Carl Gustaf's 84 mm round, the rocket of\n * the disposable tubes), long axis +x, and the explosives of the gallery (the M67, the molotov, the pipe bomb, the dynamite, the C4, the Claymore, the flashbang), centred, axis +y.\n * Answers `null` where the gallery has no model (the 40 mm grenade of a launcher), and a host keeps its primitive for it.\n */\nexport function projectileModel(THREE: typeof THREE_NS, query: ProjectileQuery): ProjectileModel | null {\n  if (query.kind !== 'rocket') return explosiveProjectile(THREE, query)\n  const launcher = buildWeaponModelById(THREE, query.weapon)\n  if (!launcher || launcher.parts.family !== 'rocket') return null\n  const round = launcher.parts.makeRound ? launcher.parts.makeRound() : buildFlyingRocket(modelKit(THREE), launcher.parts.launcherType)\n  return { model: round, axis: [1, 0, 0] }\n}\n\n// a thrown or set down explosive the gallery drew: its model centred on its middle (it tumbles about it in flight), standing axis +y\nfunction explosiveProjectile(THREE: typeof THREE_NS, query: ProjectileQuery): ProjectileModel | null {\n  const model = query.explosive === undefined ? undefined : buildExplosiveModel(THREE, query.explosive)\n  if (!model) return null\n  const centre = new THREE.Box3().setFromObject(model).getCenter(new THREE.Vector3())\n  const holder = markKitOrigin(new THREE.Group(), { owner: 'game-weapons-three', kind: 'explosive', id: model.name })\n  holder.name = model.name\n  model.position.sub(centre)\n  holder.add(model)\n  return { model: holder, axis: [0, 1, 0] }\n}\n","import { applyPatches, mergeById, removeIds } from '@adatechnology/game-contracts'\nimport type { DeepPartial } from '@adatechnology/game-contracts'\n\nimport { SHIPPED_WEAPON_ITEM_MODELS, weaponPropsOver } from './weapon-item-model'\nimport type { WeaponItemModel, WeaponProps } from './weapon-item-model'\n\nexport interface WeaponPropsOptions {\n  /** Item model overrides by weapon id, added to the shipped ones (`null` keeps the low-poly prop); later packs replace earlier ones. */\n  readonly packs?: readonly Readonly<Record<string, WeaponItemModel | null>>[]\n  /** Changes to an override by weapon id, merged field by field. */\n  readonly patch?: Readonly<Record<string, DeepPartial<WeaponItemModel>>>\n  /** Weapon ids whose override is taken out (the weapon id itself is then the item model id). */\n  readonly remove?: readonly string[]\n}\n\ntype Entry = { readonly id: string; readonly model: WeaponItemModel }\n\n/** A set of weapon prop overrides of its own: the shipped ones plus `packs`, `patch` and `remove`. Nothing is shared with any other set on the page. */\nexport function createWeaponProps(options: WeaponPropsOptions = {}): WeaponProps {\n  const entryOf = ([id, model]: readonly [string, WeaponItemModel | null]): Entry => ({ id, model: model ?? { item: '' } })\n  const entries = mergeById<Entry>(SHIPPED_WEAPON_ITEM_MODELS.map(entryOf), (options.packs ?? []).flatMap((pack) => Object.entries(pack).map(entryOf)))\n  const patches: Record<string, { model: DeepPartial<WeaponItemModel> }> = {}\n  for (const [id, model] of Object.entries(options.patch ?? {})) patches[id] = { model }\n  applyPatches(entries, patches)\n  removeIds(entries, options.remove)\n  return weaponPropsOver(new Map([...entries].map(([id, entry]) => [id, entry.model])))\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AA0BvB,SAAS,gBAAgB,OAAwB,OAAgD;AACtG,MAAI,MAAM,SAAS,SAAU,QAAO,oBAAoB,OAAO,KAAK;AACpE,QAAM,WAAW,qBAAqB,OAAO,MAAM,MAAM;AACzD,MAAI,CAAC,YAAY,SAAS,MAAM,WAAW,SAAU,QAAO;AAC5D,QAAM,QAAQ,SAAS,MAAM,YAAY,SAAS,MAAM,UAAU,IAAI,kBAAkB,SAAS,KAAK,GAAG,SAAS,MAAM,YAAY;AACpI,SAAO,EAAE,OAAO,OAAO,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE;AACzC;AAGA,SAAS,oBAAoB,OAAwB,OAAgD;AACnG,QAAM,QAAQ,MAAM,cAAc,SAAY,SAAY,oBAAoB,OAAO,MAAM,SAAS;AACpG,MAAI,CAAC,MAAO,QAAO;AACnB,QAAM,SAAS,IAAI,MAAM,KAAK,EAAE,cAAc,KAAK,EAAE,UAAU,IAAI,MAAM,QAAQ,CAAC;AAClF,QAAM,SAAS,cAAc,IAAI,MAAM,MAAM,GAAG,EAAE,OAAO,sBAAsB,MAAM,aAAa,IAAI,MAAM,KAAK,CAAC;AAClH,SAAO,OAAO,MAAM;AACpB,QAAM,SAAS,IAAI,MAAM;AACzB,SAAO,IAAI,KAAK;AAChB,SAAO,EAAE,OAAO,QAAQ,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE;AAC1C;;;AC5CA,SAAS,cAAc,WAAW,iBAAiB;AAkB5C,SAAS,kBAAkB,UAA8B,CAAC,GAAgB;AAC/E,QAAM,UAAU,CAAC,CAAC,IAAI,KAAK,OAAyD,EAAE,IAAI,OAAO,SAAS,EAAE,MAAM,GAAG,EAAE;AACvH,QAAM,UAAU,UAAiB,2BAA2B,IAAI,OAAO,IAAI,QAAQ,SAAS,CAAC,GAAG,QAAQ,CAAC,SAAS,OAAO,QAAQ,IAAI,EAAE,IAAI,OAAO,CAAC,CAAC;AACpJ,QAAM,UAAmE,CAAC;AAC1E,aAAW,CAAC,IAAI,KAAK,KAAK,OAAO,QAAQ,QAAQ,SAAS,CAAC,CAAC,EAAG,SAAQ,EAAE,IAAI,EAAE,MAAM;AACrF,eAAa,SAAS,OAAO;AAC7B,YAAU,SAAS,QAAQ,MAAM;AACjC,SAAO,gBAAgB,IAAI,IAAI,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC;AACtF;","names":[]}

package/dist/{testing-DnPjEPC5.d.ts → testing-CEcZ-zzz.d.ts}

@@ -1,4 +1,4 @@
-import { HostTool, HandPose, EffectSink, HostEvent, HandTargets, TestableModule, AreaPlacement, DestructionEvent, Hit, Vec3 as Vec3$1, ModuleControl, ModuleLayer, ModuleMetric, ModuleHost } from '@adatechnology/game-contracts';
+import { HostTool, HandPose, EffectSink, HostEvent, HandTargets, MuzzlePose, TestableModule, AreaPlacement, DestructionEvent, Hit, Vec3 as Vec3$1, ModuleControl, ModuleLayer, ModuleMetric, ModuleHost } from '@adatechnology/game-contracts';
 import { CaseType, CaliberDef, ReloadStageId, WeaponEvent, MountKind, AttachmentDef, FittedAttachment, Arsenal, WeaponDef, ExplosiveDef } from '@adatechnology/game-weapons';
 import { SampleDefaults, SfxManifest, SoundBank, AudioEngine } from '@adatechnology/game-audio';
 import * as THREE_NS from 'three';
@@ -59,6 +59,15 @@ interface CasingSound {
     readonly voices: readonly CasingVoice[];
 }
 declare function computeCasingSound(input: CasingInput): CasingSound;
+/** A dropped magazine hitting the floor. */
+interface MagazineDropInput {
+    /** Floor material id (`concrete`, `wood_hard`, `soil`...). */
+    readonly surface?: string;
+    /** Vertical speed at the hit, m/s. Default 1.5. */
+    readonly speed?: number;
+    /** 0 for the first hit, then 1, 2... */
+    readonly bounce?: number;
+}
 
 var profiles$1 = {
 	pistol_22lr: {
@@ -794,11 +803,14 @@ declare function weaponSampleDefaults(sound: {
 /** The bank of the recorded weapon sounds, every url through `url` (or `baseUrl`). Gunshots choke at three voices. */
 declare function weaponSampleBank(options: WeaponSampleOptions): SoundBank;
 
-/** What a reload cue played: its recording, nothing (another cue's recording carries it), or the synthesized steps. */
-type CuePlayed = 'sample' | 'carried' | 'synth';
+/** What a reload cue played: its recording, the recording's fitted copy (game-audio/fitted, while the files load or where they are missing), nothing (another cue's recording carries it), or the synthesized steps. */
+type CuePlayed = 'sample' | 'fitted' | 'carried' | 'synth';
 /** What sounded for a shot: the recorded takes (`sample`, with the take of each layer) or the synthesized layers (`synth`). */
 type GunshotPlayed = {
     readonly kind: 'synth';
+} | {
+    readonly kind: 'fitted';
+    readonly id: string;
 } | {
     readonly kind: 'sample';
     readonly id: string;
@@ -829,7 +841,7 @@ interface WeaponAudioOptions extends ShotSoundOptions {
     /** Told each gunshot played (profile, take, pitch, space, distance), so a host can log what sounded. */
     readonly onGunshot?: (shot: Gunshot, input: GunshotInput, played: GunshotPlayed) => void;
     /** Told each case that lands (floor, case type, sample id). */
-    readonly onCasing?: (sound: CasingSound, played: 'sample' | 'synth') => void;
+    readonly onCasing?: (sound: CasingSound, played: 'sample' | 'fitted' | 'synth') => void;
     /** Seed of the noise buffer, of the start point in it and of the casing pitch: same seed, same sound. Default 1. */
     readonly seed?: number;
     /** Replaces or adds mechanical sounds by id. */
@@ -888,8 +900,8 @@ interface WeaponAudio {
     flyby(input: FlybyInput & {
         readonly position?: readonly [number, number, number];
     }): void;
-    /** A magazine landing on the floor. */
-    thud(): void;
+    /** A magazine landing on the floor: the floor material, the speed and which bounce (all optional). */
+    thud(input?: MagazineDropInput): void;
     /** Master volume, 0 to 1. */
     setVolume(volume: number): void;
     dispose(): void;
@@ -1057,22 +1069,6 @@ interface StockMove {
     axis: 'x' | 'y' | 'z';
     travel: number;
 }
-
-/** One weapon of the gallery as `data/models.json` keeps it: the builder, the measures in mm and the builder's options. */
-interface ModelEntry {
-    readonly builder: 'pistol' | 'revolver' | 'rifle' | 'bullpup' | 'p90' | 'break' | 'm2' | 'm134' | 'launcher';
-    readonly caliber: string;
-    readonly length: number;
-    readonly barrel: number;
-    readonly options: ModelOptions;
-    readonly variantOf?: string;
-}
-declare const MODEL_ENTRIES: Readonly<Record<string, ModelEntry>>;
-/**
- * The model each generic archetype wears: the one of the first brand weapon (lowest id) that points to it with `archetype` and fires the same way (a rocket launcher that points to
- * `shotgun_pump_12` does not lend its tube to the shotgun). An archetype nothing points to, the melee weapons and the bow keep their simple prop.
- */
-declare const ARCHETYPE_MODELS: Readonly<Record<string, string>>;
 /** A weapon model: `root` (the page's `wr`) holds `inner` (what the builder made, fitted to the real length); `parts` are pivots and marks inside `inner`. */
 interface WeaponModel {
     readonly id: string;
@@ -1080,9 +1076,6 @@ interface WeaponModel {
     readonly inner: THREE_NS.Group;
     readonly parts: ModelParts;
 }
-declare const hasWeaponModel: (id: string) => boolean;
-/** The gallery model of a weapon (or of the brand weapon an archetype wears, see `ARCHETYPE_MODELS`), long axis along +x, rear at the origin; undefined for melee, throwables and what nothing drew. */
-declare function buildWeaponModelById(THREE: typeof THREE_NS, id: string): WeaponModel | undefined;
 
 type Three = typeof THREE_NS;
 type Material = THREE_NS.Material;
@@ -1122,6 +1115,11 @@ declare const createMaterials: (THREE: Three) => {
     tape: THREE_NS.MeshStandardMaterial;
     pipe: THREE_NS.MeshStandardMaterial;
     green: THREE_NS.MeshStandardMaterial;
+    /** Explosive finishes: the molotov's bottle, the dynamite's paper, the C4's putty and the detonator's wire. */
+    bottle: THREE_NS.MeshStandardMaterial;
+    dynamite: THREE_NS.MeshStandardMaterial;
+    c4: THREE_NS.MeshStandardMaterial;
+    wire: THREE_NS.MeshStandardMaterial;
     /** Magazine finishes named by the options. */
     bakelite: THREE_NS.MeshStandardMaterial;
     polyMag: THREE_NS.MeshStandardMaterial;
@@ -1283,6 +1281,8 @@ interface WeaponFxOptions {
     contact?: LaserRaycast;
     /** Where the body holds the tool (`ModuleHost.holdFrame`): third person draws it there at its real size. */
     bodyHold?: () => HandPose | null;
+    /** Whether the view is the player's own eye: the gallery's guns are then framed in the view (`VIEW_HOLD`) instead of held on the body. */
+    firstPerson?: () => boolean;
     /** The host's effects: the muzzle flash, smoke, backblast and flame jet of the gallery models are recipes it plays; without it the viewmodel makes a world of its own for them. */
     effects?: EffectSink;
     /** The most casings and magazines alive at once (`host.particleLimit`), read at each spawn; without it the viewmodel keeps a cap of its own. */
@@ -1302,6 +1302,8 @@ interface WeaponFx {
     setCondition(condition: string): void;
     /** Where the hands take the weapon (world space, read every frame after `update`): the grip and the forend of the model, or the handle of the generic prop; null with nothing in the hands. */
     handTargets(): HandTargets | null;
+    /** The muzzle of the weapon in the hands as drawn now (world space): the gallery model's mark, or the front of the generic prop; null for a tool that fires no shot. */
+    muzzle(): MuzzlePose | null;
     /** What is drawn (casings, magazines, muzzle flash): change a field and the next event follows it. */
     readonly layers: FxLayers;
     /** Weapon shown in the hands, or null. */
@@ -1342,8 +1344,14 @@ interface WeaponProps {
     /** `buildItemWeaponModel` with this set's overrides. */
     buildItemModel(THREE: typeof THREE_NS, def: Pick<WeaponDef, 'id'>, items?: ItemModels): THREE_NS.Group | undefined;
     /** `buildWeaponModel` with this set's overrides. */
-    buildModel(THREE: typeof THREE_NS, def: Pick<WeaponDef, 'id' | 'category' | 'mass'>, items?: ItemModels): THREE_NS.Group;
+    buildModel(THREE: typeof THREE_NS, def: WeaponModelDef, items?: ItemModels): THREE_NS.Group;
 }
+/** What a weapon model is drawn from: the id, the category and mass of the low-poly prop, and the action that names a throwable's explosive. */
+type WeaponModelDef = Pick<WeaponDef, 'id' | 'category' | 'mass'> & Partial<Pick<WeaponDef, 'action'>>;
+/** The gallery model of the explosive a throwable carries (the frag grenade's M67, the molotov, the dynamite...), or undefined for any other weapon. */
+/** Whether the gallery drew the explosive a throwable carries. */
+declare const hasThrowableModel: (def: Partial<Pick<WeaponDef, "action">>) => boolean;
+declare const buildThrowableModel: (THREE: typeof THREE_NS, def: Partial<Pick<WeaponDef, "action">>) => THREE_NS.Group | undefined;
 /** The set behind `registerWeaponItemModel`, `itemModelOfWeapon`, `buildItemWeaponModel` and `buildWeaponModel`, created on first use. */
 declare const defaultWeaponProps: () => WeaponProps;
 /** @deprecated use `createWeaponProps(...).register`. */
@@ -1357,8 +1365,8 @@ declare const itemModelOfWeapon: (weaponId: string, items?: ItemModels) => strin
  * @deprecated use `createWeaponProps(...).buildItemModel`.
  */
 declare const buildItemWeaponModel: (THREE: typeof THREE_NS, def: Pick<WeaponDef, "id">, items?: ItemModels) => THREE_NS.Group | undefined;
-/** The model of a weapon for the hands or a shelf: the team's item model when the kit has one (`buildItemWeaponModel`), the low-poly prop the counters show otherwise. @deprecated use `createWeaponProps(...).buildModel`. */
-declare const buildWeaponModel: (THREE: typeof THREE_NS, def: Pick<WeaponDef, "id" | "category" | "mass">, items?: ItemModels) => THREE_NS.Group;
+/** The model of a weapon for the hands or a shelf: the team's item model when the kit has one (`buildItemWeaponModel`), the gallery model of a throwable's explosive, the low-poly prop the counters show otherwise. @deprecated use `createWeaponProps(...).buildModel`. */
+declare const buildWeaponModel: (THREE: typeof THREE_NS, def: WeaponModelDef, items?: ItemModels) => THREE_NS.Group;
 
 interface WeaponsTestModuleOptions {
     /** `en` or `pt-BR` (default). */
@@ -1384,7 +1392,7 @@ interface WeaponsTestModuleOptions {
     /** The weapon item model overrides to draw with (`createWeaponProps(...)`); default the shared set behind `registerWeaponItemModel`. */
     props?: WeaponProps;
 }
-/** Prefix of the item ids of the weapon props (`weapon_pistol_9mm`). */
+/** Prefix of the item ids of the weapon props (`weapon_beretta_92fs`). */
 declare const WEAPON_ITEM_PREFIX = "weapon_";
 declare const COUNTER_ITEM_ID = "counter_weapons";
 declare const MOUNTED_M134_ITEM_ID = "m134_tripod";
@@ -1544,6 +1552,12 @@ interface ExplosivesRoom {
     };
     readonly renderer: {
         impulse(objectId: string, impulse: Vec3$1, point?: Vec3$1): void;
+        /** World boxes of what is drawn around (x, z) (game-destruction-three `solidsNear`). */
+        solidsNear?(x: number, z: number, radius: number): ReadonlyArray<{
+            readonly objectId: string;
+            readonly min: Vec3$1;
+            readonly max: Vec3$1;
+        }>;
     };
     readonly vfx: {
         spawn(kind: string, point: Vec3$1, velocity: Vec3$1, options?: {
@@ -1699,4 +1713,4 @@ declare function createExplosivesTestModule(options?: ExplosivesTestModuleOption
     readonly bench: ReturnType<typeof createExplosivesBench>;
 };
 
-export { type ShotSoundOptions as $, type AttachmentModelRegistry as A, type GunshotInput as B, CLASS_REFERENCE_ENERGY as C, DEFAULT_ENERGY_CURVE as D, EXPLOSIVES_AREA_ID as E, type FlybySound as F, GAME_DISTANCE_CURVE as G, type GunshotPlayed as H, type ItemModels as I, type ItemModelRequest as J, MECHANICAL_SOUNDS as K, type LaserRaycast as L, type ModelKit as M, MODEL_ENTRIES as N, MOUNTED_M134_ITEM_ID as O, type MechanicalSoundId as P, type ModelEntry as Q, type ModelMaterials as R, type ModelOptions as S, type MountFrame as T, RELOAD_SAMPLE as U, RELOAD_SAMPLE_HITS as V, type WeaponProps as W, type ShotExtras as X, type ShotSound as Y, type ShotSoundClass as Z, type ShotSoundInput as _, type WeaponItemModel as a, type SoundClassDef as a0, type SoundStep as a1, WEAPON_ITEM_PREFIX as a2, WEIGHT_INTENSITY as a3, type WeaponAudio as a4, type WeaponAudioOptions as a5, type WeaponFx as a6, type WeaponFxOptions as a7, type WeaponSampleOptions as a8, type WeaponsTestModuleOptions as a9, buildItemWeaponModel as aa, buildWeaponModel as ab, buildWeaponModelById as ac, computeCasingSound as ad, computeFlyby as ae, computeGunshot as af, computeShotSound as ag, createExplosivesTestModule as ah, createWeaponAudio as ai, createWeaponFx as aj, createWeaponsTestModule as ak, defaultWeaponProps as al, deriveFrames as am, explosivesTextOf as an, hasWeaponModel as ao, itemModelOfWeapon as ap, mechanicalSoundOf as aq, modelKit as ar, mountFrame as as, registerWeaponItemModel as at, weaponSampleBank as au, weaponSampleDefaults as av, weaponsLayout as aw, type WeaponModel as b, type ModelParts as c, type ModelFamily as d, ARCHETYPE_MODELS as e, type AttachmentBuildContext as f, type AttachmentModel as g, type AttachmentModelBuilder as h, COUNTER_ITEM_ID as i, CUES_IN_SAMPLE as j, type CasingSound as k, type CuePlayed as l, DEFAULT_EXPLOSIVES_SCENE as m, type DistanceCurve as n, EXPLOSIVES_TEXT as o, type EnergyCurve as p, type ExplosivesRoom as q, type ExplosivesScene as r, type ExplosivesTestModuleOptions as s, type ExplosivesText as t, type FxLayers as u, GAME_SOUND_CLASSES as v, GUNSHOT_PROFILES as w, GUNSHOT_SAMPLE as x, GUNSHOT_SAMPLE_IDS as y, type Gunshot as z };
+export { WEAPON_ITEM_PREFIX as $, type AttachmentModelRegistry as A, type GunshotInput as B, CLASS_REFERENCE_ENERGY as C, DEFAULT_ENERGY_CURVE as D, EXPLOSIVES_AREA_ID as E, type FlybySound as F, GAME_DISTANCE_CURVE as G, type GunshotPlayed as H, type ItemModels as I, type ItemModelRequest as J, MECHANICAL_SOUNDS as K, type LaserRaycast as L, type ModelOptions as M, MOUNTED_M134_ITEM_ID as N, type MechanicalSoundId as O, type ModelMaterials as P, type MountFrame as Q, RELOAD_SAMPLE as R, RELOAD_SAMPLE_HITS as S, type ShotExtras as T, type ShotSound as U, type ShotSoundClass as V, type WeaponProps as W, type ShotSoundInput as X, type ShotSoundOptions as Y, type SoundClassDef as Z, type SoundStep as _, type WeaponItemModel as a, WEIGHT_INTENSITY as a0, type WeaponAudio as a1, type WeaponAudioOptions as a2, type WeaponFx as a3, type WeaponFxOptions as a4, type WeaponModelDef as a5, type WeaponSampleOptions as a6, type WeaponsTestModuleOptions as a7, buildItemWeaponModel as a8, buildThrowableModel as a9, buildWeaponModel as aa, computeCasingSound as ab, computeFlyby as ac, computeGunshot as ad, computeShotSound as ae, createExplosivesTestModule as af, createWeaponAudio as ag, createWeaponFx as ah, createWeaponsTestModule as ai, defaultWeaponProps as aj, deriveFrames as ak, explosivesTextOf as al, hasThrowableModel as am, itemModelOfWeapon as an, mechanicalSoundOf as ao, modelKit as ap, mountFrame as aq, registerWeaponItemModel as ar, weaponSampleBank as as, weaponSampleDefaults as at, weaponsLayout as au, type WeaponModel as b, type ModelKit as c, type ModelParts as d, type ModelFamily as e, type AttachmentBuildContext as f, type AttachmentModel as g, type AttachmentModelBuilder as h, COUNTER_ITEM_ID as i, CUES_IN_SAMPLE as j, type CasingSound as k, type CuePlayed as l, DEFAULT_EXPLOSIVES_SCENE as m, type DistanceCurve as n, EXPLOSIVES_TEXT as o, type EnergyCurve as p, type ExplosivesRoom as q, type ExplosivesScene as r, type ExplosivesTestModuleOptions as s, type ExplosivesText as t, type FxLayers as u, GAME_SOUND_CLASSES as v, GUNSHOT_PROFILES as w, GUNSHOT_SAMPLE as x, GUNSHOT_SAMPLE_IDS as y, type Gunshot as z };

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-export { i as COUNTER_ITEM_ID, m as DEFAULT_EXPLOSIVES_SCENE, E as EXPLOSIVES_AREA_ID, o as EXPLOSIVES_TEXT, q as ExplosivesRoom, r as ExplosivesScene, s as ExplosivesTestModuleOptions, t as ExplosivesText, O as MOUNTED_M134_ITEM_ID, a2 as WEAPON_ITEM_PREFIX, a9 as WeaponsTestModuleOptions, ah as createExplosivesTestModule, ak as createWeaponsTestModule, an as explosivesTextOf, aw as weaponsLayout } from './testing-DnPjEPC5.js';
+export { i as COUNTER_ITEM_ID, m as DEFAULT_EXPLOSIVES_SCENE, E as EXPLOSIVES_AREA_ID, o as EXPLOSIVES_TEXT, q as ExplosivesRoom, r as ExplosivesScene, s as ExplosivesTestModuleOptions, t as ExplosivesText, N as MOUNTED_M134_ITEM_ID, $ as WEAPON_ITEM_PREFIX, a7 as WeaponsTestModuleOptions, af as createExplosivesTestModule, ai as createWeaponsTestModule, al as explosivesTextOf, au as weaponsLayout } from './testing-CEcZ-zzz.js';
 import '@adatechnology/game-contracts';
 import '@adatechnology/game-weapons';
 import '@adatechnology/game-audio';

package/dist/testing.js

@@ -9,7 +9,7 @@ import {
   createWeaponsTestModule,
   explosivesTextOf,
   weaponsLayout
-} from "./chunk-XMVSA7UT.js";
+} from "./chunk-KWJQO6JS.js";
 export {
   COUNTER_ITEM_ID,
   DEFAULT_EXPLOSIVES_SCENE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-weapons-three",
-  "version": "0.14.2",
+  "version": "0.16.0",
   "license": "MIT AND CC-BY-SA-4.0 AND CC-BY-SA-3.0 AND CC-BY-3.0 AND CC0-1.0 AND LicenseRef-Public-Domain",
   "description": "three.js presentation for @adatechnology/game-weapons: the real models of the Galeria 3D do Arsenal (78 weapons, a cartridge and a case per calibre), the weapon in the hands playing the tool-animation clips (fire, burst, cycle, jam, clear, safety and the seven reloads), ejected casings and dropped magazines, worn-metal conditions, synthesized sounds, and the weapons test area (counters with every weapon) as a TestableModule.",
   "keywords": [
@@ -44,15 +44,15 @@
     "assets"
   ],
   "dependencies": {
-    "@adatechnology/game-audio": "^0.7.0",
-    "@adatechnology/game-contracts": "^0.24.0",
-    "@adatechnology/game-items-three": "^0.7.2",
-    "@adatechnology/game-floorplan-three": "^0.9.3",
+    "@adatechnology/game-audio": "^0.9.0",
+    "@adatechnology/game-contracts": "^0.26.0",
+    "@adatechnology/game-floorplan-three": "^0.10.1",
+    "@adatechnology/game-items-three": "^0.7.4",
     "@adatechnology/game-render-three": "^0.2.0",
     "@adatechnology/game-shapes-three": "^0.3.1",
-    "@adatechnology/game-vfx": "^0.7.0",
-    "@adatechnology/game-vfx-three": "^0.6.0",
-    "@adatechnology/game-weapons": "^0.6.0"
+    "@adatechnology/game-vfx": "^0.8.0",
+    "@adatechnology/game-vfx-three": "^0.7.1",
+    "@adatechnology/game-weapons": "^0.7.1"
   },
   "peerDependencies": {
     "three": "^0.160.0"
@@ -65,7 +65,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.7.3",
     "vitest": "^3.2.4",
-    "@adatechnology/game-test-room": "^0.25.2",
+    "@adatechnology/game-test-room": "^0.27.0",
     "@adatechnology/golden-tool": "^0.0.0"
   },
   "scripts": {