From 4202350adbd7e0519b24deabbf7c721f3cd228d9 Mon Sep 17 00:00:00 2001
From: Jun Shindo <46585162+jay-es@users.noreply.github.com>
Date: Tue, 2 Dec 2025 19:21:44 +0900
Subject: [PATCH] docs: clarify tsconfig resolution behavior

---
 guide/features.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/guide/features.md b/guide/features.md
index ad502d14..74cb5e05 100644
--- a/guide/features.md
+++ b/guide/features.md
@@ -53,6 +53,10 @@ export type { T }
 
 ### TypeScript コンパイラーオプション
 
+Vite は `tsconfig.json` のいくつかのオプションを尊重し、対応する esbuild のオプションを設定します。各ファイルに対して、Vite は最も近い親ディレクトリーにある `tsconfig.json` を使用します。その `tsconfig.json` に [`references`](https://www.typescriptlang.org/tsconfig/#references) フィールドが含まれている場合、Vite は [`include`](https://www.typescriptlang.org/tsconfig/#include) と [`exclude`](https://www.typescriptlang.org/tsconfig/#exclude) フィールドを満たす参照された設定ファイルを使用します。
+
+オプションが Vite の設定と `tsconfig.json` の両方に設定されている場合、Vite の設定の値が優先されます。
+
 `tsconfig.json` の `compilerOptions` にあるいくつかの設定フィールドには、特別な注意が必要です。
 
 #### `isolatedModules`