pub struct AmplitudeStatistics {
  samples : Int
  minimum : Double
  maximum : Double
  mean : Double
  rms : Double
  standard_deviation : Double
} derive(ToJson)

pub struct Dataset {
  header : FileHeader
  // private fields
}

pub(all) enum Endian {
  Big
  Little
} derive(Eq)

pub struct FileHeader {
  endian : Endian
  revision : Int
  raw_revision_word : Int
  assumed_legacy_revision_one : Bool
  sample_code : Int
  samples : Int
  interval_us : Double
  fixed_length : Bool
  extended_count : Int
  declared_traces : UInt64
  first_trace : Int
  text_encoding : String
  raw : Bytes
}

pub struct QualityGroup {
  value : Int
  first_trace : Int
  summary : QualitySummary
} derive(ToJson)

pub struct QualityReport {
  status : String
  format_assumptions : Array[String]
  source_trace_count : Int
  weighted : Bool
  dead_threshold : Double
  clip_threshold : Double
  clipping_checked : Bool
  group_by : String?
  summary : QualitySummary
  groups : Array[QualityGroup]
  details : Array[TraceQuality]
  max_details : Int
  details_truncated : Bool
}

pub struct QualitySummary {
  traces : Int
  samples : Int
  analyzed_traces : Int
  analyzed_samples : Int
  problem_traces : Int
  nonfinite_samples : Int
  integer_range_samples : Int
  negative_weighting_traces : Int
  weighting_range_samples : Int
  dead_traces : Int
  header_dead_traces : Int
  clipped_traces : Int
  clipped_samples : Int
  minimum_samples : Int
  maximum_samples : Int
  minimum_interval_us : Double
  maximum_interval_us : Double
  statistics : AmplitudeStatistics?
}

pub(all) enum Sample {
  Signed(Int64)
  Real(Double)
}

pub struct Trace {
  // private fields
}

pub(all) struct TraceGroup {
  value : Int
  indices : Array[Int]
} derive(ToJson)

pub(all) struct TraceIndex {
  header_offset : Int
  sample_offset : Int
  samples : Int
  interval_us : Double
} derive(ToJson)

pub struct TraceQuality {
  trace : Int
  header_offset : Int
  sample_offset : Int
  sequence_line : Int
  sequence_file : Int
  field_record : Int
  ensemble : Int
  identification : Int
  samples : Int
  interval_us : Double
  weighting : Int
  flags : Array[String]
  nonfinite_samples : Int
  first_nonfinite_sample : Int?
  integer_range_samples : Int
  first_integer_range_sample : Int?
  weighting_range_samples : Int
  first_weighting_range_sample : Int?
  statistics : TraceStatistics?
}

pub(all) struct TraceStatistics {
  samples : Int
  minimum : Double
  maximum : Double
  mean : Double
  rms : Double
  standard_deviation : Double
  dead : Bool
  clipped_samples : Int
  clipping_checked : Bool
} derive(ToJson)

fn create(header : FileHeader, traces : Array[Trace], extended_headers? : Array[Bytes]) -> Dataset raise

fn decode(data : Bytes, endian? : Endian, text_encoding? : String, legacy_revision_one? : Bool) -> Dataset raise

fn decode_sample(data : Bytes, offset : Int, code : Int, endian : Endian) -> Sample raise

fn decode_text(data : Bytes, encoding : String) -> String raise

fn encode_samples(samples : Array[Sample], code : Int, endian : Endian) -> Bytes raise

fn encode_text(text : String, encoding : String) -> Bytes raise

fn make_header(samples : Int, interval_us : Double, sample_code : Int, endian? : Endian, revision? : Int, fixed_length? : Bool, text? : String, text_encoding? : String, extended_count? : Int) -> FileHeader raise

fn make_trace(header : FileHeader, samples : Array[Sample], interval_us? : Double, fields? : Map[String, Int]) -> Trace raise

fn parse_header(data : Bytes, endian? : Endian, text_encoding? : String, legacy_revision_one? : Bool) -> FileHeader raise

fn sample_width(code : Int) -> Int raise