@rsbuild/core 1.1.5 → 1.1.7

package/dist/index.js

@@ -1698,7 +1698,7 @@ function getFilename(config, type, isProd, isServer) {
         case 'assets':
             return filename.assets ?? `[name]${hash}[ext]`;
         default:
-            throw Error(`unknown key ${type} in "output.filename"`);
+            throw Error(`[rsbuild:config] unknown key ${type} in "output.filename"`);
     }
 }
 let applyToCompiler = (compiler, apply)=>{
@@ -1720,7 +1720,7 @@ let camelCase = (input)=>input.replace(/[-_](\w)/g, (_, c)=>c.toUpperCase()), pr
 function loadEnv({ cwd = process.cwd(), mode = getNodeEnv(), prefixes = [
     'PUBLIC_'
 ] } = {}) {
-    if ('local' === mode) throw Error("'local' cannot be used as a value for env mode, because \".env.local\" represents a temporary local file. Please use another value.");
+    if ('local' === mode) throw Error("[rsbuild:loadEnv] 'local' cannot be used as a value for env mode, because \".env.local\" represents a temporary local file. Please use another value.");
     let filePaths = [
         '.env',
         '.env.local',
@@ -2013,7 +2013,6 @@ let config_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module__.createRequire)(
             '@swc/helpers': swcHelpersPath
         },
         define: {},
-        aliasStrategy: 'prefer-tsconfig',
         preEntry: [],
         decorators: {
             version: '2022-03'
@@ -2095,10 +2094,14 @@ let config_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module__.createRequire)(
             exportLocalsConvention: 'camelCase'
         },
         emitAssets: !0
+    }), getDefaultResolveConfig = ()=>({
+        alias: {},
+        aliasStrategy: 'prefer-tsconfig'
     }), createDefaultConfig = ()=>({
         dev: getDefaultDevConfig(),
         server: getDefaultServerConfig(),
         html: getDefaultHtmlConfig(),
+        resolve: getDefaultResolveConfig(),
         source: getDefaultSourceConfig(),
         output: getDefaultOutputConfig(),
         tools: getDefaultToolsConfig(),
@@ -2200,13 +2203,13 @@ async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta } =
             envMode: envMode || nodeEnv,
             meta
         });
-        if (void 0 === result) throw Error('The config function must return a config object.');
+        if (void 0 === result) throw Error('[rsbuild:loadConfig] The config function must return a config object.');
         return {
             content: applyMetaInfo(result),
             filePath: configFilePath
         };
     }
