docs: add tsconfig.json support details to TypeScript page#3026
Merged
Conversation
fibibot
requested changes
May 14, 2026
Contributor
fibibot
left a comment
There was a problem hiding this comment.
Blockers:
- CI is red because
deno fmt --checkfails on this section — lines 314–315 (- Among tsconfig references, a more specific path…) and 343–344 ([configuring TypeScript](…) reference for a full list…) need reflowing.deno fmt runtime/fundamentals/typescript.mdfixes it. - "Since Deno 2.1,
jsconfig.jsonfiles are also auto-detected when apackage.jsonis present." — I couldn't find a canonical source for the 2.1 version claim (the existingruntime/reference/ts_config_migration.mddoesn't mentionjsconfig.jsonat all). Can you link to the Deno PR or release notes that added this, or soften the version assertion?
Content otherwise mirrors runtime/reference/ts_config_migration.md lines 98–138 — same auto-detection paragraph, same supported-fields block, same precedence rules. Fine to surface this on the fundamentals page, but the two pages will need to be kept in sync going forward.
- nit: precedence list drops one rule from the reference page ("A reference takes precedence over its referrer.") — intentional simplification or oversight?
a6c1443 to
a8b0671
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
Adds a short "Configuring TypeScript with
tsconfig.json" section to the TypeScript fundamentals page, explaining that Deno auto-detectstsconfig.jsonin any workspace directory that contains adeno.jsonorpackage.json, and (since Deno 2.1) auto-detectsjsconfig.jsonwhen apackage.jsonis present. Includes a short example of an existing Node.jstsconfig.jsonbeing picked up unchanged, and links to the existingts_config_migrationreference for the full list of supported fields, precedence rules, and compiler option defaults rather than duplicating that content here.Closes #2666