feat: convert to typescript and esm

[lukekarrys]

BREAKING CHANGE: read is now written in TypeScript and types are now
shipped as part of this package.

BREAKING CHANGE: read now only exports a named export { read }
and does not have a default export.

---

TODO:

• Set required template-oss configs so it template-oss-check passes
• Get eslint import config working with typescript + .js files (or use allowImportingTsExtensions)
• Add typescript eslint plugin
• Update engines
• Use TypeScript, ESM, tap18 support template-oss#371 instead of local tarball

[lukekarrys]

@isaacs any thoughts on the tsconfig.json or tshy+tap setup would be greatly appreciated. this is based on #44 and updated to replace the previous ts+esm/cjs config with tshy and tap@18.

also does it need a separate read.d.ts file if the types are exported from read.ts?

[isaacs]

Some changes suggested.

And yes, definitely remove the read.d.ts if this is being written in TS, it will be extraneous and just serve to confuse things. Better to let TS find the appropriate dialect-specific types in dist.

[lukekarrys]

Made all the changes suggested. I was not set on a default export, and I think TypeScript+ESM is a good push for us to end the pattern module.exports = () => {}; module.exports.x = 1;

[isaacs]

Those node 14 tests are never going to pass with tap 18, probably best to remove from the matrix.

[lukekarrys]

yes node 14 is definitely getting dropped as part of this PR

[wraithgar]

If we're bumping engines let's bump engines

npm view npm engines
{ node: '^18.17.0 || >=20.5.0' }

$ npm query '#read' |json -a _id from
read@2.1.0 [
  "node_modules/init-package-json",
  "node_modules/promzard",
  "workspaces/libnpmexec",
  ""
]

[lukekarrys]

This is now using @npmcli/template-oss@4.20.0 and has been squashed down to single commit.

@wraithgar It also removes the engines update entirely as I dropped it back to tap@16 + c8 and ts-node to avoid that issue for now.

[lukekarrys]

Bumped out of date devDeps and adding TODO comments for all ignored coverage.