using System;

using Framework.Services;

namespace Framework.Actors.Platformer {
  
  /// <summary>Stores moves a player character can execute</summary>
  /// <remarks>
  ///   <para>
  ///     This component can be added to an actor in order to support both caching
  ///     of moves and use of modified moves.
  ///   </para>
  ///   <para>
  ///     For example, to override the 'air' move (maybe to implement jetpack functionality
  ///     or special animations), you would derive your own class from the 'PlayerMoveRepository'
  ///     and override the <see cref="SelectAirMove" /> method to instead return your special
  ///     air move implementation. The standard 'ground' move will, upon detecting the 'jump'
  ///     key, switch to the 'air' move through the repository, thus activating your special
  ///     air move implementation. 
  ///   </para>
  /// </remarks>
  public class PlayerMoveRepository : ScriptComponent {

    /// <summary>Returns and configures the move for ground-based movement</summary>
    /// <param name="impactVelocity">Downward velocity with which the ground was hit</param>
    /// <returns>The move that should be used for ground movement</returns>
    /// <remarks>
    ///   The impact velocity can be safely ignored but allows for additional realism,
    ///   for example by using different "landing" animations for different impact strengths
    ///   or even deciding whether the actor should die rather than safely land.  
    /// </remarks>
    public virtual Move GetGroundMove(float impactVelocity = 0.0f) {
      if(this.groundMove == null) {
        this.groundMove = new GroundMove();
      }

      return this.groundMove;
    }

    /// <summary>Returns and configures the move for movement through the air</summary>
    /// <param name="jumped">Whether the character has jumped</param>
    /// <returns>The move that should be used for air movement</returns>
    public virtual Move GetAirMove(bool jumped = false) {
      if(this.airMove == null) {
        this.airMove = new AirMove();
      }

      this.airMove.WasActivatedByJumping = jumped;
      return this.airMove;
    }

    /// <summary>Returns and configures the move for dashing</summary>
    /// <returns>The move that should be used for dashes</returns>
    public virtual Move GetDashMove() {
      if(this.dashMove == null) {
        this.dashMove = new DashMove();
      }

      return this.dashMove;
    }

    /// <summary>Returns and configures the move for squatting</summary>
    /// <returns>The move that should be used to squat</returns>
    public virtual Move GetSquatMove() {
      if(this.squatMove == null) {
        this.squatMove = new SquatMove();
      }

      return this.squatMove;
    }

    /// <summary>Returns and configures the move for sliding across the ground</summary>
    /// <returns>The move that should be used to slide</returns>
    public virtual Move GetSlideMove() {
      if(this.slideMove == null) {
        this.slideMove = new SlideMove();
      }

      return this.slideMove;
    }

    /// <summary>Returns and configures the move for walking in a lowered stance</summary>
    /// <returns>The move that should be used to walk in a lowered stance</returns>
    public Move GetSneakMove() {
      if(this.sneakMove == null) {
        this.sneakMove = new SneakMove();
      }

      return this.sneakMove;
    }

    /// <summary>Returns and configures the move for crawling on all fours</summary>
    /// <returns>The move that should be used to crawl on all fours</returns>
    public Move GetCrawlMove() {
      if(this.crawlMove == null) {
        this.crawlMove = new CrawlMove();
      }

      return this.crawlMove;
    }

    /// <summary>Returns and configures the move for getting knocked back</summary>
    /// <returns>The move that should be used to be knocked back</returns>
    public Move GetKnockBackMove() {
      if(this.knockBackMove == null) {
        this.knockBackMove = new KnockBackMove();
      }

      return this.knockBackMove;
    }
    
    /// <summary>Move for controlling the actor on the ground</summary>
    private GroundMove groundMove;
    /// <summary>Move for controlling the actor in the air</summary>
    private AirMove airMove;
    /// <summary>Move where the actor dashes horizontally at high speed</summary>
    private DashMove dashMove;
    /// <summary>Move where the actor takes a lower stance</summary>
    private SquatMove squatMove;
    /// <summary>Move where the actor slides across the ground</summary>
    private SlideMove slideMove;
    /// <summary>Move where the actor walks in a lowered stance</summary>
    private SneakMove sneakMove;
    /// <summary>Move where the actor crawls on all fours</summary>
    private CrawlMove crawlMove;
    /// <summary>Move where the actor is knocked back</summary>
    private KnockBackMove knockBackMove;

  }
  
} // namespace Framework.Actors.Platformer