"Referenced projects must have the new composite setting enabled" does not hold true

🔎 Search Terms

composite, project references, solution-style tsconfig

🕗 Version & Regression Information

• This is the behavior in every version I tried, and I reviewed the FAQ for entries about tsconfig.

⏯ Playground Link

https://vite.new/react-ts

💻 Code

The above link is a project created from the vite react-ts template (https://vite.new/react-ts).
It uses project references in tsconfig.json, but no composite: true specified in both tsconfig.app.json and tsconfig.node.json.

On the other hand, the TypeScript handbook says:

Referenced projects must have the new composite setting enabled.

🙁 Actual behavior

The project builds (npm run build) successfully without composite: true.

🙂 Expected behavior

If I understand correctly, the documentation means I have to specify composite: true when using references. I'd expect an error or warning if I didn't follow the guide.

Additional information about the issue

I'm curious whether it's a bug or a feature.
If it's a bug, what's the expected behavior?
If it's a feature, I'd like to see the documentation updated accordingly.

TypeScript handbook の project references と composite のセクションから始め、次に Vite React TypeScript template で参照されている tsconfig.json、tsconfig.app.json、tsconfig.node.json を使って npm run build を実行し、動作を再現します。composite が必須かどうかを明らかにし、handbook が実装と一致するように、結果として得られる動作または想定される diagnostic を記録します。