-    if (!isObject(configExport)) throw Error(`The config must be an object or a function that returns an object, get ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(configExport)}`);
+    if (!isObject(configExport)) throw Error(`[rsbuild:loadConfig] The config must be an object or a function that returns an object, get ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(configExport)}`);
     return {
         content: applyMetaInfo(configExport),
         filePath: configFilePath
@@ -2299,7 +2302,7 @@ let normalizePublicDirs = (publicDir)=>{
     let allLines = [];
     function getPlugin(name) {
         let targets = plugins.filter((item)=>item.instance.name === name);
-        if (!targets.length) throw Error(`plugin ${name} not existed`);
+        if (!targets.length) throw Error(`[rsbuild:plugin] Plugin "${name}" not existed`);
         return targets;
     }
     for (let plugin of plugins){
@@ -2320,7 +2323,7 @@ let normalizePublicDirs = (publicDir)=>{
     if (allLines.length) {
         let restInRingPoints = {};
         for (let l of allLines)restInRingPoints[l[0]] = !0, restInRingPoints[l[1]] = !0;
-        throw Error(`plugins dependencies has loop: ${Object.keys(restInRingPoints).join(',')}`);
+        throw Error(`[rsbuild:plugin] Plugins dependencies has loop: ${Object.keys(restInRingPoints).join(',')}`);
     }
     return sortedPoint;
 };
@@ -2547,7 +2550,7 @@ let onBeforeCompile = ({ compiler, beforeCompile, beforeEnvironmentCompiler, isW
         case 'report':
             return Compilation.PROCESS_ASSETS_STAGE_REPORT;
         default:
-            throw Error(`Invalid process assets stage: ${stage}`);
+            throw Error(`[rsbuild] Invalid process assets stage: ${stage}`);
     }
 }, browsersListCache = new Map();
 async function getBrowserslist(path) {
@@ -2631,7 +2634,7 @@ async function updateEnvironmentContext(context, configs) {
 async function createContext(options, userConfig, bundlerType) {
     let { cwd } = options, rootPath = userConfig.root ? getAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = (0, external_node_path_.join)(rootPath, 'node_modules', '.cache');
     return {
-        version: "1.1.5",
+        version: "1.1.7",
         rootPath,
         distPath: '',
         cachePath,
@@ -2639,6 +2642,7 @@ async function createContext(options, userConfig, bundlerType) {
         environments: {},
         hooks: {
             onExit: createAsyncHook(),
+            onCloseBuild: createAsyncHook(),
             onAfterBuild: createAsyncHook(),
             onBeforeBuild: createAsyncHook(),
             onDevCompileDone: createAsyncHook(),
@@ -2825,6 +2829,9 @@ let pluginAppIcon = ()=>({
                     infrastructureLogging: {
                         level: 'error'
                     }
+                }), chain.watchOptions({
+                    ignored: /[\\/](?:\.git|node_modules)[\\/]/,
+                    aggregateTimeout: 0
                 }), chain.performance.hints(!1), chain.module.parser.merge({
                     javascript: {
                         exportsPresence: 'error'
@@ -3010,7 +3017,7 @@ let isPostcssPluginCreator = (plugin)=>'function' == typeof plugin && !0 === plu
     if ('function' == typeof postcssOptions) {
         let postcssOptionsWrapper = (loaderContext)=>{
             let options = postcssOptions(loaderContext);
-            if ('object' != typeof options || null === options) throw Error(`\`postcssOptions\` function must return a PostCSSOptions object, got "${typeof options}".`);
+            if ('object' != typeof options || null === options) throw Error(`[rsbuild:css] \`postcssOptions\` function must return a PostCSSOptions object, got "${typeof options}".`);
             return updatePostcssOptions({
                 ...userOptions,
                 ...options,
@@ -3129,7 +3136,7 @@ let isPostcssPluginCreator = (plugin)=>'function' == typeof plugin && !0 === plu
                     preEntry.forEach(addEntry), injectCoreJsEntry && addEntry(createVirtualModule('import "core-js";')), castArray(entry[entryName]).forEach(addEntry);
                 }
             }), api.onBeforeCreateCompiler(({ bundlerConfigs })=>{
-                if (bundlerConfigs.every((config)=>!config.entry)) throw Error(`Could not find any entry module, please make sure that ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.cyan('src/index.(ts|js|tsx|jsx|mjs|cjs)')} exists, or customize entry through the ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.cyan('source.entry')} configuration.`);
+                if (bundlerConfigs.every((config)=>!config.entry)) throw Error(`[rsbuild:config] Could not find any entry module, please make sure that ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.cyan('src/index.(ts|js|tsx|jsx|mjs|cjs)')} exists, or customize entry through the ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.cyan('source.entry')} configuration.`);
             });
         }
     }), fileSize_gzip = (0, __WEBPACK_EXTERNAL_MODULE_node_util__.promisify)(__WEBPACK_EXTERNAL_MODULE_node_zlib__.default.gzip);
@@ -3203,7 +3210,7 @@ async function printFileSizes(options, stats, rootPath, environmentName) {
             gzipSizeLabel && (log += `    ${gzipSizeLabel}`), logs.push(log);
         }
     }
-    if (!1 !== options.total) {
+    if (!1 !== options.total && assets.length > 1) {
         let totalSizeLabel = `${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.blue('Total:')} ${calcFileSize(totalSize)}`, log = `\n  ${totalSizeLabel}`;
         options.compressed && (log += __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.dim(` (gzip: ${calcFileSize(totalGzipSize)})`)), log += '\n', logs.push(log);
     }
@@ -3223,7 +3230,7 @@ let pluginFileSize = ()=>({
                     ], defaultConfig = {
                         total: !0,
                         detail: !0,
-                        compressed: !0
+                        compressed: 'node' !== environment.config.output.target
                     }, mergedConfig = !0 === printFileSize ? defaultConfig : {
                         ...defaultConfig,
                         ...printFileSize
@@ -3343,9 +3350,9 @@ class RsbuildHtmlPlugin {
         let emitFavicon = async (compilation, favicon)=>{
             let name = external_node_path_.default.basename(favicon);
             if (compilation.assets[name]) return name;
-            if (!compilation.inputFileSystem) throw Error("[RsbuildHtmlPlugin] 'compilation.inputFileSystem' is not available.");
+            if (!compilation.inputFileSystem) throw Error("[rsbuild:html] 'compilation.inputFileSystem' is not available.");
             let filename = external_node_path_.default.resolve(compilation.compiler.context, favicon), buf = await (0, __WEBPACK_EXTERNAL_MODULE_node_util__.promisify)(compilation.inputFileSystem.readFile)(filename);
-            if (!buf) throw Error(`[RsbuildHtmlPlugin] Failed to read the favicon, please check if the '${filename}' file exists'.`);
+            if (!buf) throw Error(`[rsbuild:html] Failed to read the favicon, please check if the '${filename}' file exists'.`);
             let source = new compiler.webpack.sources.RawSource(buf, !1);
             return compilation.emitAsset(name, source), name;
         }, addFavicon = async (headTags, favicon, compilation, publicPath)=>{
@@ -3405,7 +3412,7 @@ async function getTemplate(entryName, config, rootPath) {
     };
     let absolutePath = (0, external_node_path_.isAbsolute)(templatePath) ? templatePath : external_node_path_.default.resolve(rootPath, templatePath);
     if (!existTemplatePath.has(absolutePath)) {
-        if (!await isFileExists(absolutePath)) throw Error(`Failed to resolve HTML template, please check if the file exists: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.cyan(absolutePath)}`);
+        if (!await isFileExists(absolutePath)) throw Error(`[rsbuild:html] Failed to resolve HTML template, please check if the file exists: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.cyan(absolutePath)}`);
         existTemplatePath.add(absolutePath);
     }
     let templateContent = await external_node_fs_.default.promises.readFile(absolutePath, 'utf-8');
@@ -3707,13 +3714,14 @@ let generateManifest = (htmlPaths)=>(_seed, files)=>{
     }, pluginManifest = ()=>({
         name: 'rsbuild:manifest',
         setup (api) {
-            api.modifyBundlerChain(async (chain, { CHAIN_ID, environment })=>{
-                let { output: { manifest } } = environment.config;
+            api.modifyBundlerChain(async (chain, { CHAIN_ID, environment, isDev })=>{
+                let { output: { manifest }, dev: { writeToDisk } } = environment.config;
                 if (!1 === manifest) return;
                 let { RspackManifestPlugin } = await import("../compiled/rspack-manifest-plugin/index.js"), { htmlPaths } = environment;
                 chain.plugin(CHAIN_ID.PLUGIN.MANIFEST).use(RspackManifestPlugin, [
                     {
                         fileName: 'string' == typeof manifest ? manifest : 'manifest.json',
+                        writeToFileEmit: isDev && !0 !== writeToDisk,
                         generate: generateManifest(htmlPaths)
                     }
                 ]);
@@ -3845,7 +3853,7 @@ let pluginMoment = ()=>({
                 raw: !0
             }, ({ code, emitFile, resourcePath })=>{
                 let name = nodeAddons_getFilename(resourcePath);
-                if (null === name) throw Error(`Failed to load Node.js addon: "${resourcePath}"`);
+                if (null === name) throw Error(`[rsbuild:node-addons] Failed to load Node.js addon: "${resourcePath}"`);
                 return emitFile(name, code), `
 try {
 const path = require("path");
@@ -3921,7 +3929,7 @@ function printServerURLs({ urls: originalUrls, port, routes, protocol, printUrls
             protocol
         });
         if (!newUrls) return null;
-        if (!Array.isArray(newUrls)) throw Error(`"server.printUrls" must return an array, but got ${typeof newUrls}.`);
+        if (!Array.isArray(newUrls)) throw Error(`[rsbuild:config] "server.printUrls" must return an array, but got ${typeof newUrls}.`);
         urls = newUrls.map((url)=>({
                 url,
                 label: getUrlLabel(url)
@@ -3960,7 +3968,7 @@ let getPort = async ({ host, port, strictPort, tryLimits = 20 })=>{
         if ('EADDRINUSE' !== e.code) throw e;
         port++, attempts++;
     }
-    if (port !== original && strictPort) throw Error(`Port "${original}" is occupied, please choose another one.`);
+    if (port !== original && strictPort) throw Error(`[rsbuild:server] Port "${original}" is occupied, please choose another one.`);
     return port;
 }, getServerConfig = async ({ config })=>{
     let host = config.server.host || DEFAULT_DEV_HOST, originalPort = config.server.port || 3000, port = await getPort({
@@ -4201,7 +4209,7 @@ let getJsAsyncPath = (jsPath, isServer, jsAsync)=>void 0 !== jsAsync ? jsAsync :
                 ]);
             });
         }
-    }), pluginResolve = ()=>({
+    }), resolve_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module__.createRequire)(import.meta.url), pluginResolve = ()=>({
         name: 'rsbuild:resolve',
         setup (api) {
             api.modifyBundlerChain({
@@ -4231,12 +4239,43 @@ let getJsAsyncPath = (jsPath, isServer, jsAsync)=>void 0 !== jsAsync ? jsAsync :
                         chain,
                         tsconfigPath
                     }), !function({ chain, config, rootPath }) {
-                        let { alias } = config.source;
-                        if (!alias) return;
-                        let mergedAlias = reduceConfigs({
+                        let mergedSourceAlias = config.source.alias ? reduceConfigs({
                             initial: {},
-                            config: alias
-                        });
+                            config: config.source.alias
+                        }) : {}, mergedResolveAlias = config.resolve.alias ? reduceConfigs({
+                            initial: {},
+                            config: config.resolve.alias
+                        }) : {}, mergedAlias = {
+                            ...mergedSourceAlias,
+                            ...mergedResolveAlias
+                        };
+                        if (config.resolve.dedupe) for (let pkgName of config.resolve.dedupe){
+                            let pkgPath;
+                            if (mergedAlias[pkgName]) {
+                                __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.debug(`[rsbuild:resolve] The package "${pkgName}" is already in the alias config, dedupe option for "${pkgName}" will be ignored.`);
+                                continue;
+                            }
+                            try {
+                                pkgPath = (0, external_node_path_.dirname)(resolve_require.resolve(`${pkgName}/package.json`, {
+                                    paths: [
+                                        rootPath
+                                    ]
+                                }));
+                            } catch (e) {}
+                            if (!pkgPath) try {
+                                pkgPath = resolve_require.resolve(pkgName, {
+                                    paths: [
+                                        rootPath
+                                    ]
+                                });
+                                let trailing = '/' === external_node_path_.sep ? pkgName : pkgName.split('/').join(external_node_path_.sep);
+                                for(; !pkgPath.endsWith(trailing) && pkgPath.includes('node_modules');)pkgPath = (0, external_node_path_.dirname)(pkgPath);
+                            } catch (e) {
+                                __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.debug(`[rsbuild:resolve] The package "${pkgName}" is not resolved in the project, dedupe option for "${pkgName}" will be ignored.`);
+                                continue;
+                            }
+                            mergedAlias[pkgName] = pkgPath;
+                        }
                         for (let name of Object.keys(mergedAlias)){
                             let formattedValues = castArray(mergedAlias[name]).map((value)=>'string' == typeof value && value.startsWith('.') ? ensureAbsolutePath(rootPath, value) : value);
                             chain.resolve.alias.set(name, 1 === formattedValues.length ? formattedValues[0] : formattedValues);
@@ -4251,7 +4290,9 @@ let getJsAsyncPath = (jsPath, isServer, jsAsync)=>void 0 !== jsAsync ? jsAsync :
                         chain,
                         config,
                         CHAIN_ID
-                    }), tsconfigPath && 'rspack' === api.context.bundlerType && 'prefer-tsconfig' === config.source.aliasStrategy && chain.resolve.tsConfig({
+                    });
+                    let aliasStrategy = config.source.aliasStrategy ?? config.resolve.aliasStrategy;
+                    tsconfigPath && 'rspack' === api.context.bundlerType && 'prefer-tsconfig' === aliasStrategy && chain.resolve.tsConfig({
                         configFile: tsconfigPath,
                         references: 'auto'
                     });
@@ -4778,7 +4819,7 @@ let resourceHints_generateLinks = (options, rel)=>options.map((option)=>({
                                 swcConfig.jsc.transform.legacyDecorator = !1, swcConfig.jsc.transform.decoratorVersion = '2022-03';
                                 break;
                             default:
-                                throw Error(`Unknown decorators version: ${version}`);
+                                throw Error(`[rsbuild:swc] Unknown decorators version: ${version}`);
                         }
                     }(swcConfig, config), castArray(target1 = target).includes('web') || target1.includes('web-worker')) {
                         let polyfillMode = config.output.polyfill;
@@ -5080,7 +5121,7 @@ async function generateRspackConfig({ target, context, environment }) {
     if ((rspackConfig = await modifyRspackConfig(context, rspackConfig, await getConfigUtils(rspackConfig, chainUtils))).plugins) {
         for (let plugin of rspackConfig.plugins)if (plugin && void 0 === plugin.apply && 'name' in plugin && 'setup' in plugin) {
             let name = __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.bold(__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(plugin.name));
-            throw Error(`${name} appears to be an Rsbuild plugin. It cannot be used as an Rspack plugin.`);
+            throw Error(`[rsbuild:plugin] "${name}" appears to be an Rsbuild plugin. It cannot be used as an Rspack plugin.`);
         }
     }
     return rspackConfig;
@@ -5141,11 +5182,11 @@ let initEnvironmentConfigs = (normalizedConfig, rootPath, specifiedEnvironments)
                     }, config)
                 })
             ]));
-        if (!Object.keys(resolvedEnvironments).length) throw Error(`The current build is specified to run only in the ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(null == specifiedEnvironments ? void 0 : specifiedEnvironments.join(','))} environment, but the configuration of the specified environment was not found.`);
+        if (!Object.keys(resolvedEnvironments).length) throw Error(`[rsbuild:config] The current build is specified to run only in the ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(null == specifiedEnvironments ? void 0 : specifiedEnvironments.join(','))} environment, but the configuration of the specified environment was not found.`);
         return resolvedEnvironments;
     }
     let defaultEnvironmentName = camelCase(rsbuildSharedConfig.output.target);
-    if (!isEnvironmentEnabled(defaultEnvironmentName)) throw Error(`The current build is specified to run only in the ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(null == specifiedEnvironments ? void 0 : specifiedEnvironments.join(','))} environment, but the configuration of the specified environment was not found.`);
+    if (!isEnvironmentEnabled(defaultEnvironmentName)) throw Error(`[rsbuild:config] The current build is specified to run only in the ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(null == specifiedEnvironments ? void 0 : specifiedEnvironments.join(','))} environment, but the configuration of the specified environment was not found.`);
     return {
         [defaultEnvironmentName]: applyEnvironmentDefaultConfig({
             ...rsbuildSharedConfig,
@@ -5264,7 +5305,7 @@ function setupCliShortcuts({ help = !0, openPage, closeServer, printUrls, restar
             action: printUrls
         }
     ].filter(Boolean);
-    if (customShortcuts && !Array.isArray(shortcuts = customShortcuts(shortcuts))) throw Error('`dev.cliShortcuts` must return an array of shortcuts.');
+    if (customShortcuts && !Array.isArray(shortcuts = customShortcuts(shortcuts))) throw Error('[rsbuild:config] `dev.cliShortcuts` must return an array of shortcuts.');
     help && __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.log(`  ➜ ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.dim('press')} ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.bold('h + enter')} ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.dim('to show shortcuts')}\n`);
     let rl = __WEBPACK_EXTERNAL_MODULE_node_readline__.default.createInterface({
         input: process.stdin
@@ -5588,7 +5629,7 @@ class BasicRunner {
     postExecute(_m, _file) {}
     createRunner() {
         this.requirers.set('entry', (_currentDirectory, _modulePath, _context = {})=>{
-            throw Error('Not implement');
+            throw Error('[rsbuild:runner] Not implement');
         });
     }
     constructor(_options){
@@ -5675,7 +5716,7 @@ class EsmRunner extends CommonJsRunner {
             name: 'context for esm'
         }), esmCache = new Map(), esmIdentifier = this._options.name;
         return (currentDirectory, modulePath, context = {})=>{
-            if (!__WEBPACK_EXTERNAL_MODULE_node_vm__.default.SourceTextModule) throw Error("Running esm bundle needs add Node.js option '--experimental-vm-modules'.");
+            if (!__WEBPACK_EXTERNAL_MODULE_node_vm__.default.SourceTextModule) throw Error('[rsbuild:runner] Running ESM bundle needs add Node.js option "--experimental-vm-modules".');
             let _require = this.getRequire(), file = context.file || this.getFile(modulePath, currentDirectory);
             if (!file) return this.requirers.get('miss')(currentDirectory, modulePath);
             let esm = esmCache.get(file.path);
@@ -5713,7 +5754,7 @@ class BasicRunnerFactory {
             compilerOptions,
             readFileSync
         };
-        if ('web' === compilerOptions.target || 'webworker' === compilerOptions.target) throw Error(`not support run ${compilerOptions.target} resource in rsbuild server`);
+        if ('web' === compilerOptions.target || 'webworker' === compilerOptions.target) throw Error(`[rsbuild:runner] Not support run "${compilerOptions.target}" resource in Rsbuild server`);
         return new EsmRunner(runnerOptions);
     }
     constructor(name){
@@ -5733,7 +5774,7 @@ let run = async (bundlePath, outputPath, compilerOptions, readFileSync)=>new Bas
         entrypoints: !0,
         outputPath: !0
     });
-    if (!(null == entrypoints ? void 0 : entrypoints[entryName])) throw Error(`can't find entry(${entryName})`);
+    if (!(null == entrypoints ? void 0 : entrypoints[entryName])) throw Error(`[rsbuild:loadBundle] Can't find entry: "${entryName}"`);
     let { chunks: entryChunks = [] } = entrypoints[entryName], files = entryChunks.reduce((prev, entryChunkName)=>{
         let chunk = null == chunks ? void 0 : chunks.find((chunk)=>{
             var _chunk_names;
@@ -5741,12 +5782,12 @@ let run = async (bundlePath, outputPath, compilerOptions, readFileSync)=>new Bas
         });
         return (null == chunk ? void 0 : chunk.files) ? prev.concat(chunk.files.filter((file)=>!file.endsWith('.css'))) : prev;
     }, []);
-    if (0 === files.length) throw Error(`can't get bundle by entryName(${entryName})`);
-    if (files.length > 1) throw Error(`only support load single entry chunk, but got ${files.length}: ${files.join(',')}`);
+    if (0 === files.length) throw Error(`[rsbuild:loadBundle] Failed to get bundle by entryName: "${entryName}"`);
+    if (files.length > 1) throw Error(`[rsbuild:loadBundle] Only support load single entry chunk, but got ${files.length}: ${files.join(',')}`);
     return await run(files[0], outputPath, stats.compilation.options, utils.readFileSync);
 }, getTransformedHtml = async (entryName, utils)=>{
     let { htmlPaths, distPath } = utils.environment, htmlPath = htmlPaths[entryName];
-    if (!htmlPath) throw Error(`can't get html file by entryName(${entryName})`);
+    if (!htmlPath) throw Error(`[rsbuild:getTransformedHtml] Failed to get HTML file by entryName: "${entryName}"`);
     let fileName = (0, external_node_path_.join)(distPath, htmlPath);
     return utils.readFileSync(fileName);
 }, ENCODING_REGEX = /\bgzip\b/, CONTENT_TYPE_REGEX = /text|javascript|\/json|xml/i, shouldCompress = (res)=>{
@@ -6056,7 +6097,7 @@ async function devServer_createDevServer(options, createCompiler, config, { comp
         });
     }) : Promise.resolve(), startCompile = async ()=>{
         let compiler = customCompiler || await createCompiler();
-        if (!compiler) throw Error('Failed to get compiler instance.');
+        if (!compiler) throw Error('[rsbuild:server] Failed to get compiler instance.');
         let publicPaths = isMultiCompiler(compiler) ? compiler.compilers.map(getPublicPathFromCompiler) : [
             getPublicPathFromCompiler(compiler)
         ], compilerDevMiddleware = new CompilerDevMiddleware({
@@ -6124,7 +6165,7 @@ async function devServer_createDevServer(options, createCompiler, config, { comp
             name,
             {
                 getStats: async ()=>{
-                    if (!runCompile) throw Error("can't get stats info when runCompile is false");
+                    if (!runCompile) throw Error('[rsbuild:server] Can not get stats info when "runCompile" is false');
                     return await waitFirstCompileDone, lastStats[environment.index];
                 },
                 loadBundle: async (entryName)=>(await waitFirstCompileDone, loadBundle(lastStats[environment.index], entryName, {
@@ -6196,7 +6237,7 @@ async function createCompiler_createCompiler(options) {
     if (await context.hooks.onBeforeCreateCompiler.call({
         bundlerConfigs: rspackConfigs,
         environments: context.environments
-    }), !await isSatisfyRspackVersion(__WEBPACK_EXTERNAL_MODULE__rspack_core__.rspack.rspackVersion)) throw Error(`The current Rspack version does not meet the requirements, the minimum supported version of Rspack is ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.green(rspackMinVersion)}`);
+    }), !await isSatisfyRspackVersion(__WEBPACK_EXTERNAL_MODULE__rspack_core__.rspack.rspackVersion)) throw Error(`[rsbuild] The current Rspack version does not meet the requirements, the minimum supported version of Rspack is ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.green(rspackMinVersion)}`);
     let compiler = 1 === rspackConfigs.length ? (0, __WEBPACK_EXTERNAL_MODULE__rspack_core__.rspack)(rspackConfigs[0]) : (0, __WEBPACK_EXTERNAL_MODULE__rspack_core__.rspack)(rspackConfigs), isVersionLogged = !1, isCompiling = !1, logRspackVersion = ()=>{
         !isVersionLogged && (__WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.debug(`Use Rspack v${__WEBPACK_EXTERNAL_MODULE__rspack_core__.rspack.rspackVersion}`), isVersionLogged = !0);
     };
@@ -6274,11 +6315,7 @@ let build_build = async (initOptions, { watch, compiler: customCompiler } = {})=
     });
     return {
         stats,
-        close: ()=>new Promise((resolve)=>{
-                compiler.close(()=>{
-                    resolve();
-                });
-            })
+        close: async ()=>{}
     };
 }, rspackProvider = async ({ context, pluginManager, rsbuildOptions })=>{
     let createCompiler = async ()=>(await createCompiler_createCompiler({
@@ -6576,7 +6613,7 @@ async function createRsbuild(options = {}) {
             for (let newPlugin of newPlugins){
                 if (!!newPlugin) if (!function(plugin) {
                     let type = typeof plugin;
-                    if ('object' !== type || null === plugin) throw Error(`Expect Rsbuild plugin instance to be an object, but got ${type}.`);
+                    if ('object' !== type || null === plugin) throw Error(`[rsbuild:plugin] Expect Rsbuild plugin instance to be an object, but got ${type}.`);
                     if (!isFunction(plugin.setup)) {
                         if (isFunction(plugin.apply)) {
                             let { name = 'SomeWebpackPlugin' } = plugin.constructor || {};
@@ -6594,7 +6631,7 @@ async function createRsbuild(options = {}) {
 `)
                             ].join('\n'));
                         }
-                        throw Error(`Expect Rsbuild plugin.setup to be a function, but got ${type}.`);
+                        throw Error(`[rsbuild:plugin] Expect the setup function of Rsbuild plugin to be a function, but got ${type}.`);
                     }
                 }(newPlugin), before) {
                     let index = plugins.findIndex((item)=>item.instance.name === before);
@@ -6638,12 +6675,12 @@ async function createRsbuild(options = {}) {
             if (context.normalizedConfig) {
                 if (null == options ? void 0 : options.environment) {
                     let config = context.normalizedConfig.environments[options.environment];
-                    if (!config) throw Error(`Cannot find normalized config by environment: ${options.environment}.`);
+                    if (!config) throw Error(`[rsbuild] Cannot find normalized config by environment: ${options.environment}.`);
                     return config;
                 }
                 return context.normalizedConfig;
             }
-            throw Error('Cannot access normalized config until modifyRsbuildConfig is called.');
+            throw Error('[rsbuild] Cannot access normalized config until modifyRsbuildConfig is called.');
         }
         let getRsbuildConfig = (type = 'current')=>{
             switch(type){
@@ -6654,7 +6691,7 @@ async function createRsbuild(options = {}) {
                 case 'normalized':
                     return getNormalizedConfig();
             }
-            throw Error('`getRsbuildConfig` get an invalid type param.');
+            throw Error('[rsbuild] `getRsbuildConfig` get an invalid type param.');
         }, exposed = [], expose = (id, api)=>{
             exposed.push({
                 id,
@@ -6744,6 +6781,7 @@ async function createRsbuild(options = {}) {
                 isPluginExists: pluginManager.isPluginExists,
                 onExit,
                 onAfterBuild: hooks.onAfterBuild.tap,
+                onCloseBuild: hooks.onCloseBuild.tap,
                 onBeforeBuild: hooks.onBeforeBuild.tap,
                 onCloseDevServer: hooks.onCloseDevServer.tap,
                 onDevCompileDone: hooks.onDevCompileDone.tap,
@@ -6806,15 +6844,24 @@ async function createRsbuild(options = {}) {
             pluginManager
         }), { distPath } = context, { checkDistDir = !0 } = options;
         if (checkDistDir) {
-            if (!(0, external_node_fs_.existsSync)(distPath)) throw Error(`The output directory ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(distPath)} does not exist, please build the project before previewing.`);
+            if (!(0, external_node_fs_.existsSync)(distPath)) throw Error(`[rsbuild:preview] The output directory ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(distPath)} does not exist, please build the project before previewing.`);
             if (function(path) {
                 let files = external_node_fs_.default.readdirSync(path);
                 return 0 === files.length || 1 === files.length && '.git' === files[0];
-            }(distPath)) throw Error(`The output directory ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(distPath)} is empty, please build the project before previewing.`);
+            }(distPath)) throw Error(`[rsbuild:preview] The output directory ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js__.default.yellow(distPath)} is empty, please build the project before previewing.`);
         }
         return startProdServer(context, config, options);
+    }, build = async (...args)=>{
+        !getNodeEnv() && setNodeEnv('production');
+        let buildInstance = await providerInstance.build(...args);
+        return {
+            ...buildInstance,
+            close: async ()=>{
+                await context.hooks.onCloseBuild.call(), await buildInstance.close();
+            }
+        };
     }, rsbuild = {
-        build: (...args)=>(!getNodeEnv() && setNodeEnv('production'), providerInstance.build(...args)),
+        build,
         preview,
         startDevServer: (...args)=>(!getNodeEnv() && setNodeEnv('development'), providerInstance.startDevServer(...args)),
         createDevServer: (...args)=>(!getNodeEnv() && setNodeEnv('development'), providerInstance.createDevServer(...args)),
@@ -6826,6 +6873,7 @@ async function createRsbuild(options = {}) {
         ]),
         ...pick(globalPluginAPI, [
             'context',
+            'onCloseBuild',
             'onBeforeBuild',
             'onBeforeCreateCompiler',
             'onBeforeStartDevServer',
@@ -6880,13 +6928,13 @@ async function runCLI() {
                     'preview'
                 ].includes(command) ? 'production' : 'development';
             }
-        }();
+        }(), process.title = 'rsbuild-node';
         let { npm_execpath } = process.env;
-        (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.greet(`  Rsbuild v1.1.5\n`);
+        (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.greet(`  Rsbuild v1.1.7\n`);
     }();
     try {
         !function() {
-            program.name('rsbuild').usage('<command> [options]').version("1.1.5");
+            program.name('rsbuild').usage('<command> [options]').version("1.1.7");
             let devCommand = program.command('dev'), buildCommand = program.command('build'), previewCommand = program.command('preview'), inspectCommand = program.command('inspect');
             [
                 devCommand,
@@ -6913,7 +6961,7 @@ async function runCLI() {
                     }), buildInstance = await (null == rsbuild ? void 0 : rsbuild.build({
                         watch: options.watch
                     }));
-                    options.watch && buildInstance && onBeforeRestartServer(buildInstance.close);
+                    buildInstance && (options.watch ? onBeforeRestartServer(buildInstance.close) : await buildInstance.close());
                 } catch (err) {
                     __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.error('Failed to build.'), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.error(err), process.exit(1);
                 }
@@ -6945,6 +6993,6 @@ async function runCLI() {
         __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.error('Failed to start Rsbuild CLI.'), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger.error(err);
     }
 }
-let src_version = "1.1.5";
+let src_version = "1.1.7";
 var __webpack_exports__logger = __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js__.logger, __webpack_exports__rspack = __WEBPACK_EXTERNAL_MODULE__rspack_core__.rspack;
 export { PLUGIN_CSS_NAME, PLUGIN_SWC_NAME, internal_namespaceObject as __internalHelper, createRsbuild, defineConfig, ensureAssetPrefix, config_loadConfig as loadConfig, loadEnv, mergeRsbuildConfig, runCLI, src_version as version, __webpack_exports__logger as logger, __webpack_exports__rspack as rspack };

package/dist-types/hooks.d.ts

@@ -1,10 +1,11 @@
-import type { AsyncHook, EnvironmentAsyncHook, InternalContext, ModifyBundlerChainFn, ModifyEnvironmentConfigFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRspackConfigFn, ModifyWebpackChainFn, ModifyWebpackConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompile, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, Rspack } from './types';
+import type { AsyncHook, EnvironmentAsyncHook, InternalContext, ModifyBundlerChainFn, ModifyEnvironmentConfigFn, ModifyHTMLTagsFn, ModifyRsbuildConfigFn, ModifyRspackConfigFn, ModifyWebpackChainFn, ModifyWebpackConfigFn, OnAfterBuildFn, OnAfterCreateCompilerFn, OnAfterEnvironmentCompileFn, OnAfterStartDevServerFn, OnAfterStartProdServerFn, OnBeforeBuildFn, OnBeforeCreateCompilerFn, OnBeforeEnvironmentCompile, OnBeforeStartDevServerFn, OnBeforeStartProdServerFn, OnCloseBuildFn, OnCloseDevServerFn, OnDevCompileDoneFn, OnExitFn, Rspack } from './types';
 export declare function createEnvironmentAsyncHook<Callback extends (...args: any[]) => any>(): EnvironmentAsyncHook<Callback>;
 export declare function createAsyncHook<Callback extends (...args: any[]) => any>(): AsyncHook<Callback>;
 export declare function initHooks(): {
     /** The following hooks are global hooks */
     onExit: AsyncHook<OnExitFn>;
     onAfterBuild: AsyncHook<OnAfterBuildFn>;
+    onCloseBuild: AsyncHook<OnCloseBuildFn>;
     onBeforeBuild: AsyncHook<OnBeforeBuildFn>;
     onDevCompileDone: AsyncHook<OnDevCompileDoneFn>;
     onCloseDevServer: AsyncHook<OnCloseDevServerFn>;

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

@@ -98,13 +98,13 @@ export type Decorators = {
 };
 export interface SourceConfig {
     /**
-     * Create aliases to import or require certain modules,
-     * same as the [resolve.alias](https://rspack.dev/config/resolve) config of Rspack.
+     * @deprecated Use `resolve.alias` instead.
+     * `source.alias` will be removed in v2.0.0.
      */
     alias?: ConfigChain<Alias>;
     /**
-     * Used to control the priority between the `paths` option in `tsconfig.json`
-     * and the `alias` option in the bundler.
+     * @deprecated Use `resolve.aliasStrategy` instead.
+     * `source.aliasStrategy` will be removed in v2.0.0.
      */
     aliasStrategy?: AliasStrategy;
     /**
@@ -163,8 +163,11 @@ export type TransformImport = {
 type TransformImportFn = (imports: TransformImport[]) => TransformImport[] | void;
 export interface NormalizedSourceConfig extends SourceConfig {
     define: Define;
+    /**
+     * @deprecated Use `resolve.alias` instead.
+     * `source.alias` will be removed in v2.0.0.
+     */
     alias: ConfigChain<Alias>;
-    aliasStrategy: AliasStrategy;
     preEntry: string[];
     decorators: Required<Decorators>;
 }
@@ -1141,6 +1144,25 @@ export interface DevConfig {
 export type NormalizedDevConfig = DevConfig & Required<Pick<DevConfig, 'hmr' | 'liveReload' | 'assetPrefix' | 'writeToDisk' | 'cliShortcuts'>> & {
     client: NormalizedClientConfig;
 };
+export interface ResolveConfig {
+    /**
+     * Force Rsbuild to resolve the specified packages from project root,
+     * which is useful for deduplicating packages and reducing the bundle size.
+     */
+    dedupe?: string[];
+    /**
+     * Create aliases to import or require certain modules,
+     * same as the [resolve.alias](https://rspack.dev/config/resolve) config of Rspack.
+     */
+    alias?: ConfigChain<Alias>;
+    /**
+     * Control the priority between the `paths` option in `tsconfig.json`
+     * and the `resolve.alias` option of Rsbuild.
+     * @default 'prefer-tsconfig'
+     */
+    aliasStrategy?: AliasStrategy;
+}
+export type NormalizedResolveConfig = ResolveConfig & Pick<Required<ResolveConfig>, 'alias' | 'aliasStrategy'>;
 export type ModuleFederationConfig = {
     options: ModuleFederationPluginOptions;
 };
@@ -1168,7 +1190,11 @@ export interface EnvironmentConfig {
      */
     tools?: ToolsConfig;
     /**
-     * Options for source code parsing and compilation.
+     * Options for module resolution.
+     */
+    resolve?: ResolveConfig;
+    /**
+     * Options for input source code.
      */
     source?: SourceConfig;
     /**
@@ -1235,6 +1261,7 @@ export type MergedEnvironmentConfig = {
     dev: Pick<NormalizedDevConfig, 'hmr' | 'assetPrefix' | 'progressBar' | 'lazyCompilation' | 'writeToDisk'>;
     html: NormalizedHtmlConfig;
     tools: NormalizedToolsConfig;
+    resolve: NormalizedResolveConfig;
     source: NormalizedSourceConfig;
     output: Omit<NormalizedOutputConfig, 'distPath'> & {
         distPath: Omit<Required<DistPathConfig>, 'jsAsync' | 'cssAsync'> & {

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

@@ -13,6 +13,7 @@ export type OnBeforeEnvironmentCompile<B = 'rspack'> = (params: CompileCommonPar
     environment: EnvironmentContext;
     bundlerConfig?: B extends 'rspack' ? Rspack.Configuration : WebpackConfig;
 }) => MaybePromise<void>;
+export type OnCloseBuildFn = () => MaybePromise<void>;
 export type OnBeforeBuildFn<B = 'rspack'> = (params: CompileCommonParams & {
     environments: Record<string, EnvironmentContext>;
     bundlerConfigs?: B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[];