@type day() :: day_number() | day_atom()

@type day_atom() ::
  :monday | :tuesday | :wednesday | :thursday | :friday | :saturday | :sunday

@type day_number() :: 0..6

@type day_of_month() :: -31..-1 | 1..31

@type frequency() :: :monthly | :weekly | :daily | :hourly | :minutely | :secondly

@type hour_number() :: 0..23

@type minute_number() :: 0..59

@type occurrence() :: time() | Cocktail.Span.t()

@type rule_option() ::
  {:frequency, frequency()}
  | {:interval, pos_integer()}
  | {:count, pos_integer()}
  | {:until, time()}
  | {:days, [day()]}
  | {:days_of_month, [day_of_month()]}
  | {:hours, [hour_number()]}
  | {:minutes, [minute_number()]}
  | {:seconds, [second_number()]}
  | {:times, [Time.t()]}
  | {:time_range, time_range()}

@type rule_options() :: [rule_option()]

@type schedule_option() :: {:duration, pos_integer()}

@type schedule_options() :: [schedule_option()]

@type second_number() :: 0..59

@type time() :: DateTime.t() | NaiveDateTime.t()

@type time_range() :: %{
  start_time: Time.t(),
  end_time: Time.t(),
  interval_seconds: second_number()
}