Run one decompression step. Accepts a bounded prefix of input, then decodes
plaintext into output. Returns StepResult with this call's status,
consumed and produced byte counts; drop only input[:result.consumed] and re-present a suffix that was held back by
output backpressure. Pending body input is drained before accepting more,
so a call can produce output without consuming new input.
Input is borrowed only for this call; any retained suffix is copied.
Once all source input has been accepted, call check_end to declare EOF.
It returns Done, requests output space, or raises a truncation error.
Drain pending output through step with empty input; EOF stays latched.
A multi-member stream needs this signal to establish that no further
member will follow. After EOF or Done, later input is not accepted.
Concatenated multi-member streams (RFC 1952 §2.2) decode in full; their
payloads are joined. If the final accepted view also contains non-gzip
bytes, retrieve that read-ahead after Done with unused_input(). On
failure, the decoder locks the first GzipError kind/message and rethrows
it on every later call. A failing call returns no result; its output buffer
may already contain partial output.