TypeStrong/ts-node
### [`v10.0.0`](https://togithub.com/TypeStrong/ts-node/releases/v10.0.0)
[Compare Source](https://togithub.com/TypeStrong/ts-node/compare/v9.1.1...v10.0.0)
Questions about this release? Ask in the official discussion thread: [#1337](https://togithub.com/TypeStrong/ts-node/issues/1337)
*Breaking changes are prefixed with **\[BREAKING]***
**Added**
- Adds `--show-config` to log the resolved configuration ([docs](https://typestrong.org/ts-node/docs/troubleshooting#understanding-configuration)) ([#1100](https://togithub.com/TypeStrong/ts-node/issues/1100), [#1243](https://togithub.com/TypeStrong/ts-node/issues/1243))
- Bundle and re-export [@tsconfig/node](https://togithub.com/tsconfig/node)\* configurations for convenience ([docs](https://typestrong.org/ts-node/docs/configuration#tsconfigbases)) ([#1202](https://togithub.com/TypeStrong/ts-node/issues/1202), [#1236](https://togithub.com/TypeStrong/ts-node/issues/1236), [#1313](https://togithub.com/TypeStrong/ts-node/issues/1313))
- Default to appropriate [@tsconfig/node](https://togithub.com/tsconfig/node)\* configuration based on node and typescript versions ([docs](https://typestrong.org/ts-node/docs/configuration#default-config)) ([#1202](https://togithub.com/TypeStrong/ts-node/issues/1202), [#1236](https://togithub.com/TypeStrong/ts-node/issues/1236), [#1313](https://togithub.com/TypeStrong/ts-node/issues/1313))
- Automatically reference [@types/node](https://togithub.com/types/node); use globally-installed [@types/node](https://togithub.com/types/node) if not locally installed ([#1240](https://togithub.com/TypeStrong/ts-node/issues/1240), [#1257](https://togithub.com/TypeStrong/ts-node/issues/1257))
- Add `swc` integration and new `--transpiler` option to use third-party transpilers for a massive speed boost on large codebases ([docs](https://typestrong.org/ts-node/docs/transpilers)) ([#779](https://togithub.com/TypeStrong/ts-node/issues/779), [#1160](https://togithub.com/TypeStrong/ts-node/issues/1160))
- Add `scopeDir` API option ([docs](https://typestrong.org/ts-node/api/interfaces/RegisterOptions.html#scopeDir)) ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- Add `projectSearchDir` API option ([docs](https://typestrong.org/ts-node/api/interfaces/RegisterOptions.html#projectSearchDir)) ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- Add `--cwd-mode` and `ts-node-cwd` to resolve config file relative to cwd, not entrypoint script ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
**Changed**
- **\[BREAKING]** Make `--script-mode` default behavior; resolve tsconfig relative to entrypoint script instead of cwd ([#949](https://togithub.com/TypeStrong/ts-node/issues/949), [#1197](https://togithub.com/TypeStrong/ts-node/issues/1197), [#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- In most cases this change will have no noticeable effect
- Primarily benefits portable shell scripts on your `$PATH`, because `ts-node` will respect the script's local `tsconfig.json`
- Use `--cwd-mode` or `ts-node-cwd` if you need legacy behavior
- **\[BREAKING]** `ignore` rules evaluate relative to `tsconfig.json` directory, otherwise `cwd` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- **\[BREAKING]** Remove support for node 10. Minimum supported version is node 12 ([#1312](https://togithub.com/TypeStrong/ts-node/issues/1312))
- Rename `--dir` to `--cwd`; rename `TS_NODE_DIR` to `TS_NODE_CWD` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- `--dir` and `TS_NODE_DIR` are deprecated but still parsed for backwards-compatibility
- `--dir` effectively changed the working directory of `ts-node`; renaming makes this behavior more obvious
**Deprecated**
- Deprecate `TS_NODE_SCOPE` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- Deprecate `--dir` and `TS_NODE_DIR` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
**Removed**
- **\[BREAKING]** Internal APIs removed from type declarations ([#1242](https://togithub.com/TypeStrong/ts-node/issues/1242))
- Removed `DEFAULTS`, `normalizeSlashes`, `parse`, `split`
- No features were removed
- This will only affect consumers of `ts-node`'s programmatic API
**Fixed**
- **\[BREAKING]** Fix [#1229](https://togithub.com/TypeStrong/ts-node/issues/1229) and [#1235](https://togithub.com/TypeStrong/ts-node/issues/1235): always throw `ERR_REQUIRE_ESM` when attempting to execute ESM as CJS, even when not using `--loader ts-node/esm` ([#1232](https://togithub.com/TypeStrong/ts-node/issues/1232))
- This aligns our behavior with vanilla `node`
- **\[BREAKING]** Fix [#1225](https://togithub.com/TypeStrong/ts-node/issues/1225): `compiler` is loaded relative to `tsconfig.json` instead of entrypoint script ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- In most cases this change will have no noticable effect
- Fix [#1217](https://togithub.com/TypeStrong/ts-node/issues/1217): REPL not always using passed stdout and stderr ([#1224](https://togithub.com/TypeStrong/ts-node/issues/1224))
- Fix [#1220](https://togithub.com/TypeStrong/ts-node/issues/1220): `ts-node ./index` may execute the wrong file extension because tsconfig search poisons the `require.resolve` cache ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155))
- Fix [#1322](https://togithub.com/TypeStrong/ts-node/issues/1322): Sourcemaps fail for filenames with spaces or other characters which are percent-encoded in URLs ([#1160](https://togithub.com/TypeStrong/ts-node/issues/1160), [#1330](https://togithub.com/TypeStrong/ts-node/issues/1330))
- Fix [#1331](https://togithub.com/TypeStrong/ts-node/issues/1331): Resolution of node builtin modules in ESM loader fails on node >=12.20.0, <13 ([#1332](https://togithub.com/TypeStrong/ts-node/issues/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](https://togithub.com/TypeStrong/ts-node/issues/1207), [#1213](https://togithub.com/TypeStrong/ts-node/issues/1213), [#1221](https://togithub.com/TypeStrong/ts-node/issues/1221), [#1228](https://togithub.com/TypeStrong/ts-node/issues/1228), [#1244](https://togithub.com/TypeStrong/ts-node/issues/1244), [#1250](https://togithub.com/TypeStrong/ts-node/issues/1250), [#1294](https://togithub.com/TypeStrong/ts-node/issues/1294), [#1295](https://togithub.com/TypeStrong/ts-node/issues/1295), [#1296](https://togithub.com/TypeStrong/ts-node/issues/1296), [#1297](https://togithub.com/TypeStrong/ts-node/issues/1297)
- Thanks to these contributors for PRs which improved our documentation
- add troubleshooting tip for syntax errors ([#1201](https://togithub.com/TypeStrong/ts-node/issues/1201)) [@jedwards1211](https://togithub.com/jedwards1211)
- Clarify handling of tsx/jsx file extensions ([#1179](https://togithub.com/TypeStrong/ts-node/issues/1179)) [@NaridaL](https://togithub.com/NaridaL)
- Added `CONTRIBUTING.md` to document the codebase and our development workflow
https://github.com/TypeStrong/ts-node/milestone/1
Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Enabled.
♻️ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box.
This PR contains the following updates:
9.1.1->10.0.0Release Notes
TypeStrong/ts-node
### [`v10.0.0`](https://togithub.com/TypeStrong/ts-node/releases/v10.0.0) [Compare Source](https://togithub.com/TypeStrong/ts-node/compare/v9.1.1...v10.0.0) Questions about this release? Ask in the official discussion thread: [#1337](https://togithub.com/TypeStrong/ts-node/issues/1337) *Breaking changes are prefixed with **\[BREAKING]*** **Added** - Adds `--show-config` to log the resolved configuration ([docs](https://typestrong.org/ts-node/docs/troubleshooting#understanding-configuration)) ([#1100](https://togithub.com/TypeStrong/ts-node/issues/1100), [#1243](https://togithub.com/TypeStrong/ts-node/issues/1243)) - Bundle and re-export [@tsconfig/node](https://togithub.com/tsconfig/node)\* configurations for convenience ([docs](https://typestrong.org/ts-node/docs/configuration#tsconfigbases)) ([#1202](https://togithub.com/TypeStrong/ts-node/issues/1202), [#1236](https://togithub.com/TypeStrong/ts-node/issues/1236), [#1313](https://togithub.com/TypeStrong/ts-node/issues/1313)) - Default to appropriate [@tsconfig/node](https://togithub.com/tsconfig/node)\* configuration based on node and typescript versions ([docs](https://typestrong.org/ts-node/docs/configuration#default-config)) ([#1202](https://togithub.com/TypeStrong/ts-node/issues/1202), [#1236](https://togithub.com/TypeStrong/ts-node/issues/1236), [#1313](https://togithub.com/TypeStrong/ts-node/issues/1313)) - Automatically reference [@types/node](https://togithub.com/types/node); use globally-installed [@types/node](https://togithub.com/types/node) if not locally installed ([#1240](https://togithub.com/TypeStrong/ts-node/issues/1240), [#1257](https://togithub.com/TypeStrong/ts-node/issues/1257)) - Add `swc` integration and new `--transpiler` option to use third-party transpilers for a massive speed boost on large codebases ([docs](https://typestrong.org/ts-node/docs/transpilers)) ([#779](https://togithub.com/TypeStrong/ts-node/issues/779), [#1160](https://togithub.com/TypeStrong/ts-node/issues/1160)) - Add `scopeDir` API option ([docs](https://typestrong.org/ts-node/api/interfaces/RegisterOptions.html#scopeDir)) ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - Add `projectSearchDir` API option ([docs](https://typestrong.org/ts-node/api/interfaces/RegisterOptions.html#projectSearchDir)) ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - Add `--cwd-mode` and `ts-node-cwd` to resolve config file relative to cwd, not entrypoint script ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) **Changed** - **\[BREAKING]** Make `--script-mode` default behavior; resolve tsconfig relative to entrypoint script instead of cwd ([#949](https://togithub.com/TypeStrong/ts-node/issues/949), [#1197](https://togithub.com/TypeStrong/ts-node/issues/1197), [#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - In most cases this change will have no noticeable effect - Primarily benefits portable shell scripts on your `$PATH`, because `ts-node` will respect the script's local `tsconfig.json` - Use `--cwd-mode` or `ts-node-cwd` if you need legacy behavior - **\[BREAKING]** `ignore` rules evaluate relative to `tsconfig.json` directory, otherwise `cwd` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - **\[BREAKING]** Remove support for node 10. Minimum supported version is node 12 ([#1312](https://togithub.com/TypeStrong/ts-node/issues/1312)) - Rename `--dir` to `--cwd`; rename `TS_NODE_DIR` to `TS_NODE_CWD` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - `--dir` and `TS_NODE_DIR` are deprecated but still parsed for backwards-compatibility - `--dir` effectively changed the working directory of `ts-node`; renaming makes this behavior more obvious **Deprecated** - Deprecate `TS_NODE_SCOPE` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - Deprecate `--dir` and `TS_NODE_DIR` ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) **Removed** - **\[BREAKING]** Internal APIs removed from type declarations ([#1242](https://togithub.com/TypeStrong/ts-node/issues/1242)) - Removed `DEFAULTS`, `normalizeSlashes`, `parse`, `split` - No features were removed - This will only affect consumers of `ts-node`'s programmatic API **Fixed** - **\[BREAKING]** Fix [#1229](https://togithub.com/TypeStrong/ts-node/issues/1229) and [#1235](https://togithub.com/TypeStrong/ts-node/issues/1235): always throw `ERR_REQUIRE_ESM` when attempting to execute ESM as CJS, even when not using `--loader ts-node/esm` ([#1232](https://togithub.com/TypeStrong/ts-node/issues/1232)) - This aligns our behavior with vanilla `node` - **\[BREAKING]** Fix [#1225](https://togithub.com/TypeStrong/ts-node/issues/1225): `compiler` is loaded relative to `tsconfig.json` instead of entrypoint script ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - In most cases this change will have no noticable effect - Fix [#1217](https://togithub.com/TypeStrong/ts-node/issues/1217): REPL not always using passed stdout and stderr ([#1224](https://togithub.com/TypeStrong/ts-node/issues/1224)) - Fix [#1220](https://togithub.com/TypeStrong/ts-node/issues/1220): `ts-node ./index` may execute the wrong file extension because tsconfig search poisons the `require.resolve` cache ([#1155](https://togithub.com/TypeStrong/ts-node/issues/1155)) - Fix [#1322](https://togithub.com/TypeStrong/ts-node/issues/1322): Sourcemaps fail for filenames with spaces or other characters which are percent-encoded in URLs ([#1160](https://togithub.com/TypeStrong/ts-node/issues/1160), [#1330](https://togithub.com/TypeStrong/ts-node/issues/1330)) - Fix [#1331](https://togithub.com/TypeStrong/ts-node/issues/1331): Resolution of node builtin modules in ESM loader fails on node >=12.20.0, <13 ([#1332](https://togithub.com/TypeStrong/ts-node/issues/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](https://togithub.com/TypeStrong/ts-node/issues/1207), [#1213](https://togithub.com/TypeStrong/ts-node/issues/1213), [#1221](https://togithub.com/TypeStrong/ts-node/issues/1221), [#1228](https://togithub.com/TypeStrong/ts-node/issues/1228), [#1244](https://togithub.com/TypeStrong/ts-node/issues/1244), [#1250](https://togithub.com/TypeStrong/ts-node/issues/1250), [#1294](https://togithub.com/TypeStrong/ts-node/issues/1294), [#1295](https://togithub.com/TypeStrong/ts-node/issues/1295), [#1296](https://togithub.com/TypeStrong/ts-node/issues/1296), [#1297](https://togithub.com/TypeStrong/ts-node/issues/1297) - Thanks to these contributors for PRs which improved our documentation - add troubleshooting tip for syntax errors ([#1201](https://togithub.com/TypeStrong/ts-node/issues/1201)) [@jedwards1211](https://togithub.com/jedwards1211) - Clarify handling of tsx/jsx file extensions ([#1179](https://togithub.com/TypeStrong/ts-node/issues/1179)) [@NaridaL](https://togithub.com/NaridaL) - Added `CONTRIBUTING.md` to document the codebase and our development workflow https://github.com/TypeStrong/ts-node/milestone/1Configuration
📅 Schedule: At any time (no schedule defined).
🚦 Automerge: Enabled.
♻️ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by WhiteSource Renovate. View repository job log here.