types: fix plugins type mismatch

e2e/scripts/shared.ts

@@ -6,7 +6,6 @@ import { URL } from 'node:url';
 import type {
   CreateRsbuildOptions,
   RsbuildConfig,
-  RsbuildPlugin,
   RsbuildPlugins,
 } from '@rsbuild/core';
 import { pluginSwc } from '@rsbuild/plugin-swc';
@@ -135,7 +134,7 @@ export async function dev({
   plugins,
   ...options
 }: CreateRsbuildOptions & {
-  plugins?: RsbuildPlugin[];
+  plugins?: RsbuildPlugins;
 }) {
   process.env.NODE_ENV = 'development';
 

package.json

@@ -65,7 +65,11 @@
       "vue": "2.x"
     },
     "overrides": {
-      "esbuild": "~0.19.0"
+      "esbuild": "~0.19.0",
+      "@rsbuild/core": "link:packages/core",
+      "@rsbuild/plugin-less": "link:packages/plugin-less",
+      "@rsbuild/plugin-sass": "link:packages/plugin-sass",
+      "@rsbuild/plugin-react": "link:packages/plugin-react"
     }
   }
 }

packages/compat/webpack/tests/helper.ts

@@ -1,4 +1,4 @@
-import type { CreateRsbuildOptions, RsbuildPlugin } from '@rsbuild/core';
+import type { CreateRsbuildOptions, RsbuildPlugins } from '@rsbuild/core';
 import { createStubRsbuild as createBaseRsbuild } from '@scripts/test-helper';
 import { webpackProvider } from '../src/provider';
 
@@ -7,7 +7,7 @@ export async function createStubRsbuild({
   plugins,
   ...options
 }: CreateRsbuildOptions & {
-  plugins?: RsbuildPlugin[];
+  plugins?: RsbuildPlugins;
 }) {
   rsbuildConfig.provider = webpackProvider;
   return createBaseRsbuild({

packages/core/src/types/plugin.ts

@@ -129,10 +129,18 @@ export type RsbuildPlugin = {
   remove?: string[];
 };
 
+// Support for registering lower version Rsbuild plugins in the new version of
+// Rsbuild core without throwing type mismatches. In most cases, Rsbuild core
+// only adds new methods or properties to the API object, which means that lower
+// version plugins will usually work fine.
+type LooseRsbuildPlugin = Omit<RsbuildPlugin, 'setup'> & {
+  setup: (api: any) => MaybePromise<void>;
+};
+
 export type RsbuildPlugins = (
-  | RsbuildPlugin
+  | LooseRsbuildPlugin
   | Falsy
-  | Promise<RsbuildPlugin | Falsy>
+  | Promise<LooseRsbuildPlugin | Falsy>
 )[];
 
 export type GetRsbuildConfig = {