# claxid/gravesong architecture

> Architecture diagram of the GitHub repository claxid/gravesong, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/claxid/gravesong
- Repository: https://github.com/claxid/gravesong

## Overview

GraveSong is a browser-based 2D action-adventure: players enter through the web-page flow, explore maps, fight enemies and bosses, and advance through levels and perks. The graph highlights the documented navigation/audio experience and the sampled runtime systems for movement, collision, combat, progression, and rendering. Source excerpts show several player-controller delegations and the collision analyzer’s utility dependencies; most map-loop wiring was not sampled, so those relationships are omitted rather than inferred.

Main entry points: [`js/jeu/player/controller.js`](https://github.com/claxid/gravesong/blob/main/js/jeu/player/controller.js) (Player controller), [`js/collision/analyzer.js`](https://github.com/claxid/gravesong/blob/main/js/collision/analyzer.js) (Collision analyzer), [`js/script.js`](https://github.com/claxid/gravesong/blob/main/js/script.js) (Welcome navigation), [`js/pages/loading.js`](https://github.com/claxid/gravesong/blob/main/js/pages/loading.js) (Loading page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pages["Web entry flow"]
  node_script["Welcome navigation<br/>[script.js]"]
  node_loading["Loading page<br/>[loading.js]"]
  node_menu["Main menu<br/>[menu.js]"]
  node_lore["Lore page<br/>[lore.js]"]
end

subgraph group_runtime["Game runtime"]
  node_game1["Map 1 runtime<br/>[game-loop.js]"]
  node_game2["Map 2 runtime<br/>[game2.js]"]
  node_map1boss["Map 1 boss system<br/>[boss-system.js]"]
  node_map2boss["Fire Knight boss"]
end

subgraph group_combat["Combat and progression"]
  node_enemy["Enemy controller<br/>[controller.js]"]
  node_encounters["Encounter system"]
  node_boss["Boss behavior<br/>[boss.js]"]
  node_playercontroller["Player controller<br/>[controller.js]"]
  node_persistence["Player progress storage"]
  node_perks["Perk progression<br/>[perk-system.js]"]
  node_melee["Melee attacks<br/>[melee-attack.js]"]
  node_axe["Axe spell<br/>[axe-spell.js]"]
  node_blackhole["Black hole spell"]
  node_fireball["Fireball spell<br/>[fireball-spell.js]"]
  node_chaos["Chaos aura spell"]
  node_damage["Damage meter<br/>[damage-meter.js]"]
end

subgraph group_collision["Collision system"]
  node_collision["Map collision<br/>[collision.js]"]
  node_analyzer["Collision analyzer<br/>[analyzer.js]"]
  node_mask["Collision mask tools<br/>[mask-utils.js]"]
  node_colors["Map color tools<br/>[color-utils.js]"]
  node_rects["Collision rectangles<br/>[rect-utils.js]"]
  node_config["Collision config<br/>[config.js]"]
end

subgraph group_shared["Shared game UI"]
  node_ui["Game HUD<br/>[ui.js]"]
  node_perkoverlay["Perk overlay<br/>[perk-overlay.js]"]
  node_healthbar["Boss health bar<br/>[boss-health-bar.js]"]
  node_cinematics["Cinematics<br/>[cinematics.js]"]
end

node_player(("Player"))

node_player -->|"starts game flow"| node_script
node_script -->|"navigates to"| node_loading
node_loading -->|"redirects to"| node_menu
node_menu -->|"opens lore"| node_lore
node_playercontroller -->|"creates persistence"| node_persistence
node_playercontroller -->|"creates attack system"| node_melee
node_playercontroller -->|"creates spell"| node_axe
node_playercontroller -->|"creates perk system"| node_perks
node_analyzer -->|"reads settings"| node_config
node_analyzer -->|"uses mask tools"| node_mask
node_analyzer -->|"classifies pixels"| node_colors
node_analyzer -->|"builds rectangles"| node_rects

click node_script "https://github.com/claxid/gravesong/blob/main/js/script.js"
click node_loading "https://github.com/claxid/gravesong/blob/main/js/pages/loading.js"
click node_menu "https://github.com/claxid/gravesong/blob/main/js/menu.js"
click node_lore "https://github.com/claxid/gravesong/blob/main/js/pages/lore.js"
click node_game1 "https://github.com/claxid/gravesong/blob/main/js/jeu/map1/game-loop.js"
click node_game2 "https://github.com/claxid/gravesong/blob/main/js/jeu/game2.js"
click node_map1boss "https://github.com/claxid/gravesong/blob/main/js/jeu/map1/boss-system.js"
click node_map2boss "https://github.com/claxid/gravesong/blob/main/js/jeu/map2/fire-knight-boss-controller.js"
click node_enemy "https://github.com/claxid/gravesong/blob/main/js/jeu/enemy/controller.js"
click node_encounters "https://github.com/claxid/gravesong/blob/main/js/jeu/encounter-system.js"
click node_boss "https://github.com/claxid/gravesong/blob/main/js/jeu/boss.js"
click node_playercontroller "https://github.com/claxid/gravesong/blob/main/js/jeu/player/controller.js"
click node_persistence "https://github.com/claxid/gravesong/blob/main/js/jeu/player/controller-persistence.js"
click node_perks "https://github.com/claxid/gravesong/blob/main/js/jeu/player/perk-system.js"
click node_melee "https://github.com/claxid/gravesong/blob/main/js/jeu/player/melee-attack.js"
click node_axe "https://github.com/claxid/gravesong/blob/main/js/jeu/spells/axe-spell.js"
click node_blackhole "https://github.com/claxid/gravesong/blob/main/js/jeu/spells/black-hole-spell.js"
click node_fireball "https://github.com/claxid/gravesong/blob/main/js/jeu/spells/fireball-spell.js"
click node_chaos "https://github.com/claxid/gravesong/blob/main/js/jeu/spells/chaos-aura-spell.js"
click node_damage "https://github.com/claxid/gravesong/blob/main/js/jeu/map2/damage-meter.js"
click node_collision "https://github.com/claxid/gravesong/blob/main/js/collision/collision.js"
click node_analyzer "https://github.com/claxid/gravesong/blob/main/js/collision/analyzer.js"
click node_mask "https://github.com/claxid/gravesong/blob/main/js/collision/mask-utils.js"
click node_colors "https://github.com/claxid/gravesong/blob/main/js/collision/color-utils.js"
click node_rects "https://github.com/claxid/gravesong/blob/main/js/collision/rect-utils.js"
click node_config "https://github.com/claxid/gravesong/blob/main/js/collision/config.js"
click node_ui "https://github.com/claxid/gravesong/blob/main/js/jeu/ui.js"
click node_perkoverlay "https://github.com/claxid/gravesong/blob/main/js/jeu/shared/perk-overlay.js"
click node_healthbar "https://github.com/claxid/gravesong/blob/main/js/jeu/shared/boss-health-bar.js"
click node_cinematics "https://github.com/claxid/gravesong/blob/main/js/jeu/shared/cinematics.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_script,node_loading,node_menu,node_lore toneBlue
class node_game1,node_game2,node_map1boss,node_map2boss toneAmber
class node_enemy,node_encounters,node_boss,node_playercontroller,node_persistence,node_perks,node_melee,node_axe,node_blackhole,node_fireball,node_chaos,node_damage toneMint
class node_collision,node_analyzer,node_mask,node_colors,node_rects,node_config toneRose
class node_ui,node_perkoverlay,node_healthbar,node_cinematics,node_player toneIndigo
```

## Components

### Web entry flow

- [Welcome navigation](https://github.com/claxid/gravesong/blob/main/js/script.js): `js/script.js`
- [Loading page](https://github.com/claxid/gravesong/blob/main/js/pages/loading.js): `js/pages/loading.js`
- [Main menu](https://github.com/claxid/gravesong/blob/main/js/menu.js): `js/menu.js`
- [Lore page](https://github.com/claxid/gravesong/blob/main/js/pages/lore.js): `js/pages/lore.js`

### Game runtime

- [Map 1 runtime](https://github.com/claxid/gravesong/blob/main/js/jeu/map1/game-loop.js): `js/jeu/map1/game-loop.js`
- [Map 2 runtime](https://github.com/claxid/gravesong/blob/main/js/jeu/game2.js): `js/jeu/game2.js`
- [Map 1 boss system](https://github.com/claxid/gravesong/blob/main/js/jeu/map1/boss-system.js): `js/jeu/map1/boss-system.js`
- [Fire Knight boss](https://github.com/claxid/gravesong/blob/main/js/jeu/map2/fire-knight-boss-controller.js): `js/jeu/map2/fire-knight-boss-controller.js`

### Combat and progression

- [Enemy controller](https://github.com/claxid/gravesong/blob/main/js/jeu/enemy/controller.js): `js/jeu/enemy/controller.js`
- [Encounter system](https://github.com/claxid/gravesong/blob/main/js/jeu/encounter-system.js): `js/jeu/encounter-system.js`
- [Boss behavior](https://github.com/claxid/gravesong/blob/main/js/jeu/boss.js): `js/jeu/boss.js`
- [Player controller](https://github.com/claxid/gravesong/blob/main/js/jeu/player/controller.js): `js/jeu/player/controller.js`
- [Player progress storage](https://github.com/claxid/gravesong/blob/main/js/jeu/player/controller-persistence.js): `js/jeu/player/controller-persistence.js`
- [Perk progression](https://github.com/claxid/gravesong/blob/main/js/jeu/player/perk-system.js): `js/jeu/player/perk-system.js`
- [Melee attacks](https://github.com/claxid/gravesong/blob/main/js/jeu/player/melee-attack.js): `js/jeu/player/melee-attack.js`
- [Axe spell](https://github.com/claxid/gravesong/blob/main/js/jeu/spells/axe-spell.js): `js/jeu/spells/axe-spell.js`
- [Black hole spell](https://github.com/claxid/gravesong/blob/main/js/jeu/spells/black-hole-spell.js): `js/jeu/spells/black-hole-spell.js`
- [Fireball spell](https://github.com/claxid/gravesong/blob/main/js/jeu/spells/fireball-spell.js): `js/jeu/spells/fireball-spell.js`
- [Chaos aura spell](https://github.com/claxid/gravesong/blob/main/js/jeu/spells/chaos-aura-spell.js): `js/jeu/spells/chaos-aura-spell.js`
- [Damage meter](https://github.com/claxid/gravesong/blob/main/js/jeu/map2/damage-meter.js): `js/jeu/map2/damage-meter.js`

### Collision system

- [Map collision](https://github.com/claxid/gravesong/blob/main/js/collision/collision.js): `js/collision/collision.js`
- [Collision analyzer](https://github.com/claxid/gravesong/blob/main/js/collision/analyzer.js): `js/collision/analyzer.js`
- [Collision mask tools](https://github.com/claxid/gravesong/blob/main/js/collision/mask-utils.js): `js/collision/mask-utils.js`
- [Map color tools](https://github.com/claxid/gravesong/blob/main/js/collision/color-utils.js): `js/collision/color-utils.js`
- [Collision rectangles](https://github.com/claxid/gravesong/blob/main/js/collision/rect-utils.js): `js/collision/rect-utils.js`
- [Collision config](https://github.com/claxid/gravesong/blob/main/js/collision/config.js): `js/collision/config.js`

### Shared game UI

- [Game HUD](https://github.com/claxid/gravesong/blob/main/js/jeu/ui.js): `js/jeu/ui.js`
- [Perk overlay](https://github.com/claxid/gravesong/blob/main/js/jeu/shared/perk-overlay.js): `js/jeu/shared/perk-overlay.js`
- [Boss health bar](https://github.com/claxid/gravesong/blob/main/js/jeu/shared/boss-health-bar.js): `js/jeu/shared/boss-health-bar.js`
- [Cinematics](https://github.com/claxid/gravesong/blob/main/js/jeu/shared/cinematics.js): `js/jeu/shared/cinematics.js`

### Other components

- **Player**

## Connections

- Player → Welcome navigation: starts game flow (evidence: `js/script.js`)
- Welcome navigation → Loading page: navigates to (evidence: `js/script.js`)
- Loading page → Main menu: redirects to (evidence: `js/pages/loading.js`)
- Main menu → Lore page: opens lore (evidence: `js/menu.js`)
- Player controller → Player progress storage: creates persistence (evidence: `js/jeu/player/controller.js`)
- Player controller → Melee attacks: creates attack system (evidence: `js/jeu/player/controller.js`)
- Player controller → Axe spell: creates spell (evidence: `js/jeu/player/controller.js`)
- Player controller → Perk progression: creates perk system (evidence: `js/jeu/player/controller.js`)
- Collision analyzer → Collision config: reads settings (evidence: `js/collision/analyzer.js`)
- Collision analyzer → Collision mask tools: uses mask tools (evidence: `js/collision/analyzer.js`)
- Collision analyzer → Map color tools: classifies pixels (evidence: `js/collision/analyzer.js`)
- Collision analyzer → Collision rectangles: builds rectangles (evidence: `js/collision/analyzer.js`)
