@adatechnology/game-weapons-three 0.17.1 → 0.18.1

package/dist/index.js

@@ -16,6 +16,8 @@ import {
   GUNSHOT_PROFILES,
   GUNSHOT_SAMPLE,
   GUNSHOT_SAMPLE_IDS,
+  LAUNCH_SAMPLE,
+  LAUNCH_SOUND_IDS,
   MECHANICAL_SOUNDS,
   MODEL_ENTRIES,
   MOUNTED_M134_ITEM_ID,
@@ -36,6 +38,7 @@ import {
   buildCasing,
   buildExplosiveModel,
   buildFlyingRocket,
+  buildHandheldModel,
   buildItemWeaponModel,
   buildModeledProp,
   buildProp,
@@ -60,6 +63,7 @@ import {
   explosivesTextOf,
   fitAttachmentModels,
   hasExplosiveModel,
+  hasHandheldModel,
   hasThrowableModel,
   hasWeaponModel,
   itemModelOfWeapon,
@@ -82,7 +86,7 @@ import {
   worldExplosiveItem,
   worldExplosiveShell,
   worldExplosiveValve
-} from "./chunk-BDYIF7JD.js";
+} from "./chunk-4HWHC6US.js";
 
 // src/projectile-model.ts
 import { markKitOrigin } from "@adatechnology/game-contracts";
@@ -133,6 +137,8 @@ export {
   GUNSHOT_PROFILES,
   GUNSHOT_SAMPLE,
   GUNSHOT_SAMPLE_IDS,
+  LAUNCH_SAMPLE,
+  LAUNCH_SOUND_IDS,
   MECHANICAL_SOUNDS,
   MODEL_ENTRIES,
   MOUNTED_M134_ITEM_ID,
@@ -151,6 +157,7 @@ export {
   buildCartridge,
   buildCasing,
   buildExplosiveModel,
+  buildHandheldModel,
   buildItemWeaponModel,
   buildModeledProp,
   buildProp,
@@ -176,6 +183,7 @@ export {
   explosivesTextOf,
   fitAttachmentModels,
   hasExplosiveModel,
+  hasHandheldModel,
   hasThrowableModel,
   hasWeaponModel,
   itemModelOfWeapon,

package/dist/index.js.map

@@ -1 +1 @@
-{"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":[]}
+{"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-BKDGK6cq.d.ts → testing-I8H8oNSD.d.ts}

@@ -1,4 +1,4 @@
-import { HostTool, HandPose, EffectSink, HostEvent, HandTargets, MuzzlePose, TestableModule, AreaPlacement, DestructionEvent, Hit, Vec3 as Vec3$1, ModuleControl, ModuleLayer, ModuleMetric, ModuleHost } from '@adatechnology/game-contracts';
+import { HostTool, HandPose, EffectSink, ToolHand, 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';
@@ -784,6 +784,8 @@ declare const GUNSHOT_SAMPLE_IDS: readonly string[];
  * by shot.
  */
 declare const GUNSHOT_SAMPLE: SampleDefaults;
+/** A launcher firing (`launcher_40mm`, `rocket_launch`): a near take only, carried far like a shot but below its level. */
+declare const LAUNCH_SAMPLE: SampleDefaults;
 /** A reload step: heard at the hands, about a third of a shot's level after the converter's peak normalization. */
 declare const RELOAD_SAMPLE: SampleDefaults;
 /** Seconds from the start of each recorded reload step to its hit (`data/reload-sample-hits.json`, measured on the files). */
@@ -902,10 +904,19 @@ interface WeaponAudio {
     }): void;
     /** A magazine landing on the floor: the floor material, the speed and which bounce (all optional). */
     thud(input?: MagazineDropInput): void;
+    /**
+     * A launcher firing: the "thoomp" of a 40 mm grenade leaving the tube (`grenade`) or the roar of a rocket leaving it (`rocket`), at `distance`
+     * metres. The host's recording (`LAUNCH_SOUND_IDS`) once it is loaded; a synthesized thump or whoosh until then, never the blast of an explosion.
+     */
+    launch(kind: LaunchKind, volume?: number, distance?: number): void;
     /** Master volume, 0 to 1. */
     setVolume(volume: number): void;
     dispose(): void;
 }
+/** What leaves a launcher: a 40 mm grenade (M79, M32, M203) or a rocket (RPG-7, AT4, Carl Gustaf). */
+type LaunchKind = 'grenade' | 'rocket';
+/** The recorded sound of each launch (game-audio's sfx manifest, category armas). */
+declare const LAUNCH_SOUND_IDS: Readonly<Record<LaunchKind, string>>;
 declare function createWeaponAudio(volume?: number, options?: WeaponAudioOptions): WeaponAudio;
 
 /** What the bench turns on or off in the presentation of the weapon: the ejected casings, the dropped magazines, the muzzle flash, the accessory models and the light and laser beams. */
@@ -928,6 +939,8 @@ interface ModelOptions {
     h?: number;
     gl?: number;
     deagle?: number;
+    /** A pistol drawn from its photo instead of by style: `p320`, `usp` or `p99` (see `pistol-design.ts`). */
+    design?: string;
     /** Metal and furniture finish. */
     steel?: number;
     stain?: number;
@@ -963,6 +976,8 @@ interface ModelOptions {
     ar?: number;
     ak?: number;
     g3?: number;
+    /** The Heckler & Koch G36 family: its polymer receiver, skeletal stock (`stock: 'g36'`), handguard, and on top the carry handle with optics (`carry`) or the long rail. */
+    g36?: number;
     charge?: number;
     rail?: number;
     jacket?: number;
@@ -977,10 +992,16 @@ interface ModelOptions {
     heat?: number;
     /** Chambers of the revolver cylinder (default 6): the capacity of the weapon. */
     chambers?: number;
+    /** The Colt Python: ventilated rib, full underlug, walnut grip (see `revolver-python.ts`). */
+    python?: number;
     bayo?: number;
     rod?: number;
     bands?: number;
     shot?: number;
+    /** The body a bullpup is drawn with when it is not the Steyr AUG (`famas`, `tavor`, `sa80`). */
+    look?: string;
+    /** The Winchester 1887 lever-action shotgun (its own receiver, lever loop and stock). */
+    m1887?: number;
     /** Launcher type: `rpg`, `m72`, `at4`, `carl`, `flame`, `flameDIY`. */
     lt?: string;
 }
@@ -1005,7 +1026,7 @@ interface ModelFrames {
     underbarrel?: readonly [number, number];
 }
 /** The moving mechanism of a model, which picks its fire, reload and clear motion. */
-type ModelFamily = 'pistol' | 'revolver' | 'rifle' | 'semiint' | 'semi12' | 'p90' | 'belt' | 'pump' | 'lever' | 'bolt' | 'boltmag' | 'break' | 'rocket' | 'flame';
+type ModelFamily = 'pistol' | 'revolver' | 'rifle' | 'semiint' | 'semi12' | 'p90' | 'belt' | 'pump' | 'lever' | 'bolt' | 'boltmag' | 'break' | 'rocket' | 'flame' | 'cylinder';
 /** The named parts a model exposes to the animation: pivots and marks inside the model, never copies. */
 interface ModelParts {
     family: ModelFamily;
@@ -1035,6 +1056,8 @@ interface ModelParts {
     cover?: THREE_NS.Object3D;
     crane?: THREE_NS.Object3D;
     cylinder?: THREE_NS.Object3D;
+    /** The vertical grip under the barrel where the support hand takes a long gun that has one (the MGL). */
+    foreGrip?: THREE_NS.Object3D;
     chambers?: THREE_NS.Object3D[];
     barrels?: THREE_NS.Object3D;
     breech?: THREE_NS.Object3D[];
@@ -1095,6 +1118,7 @@ declare const createMaterials: (THREE: Three) => {
     olive: THREE_NS.MeshStandardMaterial;
     tan: THREE_NS.MeshStandardMaterial;
     wood: THREE_NS.MeshStandardMaterial;
+    beech: THREE_NS.MeshStandardMaterial;
     woodL: THREE_NS.MeshStandardMaterial;
     brass: THREE_NS.MeshStandardMaterial;
     copper: THREE_NS.MeshStandardMaterial;
@@ -1126,9 +1150,14 @@ declare const createMaterials: (THREE: Three) => {
     dynamite: THREE_NS.MeshStandardMaterial;
     c4: THREE_NS.MeshStandardMaterial;
     wire: THREE_NS.MeshStandardMaterial;
+    /** The Semtex putty and the green band of an M18 smoke canister. */
+    semtex: THREE_NS.MeshStandardMaterial;
+    smokeBand: THREE_NS.MeshStandardMaterial;
+    cellophane: THREE_NS.MeshStandardMaterial;
     /** Magazine finishes named by the options. */
     bakelite: THREE_NS.MeshStandardMaterial;
     polyMag: THREE_NS.MeshStandardMaterial;
+    smoke: THREE_NS.MeshStandardMaterial;
 };
 type ModelMaterials = ReturnType<typeof createMaterials>;
 /**
@@ -1287,6 +1316,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;
+    /** Where the body holds a tool in the left hand (`ModuleHost.holdFrame('L')`), for the left hand's weapon with a weapon in each hand; without it, a body's left shoulder under the eye. */
+    leftBodyHold?: () => 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 lens the host draws the first-person layer with (`ModuleHost.setViewmodelFov`): the gun in the hands sets the one of its family, and null when it leaves the view. */
@@ -1306,6 +1337,10 @@ interface WeaponFxOptions {
     lights?: LightBudget;
     /** The host's pools (`host.pools`): the burning droplets and the ground flames of a flamethrower take their geometry and material from them; without them each makes its own (deprecated, removed in the next major). */
     pools?: RenderPools;
+    /** The hand this presentation draws the tool in (default `R`); `L` is the left hand's tool with a tool in each hand (`HostTool.offHand`): held out to the left, the hand on the mirror of the grip. */
+    hand?: ToolHand;
+    /** True while the other hand holds a tool of its own: the tool is held in this hand alone, out to its side, and never brought to the eye. */
+    oneHand?: () => boolean;
 }
 
 /** The weapon in the hands, its fire and reload motion, ejected casings and dropped magazines, and their sounds. */
@@ -1317,12 +1352,17 @@ 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;
+    /**
+     * 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. `hand: 'L'` is the
+     * one of the left hand's weapon with a weapon in each hand.
+     */
+    muzzle(hand?: ToolHand): 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. */
     readonly inHand: string | null;
+    /** Weapon shown in the left hand with a weapon in each hand (`HostTool.offHand`), or null. */
+    readonly inLeftHand: string | null;
     /** The clips of the model playing now with the seconds each lasts (scaled to the rule's duration): which reload variant went (`reload` or `reload_empty`...). */
     readonly clips: ReadonlyArray<{
         name: string;
@@ -1336,6 +1376,7 @@ interface WeaponFx {
 /**
  * The presentation of the tool in the hands. The weapons the gallery drew (`MODEL_ENTRIES`) get their model and the clips the rule's events call for
  * (fire, cycle, jam, clear, safety, the seven reloads); the generic archetypes keep their low-poly prop.
+ * With a tool in each hand (`HostTool.offHand`, events with `hand: 'L'`) the left hand gets presentations of its own.
  */
 declare function createWeaponFx(options: WeaponFxOptions): WeaponFx;
 
@@ -1366,6 +1407,10 @@ type WeaponModelDef = Pick<WeaponDef, 'id' | 'category' | 'mass'> & Partial<Pick
 /** 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;
+/** Whether the kit drew the melee weapon itself (the KA-BAR, the katana, the brass knuckles). */
+declare const hasHandheldModel: (def: Pick<WeaponDef, "id">) => boolean;
+/** The model of a melee weapon the kit drew, lying as the item models do (see `buildMeleeModel`), or undefined for any other weapon. */
+declare const buildHandheldModel: (THREE: typeof THREE_NS, def: Pick<WeaponDef, "id">) => THREE_NS.Group | undefined;
 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;
@@ -1728,4 +1773,4 @@ declare function createExplosivesTestModule(options?: ExplosivesTestModuleOption
     readonly bench: ReturnType<typeof createExplosivesBench>;
 };
 
-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 };
+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, LAUNCH_SAMPLE as K, type LaserRaycast as L, type ModelOptions as M, LAUNCH_SOUND_IDS as N, type LaunchKind as O, MECHANICAL_SOUNDS as P, MOUNTED_M134_ITEM_ID as Q, type MechanicalSoundId as R, type ModelMaterials 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 WeaponModelDef as a8, type WeaponSampleOptions as a9, type WeaponsTestModuleOptions as aa, buildHandheldModel as ab, buildItemWeaponModel as ac, buildThrowableModel as ad, buildWeaponModel as ae, computeCasingSound as af, computeFlyby as ag, computeGunshot as ah, computeShotSound as ai, createExplosivesTestModule as aj, createWeaponAudio as ak, createWeaponFx as al, createWeaponsTestModule as am, defaultWeaponProps as an, deriveFrames as ao, explosivesTextOf as ap, hasHandheldModel as aq, hasThrowableModel as ar, itemModelOfWeapon as as, mechanicalSoundOf as at, modelKit as au, mountFrame as av, registerWeaponItemModel as aw, weaponSampleBank as ax, weaponSampleDefaults as ay, weaponsLayout as az, 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, 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-BKDGK6cq.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, Q as MOUNTED_M134_ITEM_ID, a2 as WEAPON_ITEM_PREFIX, aa as WeaponsTestModuleOptions, aj as createExplosivesTestModule, am as createWeaponsTestModule, ap as explosivesTextOf, az as weaponsLayout } from './testing-I8H8oNSD.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-BDYIF7JD.js";
+} from "./chunk-4HWHC6US.js";
 export {
   COUNTER_ITEM_ID,
   DEFAULT_EXPLOSIVES_SCENE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-weapons-three",
-  "version": "0.17.1",
+  "version": "0.18.1",
   "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.9.1",
-    "@adatechnology/game-contracts": "^0.27.0",
-    "@adatechnology/game-floorplan-three": "^0.10.2",
-    "@adatechnology/game-items-three": "^0.7.5",
+    "@adatechnology/game-audio": "^0.9.3",
+    "@adatechnology/game-contracts": "^0.29.0",
+    "@adatechnology/game-floorplan-three": "^0.11.0",
+    "@adatechnology/game-items-three": "^0.7.7",
     "@adatechnology/game-render-three": "^0.2.0",
     "@adatechnology/game-shapes-three": "^0.3.1",
-    "@adatechnology/game-vfx": "^0.9.0",
-    "@adatechnology/game-vfx-three": "^0.7.3",
-    "@adatechnology/game-weapons": "^0.8.0"
+    "@adatechnology/game-vfx": "^0.10.1",
+    "@adatechnology/game-vfx-three": "^0.7.5",
+    "@adatechnology/game-weapons": "^0.9.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.28.1",
+    "@adatechnology/game-test-room": "^0.29.1",
     "@adatechnology/golden-tool": "^0.0.0"
   },
   "scripts": {