@waica/behaviors 0.25.0 → 0.26.0

package/dist/character-motor.d.ts

@@ -0,0 +1,58 @@
+import { Component, type ComponentSpace } from '@waica/engine';
+/**
+ * Walks and jumps a 3D character (ADR 0028): beside a kinematic `RigidBody`
+ * and its `Collider`, it turns the player's actions into the body's desired
+ * velocity on the world axes and a jump. The engine's character controller
+ * does the moving (walls, steps, slopes, gravity); this only asks. Movement is
+ * relative to the world, not to the camera, and `-z` is forward; a diagonal
+ * is normalized, so it moves at `speed` like a cardinal direction. The jump
+ * press is consumed only when the body jumped, so a press in the air stays
+ * readable (a double jump, a glide). With no kinematic body beside it, it
+ * does nothing (`validate_project` reports it). Actions with no binding read
+ * 0, so a Game without bindings stands still.
+ */
+export declare class CharacterMotor extends Component {
+    static componentName: string;
+    static space: ComponentSpace;
+    static params: {
+        speed: {
+            label: string;
+            min: number;
+            max: number;
+            step: number;
+        };
+        jumpSpeed: {
+            label: string;
+            min: number;
+            max: number;
+            step: number;
+        };
+        leftAction: {
+            label: string;
+        };
+        rightAction: {
+            label: string;
+        };
+        forwardAction: {
+            label: string;
+        };
+        backAction: {
+            label: string;
+        };
+        jumpAction: {
+            label: string;
+        };
+    };
+    /** Walking speed in units per second. */
+    speed: number;
+    /** Launch speed of a jump in units per second. */
+    jumpSpeed: number;
+    leftAction: string;
+    rightAction: string;
+    /** Walks toward -z. */
+    forwardAction: string;
+    /** Walks toward +z. */
+    backAction: string;
+    jumpAction: string;
+    onUpdate(): void;
+}

package/dist/character-motor.js

@@ -0,0 +1,51 @@
+import { Component, RigidBody } from '@waica/engine';
+/**
+ * Walks and jumps a 3D character (ADR 0028): beside a kinematic `RigidBody`
+ * and its `Collider`, it turns the player's actions into the body's desired
+ * velocity on the world axes and a jump. The engine's character controller
+ * does the moving (walls, steps, slopes, gravity); this only asks. Movement is
+ * relative to the world, not to the camera, and `-z` is forward; a diagonal
+ * is normalized, so it moves at `speed` like a cardinal direction. The jump
+ * press is consumed only when the body jumped, so a press in the air stays
+ * readable (a double jump, a glide). With no kinematic body beside it, it
+ * does nothing (`validate_project` reports it). Actions with no binding read
+ * 0, so a Game without bindings stands still.
+ */
+export class CharacterMotor extends Component {
+    static componentName = 'CharacterMotor';
+    static space = '3d';
+    static params = {
+        speed: { label: 'Speed', min: 0, max: 30, step: 0.5 },
+        jumpSpeed: { label: 'Jump speed', min: 0, max: 30, step: 0.5 },
+        leftAction: { label: 'Left action' },
+        rightAction: { label: 'Right action' },
+        forwardAction: { label: 'Forward action' },
+        backAction: { label: 'Back action' },
+        jumpAction: { label: 'Jump action' },
+    };
+    /** Walking speed in units per second. */
+    speed = 6;
+    /** Launch speed of a jump in units per second. */
+    jumpSpeed = 6;
+    leftAction = 'left';
+    rightAction = 'right';
+    /** Walks toward -z. */
+    forwardAction = 'up';
+    /** Walks toward +z. */
+    backAction = 'down';
+    jumpAction = 'jump';
+    onUpdate() {
+        const body = this.entity.get(RigidBody);
+        if (body?.type !== 'kinematic')
+            return;
+        const { input } = this.game;
+        const x = input.axis(this.leftAction, this.rightAction);
+        const z = -input.axis(this.backAction, this.forwardAction);
+        // Like TopDownMotor: diagonals match the cardinal speed.
+        const length = Math.hypot(x, z);
+        const scale = length > 1 ? this.speed / length : this.speed;
+        body.desiredVelocity = { x: x * scale, z: z * scale };
+        if (input.justPressed(this.jumpAction) && body.jump(this.jumpSpeed))
+            input.consume(this.jumpAction);
+    }
+}

