Rework story engine flow and reorganize project docs

src/data/buildDamage.ts

@@ -5,7 +5,7 @@ import type {
   EquipmentLoadout,
   GameState,
   InventoryItem,
-  SceneMonster,
+  SceneHostileNpc,
   TimedBuildBuff,
   WorldAttributeSchema,
 } from '../types';
@@ -682,7 +682,7 @@ export function getCompanionBuildDamageBreakdown(
 }
 
 export function getMonsterBuildDamageBreakdown(
-  monster: SceneMonster,
+  monster: SceneHostileNpc,
   worldType: WorldType | null = null,
   customWorldProfile: CustomWorldProfile | null = getRuntimeCustomWorldProfile(),
 ) {
@@ -866,7 +866,7 @@ export function resolveCompanionOutgoingDamageResult(
 }
 
 export function resolveMonsterOutgoingDamage(
-  monster: SceneMonster,
+  monster: SceneHostileNpc,
   baseDamage: number,
   functionMultiplier = 1,
   worldType: WorldType | null = null,
@@ -887,7 +887,7 @@ export function resolveMonsterOutgoingDamage(
 }
 
 export function resolveMonsterOutgoingDamageResult(
-  monster: SceneMonster,
+  monster: SceneHostileNpc,
   baseDamage: number,
   functionMultiplier = 1,
   worldType: WorldType | null = null,