Files
Andrew BradleyandGitHub 960aa6d35e V11 breaking changes (#1760)
* remove node12 stuff

* bump minimum supported TS version to 3.8 to match DT

* install source-map-support in register, not create

* Remove ts.createIncrementalProgram fallback to ts.createEmitAndSemanticDiagnosticsBuilderProgram

* Make enableExperimentalEsmLoaderInterop() on by default; remove conditional code

* Remove deprecated `ts-script` bin

* make bin.ts `main()` export @internal

* change `nodeEval` function signature to accept `context: Context` instead of `: any`

* fix version check

* Add node18 @tsconfig/bases; remove node10 and node12; change dependencies to be wildcard; will respect whatever version you want to use

* More stuff for bumping minimum supported node12 -> node14

* remove test workaround that avoided old bug in node nightly

* fix test failing due to `lib` change in @tsconfig/bases node18

* merge fixes

* fix
2022-07-14 14:31:26 -04:00

1.9 KiB

The dist-raw directory contains JS sources that are distributed verbatim, not compiled nor typechecked via TS.

To implement ESM support, we unfortunately must duplicate some of node's built-in functionality that is not exposed via an API. We have copy-pasted the necessary code from https://github.com/nodejs/node/tree/master/lib then modified it to suite our needs.

Formatting may be intentionally bad to keep the diff as small as possible, to make it easier to merge upstream changes and understand our modifications. For example, when we need to wrap node's source code in a factory function, we will not indent the function body, to avoid whitespace changes in the diff.

One obvious problem with this approach: the code has been pulled from one version of node, whereas users of ts-node run multiple versions of node. Users running node 14 may see that ts-node behaves like node 18, for example.

raw directory

Within the raw directory, we keep unmodified copies of the node source files. This allows us to use diffing tools to compare files in raw to those in dist-raw, which will highlight all of the changes we have made. Hopefully, these changes are as minimal as possible.

Naming convention

Not used consistently, but the idea is:

node-<directory>(...-<directory>)-<filename>.js

node-internal-errors.js -> github.com/nodejs/node/blob/TAG/lib/internal/errors.js

So, take the path within node's lib/ directory, and replace slashes with hyphens.

In the raw directory, files are suffixed with the version number or revision from which they were downloaded.

If they have a stripped suffix, this means they have large chunks of code deleted, but no other modifications. This is useful when diffing. Sometimes our dist-raw files only have a small part of a much larger node source file. It is easier to diff raw/*-stripped.js against dist-raw/*.js.