@rsbuild/core 1.3.20 → 1.3.21

package/dist/index.js

@@ -7,17 +7,17 @@ import * as __WEBPACK_EXTERNAL_MODULE_path__ from "path";
 import * as __WEBPACK_EXTERNAL_MODULE__rspack_core_e0096ff7__ from "@rspack/core";
 import * as __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__ from "node:fs";
 import * as __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__ from "node:path";
+import * as __WEBPACK_EXTERNAL_MODULE_node_crypto_9ba42079__ from "node:crypto";
 import * as __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__ from "node:url";
 import * as __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__ from "../compiled/picocolors/index.js";
 import * as __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__ from "../compiled/rslog/index.js";
 import * as __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__ from "node:util/types";
 import * as __WEBPACK_EXTERNAL_MODULE_node_module_ab9f2194__ from "node:module";
-import * as __WEBPACK_EXTERNAL_MODULE__compiled_rspack_chain_index_js_b67fefbd__ from "../compiled/rspack-chain/index.js";
 import * as __WEBPACK_EXTERNAL_MODULE_node_os_74b4b876__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_process_786449bf__ from "node:process";
 import * as __WEBPACK_EXTERNAL_MODULE_node_util_1b29d436__ from "node:util";
 import * as __WEBPACK_EXTERNAL_MODULE__compiled_mrmime_index_js_86f064ca__ from "../compiled/mrmime/index.js";
-import * as __WEBPACK_EXTERNAL_MODULE_node_crypto_9ba42079__ from "node:crypto";
+import * as __WEBPACK_EXTERNAL_MODULE__compiled_rspack_chain_index_js_b67fefbd__ from "../compiled/rspack-chain/index.js";
 import * as __WEBPACK_EXTERNAL_MODULE_node_zlib_a5bb16fc__ from "node:zlib";
 import * as __WEBPACK_EXTERNAL_MODULE_node_child_process_27f17141__ from "node:child_process";
 import * as __WEBPACK_EXTERNAL_MODULE_node_net_0373943e__ from "node:net";
@@ -929,17 +929,15 @@ __webpack_require__.r(provider_helpers_namespaceObject), __webpack_require__.d(p
     getChainUtils: ()=>getChainUtils,
     getConfigUtils: ()=>getConfigUtils,
     getHTMLPlugin: ()=>getHTMLPlugin,
-    getRsbuildInspectConfig: ()=>getRsbuildInspectConfig,
     getStatsOptions: ()=>getStatsOptions,
     initRsbuildConfig: ()=>initRsbuildConfig,
+    inspectConfig: ()=>inspectConfig,
     modifyBundlerChain: ()=>modifyBundlerChain,
-    outputInspectConfigFiles: ()=>outputInspectConfigFiles,
     prettyTime: ()=>prettyTime,
     registerBuildHook: ()=>registerBuildHook,
     registerDevHook: ()=>registerDevHook,
     setCssExtractPlugin: ()=>setCssExtractPlugin,
-    setHTMLPlugin: ()=>setHTMLPlugin,
-    stringifyConfig: ()=>stringifyConfig
+    setHTMLPlugin: ()=>setHTMLPlugin
 });
 var main = __webpack_require__("../../node_modules/.pnpm/dotenv@16.5.0/node_modules/dotenv/lib/main.js"), lib_main = __webpack_require__("../../node_modules/.pnpm/dotenv-expand@12.0.2/node_modules/dotenv-expand/lib/main.js"), cjs = __webpack_require__("../../node_modules/.pnpm/deepmerge@4.3.1/node_modules/deepmerge/dist/cjs.js"), cjs_default = __webpack_require__.n(cjs);
 let constants_filename = (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.fileURLToPath)(import.meta.url), constants_dirname = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(constants_filename), ROOT_DIST_DIR = 'dist', LOADER_PATH = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(constants_dirname), STATIC_PATH = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(constants_dirname, '../static'), COMPILED_PATH = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(constants_dirname, '../compiled'), RSBUILD_OUTPUTS_PATH = '.rsbuild', DEFAULT_DEV_HOST = '0.0.0.0', DEFAULT_ASSET_PREFIX = '/', DEFAULT_WEB_BROWSERSLIST = [
@@ -997,9 +995,6 @@ let constants_filename = (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.fileU
         '*'
     ].some((key)=>values.includes(key));
 };
