pub suberror FlacError {
  NeedMore
  Invalid(Int64, String)
  Limit(String)
} derive(Show)

pub(all) struct Audio {
  metadata : Metadata
  frames : Array[Frame]
  integrity : Integrity
}

pub(all) struct CueIndex {
  offset : UInt64
  number : Int
} derive(Show)

pub(all) struct CueSheet {
  catalog : Bytes
  lead_in : UInt64
  is_cd : Bool
  tracks : Array[CueTrack]
} derive(Show)

pub(all) struct CueTrack {
  offset : UInt64
  number : Int
  isrc : Bytes
  non_audio : Bool
  pre_emphasis : Bool
  indices : Array[CueIndex]
} derive(Show)

pub(all) enum DecodeEvent {
  MetadataReady(Metadata)
  AudioFrame(Frame)
  LinkEnd(Integrity)
  NeedInput
  Done(Integrity)
}

type Decoder

pub(all) enum EncodeEvent {
  EncodedBytes(Bytes)
  NeedPcm
  EncoderDone(EncoderSummary)
}

type Encoder

pub(all) struct EncoderConfig {
  format : PcmFormat
  block_size : Int
  variable_block : Bool
  effort : Int
  channel_mask : UInt?
  metadata : Array[MetadataBlock]
  non_audio : Bool
  max_metadata_bytes : Int
}

pub(all) struct EncoderSummary {
  total_samples : Int64
  frames : Int64
  min_frame_size : Int
  max_frame_size : Int
  md5 : Bytes
  final_header : Bytes
}

pub(all) struct Frame {
  sample_number : Int64
  number : Int64
  variable_block : Bool
  sample_rate : Int
  bits_per_sample : Int
  channels : Array[Array[Int]]
  block_size : Int
  byte_offset : Int64
  byte_length : Int
} derive(Show)

pub(all) struct FrameLocation {
  sample : Int64
  offset : Int64
  samples : Int
  bytes : Int
}

pub(all) enum Integrity {
  Md5Verified
  Md5Unavailable
  FrameCrcOnly
} derive(Eq, Show, 
@moonbitlang/core/debug.Debug
Debug)

type Md5

pub(all) struct Metadata {
  info : StreamInfo
  blocks : Array[MetadataBlock]
  seek_points : Array[SeekPoint]
  comments : VorbisComment?
  cuesheet : CueSheet?
  cuesheets : Array[CueSheet]
  pictures : Array[Picture]
} derive(Show)

pub(all) struct MetadataBlock {
  kind : Int
  data : Bytes
} derive(Show)

type OggDemux

pub(all) struct PcmFormat {
  sample_rate : Int
  channels : Int
  bits_per_sample : Int
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct PcmInput {
  pending : BytesView
  offset : Int64
  ended : Bool
  failed : FlacError?
  stage : Int
  format : PcmFormat?
  announced : Bool
  mask : UInt?
  width : Int
  shift : Int
  raw : Bool
  rf64 : Bool
  riff_end : Int64?
  chunk_left : Int64
  pad : Bool
  saw_data : Bool
  saw_ds64 : Bool
  data_size : Int64
  data_size_used : Bool
  expected_samples : Int64
  samples : Int64
  table_left : Int
  sizes : Map[UInt, Array[Int64]]
  size_positions : Map[UInt, Int]
}

pub(all) enum PcmInputEvent {
  PcmFormatReady(PcmFormat, UInt?)
  PcmSamples(Array[Int])
  PcmNeedInput
  PcmInputDone
}

pub(all) struct Picture {
  kind : UInt
  media_type : String
  description : String
  width : UInt
  height : UInt
  depth : UInt
  colors : UInt
  data : Bytes
} derive(Show)

pub(all) enum RawDecodeEvent {
  RawFrame(Frame)
  Skipped(Int64, Int)
  RawNeedInput
  RawDone
}

type RawDecoder

pub(all) struct SeekIndex {
  metadata : Metadata
  frames : Array[FrameLocation]
  total_samples : Int64
  integrity : Integrity
}

pub(all) struct SeekPoint {
  sample : UInt64
  offset : UInt64
  samples : Int
} derive(Show)

pub(all) struct StreamInfo {
  min_block_size : Int
  max_block_size : Int
  min_frame_size : Int
  max_frame_size : Int
  sample_rate : Int
  channels : Int
  bits_per_sample : Int
  total_samples : Int64
  md5 : Bytes
} derive(Show)

pub(all) struct VorbisComment {
  vendor : String
  entries : Array[String]
} derive(Show)

fn build_index(data : Bytes) -> SeekIndex raise FlacError

fn crop_frame(frame : Frame, start : Int64, end : Int64) -> Frame?

fn decode(data : Bytes) -> Audio raise FlacError

fn decode_chained(data : Bytes) -> Array[Audio] raise FlacError

fn decode_indexed_range(data : Bytes, index : SeekIndex, start : Int64, end : Int64) -> Audio raise FlacError

fn decode_range(data : Bytes, start : Int64, end : Int64) -> Audio raise FlacError

fn decode_seektable_range(data : Bytes, start : Int64, end : Int64) -> Audio raise FlacError

fn encode_ogg_pcm(samples : Array[Int], config : EncoderConfig, serial? : UInt, vendor? : String) -> Bytes raise FlacError

fn encode_pcm(samples : Array[Int], config : EncoderConfig) -> Bytes raise FlacError

fn frame_pcm(frame : Frame, wav? : Bool) -> Bytes

fn ogg_from_flac(native : Bytes, serial? : UInt, vendor? : String) -> Bytes raise FlacError

fn parse_metadata(data : Bytes, max_metadata_bytes? : Int) -> (Metadata, Int) raise FlacError

fn wav_header(info : StreamInfo, samples : Int64, channel_mask? : UInt, rf64? : Bool) -> Bytes raise FlacError