feat: deprecate Node.js versions below 22.18.0

sxzz · sxzz · commit 439f1e025f71 · 2026-03-04T01:46:20.000+09:00
Add a runtime warning when running on Node.js &lt; 22.18.0, indicating
support will be removed in the next minor release. Update docs (EN/ZH)
with deprecation notice.
diff --git a/docs/guide/getting-started.md b/docs/guide/getting-started.md
@@ -62,6 +62,10 @@ bun add -D typescript
 `tsdown` requires Node.js version 20.19 or higher. Please ensure your development environment meets this requirement before installing. While `tsdown` is primarily tested with Node.js, support for Deno and Bun is experimental and may not work as expected.
 :::
 
+:::warning Node.js Deprecation
+Node.js versions below 22.18.0 are deprecated and support will be removed in the next minor release. Please upgrade to Node.js 22.18.0 or later.
+:::
+
 ### Starter Templates {#starter-templates}
 
 To get started even faster, you can use the [create-tsdown](https://github.com/rolldown/tsdown/tree/main/packages/create-tsdown) CLI, which provides a set of starter templates for building pure TypeScript libraries, as well as frontend libraries like React and Vue.
diff --git a/docs/zh-CN/guide/getting-started.md b/docs/zh-CN/guide/getting-started.md
@@ -62,6 +62,10 @@ bun add -D typescript
 `tsdown` 需要 Node.js 20.19 或更高版本。请确保您的开发环境满足此要求后再进行安装。虽然 `tsdown` 主要在 Node.js 下测试，但对 Deno 和 Bun 的支持仍为实验性，可能无法正常工作。
 :::
 
+:::warning Node.js 弃用警告
+低于 22.18.0 的 Node.js 版本已被弃用，将在下一个 minor 版本中移除支持。请升级到 Node.js 22.18.0 或更高版本。
+:::
+
 ### 起步模板 {#starter-templates}
 
 为了更快速地开始，您可以使用 [create-tsdown](https://github.com/rolldown/tsdown/tree/main/packages/create-tsdown) CLI，它提供了一系列起步模板，适用于构建纯 TypeScript 库以及如 React、Vue 等前端库。
diff --git a/src/run.ts b/src/run.ts
@@ -1,7 +1,16 @@
 #!/usr/bin/env node
 import module from 'node:module'
+import process from 'node:process'
+import { yellow } from 'ansis'
+import lt from 'semver/functions/lt.js'
 import { runCLI } from './cli.ts'
 
+if (lt(process.version, '22.18.0')) {
+  console.warn(
+    yellow`[tsdown] Node.js ${process.version} is deprecated. Support will be removed in the next minor release. Please upgrade to Node.js 22.18.0 or later.`,
+  )
+}
+
 try {
   module.enableCompileCache?.()
 } catch {}
