@adatechnology/game-contracts 0.23.0 → 0.25.0

package/dist/index.d.ts

@@ -92,6 +92,8 @@ interface PartSpec {
         radius: number;
         /** Inside this radius (metres) the blast is lethal to a body; from here to `radius` it only hurts, less with distance. Without it a body takes the energy falling off over `radius`. */
         lethalRadius?: number;
+        /** Kilograms of TNT equivalent of the burst: the blast wave that pushes bodies is read from it (`knockOf`). */
+        tnt?: number;
         atC?: number;
         /**
          * Chain reaction: what sets the part off before it is destroyed and the seconds from that to the blast (a number, or `[min, max]` drawn
@@ -757,6 +759,7 @@ type DestructionEvent = (EventBase & {
     energy: number;
     radius: number;
     lethalRadius?: number;
+    tnt?: number;
     effect?: string;
 })
 /** An explosive part was set off by a bullet, fire or a nearby blast and will explode `delay` seconds from now (`explodes.chain`). */
@@ -832,6 +835,8 @@ type DestructionEvent = (EventBase & {
  * One unit of a wall of units (`PartSpec.units`: a brick, a block) came out under shots or blows: `center` in world space, `size` in the part's own
  * axes and `rotation` the part's world rotation (the box of the unit that left), `fragments` the unit itself. The part stays: draw the gap, do not hide it.
  * With `torn`, nothing left the part but what a blow tore off its face (splinters of wood, lumps of MDF): the hole and the marks around it stay drawn.
+ * With `units`, a blast knocked many units out at once: each one's box (`center` in world space, `size` in the part's axes, turned by `rotation`), and
+ * `center` and `size` are the box around them all.
  */
  | (EventBase & {
     type: 'chip';
@@ -841,6 +846,10 @@ type DestructionEvent = (EventBase & {
     rotation: Quat;
     fragments: readonly Fragment[];
     torn?: true;
+    units?: readonly {
+        center: Vec3;
+        size: Vec3;
+    }[];
 })
 /** Rebar of a reinforced part is bare: segments in world space. Empty `bars` means the cage is gone. */
  | (EventBase & {
@@ -969,6 +978,13 @@ interface BlastSource {
     readonly energy: number;
     readonly radius: number;
     readonly reach?: number;
+    /**
+     * Kilograms of TNT equivalent of the charge. With it a body is pushed by the blast wave itself (`blast-impulse`), and the shove of loose items keeps this module's rule; without it the body
+     * takes the charge from `energy` by `BlastImpulseOptions.tntPerJoule`.
+     */
+    readonly tnt?: number;
+    /** Inside this radius (metres) the blast is lethal: a body there that the blast reaches (not behind cover) goes down, wounded, wherever the wave pushed it. */
+    readonly lethalRadius?: number;
 }
 /** What a blast does to one body: how fast it leaves (m/s), the unit direction it leaves in, and how far from the centre it was. */
 interface BlastShove {
@@ -980,7 +996,7 @@ interface BlastShove {
 }
 /**
  * The shove a blast gives to a body of `mass` kg whose centre is at `position`: away from the centre, lifted a little, with the speed
- * `min(maxSpeed, sqrt(2 * energy * reach * coupling / mass)) * (1 - distance / radius) ^ 2`. Undefined when the body is outside the radius or the speed is under `minSpeed`.
+ * `sqrt(reach) * min(maxSpeed, sqrt(2 * energy * coupling / mass)) * (1 - distance / radius) ^ 2`. Undefined when the body is outside the radius or the speed is under `minSpeed`.
  * The same rule moves the loose items and furniture of the test room and the people of the characters module, so a game that tunes the options tunes all of them.
  */
 declare function blastShove(blast: BlastSource, target: {
@@ -988,10 +1004,45 @@ declare function blastShove(blast: BlastSource, target: {
     readonly mass: number;
 }, options?: BlastShoveOptions): BlastShove | undefined;
 
+/**
+ * The push a blast gives a standing body, from the physics of the blast wave and not from a game coupling: the impulse of the wave per square metre at a distance from a charge of
+ * `tnt` kg of TNT equivalent (Kinney and Graham's fit of the side-on impulse, scaled by the cube root of the charge), reflected on the body, over the area the body shows the wave,
+ * divided by its mass. A hand grenade at 3 m gives a person a few tenths of a metre per second; what floors that person is the fragments, not the wave. A big charge close throws.
+ */
+/** The numbers of the body a blast wave pushes. All have a default for a standing adult. */
+interface BlastImpulseOptions {
+    /** Square metres of the body the wave meets: about 1.75 m tall by 0.4 m wide (default 0.7). */
+    readonly bodyArea?: number;
+    /** How much of the push goes up: the direction is `(away, lift)` normalised (default 0.15: the wave runs along the ground). */
+    readonly lift?: number;
+    /** Below this speed (m/s) the body does not move (default 0.3). */
+    readonly minSpeed?: number;
+    /**
+     * Kilograms of TNT per joule of the blast `energy`, for a blast that does not say its charge (`BlastSource.tnt`). Default 0.24 / 200000: the arsenal's energy scale, where the M67 (180 g
+     * of Composition B, 0.24 kg of TNT) is 200 kJ. It is a game equivalence for blasts without a charge, not a physical constant.
+     */
+    readonly tntPerJoule?: number;
+}
+declare const DEFAULT_BLAST_IMPULSE: Readonly<Required<BlastImpulseOptions>>;
+/**
+ * Side-on (incident) specific impulse of the wave, in Pa·s, at `distance` metres from `tnt` kg of TNT in free air: Kinney and Graham, "Explosive Shocks in Air" (1985),
+ * `I/W^(1/3) = 0.067 sqrt(1 + (Z/0.23)^4) / (Z^2 (1 + (Z/1.55)^3)^(1/3))` bar·ms per kg^(1/3), with the scaled distance `Z = R / W^(1/3)`.
+ */
+declare function sideOnImpulse(tnt: number, distance: number): number;
+/**
+ * The impulse per square metre a body facing the wave takes, Pa·s: the side-on impulse reflected. The reflection doubles a weak wave and grows up to about six times close to the charge,
+ * where the wave is strong (the ratio of reflected to side-on impulse of the Kingery-Bulmash charts, fitted as `2 + 4 / (1 + Z^2)`).
+ */
+declare function bodyImpulse(tnt: number, distance: number): number;
+/** The speed (m/s) a blast wave gives a free body of `mass` kg at `distance` metres from `tnt` kg of TNT, `reach` (0..1) of it getting through what stands in the way. */
+declare function blastBodySpeed(tnt: number, distance: number, mass: number, reach?: number, options?: BlastImpulseOptions): number;
+
 /** From this speed (m/s) a blast takes a standing body off its feet. Below it the body is only pushed. */
 declare const KNOCK_DOWN_SPEED = 2.5;
 /** The angle of a body lying where it fell (the same tilt a dead body takes). */
 declare const KNOCKED_DOWN_ANGLE = 1.35;
+/** The share of the blast that has to get through for its fragments to reach a body: behind cover that stops half of it the fragments stop too. */
+declare const FRAGMENT_COVER = 0.5;
 /** Height of the chest above the feet: where the blast takes the body. */
 declare const KNOCK_CHEST = 1.1;
 /** What a blast is doing to one body: its velocity (m/s), whether it is in the air, and how far down it is (0 on its feet, 1 lying). */
@@ -1004,14 +1055,23 @@ interface Knock {
     lieLeft: number;
     /** Knocked off its feet by this blast. */
     down: boolean;
+    /** Floored by its wounds: inside the lethal radius and not behind cover. It lies longer and falls where it stood. */
+    wounded?: boolean;
+    /** Seconds of stun the blast gave the body: dizziness and ringing ears. */
+    stunSeconds?: number;
+    /** The horizontal unit direction away from the blast, even when the push is too weak to move the body: the way it falls. */
+    away?: Vec3;
 }
 /** The mass of a body in kg from its height (m) and its build (1 = average): 70 kg at 1.75 m. */
 declare const bodyMass: (height: number, build?: number) => number;
 /**
- * What a blast does to a body standing at `feet`: the shove of `game-contracts` taken at the chest, a hop when it goes up, and a fall when it is strong enough. Undefined when the blast does not
- * reach it. The numbers are the host's (`ModuleHost.blastShove`), the same ones that throw its loose items.
+ * What a blast does to a body standing at `feet`, of `mass` kg. Undefined when the blast does not reach it or does nothing to it.
+ *
+ * The body is pushed by the blast wave (`blastBodySpeed`, from the charge `blast.tnt`, or from `energy` by `tntPerJoule`), taken at the chest and cut by `reach`, the share that got through
+ * cover. It is floored when that push is `KNOCK_DOWN_SPEED` or more, or when it stands inside `lethalRadius` with the blast reaching it (the fragments and the overpressure fell it where it
+ * stands). It is stunned for a while inside the radius. `options` are the shove numbers of the host's loose items; only their `minSpeed` applies to a body.
  */
-declare function knockOf(blast: BlastSource, feet: Vec3, mass: number, options?: BlastShoveOptions): Knock | undefined;
+declare function knockOf(blast: BlastSource, feet: Vec3, mass: number, options?: BlastShoveOptions, impulse?: BlastImpulseOptions): Knock | undefined;
 /**
  * Moves a body one step: it slides on the ground and slows, falls when it was knocked down, lies a while and gets up (a dead body stays down). Moves `position` in place; returns true when the
  * body is on its feet and still, and the knock can be dropped.
@@ -1021,6 +1081,17 @@ declare function stepKnock(knock: Knock, position: {
     y: number;
     z: number;
 }, dt: number, groundAt: (x: number, z: number) => number, alive: boolean): boolean;
+/**
+ * Throws a body at `velocity` (m/s, world): an occupant leaving a car through the glass, a pedestrian run over. The module that animates the body
+ * takes it on its next frame (`takeLaunch`) and moves it as it moves a body a blast knocked down: flying, landing, sliding, lying, getting up.
+ */
+declare function launchBody(root: {
+    userData: Record<string, unknown>;
+}, velocity: Vec3): void;
+/** The throw `launchBody` left on the root, as a knock (knocked down, in the air), once; undefined when nothing threw it. */
+declare function takeLaunch(root: {
+    userData: Record<string, unknown>;
+}): Knock | undefined;
 
 interface CostOptions {
     /** Reads of `state()` and of `describe()` to time. Default 10 000. */
@@ -1496,6 +1567,16 @@ interface HandTargets {
 }
 /** Read every frame by whoever draws the arms; answers null while nothing is held. */
 type HandTargetSource = () => HandTargets | null;
+/** The muzzle of the tool in the hands as it is drawn now (world space): where a shot's flash and tracer leave, and which way the barrel points. */
+interface MuzzlePose {
+    readonly position: Vec3;
+    /** Unit vector along the barrel, out of the muzzle. */
+    readonly direction: Vec3;
+    /** The module draws the muzzle flash itself: the host draws none of its own. */
+    readonly drawsFlash: boolean;
+}
+/** Read by the host at each shot; null while the tool in the hands has no muzzle (a knife, a bare hand). */
+type MuzzleSource = () => MuzzlePose | null;
 
 /** How a hand turns something round in strokes (a screw cap, a tap handle, a knob): what `twistStroke` answers for one moment of the turning. */
 interface TwistStroke {
@@ -2143,6 +2224,8 @@ interface AreaPlacement {
 interface GroundZone {
     readonly rect: readonly [number, number, number, number];
     readonly surface: string;
+    /** Sign a renderer lays on the front edge of the zone (the side of +z). */
+    readonly label?: string;
 }
 /** What the floor is made of. `surface` is a ground profile id (`lawn`, `road`, `concrete_slab`, `tile_floor`...); a host that does not know it uses its default. */
 interface GroundLayout {
@@ -2290,6 +2373,10 @@ type HostEvent =
     radius: number;
     cause: string;
     explosive?: string;
+    /** Kilograms of TNT equivalent of the charge, when the explosive says it: the blast wave that pushes bodies is read from it (`knockOf`). */
+    tnt?: number;
+    /** Inside this radius (metres) the blast is lethal to a body it reaches. */
+    lethalRadius?: number;
 }
 /** The player crouched or stood up, or the camera mode changed; read the new state with `host.player()`. */
  | {
@@ -2499,6 +2586,11 @@ interface ModuleHost {
      * frame hooks have run, and puts the hands there. Pass null (or call the returned function) to let go. A host without arms leaves it out.
      */
     setHandTargets?(source: HandTargetSource | null): () => void;
+    /**
+     * Lends the host the muzzle of the tool the module draws in the hands: the host reads `source` at each shot and puts the tracer (and, unless the module draws one, the flash) there, at the
+     * muzzle of the model and not at a guess in front of the eye. Pass null (or call the returned function) to let go. A host that draws no shot effects leaves it out.
+     */
+    setMuzzleSource?(source: MuzzleSource | null): () => void;
     /**
      * Where the player's body holds a tool now (world space), in every view (the weapon is the body's own): `position` is the pocket of the right shoulder a stock rests on, `quaternion` turns
      * to the aim (-z the aim, x right, y up, as a camera). A module draws the tool there at its real size. Null for a host with no body (the module puts the same pocket under the camera's eye);
@@ -2522,6 +2614,13 @@ interface ModuleHost {
      * that keeps its camera to itself leaves it out.
      */
     setViewCamera?(camera: unknown | null): void;
+    /**
+     * Holds the walking player where it stands (true) or lets it walk again (false): the movement keys then belong to the module (a vehicle the player drives). Mouse look,
+     * the panels and the room's other keys keep working. A host without a walking player leaves it out.
+     */
+    holdPlayer?(held: boolean): void;
+    /** True while a module holds the player (`holdPlayer(true)`): the keys then belong to that module, and another module's own keys (a weapon's accessories) stay out of its way. */
+    playerHeld?(): boolean;
     /** Lent only to a module that declares controls, layers or metrics. */
     bench?: ModuleBench;
     /** The host's shared sound engine; a module that makes sound uses it when lent and stays silent (or brings its own) when not. */
@@ -2807,4 +2906,4 @@ declare function footprintBlocker(object: FootprintObject | (() => FootprintObje
 /** @deprecated Import it from `@adatechnology/game-contracts/testing`. */
 declare const resetWarnOnce: () => void;
 
-export { type ActionControl, type AnimationClipSpec, type AnimationEventSpec, type AnimationKey, type AnimationPose, type AreaPlacement, type AudioListener, type AudioSink, BLOW_IDS, BODY_FOLEY_IDS, BODY_SOUND_IDS, type BallisticExtras, type BenchChange, type BenchDeclaration, type BenchReport, type BenchSheet, type BlastOptions, type BlastReport, type BlastShove, type BlastShoveOptions, type BlastSource, type BlowId, type BlowTarget, type BodyFoleyId, type BodyRegion, type BodySlot, type BodySoundId, type BooleanControl, type BusyOptions, type BusySink, type BusyTask, type CategorizedOptions, type CategorizedReport, type CategoryDef, type CategoryOptions, type CategoryRegistry, type ChainDelay, type CheckOptions, type CheckSpecOptions, type ChoiceControl, type ChoiceOption, type ConfinementOptions, type ContainerSpec, type ContractChecker, type ContractContext, type ControlPatch, type ControlValue, type CostOptions, type Crack, DEFAULT_BLAST_SHOVE, DEFAULT_ENVIRONMENT, DEFAULT_IGNITION_RULES, DEFAULT_SURFACE, DEFERRED_PRIORITY, DEFERRED_QUEUE_ID, type DamageStage, type DamageType, type DebrisKind, type DeepPartial, type DeferredQueue, type DeferredQueueOptions, type DeferredQueueReport, type Dent, type DestructibleImpl, type DestructibleSpec, type DestructionEvent, type DestructionEventType, type EffectHandle, type EffectRequest, type EffectSink, type Enclosure, type EnclosureBox, type EnvironmentBus, type EnvironmentKey, type EnvironmentState, type ExplosionChain, FOOTSTEP_SOUND_IDS, FRAME_PHASES, type FluidKind, type Footprint, type FootprintObject, type FootstepSoundId, type FractureStyle, type Fragment, type FragmentHitOptions, type FragmentMark, type FrameOptions, type FramePhase, GAIT_IDS, type GaitId, type GroundLayout, type GroundZone, HEAVY_LANDING_SPEED, type HandPose, type HandTargetSource, type HandTargets, type Hit, type HitIgnition, type HitResult, type Hole, type HostEvent, type HostGraphics, type HostReach, type HostTool, type HostToolAttachment, IMPACT_CONTRACT, type IgnitionRules, type ImpactContract, type ItemAnimationContract, type ItemSeat, type ItemSounds, type ItemUseDef, type JointKind, type JointSpec, type JointState, KIT_ORIGIN_KEY, KNOCKED_DOWN_ANGLE, KNOCK_CHEST, KNOCK_DOWN_SPEED, type KitOrigin, type Knock, LANDING_IDS, LAND_SOUND_IDS, type LandSoundId, type LandingId, type LiquidId, type LoopHandle, MATERIAL_SURFACES, MISSING_BITS, type MaterialId, type ModuleArea, type ModuleBench, type ModuleControl, type ModuleHost, type ModuleItemFluid, type ModuleItemSeal, type ModuleLayer, type ModuleMetric, type ModuleScenario, type ModuleView, type NumberControl, type ObjectState, type PartBreach, type PartShape, type PartSpec, type PartState, type PartStatus, type PartUnits, type PileSpec, type PlayerState, type Quat, type RayHit, type Reinforcement, STAGE_EVENT, SURFACE_IDS, SWING_LEAD_SECONDS, type SealBlock, type SealSpec, type SealState, type SegmentKind, type ShelterOptions, type Shot, type SoilLayer, type SoilProfile, type SoilState, type SoundHandle, type SoundRequest, type SpecReport, type StructureRole, type SurfaceId, type SurfaceLayer, type SurfaceRay, type SurfaceRayHit, TOOL_CLIP, TWIST_LIFT, type TensionRebar, type TestableItem, type TestableModule, type Thumbnail, type ToolAnimationStep, type ToolAnimator, type ToolClipId, type ToolClipPlayer, type ToolClipPlayerOptions, type ToolClipSet, type ToolCommand, type ToolCommandResult, type ToolKind, type ToolRig, type TunedMassDamper, type TwistOptions, type TwistStroke, type UnmarkedDrawing, type Use, type Vec3, type WarmUpProbes, type WindExposure, type WindState, applyPatches, blastShove, bodyMass, checkAnimation, checkBench, checkCategorized, checkDeferredQueue, checkDestructible, checkHit, checkSpec, checkToolClips, createEnvironmentBus, createToolClipPlayer, deepMerge, defineCategories, fillFactor, footprintBlocker, footstepSoundId, hitSoundId, ignitionChance, isSurfaceId, kitOriginOf, knockOf, landSoundId, leadClipEvents, markKitOrigin, mergeById, removeIds, resetWarnOnce, resolveEntry, resolveIgnitionRules, sampleClip, scaleClip, sealBlock, sealOpener, shotExtras, shotToHit, sparkTargetFactor, stepKnock, surfaceOfMaterial, swingSoundId, toolAnimationStep, twistStroke, unmarkedDrawings, useToHit };
+export { type ActionControl, type AnimationClipSpec, type AnimationEventSpec, type AnimationKey, type AnimationPose, type AreaPlacement, type AudioListener, type AudioSink, BLOW_IDS, BODY_FOLEY_IDS, BODY_SOUND_IDS, type BallisticExtras, type BenchChange, type BenchDeclaration, type BenchReport, type BenchSheet, type BlastImpulseOptions, type BlastOptions, type BlastReport, type BlastShove, type BlastShoveOptions, type BlastSource, type BlowId, type BlowTarget, type BodyFoleyId, type BodyRegion, type BodySlot, type BodySoundId, type BooleanControl, type BusyOptions, type BusySink, type BusyTask, type CategorizedOptions, type CategorizedReport, type CategoryDef, type CategoryOptions, type CategoryRegistry, type ChainDelay, type CheckOptions, type CheckSpecOptions, type ChoiceControl, type ChoiceOption, type ConfinementOptions, type ContainerSpec, type ContractChecker, type ContractContext, type ControlPatch, type ControlValue, type CostOptions, type Crack, DEFAULT_BLAST_IMPULSE, DEFAULT_BLAST_SHOVE, DEFAULT_ENVIRONMENT, DEFAULT_IGNITION_RULES, DEFAULT_SURFACE, DEFERRED_PRIORITY, DEFERRED_QUEUE_ID, type DamageStage, type DamageType, type DebrisKind, type DeepPartial, type DeferredQueue, type DeferredQueueOptions, type DeferredQueueReport, type Dent, type DestructibleImpl, type DestructibleSpec, type DestructionEvent, type DestructionEventType, type EffectHandle, type EffectRequest, type EffectSink, type Enclosure, type EnclosureBox, type EnvironmentBus, type EnvironmentKey, type EnvironmentState, type ExplosionChain, FOOTSTEP_SOUND_IDS, FRAGMENT_COVER, FRAME_PHASES, type FluidKind, type Footprint, type FootprintObject, type FootstepSoundId, type FractureStyle, type Fragment, type FragmentHitOptions, type FragmentMark, type FrameOptions, type FramePhase, GAIT_IDS, type GaitId, type GroundLayout, type GroundZone, HEAVY_LANDING_SPEED, type HandPose, type HandTargetSource, type HandTargets, type Hit, type HitIgnition, type HitResult, type Hole, type HostEvent, type HostGraphics, type HostReach, type HostTool, type HostToolAttachment, IMPACT_CONTRACT, type IgnitionRules, type ImpactContract, type ItemAnimationContract, type ItemSeat, type ItemSounds, type ItemUseDef, type JointKind, type JointSpec, type JointState, KIT_ORIGIN_KEY, KNOCKED_DOWN_ANGLE, KNOCK_CHEST, KNOCK_DOWN_SPEED, type KitOrigin, type Knock, LANDING_IDS, LAND_SOUND_IDS, type LandSoundId, type LandingId, type LiquidId, type LoopHandle, MATERIAL_SURFACES, MISSING_BITS, type MaterialId, type ModuleArea, type ModuleBench, type ModuleControl, type ModuleHost, type ModuleItemFluid, type ModuleItemSeal, type ModuleLayer, type ModuleMetric, type ModuleScenario, type ModuleView, type MuzzlePose, type MuzzleSource, type NumberControl, type ObjectState, type PartBreach, type PartShape, type PartSpec, type PartState, type PartStatus, type PartUnits, type PileSpec, type PlayerState, type Quat, type RayHit, type Reinforcement, STAGE_EVENT, SURFACE_IDS, SWING_LEAD_SECONDS, type SealBlock, type SealSpec, type SealState, type SegmentKind, type ShelterOptions, type Shot, type SoilLayer, type SoilProfile, type SoilState, type SoundHandle, type SoundRequest, type SpecReport, type StructureRole, type SurfaceId, type SurfaceLayer, type SurfaceRay, type SurfaceRayHit, TOOL_CLIP, TWIST_LIFT, type TensionRebar, type TestableItem, type TestableModule, type Thumbnail, type ToolAnimationStep, type ToolAnimator, type ToolClipId, type ToolClipPlayer, type ToolClipPlayerOptions, type ToolClipSet, type ToolCommand, type ToolCommandResult, type ToolKind, type ToolRig, type TunedMassDamper, type TwistOptions, type TwistStroke, type UnmarkedDrawing, type Use, type Vec3, type WarmUpProbes, type WindExposure, type WindState, applyPatches, blastBodySpeed, blastShove, bodyImpulse, bodyMass, checkAnimation, checkBench, checkCategorized, checkDeferredQueue, checkDestructible, checkHit, checkSpec, checkToolClips, createEnvironmentBus, createToolClipPlayer, deepMerge, defineCategories, fillFactor, footprintBlocker, footstepSoundId, hitSoundId, ignitionChance, isSurfaceId, kitOriginOf, knockOf, landSoundId, launchBody, leadClipEvents, markKitOrigin, mergeById, removeIds, resetWarnOnce, resolveEntry, resolveIgnitionRules, sampleClip, scaleClip, sealBlock, sealOpener, shotExtras, shotToHit, sideOnImpulse, sparkTargetFactor, stepKnock, surfaceOfMaterial, swingSoundId, takeLaunch, toolAnimationStep, twistStroke, unmarkedDrawings, useToHit };

package/dist/index.global.js

@@ -24,6 +24,7 @@ var GameContracts = (() => {
     BLOW_IDS: () => BLOW_IDS,
     BODY_FOLEY_IDS: () => BODY_FOLEY_IDS,
     BODY_SOUND_IDS: () => BODY_SOUND_IDS,
+    DEFAULT_BLAST_IMPULSE: () => DEFAULT_BLAST_IMPULSE,
     DEFAULT_BLAST_SHOVE: () => DEFAULT_BLAST_SHOVE,
     DEFAULT_ENVIRONMENT: () => DEFAULT_ENVIRONMENT,
     DEFAULT_IGNITION_RULES: () => DEFAULT_IGNITION_RULES,
@@ -31,6 +32,7 @@ var GameContracts = (() => {
     DEFERRED_PRIORITY: () => DEFERRED_PRIORITY,
     DEFERRED_QUEUE_ID: () => DEFERRED_QUEUE_ID,
     FOOTSTEP_SOUND_IDS: () => FOOTSTEP_SOUND_IDS,
+    FRAGMENT_COVER: () => FRAGMENT_COVER,
     FRAME_PHASES: () => FRAME_PHASES,
     GAIT_IDS: () => GAIT_IDS,
     HEAVY_LANDING_SPEED: () => HEAVY_LANDING_SPEED,
@@ -49,7 +51,9 @@ var GameContracts = (() => {
     TOOL_CLIP: () => TOOL_CLIP,
     TWIST_LIFT: () => TWIST_LIFT,
     applyPatches: () => applyPatches,
+    blastBodySpeed: () => blastBodySpeed,
     blastShove: () => blastShove,
+    bodyImpulse: () => bodyImpulse,
     bodyMass: () => bodyMass,
     checkAnimation: () => checkAnimation,
     checkBench: () => checkBench,
@@ -72,6 +76,7 @@ var GameContracts = (() => {
     kitOriginOf: () => kitOriginOf,
     knockOf: () => knockOf,
     landSoundId: () => landSoundId,
+    launchBody: () => launchBody,
     leadClipEvents: () => leadClipEvents,
     markKitOrigin: () => markKitOrigin,
     mergeById: () => mergeById,
@@ -85,10 +90,12 @@ var GameContracts = (() => {
     sealOpener: () => sealOpener,
     shotExtras: () => shotExtras,
     shotToHit: () => shotToHit,
+    sideOnImpulse: () => sideOnImpulse,
     sparkTargetFactor: () => sparkTargetFactor,
     stepKnock: () => stepKnock,
     surfaceOfMaterial: () => surfaceOfMaterial,
     swingSoundId: () => swingSoundId,
+    takeLaunch: () => takeLaunch,
     toolAnimationStep: () => toolAnimationStep,
     twistStroke: () => twistStroke,
     unmarkedDrawings: () => unmarkedDrawings,
@@ -98,6 +105,7 @@ var GameContracts = (() => {
 
   // src/blast-shove.ts
   var DEFAULT_BLAST_SHOVE = { coupling: 0.02, maxSpeed: 20, lift: 0.3, minSpeed: 0.3, falloffPower: 2 };
+  var clampShare = (share) => Math.min(1, Math.max(0, share));
   function blastShove(blast, target, options = {}) {
     const o = { ...DEFAULT_BLAST_SHOVE, ...options };
     const dx = target.position[0] - blast.point[0];
@@ -107,17 +115,41 @@ var GameContracts = (() => {
     if (!(blast.radius > 0) || distance > blast.radius) return void 0;
     const falloff = (1 - distance / blast.radius) ** o.falloffPower;
     const mass = Math.max(target.mass, 0.05);
-    const speed = Math.min(o.maxSpeed, Math.sqrt(2 * blast.energy * (blast.reach ?? 1) * o.coupling / mass)) * falloff;
+    const reach = clampShare(blast.reach ?? 1);
+    const speed = Math.sqrt(reach) * Math.min(o.maxSpeed, Math.sqrt(2 * blast.energy * o.coupling / mass)) * falloff;
     if (!(speed >= o.minSpeed)) return void 0;
     const direction = distance > 1e-4 ? [dx / distance, dy / distance + o.lift, dz / distance] : [0, 1, 0];
     const length = Math.hypot(direction[0], direction[1], direction[2]);
     return { speed, direction: [direction[0] / length, direction[1] / length, direction[2] / length], distance, falloff };
   }
 
+  // src/blast-impulse.ts
+  var DEFAULT_BLAST_IMPULSE = { bodyArea: 0.7, lift: 0.15, minSpeed: 0.3, tntPerJoule: 0.24 / 2e5 };
+  var NEAREST = 0.3;
+  function sideOnImpulse(tnt, distance) {
+    if (!(tnt > 0)) return 0;
+    const w3 = Math.cbrt(tnt);
+    const z = Math.max(distance, NEAREST) / w3;
+    const scaled = 0.067 * Math.sqrt(1 + (z / 0.23) ** 4) / (z * z * Math.cbrt(1 + (z / 1.55) ** 3));
+    return scaled * w3 * 100;
+  }
+  function bodyImpulse(tnt, distance) {
+    if (!(tnt > 0)) return 0;
+    const z = Math.max(distance, NEAREST) / Math.cbrt(tnt);
+    return sideOnImpulse(tnt, distance) * (2 + 4 / (1 + z * z));
+  }
+  function blastBodySpeed(tnt, distance, mass, reach = 1, options = {}) {
+    const area = options.bodyArea ?? DEFAULT_BLAST_IMPULSE.bodyArea;
+    return bodyImpulse(tnt, distance) * area * Math.max(0, reach) / Math.max(mass, 1);
+  }
+
   // src/blast-knock.ts
   var KNOCK_DOWN_SPEED = 2.5;
   var KNOCKED_DOWN_ANGLE = 1.35;
   var LIE_SECONDS = 1.6;
+  var WOUNDED_LIE_SECONDS = 6;
+  var FRAGMENT_COVER = 0.5;
+  var STUN_SECONDS = 4;
   var STAND_UP_PER_SPEED = 0.25;
   var FALL_SECONDS = 0.25;
   var RISE_SECONDS = 0.6;
@@ -126,11 +158,38 @@ var GameContracts = (() => {
   var KNOCK_CHEST = 1.1;
   var CHEST = KNOCK_CHEST;
   var bodyMass = (height, build = 1) => 70 * (height / 1.75) ** 2 * build;
-  function knockOf(blast, feet, mass, options) {
-    const hit = blastShove(blast, { position: [feet[0], feet[1] + CHEST, feet[2]], mass }, options);
-    if (!hit) return void 0;
-    const [dx, dy, dz] = hit.direction;
-    return { velocity: [dx * hit.speed, Math.max(0, dy * hit.speed), dz * hit.speed], airborne: dy > 0, lying: 0, lieLeft: 0, down: hit.speed >= KNOCK_DOWN_SPEED };
+  function knockOf(blast, feet, mass, options, impulse = {}) {
+    const o = { ...DEFAULT_BLAST_IMPULSE, ...impulse };
+    const chest = [feet[0], feet[1] + CHEST, feet[2]];
+    const dx = chest[0] - blast.point[0];
+    const dy = chest[1] - blast.point[1];
+    const dz = chest[2] - blast.point[2];
+    const distance = Math.hypot(dx, dy, dz);
+    if (!(blast.radius > 0) || distance > blast.radius) return void 0;
+    const reach = Math.max(0, Math.min(1, blast.reach ?? 1));
+    const tnt = blast.tnt ?? blast.energy * o.tntPerJoule;
+    let speed = blastBodySpeed(tnt, distance, mass, reach, o);
+    const minSpeed = impulse.minSpeed ?? options?.minSpeed ?? o.minSpeed;
+    if (speed < minSpeed) speed = 0;
+    const struck = reach >= FRAGMENT_COVER;
+    const wounded = struck && blast.lethalRadius !== void 0 && distance <= blast.lethalRadius;
+    const edge = 1 - distance / blast.radius;
+    const stunSeconds = struck ? STUN_SECONDS * edge * edge * reach : 0;
+    if (speed === 0 && !wounded && stunSeconds < 0.25) return void 0;
+    const horizontal = Math.hypot(dx, dz);
+    const away = horizontal > 1e-4 ? [dx / horizontal, o.lift, dz / horizontal] : [0, 1, 0];
+    const length = Math.hypot(away[0], away[1], away[2]);
+    const velocity = [away[0] / length * speed, away[1] / length * speed, away[2] / length * speed];
+    return {
+      velocity,
+      airborne: velocity[1] > 0.5,
+      lying: 0,
+      lieLeft: wounded ? WOUNDED_LIE_SECONDS : 0,
+      away: horizontal > 1e-4 ? [dx / horizontal, 0, dz / horizontal] : [0, 0, 0],
+      down: speed >= KNOCK_DOWN_SPEED || wounded,
+      ...wounded ? { wounded } : {},
+      ...stunSeconds >= 0.25 ? { stunSeconds } : {}
+    };
   }
   function stepKnock(knock, position, dt, groundAt, alive) {
     const v = knock.velocity;
@@ -154,18 +213,25 @@ var GameContracts = (() => {
     }
     const moving = horizontal > 0.05 || knock.airborne;
     if (knock.down) {
-      if (moving) knock.lying = Math.min(1, knock.lying + dt / FALL_SECONDS);
-      else {
-        knock.lying = 1;
-        if (alive) {
-          knock.lieLeft = knock.lieLeft > 0 ? knock.lieLeft : LIE_SECONDS + Math.hypot(v[0], v[2]) * STAND_UP_PER_SPEED;
-          knock.lieLeft -= dt;
-          if (knock.lieLeft <= 0) knock.down = false;
-        }
+      if (moving || knock.lying < 1) knock.lying = Math.min(1, knock.lying + dt / FALL_SECONDS);
+      else if (alive) {
+        knock.lieLeft = knock.lieLeft > 0 ? knock.lieLeft : LIE_SECONDS + Math.hypot(v[0], v[2]) * STAND_UP_PER_SPEED;
+        knock.lieLeft -= dt;
+        if (knock.lieLeft <= 0) knock.down = false;
       }
     } else if (knock.lying > 0) knock.lying = Math.max(0, knock.lying - dt / RISE_SECONDS);
     return !moving && !knock.down && knock.lying === 0;
   }
+  var LAUNCHED = "launched";
+  function launchBody(root, velocity) {
+    root.userData[LAUNCHED] = [velocity[0], velocity[1], velocity[2]];
+  }
+  function takeLaunch(root) {
+    const velocity = root.userData[LAUNCHED];
+    if (!velocity) return void 0;
+    delete root.userData[LAUNCHED];
+    return { velocity: [velocity[0], velocity[1], velocity[2]], airborne: true, lying: 0, lieLeft: 0, down: true };
+  }
 
   // src/impact-cost.ts
   var DEFAULT_COST_READS = 1e4;
@@ -1190,6 +1256,8 @@ var GameContracts = (() => {
     mortar: "concrete",
     stone: "concrete",
     brick: "concrete",
+    cobble: "concrete",
+    paver: "concrete",
     plaster: "concrete",
     asphalt: "asphalt",
     wood_soft: "wood",
@@ -1200,6 +1268,8 @@ var GameContracts = (() => {
     ceramic: "tile",
     plastic: "tile",
     soil: "dirt",
+    mud: "dirt",
+    clay: "dirt",
     wax: "dirt",
     flesh_fruit: "dirt",
     turf: "grass",
@@ -1207,6 +1277,8 @@ var GameContracts = (() => {
     cactus: "grass",
     gravel: "gravel",
     sand: "sand",
+    // no snow surface yet: packed snow crunches closest to sand underfoot
+    snow: "sand",
     steel: "metal",
     cast_iron: "metal",
     aluminium: "metal",