chore: update

Author: Timeless0911

packages/plugin-dts/README.md

@@ -2,18 +2,169 @@
   <img alt="Rslib Banner" src="https://assets.rspack.dev/rslib/rslib-banner.png">
 </picture>
 
-# Rslib
+# rsbuild-plugin-dts
 
-Rslib is a library development tool powered by [Rsbuild](https://rsbuild.dev). It allows library developers to leverage the knowledge and ecosystem of webpack and Rspack.
+An Rsbuild plugin to emit declaration files for TypeScript which is built-in in Rslib.
 
-## Documentation
+## Using in Rslib
 
-https://lib.rsbuild.dev/
+Read [DTS](https://lib.rsbuild.dev/guide/advanced/dts#dts) and [lib.dts](https://lib.rsbuild.dev/config/lib/dts) for more details.
+
+## Using in Rsbuild
+
+Install:
+
+```bash
+npm add rsbuild-plugin-dts -D
+```
+
+Add plugin to your `rsbuild.config.ts`:
+
+```ts
+// rsbuild.config.ts
+import { pluginDts } from 'rsbuild-plugin-dts';
+
+export default {
+  plugins: [pluginDts()],
+};
+```
+
+## Options
+
+### bundle
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+Whether to bundle the DTS files.
+
+If you want to generate [bundle DTS](https://lib.rsbuild.dev/guide/advanced/dts#bundle-dts) files, you should:
+
+- Install `@microsoft/api-extractor` as a development dependency.
+
+```bash
+npm add @microsoft/api-extractor -D
+```
+
+- Set `bundle` to `true`.
+
+```js
+pluginDts({
+  bundle: true,
+});
+```
+
+### distPath
+
+- **Type:** `string`
+
+The output directory of DTS files. The default value follows the priority below:
+
+1. The `distPath` value of the plugin options.
+2. The `declarationDir` value in the `tsconfig.json` file.
+3. The [output.distPath.root](https://rsbuild.dev/config/output/dist-path) value of Rsbuild configuration.
+
+```js
+pluginDts({
+  distPath: './dist-types',
+});
+```
+
+### build
+
+- **Type:** `boolean`
+- **Default:** `false`
+
+Determines whether to generate DTS files while building the project's references. This is equivalent to using the `--build` flag with the `tsc` command.
+
+When this option is enabled, you must explicitly set `declarationDir` or `outDir` in `tsconfig.json` in order to meet the build requirements.
+
+### abortOnError
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+Whether to abort the build process when an error occurs during DTS generation.
+
+By default, type errors will cause the build to fail. When `abortOnError` is set to `false`, the build will still succeed even if there are type issues in the code.
+
+```js
+pluginDts({
+  abortOnError: false,
+});
+```
+
+### dtsExtension
+
+- **Type:** `string`
+- **Default:** `'.d.ts'`
+
+The extension of the DTS file.
+
+```js
+pluginDts({
+  dtsExtension: '.d.mts',
+});
+```
+
+### autoExternal
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+Whether to automatically externalize dependencies of different dependency types and do not bundle them into the DTS file.
+
+The default value of `autoExternal` is `true`, which means the following dependency types will not be bundled:
+
+- `dependencies`
+- `optionalDependencies`
+- `peerDependencies`
+
+And the following dependency types will be bundled:
+
+- `devDependencies`
+
+```js
+pluginDts({
+  autoExternal: {
+    dependencies: true,
+    optionalDependencies: true,
+    peerDependencies: true,
+    devDependencies: false,
+  },
+});
+```
+
+### banner
+
+- **Type:** `string`
+- **Default:** `undefined`
+
+Inject content into the top of each DTS file.
+
+```js
+pluginDts({
+  banner: '/** @banner */',
+});
+```
+
+### footer
+
+- **Type:** `string`
+- **Default:** `undefined`
+
+```js
+pluginDts({
+  footer: '/** @footer */',
+});
+```
+
+Inject content into the bottom of each DTS file.
 
 ## Contributing
 
 Please read the [Contributing Guide](https://github.com/web-infra-dev/rslib/blob/main/CONTRIBUTING.md).
 
 ## License
 
-Rslib is [MIT licensed](https://github.com/web-infra-dev/rslib/blob/main/LICENSE).
+[MIT licensed](https://github.com/web-infra-dev/rslib/blob/main/LICENSE).

packages/plugin-dts/src/index.ts

@@ -50,7 +50,7 @@ export const PLUGIN_DTS_NAME = 'rsbuild:dts';
 // use ts compiler API to generate bundleless dts
 // use ts compiler API and api-extractor to generate dts bundle
 // TODO: deal alias in dts
-export const pluginDts = (options: PluginDtsOptions): RsbuildPlugin => ({
+export const pluginDts = (options: PluginDtsOptions = {}): RsbuildPlugin => ({
   name: PLUGIN_DTS_NAME,
 
   setup(api) {

website/docs/en/config/lib/dts.mdx

@@ -141,7 +141,7 @@ When this option is enabled, you must explicitly set `declarationDir` or `outDir
 
 Whether to abort the build process when an error occurs during DTS generation.
 
-By default, type errors will cause the build to fail. When `abortOnError` is set to `false`, the build will still succeed even if there are type issues in the code:
+By default, type errors will cause the build to fail. When `abortOnError` is set to `false`, the build will still succeed even if there are type issues in the code.
 
 ```ts title="rslib.config.ts" {5-7}
 export default {