pub struct Activity {
  title : String
  detail : String
  windows : Array[String]
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct ActivityPlan {
  activity : String
  windows : Array[ScoredWindow]
  note : String
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct Astro {
  s : Double
  h : Double
  p : Double
  n : Double
  pp : Double
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct Constituent {
  name : String
  d1 : Int
  d2 : Int
  d3 : Int
  d4 : Int
  d5 : Int
  d6 : Int
  speed : Double
  nodal_kind : NodalKind
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub(all) enum ExtremeKind {
  High
  Low
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct Harmonic {
  constituent : Constituent
  amplitude : Double
  phase_lag : Double
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct Moment {
  year : Int
  month : Int
  day : Int
  local_hour : Double
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub enum NodalKind {
  Solar
  SemiDiurnal
  LunarDiurnal
  LuniSolarDiurnal
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct Prediction {
  station : Station
  start_jd : Double
  duration_hours : Double
  tz : Double
  extremes : Array[TideExtreme]
  max_height : Double
  min_height : Double
  tidal_range : Double
  spring_neap : String
  sunrise_hour : Double
  sunset_hour : Double
  activities : Array[Activity]
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct ReferencePrediction {
  time_jd : Double
  height : Double
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct ScoredWindow {
  window : TideWindow
  score : Double
  reason : String
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct Station {
  id : String
  name : String
  lat : Double
  lon : Double
  datum : Double
  components : Array[Harmonic]
  source : String
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct TideExtreme {
  time_jd : Double
  height : Double
  kind : ExtremeKind
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct TideSample {
  jd : Double
  height : Double
  rate : Double
  state : TideState
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub enum TideState {
  Rising
  Falling
  HighSlack
  LowSlack
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct TideStats {
  min_height : Double
  max_height : Double
  mean_height : Double
  range : Double
  max_flood_rate : Double
  max_ebb_rate : Double
  rising_fraction : Double
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct TideWindow {
  start_jd : Double
  end_jd : Double
  label : String
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct ValidationIssue {
  level : ValidationLevel
  field : String
  message : String
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub enum ValidationLevel {
  Error
  Warning
  Info
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct ValidationStats {
  sample_count : Int
  bias : Double
  mean_absolute_error : Double
  root_mean_square_error : Double
  max_absolute_error : Double
  tolerance : Double
  passed : Bool
} derive(
@moonbitlang/core/debug.Debug
Debug)

fn amplitude_sum(station : Station, names : Array[String]) -> Double

fn astro_at(jd : Double) -> Astro

fn beach_plan(extremes : Array[TideExtreme], sunrise : Double, sunset : Double, tz : Double, range : Double) -> ActivityPlan

fn birding_plan(extremes : Array[TideExtreme], sunrise : Double, sunset : Double, tz : Double) -> ActivityPlan

fn builtin_stations() -> Array[Station]

fn catalog_size() -> Int

fn compare_with_reference(station : Station, references : Array[ReferencePrediction], tolerance : Double) -> ValidationStats?

fn component_names(station : Station) -> Array[String]

fn compute_stats(samples : Array[TideSample]) -> TideStats

fn coordinate_label(lat : Double, lon : Double) -> String

fn day_of_year(year : Int, month : Int, day : Int) -> Int

fn distance_km(lat1 : Double, lon1 : Double, lat2 : Double, lon2 : Double) -> Double

fn dominant_state(samples : Array[TideSample]) -> TideState

fn equilibrium_argument(c : Constituent, a : Astro, t_hours : Double) -> Double

fn extremes_to_csv(extremes : Array[TideExtreme], tz : Double) -> String

fn extremes_to_ics(station : Station, extremes : Array[TideExtreme], tz : Double) -> String

fn fastest_constituent() -> Constituent

fn find_constituent(name : String) -> Constituent?

fn find_extremes(station : Station, start_jd : Double, duration_hours : Double, step_hours : Double) -> Array[TideExtreme]

fn find_next_extreme(station : Station, jd : Double, horizon_hours : Double, step_hours : Double) -> TideExtreme?

fn find_station(id : String) -> Station?

fn fishing_activity_plan(extremes : Array[TideExtreme], sunrise : Double, sunset : Double, tz : Double, station : Station) -> ActivityPlan

fn format_local_datetime(jd : Double, tz_offset : Double) -> String

fn format_local_time(jd : Double, tz_offset : Double) -> String

fn format_meters(x : Double) -> String

fn harmonic_count(station : Station) -> Int

fn has_constituent(station : Station, name : String) -> Bool

fn hemisphere_label(station : Station) -> String

fn high_water_windows(extremes : Array[TideExtreme], before_hours : Double, after_hours : Double) -> Array[TideWindow]

fn is_eastern(station : Station) -> Bool

fn is_neap(tidal_range : Double, mean_range : Double) -> Bool

fn is_northern(station : Station) -> Bool

fn is_spring(tidal_range : Double, mean_range : Double) -> Bool

fn is_valid(issues : Array[ValidationIssue]) -> Bool

fn jd_to_calendar(jd : Double) -> (Int, Int, Int, Double)

fn julian_day_utc(year : Int, month : Int, day : Int, utc_hour : Double) -> Double

fn local_hour_of(jd : Double, tz_offset : Double) -> Double

fn low_water_windows(extremes : Array[TideExtreme], before_hours : Double, after_hours : Double) -> Array[TideWindow]

fn mean_tidal_range(station : Station) -> Double

fn merge_windows(windows : Array[TideWindow]) -> Array[TideWindow]

fn moment_to_jd(moment : Moment, tz_offset : Double) -> Double

fn nearest_station(lat : Double, lon : Double) -> Station?

fn nearest_station_summary(lat : Double, lon : Double) -> String

fn noaa_unsupported_constituents(harcon : Json) -> Array[String]

fn nodal_correction(c : Constituent, n_degrees : Double) -> (Double, Double)

fn normalize_degrees(x : Double) -> Double

fn overlap_hours(a : TideWindow, b : TideWindow) -> Double

fn parse_local_datetime(s : String) -> Moment?

fn parse_station_file(content : String) -> Station?

fn plan_to_markdown(plan : ActivityPlan, tz : Double) -> String

fn plans_for(prediction : Prediction) -> Array[ActivityPlan]

fn plans_to_markdown(plans : Array[ActivityPlan], tz : Double) -> String

fn predict(station : Station, start : Moment, tz : Double, duration_hours : Double) -> Prediction

fn predict_on(station : Station, date : String, tz : Double, duration_hours : Double) -> Prediction?

fn predictions_from_noaa(root : Json) -> Array[ReferencePrediction]?

fn rank_windows(windows : Array[ScoredWindow]) -> Array[ScoredWindow]

fn recommend(extremes : Array[TideExtreme], sunrise : Double, sunset : Double, tz : Double) -> Array[Activity]

fn render_curve(station : Station, start_jd : Double, duration_hours : Double, step_hours : Double, tz : Double) -> String

fn render_json(p : Prediction) -> String

fn render_report(p : Prediction) -> String

fn sample_series(station : Station, start_jd : Double, duration_hours : Double, step_hours : Double) -> Array[TideSample]

fn samples_to_csv(samples : Array[TideSample], tz : Double) -> String

fn score_fishing_window(window : TideWindow, sunrise : Double, sunset : Double, tz : Double, flood_rate : Double) -> Double

fn score_low_tide_window(window : TideWindow, sunrise : Double, sunset : Double, tz : Double, height_span : Double) -> Double

fn slowest_constituent() -> Constituent

fn solar_declination(day_of_year : Int) -> Double

fn standard_constituents() -> Array[Constituent]

fn state_label(state : TideState) -> String

fn station_from_json(root : Json) -> Station?

fn station_from_noaa(metadata : Json, harcon : Json, datums? : Json) -> Station?

fn station_id(station : Station) -> String

fn station_lat(station : Station) -> Double

fn station_lon(station : Station) -> Double

fn station_name(station : Station) -> String

fn station_quality_score(station : Station) -> Double

fn station_source(station : Station) -> String

fn station_summary(station : Station) -> String

fn stations_in_bounds(min_lat : Double, max_lat : Double, min_lon : Double, max_lon : Double) -> Array[Station]

fn stations_to_markdown(stations : Array[Station]) -> String

fn stats_to_markdown(stats : TideStats, coefficient : Double) -> String

fn sunrise_sunset(lat_degrees : Double, day_of_year : Int) -> (Double, Double)?

fn tide_coefficient(tidal_range : Double, mean_range : Double) -> Double

fn tide_height(station : Station, jd : Double) -> Double

fn tide_rate(station : Station, jd : Double, delta_hours : Double) -> Double

fn tide_state(station : Station, jd : Double, tolerance : Double) -> TideState

fn to_degrees(radians : Double) -> Double

fn to_radians(degrees : Double) -> Double

fn validate_coordinates(lat : Double, lon : Double) -> Array[ValidationIssue]

fn validate_datum(datum : Double) -> Array[ValidationIssue]

fn validate_harmonic(harmonic : Harmonic) -> Array[ValidationIssue]

fn validate_hours(hours : Double) -> Array[ValidationIssue]

fn validate_station(station : Station) -> Array[ValidationIssue]

fn validate_timezone(tz : Double) -> Array[ValidationIssue]

fn validation_stats_to_markdown(stats : ValidationStats) -> String

fn validation_to_markdown(issues : Array[ValidationIssue]) -> String

fn window_around(extreme : TideExtreme, before_hours : Double, after_hours : Double, label : String) -> TideWindow

fn window_contains(window : TideWindow, jd : Double) -> Bool