Questions about this release? Ask in the official discussion thread: #1337
Breaking changes are prefixed with [BREAKING]
Added
- Adds
--show-config
to log the resolved configuration (docs) (#1100, #1243) - Bundle and re-export @tsconfig/node* configurations for convenience (docs) (#1202, #1236, #1313)
- Default to appropriate @tsconfig/node* configuration based on node and typescript versions (docs) (#1202, #1236, #1313)
- Automatically reference @types/node; use globally-installed @types/node if not locally installed (#1240, #1257)
- Add
swc
integration and new--transpiler
option to use third-party transpilers for a massive speed boost on large codebases (docs) (#779, #1160) - Add
scopeDir
API option (docs) (#1155) - Add
projectSearchDir
API option (docs) (#1155) - Add
--cwd-mode
andts-node-cwd
to resolve config file relative to cwd, not entrypoint script (#1155)
Changed
- [BREAKING] Make
--script-mode
default behavior; resolve tsconfig relative to entrypoint script instead of cwd (#949, #1197, #1155)- In most cases this change will have no noticeable effect
- Primarily benefits portable shell scripts on your
$PATH
, becausets-node
will respect the script's localtsconfig.json
- Use
--cwd-mode
orts-node-cwd
if you need legacy behavior
- [BREAKING]
ignore
rules evaluate relative totsconfig.json
directory, otherwisecwd
(#1155) - [BREAKING] Remove support for node 10. Minimum supported version is node 12 (#1312)
- Rename
--dir
to--cwd
; renameTS_NODE_DIR
toTS_NODE_CWD
(#1155)--dir
andTS_NODE_DIR
are deprecated but still parsed for backwards-compatibility--dir
effectively changed the working directory ofts-node
; renaming makes this behavior more obvious
Deprecated
Removed
- [BREAKING] Internal APIs removed from type declarations (#1242)
- Removed
DEFAULTS
,normalizeSlashes
,parse
,split
- No features were removed
- This will only affect consumers of
ts-node
's programmatic API
- Removed
Fixed
- [BREAKING] Fix #1229 and #1235: always throw
ERR_REQUIRE_ESM
when attempting to execute ESM as CJS, even when not using--loader ts-node/esm
(#1232)- This aligns our behavior with vanilla
node
- This aligns our behavior with vanilla
- [BREAKING] Fix #1225:
compiler
is loaded relative totsconfig.json
instead of entrypoint script (#1155)- In most cases this change will have no noticable effect
- Fix #1217: REPL not always using passed stdout and stderr (#1224)
- Fix #1220:
ts-node ./index
may execute the wrong file extension because tsconfig search poisons therequire.resolve
cache (#1155) - Fix #1322: Sourcemaps fail for filenames with spaces or other characters which are percent-encoded in URLs (#1160, #1330)
- Fix #1331: Resolution of node builtin modules in ESM loader fails on node >=12.20.0, <13 (#1332)
Docs
- New documentation website: https://typestrong.org/ts-node
- README is generated to match the website
- Added page explaining CommonJS vs ESM
- Added page with Performance advice
- Added Troubleshooting page
- Organized and added to "Recipes" section with third-party tool integrations
- Added TypeDoc-generated API docs
- Work was spread across multiple tickets: #1207, #1213, #1221, #1228, #1244, #1250, #1294, #1295, #1296, #1297
- Thanks to these contributors for PRs which improved our documentation
- add troubleshooting tip for syntax errors (#1201) @jedwards1211
- Clarify handling of tsx/jsx file extensions (#1179) @NaridaL
- Added
CONTRIBUTING.md
to document the codebase and our development workflow
v9.1.1...v10.0.0
https://github.com/TypeStrong/ts-node/milestone/1