Deprecate baseUrl compiler option in TypeScript 6.0
#62389
Draft
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR implements deprecation of the
baseUrlcompiler option, which will be removed in TypeScript 7.0. ThebaseUrloption currently performs two functions that can be confusing to users:pathsProblem
When users configure:
{ "compilerOptions": { "baseUrl": "./src", "paths": { "@app/*": ["app/*"], "@lib/*": ["lib/*"] } } }An import like
import * as blah from "blah.js"might resolve to:./src/app/blah.js./src/lib/blah.js./src/blah.jsThe last resolution path is usually unintentional and can cause confusion.
Solution
Starting in TypeScript 6.0, using
baseUrlwill show a deprecation warning:Users should migrate to explicit path mappings:
Before:
{ "compilerOptions": { "baseUrl": "./src", "paths": { "@app/*": ["app/*"], "@lib/*": ["lib/*"] } } }After:
{ "compilerOptions": { "paths": { "@app/*": ["./src/app/*"], "@lib/*": ["./src/lib/*"] } } }To preserve baseUrl fallback behavior (optional):
{ "compilerOptions": { "paths": { "*": ["./src/*"], "@app/*": ["./src/app/*"], "@lib/*": ["./src/lib/*"] } } }Implementation
src/compiler/program.tsusing existing deprecation infrastructureignoreDeprecations: "6.0"to silence warnings during transition periodignoreDeprecationsto prevent test breakageFixes #62207.
✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.