@waica/archetype-isometric 0.24.0 → 0.25.0

package/assets/ATTRIBUTION.md

@@ -92,6 +92,31 @@ remain at the human-approved 16 texels per render unit.
 | `waica-iso-tree.png` | `(768,208,832,304)`, transparent bottom trimmed | 64×94 |
 | `waica-iso-rock.png` | `(784,868,814,890)`, padded at `(1,10)` | 32×32 |
 | `waica-iso-crate.png` | `(896,832,960,896)`, nearest-resized | 32×32 |
+| `waica-iso-wall.png` | `(448,1152,512,1216)`, the grey-blue stone cube (4th of the row of four); pixels outside its hexagon `(32,0) (64,16) (64,48) (32,64) (0,48) (0,16)` cleared (52 pixels of the neighbouring tile's tip) | 64×64 |
+
+The dungeon (issue #78) draws its stone floor with index 4 (`border`) of
+`waica-iso-ground.png`, the grey stone with a cross at `(960,640,1024,672)`:
+no new floor art. The wall cube is native at 32 texels per render unit (2×2
+units), so its base diamond is exactly one 64×32 cell; its Sprite sets
+`anchorY: 0.25`, the base diamond's centre.
+
+## Animated Pixel Torch
+
+- **Animated Pixel Torch** by XLIVE99
+- Source: https://opengameart.org/content/animated-pixel-torch
+- Licence: **Creative Commons Zero (CC0)**.
+- Source file: `Torch/Torch_Sheet.png` (96×64, 3 columns × 2 rows of 32×32
+  frames). Only that PNG was used; its pixels were copied into a fresh PNG
+  with no ancillary chunks. None of the pack's other files ships.
+
+| Output file | Source | Output size |
+|---|---|---:|
+| `waica-iso-torch.png` | the whole sheet, pixels unchanged | 96×64 |
+
+Each frame is native at 32 texels per render unit (1×1 unit). The torch's
+handle ends at row 30 of each frame, so its AnimatedSprite sets
+`anchorY: 2/32`. Rows 10–15 around columns 15–16 are flame in all six
+frames: the dungeon e2e samples the flame there.
 
 ## Click-to-move destination marker
 

package/dist/art.js

@@ -8,6 +8,8 @@ export const ISOMETRIC_ART = [
     { file: 'waica-iso-rock.png', uri: 'waica:iso-rock', kind: 'image' },
     { file: 'waica-iso-crate.png', uri: 'waica:iso-crate', kind: 'image' },
     { file: 'waica-iso-click-marker.png', uri: 'waica:iso-click-marker', kind: 'image' },
+    { file: 'waica-iso-wall.png', uri: 'waica:iso-wall', kind: 'image' },
+    { file: 'waica-iso-torch.png', uri: 'waica:iso-torch', kind: 'image' },
     { file: 'waica-iso-sword-swing.ogg', uri: 'waica:iso-sword-swing', kind: 'sound' },
     { file: 'waica-iso-hit.ogg', uri: 'waica:iso-hit', kind: 'sound' },
     { file: 'waica-iso-hurt.ogg', uri: 'waica:iso-hurt', kind: 'sound' },

package/dist/dungeon.d.ts

@@ -0,0 +1,25 @@
+import type { PrefabJson, SceneJson } from '@waica/engine';
+/** The dungeon's ground: 10×10, a stone floor (`tiles/ground` index 4) and walls. */
+export declare const ISOMETRIC_DUNGEON_MAP_WIDTH = 10;
+export declare const ISOMETRIC_DUNGEON_MAP_HEIGHT = 10;
+export declare const ISOMETRIC_DUNGEON_GROUND_CELLS: (1 | 4)[];
+/**
+ * A stone wall cube (hawkbirdtree, CC0): 64×64 at 32 texels per unit, so its
+ * base diamond is exactly one cell; anchorY 0.25 sets the base diamond's
+ * centre on the entity. Collision and occlusion come from the cell's solid
+ * tile, not from this Sprite.
+ */
+export declare const ISOMETRIC_WALL_PREFAB: PrefabJson;
+/**
+ * A torch (issue #78; art "Animated Pixel Torch" by XLIVE99, CC0): six 32×32
+ * frames, Emissive so the flame stays bright whatever the Ambient Light, and
+ * a warm Light that the walls stop — a pool of light, not the whole room.
+ */
+export declare const ISOMETRIC_TORCH_PREFAB: PrefabJson;
+/**
+ * The third demo scene (issue #78 CA-14): a dark dungeon reached from the
+ * cave. Two torches on the floor light the hall; the wall down its middle
+ * keeps the chamber behind it dark, and a vignette closes the frame. A fixed
+ * camera frames the whole room.
+ */
+export declare const ISOMETRIC_DUNGEON_SCENE: SceneJson;

package/dist/dungeon.js

@@ -0,0 +1,113 @@
+/** The dungeon's ground: 10×10, a stone floor (`tiles/ground` index 4) and walls. */
+export const ISOMETRIC_DUNGEON_MAP_WIDTH = 10;
+export const ISOMETRIC_DUNGEON_MAP_HEIGHT = 10;
+/** The grey stone with a cross: the floor. */
+const STONE = 4;
+/** Under every wall cube: flat dirt nobody sees, the dungeon's only solid tile. */
+const WALL = 1;
+/** The wall between the torch-lit hall and the dark chamber, open at its far end. */
+const WALL_COLUMN = 5;
+const WALL_GAP_ROW = 8;
+function isWall(column, row) {
+    const width = ISOMETRIC_DUNGEON_MAP_WIDTH;
+    const height = ISOMETRIC_DUNGEON_MAP_HEIGHT;
+    if (column === 0 || row === 0 || column === width - 1 || row === height - 1)
+        return true;
+    return column === WALL_COLUMN && row !== WALL_GAP_ROW;
+}
+export const ISOMETRIC_DUNGEON_GROUND_CELLS = Array.from({ length: ISOMETRIC_DUNGEON_MAP_WIDTH * ISOMETRIC_DUNGEON_MAP_HEIGHT }, (_, index) => isWall(index % ISOMETRIC_DUNGEON_MAP_WIDTH, Math.floor(index / ISOMETRIC_DUNGEON_MAP_WIDTH)) ? WALL : STONE);
+/** One wall cube per solid cell, on the cell's centre (the Tilemap draws only flat cells). */
+function wallEntities() {
+    return ISOMETRIC_DUNGEON_GROUND_CELLS.flatMap((tile, index) => {
+        if (tile !== WALL)
+            return [];
+        const column = index % ISOMETRIC_DUNGEON_MAP_WIDTH;
+        const row = Math.floor(index / ISOMETRIC_DUNGEON_MAP_WIDTH);
+        return [{ name: `Wall-${column}-${row}`, prefab: 'objects/wall', position: [column + 0.5, row + 0.5] }];
+    });
+}
+/**
+ * A stone wall cube (hawkbirdtree, CC0): 64×64 at 32 texels per unit, so its
+ * base diamond is exactly one cell; anchorY 0.25 sets the base diamond's
+ * centre on the entity. Collision and occlusion come from the cell's solid
+ * tile, not from this Sprite.
+ */
+export const ISOMETRIC_WALL_PREFAB = {
+    waicaPrefab: 1,
+    type: 'object',
+    components: [
+        { type: 'Sprite', props: { texture: 'waica:iso-wall', pixelArt: true, width: 2, height: 2, anchorY: 0.25 } },
+    ],
+};
+/**
+ * A torch (issue #78; art "Animated Pixel Torch" by XLIVE99, CC0): six 32×32
+ * frames, Emissive so the flame stays bright whatever the Ambient Light, and
+ * a warm Light that the walls stop — a pool of light, not the whole room.
+ */
+export const ISOMETRIC_TORCH_PREFAB = {
+    waicaPrefab: 1,
+    type: 'object',
+    components: [
+        {
+            type: 'AnimatedSprite',
+            props: {
+                texture: 'waica:iso-torch',
+                cols: 3,
+                rows: 2,
+                pixelArt: true,
+                width: 1,
+                height: 1,
+                anchorY: 2 / 32,
+                clips: { burn: { frames: [0, 1, 2, 3, 4, 5], fps: 8 } },
+                initialClip: 'burn',
+                emissive: true,
+            },
+        },
+        {
+            type: 'Light',
+            props: { radius: 3, color: 0xffb366, intensity: 1, softness: 0.25 },
+        },
+    ],
+};
+/**
+ * The third demo scene (issue #78 CA-14): a dark dungeon reached from the
+ * cave. Two torches on the floor light the hall; the wall down its middle
+ * keeps the chamber behind it dark, and a vignette closes the frame. A fixed
+ * camera frames the whole room.
+ */
+export const ISOMETRIC_DUNGEON_SCENE = {
+    waicaScene: 3,
+    render: {
+        sort: 'y',
+        projection: 'isometric',
+        lighting: { ambient: { color: '#5a6a9a', intensity: 0.3 } },
+        post: { vignette: { intensity: 0.45, radius: 0.35 } },
+    },
+    camera: { position: [0, -5], zoom: 12 },
+    entities: [
+        {
+            name: 'Ground',
+            prefab: 'tiles/ground',
+            position: [0, 0],
+            overrides: {
+                Tilemap: {
+                    mapWidth: ISOMETRIC_DUNGEON_MAP_WIDTH,
+                    mapHeight: ISOMETRIC_DUNGEON_MAP_HEIGHT,
+                    cells: ISOMETRIC_DUNGEON_GROUND_CELLS,
+                    solidTiles: [WALL],
+                },
+            },
+        },
+        { name: 'Player', prefab: 'characters/player', position: [2, 8] },
+        { name: 'Torch-1', prefab: 'objects/torch', position: [3.5, 3.5] },
+        { name: 'Torch-2', prefab: 'objects/torch', position: [3.5, 5.5] },
+        {
+            name: 'Door',
+            prefab: 'objects/door',
+            position: [1.5, 1.5],
+            overrides: { SceneTransition: { scene: 'cave' } },
+        },
+        ...wallEntities(),
+    ],
+    ui: ['health'],
+};

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export declare const ARCHETYPE: {
     scene: import("@waica/engine").SceneJson;
     extraScenes: {
         cave: import("@waica/engine").SceneJson;
+        dungeon: import("@waica/engine").SceneJson;
     };
     blankScene: import("@waica/engine").SceneJson;
     palette: import("@waica/engine").EntityTemplate[];

package/dist/manifest.d.ts

@@ -5,6 +5,7 @@ export declare const ARCHETYPE: {
     scene: import("@waica/engine").SceneJson;
     extraScenes: {
         cave: import("@waica/engine").SceneJson;
+        dungeon: import("@waica/engine").SceneJson;
     };
     blankScene: import("@waica/engine").SceneJson;
     registry: import("@waica/engine").SceneRegistry;

package/dist/manifest.js

@@ -5,6 +5,7 @@ import { ISOMETRIC_ACTION_LABELS, ISOMETRIC_BINDINGS } from './controls.js';
 import { ISOMETRIC_PREFABS } from './prefabs.js';
 import { ISOMETRIC_PALETTE, ISOMETRIC_REGISTRY_DATA } from './registry-data.js';
 import { ISOMETRIC_BLANK_SCENE, ISOMETRIC_CAVE_SCENE, ISOMETRIC_SCENE } from './scene-default.js';
+import { ISOMETRIC_DUNGEON_SCENE } from './dungeon.js';
 export const ISOMETRIC_ENTITY_ICONS = {
     IsoMotor: '🧭',
     Tilemap: '💎',
@@ -18,7 +19,7 @@ export const ARCHETYPE = {
     id: 'isometric',
     label: 'Isometric',
     scene: ISOMETRIC_SCENE,
-    extraScenes: { cave: ISOMETRIC_CAVE_SCENE },
+    extraScenes: { cave: ISOMETRIC_CAVE_SCENE, dungeon: ISOMETRIC_DUNGEON_SCENE },
     blankScene: ISOMETRIC_BLANK_SCENE,
     registry: ISOMETRIC_REGISTRY_DATA,
     palette: ISOMETRIC_PALETTE,

package/dist/prefabs.js

@@ -1,5 +1,6 @@
 import { ISO_PLAYER_STATE_GRAPH, NPC_STATE_GRAPH, PATROLLER_STATE_GRAPH, } from '@waica/behaviors';
 import { ISOMETRIC_EFFECT_PREFABS, SWORD_SPARKS } from './effect-prefabs.js';
+import { ISOMETRIC_TORCH_PREFAB, ISOMETRIC_WALL_PREFAB } from './dungeon.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;
@@ -238,6 +239,8 @@ export const ISOMETRIC_PREFABS = {
         ],
     },
     ...ISOMETRIC_EFFECT_PREFABS,
+    'objects/torch': ISOMETRIC_TORCH_PREFAB,
+    'objects/wall': ISOMETRIC_WALL_PREFAB,
     'objects/door': {
         waicaPrefab: 1,
         type: 'object',

package/dist/registry-data.js

@@ -1,4 +1,4 @@
-import { AnimatedSprite, Hitbox, ParticleEmitter, Solid, Sprite, StateMachine, Tilemap, } from '@waica/engine';
+import { AnimatedSprite, Hitbox, Light, 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';
@@ -9,6 +9,7 @@ export const ISOMETRIC_REGISTRY_DATA = {
         Sprite,
         AnimatedSprite,
         ParticleEmitter,
+        Light,
         Tilemap,
         Solid,
         Hitbox,
@@ -42,6 +43,8 @@ const PALETTE_ICONS = {
     wind: '🌬️',
     'hurt-smoke': '💨',
     'cave-dust': '✨',
+    torch: '🔥',
+    wall: '🧱',
     ground: '💎',
 };
 export const ISOMETRIC_PALETTE = Object.entries(ISOMETRIC_PREFABS).map(([key, prefab]) => {

package/dist/registry.js

@@ -9,6 +9,8 @@ export const ISOMETRIC_ART_URLS = {
     'waica-iso-tree.png': new URL('../assets/waica-iso-tree.png', import.meta.url).href,
     'waica-iso-rock.png': new URL('../assets/waica-iso-rock.png', import.meta.url).href,
     'waica-iso-crate.png': new URL('../assets/waica-iso-crate.png', import.meta.url).href,
+    'waica-iso-wall.png': new URL('../assets/waica-iso-wall.png', import.meta.url).href,
+    'waica-iso-torch.png': new URL('../assets/waica-iso-torch.png', import.meta.url).href,
     'waica-iso-click-marker.png': new URL('../assets/waica-iso-click-marker.png', import.meta.url).href,
     'waica-iso-sword-swing.ogg': new URL('../assets/waica-iso-sword-swing.ogg', import.meta.url).href,
     'waica-iso-hit.ogg': new URL('../assets/waica-iso-hit.ogg', import.meta.url).href,

package/dist/scene-default.js

@@ -114,6 +114,14 @@ export const ISOMETRIC_CAVE_SCENE = {
             position: [8, 2],
             overrides: { SceneTransition: { scene: 'main' } },
         },
+        // Down to the torch-lit dungeon (issue #78 CA-14), clear of the
+        // Player's entry, the rocks and the way back to the meadow.
+        {
+            name: 'DungeonDoor',
+            prefab: 'objects/door',
+            position: [7, 7],
+            overrides: { SceneTransition: { scene: 'dungeon' } },
+        },
         // An enclosed room has no wind: a few faint motes drift instead.
         {
             name: 'Dust',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-isometric",
-  "version": "0.24.0",
+  "version": "0.25.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.24.0",
-    "@waica/engine": "^0.24.0"
+    "@waica/behaviors": "^0.25.0",
+    "@waica/engine": "^0.25.0"
   }
 }