@adatechnology/game-weapons-three 0.17.0 → 0.18.0

package/dist/index.js

@@ -36,6 +36,7 @@ import {
   buildCasing,
   buildExplosiveModel,
   buildFlyingRocket,
+  buildHandheldModel,
   buildItemWeaponModel,
   buildModeledProp,
   buildProp,
@@ -60,6 +61,7 @@ import {
   explosivesTextOf,
   fitAttachmentModels,
   hasExplosiveModel,
+  hasHandheldModel,
   hasThrowableModel,
   hasWeaponModel,
   itemModelOfWeapon,
@@ -82,7 +84,7 @@ import {
   worldExplosiveItem,
   worldExplosiveShell,
   worldExplosiveValve
-} from "./chunk-BDYIF7JD.js";
+} from "./chunk-V47DJ55G.js";
 
 // src/projectile-model.ts
 import { markKitOrigin } from "@adatechnology/game-contracts";
@@ -151,6 +153,7 @@ export {
   buildCartridge,
   buildCasing,
   buildExplosiveModel,
+  buildHandheldModel,
   buildItemWeaponModel,
   buildModeledProp,
   buildProp,
@@ -176,6 +179,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-CRjxCHxK.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';
@@ -928,6 +928,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 +965,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 +981,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 +1015,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 +1045,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 +1107,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 +1139,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 +1305,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 +1326,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 +1341,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 +1365,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 +1396,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 +1762,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 { 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, buildHandheldModel as a8, buildItemWeaponModel as a9, buildThrowableModel as aa, buildWeaponModel as ab, computeCasingSound as ac, computeFlyby as ad, computeGunshot as ae, computeShotSound as af, createExplosivesTestModule as ag, createWeaponAudio as ah, createWeaponFx as ai, createWeaponsTestModule as aj, defaultWeaponProps as ak, deriveFrames as al, explosivesTextOf as am, hasHandheldModel as an, hasThrowableModel 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 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, N as MOUNTED_M134_ITEM_ID, $ as WEAPON_ITEM_PREFIX, a7 as WeaponsTestModuleOptions, ag as createExplosivesTestModule, aj as createWeaponsTestModule, am as explosivesTextOf, aw as weaponsLayout } from './testing-CRjxCHxK.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-V47DJ55G.js";
 export {
   COUNTER_ITEM_ID,
   DEFAULT_EXPLOSIVES_SCENE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-weapons-three",
-  "version": "0.17.0",
+  "version": "0.18.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.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.2",
+    "@adatechnology/game-floorplan-three": "^0.10.3",
+    "@adatechnology/game-contracts": "^0.28.0",
     "@adatechnology/game-render-three": "^0.2.0",
     "@adatechnology/game-shapes-three": "^0.3.1",
-    "@adatechnology/game-vfx": "^0.8.0",
-    "@adatechnology/game-weapons": "^0.8.0",
-    "@adatechnology/game-vfx-three": "^0.7.2"
+    "@adatechnology/game-vfx": "^0.10.0",
+    "@adatechnology/game-items-three": "^0.7.6",
+    "@adatechnology/game-vfx-three": "^0.7.4",
+    "@adatechnology/game-weapons": "^0.9.0"
   },
   "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.0",
+    "@adatechnology/game-test-room": "^0.29.0",
     "@adatechnology/golden-tool": "^0.0.0"
   },
   "scripts": {