using System;

using Framework.Services;

namespace Framework.State {

  /// <summary>Manages the game object currently being controlled by the player</summary>
  [
    ServiceScope(Scope.Scene),
    DefaultBinding(typeof(ControlManager))
  ]
  public interface IControlManager {

    /// <summary>Called when the player switches control to another controllable</summary>
    /// <remarks>>
    ///   First argument is the player index, second argument is the controllable
    ///   that player has assumed control of.
    /// </remarks>
    event Action<int, IControllable> ControlSwitched;

    /// <summary>Lets a player assume control of the specified controllable</summary>
    /// <param name="playerIndex">Index of the player that will assume control</param>
    /// <param name="controllable">Controllable the player will be controlling</param>
    void AssumeControl(int playerIndex, IControllable controllable);

    /// <summary>Gets the controllable currently active for the specified player</summary>
    /// <param name="playerIndex">
    ///   Index of the player whose active controllable will be returned
    /// </param>
    /// <returns>The controllable currently active for the specified player</returns>
    IControllable GetControllable(int playerIndex);

  }

} // namespace Framework.State