BREAKING(io): remove LimitedReader

[iuioiua]

What's changed

LimitedReader has been removed from @std/io.

Motivation

This change was made to help push users towards using the Streams API and @std/streams, and make design decisions about which APIs easier.

Migration guide

Note: the deprecation notice for readDelim() says to use LimitedByteTransformStream. This is incorrect. Instead, migrate using the instructions below.

To migrate, pipe the readable stream through a ByteSliceStream, setting start to 0, and end to 1 less than that of limit in LimitedReader.

- import { LimitedReader } from "@std/io/limited-reader";
- import { readAll } from "@std/io/read-all";
+ import { ByteSliceStream } from "@std/streams/byte-slice-stream";
+ import { toText } from "@std/streams/to-text";

  using file = await Deno.open("README.md");

- const reader = new LimitedReader(file, 10);
+ const stream = file.readable.pipeThrough(new ByteSliceStream(0, 9));

- console.log(new TextDecoder().decode(await readAll(reader))); // "# Deno Sta"
+ console.log(await toText(stream)); // "# Deno Sta"

Related

Towards #5989

[kt3k]

LGTM