@rsbuild/core 1.4.7 → 1.4.8

package/dist/index.cjs

@@ -1607,47 +1607,6 @@ ${section.body}` : section.body).join("\n\n"));
             }), actionArgs.push(options), command.commandAction.apply(this, actionArgs);
         }
     }
-    let RSBUILD_ALL_ENVIRONMENT_SYMBOL = 'RSBUILD_ALL_ENVIRONMENT_SYMBOL', isPluginMatchEnvironment = (pluginEnvironment, currentEnvironment)=>pluginEnvironment === currentEnvironment || pluginEnvironment === RSBUILD_ALL_ENVIRONMENT_SYMBOL;
-    async function initPlugins({ getPluginAPI, pluginManager }) {
-        index_js_namespaceObject.logger.debug('init plugins');
-        let plugins = ((plugins)=>{
-            let allLines = [];
-            function getPlugin(name) {
-                let targets = plugins.filter((item)=>item.instance.name === name);
-                if (!targets.length) throw Error(`${picocolors_index_js_default().dim('[rsbuild:plugin]')} Plugin "${picocolors_index_js_default().yellow(name)}" not existed`);
-                return targets;
-            }
-            for (let plugin of plugins){
-                if (plugin.instance.pre) for (let pre of plugin.instance.pre)pre && plugins.some((item)=>item.instance.name === pre) && allLines.push([
-                    pre,
-                    plugin.instance.name
-                ]);
-                if (plugin.instance.post) for (let post of plugin.instance.post)post && plugins.some((item)=>item.instance.name === post) && allLines.push([
-                    plugin.instance.name,
-                    post
-                ]);
-            }
-            let zeroEndPoints = plugins.filter((item)=>!allLines.find((l)=>l[1] === item.instance.name)), sortedPoint = [];
-            for(; zeroEndPoints.length;){
-                let zep = zeroEndPoints.shift();
-                sortedPoint.push(...getPlugin(zep.instance.name)), allLines = allLines.filter((l)=>l[0] !== getPlugin(zep.instance.name)[0].instance.name), zeroEndPoints = plugins.filter((item)=>!sortedPoint.find((sp)=>sp.instance.name === item.instance.name)).filter((item)=>!allLines.find((l)=>l[1] === item.instance.name));
-            }
-            if (allLines.length) {
-                let restInRingPoints = {};
-                for (let l of allLines)restInRingPoints[l[0]] = !0, restInRingPoints[l[1]] = !0;
-                throw Error(`${picocolors_index_js_default().dim('[rsbuild:plugin]')} Plugins dependencies has loop: ${picocolors_index_js_default().yellow(Object.keys(restInRingPoints).join(','))}`);
-            }
-            return sortedPoint;
-        })(pluginManager.getAllPluginsWithMeta()), removedPlugins = plugins.reduce((ret, plugin)=>(plugin.instance.remove && (ret[plugin.environment] ??= [], ret[plugin.environment].push(...plugin.instance.remove)), ret), {});
-        for (let plugin of plugins){
-            var _removedPlugins_plugin_environment, _removedPlugins_RSBUILD_ALL_ENVIRONMENT_SYMBOL;
-            let isGlobalPlugin = 'RSBUILD_ALL_ENVIRONMENT_SYMBOL' === plugin.environment;
-            if ((null == (_removedPlugins_plugin_environment = removedPlugins[plugin.environment]) ? void 0 : _removedPlugins_plugin_environment.includes(plugin.instance.name)) || !isGlobalPlugin && (null == (_removedPlugins_RSBUILD_ALL_ENVIRONMENT_SYMBOL = removedPlugins[RSBUILD_ALL_ENVIRONMENT_SYMBOL]) ? void 0 : _removedPlugins_RSBUILD_ALL_ENVIRONMENT_SYMBOL.includes(plugin.instance.name))) continue;
-            let { instance, environment } = plugin;
-            await instance.setup(getPluginAPI(environment));
-        }
-        index_js_namespaceObject.logger.debug('init plugins done');
-    }
     function createEnvironmentAsyncHook() {
         let preGroup = [], postGroup = [], defaultGroup = [], tapEnvironment = ({ environment, handler: cb })=>{
             isFunction(cb) ? defaultGroup.push({
@@ -1675,7 +1634,7 @@ ${section.body}` : section.body).join("\n\n"));
                     ...defaultGroup,
                     ...postGroup
                 ]){
-                    if (callback.environment && environment && !isPluginMatchEnvironment(callback.environment, environment)) continue;
+                    if (environment && callback.environment && callback.environment !== environment) continue;
                     let result = await callback.handler(...params);
                     void 0 !== result && (params[0] = result);
                 }
@@ -1688,7 +1647,7 @@ ${section.body}` : section.body).join("\n\n"));
                     ...defaultGroup,
                     ...postGroup
                 ]){
-                    if (callback.environment && environment && !isPluginMatchEnvironment(callback.environment, environment)) continue;
+                    if (environment && callback.environment && callback.environment !== environment) continue;
                     let result = await callback.handler(...params);
                     results.push(result);
                 }
@@ -2131,6 +2090,57 @@ ${section.body}` : section.body).join("\n\n"));
             }
         }
     }
