From a5d98b3173307013d01647e32445d80b3dd9eb67 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=B4=E6=9D=A8=E5=B8=86?=
 <39647285+leno23@users.noreply.github.com>
Date: Sun, 17 May 2026 22:23:38 +0800
Subject: [PATCH] docs(pack): document exe peer dependencies

---
 docs/guide/pack.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/guide/pack.md b/docs/guide/pack.md
index b1714c48df..458a3cf0ad 100644
--- a/docs/guide/pack.md
+++ b/docs/guide/pack.md
@@ -59,3 +59,13 @@ export default defineConfig({
 ```
 
 See the official [tsdown executable docs](https://tsdown.dev/options/exe#executable) for details about configuring custom file names, embedded assets, and cross-platform targets.
+
+### Executable dependencies
+
+The `exe` option loads `@tsdown/exe` at build time. Install it together with a matching top-level `tsdown` package; Vite+'s bundled tsdown is not exposed as a `tsdown` package that `@tsdown/exe` can resolve.
+
+```bash
+vp install -D @tsdown/exe@0.22.0 tsdown@0.22.0
+```
+
+Use the tsdown version shown by `vp env current` when installing these dependencies for newer Vite+ releases. Installing only `@tsdown/exe` can surface as `Failed to import module "@tsdown/exe"` because the underlying peer import `tsdown/internal` is unresolved.