///|
/// Decodes a whole Zstandard stream held in memory: one or more frames.
/// `max_output` caps the decoded size (unlimited by default) and raises
/// `OutputLimitExceeded` past it; `max_window_bits` is as for `Decoder`.
pub fn decompress(
  input : BytesView,
  max_output? : Int32,
  max_window_bits~ : Int32 = 27,
) -> Bytes raise ZstdError {
  let decoder = Decoder(max_window_bits~)
  let chunk = FixedArray::make(1 << 16, b'\x00')
  let out = Buffer()
  let mut rest = input
  for ;; {
    let status = decoder.step_into(rest, chunk, end=true)
    rest = rest[decoder.last_consumed():]
    let produced = decoder.last_produced()
    // `out` holds at most `limit` bytes, so this cannot overflow.
    if max_output is Some(limit) && produced > limit - out.length() {
      raise ZstdError(OutputLimitExceeded, "the output exceeds \{limit} bytes")
    }
    out.write_bytesview(Bytes::from_array(chunk[:produced])[:])
    if status is Done {
      return out.to_bytes()
    }
  }
}