@waica/archetype-isometric 0.19.2 → 0.21.0

package/dist/effect-prefabs.d.ts

@@ -0,0 +1,29 @@
+import type { PrefabJson } from '@waica/engine';
+/** The hero's sword-swing sparks: warm, short-lived, thrown up the screen and pulled back down. */
+export declare const SWORD_SPARKS: {
+    rate: number;
+    lifetime: number;
+    positionSpread: number[];
+    velocity: number[];
+    velocitySpread: number[];
+    gravity: number[];
+    space: string;
+    seed: number;
+    capacity: number;
+    width: number;
+    height: number;
+    startScale: number;
+    endScale: number;
+    startColor: number;
+    endColor: number;
+    startAlpha: number;
+    endAlpha: number;
+    blend: string;
+    layer: number;
+};
+/**
+ * The demo's particle effects as placeable objects: no sprite, only an
+ * emitter (plus DamagePuff for the hurt smoke). Scenes place them like any
+ * other prop, and the palette offers them.
+ */
+export declare const ISOMETRIC_EFFECT_PREFABS: Record<string, PrefabJson>;

package/dist/effect-prefabs.js

@@ -0,0 +1,108 @@
+/** The hero's sword-swing sparks: warm, short-lived, thrown up the screen and pulled back down. */
+export const SWORD_SPARKS = {
+    rate: 0,
+    lifetime: 0.3,
+    positionSpread: [0.25, 0.25],
+    velocity: [-1.8, -1.8],
+    velocitySpread: [2.6, 2.6],
+    gravity: [3, 3],
+    space: 'world',
+    seed: 7,
+    capacity: 64,
+    width: 0.16,
+    height: 0.16,
+    startScale: 1,
+    endScale: 0.3,
+    startColor: 0xffc21a,
+    endColor: 0xff3a00,
+    startAlpha: 1,
+    endAlpha: 0,
+    blend: 'normal',
+    layer: 1,
+};
+/** Continuous wind streaks covering the whole 16x16 meadow from the scene's Wind position ([8, 6]). */
+const WIND = {
+    rate: 22,
+    lifetime: 1.4,
+    positionSpread: [9, 10],
+    velocity: [2.2, -2.2],
+    velocitySpread: [0.4, 0.4],
+    space: 'world',
+    seed: 3,
+    capacity: 64,
+    width: 1.8,
+    height: 0.06,
+    startScale: 1,
+    endScale: 1.6,
+    startColor: 0xe8f4ff,
+    endColor: 0xe8f4ff,
+    startAlpha: 0.6,
+    endAlpha: 0,
+    layer: 0,
+};
+/** A burst-only grey puff rising off whatever took damage, drawn over the sprites. */
+const HURT_SMOKE = {
+    rate: 0,
+    lifetime: 0.6,
+    positionSpread: [0.2, 0.2],
+    velocity: [-0.6, -0.6],
+    velocitySpread: [0.8, 0.8],
+    gravity: [0.4, 0.4],
+    space: 'world',
+    seed: 11,
+    capacity: 64,
+    width: 0.3,
+    height: 0.3,
+    startScale: 0.6,
+    endScale: 1.8,
+    startColor: 0xdddddd,
+    endColor: 0x777777,
+    startAlpha: 0.7,
+    endAlpha: 0,
+    layer: 1,
+};
+/** Slow, faint motes over the 10x10 cave's floor (inside its border ring) when placed at its center. */
+const CAVE_DUST = {
+    rate: 5,
+    lifetime: 3,
+    positionSpread: [4, 4],
+    velocity: [-0.1, -0.1],
+    velocitySpread: [0.15, 0.15],
+    space: 'world',
+    seed: 5,
+    capacity: 32,
+    width: 0.12,
+    height: 0.12,
+    startScale: 1,
+    endScale: 0.5,
+    startColor: 0xfff0c8,
+    endColor: 0xfff0c8,
+    startAlpha: 0.7,
+    endAlpha: 0,
+    layer: 0,
+};
+/**
+ * The demo's particle effects as placeable objects: no sprite, only an
+ * emitter (plus DamagePuff for the hurt smoke). Scenes place them like any
+ * other prop, and the palette offers them.
+ */
+export const ISOMETRIC_EFFECT_PREFABS = {
+    'objects/wind': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [{ type: 'ParticleEmitter', props: WIND }],
+    },
+    'objects/hurt-smoke': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [
+            { type: 'ParticleEmitter', props: HURT_SMOKE },
+            { type: 'DamagePuff', props: { count: 10 } },
+        ],
+    },
+    'objects/cave-dust': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [{ type: 'ParticleEmitter', props: CAVE_DUST }],
+    },
+};

package/dist/prefabs.js

@@ -1,4 +1,5 @@
 import { ISO_PLAYER_STATE_GRAPH, NPC_STATE_GRAPH, PATROLLER_STATE_GRAPH, } from '@waica/behaviors';
