@waica/archetype-isometric 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ayrton Marini and Waica contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/ATTRIBUTION.md

@@ -0,0 +1,72 @@
+# Art attribution and composition receipt
+
+All source art is Creative Commons Zero (CC0). The run recomposed these files
+offline from originals retained outside the repository at
+`~/Sync/workspace/waica-art-src/iso-kit-a/`.
+
+## Puny Characters
+
+- **Puny Characters** by Shade (merchant-shade)
+- Source: https://merchant-shade.itch.io/16x16-puny-characters
+- Mirror: https://opengameart.org/content/puny-characters
+- Licence shown by the source page: **Creative Commons Zero v1.0 Universal**.
+  The author also states: “No need to give me credit.”
+- Source files: `puny-characters/orcs/Puny-Characters/Warrior-Blue.png`,
+  `Human-Worker-Red.png`, and `Orc-Grunt.png` (each 768×256, 24×8 cells
+  of 32×32).
+
+Each output character sheet is 4 columns × 5 rows of native 32×32 cells with
+one transparent pixel between cells. Output columns are source columns 0, 1,
+2 and 3: idle followed by the three walk poses. Output rows and exact source
+cell rectangles are:
+
+| Output facing | Source row | Cell rectangles `(left, top, right, bottom)` |
+|---|---:|---|
+| `n` | 4 | `(0,128,32,160)`, `(32,128,64,160)`, `(64,128,96,160)`, `(96,128,128,160)` |
+| `ne` | 5 | `(0,160,32,192)`, `(32,160,64,192)`, `(64,160,96,192)`, `(96,160,128,192)` |
+| `e` | 6 | `(0,192,32,224)`, `(32,192,64,224)`, `(64,192,96,224)`, `(96,192,128,224)` |
+| `se` | 7 | `(0,224,32,256)`, `(32,224,64,256)`, `(64,224,96,256)`, `(96,224,128,256)` |
+| `s` | 0 | `(0,0,32,32)`, `(32,0,64,32)`, `(64,0,96,32)`, `(96,0,128,32)` |
+
+The offline composition compared every one of those four poses against the
+source mirror pair. Source row 2 (`w`) is the pixel-exact horizontal mirror of
+row 6 (`e`), row 3 (`nw`) mirrors row 5 (`ne`), and row 1 (`sw`) mirrors row 7
+(`se`) in all three character files. The west rows are therefore intentionally
+absent from the committed sheets and resolve through runtime mirroring.
+
+| Output file | Character | Output size |
+|---|---|---:|
+| `waica-iso-hero.png` | `Warrior-Blue.png` | 131×164 |
+| `waica-iso-villager.png` | `Human-Worker-Red.png` | 131×164 |
+| `waica-iso-orc.png` | `Orc-Grunt.png` | 131×164 |
+
+## hawkbirdtree isometric tileset
+
+- **32x32 Isometric Tileset Version 0_1** by hawkbirdtree
+- Source: https://opengameart.org/content/32x32-isometric-tileset-version-01
+- Licence: **Creative Commons Zero (CC0)**.
+- Source file: `hawkbirdtree-64x32/big_isometric_tileset64x32.png`
+  (1024×1344).
+
+`waica-iso-ground.png` is a 5×1 regular sheet of flat 64×32 diamonds with
+one transparent pixel between columns. No raised/cube tile is included:
+
+| Index | Meaning | Source rectangle `(left, top, right, bottom)` |
+|---:|---|---|
+| 0 | grass | `(832,576,896,608)` |
+| 1 | dirt | `(896,576,960,608)` |
+| 2 | path | `(832,640,896,672)` |
+| 3 | water | `(896,640,960,672)` |
+| 4 | border | `(960,640,1024,672)` |
+
+Tall art remains a Sprite prop. To keep nearest-neighbour sampling on one
+power-of-two texel-density family, the crate is reduced to 32×32 with nearest
+sampling and the 30×22 rock is bottom-centred at `(1,10)` on a transparent
+32×32 canvas. The tree remains native at 32 texels per render unit; characters
+remain at the human-approved 16 texels per render unit.
+
+| Output file | Source rectangle `(left, top, right, bottom)` | Output size |
+|---|---|---:|
+| `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 |

package/dist/animation.d.ts

@@ -0,0 +1,3 @@
+import type { DirectionalAnimation } from '@waica/engine';
+/** Five authored facings plus three horizontal mirror fallbacks. */
+export declare const ISOMETRIC_ANIMATION: DirectionalAnimation;

package/dist/animation.js

@@ -0,0 +1,10 @@
+/** Five authored facings plus three horizontal mirror fallbacks. */
+export const ISOMETRIC_ANIMATION = {
+    directions: ['n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw'],
+    fallbacks: {
+        w: { dir: 'e', flip: true },
+        nw: { dir: 'ne', flip: true },
+        sw: { dir: 'se', flip: true },
+    },
+    contract: { required: ['idle'], fallbacks: { walk: 'idle' } },
+};

package/dist/art.d.ts

@@ -0,0 +1,3 @@
+import type { ArchetypeArt } from '@waica/engine';
+/** Stock art as Node-safe package data. */
+export declare const ISOMETRIC_ART: ArchetypeArt[];

package/dist/art.js

@@ -0,0 +1,10 @@
+/** 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' },
+];

package/dist/bundle.d.ts

@@ -0,0 +1,2 @@
+import type { ArchetypeBundle } from '@waica/engine';
+export declare const ISOMETRIC_BUNDLE: ArchetypeBundle;

package/dist/bundle.js

@@ -0,0 +1,9 @@
+import { CHASER_ROLE, ISO_PLAYER_ROLE, NPC_ROLE, PATROLLER_ROLE, } from '@waica/behaviors';
+export const ISOMETRIC_BUNDLE = {
+    roles: {
+        player: ISO_PLAYER_ROLE,
+        patroller: PATROLLER_ROLE,
+        chaser: CHASER_ROLE,
+        npc: NPC_ROLE,
+    },
+};

package/dist/controls.d.ts

@@ -0,0 +1,3 @@
+import type { InputBindings } from '@waica/engine';
+export declare const ISOMETRIC_BINDINGS: Readonly<InputBindings>;
+export declare const ISOMETRIC_ACTION_LABELS: Readonly<Record<string, string>>;

package/dist/controls.js

@@ -0,0 +1,14 @@
+export const ISOMETRIC_BINDINGS = {
+    up: ['ArrowUp', 'KeyW'],
+    down: ['ArrowDown', 'KeyS'],
+    left: ['ArrowLeft', 'KeyA'],
+    right: ['ArrowRight', 'KeyD'],
+    interact: ['KeyE', 'Space'],
+};
+export const ISOMETRIC_ACTION_LABELS = {
+    up: 'Move up',
+    down: 'Move down',
+    left: 'Move left',
+    right: 'Move right',
+    interact: 'Interact',
+};

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { ISOMETRIC_ANIMATION } from './animation.js';
+export { ISOMETRIC_ART } from './art.js';
+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_UI } from './ui.js';
+export declare const ARCHETYPE: {
+    id: string;
+    label: string;
+    scene: import("@waica/engine").SceneJson;
+    blankScene: import("@waica/engine").SceneJson;
+    palette: import("@waica/engine").EntityTemplate[];
+    prefabs: Record<string, import("@waica/engine").PrefabJson>;
+    art: import("@waica/engine").ArchetypeArt[];
+    entityIcons: Readonly<Record<string, string>>;
+    bindings: Readonly<import("@waica/engine").InputBindings>;
+    actionLabels: Readonly<Record<string, string>>;
+    bundle: import("@waica/engine").ArchetypeBundle;
+    animation: import("@waica/engine").DirectionalAnimation<string>;
+    registry: import("@waica/engine").SceneRegistry;
+    artUrls: Record<string, string>;
+};

package/dist/index.js

@@ -0,0 +1,15 @@
+import { ARCHETYPE as DATA_ARCHETYPE } from './manifest.js';
+import { ISOMETRIC_ART_URLS, ISOMETRIC_REGISTRY } from './registry.js';
+export { ISOMETRIC_ANIMATION } from './animation.js';
+export { ISOMETRIC_ART } from './art.js';
+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_UI } from './ui.js';
+export const ARCHETYPE = {
+    ...DATA_ARCHETYPE,
+    registry: ISOMETRIC_REGISTRY,
+    artUrls: ISOMETRIC_ART_URLS,
+};

package/dist/manifest.d.ts

@@ -0,0 +1,16 @@
+export declare const ISOMETRIC_ENTITY_ICONS: Readonly<Record<string, string>>;
+export declare const ARCHETYPE: {
+    id: string;
+    label: string;
+    scene: import("@waica/engine").SceneJson;
+    blankScene: import("@waica/engine").SceneJson;
+    registry: import("@waica/engine").SceneRegistry;
+    palette: import("@waica/engine").EntityTemplate[];
+    prefabs: Record<string, import("@waica/engine").PrefabJson>;
+    art: import("@waica/engine").ArchetypeArt[];
+    entityIcons: Readonly<Record<string, string>>;
+    bindings: Readonly<import("@waica/engine").InputBindings>;
+    actionLabels: Readonly<Record<string, string>>;
+    bundle: import("@waica/engine").ArchetypeBundle;
+    animation: import("@waica/engine").DirectionalAnimation<string>;
+};

package/dist/manifest.js

@@ -0,0 +1,29 @@
+import { ISOMETRIC_ANIMATION } from './animation.js';
+import { ISOMETRIC_ART } from './art.js';
+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';
+export const ISOMETRIC_ENTITY_ICONS = {
+    IsoMotor: '🧭',
+    Tilemap: '💎',
+    Interactable: '💬',
+    Collectible: '📦',
+    Hazard: '👹',
+};
+export const ARCHETYPE = {
+    id: 'isometric',
+    label: 'Isometric',
+    scene: ISOMETRIC_SCENE,
+    blankScene: ISOMETRIC_BLANK_SCENE,
+    registry: ISOMETRIC_REGISTRY_DATA,
+    palette: ISOMETRIC_PALETTE,
+    prefabs: ISOMETRIC_PREFABS,
+    art: ISOMETRIC_ART,
+    entityIcons: ISOMETRIC_ENTITY_ICONS,
+    bindings: ISOMETRIC_BINDINGS,
+    actionLabels: ISOMETRIC_ACTION_LABELS,
+    bundle: ISOMETRIC_BUNDLE,
+    animation: ISOMETRIC_ANIMATION,
+};

package/dist/prefabs.d.ts

@@ -0,0 +1,18 @@
+import type { PrefabJson } from '@waica/engine';
+export declare const ISOMETRIC_HERO_SPRITE: {
+    texture: string;
+    cols: number;
+    rows: number;
+    spacingX: number;
+    spacingY: number;
+    pixelArt: boolean;
+    width: number;
+    height: number;
+    anchorY: number;
+    clips: Record<string, {
+        frames: number[];
+        fps: number;
+    }>;
+    initialClip: string;
+};
+export declare const ISOMETRIC_PREFABS: Record<string, PrefabJson>;

package/dist/prefabs.js

@@ -0,0 +1,196 @@
+import { ISO_PLAYER_STATE_GRAPH, NPC_STATE_GRAPH, PATROLLER_STATE_GRAPH, } from '@waica/behaviors';
+const SHIPPED_DIRECTIONS = ['n', 'ne', 'e', 'se', 's'];
+function directionalClips(includePlain) {
+    const clips = {};
+    SHIPPED_DIRECTIONS.forEach((direction, row) => {
+        const first = row * 4;
+        clips[`idle-${direction}`] = { frames: [first], fps: 2 };
+        clips[`walk-${direction}`] = {
+            frames: [first + 1, first + 2, first + 3, first + 2],
+            fps: 8,
+        };
+    });
+    if (includePlain) {
+        clips['idle'] = { frames: [16], fps: 2 };
+        clips['walk'] = { frames: [17, 18, 19, 18], fps: 8 };
+    }
+    return clips;
+}
+function characterSprite(texture, includePlain = false) {
+    return {
+        texture,
+        cols: 4,
+        rows: 5,
+        spacingX: 1,
+        spacingY: 1,
+        pixelArt: true,
+        width: 2,
+        height: 2,
+        anchorY: 0,
+        clips: directionalClips(includePlain),
+        initialClip: includePlain ? 'idle' : 'idle-s',
+    };
+}
+export const ISOMETRIC_HERO_SPRITE = characterSprite('waica:iso-hero');
+const MAP_WIDTH = 16;
+const MAP_HEIGHT = 16;
+const GRASS = 0;
+const DIRT = 1;
+const PATH = 2;
+const WATER = 3;
+const BORDER = 4;
+function tileAt(column, row) {
+    if (column === 0 || row === 0 || column === MAP_WIDTH - 1 || row === MAP_HEIGHT - 1) {
+        return BORDER;
+    }
+    if (column >= 11 && column <= 12 && row >= 5 && row <= 6)
+        return WATER;
+    if (column === 7 || row === 7)
+        return PATH;
+    if (column >= 2 && column <= 5 && row >= 2 && row <= 4)
+        return DIRT;
+    return GRASS;
+}
+const GROUND_CELLS = Array.from({ length: MAP_WIDTH * MAP_HEIGHT }, (_, index) => tileAt(index % MAP_WIDTH, Math.floor(index / MAP_WIDTH)));
+export const ISOMETRIC_PREFABS = {
+    'characters/player': {
+        waicaPrefab: 1,
+        type: 'character',
+        components: [
+            { type: 'AnimatedSprite', props: ISOMETRIC_HERO_SPRITE },
+            { type: 'IsoMotor' },
+            {
+                type: 'StateMachine',
+                props: {
+                    role: 'player',
+                    initial: ISO_PLAYER_STATE_GRAPH.initial,
+                    states: ISO_PLAYER_STATE_GRAPH.states,
+                },
+            },
+            { type: 'Hitbox', props: { width: 0.8, height: 0.8 } },
+            { type: 'Respawnable' },
+            { type: 'Health', props: { max: 3, invulnerability: 1 } },
+        ],
+    },
+    'characters/villager': {
+        waicaPrefab: 1,
+        type: 'character',
+        components: [
+            {
+                type: 'AnimatedSprite',
+                props: characterSprite('waica:iso-villager', true),
+            },
+            {
+                type: 'StateMachine',
+                props: {
+                    role: 'npc',
+                    initial: NPC_STATE_GRAPH.initial,
+                    states: NPC_STATE_GRAPH.states,
+                },
+            },
+            { type: 'Interactable', props: { line: 'Welcome to Diamond Meadow!', radius: 1.5 } },
+            { type: 'Solid', props: { width: 0.8, height: 0.6 } },
+        ],
+    },
+    'characters/orc': {
+        waicaPrefab: 1,
+        type: 'character',
+        components: [
+            {
+                type: 'AnimatedSprite',
+                props: {
+                    ...characterSprite('waica:iso-orc', true),
+                    initialClip: 'walk',
+                },
+            },
+            { type: 'Patrol', props: { axis: 'horizontal', distance: 2, speed: 2 } },
+            {
+                type: 'StateMachine',
+                props: {
+                    role: 'patroller',
+                    initial: PATROLLER_STATE_GRAPH.initial,
+                    states: PATROLLER_STATE_GRAPH.states,
+                },
+            },
+            { type: 'Hitbox', props: { width: 0.8, height: 0.7 } },
+            { type: 'Hazard', props: { stompable: false, contactDamage: 1 } },
+        ],
+    },
+    'objects/crate': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [
+            {
+                type: 'Sprite',
+                props: {
+                    texture: 'waica:iso-crate',
+                    pixelArt: true,
+                    width: 1,
+                    height: 1,
+                    anchorY: 0,
+                },
+            },
+            { type: 'Hitbox', props: { width: 0.6, height: 0.6 } },
+            { type: 'Collectible', props: { value: 1 } },
+        ],
+    },
+    'objects/tree': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [
+            {
+                type: 'Sprite',
+                props: {
+                    texture: 'waica:iso-tree',
+                    pixelArt: true,
+                    width: 2,
+                    height: 47 / 16,
+                    anchorY: 0,
+                },
+            },
+            { type: 'Solid', props: { width: 0.8, height: 0.6 } },
+        ],
+    },
+    'objects/rock': {
+        waicaPrefab: 1,
+        type: 'object',
+        components: [
+            {
+                type: 'Sprite',
+                props: {
+                    texture: 'waica:iso-rock',
+                    pixelArt: true,
+                    width: 1,
+                    height: 1,
+                    anchorY: 0,
+                },
+            },
+            { type: 'Solid', props: { width: 0.8, height: 0.6 } },
+        ],
+    },
+    'tiles/ground': {
+        waicaPrefab: 1,
+        type: 'tile',
+        components: [
+            {
+                type: 'Tilemap',
+                props: {
+                    texture: 'waica:iso-ground',
+                    cols: 5,
+                    rows: 1,
+                    spacingX: 1,
+                    spacingY: 1,
+                    cellWidth: 64,
+                    cellHeight: 32,
+                    pixelArt: true,
+                    mapWidth: MAP_WIDTH,
+                    mapHeight: MAP_HEIGHT,
+                    cellSize: 1,
+                    cells: GROUND_CELLS,
+                    solidTiles: [WATER, BORDER],
+                    layer: -2,
+                },
+            },
+        ],
+    },
+};

package/dist/registry-data.d.ts

@@ -0,0 +1,3 @@
+import { type EntityTemplate, type SceneRegistry } from '@waica/engine';
+export declare const ISOMETRIC_REGISTRY_DATA: SceneRegistry;
+export declare const ISOMETRIC_PALETTE: EntityTemplate[];

package/dist/registry-data.js

@@ -0,0 +1,46 @@
+import { AnimatedSprite, Hitbox, Solid, Sprite, StateMachine, Tilemap, } from '@waica/engine';
+import { Chaser, Collectible, Hazard, Health, Interactable, IsoMotor, Lifetime, Patrol, Respawnable, } from '@waica/behaviors';
+import { ISOMETRIC_ART } from './art.js';
+import { ISOMETRIC_PREFABS } from './prefabs.js';
+import { ISOMETRIC_UI } from './ui.js';
+const PACKAGE_ASSETS = Object.fromEntries(ISOMETRIC_ART.map((art) => [art.uri, `assets/${art.file}`]));
+export const ISOMETRIC_REGISTRY_DATA = {
+    components: {
+        Sprite,
+        AnimatedSprite,
+        Tilemap,
+        Solid,
+        Hitbox,
+        StateMachine,
+        IsoMotor,
+        Interactable,
+        Collectible,
+        Patrol,
+        Chaser,
+        Hazard,
+        Health,
+        Respawnable,
+        Lifetime,
+    },
+    resolveAsset: (uri) => PACKAGE_ASSETS[uri] ?? uri,
+    prefabs: ISOMETRIC_PREFABS,
+    ui: ISOMETRIC_UI,
+};
+const PALETTE_ICONS = {
+    player: '🧭',
+    villager: '🧑‍🌾',
+    orc: '👹',
+    crate: '📦',
+    tree: '🌳',
+    rock: '🪨',
+    ground: '💎',
+};
+export const ISOMETRIC_PALETTE = Object.entries(ISOMETRIC_PREFABS).map(([key, prefab]) => {
+    const base = key.slice(key.indexOf('/') + 1);
+    return {
+        label: base,
+        icon: PALETTE_ICONS[base] ?? '▣',
+        category: prefab.type,
+        make: () => ({ name: base.charAt(0).toUpperCase() + base.slice(1), prefab: key }),
+    };
+});

package/dist/registry.d.ts

@@ -0,0 +1,4 @@
+import type { SceneRegistry } from '@waica/engine';
+export { ISOMETRIC_PALETTE } from './registry-data.js';
+export declare const ISOMETRIC_ART_URLS: Record<string, string>;
+export declare const ISOMETRIC_REGISTRY: SceneRegistry;

package/dist/registry.js

@@ -0,0 +1,17 @@
+import { ISOMETRIC_ART } from './art.js';
+import { ISOMETRIC_REGISTRY_DATA } from './registry-data.js';
+export { ISOMETRIC_PALETTE } from './registry-data.js';
+export const ISOMETRIC_ART_URLS = {
+    'waica-iso-hero.png': new URL('../assets/waica-iso-hero.png', import.meta.url).href,
+    'waica-iso-villager.png': new URL('../assets/waica-iso-villager.png', import.meta.url).href,
+    'waica-iso-orc.png': new URL('../assets/waica-iso-orc.png', import.meta.url).href,
+    'waica-iso-ground.png': new URL('../assets/waica-iso-ground.png', import.meta.url).href,
+    '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,
+};
+const BUILTIN_ASSETS = Object.fromEntries(ISOMETRIC_ART.map((art) => [art.uri, ISOMETRIC_ART_URLS[art.file] ?? art.uri]));
+export const ISOMETRIC_REGISTRY = {
+    ...ISOMETRIC_REGISTRY_DATA,
+    resolveAsset: (uri) => BUILTIN_ASSETS[uri] ?? uri,
+};

package/dist/scene-default.d.ts

@@ -0,0 +1,5 @@
+import type { SceneJson } from '@waica/engine';
+/** A logical 16x16 meadow projected into a 2:1 diamond at render time. */
+export declare const ISOMETRIC_SCENE: SceneJson;
+/** Blank projects retain the diamond grid and full-map framing. */
+export declare const ISOMETRIC_BLANK_SCENE: SceneJson;

package/dist/scene-default.js

@@ -0,0 +1,49 @@
+function isometricCamera() {
+    return {
+        position: [0, -8],
+        zoom: 12,
+        limits: { minX: -16, maxX: 16, minY: -16, maxY: 0 },
+    };
+}
+/** A logical 16x16 meadow projected into a 2:1 diamond at render time. */
+export const ISOMETRIC_SCENE = {
+    waicaScene: 3,
+    render: { sort: 'y', projection: 'isometric' },
+    camera: {
+        ...isometricCamera(),
+        follow: 'Player',
+        lookaheadY: 1,
+    },
+    entities: [
+        { name: 'Ground', prefab: 'tiles/ground', position: [0, 0] },
+        { name: 'Player', prefab: 'characters/player', position: [8, 8] },
+        {
+            name: 'Villager',
+            prefab: 'characters/villager',
+            position: [6, 9],
+            overrides: { Interactable: { line: 'The water sparkles, but it blocks the trail.' } },
+        },
+        {
+            name: 'Orc',
+            prefab: 'characters/orc',
+            position: [10, 10],
+            overrides: { Patrol: { axis: 'horizontal', distance: 2.5, speed: 1.5 } },
+        },
+        { name: 'Crate-1', prefab: 'objects/crate', position: [5, 6] },
+        { name: 'Crate-2', prefab: 'objects/crate', position: [10, 4] },
+        { name: 'Crate-3', prefab: 'objects/crate', position: [12, 10] },
+        { name: 'Tree-1', prefab: 'objects/tree', position: [4, 10] },
+        { name: 'Tree-2', prefab: 'objects/tree', position: [10, 12] },
+        { 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] },
+    ],
+    ui: ['crate-counter'],
+};
+/** Blank projects retain the diamond grid and full-map framing. */
+export const ISOMETRIC_BLANK_SCENE = {
+    waicaScene: 3,
+    render: { sort: 'y', projection: 'isometric' },
+    camera: isometricCamera(),
+    entities: [],
+};

package/dist/ui.d.ts

@@ -0,0 +1 @@
+export declare const ISOMETRIC_UI: Record<string, string>;

package/dist/ui.js

@@ -0,0 +1,17 @@
+import { INTERACTABLE_UI } from '@waica/behaviors';
+export const ISOMETRIC_UI = {
+    'crate-counter': `<style>
+  .crate-counter {
+    position: absolute;
+    top: 12px;
+    left: 12px;
+    font: 600 20px system-ui, sans-serif;
+    color: #ffd166;
+    text-shadow: 0 1px 3px #000a;
+    user-select: none;
+  }
+</style>
+<div class="crate-counter">📦 {{points}}</div>
+`,
+    ...INTERACTABLE_UI,
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@waica/archetype-isometric",
+  "version": "0.7.0",
+  "description": "Waica isometric archetype — logical-grid action adventures with screen-relative movement",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chichex/waica",
+    "directory": "packages/archetype-isometric"
+  },
+  "files": [
+    "dist",
+    "assets"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    }
+  },
+  "dependencies": {
+    "@waica/behaviors": "^0.7.0",
+    "@waica/engine": "^0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3"
+  },
+  "scripts": {
+    "build": "node ../../scripts/clean-dist.mjs && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit"
+  }
+}