Refactorizar estilo del proyecto: .h → .hpp, #pragma once, includes desde raíz

Modernizar convenciones de código C++ aplicando las siguientes directivas:

## Cambios principales

**1. Renombrar headers (.h → .hpp)**
- 36 archivos renombrados a extensión .hpp (estándar C++)
- Mantenidos como .h: stb_image.h, stb_image_resize2.h (librerías C externas)

**2. Modernizar include guards (#ifndef → #pragma once)**
- resource_manager.hpp: #ifndef RESOURCE_MANAGER_H → #pragma once
- resource_pack.hpp: #ifndef RESOURCE_PACK_H → #pragma once
- spatial_grid.hpp: #ifndef SPATIAL_GRID_H → #pragma once

**3. Sistema de includes desde raíz del proyecto**
- CMakeLists.txt: añadido include_directories(${CMAKE_SOURCE_DIR}/source)
- Eliminadas rutas relativas (../) en todos los includes
- Includes ahora usan rutas absolutas desde source/

**Antes:**
```cpp
#include "../defines.h"
#include "../text/textrenderer.h"
```

**Ahora:**
```cpp
#include "defines.hpp"
#include "text/textrenderer.hpp"
```

## Archivos afectados

- 1 archivo CMakeLists.txt modificado
- 36 archivos renombrados (.h → .hpp)
- 32 archivos .cpp actualizados (includes)
- 36 archivos .hpp actualizados (includes + guards)
- 1 archivo tools/ actualizado

**Total: 70 archivos modificados**

## Verificación

✅ Proyecto compila sin errores
✅ Todas las rutas de includes correctas
✅ Include guards modernizados
✅ Librerías externas C mantienen extensión .h

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

source/themes/theme.hpp

@@ -0,0 +1,94 @@
+#pragma once
+
+#include <vector>
+#include "defines.hpp"  // for Color, ThemeKeyframe
+
+/**
+ * Theme: Interfaz polimórfica para todos los temas (estáticos y dinámicos)
+ *
+ * Responsabilidades:
+ * - Proporcionar información básica del tema (nombre, color de texto)
+ * - Generar colores interpolados para pelotas y fondo
+ * - Actualizar estado interno si es animado (solo dinámicos)
+ *
+ * Implementaciones:
+ * - StaticTheme: 1 keyframe, sin animación, colores fijos
+ * - DynamicTheme: N keyframes, animación continua con loop
+ */
+class Theme {
+    public:
+        virtual ~Theme() = default;
+
+        // ========================================
+        // QUERIES BÁSICAS (implementar en derivadas)
+        // ========================================
+
+        virtual const char* getNameEN() const = 0;
+        virtual const char* getNameES() const = 0;
+        virtual void getTextColor(int& r, int& g, int& b) const = 0;
+        virtual void getNotificationBackgroundColor(int& r, int& g, int& b) const = 0;
+
+        // ========================================
+        // CORE: OBTENER COLORES (polimórfico)
+        // ========================================
+
+        /**
+         * Obtiene color de pelota según índice y progreso de animación
+         * @param ball_index: Índice de pelota (para seleccionar color de paleta)
+         * @param progress: Progreso 0.0-1.0 si hay transición LERP externa (PHASE 3)
+         * @return Color interpolado para esta pelota
+         */
+        virtual Color getBallColor(size_t ball_index, float progress) const = 0;
+
+        /**
+         * Obtiene colores de fondo degradado (top/bottom)
+         * @param progress: Progreso 0.0-1.0 si hay transición LERP externa (PHASE 3)
+         * @param tr, tg, tb: Color superior (out)
+         * @param br, bg, bb: Color inferior (out)
+         */
+        virtual void getBackgroundColors(float progress,
+                                         float& tr, float& tg, float& tb,
+                                         float& br, float& bg, float& bb) const = 0;
+
+        // ========================================
+        // ANIMACIÓN (solo temas dinámicos)
+        // ========================================
+
+        /**
+         * Actualiza progreso de animación interna (solo dinámicos)
+         * @param delta_time: Tiempo transcurrido desde último frame
+         */
+        virtual void update(float delta_time) { }
+
+        /**
+         * ¿Este tema necesita update() cada frame?
+         * @return false para estáticos, true para dinámicos
+         */
+        virtual bool needsUpdate() const { return false; }
+
+        /**
+         * Obtiene progreso actual de animación interna
+         * @return 0.0 para estáticos, 0.0-1.0 para dinámicos
+         */
+        virtual float getProgress() const { return 0.0f; }
+
+        /**
+         * Reinicia progreso de animación a 0.0 (usado al activar tema)
+         */
+        virtual void resetProgress() { }
+
+        // ========================================
+        // PAUSA (solo temas dinámicos)
+        // ========================================
+
+        /**
+         * ¿Está pausado? (solo dinámicos)
+         * @return false para estáticos, true/false para dinámicos
+         */
+        virtual bool isPaused() const { return false; }
+
+        /**
+         * Toggle pausa de animación (solo dinámicos, tecla Shift+D)
+         */
+        virtual void togglePause() { }
+};