+import { ISOMETRIC_EFFECT_PREFABS, SWORD_SPARKS } from './effect-prefabs.js';
 const SHIPPED_DIRECTIONS = ['n', 'ne', 'e', 'se', 's'];
 /** One row per shipped facing: idle · walk×3 · attack×3 · hurt×2 · death×2. */
 const SHEET_COLUMNS = 11;
@@ -113,6 +114,11 @@ export const ISOMETRIC_PREFABS = {
                     markerHeight: 0.5,
                 },
             },
+            // Sword sparks: a burst-only emitter SwingSparks fires on entering
+            // 'attack'. It draws on layer 1, over the y-sorted sprites, so the
+            // flash reads in front of the hero.
+            { type: 'ParticleEmitter', props: SWORD_SPARKS },
+            { type: 'SwingSparks', props: { state: 'attack', count: 18 } },
         ],
     },
     'characters/villager': {
@@ -231,6 +237,7 @@ export const ISOMETRIC_PREFABS = {
             { type: 'Solid', props: { width: 0.8, height: 0.6 } },
         ],
     },
+    ...ISOMETRIC_EFFECT_PREFABS,
     'objects/door': {
         waicaPrefab: 1,
         type: 'object',

package/dist/registry-data.js

@@ -1,5 +1,5 @@
-import { AnimatedSprite, Hitbox, Solid, Sprite, StateMachine, Tilemap, } from '@waica/engine';
-import { Chaser, ClickToMove, Collectible, Hazard, Health, Interactable, IsoMotor, Lifetime, MeleeAttack, Patrol, Respawnable, SceneTransition, } from '@waica/behaviors';
+import { AnimatedSprite, Hitbox, ParticleEmitter, Solid, Sprite, StateMachine, Tilemap, } from '@waica/engine';
+import { Chaser, ClickToMove, Collectible, DamagePuff, Hazard, Health, Interactable, IsoMotor, Lifetime, MeleeAttack, Patrol, Respawnable, SceneTransition, SwingSparks, } from '@waica/behaviors';
 import { ISOMETRIC_ART } from './art.js';
 import { ISOMETRIC_PREFABS } from './prefabs.js';
 import { ISOMETRIC_UI } from './ui.js';
@@ -8,12 +8,15 @@ export const ISOMETRIC_REGISTRY_DATA = {
     components: {
         Sprite,
         AnimatedSprite,
+        ParticleEmitter,
         Tilemap,
         Solid,
         Hitbox,
         StateMachine,
         IsoMotor,
         MeleeAttack,
+        SwingSparks,
+        DamagePuff,
         Interactable,
         Collectible,
         Patrol,
@@ -36,6 +39,9 @@ const PALETTE_ICONS = {
     crate: '📦',
     tree: '🌳',
     rock: '🪨',
+    wind: '🌬️',
+    'hurt-smoke': '💨',
+    'cave-dust': '✨',
     ground: '💎',
 };
 export const ISOMETRIC_PALETTE = Object.entries(ISOMETRIC_PREFABS).map(([key, prefab]) => {

package/dist/scene-default.js

@@ -54,6 +54,16 @@ export const ISOMETRIC_SCENE = {
         // isometric e2e leg exercises (CA-13) — a Door placed inside any of
         // those previously fired mid-test.
         { name: 'Door', prefab: 'objects/door', position: [2, 2] },
+        // Ambient wind over the whole meadow: thin translucent streaks drifting
+        // screen-right (logical [+x, -y]) in world space, on layer 0 so each
+        // streak y-sorts among the sprites (it can pass behind a tree). Placed
+        // two cells off the Player's spawn so the two editor markers never
+        // overlap; its spread still covers the whole map from here.
+        { name: 'Wind', prefab: 'objects/wind', position: [8, 6] },
+        // One hurt-smoke source for every Health in the scene: DamagePuff moves
+        // it to whoever takes damage and puffs there. Parked in the empty
+        // south corner until the first hit, clear of the Ground's origin marker.
+        { name: 'HurtSmoke', prefab: 'objects/hurt-smoke', position: [14, 14] },
     ],
     ui: ['crate-counter', 'health'],
 };
@@ -104,6 +114,12 @@ export const ISOMETRIC_CAVE_SCENE = {
             position: [8, 2],
             overrides: { SceneTransition: { scene: 'main' } },
         },
+        // An enclosed room has no wind: a few faint motes drift instead.
+        {
+            name: 'Dust',
+            prefab: 'objects/cave-dust',
+            position: [ISOMETRIC_CAVE_MAP_WIDTH / 2, ISOMETRIC_CAVE_MAP_HEIGHT / 2],
+        },
     ],
     ui: ['health'],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-isometric",
-  "version": "0.19.2",
+  "version": "0.21.0",
   "description": "Waica isometric archetype — logical-grid action adventures with screen-relative movement",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@waica/behaviors": "^0.19.2",
-    "@waica/engine": "^0.19.2"
+    "@waica/behaviors": "^0.21.0",
+    "@waica/engine": "^0.21.0"
   }
 }