@waica/behaviors 0.14.0 → 0.15.0

package/dist/collectible.d.ts

@@ -1,8 +1,8 @@
 import { Component, type Entity } from '@waica/engine';
 /**
- * Collected when the entity with the player role touches
- * it: adds its value to a stat, fires onCollect and destroys itself.
- * Requires Hitbox on both entities.
+ * Collected when its Hitbox mask dispatches an overlap: adds its value to a
+ * stat, fires onCollect and destroys itself. Shipped collectibles target the
+ * `player` layer; this handler deliberately does not recheck identity.
  */
 export declare class Collectible extends Component {
     static componentName: string;
@@ -22,5 +22,5 @@ export declare class Collectible extends Component {
     /** Stat receiving the value ('' collects without counting anywhere). */
     stat: string;
     onCollect?: (value: number) => void;
-    onCollide(other: Entity): void;
+    onCollide(_other: Entity): void;
 }

package/dist/collectible.js

@@ -1,9 +1,8 @@
 import { Component } from '@waica/engine';
-import { isPlayer } from './player-identity.js';
 /**
- * Collected when the entity with the player role touches
- * it: adds its value to a stat, fires onCollect and destroys itself.
- * Requires Hitbox on both entities.
+ * Collected when its Hitbox mask dispatches an overlap: adds its value to a
+ * stat, fires onCollect and destroys itself. Shipped collectibles target the
+ * `player` layer; this handler deliberately does not recheck identity.
  */
 export class Collectible extends Component {
     static componentName = 'Collectible';
@@ -15,9 +14,7 @@ export class Collectible extends Component {
     /** Stat receiving the value ('' collects without counting anywhere). */
     stat = 'points';
     onCollect;
-    onCollide(other) {
-        if (!isPlayer(other))
-            return;
+    onCollide(_other) {
         this.onCollect?.(this.value);
         if (this.stat)
             this.game.stats.add(this.stat, this.value);

package/dist/hazard.d.ts

@@ -7,8 +7,9 @@ export type HazardTouch = 'stomp' | 'hurt';
  */
 export declare function resolveHazardTouch(playerVy: number, playerBottom: number, hazardY: number, stompable: boolean): HazardTouch;
 /**
- * Hurts the player on contact. If stompable (Mario-style), stomping it
- * bounces the player. Requires Hitbox on both entities.
+ * Hurts the Entity delivered by its Hitbox mask. Shipped hazards target the
+ * `player` layer; this handler deliberately does not recheck identity. If
+ * stompable (Mario-style), stomping it bounces the target.
  *
  * "Hurts on touch" is all this means — being able to take a hit is Health's
  * job, so a spike is a Hazard alone and an enemy is Hazard + Health. Either

package/dist/hazard.js

@@ -1,7 +1,6 @@
 import { Component } from '@waica/engine';
 import { Health } from './health.js';
 import { PlatformerMotor } from './platformer-motor.js';
-import { isPlayer } from './player-identity.js';
 import { Respawnable } from './respawnable.js';
 /**
  * Touching a hazard by stomping it from above (falling, with the feet
@@ -14,8 +13,9 @@ export function resolveHazardTouch(playerVy, playerBottom, hazardY, stompable) {
     return 'hurt';
 }
 /**
- * Hurts the player on contact. If stompable (Mario-style), stomping it
- * bounces the player. Requires Hitbox on both entities.
+ * Hurts the Entity delivered by its Hitbox mask. Shipped hazards target the
+ * `player` layer; this handler deliberately does not recheck identity. If
+ * stompable (Mario-style), stomping it bounces the target.
  *
  * "Hurts on touch" is all this means — being able to take a hit is Health's
  * job, so a spike is a Hazard alone and an enemy is Hazard + Health. Either
@@ -57,8 +57,6 @@ export class Hazard extends Component {
      */
     bouncing = false;
     onCollide(other) {
-        if (!isPlayer(other))
-            return;
         const motor = other.get(PlatformerMotor);
         if (motor) {
             const playerBottom = other.position.y - motor.hitboxHeight / 2;

package/dist/interactable.js

@@ -56,26 +56,16 @@ export function fireInteract(target, initiator) {
  * radius hides it again. Nearest one wins when several are in range.
  */
 export function interactUpdate({ entity, game }) {
-    let nearest = null;
-    let nearestEntity = null;
-    let nearestDistance = Infinity;
-    for (const other of game.entities) {
-        if (other === entity)
-            continue;
-        const interactable = other.get(Interactable);
-        if (!interactable)
-            continue;
-        const distance = Math.hypot(other.position.x - entity.position.x, other.position.y - entity.position.y);
-        if (distance <= interactable.radius && distance < nearestDistance) {
-            nearest = interactable;
-            nearestEntity = other;
-            nearestDistance = distance;
-        }
-    }
-    if (!nearest || !nearestEntity) {
+    const nearestEntity = game.query.nearest(entity.position.x, entity.position.y, {
+        with: [Interactable],
+        exclude: entity,
+        where: (candidate, { distance }) => distance <= candidate.get(Interactable).radius,
+    });
+    if (!nearestEntity) {
         game.ui.hide(INTERACTABLE_UI_PIECE);
         return;
     }
+    const nearest = nearestEntity.get(Interactable);
     if (game.input.justPressed('interact') && !game.input.consumed('interact')) {
         // The press is spent: an input:interact edge needs a NEW press.
         game.input.consume('interact');

package/dist/melee-attack.js

@@ -1,4 +1,4 @@
-import { Component, Hitbox, collisionOverlap, } from '@waica/engine';
+import { Component, Hitbox, } from '@waica/engine';
 import { logicalDirection } from './facing.js';
 import { Health } from './health.js';
 /**
@@ -43,25 +43,16 @@ export class MeleeAttack extends Component {
             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,
-        // which splices it out of the live array mid-loop (Game does the same).
-        for (const other of [...this.game.entities]) {
-            if (other === this.entity || !other.alive)
+        const targets = this.game.query.area(area, {
+            with: [Health],
+            exclude: this.entity,
+        });
+        for (const other of targets) {
+            // Query results are eager live references: an earlier target can destroy
+            // a later one while this strike is still consuming its snapshot.
+            if (!other.alive)
                 continue;
-            const hitbox = other.get(Hitbox);
             const health = other.get(Health);
-            if (!hitbox || !health)
-                continue;
-            const body = {
-                x: other.position.x + hitbox.offsetX,
-                y: other.position.y + hitbox.offsetY,
-                width: hitbox.width,
-                height: hitbox.height,
-                shape: hitbox.shape,
-                points: hitbox.points,
-            };
-            if (!collisionOverlap(area, body))
-                continue;
             const before = health.current;
             health.damage(this.damage, this.entity);
             if (health.current < before)

package/dist/scene-transition.d.ts

@@ -6,9 +6,10 @@ import { Component, type Entity } from '@waica/engine';
  * destination: the incoming scene places its own Player wherever that
  * scene authored it (no named entry points).
  *
- * With trigger:'overlap' (the default) it fires like Collectible/Hazard:
- * the player's Hitbox overlapping its own — requires a sibling Hitbox.
- * With trigger:'interact' it implements no radius or prompt of its own:
+ * With trigger:'overlap' (the default) it fires whenever its Hitbox mask
+ * dispatches an overlap. Shipped doors target the `player` layer; this handler
+ * deliberately does not recheck identity. With trigger:'interact' it implements
+ * no radius or prompt of its own:
  * it needs a sibling Interactable and fires from the shared nearest-wins
  * interact scan (interactable.ts's fireInteract), so a door and an NPC in
  * range arbitrate themselves with no new rule.
@@ -28,7 +29,7 @@ export declare class SceneTransition extends Component {
     scene: string;
     trigger: 'overlap' | 'interact';
     onReady(): void;
-    onCollide(other: Entity): void;
+    onCollide(_other: Entity): void;
     onInteract(_initiator: Entity): void;
     private fire;
 }

package/dist/scene-transition.js

@@ -1,6 +1,5 @@
 import { Component } from '@waica/engine';
 import { Interactable } from './interactable.js';
-import { isPlayer } from './player-identity.js';
 /**
  * Replaces the live scene with `scene` (its file's stem, e.g.
  * "cave.scene.json" -> "cave") when fired — a door, or any entity a player
@@ -8,9 +7,10 @@ import { isPlayer } from './player-identity.js';
  * destination: the incoming scene places its own Player wherever that
  * scene authored it (no named entry points).
  *
- * With trigger:'overlap' (the default) it fires like Collectible/Hazard:
- * the player's Hitbox overlapping its own — requires a sibling Hitbox.
- * With trigger:'interact' it implements no radius or prompt of its own:
+ * With trigger:'overlap' (the default) it fires whenever its Hitbox mask
+ * dispatches an overlap. Shipped doors target the `player` layer; this handler
+ * deliberately does not recheck identity. With trigger:'interact' it implements
+ * no radius or prompt of its own:
  * it needs a sibling Interactable and fires from the shared nearest-wins
  * interact scan (interactable.ts's fireInteract), so a door and an NPC in
  * range arbitrate themselves with no new rule.
@@ -30,11 +30,9 @@ export class SceneTransition extends Component {
                 'sibling Interactable; it will never fire.');
         }
     }
-    onCollide(other) {
+    onCollide(_other) {
         if (this.trigger !== 'overlap')
             return;
-        if (!isPlayer(other))
-            return;
         this.fire();
     }
     onInteract(_initiator) {

package/package.json

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