@waica/archetype-topdown 0.20.0 → 0.22.0

package/dist/controls.d.ts

@@ -1,5 +1,5 @@
 import type { InputBindings } from '@waica/engine';
-/** Top-down actions: four directions plus interact, arrows and WASD. */
+/** Top-down actions: four directions plus interact; arrows and WASD, the left stick, D-pad and A (ADR 0023). */
 export declare const TOPDOWN_BINDINGS: Readonly<InputBindings>;
 /** Friendly labels shown by the editor's controls panel. */
 export declare const TOPDOWN_ACTION_LABELS: Readonly<Record<string, string>>;

package/dist/controls.js

@@ -1,10 +1,10 @@
-/** Top-down actions: four directions plus interact, arrows and WASD. */
+/** Top-down actions: four directions plus interact; arrows and WASD, the left stick, D-pad and A (ADR 0023). */
 export const TOPDOWN_BINDINGS = {
-    up: ['ArrowUp', 'KeyW'],
-    down: ['ArrowDown', 'KeyS'],
-    left: ['ArrowLeft', 'KeyA'],
-    right: ['ArrowRight', 'KeyD'],
-    interact: ['KeyE', 'Space'],
+    up: ['ArrowUp', 'KeyW', 'Gamepad:LeftStickUp', 'Gamepad:DPadUp'],
+    down: ['ArrowDown', 'KeyS', 'Gamepad:LeftStickDown', 'Gamepad:DPadDown'],
+    left: ['ArrowLeft', 'KeyA', 'Gamepad:LeftStickLeft', 'Gamepad:DPadLeft'],
+    right: ['ArrowRight', 'KeyD', 'Gamepad:LeftStickRight', 'Gamepad:DPadRight'],
+    interact: ['KeyE', 'Space', 'Gamepad:A'],
 };
 /** Friendly labels shown by the editor's controls panel. */
 export const TOPDOWN_ACTION_LABELS = {

package/dist/prefabs.js

@@ -1,5 +1,26 @@
 import { NPC_STATE_GRAPH, TOPDOWN_PLAYER_STATE_GRAPH } from '@waica/behaviors';
 import { HERO_SPRITE } from './scene-default.js';
+/** The hero's walking dust: faint puffs left behind, drifting up and fading. */
+const WALK_DUST = {
+    rate: 16,
+    emitting: false,
+    lifetime: 0.6,
+    positionSpread: [0.2, 0.08],
+    velocity: [0, 0.25],
+    velocitySpread: [0.35, 0.2],
+    space: 'world',
+    seed: 13,
+    capacity: 48,
+    width: 0.16,
+    height: 0.16,
+    startScale: 0.8,
+    endScale: 1.8,
+    startColor: 0xe0cfa8,
+    endColor: 0xb8a888,
+    startAlpha: 0.45,
+    endAlpha: 0,
+    layer: -0.5,
+};
 /**
  * The archetype's reusable entity templates, keyed by ref ('tiles/tree').
  * Scenes reference these and override per-entity props; the palette derives
@@ -30,6 +51,11 @@ export const TOPDOWN_PREFABS = {
             },
             { type: 'Respawnable' },
             { type: 'Health', props: { max: 3, invulnerability: 1 } },
+            // A soft dust trail: a continuous emitter authored with
+            // emitting: false, switched on by DustTrail only while walking.
+            // Layer -0.5 sits between the ground tiles and the characters.
+            { type: 'ParticleEmitter', props: WALK_DUST },
+            { type: 'DustTrail', props: { state: 'walk' } },
         ],
     },
     'characters/villager': {

package/dist/registry-data.js

@@ -1,5 +1,5 @@
 import { AnimatedSprite, Hitbox, ParticleEmitter, Solid, Sprite, StateMachine, Tilemap, } from '@waica/engine';
-import { Chaser, ClickToMove, Collectible, Hazard, Health, Interactable, Lifetime, Patrol, Respawnable, SceneTransition, TopDownMotor, } from '@waica/behaviors';
+import { Chaser, ClickToMove, Collectible, DustTrail, Hazard, Health, Interactable, Lifetime, Patrol, Respawnable, SceneTransition, TopDownMotor, } from '@waica/behaviors';
 import { TOPDOWN_ART } from './art.js';
 import { TOPDOWN_PREFABS } from './prefabs.js';
 import { TOPDOWN_UI } from './ui.js';
@@ -19,6 +19,7 @@ export const TOPDOWN_REGISTRY_DATA = {
         Hitbox,
         StateMachine,
         TopDownMotor,
+        DustTrail,
         Interactable,
         Collectible,
         Patrol,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-topdown",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Waica top-down archetype — opinionated setup for Zelda-like overhead adventures",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@waica/behaviors": "^0.20.0",
-    "@waica/engine": "^0.20.0"
+    "@waica/behaviors": "^0.22.0",
+    "@waica/engine": "^0.22.0"
   }
 }