diff --git a/website/docs/en/config/rsbuild/resolve.mdx b/website/docs/en/config/rsbuild/resolve.mdx
index 749fa16db..53ba48a87 100644
--- a/website/docs/en/config/rsbuild/resolve.mdx
+++ b/website/docs/en/config/rsbuild/resolve.mdx
@@ -6,7 +6,7 @@ Options for module resolution.
## resolve.aliasStrategy
-Control the priority between the `paths` option in `tsconfig.json` and the `resolve.alias` option of Rsbuild.
+Control the priority between the `resolve.alias` option and the `paths` option in `tsconfig.json`.
## resolve.alias
diff --git a/website/docs/en/config/rsbuild/source.mdx b/website/docs/en/config/rsbuild/source.mdx
index a6cf52c57..4f5b2e336 100644
--- a/website/docs/en/config/rsbuild/source.mdx
+++ b/website/docs/en/config/rsbuild/source.mdx
@@ -75,4 +75,10 @@ Transform the import path, which can be used to modularly import the subpath of
## source.tsconfigPath
-Configure a custom tsconfig.json file path to use, can be a relative or absolute path.
+Configure a custom `tsconfig.json` file path to use, can be a relative or absolute path.
+
+The `tsconfig.json` configuration file affects the following behavior of Rslib:
+
+- The `paths` field is used to configure [Path alias](/config/rsbuild/resolve#resolvealias).
+- The `experimentalDecorators` field is used to configure [Decorators version](/config/rsbuild/source#sourcedecorators).
+- Used to configure the effective scope, rules, and output directory during [TypeScript declaration file generation](/config/lib/dts).
diff --git a/website/docs/en/guide/basic/typescript.mdx b/website/docs/en/guide/basic/typescript.mdx
index d110295c2..c8e740551 100644
--- a/website/docs/en/guide/basic/typescript.mdx
+++ b/website/docs/en/guide/basic/typescript.mdx
@@ -40,6 +40,14 @@ You can create a `src/env.d.ts` file to reference it:
///
```
+## Type checking
+
+When transpiling TypeScript code using tools like SWC and Babel, type checking is not performed.
+
+Rslib provides the [lib.dts](/config/lib/dts) configuration item for generating TypeScript declaration files, and type checking is performed by default during the generation process.
+
+You can skip type checking by setting the [noCheck](https://www.typescriptlang.org/tsconfig/#noCheck) configuration item to `true` in the `tsconfig.json` file.
+
## tsconfig.json path
Rslib by default reads the `tsconfig.json` file from the root directory. You can use [source.tsconfigPath](/config/rsbuild/source#sourcetsconfigpath) to configure a custom `tsconfig.json` file path.
@@ -54,3 +62,9 @@ export default {
},
};
```
+
+## Decorators version
+
+By default, Rslib uses the [`2022-03`](https://rsbuild.rs/config/source/decorators#2022-03) version of the decorators.
+
+If [experimentalDecorators](https://www.typescriptlang.org/tsconfig/#experimentalDecorators) is enabled in `tsconfig.json`, Rslib will set [source.decorators.version](/config/rsbuild/source#sourcedecorators) to `legacy` to use the legacy decorators.
diff --git a/website/docs/en/guide/faq/features.mdx b/website/docs/en/guide/faq/features.mdx
index fc3ceb3b3..4066364c4 100644
--- a/website/docs/en/guide/faq/features.mdx
+++ b/website/docs/en/guide/faq/features.mdx
@@ -95,6 +95,73 @@ export default {
## Declaration files generation
+### How to avoid generating declaration files for certain files?
+
+As shown below, Rslib ignores the files under the `src/tests` directory when emitting JavaScript outputs, but these files still generate corresponding declaration files.
+
+```ts title="rslib.config.ts"
+export default {
+ lib: [
+ source: {
+ entry: {
+ index: ['src/**/*', '!src/tests/**/*'],
+ }
+ }
+ ],
+};
+```
+
+The entry set by [source.entry](/config/lib/bundle#bundle-false) can exclude some files that do not generate corresponding JavaScript outputs, but cannot exclude the generation of corresponding declaration files. This needs to be achieved by setting [include](https://www.typescriptlang.org/tsconfig/#include) and [exclude](https://www.typescriptlang.org/tsconfig/#exclude) in `tsconfig.json`, as shown below:
+
+```json title="tsconfig.json"
+{
+ "compilerOptions": {
+ // ...
+ },
+ "include": ["src/**/*"],
+ "exclude": ["src/tests/**/*"]
+}
+```
+
+If you want to keep type prompts and checking for these files, but do not generate corresponding declaration files, you can inherit a basic `tsconfig.json` by [extends](https://www.typescriptlang.org/tsconfig/#extends) and then override the `include` and `exclude` options as follows:
+
+```json title="tsconfig.json"
+{
+ "compilerOptions": {
+ // ...
+ },
+ "include": ["src/**/*", "rslib.config.ts"]
+}
+```
+
+```json title="tsconfig.build.json"
+{
+ "extends": "./tsconfig.json",
+ "compilerOptions": {
+ // ...
+ },
+ "include": ["src/**/*"],
+ "exclude": ["src/tests/**/*"]
+}
+```
+
+The newly added `tsconfig.build.json` needs to be configured in the [source.tsconfigPath](/config/rsbuild/source#sourcetsconfigpath) option in `rslib.config.ts`:
+
+```ts title="rslib.config.ts"
+export default {
+ lib: [
+ source: {
+ entry: {
+ index: ['src/**/*', '!src/tests/**/*'],
+ }
+ }
+ ],
+ source: {
+ tsconfigPath: 'tsconfig.build.json',
+ },
+};
+```
+
### How to additionally exclude specified dependencies when `dts.bundle` is `true`?
Rslib uses [rsbuild-plugin-dts](https://github.com/web-infra-dev/rslib/blob/main/packages/plugin-dts/README.md) to generate declaration files, which supports configuration via [output.externals](/config/rsbuild/output#outputtarget) for excluding certain dependencies from bundled declaration files.
diff --git a/website/docs/zh/config/rsbuild/resolve.mdx b/website/docs/zh/config/rsbuild/resolve.mdx
index e24f3563e..fd129c4d8 100644
--- a/website/docs/zh/config/rsbuild/resolve.mdx
+++ b/website/docs/zh/config/rsbuild/resolve.mdx
@@ -6,7 +6,7 @@ import { RsbuildDocBadge } from '@components/RsbuildDocBadge';
## resolve.aliasStrategy
-控制 `tsconfig.json` 中的 `paths` 选项与 Rsbuild 中的 `resolve.alias` 选项的优先级。
+控制 `resolve.alias` 选项与 `tsconfig.json` 中的 `paths` 选项的优先级。
## resolve.alias
diff --git a/website/docs/zh/config/rsbuild/source.mdx b/website/docs/zh/config/rsbuild/source.mdx
index 3c3e0302e..a6fb386f1 100644
--- a/website/docs/zh/config/rsbuild/source.mdx
+++ b/website/docs/zh/config/rsbuild/source.mdx
@@ -70,4 +70,10 @@ const defaultEntry = {
## source.tsconfigPath
-配置自定义的 tsconfig.json 文件路径，可以是相对路径或绝对路径。
+配置自定义的 `tsconfig.json` 文件路径，可以是相对路径或绝对路径。
+
+`tsconfig.json` 配置文件影响 Rslib 的以下行为：
+
+- `paths` 字段用于配置 [路径别名](/config/rsbuild/resolve#resolvealias)。
+- `experimentalDecorators` 字段用于配置 [装饰器语法](/config/rsbuild/source#sourcedecorators)。
+- 用于配置 [TypeScript 声明文件生成](/config/lib/dts) 时的生效范围、规则以及输出目录。
diff --git a/website/docs/zh/guide/basic/typescript.mdx b/website/docs/zh/guide/basic/typescript.mdx
index 3ecb024e3..4c1f5b8a1 100644
--- a/website/docs/zh/guide/basic/typescript.mdx
+++ b/website/docs/zh/guide/basic/typescript.mdx
@@ -40,6 +40,14 @@ export type { SomeType } from './types';
///
```
+## 类型检查
+
+在进行 TypeScript 转译时，SWC 和 Babel 等工具不会执行类型检查。
+
+Rslib 提供了 [lib.dts](/config/lib/dts) 配置项用于生成 TypeScript 声明文件，生成过程中默认会进行类型检查。
+
+你可以在 `tsconfig.json` 文件中将 [noCheck](https://www.typescriptlang.org/tsconfig/#noCheck) 配置项设置为 `true` 来跳过类型检查。
+
## tsconfig.json 路径
Rslib 默认从根目录下读取 `tsconfig.json` 文件。你可以使用 [source.tsconfigPath](/config/rsbuild/source#sourcetsconfigpath) 配置一个自定义的 `tsconfig.json` 文件路径。
@@ -54,3 +62,9 @@ export default {
},
};
```
+
+## 装饰器版本
+
+默认情况下，Rslib 会使用 [`2022-03`](https://rsbuild.rs/zh/config/source/decorators#2022-03) 版本的装饰器。
+
+如果在 `tsconfig.json` 中启用了 [experimentalDecorators](https://www.typescriptlang.org/tsconfig/#experimentalDecorators)，Rslib 会默认将 [source.decorators.version](/config/rsbuild/source#sourcedecorators) 设置为 `legacy` 来使用旧版本装饰器。
diff --git a/website/docs/zh/guide/faq/features.mdx b/website/docs/zh/guide/faq/features.mdx
index 613a27f09..38227dbab 100644
--- a/website/docs/zh/guide/faq/features.mdx
+++ b/website/docs/zh/guide/faq/features.mdx
@@ -95,6 +95,73 @@ export default {
## 类型声明文件生成
+### 如何避免生成某些文件的类型声明文件？
+
+如下所示，Rslib 在构建 JavaScript 产物时忽略了 `src/tests` 目录下的文件，但这些文件仍然会生成对应的类型声明文件。
+
+```ts title="rslib.config.ts"
+export default {
+ lib: [
+ source: {
+ entry: {
+ index: ['src/**/*', '!src/tests/**/*'],
+ }
+ }
+ ],
+};
+```
+
+[source.entry](/config/lib/bundle#bundle-false) 设置的入口可以排除一些文件不生成对应的 JavaScript 产物，但无法排除生成对应的类型声明文件，这需要通过在 `tsconfig.json` 中设置 [include](https://www.typescriptlang.org/tsconfig/#include) 和 [exclude](https://www.typescriptlang.org/tsconfig/#exclude) 来实现，如下所示：
+
+```json title="tsconfig.json"
+{
+ "compilerOptions": {
+ // ...
+ },
+ "include": ["src/**/*"],
+ "exclude": ["src/tests/**/*"]
+}
+```
+
+如果你想保留对这些文件的类型提示与检查，但不生成对应的类型声明文件，可以通过 [extends](https://www.typescriptlang.org/tsconfig/#extends) 来继承一个基础的 `tsconfig.json`，然后覆盖 `include` 和 `exclude` 选项，如下所示：
+
+```json title="tsconfig.json"
+{
+ "compilerOptions": {
+ // ...
+ },
+ "include": ["src/**/*", "rslib.config.ts"]
+}
+```
+
+```json title="tsconfig.build.json"
+{
+ "extends": "./tsconfig.json",
+ "compilerOptions": {
+ // ...
+ },
+ "include": ["src/**/*"],
+ "exclude": ["src/tests/**/*"]
+}
+```
+
+新增的 `tsconfig.build.json` 需要配置在 `rslib.config.ts` 中的 [source.tsconfigPath](/config/rsbuild/source#sourcetsconfigpath) 选项中：
+
+```ts title="rslib.config.ts"
+export default {
+ lib: [
+ source: {
+ entry: {
+ index: ['src/**/*', '!src/tests/**/*'],
+ }
+ }
+ ],
+ source: {
+ tsconfigPath: 'tsconfig.build.json',
+ },
+};
+```
+
### 如何在 `dts.bundle` 为 `true` 时额外排除指定的依赖？
Rslib 通过 [rsbuild-plugin-dts](https://github.com/web-infra-dev/rslib/blob/main/packages/plugin-dts/README.md) 完成对类型声明文件的生成，该插件支持通过 [output.externals](/config/rsbuild/output#outputtarget) 进行配置，用于从打包后的类型声明文件中排除指定的依赖。
diff --git a/website/rspress.config.ts b/website/rspress.config.ts
index d9382f64d..c7406157b 100644
--- a/website/rspress.config.ts
+++ b/website/rspress.config.ts
@@ -138,7 +138,7 @@ export default defineConfig({
dev: {
lazyCompilation: true,
},
- source: {
+ resolve: {
alias: {
'@components': path.join(__dirname, '@components'),
'@en': path.join(__dirname, 'docs/en'),