src/
  game/
    types.ts          — all shared types & interfaces (scaffold)
    config.ts         — balance constants (scaffold)
    data/
      champions.ts    — champion definitions (scaffold creates, champion agent fills)
      items.ts        — item definitions (scaffold creates, ai-rules agent fills? no — data should be scaffold)
    engine/
      loop.ts         — fixed timestep game loop
      input.ts        — mouse/keyboard input manager
      camera.ts       — camera (pan, lock, zoom)
      spatial.ts      — spatial hash grid for queries
      mathUtils.ts    — vector math helpers
    world/
      mapData.ts      — map layout: lanes, waypoints, structures positions, brushes
      pathing.ts      — waypoint lane pathing
    entities/
      Entity.ts       — base entity
      Unit.ts         — base unit (hp, move, attack)
      Champion.ts     — champion entity
      Minion.ts       — minion entity
      Turret.ts       — turret entity
      Structure.ts    — inhibitor/nexus
      Projectile.ts   — projectiles
    systems/
      combat.ts       — damage calc, attack resolution
      abilities.ts    — ability framework + implementations
      minionAI.ts     — minion behavior
      turretAI.ts     — turret targeting
      championAI.ts   — enemy champion AI
      progression.ts  — XP/gold/levels
      shop.ts         — item purchase logic
      waves.ts        — minion wave spawning
      winlose.ts      — nexus destruction, game end
    render/
      renderer.ts     — main canvas renderer (map, entities)
      effects.ts      — particles, floating text
      fog.ts          — fog of war (optional)
      minimap.ts      — minimap renderer
    Game.ts           — orchestrator (owns state, steps simulation)
    state.ts          — GameState container type
  components/
    screens/
      StartScreen.tsx
      ChampSelect.tsx
      EndScreen.tsx
    hud/
      HUD.tsx         — bottom bar (portrait, hp/mana, abilities, items, gold)
      Shop.tsx
      Scoreboard.tsx
      KillFeed.tsx
      MinimapView.tsx
      Announcements.tsx
  pages/
    GamePage.tsx      — hosts canvas + HUD, runs Game

interface GameState {
  time: number; // seconds since game start
  tick: number;
  entities: Map<number, Entity>;
  projectiles: Projectile[];
  effects: Effect[];
  floatingTexts: FloatingText[];
  playerChampionId: number;
  camera: CameraState;
  gameOver: 'blue' | 'red' | null;
  killFeed: KillFeedEntry[];
  announcements: Announcement[];
  stats: { blue: TeamStats; red: TeamStats };
}

export type Team = 'blue' | 'red';
export interface Vec { x: number; y: number; }

export type EntityKind = 'champion' | 'minion' | 'turret' | 'inhibitor' | 'nexus';

export interface EntityBase {
  id: number; kind: EntityKind; team: Team;
  pos: Vec; radius: number;
  hp: number; maxHp: number;
  dead: boolean;
}

export interface Champion extends EntityBase {
  kind: 'champion';
  champId: string; // 'garen' | 'ashe' | 'annie'
  isPlayer: boolean;
  level: number; xp: number;
  ad, ap, armor, mr, as (attackSpeed), ms, crit...
  mana, maxMana, hpRegen, manaRegen
  abilities: AbilityState[]; // Q W E R, each { level, cooldownEnd }
  summoner: { flash: {cooldownEnd}, heal: ... }
  items: (string|null)[]; // 6 slots
  gold: number;
  kills, deaths, assists, cs;
  moveTarget?: Vec; attackTargetId?: number;
  respawnAt?: number; // when dead
  recall?: { endTime: number };
  buffs: Buff[];
  attackCooldownEnd: number;
  lastAttackAt...
}

export interface AbilityDef {
  id: string; key: 'Q'|'W'|'E'|'R';
  name: string; icon: string; // emoji or text
  type: 'skillshot'|'targeted'|'self'|'aoe'|'buff'|'cone';
  range: number; radius?: number;
  manaCost: number[]; cooldown: number[]; // per level
  damage?: { base: number[]; adRatio?: number; apRatio?: number; type: 'physical'|'magic'|'true' };
  effects?: ...; // stun, slow, heal etc.
  description: string;
}

