refactor(bloques2-5): auditoria de codi - limpieza i arquitectura

Bloque 2: eliminar codi mort comentat (shape_manager, engine)
Bloque 3: Engine shape methods com thin wrappers a ShapeManager;
          eliminar estat duplicat de shapes en Engine
Bloque 4: encapsular getBallsMutable() amb helpers a SceneManager
          (enableShapeAttractionAll, resetDepthScalesAll)
Bloque 5: StateManager Phase 9 - tota la logica DEMO/LOGO
          implementada directament amb refs a SceneManager,
          ThemeManager i ShapeManager; eliminar callbacks a Engine.
          Acoplament Engine<->StateManager passa a unidireccional.

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

source/shapes_mgr/shape_manager.hpp

@@ -133,6 +133,18 @@ class ShapeManager {
          */
         float getConvergence() const { return shape_convergence_; }
 
+        /**
+         * @brief Establece la escala de figura y aplica clamping
+         * @param scale Nuevo factor de escala (se limitará a rango válido)
+         */
+        void setShapeScaleFactor(float scale);
+
+        /**
+         * @brief Establece el estado del zoom por profundidad Z
+         * @param enabled true para activar, false para desactivar
+         */
+        void setDepthZoomEnabled(bool enabled) { depth_zoom_enabled_ = enabled; }
+
     private:
         // === Referencias a otros componentes ===
         Engine* engine_;            // Callback al Engine (legacy - temporal)