@rsbuild/core 1.4.6 → 1.4.8

package/dist/index.js

@@ -12,12 +12,12 @@ import node_os, { constants as external_node_os_constants } from "node:os";
 import node_process from "node:process";
 import rspack_chain from "../compiled/rspack-chain/index.js";
 import { isPromise, isRegExp } from "node:util/types";
-import node_util, { promisify as external_node_util_promisify } from "node:util";
+import { promisify as external_node_util_promisify } from "node:util";
 import { lookup } from "../compiled/mrmime/index.js";
 import node_zlib from "node:zlib";
 import { Buffer as external_node_buffer_Buffer } from "node:buffer";
 import node_child_process, { execFile } from "node:child_process";
-import promises from "node:fs/promises";
+import promises, { constants as promises_constants } from "node:fs/promises";
 var EsmMode, __webpack_modules__ = {
     "../../node_modules/.pnpm/clone-deep@4.0.1/node_modules/clone-deep/index.js": function(module, __unused_webpack_exports, __webpack_require__) {
         let clone = __webpack_require__("../../node_modules/.pnpm/shallow-clone@3.0.1/node_modules/shallow-clone/index.js"), typeOf = __webpack_require__("../../node_modules/.pnpm/kind-of@6.0.3/node_modules/kind-of/index.js"), isPlainObject = __webpack_require__("../../node_modules/.pnpm/is-plain-object@2.0.4/node_modules/is-plain-object/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.6",
+        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)=>{
@@ -2540,7 +2550,7 @@ async function initRsbuildConfig({ context, pluginManager }) {
         environments
     }, await updateEnvironmentContext(context, environments);
     let distPaths = Object.values(context.environments).map((item)=>item.distPath);
-    context.distPath = function(paths) {
+    return context.distPath = function(paths) {
         let uniquePaths = [
             ...new Set(paths)
         ];
@@ -2552,14 +2562,20 @@ async function initRsbuildConfig({ context, pluginManager }) {
             else break;
         }
         return common.join(sep);
-    }(distPaths);
-    var config = context.normalizedConfig;
-    if (config.server.base && !config.server.base.startsWith('/')) throw Error(`${picocolors.dim('[rsbuild:config]')} The ${picocolors.yellow('"server.base"')} option should start with a slash, for example: "/base"`);
-    if (config.environments) {
-        let names = Object.keys(config.environments), regexp = /^[\w$-]+$/;
-        for (let name of names)regexp.test(name) || logger.warn(`${picocolors.dim('[rsbuild:config]')} Environment name "${picocolors.yellow(name)}" contains invalid characters. Only letters, numbers, "-", "_", and "$" are allowed.`);
-    }
-    return context.normalizedConfig;
+    }(distPaths), ((config)=>{
+        if (config.server.base && !config.server.base.startsWith('/')) throw Error(`${picocolors.dim('[rsbuild:config]')} The ${picocolors.yellow('"server.base"')} option should start with a slash, for example: "/base"`);
+        if (!config.environments) return;
+        let environmentNames = Object.keys(config.environments), environmentNameRegexp = /^[\w$-]+$/, validTargets = [
+            'web',
+            'node',
+            'web-worker'
+        ];
+        for (let name of environmentNames){
+            environmentNameRegexp.test(name) || logger.warn(`${picocolors.dim('[rsbuild:config]')} Environment name "${picocolors.yellow(name)}" contains invalid characters. Only letters, numbers, "-", "_", and "$" are allowed.`);
+            let outputConfig = config.environments[name].output;
+            if (outputConfig.target && !validTargets.includes(outputConfig.target)) throw Error(`${picocolors.dim('[rsbuild:config]')} Invalid value of ${picocolors.yellow('output.target')}: ${picocolors.yellow(`"${outputConfig.target}"`)}, valid values are: ${picocolors.yellow(validTargets.join(', '))}`);
+        }
+    })(context.normalizedConfig), context.normalizedConfig;
 }
 async function initConfigs({ context, pluginManager, rsbuildOptions }) {
     let normalizedConfig = await initRsbuildConfig({
@@ -3032,9 +3048,10 @@ let entryNameSymbol = Symbol('entryName'), VOID_TAGS = [
 }, formatBasicTag = (tag)=>({
         tag: tag.tagName,
         attrs: tag.attributes,
-        children: tag.innerHTML
+        children: tag.innerHTML,
+        metadata: tag.meta
     }), fromBasicTag = (tag)=>({
-        meta: {},
+        meta: tag.metadata ?? {},
         tagName: tag.tag,
         attributes: tag.attrs ?? {},
         voidTag: VOID_TAGS.includes(tag.tag),
@@ -3263,7 +3280,24 @@ let isWsl = ()=>{
     } catch  {
         return !1;
     }
-}, is_wsl = node_process.env.__IS_WSL_TEST__ ? isWsl : isWsl();
+}, is_wsl = node_process.env.__IS_WSL_TEST__ ? isWsl : isWsl(), wslDrivesMountPoint = (()=>{
+    let mountPoint, defaultMountPoint = '/mnt/';
+    return async function() {
+        if (mountPoint) return mountPoint;
+        let configFilePath = '/etc/wsl.conf', isConfigFileExists = !1;
+        try {
+            await promises.access(configFilePath, promises_constants.F_OK), isConfigFileExists = !0;
+        } catch  {}
+        if (!isConfigFileExists) return defaultMountPoint;
+        let configContent = await promises.readFile(configFilePath, {
+            encoding: 'utf8'
+        }), configMountPoint = /(?<!#.*)root\s*=\s*(?<mountPoint>.*)/g.exec(configContent);
+        return configMountPoint ? mountPoint = (mountPoint = configMountPoint.groups.mountPoint.trim()).endsWith('/') ? mountPoint : `${mountPoint}/` : defaultMountPoint;
+    };
+})(), powerShellPathFromWsl = async ()=>{
+    let mountPoint = await wslDrivesMountPoint();
+    return `${mountPoint}c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe`;
+}, powerShellPath = async ()=>is_wsl ? powerShellPathFromWsl() : `${node_process.env.SYSTEMROOT || node_process.env.windir || String.raw`C:\Windows`}\\System32\\WindowsPowerShell\\v1.0\\powershell.exe`;
 function defineLazyProperty(object, propertyName, valueGetter) {
     let define = (value)=>Object.defineProperty(object, propertyName, {
             value,
@@ -3382,26 +3416,9 @@ async function default_browser_defaultBrowser() {
     if ('win32' === node_process.platform) return defaultBrowser();
     throw Error('Only macOS, Linux, and Windows are supported');
 }
-let open_execFile = node_util.promisify(node_child_process.execFile), open_dirname = node_path.dirname(fileURLToPath(import.meta.url)), localXdgOpenPath = node_path.join(open_dirname, 'xdg-open'), { platform, arch } = node_process, getWslDrivesMountPoint = (()=>{
-    let mountPoint, defaultMountPoint = '/mnt/';
-    return async function() {
-        if (mountPoint) return mountPoint;
-        let configFilePath = '/etc/wsl.conf', isConfigFileExists = !1;
-        try {
-            await promises.access(configFilePath, external_node_fs_constants.F_OK), isConfigFileExists = !0;
-        } catch  {}
-        if (!isConfigFileExists) return defaultMountPoint;
-        let configContent = await promises.readFile(configFilePath, {
-            encoding: 'utf8'
-        }), configMountPoint = /(?<!#.*)root\s*=\s*(?<mountPoint>.*)/g.exec(configContent);
-        return configMountPoint ? mountPoint = (mountPoint = configMountPoint.groups.mountPoint.trim()).endsWith('/') ? mountPoint : `${mountPoint}/` : defaultMountPoint;
-    };
-})(), getPowershellPathFromWsl = async ()=>{
-    let mountPoint = await getWslDrivesMountPoint();
-    return `${mountPoint}c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe`;
-};
+let open_execFile = external_node_util_promisify(node_child_process.execFile), open_dirname = node_path.dirname(fileURLToPath(import.meta.url)), localXdgOpenPath = node_path.join(open_dirname, 'xdg-open'), { platform, arch } = node_process;
 async function getWindowsDefaultBrowserFromWsl() {
-    let powershellPath = await getPowershellPathFromWsl(), encodedCommand = external_node_buffer_Buffer.from('(Get-ItemProperty -Path "HKCU:\\Software\\Microsoft\\Windows\\Shell\\Associations\\UrlAssociations\\http\\UserChoice").ProgId', 'utf16le').toString('base64'), { stdout } = await open_execFile(powershellPath, [
+    let powershellPath = await powerShellPath(), rawCommand = String.raw`(Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\Shell\Associations\UrlAssociations\http\UserChoice").ProgId`, encodedCommand = external_node_buffer_Buffer.from(rawCommand, 'utf16le').toString('base64'), { stdout } = await open_execFile(powershellPath, [
         '-NoProfile',
         '-NonInteractive',
         '-ExecutionPolicy',
@@ -3412,6 +3429,7 @@ async function getWindowsDefaultBrowserFromWsl() {
         encoding: 'utf8'
     }), progId = stdout.trim(), browserMap = {
         ChromeHTML: 'com.google.chrome',
+        BraveHTML: 'com.brave.Browser',
         MSEdgeHTM: 'com.microsoft.edge',
         FirefoxURL: 'org.mozilla.firefox'
     };
@@ -3453,6 +3471,7 @@ let pTryEach = async (array, mapper)=>{
         let ids = {
             'com.google.chrome': 'chrome',
             'google-chrome.desktop': 'chrome',
+            'com.brave.Browser': 'brave',
             'org.mozilla.firefox': 'firefox',
             'firefox.desktop': 'firefox',
             'com.microsoft.msedge': 'edge',
@@ -3464,6 +3483,7 @@ let pTryEach = async (array, mapper)=>{
             let browserName = ids[browser.id];
             return 'browserPrivate' === app && appArguments.push({
                 chrome: '--incognito',
+                brave: '--incognito',
                 firefox: '--private-window',
                 edge: '--inPrivate'
             }[browserName]), baseOpen({
@@ -3489,7 +3509,7 @@ let pTryEach = async (array, mapper)=>{
         }
         appArguments.length > 0 && cliArguments.push(...appArguments), options.wait || (childProcessOptions.stdio = 'ignore', childProcessOptions.detached = !0);
     } else {
-        command = is_wsl ? await getPowershellPathFromWsl() : `${node_process.env.SYSTEMROOT || node_process.env.windir || 'C:\\Windows'}\\System32\\WindowsPowerShell\\v1.0\\powershell`, cliArguments.push('-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-EncodedCommand'), is_wsl || (childProcessOptions.windowsVerbatimArguments = !0);
+        command = await powerShellPath(), cliArguments.push('-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-EncodedCommand'), is_wsl || (childProcessOptions.windowsVerbatimArguments = !0);
         let encodedArguments = [
             'Start'
         ];
@@ -3532,9 +3552,24 @@ defineLazyProperty(apps, 'chrome', ()=>detectPlatformBinary({
                 '/mnt/c/Program Files (x86)/Google/Chrome/Application/chrome.exe'
             ]
         }
+    })), defineLazyProperty(apps, 'brave', ()=>detectPlatformBinary({
+        darwin: 'brave browser',
+        win32: 'brave',
+        linux: [
+            'brave-browser',
+            'brave'
+        ]
+    }, {
+        wsl: {
+            ia32: '/mnt/c/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe',
+            x64: [
+                '/mnt/c/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe',
+                '/mnt/c/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe'
+            ]
+        }
     })), defineLazyProperty(apps, 'firefox', ()=>detectPlatformBinary({
         darwin: 'firefox',
-        win32: 'C:\\Program Files\\Mozilla Firefox\\firefox.exe',
+        win32: String.raw`C:\Program Files\Mozilla Firefox\firefox.exe`,
         linux: 'firefox'
     }, {
         wsl: '/mnt/c/Program Files/Mozilla Firefox/firefox.exe'
@@ -3589,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;
@@ -4110,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
     });
@@ -5257,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({
@@ -5323,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
                     });
@@ -5691,7 +5733,7 @@ async function applyDefaultPlugins(pluginManager, context) {
                         buildDependencies
                     });
                 }), api.onAfterCreateCompiler(()=>{
-                    cacheEnabled && 'rspack' === api.context.bundlerType && logger.info(`Rspack persistent cache enabled ${picocolors.dim('(experimental)')}`);
+                    cacheEnabled && 'rspack' === api.context.bundlerType && logger.debug('Rspack persistent cache enabled');
                 });
             }
         },
@@ -7001,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({
@@ -7121,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)}.`);
@@ -7167,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 = [
@@ -7223,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,
@@ -7236,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({
@@ -7647,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.6\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.6"), 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: [
@@ -7709,5 +7748,5 @@ async function runCLI() {
         logger.error('Failed to start Rsbuild CLI.'), logger.error(err);
     }
 }
-let src_version = "1.4.6";
+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/index.d.ts

@@ -19,4 +19,4 @@ export { type Logger, logger } from './logger';
 export { mergeRsbuildConfig } from './mergeConfig';
 export type { RsbuildDevServer } from './server/devServer';
 export type { StartServerResult } from './server/helper';
-export type { AliasStrategy, AppIcon, AppIconItem, Build, BuildOptions, BundlerPluginInstance, Charset, CleanDistPath, CleanDistPathObject, ClientConfig, CliShortcut, CompressOptions, ConfigChain, ConfigChainWithContext, ConsoleType, CreateCompiler, CreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, DataUriLimit, Decorators, DevConfig, DistPathConfig, EnvironmentConfig, EnvironmentContext, FilenameConfig, HistoryApiFallbackContext, HistoryApiFallbackOptions, HtmlBasicTag, HtmlConfig, HtmlFallback, HtmlRspackPlugin, HtmlTagContext, HtmlTagDescriptor, HtmlTagHandler, InlineChunkConfig, InlineChunkTest, InlineChunkTestFunction, InspectConfigOptions, InspectConfigResult, InternalContext, LegalComments, LogLevel, ManifestConfig, ManifestData, ManifestObjectConfig, MergedEnvironmentConfig, MetaAttrs, MetaOptions, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyEnvironmentConfigFn, ModifyEnvironmentConfigUtils, ModifyHTMLContext, ModifyHTMLFn, ModifyHTMLTagsContext, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRsbuildConfigUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigFn, ModifyWebpackConfigUtils, ModuleFederationConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSOptions, PostCSSPlugin, PreconnectOption, PreviewOptions, PrintUrls, ProcessAssetsDescriptor, ProcessAssetsHandler, ProcessAssetsHook, ProgressBarConfig, ProxyBypass, ProxyConfig, ProxyFilter, ProxyOptions, PublicDir, PublicDirOptions, RequestHandler, ResolvedCreateRsbuildOptions, ResolveHandler, ResolveHook, ResourceHintsIncludeType, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildProviderHelpers, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerConfig, SetupMiddlewaresContext, SetupMiddlewaresFn, SourceConfig, SourceMap, SplitChunks, SriAlgorithm, SriOptions, StartDevServerOptions, StyleLoaderOptions, ToolsConfig, TransformContext, TransformDescriptor, TransformHandler, TransformHook, TransformImport, WatchFiles, } from './types';
+export type { AliasStrategy, AppIcon, AppIconItem, Build, BuildOptions, BundlerPluginInstance, Charset, CleanDistPath, CleanDistPathObject, ClientConfig, CliShortcut, CompressOptions, ConfigChain, ConfigChainWithContext, ConsoleType, CreateCompiler, CreateRsbuildOptions, CrossOrigin, CSSLoaderOptions, CSSModules, CSSModulesLocalsConvention, DataUriLimit, Decorators, DevConfig, DistPathConfig, EnvironmentConfig, EnvironmentContext, FilenameConfig, HistoryApiFallbackContext, HistoryApiFallbackOptions, HtmlBasicTag, HtmlConfig, HtmlFallback, HtmlRspackPlugin, HtmlTag, HtmlTagContext, HtmlTagDescriptor, HtmlTagHandler, InlineChunkConfig, InlineChunkTest, InlineChunkTestFunction, InspectConfigOptions, InspectConfigResult, InternalContext, LegalComments, LogLevel, ManifestConfig, ManifestData, ManifestObjectConfig, MergedEnvironmentConfig, MetaAttrs, MetaOptions, Minify, ModifyBundlerChainFn, ModifyBundlerChainUtils, ModifyChainUtils, ModifyEnvironmentConfigFn, ModifyEnvironmentConfigUtils, ModifyHTMLContext, ModifyHTMLFn, ModifyHTMLTagsContext, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRsbuildConfigUtils, ModifyRspackConfigFn, ModifyRspackConfigUtils, ModifyWebpackChainFn, ModifyWebpackChainUtils, ModifyWebpackConfigFn, ModifyWebpackConfigUtils, ModuleFederationConfig, NormalizedConfig, NormalizedDevConfig, NormalizedEnvironmentConfig, NormalizedHtmlConfig, NormalizedModuleFederationConfig, NormalizedOutputConfig, NormalizedPerformanceConfig, NormalizedSecurityConfig, NormalizedServerConfig, NormalizedSourceConfig, NormalizedToolsConfig, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompileFn, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, OutputConfig, OutputStructure, PerformanceConfig, PluginManager, Polyfill, PostCSSLoaderOptions, PostCSSOptions, PostCSSPlugin, PreconnectOption, PreviewOptions, PrintUrls, ProcessAssetsDescriptor, ProcessAssetsHandler, ProcessAssetsHook, ProgressBarConfig, ProxyBypass, ProxyConfig, ProxyFilter, ProxyOptions, PublicDir, PublicDirOptions, RequestHandler, ResolvedCreateRsbuildOptions, ResolveHandler, ResolveHook, ResourceHintsIncludeType, RsbuildConfig, RsbuildContext, RsbuildEntry, RsbuildEntryDescription, RsbuildInstance, RsbuildMode, RsbuildPlugin, RsbuildPluginAPI, RsbuildPlugins, RsbuildProvider, RsbuildProviderHelpers, RsbuildTarget, RspackChain, RspackRule, ScriptInject, ScriptLoading, SecurityConfig, ServerConfig, SetupMiddlewaresContext, SetupMiddlewaresFn, SourceConfig, SourceMap, SplitChunks, SriAlgorithm, SriOptions, StartDevServerOptions, StyleLoaderOptions, ToolsConfig, TransformContext, TransformDescriptor, TransformHandler, TransformHook, TransformImport, WatchFiles, } from './types';

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/config.d.ts

@@ -1146,6 +1146,12 @@ export type HtmlBasicTag = {
      * HTML escaping, so ensure it's safe to prevent XSS vulnerabilities.
      */
     children?: string;
+    /**
+     * The metadata object for tags, used to store additional information about tags.
+     * `metadata` does not affect the generated HTML content.
+     * @default undefined
+     */
+    metadata?: Record<string, any>;
 };
 export type HtmlTag = HtmlBasicTag & {
     /**

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.