@waica/behaviors 0.12.0 → 0.14.0

package/dist/health.d.ts

@@ -45,6 +45,10 @@ export declare class Health extends Component {
             label: string;
             ref: 'stat';
         };
+        hurtSound: {
+            label: string;
+            ref: 'sound';
+        };
     };
     static transient: string[];
     max: number;
@@ -55,6 +59,8 @@ export declare class Health extends Component {
      * publishes nothing: the stat is the project's to declare.
      */
     stat: string;
+    /** Sound played at this entity's position on every accepted hit. Empty plays nothing (CA-12). */
+    hurtSound: string;
     /** Health left; 0 is dead. Filled in from max on ready. */
     current: number;
     /** Whoever dealt the last accepted hit, for the state that reacts to it. */

package/dist/health.js

@@ -1,4 +1,4 @@
-import { Component, StateMachine } from '@waica/engine';
+import { Component, SIMULATION_TIME_EPSILON, StateMachine, } from '@waica/engine';
 /**
  * Below this, current is treated as exactly zero. Repeated fractional
  * damage (e.g. ten hits of 0.1 against max: 1) can leave a floating-point
@@ -47,6 +47,7 @@ export class Health extends Component {
         max: { label: 'Max health', min: 1, max: 20, step: 1 },
         invulnerability: { label: 'Invulnerability', min: 0, max: 5, step: 0.1 },
         stat: { label: 'Stat', ref: 'stat' },
+        hurtSound: { label: 'Hurt sound', ref: 'sound' },
     };
     static transient = [
         'current',
@@ -64,6 +65,8 @@ export class Health extends Component {
      * publishes nothing: the stat is the project's to declare.
      */
     stat = '';
+    /** Sound played at this entity's position on every accepted hit. Empty plays nothing (CA-12). */
+    hurtSound = '';
     /** Health left; 0 is dead. Filled in from max on ready. */
     current = 0;
     /** Whoever dealt the last accepted hit, for the state that reacts to it. */
@@ -110,6 +113,12 @@ export class Health extends Component {
     onUpdate(dt) {
         if (this.invulnerable > 0) {
             this.invulnerable = Math.max(0, this.invulnerable - dt);
+            // this.invulnerable is a countdown of SIMULATION_STEP-sized dts, which
+            // float error can leave as a tiny positive residual instead of
+            // exactly 0 on the step that should close the window; without this,
+            // `> 0` above stays true for one whole extra step.
+            if (this.invulnerable <= SIMULATION_TIME_EPSILON)
+                this.invulnerable = 0;
             this.blink(dt);
         }
         if (this.deathPending) {
@@ -158,6 +167,8 @@ export class Health extends Component {
             current: this.current,
             source,
         });
+        if (this.hurtSound)
+            this.game.audio.play(this.hurtSound, { at: this.entity });
         this.invulnerable = this.invulnerability;
         this.blinkClock = 0;
         if (this.current === 0) {

package/dist/lifetime.js

@@ -1,4 +1,4 @@
-import { Component } from '@waica/engine';
+import { Component, SIMULATION_TIME_EPSILON } from '@waica/engine';
 /** Destroys its entity after a configurable amount of simulated time. */
 export class Lifetime extends Component {
     static componentName = 'Lifetime';
@@ -14,7 +14,10 @@ export class Lifetime extends Component {
         if (!this.entity.alive)
             return;
         this.elapsed += dt;
-        if (this.elapsed >= this.seconds)
+        // this.elapsed is a sum of SIMULATION_STEP-sized dts, which float error
+        // can leave a hair under an exact multiple; the epsilon keeps a bare
+        // `>=` from waiting one whole step too long to destroy.
+        if (this.elapsed + SIMULATION_TIME_EPSILON >= this.seconds)
             this.entity.destroy();
     }
 }

package/dist/melee-attack.d.ts

@@ -29,12 +29,18 @@ export declare class MeleeAttack extends Component {
             max: number;
             step: number;
         };
+        swingSound: {
+            label: string;
+            ref: 'sound';
+        };
     };
     damage: number;
     /** How far in front of the attacker the blow reaches, in world units. */
     range: number;
     /** How wide the blow is, across the facing. */
     width: number;
+    /** Sound played on every swing. Empty plays nothing (CA-12). */
+    swingSound: string;
     /**
      * Lands one blow along `facing`: every other living entity with a Hitbox
      * and a Health inside the strike area takes `damage` once, with this

package/dist/melee-attack.js

@@ -16,12 +16,15 @@ export class MeleeAttack extends Component {
         damage: { label: 'Damage', min: 0, max: 20, step: 1 },
         range: { label: 'Range', min: 0.5, max: 5, step: 0.5 },
         width: { label: 'Width', min: 0.5, max: 5, step: 0.5 },
+        swingSound: { label: 'Swing sound', ref: 'sound' },
     };
     damage = 1;
     /** How far in front of the attacker the blow reaches, in world units. */
     range = 1;
     /** How wide the blow is, across the facing. */
     width = 1;
+    /** Sound played on every swing. Empty plays nothing (CA-12). */
+    swingSound = '';
     /**
      * Lands one blow along `facing`: every other living entity with a Hitbox
      * and a Health inside the strike area takes `damage` once, with this
@@ -33,6 +36,11 @@ export class MeleeAttack extends Component {
         const direction = logicalDirection(facing, this.game.projection);
         if (!direction)
             return [];
+        // Positional like Health's hurtSound (CA-8): an off-camera NPC's swing
+        // should attenuate and pan like the hit it causes, not play flat and
+        // dead-centre while the damage it lands sounds correctly placed.
+        if (this.swingSound)
+            this.game.audio.play(this.swingSound, { at: this.entity });
         const area = this.strikeArea(direction.x, direction.y);
         const struck = [];
         // A copy: a target with no death-handling graph is destroyed on the spot,

package/dist/patrol.js

@@ -1,4 +1,4 @@
-import { Component, installedDirectionalAnimation, projectIsometric, } from '@waica/engine';
+import { Component, installedDirectionalAnimation, projectIsometric, SIMULATION_TIME_EPSILON, } from '@waica/engine';
 import { facingForInput } from './facing.js';
 /** Seconds a hit stops the rail. */
 const HURT_SECONDS = 0.25;
@@ -105,7 +105,10 @@ export const PATROLLER_ROLE = {
         // Holds the death pose for a beat, then the body goes away for good.
         dead: {
             onUpdate({ entity, fsm }) {
-                if (fsm.elapsed >= DEATH_SECONDS)
+                // fsm.elapsed is a sum of SIMULATION_STEP-sized dts, which float
+                // error can leave a hair under an exact multiple; the epsilon keeps
+                // a bare `>=` from waiting one whole step too long to destroy.
+                if (fsm.elapsed + SIMULATION_TIME_EPSILON >= DEATH_SECONDS)
                     entity.destroy();
             },
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/behaviors",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Waica built-in behaviors — the curated game-feel library",
   "license": "MIT",
   "type": "module",
@@ -19,6 +19,6 @@
     }
   },
   "dependencies": {
-    "@waica/engine": "^0.12.0"
+    "@waica/engine": "^0.14.0"
   }
 }