@waica/archetype-isometric 0.11.0 → 0.13.0

package/assets/ATTRIBUTION.md

@@ -105,3 +105,32 @@ remain at the human-approved 16 texels per render unit.
 - Placeholder-quality by design: exact visual polish is out of scope for
   this run and is the human-verified part of CA-8/CA-12 — a human is free
   to swap this file for a nicer diamond later without touching any code.
+
+## Audio
+
+All four sound files are Creative Commons Zero (CC0). The three effects ship
+byte-for-byte as distributed; only the music was re-encoded (see below).
+
+### Sound effects
+
+- **RPG Audio** and **Impact Sounds** by Kenney Vleugels (Kenney.nl)
+- Sources: https://kenney.nl/assets/rpg-audio and
+  https://kenney.nl/assets/impact-sounds
+- Licence shown by each pack's `License.txt`: **Creative Commons Zero, CC0**.
+  Kenney states: "Credit (Kenney or www.kenney.nl) would be nice but is not
+  mandatory."
+- `waica-iso-sword-swing.ogg` is `knifeSlice.ogg` from RPG Audio.
+- `waica-iso-hit.ogg` is `chop.ogg` from RPG Audio.
+- `waica-iso-hurt.ogg` is `impactPunch_medium_000.ogg` from Impact Sounds.
+
+### Music
+
+- **Town Theme RPG** by cynicmusic
+- Source: https://opengameart.org/content/town-theme-rpg
+- Licence shown by the submission page: **CC0**. The author asks for
+  `cynicmusic.com pixelsphere.org` as credit, which CC0 does not require and
+  this file gives anyway.
+- `waica-iso-town-theme.ogg` is the pack's `TownTheme.mp3` re-encoded to Ogg
+  Vorbis (`ffmpeg -c:a vorbis -q:a 3 -ar 44100`), 97.5 s, no edits to the
+  audio itself. Vorbis rather than Opus so the file plays on the Safari 16.4+
+  baseline the spec commits to; Opus in Ogg needs Safari 17.

package/dist/art.js

