docs: add warning about overriding tsconfig types (#627) (#1017)

mstelbrink · web-flow · commit eecab242cc47 · 2025-11-13T17:34:02.000+01:00
Co-authored-by: Rush Ali <s0aPii.ra@googlemail.com> closes #627 #1017
diff --git a/docs/guide/features.md b/docs/guide/features.md
@@ -129,12 +129,18 @@ Alternativ können Sie `vite/client` zu `compilerOptions.types` in `tsconfig.jso
 ```json [tsconfig.json]
 {
   "compilerOptions": {
-    "types": ["vite/client"]
+    "types": ["some-other-global-lib"]
   }
 }
 ```
 
-Damit werden die folgenden Arten von Shims bereitgestellt:
+::: warning
+
+Wenn [`compilerOptions.types`](https://www.typescriptlang.org/tsconfig#types) angegeben ist, werden nur diese Pakete in den globalen Bereich aufgenommen (anstelle aller sichtbaren „@types“-Pakete).
+
+:::
+
+`vite/client` stellt die folgenden Arten von Shims bereit:
 
 - Asset-Importe (z.B. Importieren einer `.svg`-Datei)
 - Typen für die in Vite eingefügten [konstanten Variablen](./env-and-mode#env-variables) auf `import.meta.env`

Original file line number	Diff line number	Diff line change
@@ -129,12 +129,18 @@ Alternativ können Sie `vite/client` zu `compilerOptions.types` in `tsconfig.jso
`129`	`129`	```json [tsconfig.json]
`130`	`130`	`{`
`131`	`131`	`"compilerOptions": {`
`132`		`- "types": ["vite/client"]`
	`132`	`+ "types": ["some-other-global-lib"]`
`133`	`133`	`}`
`134`	`134`	`}`
`135`	`135`	```
`136`	`136`
`137`		`-Damit werden die folgenden Arten von Shims bereitgestellt:`
	`137`	`+::: warning`
	`138`	`+`
	`139`	+Wenn [`compilerOptions.types`](https://www.typescriptlang.org/tsconfig#types) angegeben ist, werden nur diese Pakete in den globalen Bereich aufgenommen (anstelle aller sichtbaren „@types“-Pakete).
	`140`	`+`
	`141`	`+:::`
	`142`	`+`
	`143`	+`vite/client` stellt die folgenden Arten von Shims bereit:
`138`	`144`
`139`	`145`	- Asset-Importe (z.B. Importieren einer `.svg`-Datei)
`140`	`146`	- Typen für die in Vite eingefügten [konstanten Variablen](./env-and-mode#env-variables) auf `import.meta.env`