From 9e86ffdd0557955748632008db1ce231c039ba99 Mon Sep 17 00:00:00 2001
From: Sultanov Mirjamol <9625526+cljamal@users.noreply.github.com>
Date: Thu, 7 Mar 2024 01:59:44 +0500
Subject: [PATCH] docs: add warning about latest `vue-tsc` (#26083)

---
 docs/2.guide/1.concepts/8.typescript.md | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/2.guide/1.concepts/8.typescript.md b/docs/2.guide/1.concepts/8.typescript.md
index e2718dc55f..afc7ae5a05 100644
--- a/docs/2.guide/1.concepts/8.typescript.md
+++ b/docs/2.guide/1.concepts/8.typescript.md
@@ -9,22 +9,26 @@ By default, Nuxt doesn't check types when you run [`nuxi dev`](/docs/api/command
 
 To enable type-checking at build or development time, install `vue-tsc` and `typescript` as development dependency:
 
+::alert{type="warning"}
+You may experience issues with the latest `vue-tsc` and `vite-plugin-checker`, used internally when type checking. For now, you may need to stay on v1 of `vue-tsc`, and follow these upstream issues for updates: [fi3ework/vite-plugin-checker#306](https://github.com/fi3ework/vite-plugin-checker/issues/306) and [vuejs/language-tools#3969](https://github.com/vuejs/language-tools/issues/3969).
+::
+
 ::code-group
 
   ```bash [yarn]
-  yarn add --dev vue-tsc typescript
+  yarn add --dev vue-tsc@^1 typescript
   ```
 
   ```bash [npm]
-  npm install --save-dev vue-tsc typescript
+  npm install --save-dev vue-tsc@^1 typescript
   ```
 
   ```bash [pnpm]
-  pnpm add -D vue-tsc typescript
+  pnpm add -D vue-tsc@^1 typescript
   ```
 
   ```bash [bun]
-  bun add -D vue-tsc typescript
+  bun add -D vue-tsc@^1 typescript
   ```
 
 ::