feat(infra): auto-commit con 10 cambios

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

cpp/framework/app_base.h

@@ -101,6 +101,21 @@ struct AppConfig {
     int height = 720;
     bool vsync = true;
     bool viewports = true; // Multi-viewport ON por defecto: ventanas ImGui arrastrables fuera del main window
+
+    // Headless: si true, la ventana GLFW se crea oculta (GLFW_VISIBLE=FALSE).
+    // El contexto OpenGL real se sigue creando y el render ocurre offscreen,
+    // por lo que las pruebas visuales y de UI siguen siendo fieles, pero la
+    // ventana nunca se mapea en pantalla (cero parpadeo, no roba foco).
+    //
+    // Politica por path:
+    //   - run_app (apps reales): default visible (headless = false).
+    //   - run_app_test (Dear ImGui Test Engine): default OCULTA. Los tests de
+    //     frontend corren headless salvo opt-out explicito para debug visual.
+    //
+    // Override por entorno (gana sobre el default del path y sobre este flag):
+    //   FN_HEADLESS=1 / true  -> fuerza ventana oculta.
+    //   FN_HEADLESS=0 / false -> fuerza ventana visible (ej. ver un test).
+    bool headless = false;
     ThemeMode theme = ThemeMode::FnDark; // Identidad visual unificada por defecto
     float bg_r = 0.102f; // fn_tokens::colors::bg (dark.7 #1A1B1E)
     float bg_g = 0.106f;