@spec calculate_factors([integer()]) :: tuple()

Calculate exponent and remainder of the players by the power of 2

@spec fill_pattern(integer(), integer()) :: [integer()]

Takes count of matches and number of the current fill iteration. It will generate fill pattern to build matches flow.

Returns list of number for matches flow.

@spec generate_preliminary_matches(number(), integer()) :: [ExTournaments.Match.t()]

Takes calculated remainder and return list of matches for the preliminary round

@spec generate_regular_matches(
  [ExTournaments.Match.t()],
  non_neg_integer(),
  non_neg_integer(),
  number(),
  number(),
  boolean()
) :: {[ExTournaments.Match.t()], integer()}

Takes list of %ExTournaments.Match{} structs, round index, first round index, calculated exponents and flag to toggle function.

Returns tuple with a list of generated matches and count of rounds.

@spec prefill_bracket(float()) :: [integer()]

Takes calculated exponent and return list of prefilled participants seed

@spec prepare_players_list([integer()], boolean()) :: [integer()]

Takes list of players IDs and according to the passed flag it will shuffle it.

@spec set_byes_for_first_round(
  [ExTournaments.Match.t()],
  [integer()],
  integer(),
  number(),
  number()
) ::
  [ExTournaments.Match.t()]

Takes list of matches, first round index, list of players IDs and calculated exponent and remainder. It will set BYE to the matches in the first round by the remainder.

Returns list of matches with assigned BYE.

@spec set_players_for_first_round(
  [ExTournaments.Match.t()],
  [integer()],
  non_neg_integer(),
  [non_neg_integer()],
  number()
) :: [ExTournaments.Match.t()]

Takes list of matches, list of seeds, first round index, list of players IDs and calculated remainder. It will assign players to the matches by the list of seeds and shuffling algorithms.

Returns list of matches with assign players to the first round.