package/dist/chaser.d.ts

@@ -1,4 +1,4 @@
-import { Component, type RoleDefinition, type RoleGraph } from '@waica/engine';
+import { Component, type ComponentSpace, type RoleDefinition, type RoleGraph } from '@waica/engine';
 export type ChaserMode = 'walker' | 'ghost' | 'flyer';
 /**
  * Pursuit toward the player while they are within sight range, in one of
@@ -11,6 +11,7 @@ export type ChaserMode = 'walker' | 'ghost' | 'flyer';
  */
 export declare class Chaser extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static params: {
         mode: {
             label: string;

package/dist/chaser.js

@@ -11,6 +11,7 @@ import { isPlayer } from './player-identity.js';
  */
 export class Chaser extends Component {
     static componentName = 'Chaser';
+    static space = '2d';
     static params = {
         mode: { label: 'Mode', options: ['walker', 'ghost', 'flyer'] },
         range: { label: 'Sight range', min: 1, max: 30, step: 0.5 },

package/dist/click-to-move.d.ts

@@ -1,4 +1,4 @@
-import { Component, type Entity, type StateContext } from '@waica/engine';
+import { Component, type ComponentSpace, type Entity, type StateContext } from '@waica/engine';
 import { type GridPoint } from './navigation-grid.js';
 interface GroundOrder {
     kind: 'ground';
@@ -35,6 +35,7 @@ interface ClickToMoveMotor {
  */
 export declare class ClickToMove extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         arrivalTolerance: {

package/dist/click-to-move.js

@@ -20,6 +20,7 @@ const NPC_REPLAN_DISTANCE = ATTACK_REPLAN_DISTANCE;
  */
 export class ClickToMove extends Component {
     static componentName = 'ClickToMove';
+    static space = '2d';
     static displayName = 'Click to move';
     static params = {
         arrivalTolerance: { label: 'Arrival tolerance', min: 0.05, max: 1, step: 0.05 },

package/dist/damage-puff.d.ts

@@ -1,4 +1,4 @@
-import { Component } from '@waica/engine';
+import { Component, type ComponentSpace } from '@waica/engine';
 /**
  * A puff from this entity's ParticleEmitter wherever
  * damage lands. Health announces every accepted hit on `game.events` as
@@ -9,6 +9,7 @@ import { Component } from '@waica/engine';
  */
 export declare class DamagePuff extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         count: {

package/dist/damage-puff.js

@@ -9,6 +9,7 @@ import { Component, Entity, ParticleEmitter } from '@waica/engine';
  */
 export class DamagePuff extends Component {
     static componentName = 'DamagePuff';
+    static space = '2d';
     static displayName = 'Damage puff';
     static params = {
         count: { label: 'Particles', min: 1, max: 64, step: 1 },

package/dist/dust-puffs.d.ts

@@ -1,4 +1,4 @@
-import { Component } from '@waica/engine';
+import { Component, type ComponentSpace } from '@waica/engine';
 /**
  * Dust from this entity's own ParticleEmitter at the
  * two moments a platformer body meets the ground hard — a small puff when a
@@ -25,6 +25,7 @@ import { Component } from '@waica/engine';
  */
 export declare class DustPuffs extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         jumpCount: {

package/dist/dust-puffs.js

@@ -30,6 +30,7 @@ const AIR_STATES = ['jump', 'fall'];
  */
 export class DustPuffs extends Component {
     static componentName = 'DustPuffs';
+    static space = '2d';
     static displayName = 'Dust puffs';
     static params = {
         jumpCount: { label: 'Jump puff', min: 0, max: 64, step: 1 },

package/dist/dust-trail.d.ts

@@ -1,4 +1,4 @@
-import { Component } from '@waica/engine';
+import { Component, type ComponentSpace } from '@waica/engine';
 /**
  * A soft dust trail while this entity walks. The
  * ParticleEmitter on the same entity does the continuous emission (its
@@ -12,6 +12,7 @@ import { Component } from '@waica/engine';
  */
 export declare class DustTrail extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         state: {

package/dist/dust-trail.js

@@ -12,6 +12,7 @@ import { Component, ParticleEmitter, StateMachine } from '@waica/engine';
  */
 export class DustTrail extends Component {
     static componentName = 'DustTrail';
+    static space = '2d';
     static displayName = 'Dust trail';
     static params = {
         state: { label: 'State' },

package/dist/grid-motor.d.ts

@@ -1,7 +1,8 @@
-import { Component, type AnimationFacingProvider, type CameraVelocity, type CameraVelocityProvider } from '@waica/engine';
+import { Component, type AnimationFacingProvider, type CameraVelocity, type CameraVelocityProvider, type ComponentSpace } from '@waica/engine';
 /** Shared velocity, collision and provider behavior for square-grid motors. */
 export declare abstract class GridMotor extends Component implements CameraVelocityProvider, AnimationFacingProvider {
     static displayName: string;
+    static space: ComponentSpace;
     static params: {
         moveSpeed: {
             label: string;

package/dist/grid-motor.js

@@ -2,6 +2,7 @@ import { Component, resolveSolidAxis, THREE, } from '@waica/engine';
 /** Shared velocity, collision and provider behavior for square-grid motors. */
 export class GridMotor extends Component {
     static displayName = 'Motor';
+    static space = '2d';
     static params = {
         moveSpeed: { label: 'Speed', min: 1, max: 30, step: 0.5 },
         acceleration: { label: 'Acceleration', min: 5, max: 200, step: 5 },

package/dist/hazard.d.ts

@@ -1,4 +1,4 @@
-import { Component, type Entity } from '@waica/engine';
+import { Component, type Entity, type ComponentSpace } from '@waica/engine';
 export type HazardTouch = 'stomp' | 'hurt';
 /**
  * Touching a hazard by stomping it from above (falling, with the feet
@@ -19,6 +19,7 @@ export declare function resolveHazardTouch(playerVy: number, playerBottom: numbe
  */
 export declare class Hazard extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static params: {
         stompable: {
             label: string;

package/dist/hazard.js

@@ -25,6 +25,7 @@ export function resolveHazardTouch(playerVy, playerBottom, hazardY, stompable) {
  */
 export class Hazard extends Component {
     static componentName = 'Hazard';
+    static space = '2d';
     static params = {
         stompable: { label: 'Stompable' },
         bounce: { label: 'Stomp bounce', min: 0, max: 30, step: 0.5 },

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { PlatformerMotor } from './platformer-motor.js';
+export { CharacterMotor } from './character-motor.js';
 export { PLAYER_ROLE, PLAYER_STATE_GRAPH, playerUpdate } from './player-states.js';
 export { TopDownMotor, type TopDownFacing } from './topdown-motor.js';
 export { IsoMotor, type IsoFacing } from './iso-motor.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 export { PlatformerMotor } from './platformer-motor.js';
+export { CharacterMotor } from './character-motor.js';
 export { PLAYER_ROLE, PLAYER_STATE_GRAPH, playerUpdate } from './player-states.js';
 export { TopDownMotor } from './topdown-motor.js';
 export { IsoMotor } from './iso-motor.js';

package/dist/interactable.d.ts

@@ -1,4 +1,4 @@
-import { Component, type Entity, type Game, type StateContext } from '@waica/engine';
+import { Component, type ComponentSpace, type Entity, type Game, type StateContext } from '@waica/engine';
 /**
  * Something the player can talk to or examine: a dialogue line and the
  * radius it can be triggered from. The component is pure data — the
@@ -7,6 +7,7 @@ import { Component, type Entity, type Game, type StateContext } from '@waica/eng
  */
 export declare class Interactable extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static params: {
         line: {
             label: string;

package/dist/interactable.js

@@ -8,6 +8,7 @@ import { anchorHeight } from './anchor-height.js';
  */
 export class Interactable extends Component {
     static componentName = 'Interactable';
+    static space = '2d';
     static params = {
         line: { label: 'Line' },
         radius: { label: 'Radius', min: 0.5, max: 10, step: 0.25 },

package/dist/melee-attack.d.ts

@@ -1,4 +1,4 @@
-import { Component, type Entity } from '@waica/engine';
+import { Component, type ComponentSpace, type Entity } from '@waica/engine';
 /**
  * A short frontal strike. Passive like a motor: state code decides when it
  * happens (the player's `attack` state) and calls strike(facing); this only
@@ -9,6 +9,7 @@ import { Component, type Entity } from '@waica/engine';
  */
 export declare class MeleeAttack extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         damage: {

package/dist/melee-attack.js

@@ -11,6 +11,7 @@ import { Health } from './health.js';
  */
 export class MeleeAttack extends Component {
     static componentName = 'MeleeAttack';
+    static space = '2d';
     static displayName = 'Melee attack';
     static params = {
         damage: { label: 'Damage', min: 0, max: 20, step: 1 },

package/dist/patrol.d.ts

@@ -1,4 +1,4 @@
-import { Component, type AnimationFacingProvider, type RoleDefinition, type RoleGraph } from '@waica/engine';
+import { Component, type AnimationFacingProvider, type ComponentSpace, type RoleDefinition, type RoleGraph } from '@waica/engine';
 export type PatrolAxis = 'horizontal' | 'vertical';
 /**
  * Rail patrol: back and forth `distance` units from the starting
@@ -12,6 +12,7 @@ export type PatrolAxis = 'horizontal' | 'vertical';
  */
 export declare class Patrol extends Component implements AnimationFacingProvider {
     static componentName: string;
+    static space: ComponentSpace;
     static params: {
         axis: {
             label: string;

package/dist/patrol.js

@@ -16,6 +16,7 @@ const DEATH_SECONDS = 0.5;
  */
 export class Patrol extends Component {
     static componentName = 'Patrol';
+    static space = '2d';
     static params = {
         axis: { label: 'Axis', options: ['horizontal', 'vertical'] },
         distance: { label: 'Distance', min: 0.5, max: 20, step: 0.5 },

package/dist/platformer-motor.d.ts

@@ -1,4 +1,4 @@
-import { Component, type CameraVelocity, type CameraVelocityProvider } from '@waica/engine';
+import { Component, type CameraVelocity, type CameraVelocityProvider, type ComponentSpace } from '@waica/engine';
 /**
  * Passive platformer motor: tuning params, physical state and movement
  * methods for state code to call. It has no onUpdate of its own — the
@@ -11,6 +11,7 @@ import { Component, type CameraVelocity, type CameraVelocityProvider } from '@wa
  */
 export declare class PlatformerMotor extends Component implements CameraVelocityProvider {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         moveSpeed: {

package/dist/platformer-motor.js

@@ -11,6 +11,7 @@ import { Component, resolveSolidAxis, THREE, } from '@waica/engine';
  */
 export class PlatformerMotor extends Component {
     static componentName = 'PlatformerMotor';
+    static space = '2d';
     static displayName = 'Motor';
     static params = {
         moveSpeed: { label: 'Speed', min: 1, max: 30, step: 0.5 },

package/dist/swing-sparks.d.ts

@@ -1,4 +1,4 @@
-import { Component } from '@waica/engine';
+import { Component, type ComponentSpace } from '@waica/engine';
 /**
  * A burst of sparks from this entity's own
  * ParticleEmitter each time its StateMachine enters the swing state. The
@@ -12,6 +12,7 @@ import { Component } from '@waica/engine';
  */
 export declare class SwingSparks extends Component {
     static componentName: string;
+    static space: ComponentSpace;
     static displayName: string;
     static params: {
         state: {

package/dist/swing-sparks.js

@@ -12,6 +12,7 @@ import { Component, ParticleEmitter, StateMachine } from '@waica/engine';
  */
 export class SwingSparks extends Component {
     static componentName = 'SwingSparks';
+    static space = '2d';
     static displayName = 'Swing sparks';
     static params = {
         state: { label: 'State' },

package/package.json

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