+    let isEnvironmentMatch = (pluginEnvironment, specifiedEnvironment)=>pluginEnvironment === specifiedEnvironment || void 0 === pluginEnvironment;
+    async function initPlugins({ context, pluginManager }) {
+        index_js_namespaceObject.logger.debug('init plugins');
+        let plugins = ((plugins)=>{
+            let allLines = [];
+            function getPlugin(name) {
+                let targets = plugins.filter((item)=>item.instance.name === name);
+                if (!targets.length) throw Error(`${picocolors_index_js_default().dim('[rsbuild:plugin]')} Plugin "${picocolors_index_js_default().yellow(name)}" not existed`);
+                return targets;
+            }
+            for (let plugin of plugins){
+                if (plugin.instance.pre) for (let pre of plugin.instance.pre)pre && plugins.some((item)=>item.instance.name === pre) && allLines.push([
+                    pre,
+                    plugin.instance.name
+                ]);
+                if (plugin.instance.post) for (let post of plugin.instance.post)post && plugins.some((item)=>item.instance.name === post) && allLines.push([
+                    plugin.instance.name,
+                    post
+                ]);
+            }
+            let zeroEndPoints = plugins.filter((item)=>!allLines.find((l)=>l[1] === item.instance.name)), sortedPoint = [];
+            for(; zeroEndPoints.length;){
+                let zep = zeroEndPoints.shift();
+                sortedPoint.push(...getPlugin(zep.instance.name)), allLines = allLines.filter((l)=>l[0] !== getPlugin(zep.instance.name)[0].instance.name), zeroEndPoints = plugins.filter((item)=>!sortedPoint.find((sp)=>sp.instance.name === item.instance.name)).filter((item)=>!allLines.find((l)=>l[1] === item.instance.name));
+            }
+            if (allLines.length) {
+                let restInRingPoints = {};
+                for (let l of allLines)restInRingPoints[l[0]] = !0, restInRingPoints[l[1]] = !0;
+                throw Error(`${picocolors_index_js_default().dim('[rsbuild:plugin]')} Plugins dependencies has loop: ${picocolors_index_js_default().yellow(Object.keys(restInRingPoints).join(','))}`);
+            }
+            return sortedPoint;
+        })(pluginManager.getAllPluginsWithMeta()), removedPlugins = new Set(), removedEnvPlugins = {};
+        for (let { environment, instance } of plugins)if (instance.remove) if (environment) for (let item of (removedEnvPlugins[environment] ??= new Set(), instance.remove))removedEnvPlugins[environment].add(item);
+        else for (let item of instance.remove)removedPlugins.add(item);
+        for (let { instance, environment } of plugins){
+            var _removedEnvPlugins_environment;
+            let { name, setup } = instance;
+            if (!(removedPlugins.has(name) || environment && (null == (_removedEnvPlugins_environment = removedEnvPlugins[environment]) ? void 0 : _removedEnvPlugins_environment.has(name)))) {
+                if (instance.apply && context.action) {
+                    let expected = {
+                        build: 'build',
+                        dev: 'serve',
+                        preview: 'serve'
+                    }[context.action];
+                    if (expected && instance.apply !== expected) continue;
+                }
+                await setup(context.getPluginAPI(environment));
+            }
+        }
+        index_js_namespaceObject.logger.debug('init plugins done');
+    }
     let mapProcessAssetsStage = (compiler, stage)=>{
         let { Compilation } = compiler.webpack;
         switch(stage){
@@ -2250,7 +2260,7 @@ ${section.body}` : section.body).join("\n\n"));
     async function createContext(options, userConfig) {
         let { cwd } = options, rootPath = userConfig.root ? ensureAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = (0, external_node_path_namespaceObject.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0, bundlerType = userConfig.provider ? 'webpack' : 'rspack';
         return {
-            version: "1.4.7",
+            version: "1.4.8",
             rootPath,
             distPath: '',
             cachePath,
@@ -2640,7 +2650,7 @@ ${section.body}` : section.body).join("\n\n"));
     async function initRsbuildConfig({ context, pluginManager }) {
         if (context.normalizedConfig) return context.normalizedConfig;
         await initPlugins({
-            getPluginAPI: context.getPluginAPI,
+            context,
             pluginManager
         }), await modifyRsbuildConfig(context);
         let normalizedBaseConfig = ((config)=>{
@@ -3809,13 +3819,13 @@ ${section.body}` : section.body).join("\n\n"));
             if (routes.length <= 1) {
                 let pathname = routes.length ? routes[0].pathname : '';
                 return urls.map(({ label, url })=>{
-                    let normalizedPathname = normalizeUrl(`${url}${pathname}`), prefix = `\u{279C} ${picocolors_index_js_default().dim(label.padEnd(10))}`;
+                    let normalizedPathname = normalizeUrl(`${url}${pathname}`), prefix = `\u{279C}  ${picocolors_index_js_default().dim(label.padEnd(10))}`;
                     return `  ${prefix}${picocolors_index_js_default().cyan(normalizedPathname)}\n`;
                 }).join('');
             }
             let message = '', maxNameLength = Math.max(...routes.map((r)=>r.entryName.length));
             return urls.forEach(({ label, url }, index)=>{
-                for (let r of (index > 0 && (message += '\n'), message += `  ${`\u{279C} ${label}`}\n`, routes))message += `  ${picocolors_index_js_default().dim('-')} ${picocolors_index_js_default().dim(r.entryName.padEnd(maxNameLength + 4))}${picocolors_index_js_default().cyan(normalizeUrl(`${url}${r.pathname}`))}\n`;
+                for (let r of (index > 0 && (message += '\n'), message += `  ${`\u{279C}  ${label}`}\n`, routes))message += `  ${picocolors_index_js_default().dim('-')} ${picocolors_index_js_default().dim(r.entryName.padEnd(maxNameLength + 4))}${picocolors_index_js_default().cyan(normalizeUrl(`${url}${r.pathname}`))}\n`;
             }), message;
         }(urls, routes);
         return !1 === trailingLineBreak && message.endsWith('\n') && (message = message.slice(0, -1)), index_js_namespaceObject.logger.log(message), message;
@@ -4334,7 +4344,7 @@ ${section.body}` : section.body).join("\n\n"));
             }
         ].filter(Boolean);
         if (customShortcuts && !Array.isArray(shortcuts = customShortcuts(shortcuts))) throw Error(`${picocolors_index_js_default().dim('[rsbuild:config]')} ${picocolors_index_js_default().yellow('dev.cliShortcuts')} option must return an array of shortcuts.`);
-        help && index_js_namespaceObject.logger.log(!0 === help ? `  \u{279C} ${picocolors_index_js_default().dim('press')} ${picocolors_index_js_default().bold('h + enter')} ${picocolors_index_js_default().dim('to show shortcuts')}\n` : `  \u{279C} ${help}\n`);
+        help && index_js_namespaceObject.logger.log(!0 === help ? `  \u{279C}  ${picocolors_index_js_default().dim('press')} ${picocolors_index_js_default().bold('h + enter')} ${picocolors_index_js_default().dim('to show shortcuts')}\n` : `  \u{279C}  ${help}\n`);
         let { createInterface } = await Promise.resolve().then(__webpack_require__.bind(__webpack_require__, "node:readline")), rl = createInterface({
             input: process.stdin
         });