export interface ChampionDef {
  id: string; name: string; title: string; role: string;
  baseStats: { hp, hpGrowth, mana, manaGrowth, ad, adGrowth, as, asGrowth, armor, armorGrowth, mr, mrGrowth, ms, range, hpRegen, manaRegen };
  resourceType: 'mana'|'none';
  abilities: { Q: AbilityDef; W: ...; E: ...; R: ... };
  passive: { name: string; description: string };
}

export interface ItemDef {
  id: string; name: string; cost: number;
  stats: Partial<{ ad, ap, hp, armor, mr, as, crit, ms, ah, lifeSteal }>;
  description: string; icon: string;
}

export class Game {
  state: GameState;
  constructor(playerChampId: string, enemyChampId: string);
  update(dt: number): void; // advances simulation
  // input commands (called from React/canvas):
  commandMove(worldPos): void;
  commandAttack(targetId | worldPos): void;
  commandAttackMove(worldPos): void;
  castAbility(key: 'Q'|'W'|'E'|'R', targetPos?: Vec, targetId?: number): void;
  useSummoner(spell: 'flash'|'heal'|'ignite', targetPos?, targetId?): void;
  levelUpAbility(key): void;
  recall(): void;
  buyItem(itemId): void;
  sellItem(slot): void;
  stop(): void;
}

// systems/waves.ts
export function updateWaves(state: GameState, dt: number): void
// systems/minionAI.ts
export function updateMinions(state: GameState, dt: number): void
// systems/turretAI.ts
export function updateTurrets(state: GameState, dt: number): void
// systems/championAI.ts
export function updateEnemyChampions(state: GameState, dt: number): void
// systems/progression.ts
export function updateProgression(state: GameState, dt: number): void // xp, regen, respawns, buffs ticking
// systems/combat.ts
export function attackUnit(state, attackerId, targetId): void
export function dealDamage(state, sourceId, targetId, amount, type): void
export function updateCombat(...) 
// systems/abilities.ts
export function castChampionAbility(state, champ, key, targetPos?, targetId?): boolean
export function updateAbilityEffects(state, dt): void // projectiles from abilities, DoTs, spins...
// systems/shop.ts
export function buyItem(state, champId, itemId): boolean
// systems/unitControl.ts
export function moveUnitTowards(state, unit, dest, dt): boolean
export function findNearestEnemy(state, pos, team, radius, filter?): EntityBase | null
// systems/winlose.ts
export function checkWinCondition(state): void

## 铁律
- 你只能创建/修改下方"你拥有的文件"列表中的文件。禁止修改：src/game/types.ts、src/game/config.ts、src/game/data/*、src/game/registry.ts、src/game/Game.ts、src/game/engine/mathUtils.ts、src/components/kit/*、src/App.tsx、src/index.css、tailwind.config.js、public/*。如发现共享文件必须改动，在你的最终报告中说明，不要改。
- import 白名单：react、src/game/types.ts、config.ts、data/*、registry.ts、engine/mathUtils.ts、你自己的文件、模板自带组件。禁止 import 其他代理的模块（它们在你的 worktree 里不存在）：engine/(loop|camera|input|spatial|unitControl|combatMove|vision).ts、world/*、systems/*、render/*、components/game/*。
- 需要的小型移动/索敌辅助函数（moveTowards、nearestEnemy、entitiesInRadius 等）在你自己的文件内实现本地副本（5-15 行）。
- TypeScript 严格模式，`npm run build` 必须通过（你的 worktree 只含 scaffold+你的文件，只要不 import 其他代理模块就能过）。
- 提交：git add -A && git commit -m '<scope>: implement'，然后立即返回报告（不跑 dev server、不截图）。

{ui && (
  <>
    {!over && (
      <> ...hud... </>
    )}
    {over && (
      <GameOverScreen .../>
    )}
  </>
)}

      {over && (
        <GameOverScreen game={gameRef.current!} ui={ui} onRestart={() => navigate('/select')} />
      )}

      {/* 自绘光标层 */}