Rework story engine flow and reorganize project docs

src/components/game-canvas/GameCanvasShared.tsx

@@ -27,8 +27,7 @@ export interface GameCanvasProps {
   encounter: Encounter | null;
   currentScenePreset: ScenePresetInfo | null;
   worldType: WorldType | null;
-  sceneHostileNpcs?: SceneHostileNpc[];
-  sceneMonsters?: SceneHostileNpc[];
+  sceneHostileNpcs: SceneHostileNpc[];
   playerX: number;
   playerOffsetY: number;
   playerFacing: 'left' | 'right';
@@ -64,6 +63,8 @@ export const DEFAULT_COMBAT_HP_TOP_PX = -18;
 export const CHARACTER_NPC_COMBAT_HP_TOP_PX = -2;
 export const GENERIC_NPC_COMBAT_HP_TOP_PX = 94;
 export const GENERIC_NPC_EFFECT_TARGET_OFFSET_PX = -16;
+export const HOSTILE_NPC_SCENE_INSET_PX = 28;
+export const HOSTILE_NPC_SCENE_BOTTOM_OFFSET_PX = -18;
 export const CHAT_BUBBLE_SPRITE_SRC = '/chat.png';
 export const OPENING_CAMP_OVERLAY_SRC = '/scene_bg/hut.png';
 export const CHAT_BUBBLE_FRAME_WIDTH = 27;
@@ -162,7 +163,7 @@ export function getCharacterBottomOffsetPx(
 export function getEntityEffectBottom({
   origin,
   hostileNpcId,
-  sceneHostileNpcs,
+  sceneCombatants,
   playerCharacter,
   groundBottom,
   stageLiftPx,
@@ -171,7 +172,7 @@ export function getEntityEffectBottom({
 }: {
   origin: 'player' | 'hostile_npc' | 'monster';
   hostileNpcId?: string;
-  sceneHostileNpcs: SceneHostileNpc[];
+  sceneCombatants: SceneHostileNpc[];
   playerCharacter: Character | null;
   groundBottom: string;
   stageLiftPx: number;
@@ -184,7 +185,7 @@ export function getEntityEffectBottom({
   }
 
   const targetHostileNpc = hostileNpcId
-    ? sceneHostileNpcs.find(hostileNpc => hostileNpc.id === hostileNpcId)
+    ? sceneCombatants.find(hostileNpc => hostileNpc.id === hostileNpcId)
     : null;
 
   if (!targetHostileNpc) {