Rework story engine flow and reorganize project docs

src/components/game-canvas/GameCanvasEffectLayer.tsx

@@ -8,7 +8,7 @@ interface GameCanvasEffectLayerProps {
   activeCombatEffects: CombatVisualEffect[];
   getPlayerEffectLeft: (effectX: number, offsetPx?: number) => string;
   getHostileNpcEffectLeft: (effectX: number, hostileNpcId?: string, offsetPx?: number) => string;
-  sceneHostileNpcs: SceneHostileNpc[];
+  sceneCombatants: SceneHostileNpc[];
   playerCharacter: Character | null;
   groundBottom: string;
   stageLiftPx: number;
@@ -189,7 +189,7 @@ export function GameCanvasEffectLayer({
   activeCombatEffects,
   getPlayerEffectLeft,
   getHostileNpcEffectLeft,
-  sceneHostileNpcs,
+  sceneCombatants,
   playerCharacter,
   groundBottom,
   stageLiftPx,
@@ -210,7 +210,7 @@ export function GameCanvasEffectLayer({
         const startBottom = `calc(${getEntityEffectBottom({
           origin: effect.startOrigin,
           hostileNpcId: effect.startHostileNpcId ?? effect.startMonsterId,
-          sceneHostileNpcs,
+          sceneCombatants,
           playerCharacter,
           groundBottom,
           stageLiftPx,
@@ -220,7 +220,7 @@ export function GameCanvasEffectLayer({
         const endBottom = `calc(${getEntityEffectBottom({
           origin: effect.endOrigin ?? effect.startOrigin,
           hostileNpcId: effect.endHostileNpcId ?? effect.endMonsterId ?? effect.startHostileNpcId ?? effect.startMonsterId,
-          sceneHostileNpcs,
+          sceneCombatants,
           playerCharacter,
           groundBottom,
           stageLiftPx,