@waica/cli 0.7.0 → 0.8.0

package/dist/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/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/mcp/node_modules/@waica/archetype-isometric/dist/ui.d.ts

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

package/dist/mcp/node_modules/@waica/archetype-isometric/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/dist/mcp/node_modules/@waica/archetype-isometric/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@waica/archetype-isometric",
+  "version": "0.8.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.8.0",
+    "@waica/engine": "^0.8.0"
+  }
+}

package/dist/mcp/node_modules/@waica/archetype-platformer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-platformer",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Waica platformer archetype — opinionated setup for side-scrolling platformers",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@waica/behaviors": "^0.7.0",
-    "@waica/engine": "^0.7.0"
+    "@waica/behaviors": "^0.8.0",
+    "@waica/engine": "^0.8.0"
   }
 }

package/dist/mcp/node_modules/@waica/archetype-topdown/dist/registry-data.js

@@ -1,4 +1,4 @@
-import { AnimatedSprite, Hitbox, Solid, Sprite, StateMachine, } from '@waica/engine';
+import { AnimatedSprite, Hitbox, Solid, Sprite, StateMachine, Tilemap, } from '@waica/engine';
 import { Chaser, Collectible, Hazard, Health, Interactable, Lifetime, Patrol, Respawnable, TopDownMotor, } from '@waica/behaviors';
 import { TOPDOWN_ART } from './art.js';
 import { TOPDOWN_PREFABS } from './prefabs.js';
@@ -13,6 +13,7 @@ export const TOPDOWN_REGISTRY_DATA = {
     components: {
         Sprite,
         AnimatedSprite,
+        Tilemap,
         Solid,
         Hitbox,
         StateMachine,

package/dist/mcp/node_modules/@waica/archetype-topdown/dist/ui.js

@@ -1,3 +1,4 @@
+import { INTERACTABLE_UI } from '@waica/behaviors';
 /**
  * The archetype's default UI pieces: self-contained HTML fragments
  * (markup + <style>, {{stat}} bindings) keyed by piece name. Projects
@@ -21,23 +22,5 @@ export const TOPDOWN_UI = {
 </style>
 <div class="potion-counter">🧪 {{points}}</div>
 `,
-    'npc-line': `<style>
-  .npc-line {
-    position: absolute;
-    left: 50%;
-    bottom: 24px;
-    transform: translateX(-50%);
-    max-width: 70%;
-    padding: 10px 18px;
-    border-radius: 8px;
-    background: #1a1a2ecc;
-    border: 1px solid #ffffff2e;
-    font: 500 18px system-ui, sans-serif;
-    color: #f5f5f5;
-    text-shadow: 0 1px 2px #000a;
-    user-select: none;
-  }
-</style>
-<div class="npc-line">{{npcLine}}</div>
-`,
+    ...INTERACTABLE_UI,
 };

package/dist/mcp/node_modules/@waica/archetype-topdown/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waica/archetype-topdown",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Waica top-down archetype — opinionated setup for Zelda-like overhead adventures",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@waica/behaviors": "^0.7.0",
-    "@waica/engine": "^0.7.0"
+    "@waica/behaviors": "^0.8.0",
+    "@waica/engine": "^0.8.0"
   }
 }

package/dist/mcp/node_modules/@waica/behaviors/dist/grid-motor.d.ts

@@ -0,0 +1,56 @@
+import { Component, type AnimationFacingProvider, type CameraVelocity, type CameraVelocityProvider } from '@waica/engine';
+/** Shared velocity, collision and provider behavior for square-grid motors. */
+export declare abstract class GridMotor<Facing extends string> extends Component implements CameraVelocityProvider, AnimationFacingProvider {
+    static displayName: string;
+    static params: {
+        moveSpeed: {
+            label: string;
+            min: number;
+            max: number;
+            step: number;
+        };
+        acceleration: {
+            label: string;
+            min: number;
+            max: number;
+            step: number;
+        };
+        deceleration: {
+            label: string;
+            min: number;
+            max: number;
+            step: number;
+        };
+        walkThreshold: {
+            label: string;
+            min: number;
+            max: number;
+            step: number;
+        };
+    };
+    static transient: string[];
+    moveSpeed: number;
+    acceleration: number;
+    deceleration: number;
+    /** Speed above this reads as walking (the idle ↔ walk edge). */
+    walkThreshold: number;
+    /** The character's AABB hitbox — a footprint, shorter than the sprite. */
+    hitboxWidth: number;
+    hitboxHeight: number;
+    vx: number;
+    vy: number;
+    abstract facing: Facing;
+    /** The scene camera reads follow velocity through this explicit seam. */
+    getCameraVelocity(): CameraVelocity;
+    /** The StateMachine resolves directional clips through this explicit seam. */
+    getAnimationFacing(): string;
+    /** Accelerates each axis toward an already-normalized logical direction. */
+    protected accelerateToward(x: number, y: number, dt: number): void;
+    /** Live speed, for the idle ↔ walk edge. */
+    speed(): number;
+    /** Integrates velocity and resolves each logical axis against Solids. */
+    step(dt: number): void;
+    halt(): void;
+    private resolveAxis;
+    private collisionBody;
+}