-function getAbsolutePath(base, filepath) {
-    return (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.isAbsolute)(filepath) ? filepath : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(base, filepath);
-}
 isDebug() && (__WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.level = 'verbose'), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.override({
     debug: (message, ...args)=>{
         if ('verbose' !== __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.level) return;
@@ -1010,7 +1005,7 @@ isDebug() && (__WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logg
         console.log(`  ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.magenta('rsbuild')} ${time} ${message}`, ...args);
     }
 });
-let getCompiledPath = (packageName)=>(0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(COMPILED_PATH, packageName, 'index.js'), ensureAbsolutePath = (base, filePath)=>(0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.isAbsolute)(filePath) ? filePath : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.resolve)(base, filePath), pathnameParse = (publicPath)=>{
+let getCompiledPath = (packageName)=>(0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(COMPILED_PATH, packageName, 'index.js'), ensureAbsolutePath = (base, filePath)=>(0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.isAbsolute)(filePath) ? filePath : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(base, filePath), getPathnameFromUrl = (publicPath)=>{
     try {
         return publicPath ? new URL(publicPath).pathname : publicPath;
     } catch (err) {
@@ -1227,7 +1222,7 @@ function formatStats(statsData, hasErrors) {
     }
     return {};
 }
-let rspackMinVersion = '1.0.0', getNodeEnv = ()=>process.env.NODE_ENV, setNodeEnv = (env)=>{
+let rspackMinVersion = '1.2.4', getNodeEnv = ()=>process.env.NODE_ENV, setNodeEnv = (env)=>{
     process.env.NODE_ENV = env;
 }, isFunction = (func)=>'function' == typeof func, isObject = (obj)=>'[object Object]' === Object.prototype.toString.call(obj), isPlainObject = (obj)=>null !== obj && 'object' == typeof obj && Object.getPrototypeOf(obj) === Object.prototype, castArray = (arr)=>void 0 === arr ? [] : Array.isArray(arr) ? arr : [
         arr
@@ -1445,6 +1440,7 @@ let configCache = {}, OVERRIDE_PATHS = [
 }, mergeRsbuildConfig = (...configs)=>2 === configs.length ? merge(configs[0], configs[1]) : configs.length < 2 ? configs[0] : configs.reduce((result, config)=>merge(result, config), {}), config_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module_ab9f2194__.createRequire)(import.meta.url), getDefaultDevConfig = ()=>({
         hmr: !0,
         liveReload: !0,
+        watchFiles: [],
         assetPrefix: DEFAULT_ASSET_PREFIX,
         writeToDisk: !1,
         cliShortcuts: !1,
@@ -1583,14 +1579,19 @@ let configCache = {}, OVERRIDE_PATHS = [
         await isFileExists(tsconfigPath) && (merged.source.tsconfigPath = tsconfigPath);
     }
     return merged;
-}, normalizeConfig = (config)=>mergeRsbuildConfig({
+}, normalizeConfig = (config)=>{
+    let mergedConfig = mergeRsbuildConfig({
         ...createDefaultConfig(),
         mode: (()=>{
             if (config.mode) return config.mode;
             let nodeEnv = getNodeEnv();
             return 'production' === nodeEnv || 'development' === nodeEnv ? nodeEnv : 'none';
         })()
-    }, config);
+    }, config), { watchFiles } = mergedConfig.dev;
+    return Array.isArray(watchFiles) || (mergedConfig.dev.watchFiles = [
+        watchFiles
+    ]), mergedConfig;
+};
 function defineConfig(config) {
     return config;
 }
@@ -1665,71 +1666,6 @@ async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta, loa
         filePath: configFilePath
     };
 }
-let normalizePluginObject = (plugin)=>{
-    let { setup: _, ...rest } = plugin;
-    return {
-        ...rest,
-        setup () {}
-    };
-}, getRsbuildInspectConfig = ({ normalizedConfig, inspectOptions, pluginManager })=>{
-    let { environments, ...rsbuildConfig } = normalizedConfig, rawRsbuildConfig = stringifyConfig({
-        ...rsbuildConfig,
-        plugins: pluginManager.getPlugins().map(normalizePluginObject)
-    }, inspectOptions.verbose), environmentConfigs = {}, rawEnvironmentConfigs = [];
-    for (let [name, config] of Object.entries(environments)){
-        let debugConfig = {
-            ...config,
-            plugins: pluginManager.getPlugins({
-                environment: name
-            }).map(normalizePluginObject)
-        };
-        rawEnvironmentConfigs.push({
-            name,
-            content: stringifyConfig(debugConfig, inspectOptions.verbose)
-        }), environmentConfigs[name] = debugConfig;
-    }
-    return {
-        rsbuildConfig,
-        rawRsbuildConfig,
-        environmentConfigs: environments,
-        rawEnvironmentConfigs
-    };
-};
-async function outputInspectConfigFiles({ rawBundlerConfigs, rawEnvironmentConfigs, inspectOptions, configType }) {
-    let { outputPath } = inspectOptions, files = [
-        ...rawEnvironmentConfigs.map(({ name, content })=>{
-            if (1 === rawEnvironmentConfigs.length) return {
-                path: (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(outputPath, 'rsbuild.config.mjs'),
-                label: 'Rsbuild config',
-                content
-            };
-            let outputFile = `rsbuild.config.${name}.mjs`;
-            return {
-                path: (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(outputPath, outputFile),
-                label: `Rsbuild config (${name})`,
-                content
-            };
-        }),
-        ...rawBundlerConfigs.map(({ name, content })=>{
-            let outputFile = `${configType}.config.${name}.mjs`, outputFilePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(outputPath, outputFile);
-            return __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.existsSync(outputFilePath) && (outputFilePath = outputFilePath.replace(/\.mjs$/, `.${Date.now()}.mjs`)), {
-                path: outputFilePath,
-                label: `${upperFirst(configType)} Config (${name})`,
-                content
-            };
-        })
-    ];
-    await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.mkdir(outputPath, {
-        recursive: !0
-    }), await Promise.all(files.map(async (item)=>__WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.writeFile(item.path, `export default ${item.content}`)));
-    let fileInfos = files.map((item)=>`  - ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.bold(__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(item.label))}: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.underline(item.path)}`).join('\n');
-    __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.success(`config inspection completed, generated files: \n\n${fileInfos}\n`);
-}
-function stringifyConfig(config, verbose) {
-    return (0, __WEBPACK_EXTERNAL_MODULE__compiled_rspack_chain_index_js_b67fefbd__.default.toString)(config, {
-        verbose
-    });
-}
 let normalizePublicDirs = (publicDir)=>{
     if (!1 === publicDir) return [];
     let defaultConfig = {
@@ -2094,12 +2030,12 @@ let getEnvironmentHTMLPaths = (entry, config)=>'web' !== config.output.target ||
     }, {});
 async function updateEnvironmentContext(context, configs) {
     for (let [index, [name, config]] of (context.environments ||= {}, Object.entries(configs).entries())){
-        let tsconfigPath = config.source.tsconfigPath ? getAbsolutePath(context.rootPath, config.source.tsconfigPath) : void 0, browserslist = await getBrowserslistByEnvironment(context.rootPath, config), entry = config.source.entry ?? {}, htmlPaths = getEnvironmentHTMLPaths(entry, config), environmentContext = {
+        let browserslist = await getBrowserslistByEnvironment(context.rootPath, config), { entry = {}, tsconfigPath } = config.source, htmlPaths = getEnvironmentHTMLPaths(entry, config), environmentContext = {
             index,
             name,
             distPath: function(cwd, config) {
                 var _config_output_distPath, _config_output;
-                return getAbsolutePath(cwd, (null == (_config_output = config.output) || null == (_config_output_distPath = _config_output.distPath) ? void 0 : _config_output_distPath.root) ?? ROOT_DIST_DIR);
+                return ensureAbsolutePath(cwd, (null == (_config_output = config.output) || null == (_config_output_distPath = _config_output.distPath) ? void 0 : _config_output_distPath.root) ?? ROOT_DIST_DIR);
             }(context.rootPath, config),
             entry,
             browserslist,
@@ -2114,9 +2050,9 @@ async function updateEnvironmentContext(context, configs) {
     }
 }
 async function createContext(options, userConfig) {
-    let { cwd } = options, rootPath = userConfig.root ? getAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0, bundlerType = userConfig.provider ? 'webpack' : 'rspack';
+    let { cwd } = options, rootPath = userConfig.root ? ensureAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0, bundlerType = userConfig.provider ? 'webpack' : 'rspack';
     return {
-        version: "1.3.20",
+        version: "1.3.21",
         rootPath,
         distPath: '',
         cachePath,
@@ -2491,7 +2427,7 @@ let pluginCache = ()=>({
         setup (api) {
             let cacheEnabled = !1;
             api.modifyBundlerChain(async (chain, { environment, env })=>{
-                var digest;
+                var data;
                 let { config } = environment, { bundlerType } = api.context, buildCache = config.performance.buildCache ?? 'webpack' === bundlerType;
                 if (!1 === buildCache) return;
                 cacheEnabled = !0;
@@ -2501,7 +2437,7 @@ let pluginCache = ()=>({
                     userBuildDependencies: cacheConfig.buildDependencies
                 } : {});
                 'webpack' === bundlerType && await validateWebpackCache(cacheDirectory, buildDependencies);
-                let cacheVersion = Array.isArray(cacheConfig.cacheDigest) && cacheConfig.cacheDigest.length ? `${environment.name}-${env}-${digest = cacheConfig.cacheDigest, __WEBPACK_EXTERNAL_MODULE_node_crypto_9ba42079__.default.createHash('md5').update(JSON.stringify(digest)).digest('hex').slice(0, 8)}` : `${environment.name}-${env}`;
+                let cacheVersion = Array.isArray(cacheConfig.cacheDigest) && cacheConfig.cacheDigest.length ? `${environment.name}-${env}-${data = JSON.stringify(cacheConfig.cacheDigest), __WEBPACK_EXTERNAL_MODULE_node_crypto_9ba42079__.default.hash ? __WEBPACK_EXTERNAL_MODULE_node_crypto_9ba42079__.default.hash('sha256', data, 'hex').slice(0, 16) : __WEBPACK_EXTERNAL_MODULE_node_crypto_9ba42079__.default.createHash('sha256').update(data).digest('hex').slice(0, 16)}` : `${environment.name}-${env}`;
                 'rspack' === bundlerType ? (chain.cache(!0), chain.experiments({
                     ...chain.get('experiments'),
                     cache: {
@@ -4630,14 +4566,75 @@ let reduceTransformImportConfig = (options)=>{
                 });
             });
         }
-    }), getInspectOutputPath = (context, inspectOptions)=>inspectOptions.outputPath ? (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.isAbsolute)(inspectOptions.outputPath) ? inspectOptions.outputPath : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(context.distPath, inspectOptions.outputPath) : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(context.distPath, RSBUILD_OUTPUTS_PATH);
-async function inspectConfig({ context, pluginManager, rsbuildOptions, bundlerConfigs, inspectOptions = {} }) {
+    }), normalizePluginObject = (plugin)=>{
+    let { setup: _, ...rest } = plugin;
+    return {
+        ...rest,
+        setup () {}
+    };
+}, getRsbuildInspectConfig = ({ normalizedConfig, inspectOptions, pluginManager })=>{
+    let { environments, ...rsbuildConfig } = normalizedConfig, rawRsbuildConfig = stringifyConfig({
+        ...rsbuildConfig,
+        plugins: pluginManager.getPlugins().map(normalizePluginObject)
+    }, inspectOptions.verbose), environmentConfigs = {}, rawEnvironmentConfigs = [];
+    for (let [name, config] of Object.entries(environments)){
+        let debugConfig = {
+            ...config,
+            plugins: pluginManager.getPlugins({
+                environment: name
+            }).map(normalizePluginObject)
+        };
+        rawEnvironmentConfigs.push({
+            name,
+            content: stringifyConfig(debugConfig, inspectOptions.verbose)
+        }), environmentConfigs[name] = debugConfig;
+    }
+    return {
+        rsbuildConfig,
+        rawRsbuildConfig,
+        environmentConfigs: environments,
+        rawEnvironmentConfigs
+    };
+};
+async function outputInspectConfigFiles({ rawBundlerConfigs, rawEnvironmentConfigs, inspectOptions, configType }) {
+    let { outputPath } = inspectOptions, files = [
+        ...rawEnvironmentConfigs.map(({ name, content })=>{
+            if (1 === rawEnvironmentConfigs.length) return {
+                path: (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(outputPath, 'rsbuild.config.mjs'),
+                label: 'Rsbuild config',
+                content
+            };
+            let outputFile = `rsbuild.config.${name}.mjs`;
+            return {
+                path: (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(outputPath, outputFile),
+                label: `Rsbuild config (${name})`,
+                content
+            };
+        }),
+        ...rawBundlerConfigs.map(({ name, content })=>{
+            let outputFile = `${configType}.config.${name}.mjs`, outputFilePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(outputPath, outputFile);
+            return __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.existsSync(outputFilePath) && (outputFilePath = outputFilePath.replace(/\.mjs$/, `.${Date.now()}.mjs`)), {
+                path: outputFilePath,
+                label: `${upperFirst(configType)} Config (${name})`,
+                content
+            };
+        })
+    ];
+    await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.mkdir(outputPath, {
+        recursive: !0
+    }), await Promise.all(files.map(async (item)=>__WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.writeFile(item.path, `export default ${item.content}`)));
+    let fileInfos = files.map((item)=>`  - ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.bold(__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(item.label))}: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.underline(item.path)}`).join('\n');
+    __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.success(`config inspection completed, generated files: \n\n${fileInfos}\n`);
+}
+function stringifyConfig(config, verbose) {
+    return (0, __WEBPACK_EXTERNAL_MODULE__compiled_rspack_chain_index_js_b67fefbd__.default.toString)(config, {
+        verbose
+    });
+}
+let getInspectOutputPath = (context, inspectOptions)=>inspectOptions.outputPath ? (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.isAbsolute)(inspectOptions.outputPath) ? inspectOptions.outputPath : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(context.distPath, inspectOptions.outputPath) : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(context.distPath, RSBUILD_OUTPUTS_PATH);
+async function inspectConfig({ context, pluginManager, bundlerConfigs, inspectOptions = {}, bundler = 'rspack' }) {
     inspectOptions.mode ? setNodeEnv(inspectOptions.mode) : getNodeEnv() || setNodeEnv('development');
-    let rspackConfigs = bundlerConfigs || (await initConfigs({
-        context,
-        pluginManager,
-        rsbuildOptions
-    })).rspackConfigs, rawBundlerConfigs = rspackConfigs.map((config, index)=>({
+    let rawBundlerConfigs = bundlerConfigs.map((config, index)=>({
             name: config.name || String(index),
             content: stringifyConfig(config, inspectOptions.verbose)
         })), { rsbuildConfig, rawRsbuildConfig, environmentConfigs, rawEnvironmentConfigs } = getRsbuildInspectConfig({
@@ -4652,7 +4649,7 @@ async function inspectConfig({ context, pluginManager, rsbuildOptions, bundlerCo
             ...inspectOptions,
             outputPath
         },
-        configType: 'rspack'
+        configType: bundler
     }), {
         rsbuildConfig: rawRsbuildConfig,
         environmentConfigs: rawEnvironmentConfigs.map((r)=>r.content),
@@ -4660,7 +4657,7 @@ async function inspectConfig({ context, pluginManager, rsbuildOptions, bundlerCo
         origin: {
             rsbuildConfig,
             environmentConfigs,
-            bundlerConfigs: rspackConfigs
+            bundlerConfigs
         }
     };
 }
@@ -4833,19 +4830,26 @@ async function initRsbuildConfig({ context, pluginManager }) {
         getPluginAPI: context.getPluginAPI,
         pluginManager
     }), await modifyRsbuildConfig(context);
-    let normalizedBaseConfig = normalizeConfig(context.config), environments = {}, mergedEnvironments = initEnvironmentConfigs(normalizedBaseConfig, context.rootPath, context.specifiedEnvironments), { dev: { hmr, assetPrefix, progressBar, lazyCompilation, writeToDisk, ...rsbuildSharedDev }, server } = normalizedBaseConfig;
+    let normalizedBaseConfig = normalizeConfig(context.config), environments = {}, mergedEnvironments = initEnvironmentConfigs(normalizedBaseConfig, context.rootPath, context.specifiedEnvironments), { dev: { hmr, assetPrefix, progressBar, lazyCompilation, writeToDisk, ...rsbuildSharedDev }, server } = normalizedBaseConfig, tsconfigPaths = new Set();
     for (let [name, config] of Object.entries(mergedEnvironments)){
-        let environmentConfig = await modifyEnvironmentConfig(context, config, name);
-        environments[name] = {
+        let environmentConfig = await modifyEnvironmentConfig(context, config, name), normalizedEnvironmentConfig = {
             ...environmentConfig,
             dev: {
                 ...environmentConfig.dev,
                 ...rsbuildSharedDev
             },
             server
-        };
+        }, { tsconfigPath } = normalizedEnvironmentConfig.source;
+        if (tsconfigPath) {
+            let absoluteTsconfigPath = ensureAbsolutePath(context.rootPath, tsconfigPath);
+            normalizedEnvironmentConfig.source.tsconfigPath = absoluteTsconfigPath, tsconfigPaths.add(absoluteTsconfigPath);
+        }
+        environments[name] = normalizedEnvironmentConfig;
     }
-    context.normalizedConfig = {
+    tsconfigPaths.size && 'prefer-tsconfig' === normalizedBaseConfig.resolve.aliasStrategy && normalizedBaseConfig.dev.watchFiles.push({
+        paths: Array.from(tsconfigPaths),
+        type: 'reload-server'
+    }), context.normalizedConfig = {
         ...normalizedBaseConfig,
         environments
     }, await updateEnvironmentContext(context, environments);
@@ -4913,7 +4917,7 @@ let commonOpts = {}, getEnvDir = (cwd, envDir)=>envDir ? __WEBPACK_EXTERNAL_MODU
 async function init({ cliOptions, isRestart, isBuildWatch = !1 }) {
     cliOptions && (commonOpts = cliOptions);
     try {
-        let cwd = process.cwd(), root = commonOpts.root ? getAbsolutePath(cwd, commonOpts.root) : cwd, rsbuild = await createRsbuild({
+        let cwd = process.cwd(), root = commonOpts.root ? ensureAbsolutePath(cwd, commonOpts.root) : cwd, rsbuild = await createRsbuild({
             cwd: root,
             rsbuildConfig: ()=>init_loadConfig(root),
             environment: commonOpts.environment,
@@ -4923,17 +4927,16 @@ async function init({ cliOptions, isRestart, isBuildWatch = !1 }) {
             }
         });
         return rsbuild.onBeforeCreateCompiler(()=>{
-            var _config_dev;
             if ('dev' !== rsbuild.context.action && !isBuildWatch) return;
             let files = [], config = rsbuild.getNormalizedConfig();
-            if (null == (_config_dev = config.dev) ? void 0 : _config_dev.watchFiles) for (let watchFilesConfig of castArray(config.dev.watchFiles)){
-                if ('reload-server' !== watchFilesConfig.type) continue;
-                let paths = castArray(watchFilesConfig.paths);
-                watchFilesConfig.options ? watchFilesForRestart({
+            if (config.dev.watchFiles) for (let watchConfig of config.dev.watchFiles){
+                if ('reload-server' !== watchConfig.type) continue;
+                let paths = castArray(watchConfig.paths);
+                watchConfig.options ? watchFilesForRestart({
                     files: paths,
                     rsbuild,
                     isBuildWatch,
-                    watchOptions: watchFilesConfig.options
+                    watchOptions: watchConfig.options
                 }) : files.push(...paths);
             }
             watchFilesForRestart({
@@ -5578,7 +5581,7 @@ class CompilationManager {
             clientPaths,
             devConfig,
             serverConfig
-        }), { base } = serverConfig, assetPrefixes = publicPaths.map(pathnameParse).map((prefix)=>base && '/' !== base ? stripBase(prefix, base) : prefix), wrapper = async (req, res, next)=>{
+        }), { base } = serverConfig, assetPrefixes = publicPaths.map(getPathnameFromUrl).map((prefix)=>base && '/' !== base ? stripBase(prefix, base) : prefix), wrapper = async (req, res, next)=>{
             let { url } = req, assetPrefix = url && assetPrefixes.find((prefix)=>url.startsWith(prefix));
             assetPrefix && '/' !== assetPrefix ? (req.url = url.slice(assetPrefix.length - 1), middleware(req, res, (...args)=>{
                 req.url = url, next(...args);
@@ -6472,12 +6475,20 @@ let RSPACK_BUILD_ERROR = 'Rspack build failed.', build_build = async (initOption
             });
             return rspackConfigs;
         },
-        inspectConfig: async (inspectOptions)=>inspectConfig({
+        async inspectConfig (inspectOptions) {
+            let bundlerConfigs = (await initConfigs({
+                context,
+                pluginManager,
+                rsbuildOptions
+            })).rspackConfigs;
+            return inspectConfig({
                 context,
                 pluginManager,
                 rsbuildOptions,
-                inspectOptions
-            })
+                inspectOptions,
+                bundlerConfigs
+            });
+        }
     };
 };
 function prodServer_define_property(obj, key, value) {
@@ -6544,7 +6555,7 @@ async function startProdServer(context, config, { getPortSilently } = {}) {
         pwd: context.rootPath,
         output: {
             path: context.distPath,
-            assetPrefixes: Object.values(context.environments).map((e)=>pathnameParse(e.config.output.assetPrefix))
+            assetPrefixes: Object.values(context.environments).map((e)=>getPathnameFromUrl(e.config.output.assetPrefix))
         },
         serverConfig
     }, middlewares);
@@ -7388,11 +7399,11 @@ async function runCLI() {
     }
     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_c302f6e3__.logger.greet(`  Rsbuild v1.3.20\n`);
+    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.greet(`  Rsbuild v1.3.21\n`);
     try {
         !function() {
             let cli = cac_dist('rsbuild');
-            cli.help(), cli.version("1.3.20"), applyCommonOptions(cli);
+            cli.help(), cli.version("1.3.21"), applyCommonOptions(cli);
             let devCommand = cli.command('', 'starting the dev server').alias('dev'), buildCommand = cli.command('build', 'build the app for production'), previewCommand = cli.command('preview', 'preview the production build locally'), inspectCommand = cli.command('inspect', 'inspect the Rspack and Rsbuild configs');
             applyServerOptions(devCommand), applyServerOptions(previewCommand), devCommand.action(async (options)=>{
                 try {
@@ -7443,6 +7454,6 @@ async function runCLI() {
         __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error('Failed to start Rsbuild CLI.'), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error(err);
     }
 }
-let src_version = "1.3.20";
+let src_version = "1.3.21";
 var __webpack_exports__logger = __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger, __webpack_exports__rspack = __WEBPACK_EXTERNAL_MODULE__rspack_core_e0096ff7__.rspack;
 export { PLUGIN_CSS_NAME, PLUGIN_SWC_NAME, createRsbuild, defaultAllowedOrigins, 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/config.d.ts

@@ -1,4 +1,4 @@
-import type { InspectConfigOptions, InspectConfigResult, NormalizedConfig, PluginManager, PublicDir, PublicDirOptions, RsbuildConfig, RsbuildEntry } from './types';
+import type { NormalizedConfig, PublicDir, PublicDirOptions, RsbuildConfig, RsbuildEntry } from './types';
 /**
  * Default allowed origins for CORS.
  * - localhost
@@ -81,32 +81,4 @@ export type LoadConfigResult = {
 };
 export type ConfigLoader = 'jiti' | 'native';
 export declare function loadConfig({ cwd, path, envMode, meta, loader, }?: LoadConfigOptions): Promise<LoadConfigResult>;
-export declare const getRsbuildInspectConfig: ({ normalizedConfig, inspectOptions, pluginManager, }: {
-    normalizedConfig: NormalizedConfig;
-    inspectOptions: InspectConfigOptions;
-    pluginManager: PluginManager;
-}) => {
-    rawRsbuildConfig: string;
-    rsbuildConfig: InspectConfigResult["origin"]["rsbuildConfig"];
-    rawEnvironmentConfigs: Array<{
-        name: string;
-        content: string;
-    }>;
-    environmentConfigs: InspectConfigResult["origin"]["environmentConfigs"];
-};
-export declare function outputInspectConfigFiles({ rawBundlerConfigs, rawEnvironmentConfigs, inspectOptions, configType, }: {
-    configType: string;
-    rawEnvironmentConfigs: Array<{
-        name: string;
-        content: string;
-    }>;
-    rawBundlerConfigs: Array<{
-        name: string;
-        content: string;
-    }>;
-    inspectOptions: InspectConfigOptions & {
-        outputPath: string;
-    };
-}): Promise<void>;
-export declare function stringifyConfig(config: unknown, verbose?: boolean): string;
 export declare const normalizePublicDirs: (publicDir?: PublicDir) => Required<PublicDirOptions>[];

package/dist-types/helpers/index.d.ts

@@ -5,7 +5,7 @@ export * from './fs';
 export * from './path';
 export * from './stats';
 export { color };
-export declare const rspackMinVersion = "1.0.0";
+export declare const rspackMinVersion = "1.2.4";
 export declare const getNodeEnv: () => string;
 export declare const setNodeEnv: (env: string) => void;
 export declare const isNil: (o: unknown) => o is undefined | null;
@@ -14,6 +14,11 @@ export declare const isObject: (obj: unknown) => obj is Record<string, any>;
 export declare const isPlainObject: (obj: unknown) => obj is Record<string, any>;
 export declare const castArray: <T>(arr?: T | T[]) => T[];
 export declare const cloneDeep: <T>(value: T) => T;
+/**
+ * If the application overrides the Rspack version to a lower one,
+ * we should check that the Rspack version is greater than the minimum
+ * supported version.
+ */
 export declare const isSatisfyRspackVersion: (originalVersion: string) => Promise<boolean>;
 export declare const removeLeadingSlash: (s: string) => string;
 export declare const removeTailingSlash: (s: string) => string;
@@ -42,3 +47,4 @@ export declare const prettyTime: (seconds: number) => string;
  */
 export declare const isTTY: (type?: "stdin" | "stdout") => boolean;
 export declare const addCompilationError: (compilation: Rspack.Compilation, message: string) => void;
+export declare function hash(data: string): string;

package/dist-types/helpers/path.d.ts

@@ -1,5 +1,4 @@
-export declare function getAbsolutePath(base: string, filepath: string): string;
-export declare function getRelativePath(base: string, filepath: string): string;
+export declare function toRelativePath(base: string, filepath: string): string;
 export declare function getCommonParentPath(paths: string[]): string;
 export declare const getCompiledPath: (packageName: string) => string;
 /**
@@ -9,7 +8,7 @@ export declare const getCompiledPath: (packageName: string) => string;
  * @returns Resolved absolute file path.
  */
 export declare const ensureAbsolutePath: (base: string, filePath: string) => string;
-export declare const pathnameParse: (publicPath: string) => string;
+export declare const getPathnameFromUrl: (publicPath: string) => string;
 /** dedupe and remove nested paths */
 export declare const dedupeNestedPaths: (paths: string[]) => string[];
 /**

package/dist-types/inspectConfig.d.ts

@@ -0,0 +1,35 @@
+import type { InitConfigsOptions } from './provider/initConfigs';
+import type { InspectConfigOptions, InspectConfigResult, NormalizedConfig, PluginManager, Rspack, WebpackConfig } from './types';
+export declare const getRsbuildInspectConfig: ({ normalizedConfig, inspectOptions, pluginManager, }: {
+    normalizedConfig: NormalizedConfig;
+    inspectOptions: InspectConfigOptions;
+    pluginManager: PluginManager;
+}) => {
+    rawRsbuildConfig: string;
+    rsbuildConfig: InspectConfigResult["origin"]["rsbuildConfig"];
+    rawEnvironmentConfigs: Array<{
+        name: string;
+        content: string;
+    }>;
+    environmentConfigs: InspectConfigResult["origin"]["environmentConfigs"];
+};
+export declare function outputInspectConfigFiles({ rawBundlerConfigs, rawEnvironmentConfigs, inspectOptions, configType, }: {
+    configType: string;
+    rawEnvironmentConfigs: Array<{
+        name: string;
+        content: string;
+    }>;
+    rawBundlerConfigs: Array<{
+        name: string;
+        content: string;
+    }>;
+    inspectOptions: InspectConfigOptions & {
+        outputPath: string;
+    };
+}): Promise<void>;
+export declare function stringifyConfig(config: unknown, verbose?: boolean): string;
+export declare function inspectConfig<B extends 'rspack' | 'webpack' = 'rspack'>({ context, pluginManager, bundlerConfigs, inspectOptions, bundler, }: InitConfigsOptions & {
+    inspectOptions?: InspectConfigOptions;
+    bundlerConfigs: B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[];
+    bundler?: 'rspack' | 'webpack';
+}): Promise<InspectConfigResult<B>>;

package/dist-types/provider/helpers.d.ts

@@ -3,7 +3,7 @@
  */
 export { setCssExtractPlugin, setHTMLPlugin } from '../pluginHelper';
 export { initRsbuildConfig } from './initConfigs';
-export { stringifyConfig, getRsbuildInspectConfig, outputInspectConfigFiles, } from '../config';
+export { inspectConfig } from '../inspectConfig';
 export { getHTMLPlugin } from '../pluginHelper';
 export { formatStats, getStatsOptions, prettyTime } from '../helpers';
 export { registerBuildHook, registerDevHook } from '../hooks';

package/dist-types/provider/initConfigs.d.ts

@@ -4,6 +4,15 @@ export type InitConfigsOptions = {
     pluginManager: PluginManager;
     rsbuildOptions: ResolvedCreateRsbuildOptions;
 };
+/**
+ * Initialize the Rsbuild config
+ * 1. Initialize the Rsbuild plugins
+ * 2. Run all the `modifyRsbuildConfig` hooks
+ * 3. Normalize the Rsbuild config, merge with the default config
+ * 4. Initialize the configs for each environment
+ * 5. Run all the `modifyEnvironmentConfig` hooks
+ * 6. Validate the final Rsbuild config
+ */
 export declare function initRsbuildConfig({ context, pluginManager, }: Pick<InitConfigsOptions, 'context' | 'pluginManager'>): Promise<NormalizedConfig>;
 export declare function initConfigs({ context, pluginManager, rsbuildOptions, }: InitConfigsOptions): Promise<{
     rspackConfigs: Rspack.Configuration[];

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

@@ -14,7 +14,7 @@ import type { ModifyWebpackChainUtils, ModifyWebpackConfigUtils, RsbuildPlugins
 import type { RsbuildEntry, RsbuildMode, RsbuildTarget } from './rsbuild';
 import type { BundlerPluginInstance, Rspack, RspackRule } from './rspack';
 import type { CSSExtractOptions, CSSLoaderModulesOptions, CSSLoaderOptions, HtmlRspackPlugin, PostCSSLoaderOptions, PostCSSPlugin, StyleLoaderOptions, WebpackConfig } from './thirdParty';
-import type { ConfigChain, ConfigChainMergeContext, ConfigChainWithContext, DeepReadonly, MaybePromise, OneOrMany } from './utils';
+import type { ConfigChain, ConfigChainMergeContext, ConfigChainWithContext, MaybePromise, OneOrMany, TwoLevelReadonly } from './utils';
 export type ToolsSwcConfig = ConfigChain<SwcLoaderOptions>;
 export type ToolsBundlerChainConfig = OneOrMany<(chain: RspackChain, utils: ModifyBundlerChainUtils) => MaybePromise<void>>;
 export type ToolsPostCSSLoaderConfig = ConfigChainWithContext<PostCSSLoaderOptions, {
@@ -1373,7 +1373,8 @@ export interface DevConfig {
      */
     lazyCompilation?: boolean | Rspack.LazyCompilationOptions;
 }
-export type NormalizedDevConfig = DevConfig & Required<Pick<DevConfig, 'hmr' | 'liveReload' | 'assetPrefix' | 'writeToDisk' | 'cliShortcuts'>> & {
+export type NormalizedDevConfig = Omit<DevConfig, 'watchFiles'> & Required<Pick<DevConfig, 'hmr' | 'liveReload' | 'assetPrefix' | 'writeToDisk' | 'cliShortcuts'>> & {
+    watchFiles: WatchFiles[];
     client: NormalizedClientConfig;
 };
 export interface ResolveConfig {
@@ -1520,7 +1521,7 @@ export type MergedEnvironmentConfig = {
 /**
  * The normalized Rsbuild environment config.
  */
-export type NormalizedEnvironmentConfig = DeepReadonly<Omit<MergedEnvironmentConfig, 'dev'> & {
+export type NormalizedEnvironmentConfig = TwoLevelReadonly<Omit<MergedEnvironmentConfig, 'dev'> & {
     dev: NormalizedDevConfig;
     server: NormalizedServerConfig;
     _privateMeta?: RsbuildConfigMeta;

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

@@ -13,10 +13,29 @@ export type RsbuildContext = {
     distPath: string;
     /** Absolute path of cache files. */
     cachePath: string;
-    /** Info of dev server  */
+    /**
+     * Dev server information when running in dev mode.
+     * Available after the dev server has been created.
+     *
+     * @example
+     * ```ts
+     * import { createRsbuild } from '@rsbuild/core';
+     *
+     * async function main() {
+     *   const rsbuild = createRsbuild({
+     *     // ...
+     *   });
+     *   await rsbuild.startDevServer();
+     *   console.log(rsbuild.context.devServer); // { hostname: 'localhost', port: 3000, https: false }
+     * }
+     * ```
+     */
     devServer?: {
+        /** The hostname the server is running on. */
         hostname: string;
+        /** The port number the server is listening on. */
         port: number;
+        /** Whether the server is using HTTPS protocol. */
         https: boolean;
     };
     /**