@@ -1,11 +1,15 @@
 /** Stock art as Node-safe package data. */
 export const ISOMETRIC_ART = [
-    { file: 'waica-iso-hero.png', uri: 'waica:iso-hero' },
-    { file: 'waica-iso-villager.png', uri: 'waica:iso-villager' },
-    { file: 'waica-iso-orc.png', uri: 'waica:iso-orc' },
-    { file: 'waica-iso-ground.png', uri: 'waica:iso-ground' },
-    { file: 'waica-iso-tree.png', uri: 'waica:iso-tree' },
-    { file: 'waica-iso-rock.png', uri: 'waica:iso-rock' },
-    { file: 'waica-iso-crate.png', uri: 'waica:iso-crate' },
-    { file: 'waica-iso-click-marker.png', uri: 'waica:iso-click-marker' },
+    { file: 'waica-iso-hero.png', uri: 'waica:iso-hero', kind: 'image' },
+    { file: 'waica-iso-villager.png', uri: 'waica:iso-villager', kind: 'image' },
+    { file: 'waica-iso-orc.png', uri: 'waica:iso-orc', kind: 'image' },
+    { file: 'waica-iso-ground.png', uri: 'waica:iso-ground', kind: 'image' },
+    { file: 'waica-iso-tree.png', uri: 'waica:iso-tree', kind: 'image' },
+    { 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-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' },
+    { file: 'waica-iso-town-theme.ogg', uri: 'waica:iso-town-theme', kind: 'sound' },
 ];

package/dist/index.d.ts

@@ -4,12 +4,15 @@ export { ISOMETRIC_BUNDLE } from './bundle.js';
 export { ISOMETRIC_ACTION_LABELS, ISOMETRIC_BINDINGS } from './controls.js';
 export { ISOMETRIC_PREFABS, ISOMETRIC_HERO_SPRITE } from './prefabs.js';
 export { ISOMETRIC_ART_URLS, ISOMETRIC_PALETTE, ISOMETRIC_REGISTRY, } from './registry.js';
-export { ISOMETRIC_BLANK_SCENE, ISOMETRIC_SCENE } from './scene-default.js';
+export { ISOMETRIC_BLANK_SCENE, ISOMETRIC_CAVE_SCENE, ISOMETRIC_SCENE } from './scene-default.js';
 export { ISOMETRIC_UI } from './ui.js';
 export declare const ARCHETYPE: {
     id: string;
     label: string;
     scene: import("@waica/engine").SceneJson;
+    extraScenes: {
+        cave: import("@waica/engine").SceneJson;
+    };
     blankScene: import("@waica/engine").SceneJson;
     palette: import("@waica/engine").EntityTemplate[];
     prefabs: Record<string, import("@waica/engine").PrefabJson>;
@@ -19,6 +22,7 @@ export declare const ARCHETYPE: {
     actionLabels: Readonly<Record<string, string>>;
     bundle: import("@waica/engine").ArchetypeBundle;
     animation: import("@waica/engine").DirectionalAnimation<string>;
+    music: string;
     registry: import("@waica/engine").SceneRegistry;
     artUrls: Record<string, string>;
 };

package/dist/index.js

@@ -6,7 +6,7 @@ export { ISOMETRIC_BUNDLE } from './bundle.js';
 export { ISOMETRIC_ACTION_LABELS, ISOMETRIC_BINDINGS } from './controls.js';
 export { ISOMETRIC_PREFABS, ISOMETRIC_HERO_SPRITE } from './prefabs.js';
 export { ISOMETRIC_ART_URLS, ISOMETRIC_PALETTE, ISOMETRIC_REGISTRY, } from './registry.js';
-export { ISOMETRIC_BLANK_SCENE, ISOMETRIC_SCENE } from './scene-default.js';
+export { ISOMETRIC_BLANK_SCENE, ISOMETRIC_CAVE_SCENE, ISOMETRIC_SCENE } from './scene-default.js';
 export { ISOMETRIC_UI } from './ui.js';
 export const ARCHETYPE = {
     ...DATA_ARCHETYPE,

package/dist/manifest.d.ts

@@ -3,6 +3,9 @@ export declare const ARCHETYPE: {
     id: string;
     label: string;
     scene: import("@waica/engine").SceneJson;
+    extraScenes: {
+        cave: import("@waica/engine").SceneJson;
+    };
     blankScene: import("@waica/engine").SceneJson;
     registry: import("@waica/engine").SceneRegistry;
     palette: import("@waica/engine").EntityTemplate[];
@@ -13,4 +16,5 @@ export declare const ARCHETYPE: {
     actionLabels: Readonly<Record<string, string>>;
     bundle: import("@waica/engine").ArchetypeBundle;
     animation: import("@waica/engine").DirectionalAnimation<string>;
+    music: string;
 };

package/dist/manifest.js

@@ -4,7 +4,7 @@ import { ISOMETRIC_BUNDLE } from './bundle.js';
 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_SCENE } from './scene-default.js';
+import { ISOMETRIC_BLANK_SCENE, ISOMETRIC_CAVE_SCENE, ISOMETRIC_SCENE } from './scene-default.js';
 export const ISOMETRIC_ENTITY_ICONS = {
     IsoMotor: '🧭',
     Tilemap: '💎',
@@ -12,11 +12,13 @@ export const ISOMETRIC_ENTITY_ICONS = {
     Interactable: '💬',
     Collectible: '📦',
     Hazard: '👹',
+    SceneTransition: '🚪',
 };
 export const ARCHETYPE = {
     id: 'isometric',
     label: 'Isometric',
     scene: ISOMETRIC_SCENE,
+    extraScenes: { cave: ISOMETRIC_CAVE_SCENE },
     blankScene: ISOMETRIC_BLANK_SCENE,
     registry: ISOMETRIC_REGISTRY_DATA,
     palette: ISOMETRIC_PALETTE,
@@ -27,4 +29,7 @@ export const ARCHETYPE = {
     actionLabels: ISOMETRIC_ACTION_LABELS,
     bundle: ISOMETRIC_BUNDLE,
     animation: ISOMETRIC_ANIMATION,
+    // G8: the archetype's own looping music bed. The generic project
+    // template (and examples/isometric/src/main.ts) start it if present.
+    music: 'waica:iso-town-theme',
 };

package/dist/prefabs.d.ts

@@ -18,5 +18,9 @@ export declare const ISOMETRIC_HERO_SPRITE: {
     clips: ClipMap;
     initialClip: string;
 };
+/** The second demo scene's ground: smaller and enclosed, so it reads as a distinct map. */
+export declare const ISOMETRIC_CAVE_MAP_WIDTH = 10;
+export declare const ISOMETRIC_CAVE_MAP_HEIGHT = 10;
+export declare const ISOMETRIC_CAVE_GROUND_CELLS: number[];
 export declare const ISOMETRIC_PREFABS: Record<string, PrefabJson>;
 export {};

package/dist/prefabs.js

@@ -67,6 +67,19 @@ function tileAt(column, row) {
     return GRASS;
 }
 const GROUND_CELLS = Array.from({ length: MAP_WIDTH * MAP_HEIGHT }, (_, index) => tileAt(index % MAP_WIDTH, Math.floor(index / MAP_WIDTH)));
+/** The second demo scene's ground: smaller and enclosed, so it reads as a distinct map. */
+export const ISOMETRIC_CAVE_MAP_WIDTH = 10;
+export const ISOMETRIC_CAVE_MAP_HEIGHT = 10;
+function caveTileAt(column, row) {
+    const width = ISOMETRIC_CAVE_MAP_WIDTH;
+    const height = ISOMETRIC_CAVE_MAP_HEIGHT;
+    if (column === 0 || row === 0 || column === width - 1 || row === height - 1)
+        return BORDER;
+    if (column >= 4 && column <= 5 && row >= 4 && row <= 5)
+        return WATER;
+    return DIRT;
+}
+export const ISOMETRIC_CAVE_GROUND_CELLS = Array.from({ length: ISOMETRIC_CAVE_MAP_WIDTH * ISOMETRIC_CAVE_MAP_HEIGHT }, (_, index) => caveTileAt(index % ISOMETRIC_CAVE_MAP_WIDTH, Math.floor(index / ISOMETRIC_CAVE_MAP_WIDTH)));
 export const ISOMETRIC_PREFABS = {
     'characters/player': {
         waicaPrefab: 1,
@@ -83,9 +96,12 @@ export const ISOMETRIC_PREFABS = {
                 },
             },
             { type: 'Hitbox', props: { width: 0.8, height: 0.8 } },
-            { type: 'MeleeAttack' },
+            { type: 'MeleeAttack', props: { swingSound: 'waica:iso-sword-swing' } },
             { type: 'Respawnable' },
-            { type: 'Health', props: { max: 3, invulnerability: 1, stat: 'health' } },
+            {
+                type: 'Health',
+                props: { max: 3, invulnerability: 1, stat: 'health', hurtSound: 'waica:iso-hurt' },
+            },
             {
                 type: 'ClickToMove',
                 props: {
@@ -140,7 +156,7 @@ export const ISOMETRIC_PREFABS = {
             },
             { type: 'Hitbox', props: { width: 0.8, height: 0.7 } },
             { type: 'Hazard', props: { stompable: false, contactDamage: 1 } },
-            { type: 'Health', props: { max: 2, invulnerability: 0.3 } },
+            { type: 'Health', props: { max: 2, invulnerability: 0.3, hurtSound: 'waica:iso-hit' } },
         ],
     },
     'objects/crate': {
@@ -195,6 +211,24 @@ export const ISOMETRIC_PREFABS = {
             { type: 'Solid', props: { width: 0.8, height: 0.6 } },
         ],
     },
+    'objects/door': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [
+            {
+                type: 'Sprite',
+                props: {
+                    texture: 'waica:iso-rock',
+                    pixelArt: true,
+                    width: 1,
+                    height: 1,
+                    anchorY: 0,
+                },
+            },
+            { type: 'Hitbox', props: { width: 0.8, height: 0.8 } },
+            { type: 'SceneTransition', props: { scene: 'cave' } },
+        ],
+    },
     'tiles/ground': {
         waicaPrefab: 1,
         type: 'tile',

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, } from '@waica/behaviors';
+import { Chaser, ClickToMove, Collectible, Hazard, Health, Interactable, IsoMotor, Lifetime, MeleeAttack, Patrol, Respawnable, SceneTransition, } from '@waica/behaviors';
 import { ISOMETRIC_ART } from './art.js';
 import { ISOMETRIC_PREFABS } from './prefabs.js';
 import { ISOMETRIC_UI } from './ui.js';
@@ -23,6 +23,7 @@ export const ISOMETRIC_REGISTRY_DATA = {
         Respawnable,
         Lifetime,
         ClickToMove,
+        SceneTransition,
     },
     resolveAsset: (uri) => PACKAGE_ASSETS[uri] ?? uri,
     prefabs: ISOMETRIC_PREFABS,

package/dist/registry.js

@@ -10,6 +10,10 @@ export const ISOMETRIC_ART_URLS = {
     '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-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,
+    'waica-iso-hurt.ogg': new URL('../assets/waica-iso-hurt.ogg', import.meta.url).href,
+    'waica-iso-town-theme.ogg': new URL('../assets/waica-iso-town-theme.ogg', import.meta.url).href,
 };
 const BUILTIN_ASSETS = Object.fromEntries(ISOMETRIC_ART.map((art) => [art.uri, ISOMETRIC_ART_URLS[art.file] ?? art.uri]));
 export const ISOMETRIC_REGISTRY = {

package/dist/scene-default.d.ts

@@ -3,3 +3,12 @@ import type { SceneJson } from '@waica/engine';
 export declare const ISOMETRIC_SCENE: SceneJson;
 /** Blank projects retain the diamond grid and full-map framing. */
 export declare const ISOMETRIC_BLANK_SCENE: SceneJson;
+/**
+ * The second demo scene (CA-13): a smaller, enclosed cave — reusing
+ * `tiles/ground`'s texture with a distinct, smaller layout (an
+ * entity-level Tilemap override, no new asset) so it reads as a different
+ * map at a glance. The incoming Player is authored here, not carried from
+ * `main` (grill decision 18): crossing back through the Door lands at this
+ * scene's own entry, not beside where the player left.
+ */
+export declare const ISOMETRIC_CAVE_SCENE: SceneJson;

package/dist/scene-default.js

@@ -1,3 +1,4 @@
+import { ISOMETRIC_CAVE_GROUND_CELLS, ISOMETRIC_CAVE_MAP_HEIGHT, ISOMETRIC_CAVE_MAP_WIDTH, } from './prefabs.js';
 /**
  * Full-map framing plus a follow feel tuned for the diamond: a tight dead
  * zone and no horizontal lookahead (the engine's step kicks in every time
@@ -47,6 +48,12 @@ export const ISOMETRIC_SCENE = {
         { name: 'Tree-3', prefab: 'objects/tree', position: [12, 3] },
         { name: 'Rock-1', prefab: 'objects/rock', position: [5, 11] },
         { name: 'Rock-2', prefab: 'objects/rock', position: [9, 4] },
+        // The Scene Transition into the second demo scene: tucked in the
+        // north-west corner, well clear of every other prop, of the player's
+        // start-area walking radius, and of the click-to-move destinations the
+        // 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] },
     ],
     ui: ['crate-counter', 'health'],
 };
@@ -57,3 +64,46 @@ export const ISOMETRIC_BLANK_SCENE = {
     camera: isometricCamera(),
     entities: [],
 };
+/**
+ * The second demo scene (CA-13): a smaller, enclosed cave — reusing
+ * `tiles/ground`'s texture with a distinct, smaller layout (an
+ * entity-level Tilemap override, no new asset) so it reads as a different
+ * map at a glance. The incoming Player is authored here, not carried from
+ * `main` (grill decision 18): crossing back through the Door lands at this
+ * scene's own entry, not beside where the player left.
+ */
+export const ISOMETRIC_CAVE_SCENE = {
+    waicaScene: 3,
+    render: { sort: 'y', projection: 'isometric' },
+    camera: {
+        ...isometricCamera(),
+        position: [0, -5],
+        limits: { minX: -10, maxX: 10, minY: -10, maxY: 0 },
+        follow: 'Player',
+    },
+    entities: [
+        {
+            name: 'Ground',
+            prefab: 'tiles/ground',
+            position: [0, 0],
+            overrides: {
+                Tilemap: {
+                    mapWidth: ISOMETRIC_CAVE_MAP_WIDTH,
+                    mapHeight: ISOMETRIC_CAVE_MAP_HEIGHT,
+                    cells: ISOMETRIC_CAVE_GROUND_CELLS,
+                },
+            },
+        },
+        { name: 'Player', prefab: 'characters/player', position: [2, 7] },
+        { name: 'Rock-1', prefab: 'objects/rock', position: [7, 3] },
+        { name: 'Rock-2', prefab: 'objects/rock', position: [2, 2] },
+        // Returns to the meadow, clear of the cave's rocks and water pool.
+        {
+            name: 'Door',
+            prefab: 'objects/door',
+            position: [8, 2],
+            overrides: { SceneTransition: { scene: 'main' } },
+        },
+    ],
+    ui: ['health'],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-isometric",
-  "version": "0.11.0",
+  "version": "0.13.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.11.0",
-    "@waica/engine": "^0.11.0"
+    "@waica/behaviors": "^0.13.0",
+    "@waica/engine": "^0.13.0"
   }
 }