Skip to content

docs: add tsconfig.json support details to TypeScript page#3026

Merged
bartlomieju merged 2 commits into
mainfrom
docs/tsconfig-support-2666
May 21, 2026
Merged

docs: add tsconfig.json support details to TypeScript page#3026
bartlomieju merged 2 commits into
mainfrom
docs/tsconfig-support-2666

Conversation

@bartlomieju
Copy link
Copy Markdown
Member

@bartlomieju bartlomieju commented Apr 8, 2026

Adds a short "Configuring TypeScript with tsconfig.json" section to the TypeScript fundamentals page, explaining that Deno auto-detects tsconfig.json in any workspace directory that contains a deno.json or package.json, and (since Deno 2.1) auto-detects jsconfig.json when a package.json is present. Includes a short example of an existing Node.js tsconfig.json being picked up unchanged, and links to the existing ts_config_migration reference for the full list of supported fields, precedence rules, and compiler option defaults rather than duplicating that content here.

Closes #2666

Copy link
Copy Markdown
Contributor

@fibibot fibibot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blockers:

  1. CI is red because deno fmt --check fails 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.md fixes it.
  2. "Since Deno 2.1, jsconfig.json files are also auto-detected when a package.json is present." — I couldn't find a canonical source for the 2.1 version claim (the existing runtime/reference/ts_config_migration.md doesn't mention jsconfig.json at 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?

@bartlomieju bartlomieju force-pushed the docs/tsconfig-support-2666 branch from a6c1443 to a8b0671 Compare May 21, 2026 10:39
@bartlomieju bartlomieju merged commit f77cbff into main May 21, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Details of tsconfig support

2 participants