add fn comments for doxygen, rename OAMTile to OamTile

src/app/editor/context/entrance_context.h

@@ -10,6 +10,7 @@
 namespace yaze {
 namespace app {
 namespace editor {
+namespace context {
 
 class EntranceContext {
  public:
@@ -33,6 +34,7 @@ class EntranceContext {
   std::vector<uint16_t> entrance_tile_types_high_;
 };
 
+}  // namespace context
 }  // namespace editor
 }  // namespace app
 }  // namespace yaze

src/app/editor/context/gfx_context.cc

@@ -5,22 +5,23 @@
 #include <cmath>
 
 #include "app/core/editor.h"
-#include "app/gui/pipeline.h"
 #include "app/editor/modules/palette_editor.h"
 #include "app/gfx/bitmap.h"
 #include "app/gfx/snes_palette.h"
 #include "app/gfx/snes_tile.h"
 #include "app/gui/canvas.h"
 #include "app/gui/icons.h"
+#include "app/gui/pipeline.h"
 #include "app/rom.h"
 
 namespace yaze {
 namespace app {
 namespace editor {
-
+namespace context {
 
 std::unordered_map<uint8_t, gfx::Paletteset> GfxContext::palettesets_;
 
+}
 }  // namespace editor
 }  // namespace app
 }  // namespace yaze

src/app/editor/context/gfx_context.h

@@ -19,7 +19,11 @@
 namespace yaze {
 namespace app {
 namespace editor {
+namespace context {
 
+/**
+ * @brief Shared graphical context across editors.
+ */
 class GfxContext {
  public:
   absl::Status Update();
@@ -29,6 +33,7 @@ class GfxContext {
   static std::unordered_map<uint8_t, gfx::Paletteset> palettesets_;
 };
 
+}  // namespace context
 }  // namespace editor
 }  // namespace app
 }  // namespace yaze

src/app/editor/graphics_editor.h

@@ -59,6 +59,9 @@ constexpr ImGuiTableFlags kGfxEditFlags = ImGuiTableFlags_Reorderable |
                                           ImGuiTableFlags_Resizable |
                                           ImGuiTableFlags_SizingStretchSame;
 
+/**
+ * @brief Manages the games graphical content.
+*/
 class GraphicsEditor : public SharedROM {
  public:
   absl::Status Update();

src/app/editor/master_editor.h

@@ -35,7 +35,7 @@ namespace app {
 namespace editor {
 
 class MasterEditor : public SharedROM,
-                     public GfxContext,
+                     public context::GfxContext,
                      public core::ExperimentFlags {
  public:
   MasterEditor() { current_editor_ = &overworld_editor_; }

src/app/editor/modules/palette_editor.h

@@ -25,6 +25,7 @@ static constexpr absl::string_view kPaletteGroupNames[] = {
     "ow_aux",      "global_sprites", "dungeon_main", "ow_mini_map",
     "ow_mini_map", "3d_object",      "3d_object"};
 
+namespace palette_internal {
 struct PaletteChange {
   std::string group_name;
   size_t palette_index;
@@ -74,6 +75,7 @@ class PaletteEditorHistory {
   std::deque<PaletteChange> recentChanges;
   static const size_t maxHistorySize = 50;  // or any other number you deem fit
 };
+}  // namespace palette_internal
 
 class PaletteEditor : public SharedROM {
  public:
@@ -103,7 +105,7 @@ class PaletteEditor : public SharedROM {
 
   absl::Status status_;
 
-  PaletteEditorHistory history_;
+  palette_internal::PaletteEditorHistory history_;
 
   ImVec4 saved_palette_[256] = {};
   gfx::SnesColor current_color_;

src/app/editor/modules/tile16_editor.h

@@ -24,7 +24,10 @@ namespace yaze {
 namespace app {
 namespace editor {
 
-class Tile16Editor : public GfxContext, public SharedROM {
+/**
+ * @brief Popup window to edit Tile16 data
+ */
+class Tile16Editor : public context::GfxContext, public SharedROM {
  public:
   absl::Status Update();
   absl::Status DrawMenu();

src/app/editor/overworld_editor.h

@@ -64,8 +64,8 @@ constexpr absl::string_view kOWMapTable = "#MapSettingsTable";
 
 class OverworldEditor : public Editor,
                         public SharedROM,
-                        public GfxContext,
-                        public EntranceContext,
+                        public context::GfxContext,
+                        public context::EntranceContext,
                         public core::ExperimentFlags {
  public:
   absl::Status Update() final;