@waica/archetype-isometric 0.10.0 → 0.12.0

package/assets/ATTRIBUTION.md

@@ -92,3 +92,16 @@ 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 |
+
+## Click-to-move destination marker
+
+- **Original**, not sourced from Puny Characters or the hawkbirdtree tileset:
+  a flat gold rhombus (translucent fill, brighter outline), generated
+  programmatically at 2026-08-30 for the point-and-click feature (CA-8/CA-9
+  of `.sdd/specs/point-and-click-grid-role.md`) — CC0, same terms as the
+  rest of this archetype's own art.
+- `waica-iso-click-marker.png`: 32×16 (matches the 2:1 diamond aspect of the
+  ground tileset, halved), transparent background.
+- 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.

package/dist/art.js

@@ -7,4 +7,5 @@ export const ISOMETRIC_ART = [
     { 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' },
 ];

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>;

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[];

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,

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,
@@ -86,6 +99,14 @@ export const ISOMETRIC_PREFABS = {
             { type: 'MeleeAttack' },
             { type: 'Respawnable' },
             { type: 'Health', props: { max: 3, invulnerability: 1, stat: 'health' } },
+            {
+                type: 'ClickToMove',
+                props: {
+                    markerTexture: 'waica:iso-click-marker',
+                    markerWidth: 1,
+                    markerHeight: 0.5,
+                },
+            },
         ],
     },
     'characters/villager': {
@@ -187,6 +208,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, 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';
@@ -22,6 +22,8 @@ export const ISOMETRIC_REGISTRY_DATA = {
         Health,
         Respawnable,
         Lifetime,
+        ClickToMove,
+        SceneTransition,
     },
     resolveAsset: (uri) => PACKAGE_ASSETS[uri] ?? uri,
     prefabs: ISOMETRIC_PREFABS,

package/dist/registry.js

@@ -9,6 +9,7 @@ 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-click-marker.png': new URL('../assets/waica-iso-click-marker.png', 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.10.0",
+  "version": "0.12.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.10.0",
-    "@waica/engine": "^0.10.0"
+    "@waica/behaviors": "^0.12.0",
+    "@waica/engine": "^0.12.0"
   }
 }