From a0b66b8f1daecb20acb6e16e4623daba2e3ff528 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Thu, 5 Jun 2025 11:39:18 +0800
Subject: [PATCH] docs: clarify swc-loader default options

---
 website/docs/en/config/tools/swc.mdx | 17 ++++++++++++++++-
 website/docs/zh/config/tools/swc.mdx | 17 ++++++++++++++++-
 2 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/website/docs/en/config/tools/swc.mdx b/website/docs/en/config/tools/swc.mdx
index 455d3f4a94..056cd3e5d9 100644
--- a/website/docs/en/config/tools/swc.mdx
+++ b/website/docs/en/config/tools/swc.mdx
@@ -1,6 +1,13 @@
 # tools.swc
 
-- **Type:** `Object | Function`
+- **Type:**
+
+```ts
+type ToolsSwc =
+  | Rspack.SwcLoaderOptions
+  | ((config: Rspack.SwcLoaderOptions) => Rspack.SwcLoaderOptions | undefined);
+```
+
 - **Default:**
 
 ```js
@@ -13,7 +20,15 @@ const defaultOptions = {
       decorators: true,
     },
   },
+  experimental: {
+    cacheRoot: './node_modules/.cache/.swc',
+    keepImportAttributes: true,
+  },
   isModule: 'unknown',
+  env: {
+    // Read the browserslist configuration of the project
+    targets: browserslist,
+  },
   // ...some other conditional options
 };
 ```
diff --git a/website/docs/zh/config/tools/swc.mdx b/website/docs/zh/config/tools/swc.mdx
index 1ac15388f8..34f757530d 100644
--- a/website/docs/zh/config/tools/swc.mdx
+++ b/website/docs/zh/config/tools/swc.mdx
@@ -1,6 +1,13 @@
 # tools.swc
 
-- **类型：** `Object | Function`
+- **类型：**
+
+```ts
+type ToolsSwc =
+  | Rspack.SwcLoaderOptions
+  | ((config: Rspack.SwcLoaderOptions) => Rspack.SwcLoaderOptions | undefined);
+```
+
 - **默认值：**
 
 ```js
@@ -13,7 +20,15 @@ const defaultOptions = {
       decorators: true,
     },
   },
+  experimental: {
+    cacheRoot: './node_modules/.cache/.swc',
+    keepImportAttributes: true,
+  },
   isModule: 'unknown',
+  env: {
+    // 读取项目的 browserslist 配置
+    targets: browserslist,
+  },
   // ...some other conditional options
 };
 ```