chore: update

Author: Timeless0911

packages/core/src/config.ts

@@ -1500,7 +1500,7 @@ const composeDtsConfig = async (
         banner: banner?.dts,
         footer: footer?.dts,
         redirect: redirect?.dts,
-        experiments: dts?.experiments,
+        tsgo: dts?.tsgo,
       }),
     ],
   };

packages/core/src/types/config.ts

@@ -95,18 +95,11 @@ export type Dts =
        */
       alias?: Record<string, string>;
       /**
-       * [Experimental] Whether to enable experimental features.
-       * @defaultValue `{}`
-       * @see {@link https://rslib.rs/config/lib/dts#dtsexperiments}
+       * [Experimental] Whether to generate declaration files with `tsgo`.
+       * @defaultValue `false`
+       * @see {@link https://rslib.rs/config/lib/dts#dtstsgo}
        */
-      experiments?: {
-        /**
-         * [Experimental] Whether to generate declaration files with `tsgo`.
-         * @defaultValue `false`
-         * @see {@link https://rslib.rs/config/lib/dts#dtsexperimentstsgo}
-         */
-        tsgo?: boolean;
-      };
+      tsgo?: boolean;
     }
   | boolean;
 

packages/plugin-dts/README.md

@@ -136,7 +136,7 @@ pluginDts({
 });
 ```
 
-> When [experiments.tsgo](#experimentstsgo) is enabled, if the project also enables [build](#build) or emits declaration files with different extensions to the same directory, `dtsExtension` may not work correctly.
+> When [tsgo](#tsgo) is enabled, if the project also enables [build](#build) or emits declaration files with different extensions to the same directory, `dtsExtension` may not work correctly.
 
 ### alias
 
@@ -282,19 +282,14 @@ import { foo } from './foo.mjs'; // expected output of './dist/bar.d.mts'
 
 - When set to `false`, the file extension will remain unchanged from the original import path in the rewritten import path of the output file (regardless of whether it is specified or specified as any value).
 
-### experiments
-
-- **Type:** `{ tsgo?: boolean }`
-- **Default:** `{}`
-
-Whether to enable experimental features.
-
-#### experiments.tsgo
+### tsgo
 
 - **Type:** `boolean`
 - **Default:** `false`
 
-Whether to generate declaration files with [tsgo](https://github.com/microsoft/typescript-go).
+Whether to generate declaration files with [tsgo](https://github.com/microsoft/typescript-go), which can provide faster generation of declaration files, especially for large projects.
+
+> This feature is currently an **experimental feature**. Since tsgo is still in the **experimental stage**, there may be some bugs and unresolved issues or limitations. So, make sure to fully test it in your project before enabling this option.
 
 To enable this option, you need to:
 
@@ -306,17 +301,21 @@ npm add @typescript/native-preview -D
 
 > `@typescript/native-preview` requires Node.js 20.6.0 or higher.
 
-2. Set `experiments.tsgo` to `true`.
+2. Set `tsgo` to `true`.
 
 ```js
 pluginDts({
-  experiments: {
-    tsgo: true,
-  },
+  tsgo: true,
 });
 ```
 
-> `tsgo` can provide faster generation of declaration files, especially for large projects. However, since `tsgo` is still experimental, there may be unresolved issues or limitations. Therefore, please make sure to thoroughly test it in your project before enabling this option.
+3. In order to ensure the consistency of local development, you need to install the corresponding [VS Code Preview Extension](https://marketplace.visualstudio.com/items?itemName=TypeScriptTeam.native-preview) and add the following configuration in the VS Code settings:
+
+```json
+{
+  "typescript.experimental.useTsgo": true
+}
+```
 
 ## Contributing
 

packages/plugin-dts/src/dts.ts

@@ -135,11 +135,8 @@ export async function generateDts(data: DtsGenOptions): Promise<void> {
       path: true,
       extension: false,
     },
-    experiments = {
-      tsgo: false,
-    },
+    tsgo,
   } = data;
-  const { tsgo } = experiments;
   if (!isWatch) {
     logger.start(`generating declaration files... ${color.dim(`(${name})`)}`);
   }

packages/plugin-dts/src/index.ts

@@ -44,9 +44,7 @@ export type PluginDtsOptions = {
   banner?: string;
   footer?: string;
   redirect?: DtsRedirect;
-  experiments?: {
-    tsgo?: boolean;
-  };
+  tsgo?: boolean;
 };
 
 export type DtsEntry = {
@@ -96,16 +94,15 @@ export const pluginDts = (options: PluginDtsOptions = {}): RsbuildPlugin => ({
     options.redirect.path = options.redirect.path ?? true;
     options.redirect.extension = options.redirect.extension ?? false;
     options.alias = options.alias ?? {};
-    options.experiments = options.experiments ?? {};
-    options.experiments.tsgo = options.experiments.tsgo ?? false;
+    options.tsgo = options.tsgo ?? false;
 
     const dtsPromises: Promise<TaskResult>[] = [];
     let promisesResult: TaskResult[] = [];
     let childProcesses: ChildProcess[] = [];
 
     api.onBeforeEnvironmentCompile(
       async ({ isWatch, isFirstCompile, environment }) => {
-        if (!isFirstCompile && !options.experiments?.tsgo) {
+        if (!isFirstCompile && !options.tsgo) {
           return;
         }
 

tests/integration/banner-footer/rslib.config.ts

@@ -98,9 +98,7 @@ export default defineConfig({
       },
       dts: {
         bundle: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       ...bannerFooterConfig,
     }),
@@ -113,9 +111,7 @@ export default defineConfig({
       },
       dts: {
         bundle: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       ...bannerFooterConfig,
     }),
@@ -129,9 +125,7 @@ export default defineConfig({
       bundle: false,
       dts: {
         bundle: false,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       source: {
         entry: {
@@ -150,9 +144,7 @@ export default defineConfig({
       bundle: false,
       dts: {
         bundle: false,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       source: {
         entry: {
@@ -171,9 +163,7 @@ export default defineConfig({
       },
       dts: {
         bundle: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       ...bannerFooterConfig,
     }),

tests/integration/dts-tsgo/build/abort-on-error/rslib.config.ts

@@ -9,9 +9,7 @@ export default defineConfig({
         bundle: false,
         build: true,
         abortOnError: false,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
     }),
   ],

tests/integration/dts-tsgo/build/auto-extension/rslib.config.ts

@@ -10,9 +10,7 @@ export default defineConfig({
         distPath: './dist/types',
         bundle: false,
         build: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
     }),
   ],

tests/integration/dts-tsgo/build/basic/rslib.config.ts

@@ -8,9 +8,7 @@ export default defineConfig({
       dts: {
         bundle: false,
         build: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
     }),
   ],

tests/integration/dts-tsgo/build/clean/rslib.config.ts

@@ -9,9 +9,7 @@ export default defineConfig({
         distPath: './dist-types/esm',
         bundle: false,
         build: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       source: {
         tsconfigPath: './tsconfig.esm.json',
@@ -23,9 +21,7 @@ export default defineConfig({
         distPath: './dist-types/cjs',
         bundle: false,
         build: true,
-        experiments: {
-          tsgo: true,
-        },
+        tsgo: true,
       },
       source: {
         tsconfigPath: './tsconfig.cjs.json',