// Ichimoku Kinko Hyo (一目均衡表): five lines derived from rolling
// high/low midpoints and displacements. All lines are O(n) via the base
// rolling primitives.

///|
/// Ichimoku decomposition: tenkan, kijun, senkou_a, senkou_b and chikou,
/// all of input length with NaN outside their valid ranges.
pub struct IchimokuResult {
  tenkan : Array[Double]
  kijun : Array[Double]
  senkou_a : Array[Double]
  senkou_b : Array[Double]
  chikou : Array[Double]
}

///|
/// Number of leading NaN values of the tenkan/kijun lines for their periods.
pub fn ichimoku_lookback(tenkan : Int32, kijun : Int32) -> Int32 {
  if kijun > tenkan {
    kijun - 1
  } else {
    tenkan - 1
  }
}

///|
/// Ichimoku Kinko Hyo.
///
/// - `tenkan[i] = (hh(tenkan) + ll(tenkan)) / 2` over the last `tenkan` bars;
/// - `kijun[i]` mirrors it over `kijun` bars;
/// - `senkou_a[i] = (tenkan[i - displacement] + kijun[i - displacement]) / 2`
///   (the midpoint computed `displacement` bars ago, plotted forward);
/// - `senkou_b[i] = (hh(senkou) + ll(senkou)) / 2` from the window ending
///   `displacement` bars ago;
/// - `chikou[i] = close[i + displacement]` (the close plotted backward).
///
/// All lines share the flat-window and NaN rules of the rolling extremes.
pub fn ichimoku(
  candles : @base.Candles,
  tenkan~ : Int32,
  kijun~ : Int32,
  senkou~ : Int32,
  displacement~ : Int32,
) -> IchimokuResult raise @base.TaError {
  @base.validate_candles(candles)
  if tenkan <= 0 || kijun <= 0 || senkou <= 0 || displacement < 0 {
    raise @base.InvalidPeriod(
      "periods must be positive and displacement non-negative",
    )
  }
  let n = candles.close.length()
  let hh_t = @base.rolling_max(candles.high, tenkan)
  let ll_t = @base.rolling_min(candles.low, tenkan)
  let hh_k = @base.rolling_max(candles.high, kijun)
  let ll_k = @base.rolling_min(candles.low, kijun)
  let hh_s = @base.rolling_max(candles.high, senkou)
  let ll_s = @base.rolling_min(candles.low, senkou)
  let tenkan_line : Array[Double] = []
  let kijun_line : Array[Double] = []
  for i in 0..