@@ -5492,15 +5502,22 @@ ${section.body}` : section.body).join("\n\n"));
             port: port1,
             https
         };
-        let waitFirstCompileDone = runCompile ? new Promise((resolve)=>{
-            context.hooks.onDevCompileDone.tap(({ stats, isFirstCompile })=>{
-                lastStats = 'stats' in stats ? stats.stats : [
-                    stats
-                ], isFirstCompile && resolve();
-            });
-        }) : Promise.resolve(), startCompile = async ()=>{
+        let waitLastCompileDoneResolve = null, waitLastCompileDone = new Promise((resolve)=>{
+            waitLastCompileDoneResolve = resolve;
+        });
+        context.hooks.onDevCompileDone.tap(({ stats })=>{
+            lastStats = 'stats' in stats ? stats.stats : [
+                stats
+            ], waitLastCompileDoneResolve && (waitLastCompileDoneResolve(), waitLastCompileDoneResolve = null);
+        });
+        let startCompile = async ()=>{
             let compiler = customCompiler || await createCompiler();
             if (!compiler) throw Error(`${picocolors_index_js_default().dim('[rsbuild:server]')} Failed to get compiler instance.`);
+            null == compiler || compiler.hooks.watchRun.tap('rsbuild:watchRun', ()=>{
+                lastStats && (waitLastCompileDoneResolve && (waitLastCompileDoneResolve(), waitLastCompileDoneResolve = null), waitLastCompileDone = new Promise((resolve)=>{
+                    waitLastCompileDoneResolve = resolve;
+                }));
+            });
             let publicPaths = helpers_isMultiCompiler(compiler) ? compiler.compilers.map(getPublicPathFromCompiler) : [
                 getPublicPathFromCompiler(compiler)
             ], compilationManager = new CompilationManager({
@@ -5558,19 +5575,19 @@ ${section.body}` : section.body).join("\n\n"));
                 {
                     getStats: async ()=>{
                         if (!compilationManager) throw Error(`${picocolors_index_js_default().dim('[rsbuild:server]')} Can not call ${picocolors_index_js_default().yellow('getStats')} when ${picocolors_index_js_default().yellow('runCompile')} is false`);
-                        return await waitFirstCompileDone, lastStats[environment.index];
+                        return await waitLastCompileDone, lastStats[environment.index];
                     },
                     context: environment,
                     loadBundle: async (entryName)=>{
                         if (!compilationManager) throw Error(`${picocolors_index_js_default().dim('[rsbuild:server]')} Can not call ${picocolors_index_js_default().yellow('loadBundle')} when ${picocolors_index_js_default().yellow('runCompile')} is false`);
-                        return await waitFirstCompileDone, cacheableLoadBundle(lastStats[environment.index], entryName, {
+                        return await waitLastCompileDone, cacheableLoadBundle(lastStats[environment.index], entryName, {
                             readFileSync: compilationManager.readFileSync,
                             environment
                         });
                     },
                     getTransformedHtml: async (entryName)=>{
                         if (!compilationManager) throw Error(`${picocolors_index_js_default().dim('[rsbuild:server]')} Can not call ${picocolors_index_js_default().yellow('getTransformedHtml')} when ${picocolors_index_js_default().yellow('runCompile')} is false`);
-                        return await waitFirstCompileDone, cacheableTransformedHtml(lastStats[environment.index], entryName, {
+                        return await waitLastCompileDone, cacheableTransformedHtml(lastStats[environment.index], entryName, {
                             readFileSync: compilationManager.readFileSync,
                             environment
                         });
@@ -7239,10 +7256,11 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             },
             {
                 name: 'rsbuild:lazy-compilation',
+                apply: 'serve',
                 setup (api) {
-                    api.modifyBundlerChain((chain, { environment, isProd, target })=>{
+                    api.modifyBundlerChain((chain, { environment, target })=>{
                         var _config_dev;
-                        if (isProd || 'web' !== target) return;
+                        if ('web' !== target) return;
                         let { config } = environment, options = null == (_config_dev = config.dev) ? void 0 : _config_dev.lazyCompilation;
                         if (options) {
                             if (!0 === options && Object.keys(chain.entryPoints.entries() || {}).length <= 1) return void chain.experiments({
@@ -7359,12 +7377,10 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             ...options,
             rsbuildConfig: config
         }, pluginManager = (plugins = [], {
-            getPlugins: (options = {
-                environment: RSBUILD_ALL_ENVIRONMENT_SYMBOL
-            })=>plugins.filter((p)=>isPluginMatchEnvironment(p.environment, options.environment)).map((p)=>p.instance),
+            getPlugins: (options = {})=>plugins.filter((plugin)=>isEnvironmentMatch(plugin.environment, options.environment)).map(({ instance })=>instance),
             getAllPluginsWithMeta: ()=>plugins,
             addPlugins: (newPlugins, options)=>{
-                let { before, environment = RSBUILD_ALL_ENVIRONMENT_SYMBOL } = options || {};
+                let { before, environment } = options || {};
                 for (let newPlugin of newPlugins)if (newPlugin) {
                     var plugin = newPlugin;
                     let type = typeof plugin;
@@ -7406,9 +7422,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             removePlugins: (pluginNames, options = {})=>{
                 plugins = plugins.filter((plugin)=>!(pluginNames.includes(plugin.instance.name) && (!options.environment || plugin.environment === options.environment)));
             },
-            isPluginExists: (pluginName, options = {
-                environment: RSBUILD_ALL_ENVIRONMENT_SYMBOL
-            })=>!!plugins.find((plugin)=>plugin.instance.name === pluginName && isPluginMatchEnvironment(plugin.environment, options.environment))
+            isPluginExists: (pluginName, options = {})=>plugins.some((plugin)=>plugin.instance.name === pluginName && isEnvironmentMatch(plugin.environment, options.environment))
         }), context = await createContext(resolvedOptions, config), getPluginAPI = function({ context, pluginManager }) {
             let { hooks } = context, publicContext = function(context) {
                 let exposedKeys = [
@@ -7462,7 +7476,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                 let pluginName = 'RsbuildCorePlugin';
                 chain.plugin(pluginName).use(class {
                     apply(compiler) {
-                        for (let { handler, environment: pluginEnvironment } of (compiler.__rsbuildTransformer = transformer, resolveFns))(!pluginEnvironment || isPluginMatchEnvironment(pluginEnvironment, environment.name)) && compiler.hooks.compilation.tap(pluginName, (compilation, { normalModuleFactory })=>{
+                        for (let { handler, environment: pluginEnvironment } of (compiler.__rsbuildTransformer = transformer, resolveFns))(!pluginEnvironment || isEnvironmentMatch(pluginEnvironment, environment.name)) && compiler.hooks.compilation.tap(pluginName, (compilation, { normalModuleFactory })=>{
                             normalModuleFactory.hooks.resolve.tapPromise(pluginName, async (resolveData)=>handler({
                                     compiler,
                                     compilation,
@@ -7475,7 +7489,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                                 childCompiler.__rsbuildTransformer = transformer;
                             });
                             let { sources } = compiler.webpack;
-                            for (let { descriptor, handler, environment: pluginEnvironment } of processAssetsFns)(!descriptor.targets || descriptor.targets.includes(target)) && (!descriptor.environments || descriptor.environments.includes(environment.name)) && (!pluginEnvironment || isPluginMatchEnvironment(pluginEnvironment, environment.name)) && compilation.hooks.processAssets.tapPromise({
+                            for (let { descriptor, handler, environment: pluginEnvironment } of processAssetsFns)(!descriptor.targets || descriptor.targets.includes(target)) && (!descriptor.environments || descriptor.environments.includes(environment.name)) && (!pluginEnvironment || isEnvironmentMatch(pluginEnvironment, environment.name)) && compilation.hooks.processAssets.tapPromise({
                                 name: pluginName,
                                 stage: mapProcessAssetsStage(compiler, descriptor.stage)
                             }, async (assets)=>handler({
@@ -7889,11 +7903,11 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             ].includes(level) && (index_js_namespaceObject.logger.level = level);
         }
         let { npm_execpath } = process.env;
-        (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && index_js_namespaceObject.logger.log(), index_js_namespaceObject.logger.greet(`  Rsbuild v1.4.7\n`);
+        (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && index_js_namespaceObject.logger.log(), index_js_namespaceObject.logger.greet(`  Rsbuild v1.4.8\n`);
         try {
             !function() {
                 let cli = ((name = "")=>new CAC(name))('rsbuild');
-                cli.help(), cli.version("1.4.7"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
+                cli.help(), cli.version("1.4.8"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
                     default: 'jiti'
                 }).option('-r, --root <root>', 'specify the project root directory, can be an absolute path or a path relative to cwd').option('-m, --mode <mode>', 'specify the build mode, can be `development`, `production` or `none`').option('--log-level <level>', 'specify the log level, can be `info`, `warn`, `error` or `silent`').option('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
                     type: [
@@ -7951,7 +7965,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             index_js_namespaceObject.logger.error('Failed to start Rsbuild CLI.'), index_js_namespaceObject.logger.error(err);
         }
     }
-    let src_version = "1.4.7";
+    let src_version = "1.4.8";
 })(), exports.PLUGIN_CSS_NAME = __webpack_exports__.PLUGIN_CSS_NAME, exports.PLUGIN_SWC_NAME = __webpack_exports__.PLUGIN_SWC_NAME, exports.createRsbuild = __webpack_exports__.createRsbuild, exports.defaultAllowedOrigins = __webpack_exports__.defaultAllowedOrigins, exports.defineConfig = __webpack_exports__.defineConfig, exports.ensureAssetPrefix = __webpack_exports__.ensureAssetPrefix, exports.loadConfig = __webpack_exports__.loadConfig, exports.loadEnv = __webpack_exports__.loadEnv, exports.logger = __webpack_exports__.logger, exports.mergeRsbuildConfig = __webpack_exports__.mergeRsbuildConfig, exports.rspack = __webpack_exports__.rspack, exports.runCLI = __webpack_exports__.runCLI, exports.version = __webpack_exports__.version, __webpack_exports__)-1 === [
     "PLUGIN_CSS_NAME",
     "PLUGIN_SWC_NAME",

package/dist/index.js

@@ -1428,47 +1428,6 @@ class CAC extends EventEmitter {
         }), actionArgs.push(options), command.commandAction.apply(this, actionArgs);
     }
 }
-let RSBUILD_ALL_ENVIRONMENT_SYMBOL = 'RSBUILD_ALL_ENVIRONMENT_SYMBOL', isPluginMatchEnvironment = (pluginEnvironment, currentEnvironment)=>pluginEnvironment === currentEnvironment || pluginEnvironment === RSBUILD_ALL_ENVIRONMENT_SYMBOL;
-async function initPlugins({ getPluginAPI, pluginManager }) {
-    logger.debug('init plugins');
-    let plugins = ((plugins)=>{
-        let allLines = [];
-        function getPlugin(name) {
-            let targets = plugins.filter((item)=>item.instance.name === name);
-            if (!targets.length) throw Error(`${picocolors.dim('[rsbuild:plugin]')} Plugin "${picocolors.yellow(name)}" not existed`);
-            return targets;
-        }
-        for (let plugin of plugins){
-            if (plugin.instance.pre) for (let pre of plugin.instance.pre)pre && plugins.some((item)=>item.instance.name === pre) && allLines.push([
-                pre,
-                plugin.instance.name
-            ]);
-            if (plugin.instance.post) for (let post of plugin.instance.post)post && plugins.some((item)=>item.instance.name === post) && allLines.push([
-                plugin.instance.name,
-                post
-            ]);
-        }
-        let zeroEndPoints = plugins.filter((item)=>!allLines.find((l)=>l[1] === item.instance.name)), sortedPoint = [];
-        for(; zeroEndPoints.length;){
-            let zep = zeroEndPoints.shift();
-            sortedPoint.push(...getPlugin(zep.instance.name)), allLines = allLines.filter((l)=>l[0] !== getPlugin(zep.instance.name)[0].instance.name), zeroEndPoints = plugins.filter((item)=>!sortedPoint.find((sp)=>sp.instance.name === item.instance.name)).filter((item)=>!allLines.find((l)=>l[1] === item.instance.name));
-        }
-        if (allLines.length) {
-            let restInRingPoints = {};
-            for (let l of allLines)restInRingPoints[l[0]] = !0, restInRingPoints[l[1]] = !0;
-            throw Error(`${picocolors.dim('[rsbuild:plugin]')} Plugins dependencies has loop: ${picocolors.yellow(Object.keys(restInRingPoints).join(','))}`);
-        }
-        return sortedPoint;
-    })(pluginManager.getAllPluginsWithMeta()), removedPlugins = plugins.reduce((ret, plugin)=>(plugin.instance.remove && (ret[plugin.environment] ??= [], ret[plugin.environment].push(...plugin.instance.remove)), ret), {});
-    for (let plugin of plugins){
-        var _removedPlugins_plugin_environment, _removedPlugins_RSBUILD_ALL_ENVIRONMENT_SYMBOL;
-        let isGlobalPlugin = 'RSBUILD_ALL_ENVIRONMENT_SYMBOL' === plugin.environment;
-        if ((null == (_removedPlugins_plugin_environment = removedPlugins[plugin.environment]) ? void 0 : _removedPlugins_plugin_environment.includes(plugin.instance.name)) || !isGlobalPlugin && (null == (_removedPlugins_RSBUILD_ALL_ENVIRONMENT_SYMBOL = removedPlugins[RSBUILD_ALL_ENVIRONMENT_SYMBOL]) ? void 0 : _removedPlugins_RSBUILD_ALL_ENVIRONMENT_SYMBOL.includes(plugin.instance.name))) continue;
-        let { instance, environment } = plugin;
-        await instance.setup(getPluginAPI(environment));
-    }
-    logger.debug('init plugins done');
-}
 function createEnvironmentAsyncHook() {
     let preGroup = [], postGroup = [], defaultGroup = [], tapEnvironment = ({ environment, handler: cb })=>{
         isFunction(cb) ? defaultGroup.push({
@@ -1496,7 +1455,7 @@ function createEnvironmentAsyncHook() {
                 ...defaultGroup,
                 ...postGroup
             ]){
-                if (callback.environment && environment && !isPluginMatchEnvironment(callback.environment, environment)) continue;
+                if (environment && callback.environment && callback.environment !== environment) continue;
                 let result = await callback.handler(...params);
                 void 0 !== result && (params[0] = result);
             }
@@ -1509,7 +1468,7 @@ function createEnvironmentAsyncHook() {
                 ...defaultGroup,
                 ...postGroup
             ]){
-                if (callback.environment && environment && !isPluginMatchEnvironment(callback.environment, environment)) continue;
+                if (environment && callback.environment && callback.environment !== environment) continue;
                 let result = await callback.handler(...params);
                 results.push(result);
             }
@@ -1946,6 +1905,57 @@ function exit(exitCode, type) {
         }
     }
 }
+let isEnvironmentMatch = (pluginEnvironment, specifiedEnvironment)=>pluginEnvironment === specifiedEnvironment || void 0 === pluginEnvironment;
+async function initPlugins({ context, pluginManager }) {
+    logger.debug('init plugins');
+    let plugins = ((plugins)=>{
+        let allLines = [];
+        function getPlugin(name) {
+            let targets = plugins.filter((item)=>item.instance.name === name);
+            if (!targets.length) throw Error(`${picocolors.dim('[rsbuild:plugin]')} Plugin "${picocolors.yellow(name)}" not existed`);
+            return targets;
+        }
+        for (let plugin of plugins){
+            if (plugin.instance.pre) for (let pre of plugin.instance.pre)pre && plugins.some((item)=>item.instance.name === pre) && allLines.push([
+                pre,
+                plugin.instance.name
+            ]);
+            if (plugin.instance.post) for (let post of plugin.instance.post)post && plugins.some((item)=>item.instance.name === post) && allLines.push([
+                plugin.instance.name,
+                post
+            ]);
+        }
+        let zeroEndPoints = plugins.filter((item)=>!allLines.find((l)=>l[1] === item.instance.name)), sortedPoint = [];
+        for(; zeroEndPoints.length;){
+            let zep = zeroEndPoints.shift();
+            sortedPoint.push(...getPlugin(zep.instance.name)), allLines = allLines.filter((l)=>l[0] !== getPlugin(zep.instance.name)[0].instance.name), zeroEndPoints = plugins.filter((item)=>!sortedPoint.find((sp)=>sp.instance.name === item.instance.name)).filter((item)=>!allLines.find((l)=>l[1] === item.instance.name));
+        }
+        if (allLines.length) {
+            let restInRingPoints = {};
+            for (let l of allLines)restInRingPoints[l[0]] = !0, restInRingPoints[l[1]] = !0;
+            throw Error(`${picocolors.dim('[rsbuild:plugin]')} Plugins dependencies has loop: ${picocolors.yellow(Object.keys(restInRingPoints).join(','))}`);
+        }
+        return sortedPoint;
+    })(pluginManager.getAllPluginsWithMeta()), removedPlugins = new Set(), removedEnvPlugins = {};
+    for (let { environment, instance } of plugins)if (instance.remove) if (environment) for (let item of (removedEnvPlugins[environment] ??= new Set(), instance.remove))removedEnvPlugins[environment].add(item);
+    else for (let item of instance.remove)removedPlugins.add(item);
+    for (let { instance, environment } of plugins){
+        var _removedEnvPlugins_environment;
+        let { name, setup } = instance;
+        if (!(removedPlugins.has(name) || environment && (null == (_removedEnvPlugins_environment = removedEnvPlugins[environment]) ? void 0 : _removedEnvPlugins_environment.has(name)))) {
+            if (instance.apply && context.action) {
+                let expected = {
+                    build: 'build',
+                    dev: 'serve',
+                    preview: 'serve'
+                }[context.action];
+                if (expected && instance.apply !== expected) continue;
+            }
+            await setup(context.getPluginAPI(environment));
+        }
+    }
+    logger.debug('init plugins done');
+}
 let mapProcessAssetsStage = (compiler, stage)=>{
     let { Compilation } = compiler.webpack;
     switch(stage){
@@ -2065,7 +2075,7 @@ async function updateEnvironmentContext(context, configs) {
 async function createContext(options, userConfig) {
     let { cwd } = options, rootPath = userConfig.root ? ensureAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = join(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0, bundlerType = userConfig.provider ? 'webpack' : 'rspack';
     return {
-        version: "1.4.7",
+        version: "1.4.8",
         rootPath,
         distPath: '',
         cachePath,
@@ -2448,7 +2458,7 @@ async function modifyEnvironmentConfig(context, config, name) {
 async function initRsbuildConfig({ context, pluginManager }) {
     if (context.normalizedConfig) return context.normalizedConfig;
     await initPlugins({
-        getPluginAPI: context.getPluginAPI,
+        context,
         pluginManager
     }), await modifyRsbuildConfig(context);
     let normalizedBaseConfig = ((config)=>{
@@ -3614,13 +3624,13 @@ function printServerURLs({ urls: originalUrls, port, routes, protocol, printUrls
         if (routes.length <= 1) {
             let pathname = routes.length ? routes[0].pathname : '';
             return urls.map(({ label, url })=>{
-                let normalizedPathname = normalizeUrl(`${url}${pathname}`), prefix = `\u{279C} ${picocolors.dim(label.padEnd(10))}`;
+                let normalizedPathname = normalizeUrl(`${url}${pathname}`), prefix = `\u{279C}  ${picocolors.dim(label.padEnd(10))}`;
                 return `  ${prefix}${picocolors.cyan(normalizedPathname)}\n`;
             }).join('');
         }
         let message = '', maxNameLength = Math.max(...routes.map((r)=>r.entryName.length));
         return urls.forEach(({ label, url }, index)=>{
-            for (let r of (index > 0 && (message += '\n'), message += `  ${`\u{279C} ${label}`}\n`, routes))message += `  ${picocolors.dim('-')} ${picocolors.dim(r.entryName.padEnd(maxNameLength + 4))}${picocolors.cyan(normalizeUrl(`${url}${r.pathname}`))}\n`;
+            for (let r of (index > 0 && (message += '\n'), message += `  ${`\u{279C}  ${label}`}\n`, routes))message += `  ${picocolors.dim('-')} ${picocolors.dim(r.entryName.padEnd(maxNameLength + 4))}${picocolors.cyan(normalizeUrl(`${url}${r.pathname}`))}\n`;
         }), message;
     }(urls, routes);
     return !1 === trailingLineBreak && message.endsWith('\n') && (message = message.slice(0, -1)), logger.log(message), message;
@@ -4135,7 +4145,7 @@ async function setupCliShortcuts({ help = !0, openPage, closeServer, printUrls,
         }
     ].filter(Boolean);
     if (customShortcuts && !Array.isArray(shortcuts = customShortcuts(shortcuts))) throw Error(`${picocolors.dim('[rsbuild:config]')} ${picocolors.yellow('dev.cliShortcuts')} option must return an array of shortcuts.`);
-    help && logger.log(!0 === help ? `  \u{279C} ${picocolors.dim('press')} ${picocolors.bold('h + enter')} ${picocolors.dim('to show shortcuts')}\n` : `  \u{279C} ${help}\n`);
+    help && logger.log(!0 === help ? `  \u{279C}  ${picocolors.dim('press')} ${picocolors.bold('h + enter')} ${picocolors.dim('to show shortcuts')}\n` : `  \u{279C}  ${help}\n`);
     let { createInterface } = await import("node:readline"), rl = createInterface({
         input: process.stdin
     });
@@ -5282,15 +5292,22 @@ async function devServer_createDevServer(options, createCompiler, config, { comp
         port,
         https
     };
-    let waitFirstCompileDone = runCompile ? new Promise((resolve)=>{
-        context.hooks.onDevCompileDone.tap(({ stats, isFirstCompile })=>{
-            lastStats = 'stats' in stats ? stats.stats : [
-                stats
-            ], isFirstCompile && resolve();
-        });
-    }) : Promise.resolve(), startCompile = async ()=>{
+    let waitLastCompileDoneResolve = null, waitLastCompileDone = new Promise((resolve)=>{
+        waitLastCompileDoneResolve = resolve;
+    });
+    context.hooks.onDevCompileDone.tap(({ stats })=>{
+        lastStats = 'stats' in stats ? stats.stats : [
+            stats
+        ], waitLastCompileDoneResolve && (waitLastCompileDoneResolve(), waitLastCompileDoneResolve = null);
+    });
+    let startCompile = async ()=>{
         let compiler = customCompiler || await createCompiler();
         if (!compiler) throw Error(`${picocolors.dim('[rsbuild:server]')} Failed to get compiler instance.`);
+        null == compiler || compiler.hooks.watchRun.tap('rsbuild:watchRun', ()=>{
+            lastStats && (waitLastCompileDoneResolve && (waitLastCompileDoneResolve(), waitLastCompileDoneResolve = null), waitLastCompileDone = new Promise((resolve)=>{
+                waitLastCompileDoneResolve = resolve;
+            }));
+        });
         let publicPaths = helpers_isMultiCompiler(compiler) ? compiler.compilers.map(getPublicPathFromCompiler) : [
             getPublicPathFromCompiler(compiler)
         ], compilationManager = new CompilationManager({
@@ -5348,19 +5365,19 @@ async function devServer_createDevServer(options, createCompiler, config, { comp
             {
                 getStats: async ()=>{
                     if (!compilationManager) throw Error(`${picocolors.dim('[rsbuild:server]')} Can not call ${picocolors.yellow('getStats')} when ${picocolors.yellow('runCompile')} is false`);
-                    return await waitFirstCompileDone, lastStats[environment.index];
+                    return await waitLastCompileDone, lastStats[environment.index];
                 },
                 context: environment,
                 loadBundle: async (entryName)=>{
                     if (!compilationManager) throw Error(`${picocolors.dim('[rsbuild:server]')} Can not call ${picocolors.yellow('loadBundle')} when ${picocolors.yellow('runCompile')} is false`);
-                    return await waitFirstCompileDone, cacheableLoadBundle(lastStats[environment.index], entryName, {
+                    return await waitLastCompileDone, cacheableLoadBundle(lastStats[environment.index], entryName, {
                         readFileSync: compilationManager.readFileSync,
                         environment
                     });
                 },
                 getTransformedHtml: async (entryName)=>{
                     if (!compilationManager) throw Error(`${picocolors.dim('[rsbuild:server]')} Can not call ${picocolors.yellow('getTransformedHtml')} when ${picocolors.yellow('runCompile')} is false`);
-                    return await waitFirstCompileDone, cacheableTransformedHtml(lastStats[environment.index], entryName, {
+                    return await waitLastCompileDone, cacheableTransformedHtml(lastStats[environment.index], entryName, {
                         readFileSync: compilationManager.readFileSync,
                         environment
                     });
@@ -7026,10 +7043,11 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
         },
         {
             name: 'rsbuild:lazy-compilation',
+            apply: 'serve',
             setup (api) {
-                api.modifyBundlerChain((chain, { environment, isProd, target })=>{
+                api.modifyBundlerChain((chain, { environment, target })=>{
                     var _config_dev;
-                    if (isProd || 'web' !== target) return;
+                    if ('web' !== target) return;
                     let { config } = environment, options = null == (_config_dev = config.dev) ? void 0 : _config_dev.lazyCompilation;
                     if (options) {
                         if (!0 === options && Object.keys(chain.entryPoints.entries() || {}).length <= 1) return void chain.experiments({
@@ -7146,12 +7164,10 @@ async function createRsbuild(options = {}) {
         ...options,
         rsbuildConfig: config
     }, pluginManager = (plugins = [], {
-        getPlugins: (options = {
-            environment: RSBUILD_ALL_ENVIRONMENT_SYMBOL
-        })=>plugins.filter((p)=>isPluginMatchEnvironment(p.environment, options.environment)).map((p)=>p.instance),
+        getPlugins: (options = {})=>plugins.filter((plugin)=>isEnvironmentMatch(plugin.environment, options.environment)).map(({ instance })=>instance),
         getAllPluginsWithMeta: ()=>plugins,
         addPlugins: (newPlugins, options)=>{
-            let { before, environment = RSBUILD_ALL_ENVIRONMENT_SYMBOL } = options || {};
+            let { before, environment } = options || {};
             for (let newPlugin of newPlugins)if (newPlugin) {
                 let type = typeof newPlugin;
                 if ('object' !== type || null === newPlugin) throw Error(`${picocolors.dim('[rsbuild:plugin]')} Expect Rsbuild plugin instance to be an object, but got ${picocolors.yellow(type)}.`);
@@ -7192,9 +7208,7 @@ async function createRsbuild(options = {}) {
         removePlugins: (pluginNames, options = {})=>{
             plugins = plugins.filter((plugin)=>!(pluginNames.includes(plugin.instance.name) && (!options.environment || plugin.environment === options.environment)));
         },
-        isPluginExists: (pluginName, options = {
-            environment: RSBUILD_ALL_ENVIRONMENT_SYMBOL
-        })=>!!plugins.find((plugin)=>plugin.instance.name === pluginName && isPluginMatchEnvironment(plugin.environment, options.environment))
+        isPluginExists: (pluginName, options = {})=>plugins.some((plugin)=>plugin.instance.name === pluginName && isEnvironmentMatch(plugin.environment, options.environment))
     }), context = await createContext(resolvedOptions, config), getPluginAPI = function({ context, pluginManager }) {
         let { hooks } = context, publicContext = function(context) {
             let exposedKeys = [
@@ -7248,7 +7262,7 @@ async function createRsbuild(options = {}) {
             let pluginName = 'RsbuildCorePlugin';
             chain.plugin(pluginName).use(class {
                 apply(compiler) {
-                    for (let { handler, environment: pluginEnvironment } of (compiler.__rsbuildTransformer = transformer, resolveFns))(!pluginEnvironment || isPluginMatchEnvironment(pluginEnvironment, environment.name)) && compiler.hooks.compilation.tap(pluginName, (compilation, { normalModuleFactory })=>{
+                    for (let { handler, environment: pluginEnvironment } of (compiler.__rsbuildTransformer = transformer, resolveFns))(!pluginEnvironment || isEnvironmentMatch(pluginEnvironment, environment.name)) && compiler.hooks.compilation.tap(pluginName, (compilation, { normalModuleFactory })=>{
                         normalModuleFactory.hooks.resolve.tapPromise(pluginName, async (resolveData)=>handler({
                                 compiler,
                                 compilation,
@@ -7261,7 +7275,7 @@ async function createRsbuild(options = {}) {
                             childCompiler.__rsbuildTransformer = transformer;
                         });
                         let { sources } = compiler.webpack;
-                        for (let { descriptor, handler, environment: pluginEnvironment } of processAssetsFns)(!descriptor.targets || descriptor.targets.includes(target)) && (!descriptor.environments || descriptor.environments.includes(environment.name)) && (!pluginEnvironment || isPluginMatchEnvironment(pluginEnvironment, environment.name)) && compilation.hooks.processAssets.tapPromise({
+                        for (let { descriptor, handler, environment: pluginEnvironment } of processAssetsFns)(!descriptor.targets || descriptor.targets.includes(target)) && (!descriptor.environments || descriptor.environments.includes(environment.name)) && (!pluginEnvironment || isEnvironmentMatch(pluginEnvironment, environment.name)) && compilation.hooks.processAssets.tapPromise({
                             name: pluginName,
                             stage: mapProcessAssetsStage(compiler, descriptor.stage)
                         }, async (assets)=>handler({
@@ -7672,11 +7686,11 @@ async function runCLI() {
         ].includes(level) && (logger.level = level);
     }
     let { npm_execpath } = process.env;
-    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && logger.log(), logger.greet(`  Rsbuild v1.4.7\n`);
+    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && logger.log(), logger.greet(`  Rsbuild v1.4.8\n`);
     try {
         !function() {
             let cli = ((name = "")=>new CAC(name))('rsbuild');
-            cli.help(), cli.version("1.4.7"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
+            cli.help(), cli.version("1.4.8"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
                 default: 'jiti'
             }).option('-r, --root <root>', 'specify the project root directory, can be an absolute path or a path relative to cwd').option('-m, --mode <mode>', 'specify the build mode, can be `development`, `production` or `none`').option('--log-level <level>', 'specify the log level, can be `info`, `warn`, `error` or `silent`').option('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
                 type: [
@@ -7734,5 +7748,5 @@ async function runCLI() {
         logger.error('Failed to start Rsbuild CLI.'), logger.error(err);
     }
 }
-let src_version = "1.4.7";
+let src_version = "1.4.8";
 export { PLUGIN_CSS_NAME, PLUGIN_SWC_NAME, createRsbuild, defaultAllowedOrigins, defineConfig, ensureAssetPrefix, loadConfig_loadConfig as loadConfig, loadEnv, logger, mergeRsbuildConfig, rspack, runCLI, src_version as version };

package/dist-types/loadEnv.d.ts

@@ -23,7 +23,7 @@ export type LoadEnvOptions = {
 };
 export type LoadEnvResult = {
     /**
-     * All env variables in the .env file
+     * All environment variables in the .env file
      */
     parsed: Record<string, string>;
     /**
@@ -31,7 +31,7 @@ export type LoadEnvResult = {
      */
     filePaths: string[];
     /**
-     * Env variables that start with prefixes.
+     * Environment variables that start with prefixes.
      *
      * @example
      * ```ts
@@ -42,7 +42,7 @@ export type LoadEnvResult = {
      **/
     rawPublicVars: Record<string, string | undefined>;
     /**
-     * Formatted env variables that start with prefixes.
+     * Formatted environment variables that start with prefixes.
      * The keys contain the prefixes `process.env.*` and `import.meta.env.*`.
      * The values are processed by `JSON.stringify`.
      *
@@ -56,7 +56,7 @@ export type LoadEnvResult = {
      **/
     publicVars: Record<string, string>;
     /**
-     * Clear the env variables mounted on `process.env`
+     * Clear the environment variables mounted on `process.env`
      */
     cleanup: () => void;
 };

package/dist-types/pluginManager.d.ts

@@ -1,9 +1,12 @@
-import type { PluginManager, PluginMeta, RsbuildPluginAPI } from './types';
-export declare const RSBUILD_ALL_ENVIRONMENT_SYMBOL = "RSBUILD_ALL_ENVIRONMENT_SYMBOL";
-export declare const isPluginMatchEnvironment: (pluginEnvironment: string, currentEnvironment: string) => boolean;
+import type { InternalContext, PluginManager, PluginMeta } from './types';
+/**
+ * Determines whether the plugin is registered in the specified environment.
+ * If the pluginEnvironment is undefined, it means it can match any environment.
+ */
+export declare const isEnvironmentMatch: (pluginEnvironment?: string, specifiedEnvironment?: string) => boolean;
 export declare function createPluginManager(): PluginManager;
 export declare const pluginDagSort: (plugins: PluginMeta[]) => PluginMeta[];
-export declare function initPlugins({ getPluginAPI, pluginManager, }: {
-    getPluginAPI: (environment?: string) => RsbuildPluginAPI;
+export declare function initPlugins({ context, pluginManager, }: {
+    context: InternalContext;
     pluginManager: PluginManager;
 }): Promise<void>;

package/dist-types/types/plugin.d.ts

@@ -6,7 +6,7 @@ import type { Logger } from '../logger';
 import type { ModifyRspackConfigUtils, NarrowedRspackConfig, NormalizedConfig, NormalizedEnvironmentConfig, RsbuildConfig, RspackMerge } from './config';
 import type { RsbuildContext } from './context';
 import type { EnvironmentContext, ModifyBundlerChainFn, ModifyChainUtils, ModifyEnvironmentConfigFn, ModifyHTMLFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn } from './hooks';
-import type { RsbuildInstance, RsbuildTarget } from './rsbuild';
+import type { AddPluginsOptions, RsbuildInstance, RsbuildTarget } from './rsbuild';
 import type { Rspack } from './rspack';
 import type { HtmlRspackPlugin } from './thirdParty';
 import type { Falsy, MaybePromise } from './utils';
@@ -117,13 +117,14 @@ export type ModifyWebpackConfigUtils = ModifyWebpackChainUtils & {
 export type ModifyWebpackChainFn = (chain: RspackChain, utils: ModifyWebpackChainUtils) => Promise<void> | void;
 export type ModifyWebpackConfigFn = (config: WebpackConfig, utils: ModifyWebpackConfigUtils) => Promise<WebpackConfig | void> | WebpackConfig | void;
 export type PluginMeta = {
-    environment: string;
+    environment?: AddPluginsOptions['environment'];
     instance: RsbuildPlugin;
 };
 export type PluginManager = Pick<RsbuildInstance, 'getPlugins' | 'addPlugins' | 'isPluginExists' | 'removePlugins'> & {
     /** Get all plugins with environment info */
     getAllPluginsWithMeta: () => PluginMeta[];
 };
+export type RsbuildPluginApply = 'serve' | 'build';
 /**
  * The type of the Rsbuild plugin object.
  */
@@ -132,6 +133,13 @@ export type RsbuildPlugin = {
      * The name of the plugin, a unique identifier.
      */
     name: string;
+    /**
+     * Conditional apply the plugin during serve or build.
+     * - `'serve'`: Apply the plugin when starting the dev server or preview server.
+     * - `'build'`: Apply the plugin during build.
+     * - If not specified, the plugin will be applied during both serve and build.
+     */
+    apply?: RsbuildPluginApply;
     /**
      * The setup function of the plugin, which can be an async function.
      * This function is called once when the plugin is initialized.

package/dist-types/types/rsbuild.d.ts

@@ -135,7 +135,7 @@ export type CreateRsbuildOptions = {
      */
     rsbuildConfig?: RsbuildConfig | (() => Promise<RsbuildConfig>);
     /**
-     * Whether to call `loadEnv` to load env variables and define them
+     * Whether to call `loadEnv` to load environment variables and define them
      * as global variables via `source.define`.
      * @default false
      */
@@ -158,23 +158,26 @@ export type RsbuildProvider<B extends 'rspack' | 'webpack' = 'rspack'> = (option
     rsbuildOptions: ResolvedCreateRsbuildOptions;
     helpers: RsbuildProviderHelpers;
 }) => Promise<ProviderInstance<B>>;
+export type AddPluginsOptions = {
+    /**
+     * Insert before the specified plugin.
+     */
+    before?: string;
+    /**
+     * Specify the environment that the plugin will be applied to.
+     * If not specified, the plugin will be be registered as a global plugin and
+     * applied to all environments.
+     */
+    environment?: string;
+};
+export type AddPlugins = (plugins: Array<RsbuildPlugin | Falsy>, options?: AddPluginsOptions) => void;
 export type RsbuildInstance = {
     /**
      * Register one or more Rsbuild plugins, which can be called multiple times.
      * This method needs to be called before compiling. If it is called after
      * compiling, it will not affect the compilation result.
      */
-    addPlugins: (plugins: Array<RsbuildPlugin | Falsy>, options?: {
-        /**
-         * Insert before the specified plugin.
-         */
-        before?: string;
-        /**
-         * Add a plugin for the specified environment.
-         * If environment is not specified, it will be registered as a global plugin (effective in all environments)
-         */
-        environment?: string;
-    }) => void;
+    addPlugins: AddPlugins;
     /**
      * Get all the Rsbuild plugins registered in the current Rsbuild instance.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.4.7",
+  "version": "1.4.8",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.rs",
   "bugs": {

package/types.d.ts

@@ -1,10 +1,27 @@
 /// <reference types="@rspack/core/module" />
 
+/**
+ * This is a placeholder for extending the type options.
+ * You can augment this interface to enable stricter type checking.
+ * @example
+ * ```ts
+ * interface RsbuildTypeOptions {
+ *   // This will enable strict type checking for `import.meta.env`.
+ *   strictImportMetaEnv: true;
+ * }
+ * ```
+ */
+// biome-ignore lint/suspicious/noEmptyInterface: placeholder
+interface RsbuildTypeOptions {}
+
 /**
  * import.meta
  */
+type ImportMetaEnvFallbackKey =
+  'strictImportMetaEnv' extends keyof RsbuildTypeOptions ? never : string;
+
 interface ImportMetaEnv {
-  [key: string]: any;
+  [key: ImportMetaEnvFallbackKey]: any;
   /**
    * The value of the `mode` configuration.
    * @example