@rsbuild/core 1.2.4 → 1.2.6

package/compiled/css-loader/index.js

@@ -1,19 +1,19 @@
 (() => {
   var __webpack_modules__ = {
-    4063: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    9605: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
-      const loader = __nccwpck_require__(6209);
+      const loader = __nccwpck_require__(7999);
       module.exports = loader.default;
       module.exports.defaultGetLocalIdent =
-        __nccwpck_require__(1724).defaultGetLocalIdent;
+        __nccwpck_require__(2666).defaultGetLocalIdent;
     },
-    6209: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    7999: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = loader;
       var _postcss = _interopRequireDefault(__nccwpck_require__(9409));
-      var _plugins = __nccwpck_require__(6734);
-      var _utils = __nccwpck_require__(1724);
+      var _plugins = __nccwpck_require__(3604);
+      var _utils = __nccwpck_require__(2666);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -236,7 +236,7 @@
         callback(null, `${importCode}${moduleCode}${exportCode}`);
       }
     },
-    6734: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    3604: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       Object.defineProperty(exports, "icssParser", {
@@ -258,20 +258,22 @@
         },
       });
       var _postcssImportParser = _interopRequireDefault(
-        __nccwpck_require__(4853),
+        __nccwpck_require__(1663),
       );
-      var _postcssIcssParser = _interopRequireDefault(__nccwpck_require__(532));
-      var _postcssUrlParser = _interopRequireDefault(__nccwpck_require__(4115));
+      var _postcssIcssParser = _interopRequireDefault(
+        __nccwpck_require__(6178),
+      );
+      var _postcssUrlParser = _interopRequireDefault(__nccwpck_require__(7973));
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
     },
-    532: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    6178: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _icssUtils = __nccwpck_require__(7937);
-      var _utils = __nccwpck_require__(1724);
+      var _utils = __nccwpck_require__(2666);
       const plugin = (options = {}) => ({
         postcssPlugin: "postcss-icss-parser",
         async OnceExit(root) {
@@ -370,14 +372,14 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    4853: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    1663: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _postcssValueParser = _interopRequireDefault(
         __nccwpck_require__(2948),
       );
-      var _utils = __nccwpck_require__(1724);
+      var _utils = __nccwpck_require__(2666);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -682,14 +684,14 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    4115: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    7973: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _postcssValueParser = _interopRequireDefault(
         __nccwpck_require__(2948),
       );
-      var _utils = __nccwpck_require__(1724);
+      var _utils = __nccwpck_require__(2666);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -1032,7 +1034,7 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    1724: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    2666: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.WEBPACK_IGNORE_COMMENT_REGEXP = void 0;
@@ -7982,6 +7984,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(4063);
+  var __webpack_exports__ = __nccwpck_require__(9605);
   module.exports = __webpack_exports__;
 })();

package/compiled/postcss-loader/index.js

@@ -1,15 +1,15 @@
 (() => {
   "use strict";
   var __webpack_modules__ = {
-    51: (module, __unused_webpack_exports, __nccwpck_require__) => {
-      module.exports = __nccwpck_require__(413)["default"];
+    15: (module, __unused_webpack_exports, __nccwpck_require__) => {
+      module.exports = __nccwpck_require__(49)["default"];
     },
-    413: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    49: (__unused_webpack_module, exports, __nccwpck_require__) => {
       var __webpack_unused_export__;
       __webpack_unused_export__ = { value: true };
       exports["default"] = loader;
       var _path = _interopRequireDefault(__nccwpck_require__(928));
-      var _utils = __nccwpck_require__(744);
+      var _utils = __nccwpck_require__(628);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -179,7 +179,7 @@
         callback(null, result.css, map, { ast });
       }
     },
-    744: (module, exports, __nccwpck_require__) => {
+    628: (module, exports, __nccwpck_require__) => {
       module = __nccwpck_require__.nmd(module);
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.exec = exec;
@@ -716,6 +716,6 @@
   })();
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(51);
+  var __webpack_exports__ = __nccwpck_require__(15);
   module.exports = __webpack_exports__;
 })();

package/compiled/rsbuild-dev-middleware/index.js

@@ -4449,14 +4449,14 @@
         return a.start - b.start;
       }
     },
-    4358: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    2461: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
-      const middleware = __nccwpck_require__(8284);
-      const getFilenameFromUrl = __nccwpck_require__(2756);
-      const setupHooks = __nccwpck_require__(9065);
-      const setupWriteToDisk = __nccwpck_require__(9654);
-      const setupOutputFileSystem = __nccwpck_require__(4359);
-      const ready = __nccwpck_require__(3395);
+      const middleware = __nccwpck_require__(5121);
+      const getFilenameFromUrl = __nccwpck_require__(8537);
+      const setupHooks = __nccwpck_require__(3972);
+      const setupWriteToDisk = __nccwpck_require__(527);
+      const setupOutputFileSystem = __nccwpck_require__(7380);
+      const ready = __nccwpck_require__(9296);
       const noop = () => {};
       function wdm(compiler, options = {}) {
         const context = {
@@ -4511,14 +4511,14 @@
       }
       module.exports = wdm;
     },
-    8284: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    5121: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const mrmime = __nccwpck_require__(8311);
       const onFinishedStream = __nccwpck_require__(21);
-      const getFilenameFromUrl = __nccwpck_require__(2756);
-      const ready = __nccwpck_require__(3395);
-      const parseTokenList = __nccwpck_require__(8766);
-      const memorize = __nccwpck_require__(4376);
+      const getFilenameFromUrl = __nccwpck_require__(8537);
+      const ready = __nccwpck_require__(9296);
+      const parseTokenList = __nccwpck_require__(5919);
+      const memorize = __nccwpck_require__(2297);
       async function getEtag(stat) {
         const mtime = stat.mtime.getTime().toString(16);
         const size = stat.size.toString(16);
@@ -4610,7 +4610,7 @@
             return;
           }
           function sendError(status, options) {
-            const escapeHtml = __nccwpck_require__(6680);
+            const escapeHtml = __nccwpck_require__(3557);
             const content = statuses[status] || String(status);
             const document = Buffer.from(
               `<!DOCTYPE html>\n<html lang="en">\n<head>\n<meta charset="utf-8">\n<title>Error</title>\n</head>\n<body>\n<pre>${escapeHtml(content)}</pre>\n</body>\n</html>`,
@@ -4915,7 +4915,7 @@
       }
       module.exports = wrapper;
     },
-    6680: (module) => {
+    3557: (module) => {
       "use strict";
       const matchHtmlRegExp = /["'&<>]/;
       function escapeHtml(string) {
@@ -4960,13 +4960,13 @@
       }
       module.exports = escapeHtml;
     },
-    2756: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    8537: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const path = __nccwpck_require__(6928);
       const { parse } = __nccwpck_require__(7016);
       const querystring = __nccwpck_require__(3480);
-      const getPaths = __nccwpck_require__(3474);
-      const memorize = __nccwpck_require__(4376);
+      const getPaths = __nccwpck_require__(9411);
+      const memorize = __nccwpck_require__(2297);
       const memoizedParse = memorize(parse, undefined, (value) => {
         if (value.pathname) {
           value.pathname = decode(value.pathname);
@@ -5049,7 +5049,7 @@
       }
       module.exports = getFilenameFromUrl;
     },
-    3474: (module) => {
+    9411: (module) => {
       "use strict";
       function getPaths(context) {
         const { stats, options } = context;
@@ -5070,7 +5070,7 @@
       }
       module.exports = getPaths;
     },
-    4376: (module) => {
+    2297: (module) => {
       "use strict";
       const cacheStore = new WeakMap();
       function memorize(fn, { cache = new Map() } = {}, callback) {
@@ -5092,7 +5092,7 @@
       }
       module.exports = memorize;
     },
-    8766: (module) => {
+    5919: (module) => {
       "use strict";
       function parseTokenList(str) {
         let end = 0;
@@ -5125,7 +5125,7 @@
       }
       module.exports = parseTokenList;
     },
-    3395: (module) => {
+    9296: (module) => {
       "use strict";
       function ready(context, callback, req) {
         if (context.state) {
@@ -5140,7 +5140,7 @@
       }
       module.exports = ready;
     },
-    9065: (module) => {
+    3972: (module) => {
       "use strict";
       function setupHooks(context) {
         function invalid() {
@@ -5172,7 +5172,7 @@
       }
       module.exports = setupHooks;
     },
-    4359: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    7380: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const memfs = __nccwpck_require__(5590);
       function setupOutputFileSystem(context) {
@@ -5199,7 +5199,7 @@
       }
       module.exports = setupOutputFileSystem;
     },
-    9654: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    527: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const fs = __nccwpck_require__(9896);
       const path = __nccwpck_require__(6928);
@@ -6185,6 +6185,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(4358);
+  var __webpack_exports__ = __nccwpck_require__(2461);
   module.exports = __webpack_exports__;
 })();

package/compiled/style-loader/index.js

@@ -1,16 +1,16 @@
 (() => {
   "use strict";
   var __webpack_modules__ = {
-    687: (module, __unused_webpack_exports, __nccwpck_require__) => {
-      const loader = __nccwpck_require__(537);
+    620: (module, __unused_webpack_exports, __nccwpck_require__) => {
+      const loader = __nccwpck_require__(314);
       module.exports = loader.default;
     },
-    537: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    314: (__unused_webpack_module, exports, __nccwpck_require__) => {
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _path = _interopRequireDefault(__nccwpck_require__(928));
-      var _utils = __nccwpck_require__(788);
-      var _options = _interopRequireDefault(__nccwpck_require__(380));
+      var _utils = __nccwpck_require__(555);
+      var _options = _interopRequireDefault(__nccwpck_require__(199));
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -104,7 +104,7 @@
       };
       var _default = (exports["default"] = loader);
     },
-    142: (module) => {
+    589: (module) => {
       function isEqualLocals(a, b, isNamedExport) {
         if ((!a && b) || (a && !b)) {
           return false;
@@ -130,7 +130,7 @@
       }
       module.exports = isEqualLocals;
     },
-    788: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    555: (__unused_webpack_module, exports, __nccwpck_require__) => {
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.getExportLazyStyleCode = getExportLazyStyleCode;
       exports.getExportStyleCode = getExportStyleCode;
@@ -151,7 +151,7 @@
       exports.getdomAPI = getdomAPI;
       exports.stringifyRequest = stringifyRequest;
       var _path = _interopRequireDefault(__nccwpck_require__(928));
-      var _isEqualLocals = _interopRequireDefault(__nccwpck_require__(142));
+      var _isEqualLocals = _interopRequireDefault(__nccwpck_require__(589));
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -394,7 +394,7 @@
     928: (module) => {
       module.exports = require("path");
     },
-    380: (module) => {
+    199: (module) => {
       module.exports = JSON.parse(
         '{"title":"Style Loader options","type":"object","properties":{"injectType":{"description":"Allows to setup how styles will be injected into DOM.","link":"https://github.com/webpack-contrib/style-loader#injecttype","enum":["styleTag","singletonStyleTag","autoStyleTag","lazyStyleTag","lazySingletonStyleTag","lazyAutoStyleTag","linkTag"]},"attributes":{"description":"Adds custom attributes to tag.","link":"https://github.com/webpack-contrib/style-loader#attributes","type":"object"},"insert":{"description":"Inserts `<style>`/`<link>` at the given position.","link":"https://github.com/webpack-contrib/style-loader#insert","anyOf":[{"type":"string"},{"instanceof":"Function"}]},"base":{"description":"Sets module ID base for DLLPlugin.","link":"https://github.com/webpack-contrib/style-loader#base","type":"number"},"esModule":{"description":"Use the ES modules syntax.","link":"https://github.com/webpack-contrib/css-loader#esmodule","type":"boolean"},"styleTagTransform":{"description":"Transform tag and css when insert \'style\' tag into the DOM","link":"https://github.com/webpack-contrib/style-loader#styleTagTransform","anyOf":[{"type":"string"},{"instanceof":"Function"}]}},"additionalProperties":false}',
       );
@@ -422,6 +422,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(687);
+  var __webpack_exports__ = __nccwpck_require__(620);
   module.exports = __webpack_exports__;
 })();

package/dist/index.cjs

@@ -918,36 +918,42 @@ var __webpack_exports__ = {};
     async function init({ cliOptions, isRestart, isBuildWatch = !1 }) {
         cliOptions && (commonOpts = cliOptions);
         try {
-            var _config_server, _config_dev, _config_dev1;
+            var _config_server, _config_dev;
             let cwd = process.cwd(), root = commonOpts.root ? getAbsolutePath(cwd, commonOpts.root) : cwd, envs = loadEnv({
                 cwd: getEnvDir(root, commonOpts.envDir),
                 mode: commonOpts.envMode
             }), { content: config, filePath: configFilePath } = await config_loadConfig({
                 cwd: root,
                 path: commonOpts.config,
-                envMode: commonOpts.envMode
-            }), command = process.argv[2];
-            if ('dev' === command || isBuildWatch) {
-                let files = [
-                    ...envs.filePaths
-                ];
-                if (configFilePath && files.push(configFilePath), null === (_config_dev1 = config.dev) || void 0 === _config_dev1 ? void 0 : _config_dev1.watchFiles) for (let watchFilesConfig of castArray(config.dev.watchFiles)){
-                    if ('reload-server' !== watchFilesConfig.type) continue;
-                    let paths = castArray(watchFilesConfig.paths);
-                    watchFilesConfig.options ? watchFilesForRestart(paths, root, isBuildWatch, watchFilesConfig.options) : files.push(...paths);
-                }
-                watchFilesForRestart(files, root, isBuildWatch);
-            }
+                envMode: commonOpts.envMode,
+                loader: commonOpts.configLoader
+            });
             config.source ||= {}, config.source.define = {
                 ...envs.publicVars,
                 ...config.source.define
-            }, commonOpts.root && (config.root = root), commonOpts.mode && (config.mode = commonOpts.mode), !commonOpts.open || (null === (_config_server = config.server) || void 0 === _config_server ? void 0 : _config_server.open) || (config.server ||= {}, config.server.open = commonOpts.open), commonOpts.host && (config.server ||= {}, config.server.host = commonOpts.host), commonOpts.port && (config.server ||= {}, config.server.port = commonOpts.port), (null === (_config_dev = config.dev) || void 0 === _config_dev ? void 0 : _config_dev.cliShortcuts) === void 0 && (config.dev ||= {}, config.dev.cliShortcuts = !0);
+            }, commonOpts.base && (config.server ||= {}, config.server.base = commonOpts.base), commonOpts.root && (config.root = root), commonOpts.mode && (config.mode = commonOpts.mode), !commonOpts.open || (null === (_config_server = config.server) || void 0 === _config_server ? void 0 : _config_server.open) || (config.server ||= {}, config.server.open = commonOpts.open), commonOpts.host && (config.server ||= {}, config.server.host = commonOpts.host), commonOpts.port && (config.server ||= {}, config.server.port = commonOpts.port), (null === (_config_dev = config.dev) || void 0 === _config_dev ? void 0 : _config_dev.cliShortcuts) === void 0 && (config.dev ||= {}, config.dev.cliShortcuts = !0);
             let rsbuild = await createRsbuild({
                 cwd: root,
                 rsbuildConfig: config,
                 environment: commonOpts.environment
             });
-            return rsbuild.onCloseBuild(envs.cleanup), rsbuild.onCloseDevServer(envs.cleanup), rsbuild;
+            return rsbuild.onBeforeCreateCompiler(()=>{
+                let command = process.argv[2];
+                if ('dev' === command || isBuildWatch) {
+                    var _config_dev;
+                    let files = [
+                        ...envs.filePaths
+                    ];
+                    configFilePath && files.push(configFilePath);
+                    let config = rsbuild.getNormalizedConfig();
+                    if (null === (_config_dev = config.dev) || void 0 === _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(paths, root, isBuildWatch, watchFilesConfig.options) : files.push(...paths);
+                    }
+                    watchFilesForRestart(files, root, isBuildWatch);
+                }
+            }), rsbuild.onCloseBuild(envs.cleanup), rsbuild.onCloseDevServer(envs.cleanup), rsbuild;
         } catch (err) {
             if (isRestart) rslog_index_js_namespaceObject.logger.error(err);
             else throw err;
@@ -1103,7 +1109,6 @@ var __webpack_exports__ = {};
             }
         }), getDefaultPerformanceConfig = ()=>({
             profile: !1,
-            buildCache: !0,
             printFileSize: !0,
             removeConsole: !1,
             removeMomentLocale: !1,
@@ -1236,7 +1241,7 @@ var __webpack_exports__ = {};
         });
         watcher.on('add', callback), watcher.on('change', callback), watcher.on('unlink', callback);
     }
-    async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta } = {}) {
+    async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta, loader = 'jiti' } = {}) {
         let configExport;
         let configFilePath = resolveConfigPath(cwd, path);
         if (!configFilePath) return {
@@ -1246,10 +1251,11 @@ var __webpack_exports__ = {};
         let applyMetaInfo = (config)=>(config._privateMeta = {
                 configFilePath
             }, config);
-        if (/\.(?:js|mjs|cjs)$/.test(configFilePath)) try {
-            let exportModule = await import(`${configFilePath}?t=${Date.now()}`);
+        if ('native' === loader || /\.(?:js|mjs|cjs)$/.test(configFilePath)) try {
+            let configFileURL = (0, external_node_url_namespaceObject.pathToFileURL)(configFilePath).href, exportModule = await import(`${configFileURL}?t=${Date.now()}`);
             configExport = exportModule.default ? exportModule.default : exportModule;
         } catch (err) {
+            if ('native' === loader) throw rslog_index_js_namespaceObject.logger.error(`Failed to load file with native loader: ${index_js_default().dim(configFilePath)}`), err;
             rslog_index_js_namespaceObject.logger.debug(`Failed to load file with dynamic import: ${index_js_default().dim(configFilePath)}`);
         }
         try {
@@ -1702,7 +1708,7 @@ var __webpack_exports__ = {};
     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_namespaceObject.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0;
         return {
-            version: "1.2.4",
+            version: "1.2.6",
             rootPath,
             distPath: '',
             cachePath,
@@ -2011,10 +2017,16 @@ var __webpack_exports__ = {};
         return process.env.BUNDLE_ANALYZE || (null === (_config_performance = config.performance) || void 0 === _config_performance ? void 0 : _config_performance.bundleAnalyze);
     }, external_node_crypto_namespaceObject = require("node:crypto");
     var external_node_crypto_default = __webpack_require__.n(external_node_crypto_namespaceObject);
-    async function validateCache(cacheDirectory, buildDependencies) {
+    async function validateWebpackCache(cacheDirectory, buildDependencies) {
         let configFile = (0, external_node_path_namespaceObject.join)(cacheDirectory, 'buildDependencies.json');
         if (await isFileExists(configFile)) {
-            if (JSON.stringify(JSON.parse(await external_node_fs_default().promises.readFile(configFile, 'utf-8'))) === JSON.stringify(buildDependencies)) return;
+            let rawConfigFile = await external_node_fs_default().promises.readFile(configFile, 'utf-8'), prevBuildDependencies = null;
+            try {
+                prevBuildDependencies = JSON.parse(rawConfigFile);
+            } catch (e) {
+                rslog_index_js_namespaceObject.logger.debug('Failed to parse the previous buildDependencies.json', e);
+            }
+            if (JSON.stringify(prevBuildDependencies) === JSON.stringify(buildDependencies)) return;
             await external_node_fs_default().promises.rm(cacheDirectory, {
                 force: !0,
                 recursive: !0
@@ -2051,24 +2063,33 @@ var __webpack_exports__ = {};
     let pluginCache = ()=>({
             name: 'rsbuild:cache',
             setup (api) {
-                'rspack' !== api.context.bundlerType && api.modifyBundlerChain(async (chain, { environment, env })=>{
+                let cacheEnabled = !1;
+                api.modifyBundlerChain(async (chain, { environment, env })=>{
                     var digest;
-                    let { config } = environment, { buildCache } = config.performance;
-                    if (!1 === buildCache) {
-                        chain.cache(!1);
-                        return;
-                    }
+                    let { config } = environment, { bundlerType } = api.context, buildCache = config.performance.buildCache ?? 'webpack' === bundlerType;
+                    if (!1 === buildCache) return;
+                    cacheEnabled = !0;
                     let { context } = api, cacheConfig = 'boolean' == typeof buildCache ? {} : buildCache, cacheDirectory = function({ cacheDirectory }, context) {
                         return cacheDirectory ? (0, external_node_path_namespaceObject.isAbsolute)(cacheDirectory) ? cacheDirectory : (0, external_node_path_namespaceObject.join)(context.rootPath, cacheDirectory) : (0, external_node_path_namespaceObject.join)(context.cachePath, context.bundlerType);
                     }(cacheConfig, context), buildDependencies = await getBuildDependencies(context, config, environment);
-                    await validateCache(cacheDirectory, buildDependencies);
-                    let useDigest = Array.isArray(cacheConfig.cacheDigest) && cacheConfig.cacheDigest.length;
-                    chain.cache({
-                        name: useDigest ? `${environment.name}-${env}-${digest = cacheConfig.cacheDigest, external_node_crypto_default().createHash('md5').update(JSON.stringify(digest)).digest('hex').slice(0, 8)}` : `${environment.name}-${env}`,
+                    'webpack' === bundlerType && await validateWebpackCache(cacheDirectory, buildDependencies);
+                    let cacheVersion = Array.isArray(cacheConfig.cacheDigest) && cacheConfig.cacheDigest.length ? `${environment.name}-${env}-${digest = cacheConfig.cacheDigest, external_node_crypto_default().createHash('md5').update(JSON.stringify(digest)).digest('hex').slice(0, 8)}` : `${environment.name}-${env}`;
+                    'rspack' === bundlerType ? (chain.cache(!0), chain.experiments({
+                        ...chain.get('experiments'),
+                        cache: {
+                            type: 'persistent',
+                            version: cacheVersion,
+                            directory: cacheDirectory,
+                            buildDependencies: Object.values(buildDependencies).flat()
+                        }
+                    })) : chain.cache({
+                        name: cacheVersion,
                         type: 'filesystem',
                         cacheDirectory,
                         buildDependencies
                     });
+                }), api.onAfterCreateCompiler(()=>{
+                    cacheEnabled && 'rspack' === api.context.bundlerType && rslog_index_js_namespaceObject.logger.info(`Rspack persistent cache enabled ${index_js_default().dim('(experimental)')}`);
                 });
             }
         }), addTrailingSep = (dir)=>dir.endsWith(external_node_path_namespaceObject.sep) ? dir : dir + external_node_path_namespaceObject.sep, isStrictSubdir = (parent, child)=>{
@@ -2093,9 +2114,9 @@ var __webpack_exports__ = {};
                     if (!0 === enable || 'auto' === enable && isStrictSubdir(rootPath, targetPath)) return {
                         path: targetPath
                     };
-                }, getPathInfo = (environment)=>{
+                }, getPathInfo = (environment, isDev)=>{
                     let { rootPath } = api.context, { config, distPath } = environment, { enable, keep } = normalizeCleanDistPath(config.output.cleanDistPath);
-                    return 'auto' === enable ? isStrictSubdir(rootPath, distPath) ? {
+                    return 'auto' === enable ? isDev && !config.dev.writeToDisk ? void 0 : isStrictSubdir(rootPath, distPath) ? {
                         path: distPath,
                         keep
                     } : (rslog_index_js_namespaceObject.logger.warn('The dist path is not a subdir of root path, Rsbuild will not empty it.'), rslog_index_js_namespaceObject.logger.warn(`Please set ${index_js_default().yellow('`output.cleanDistPath`')} config manually.`), rslog_index_js_namespaceObject.logger.warn(`Current root path: ${index_js_default().dim(rootPath)}`), void rslog_index_js_namespaceObject.logger.warn(`Current dist path: ${index_js_default().dim(distPath)}`)) : !0 === enable ? {
@@ -2104,7 +2125,7 @@ var __webpack_exports__ = {};
                     } : void 0;
                 }, cleanAll = async (params)=>{
                     for (let pathInfo of [
-                        ...Object.values(params.environments).reduce((result, curr)=>(result.find((item)=>item.distPath === curr.distPath) || result.push(curr), result), []).map(getPathInfo),
+                        ...Object.values(params.environments).reduce((result, curr)=>(result.find((item)=>item.distPath === curr.distPath) || result.push(curr), result), []).map((environment)=>getPathInfo(environment, params.isDev)),
                         getRsbuildOutputPath()
                     ].filter((pathInfo)=>!!pathInfo))await emptyDir(pathInfo.path, pathInfo.keep);
                 };
@@ -2112,7 +2133,12 @@ var __webpack_exports__ = {};
                     isFirstCompile && await cleanAll({
                         environments
                     });
-                }), api.onBeforeStartDevServer(cleanAll);
+                }), api.onBeforeStartDevServer(async ({ environments })=>{
+                    await cleanAll({
+                        environments,
+                        isDev: !0
+                    });
+                });
             }
         }), dist_isNil = (o)=>null == o, dist_isFunction = (func)=>'function' == typeof func, dist_isObject = (obj)=>null !== obj && 'object' == typeof obj, dist_isPlainObject = (obj)=>dist_isObject(obj) && '[object Object]' === Object.prototype.toString.call(obj);
     function reduceConfigs({ initial, config, mergeFn = Object.assign }) {
@@ -2342,12 +2368,12 @@ var __webpack_exports__ = {};
     let excludeAsset = (asset)=>/\.(?:map|LICENSE\.txt)$/.test(asset.name), getAssetColor = (size)=>size > 300000 ? index_js_default().red : size > 100000 ? index_js_default().yellow : index_js_default().green, calcFileSize = (len)=>{
         let val = len / 1000;
         return `${val.toFixed(val < 1 ? 2 : 1)} kB`;
-    }, coloringAssetName = (assetName)=>JS_REGEX.test(assetName) ? index_js_default().cyan(assetName) : CSS_REGEX.test(assetName) ? index_js_default().yellow(assetName) : HTML_REGEX.test(assetName) ? index_js_default().green(assetName) : index_js_default().magenta(assetName);
+    }, coloringAssetName = (assetName)=>JS_REGEX.test(assetName) ? index_js_default().cyan(assetName) : CSS_REGEX.test(assetName) ? index_js_default().yellow(assetName) : HTML_REGEX.test(assetName) ? index_js_default().green(assetName) : index_js_default().magenta(assetName), COMPRESSIBLE_REGEX = /\.(?:js|css|html|json|svg|txt|xml|xhtml|wasm|manifest)$/i, isCompressible = (assetName)=>COMPRESSIBLE_REGEX.test(assetName);
     async function printFileSizes(options, stats, rootPath, environmentName) {
         let logs = [];
         if (!1 === options.detail && !1 === options.total) return logs;
         let formatAsset = async (asset, distPath, distFolder)=>{
-            let fileName = asset.name.split('?')[0], contents = await external_node_fs_default().promises.readFile(external_node_path_default().join(distPath, fileName)), size = contents.length, gzippedSize = options.compressed ? await gzipSize(contents) : null, gzipSizeLabel = gzippedSize ? getAssetColor(gzippedSize)(calcFileSize(gzippedSize)) : null;
+            let fileName = asset.name.split('?')[0], contents = await external_node_fs_default().promises.readFile(external_node_path_default().join(distPath, fileName)), size = contents.length, gzippedSize = options.compressed && isCompressible(fileName) ? await gzipSize(contents) : null, gzipSizeLabel = gzippedSize ? getAssetColor(gzippedSize)(calcFileSize(gzippedSize)) : null;
             return {
                 size,
                 folder: external_node_path_default().join(distFolder, external_node_path_default().dirname(fileName)),
@@ -3013,27 +3039,27 @@ var __webpack_exports__ = {};
         apply(compiler) {
             let { splitChunks } = compiler.options.optimization;
             if (!splitChunks) return;
-            let applyPatch = (cacheGroup)=>{
-                if ('object' != typeof cacheGroup || (0, types_namespaceObject.isRegExp)(cacheGroup)) return;
-                let { chunks } = cacheGroup;
+            let applyPatch = (config)=>{
+                if ('object' != typeof config || (0, types_namespaceObject.isRegExp)(config)) return;
+                let { chunks } = config;
                 if (chunks && 'async' !== chunks) {
                     if ('function' == typeof chunks) {
-                        cacheGroup.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunks(chunk);
+                        config.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunks(chunk);
                         return;
                     }
                     if ('all' === chunks) {
-                        cacheGroup.chunks = (chunk)=>!chunk.name || chunk.name !== this.name;
+                        config.chunks = (chunk)=>!chunk.name || chunk.name !== this.name;
                         return;
                     }
                     if ('initial' === chunks) {
-                        cacheGroup.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunk.isOnlyInitial();
+                        config.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunk.isOnlyInitial();
                         return;
                     }
                 }
             };
             applyPatch(splitChunks);
             let { cacheGroups } = splitChunks;
-            if (cacheGroups) for (let cacheGroupKey of Object.keys(cacheGroups))applyPatch(cacheGroups[cacheGroupKey]);
+            if (cacheGroups) for (let cacheGroupKey of Object.keys(cacheGroups))cacheGroups[cacheGroupKey] && applyPatch(cacheGroups[cacheGroupKey]);
         }
         constructor(name){
             !function(obj, key, value) {
@@ -3683,7 +3709,8 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                         return;
                     }
                     try {
-                        module = await import(packagePath);
+                        let moduleURL = 'win32' === process.platform ? (0, external_node_url_namespaceObject.pathToFileURL)(packagePath).href : packagePath;
+                        module = await import(moduleURL);
                     } catch (err) {
                         rslog_index_js_namespaceObject.logger.error(`\`process.env.RSDOCTOR\` enabled, but failed to load ${index_js_default().bold(index_js_default().yellow(packageName))} module.`);
                         return;
@@ -4315,6 +4342,8 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                 ])
             })
         };
+    }, validateRsbuildConfig = (config)=>{
+        if (config.server.base && !config.server.base.startsWith('/')) throw Error('[rsbuild:config] The "server.base" option should start with a slash, for example: "/base"');
     };
     async function initRsbuildConfig({ context, pluginManager }) {
         if (context.normalizedConfig) return context.normalizedConfig;
@@ -4352,7 +4381,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                 }
                 return common.join(external_node_path_namespaceObject.sep);
             }(distPaths);
-        }(context), context.normalizedConfig;
+        }(context), validateRsbuildConfig(context.normalizedConfig), context.normalizedConfig;
     }
     async function initConfigs({ context, pluginManager, rsbuildOptions }) {
         let normalizedConfig = await initRsbuildConfig({
@@ -6588,7 +6617,9 @@ ${section.body}` : section.body).join("\n\n"));
         }
     }
     let cac_dist = (name = "")=>new CAC(name), applyCommonOptions = (cli)=>{
-        cli.option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').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('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
+        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('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
             type: [
                 String
             ],
@@ -6609,12 +6640,12 @@ ${section.body}` : section.body).join("\n\n"));
                 }
             }(), process.title = 'rsbuild-node';
             let { npm_execpath } = process.env;
-            (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), rslog_index_js_namespaceObject.logger.greet(`  Rsbuild v1.2.4\n`);
+            (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), rslog_index_js_namespaceObject.logger.greet(`  Rsbuild v1.2.6\n`);
         }();
         try {
             !function() {
                 let cli = cac_dist('rsbuild');
-                cli.help(), cli.version("1.2.4"), applyCommonOptions(cli);
+                cli.help(), cli.version("1.2.6"), applyCommonOptions(cli);
                 let devCommand = cli.command('dev', 'starting the dev server'), 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 {
@@ -6665,7 +6696,7 @@ ${section.body}` : section.body).join("\n\n"));
             rslog_index_js_namespaceObject.logger.error('Failed to start Rsbuild CLI.'), rslog_index_js_namespaceObject.logger.error(err);
         }
     }
-    let src_rslib_entry_version = "1.2.4";
+    let src_rslib_entry_version = "1.2.6";
 })();
 var __webpack_export_target__ = exports;
 for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];

package/dist/index.js

@@ -827,36 +827,42 @@ let configCache = {}, OVERRIDE_PATHS = [
 async function init({ cliOptions, isRestart, isBuildWatch = !1 }) {
     cliOptions && (commonOpts = cliOptions);
     try {
-        var _config_server, _config_dev, _config_dev1;
+        var _config_server, _config_dev;
         let cwd = process.cwd(), root = commonOpts.root ? getAbsolutePath(cwd, commonOpts.root) : cwd, envs = loadEnv({
             cwd: getEnvDir(root, commonOpts.envDir),
             mode: commonOpts.envMode
         }), { content: config, filePath: configFilePath } = await config_loadConfig({
             cwd: root,
             path: commonOpts.config,
-            envMode: commonOpts.envMode
-        }), command = process.argv[2];
-        if ('dev' === command || isBuildWatch) {
-            let files = [
-                ...envs.filePaths
-            ];
-            if (configFilePath && files.push(configFilePath), null === (_config_dev1 = config.dev) || void 0 === _config_dev1 ? void 0 : _config_dev1.watchFiles) for (let watchFilesConfig of castArray(config.dev.watchFiles)){
-                if ('reload-server' !== watchFilesConfig.type) continue;
-                let paths = castArray(watchFilesConfig.paths);
-                watchFilesConfig.options ? watchFilesForRestart(paths, root, isBuildWatch, watchFilesConfig.options) : files.push(...paths);
-            }
-            watchFilesForRestart(files, root, isBuildWatch);
-        }
+            envMode: commonOpts.envMode,
+            loader: commonOpts.configLoader
+        });
         config.source ||= {}, config.source.define = {
             ...envs.publicVars,
             ...config.source.define
-        }, commonOpts.root && (config.root = root), commonOpts.mode && (config.mode = commonOpts.mode), !commonOpts.open || (null === (_config_server = config.server) || void 0 === _config_server ? void 0 : _config_server.open) || (config.server ||= {}, config.server.open = commonOpts.open), commonOpts.host && (config.server ||= {}, config.server.host = commonOpts.host), commonOpts.port && (config.server ||= {}, config.server.port = commonOpts.port), (null === (_config_dev = config.dev) || void 0 === _config_dev ? void 0 : _config_dev.cliShortcuts) === void 0 && (config.dev ||= {}, config.dev.cliShortcuts = !0);
+        }, commonOpts.base && (config.server ||= {}, config.server.base = commonOpts.base), commonOpts.root && (config.root = root), commonOpts.mode && (config.mode = commonOpts.mode), !commonOpts.open || (null === (_config_server = config.server) || void 0 === _config_server ? void 0 : _config_server.open) || (config.server ||= {}, config.server.open = commonOpts.open), commonOpts.host && (config.server ||= {}, config.server.host = commonOpts.host), commonOpts.port && (config.server ||= {}, config.server.port = commonOpts.port), (null === (_config_dev = config.dev) || void 0 === _config_dev ? void 0 : _config_dev.cliShortcuts) === void 0 && (config.dev ||= {}, config.dev.cliShortcuts = !0);
         let rsbuild = await createRsbuild({
             cwd: root,
             rsbuildConfig: config,
             environment: commonOpts.environment
         });
-        return rsbuild.onCloseBuild(envs.cleanup), rsbuild.onCloseDevServer(envs.cleanup), rsbuild;
+        return rsbuild.onBeforeCreateCompiler(()=>{
+            let command = process.argv[2];
+            if ('dev' === command || isBuildWatch) {
+                var _config_dev;
+                let files = [
+                    ...envs.filePaths
+                ];
+                configFilePath && files.push(configFilePath);
+                let config = rsbuild.getNormalizedConfig();
+                if (null === (_config_dev = config.dev) || void 0 === _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(paths, root, isBuildWatch, watchFilesConfig.options) : files.push(...paths);
+                }
+                watchFilesForRestart(files, root, isBuildWatch);
+            }
+        }), rsbuild.onCloseBuild(envs.cleanup), rsbuild.onCloseDevServer(envs.cleanup), rsbuild;
     } catch (err) {
         if (isRestart) __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error(err);
         else throw err;
@@ -1012,7 +1018,6 @@ let config_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module_ab9f2194__.create
         }
     }), getDefaultPerformanceConfig = ()=>({
         profile: !1,
-        buildCache: !0,
         printFileSize: !0,
         removeConsole: !1,
         removeMomentLocale: !1,
@@ -1145,7 +1150,7 @@ async function watchFilesForRestart(files, root, isBuildWatch, watchOptions) {
     });
     watcher.on('add', callback), watcher.on('change', callback), watcher.on('unlink', callback);
 }
-async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta } = {}) {
+async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta, loader = 'jiti' } = {}) {
     let configExport;
     let configFilePath = resolveConfigPath(cwd, path);
     if (!configFilePath) return {
@@ -1155,10 +1160,11 @@ async function config_loadConfig({ cwd = process.cwd(), path, envMode, meta } =
     let applyMetaInfo = (config)=>(config._privateMeta = {
             configFilePath
         }, config);
-    if (/\.(?:js|mjs|cjs)$/.test(configFilePath)) try {
-        let exportModule = await import(`${configFilePath}?t=${Date.now()}`);
+    if ('native' === loader || /\.(?:js|mjs|cjs)$/.test(configFilePath)) try {
+        let configFileURL = (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.pathToFileURL)(configFilePath).href, exportModule = await import(`${configFileURL}?t=${Date.now()}`);
         configExport = exportModule.default ? exportModule.default : exportModule;
     } catch (err) {
+        if ('native' === loader) throw __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error(`Failed to load file with native loader: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.dim(configFilePath)}`), err;
         __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.debug(`Failed to load file with dynamic import: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.dim(configFilePath)}`);
     }
     try {
@@ -1611,7 +1617,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, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0;
     return {
-        version: "1.2.4",
+        version: "1.2.6",
         rootPath,
         distPath: '',
         cachePath,
@@ -1919,10 +1925,16 @@ let configChain_CHAIN_ID = {
     var _config_performance;
     return process.env.BUNDLE_ANALYZE || (null === (_config_performance = config.performance) || void 0 === _config_performance ? void 0 : _config_performance.bundleAnalyze);
 };
-async function validateCache(cacheDirectory, buildDependencies) {
+async function validateWebpackCache(cacheDirectory, buildDependencies) {
     let configFile = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(cacheDirectory, 'buildDependencies.json');
     if (await isFileExists(configFile)) {
-        if (JSON.stringify(JSON.parse(await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.readFile(configFile, 'utf-8'))) === JSON.stringify(buildDependencies)) return;
+        let rawConfigFile = await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.readFile(configFile, 'utf-8'), prevBuildDependencies = null;
+        try {
+            prevBuildDependencies = JSON.parse(rawConfigFile);
+        } catch (e) {
+            __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.debug('Failed to parse the previous buildDependencies.json', e);
+        }
+        if (JSON.stringify(prevBuildDependencies) === JSON.stringify(buildDependencies)) return;
         await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.rm(cacheDirectory, {
             force: !0,
             recursive: !0
@@ -1959,24 +1971,33 @@ async function getBuildDependencies(context, config, environmentContext) {
 let pluginCache = ()=>({
         name: 'rsbuild:cache',
         setup (api) {
-            'rspack' !== api.context.bundlerType && api.modifyBundlerChain(async (chain, { environment, env })=>{
+            let cacheEnabled = !1;
+            api.modifyBundlerChain(async (chain, { environment, env })=>{
                 var digest;
-                let { config } = environment, { buildCache } = config.performance;
-                if (!1 === buildCache) {
-                    chain.cache(!1);
-                    return;
-                }
+                let { config } = environment, { bundlerType } = api.context, buildCache = config.performance.buildCache ?? 'webpack' === bundlerType;
+                if (!1 === buildCache) return;
+                cacheEnabled = !0;
                 let { context } = api, cacheConfig = 'boolean' == typeof buildCache ? {} : buildCache, cacheDirectory = function({ cacheDirectory }, context) {
                     return cacheDirectory ? (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.isAbsolute)(cacheDirectory) ? cacheDirectory : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(context.rootPath, cacheDirectory) : (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(context.cachePath, context.bundlerType);
                 }(cacheConfig, context), buildDependencies = await getBuildDependencies(context, config, environment);
-                await validateCache(cacheDirectory, buildDependencies);
-                let useDigest = Array.isArray(cacheConfig.cacheDigest) && cacheConfig.cacheDigest.length;
-                chain.cache({
-                    name: useDigest ? `${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}`,
+                '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}`;
+                'rspack' === bundlerType ? (chain.cache(!0), chain.experiments({
+                    ...chain.get('experiments'),
+                    cache: {
+                        type: 'persistent',
+                        version: cacheVersion,
+                        directory: cacheDirectory,
+                        buildDependencies: Object.values(buildDependencies).flat()
+                    }
+                })) : chain.cache({
+                    name: cacheVersion,
                     type: 'filesystem',
                     cacheDirectory,
                     buildDependencies
                 });
+            }), api.onAfterCreateCompiler(()=>{
+                cacheEnabled && 'rspack' === api.context.bundlerType && __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.info(`Rspack persistent cache enabled ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.dim('(experimental)')}`);
             });
         }
     }), addTrailingSep = (dir)=>dir.endsWith(__WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.sep) ? dir : dir + __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.sep, isStrictSubdir = (parent, child)=>{
@@ -2001,9 +2022,9 @@ let pluginCache = ()=>({
                 if (!0 === enable || 'auto' === enable && isStrictSubdir(rootPath, targetPath)) return {
                     path: targetPath
                 };
-            }, getPathInfo = (environment)=>{
+            }, getPathInfo = (environment, isDev)=>{
                 let { rootPath } = api.context, { config, distPath } = environment, { enable, keep } = normalizeCleanDistPath(config.output.cleanDistPath);
-                return 'auto' === enable ? isStrictSubdir(rootPath, distPath) ? {
+                return 'auto' === enable ? isDev && !config.dev.writeToDisk ? void 0 : isStrictSubdir(rootPath, distPath) ? {
                     path: distPath,
                     keep
                 } : (__WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn('The dist path is not a subdir of root path, Rsbuild will not empty it.'), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(`Please set ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow('`output.cleanDistPath`')} config manually.`), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(`Current root path: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.dim(rootPath)}`), void __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.warn(`Current dist path: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.dim(distPath)}`)) : !0 === enable ? {
@@ -2012,7 +2033,7 @@ let pluginCache = ()=>({
                 } : void 0;
             }, cleanAll = async (params)=>{
                 for (let pathInfo of [
-                    ...Object.values(params.environments).reduce((result, curr)=>(result.find((item)=>item.distPath === curr.distPath) || result.push(curr), result), []).map(getPathInfo),
+                    ...Object.values(params.environments).reduce((result, curr)=>(result.find((item)=>item.distPath === curr.distPath) || result.push(curr), result), []).map((environment)=>getPathInfo(environment, params.isDev)),
                     getRsbuildOutputPath()
                 ].filter((pathInfo)=>!!pathInfo))await emptyDir(pathInfo.path, pathInfo.keep);
             };
@@ -2020,7 +2041,12 @@ let pluginCache = ()=>({
                 isFirstCompile && await cleanAll({
                     environments
                 });
-            }), api.onBeforeStartDevServer(cleanAll);
+            }), api.onBeforeStartDevServer(async ({ environments })=>{
+                await cleanAll({
+                    environments,
+                    isDev: !0
+                });
+            });
         }
     }), dist_isNil = (o)=>null == o, dist_isFunction = (func)=>'function' == typeof func, dist_isObject = (obj)=>null !== obj && 'object' == typeof obj, dist_isPlainObject = (obj)=>dist_isObject(obj) && '[object Object]' === Object.prototype.toString.call(obj);
 function reduceConfigs({ initial, config, mergeFn = Object.assign }) {
@@ -2248,12 +2274,12 @@ async function gzipSize(input) {
 let excludeAsset = (asset)=>/\.(?:map|LICENSE\.txt)$/.test(asset.name), getAssetColor = (size)=>size > 300000 ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.red : size > 100000 ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow : __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.green, calcFileSize = (len)=>{
     let val = len / 1000;
     return `${val.toFixed(val < 1 ? 2 : 1)} kB`;
-}, coloringAssetName = (assetName)=>JS_REGEX.test(assetName) ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan(assetName) : CSS_REGEX.test(assetName) ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(assetName) : HTML_REGEX.test(assetName) ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.green(assetName) : __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.magenta(assetName);
+}, coloringAssetName = (assetName)=>JS_REGEX.test(assetName) ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan(assetName) : CSS_REGEX.test(assetName) ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(assetName) : HTML_REGEX.test(assetName) ? __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.green(assetName) : __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.magenta(assetName), COMPRESSIBLE_REGEX = /\.(?:js|css|html|json|svg|txt|xml|xhtml|wasm|manifest)$/i, isCompressible = (assetName)=>COMPRESSIBLE_REGEX.test(assetName);
 async function printFileSizes(options, stats, rootPath, environmentName) {
     let logs = [];
     if (!1 === options.detail && !1 === options.total) return logs;
     let formatAsset = async (asset, distPath, distFolder)=>{
-        let fileName = asset.name.split('?')[0], contents = await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.readFile(__WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.default.join(distPath, fileName)), size = contents.length, gzippedSize = options.compressed ? await gzipSize(contents) : null, gzipSizeLabel = gzippedSize ? getAssetColor(gzippedSize)(calcFileSize(gzippedSize)) : null;
+        let fileName = asset.name.split('?')[0], contents = await __WEBPACK_EXTERNAL_MODULE_node_fs_5ea92f0c__.default.promises.readFile(__WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.default.join(distPath, fileName)), size = contents.length, gzippedSize = options.compressed && isCompressible(fileName) ? await gzipSize(contents) : null, gzipSizeLabel = gzippedSize ? getAssetColor(gzippedSize)(calcFileSize(gzippedSize)) : null;
         return {
             size,
             folder: __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.default.join(distFolder, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.default.dirname(fileName)),
@@ -2919,27 +2945,27 @@ class PatchSplitChunksPlugin {
     apply(compiler) {
         let { splitChunks } = compiler.options.optimization;
         if (!splitChunks) return;
-        let applyPatch = (cacheGroup)=>{
-            if ('object' != typeof cacheGroup || (0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(cacheGroup)) return;
-            let { chunks } = cacheGroup;
+        let applyPatch = (config)=>{
+            if ('object' != typeof config || (0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(config)) return;
+            let { chunks } = config;
             if (chunks && 'async' !== chunks) {
                 if ('function' == typeof chunks) {
-                    cacheGroup.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunks(chunk);
+                    config.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunks(chunk);
                     return;
                 }
                 if ('all' === chunks) {
-                    cacheGroup.chunks = (chunk)=>!chunk.name || chunk.name !== this.name;
+                    config.chunks = (chunk)=>!chunk.name || chunk.name !== this.name;
                     return;
                 }
                 if ('initial' === chunks) {
-                    cacheGroup.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunk.isOnlyInitial();
+                    config.chunks = (chunk)=>(!chunk.name || chunk.name !== this.name) && chunk.isOnlyInitial();
                     return;
                 }
             }
         };
         applyPatch(splitChunks);
         let { cacheGroups } = splitChunks;
-        if (cacheGroups) for (let cacheGroupKey of Object.keys(cacheGroups))applyPatch(cacheGroups[cacheGroupKey]);
+        if (cacheGroups) for (let cacheGroupKey of Object.keys(cacheGroups))cacheGroups[cacheGroupKey] && applyPatch(cacheGroups[cacheGroupKey]);
     }
     constructor(name){
         var key, value;
@@ -3584,7 +3610,8 @@ let resourceHints_generateLinks = (options, rel)=>options.map((option)=>({
                     return;
                 }
                 try {
-                    module = await import(packagePath);
+                    let moduleURL = 'win32' === process.platform ? (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.pathToFileURL)(packagePath).href : packagePath;
+                    module = await import(moduleURL);
                 } catch (err) {
                     __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error(`\`process.env.RSDOCTOR\` enabled, but failed to load ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.bold(__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(packageName))} module.`);
                     return;
@@ -4212,6 +4239,8 @@ let initEnvironmentConfigs = (normalizedConfig, rootPath, specifiedEnvironments)
             ])
         })
     };
+}, validateRsbuildConfig = (config)=>{
+    if (config.server.base && !config.server.base.startsWith('/')) throw Error('[rsbuild:config] The "server.base" option should start with a slash, for example: "/base"');
 };
 async function initRsbuildConfig({ context, pluginManager }) {
     if (context.normalizedConfig) return context.normalizedConfig;
@@ -4249,7 +4278,7 @@ async function initRsbuildConfig({ context, pluginManager }) {
             }
             return common.join(__WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.sep);
         }(distPaths);
-    }(context), context.normalizedConfig;
+    }(context), validateRsbuildConfig(context.normalizedConfig), context.normalizedConfig;
 }
 async function initConfigs({ context, pluginManager, rsbuildOptions }) {
     let normalizedConfig = await initRsbuildConfig({
@@ -6476,7 +6505,9 @@ class CAC extends __WEBPACK_EXTERNAL_MODULE_events__.EventEmitter {
     }
 }
 let cac_dist = (name = "")=>new CAC(name), applyCommonOptions = (cli)=>{
-    cli.option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').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('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
+    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('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
         type: [
             String
         ],
@@ -6497,12 +6528,12 @@ 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.2.4\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.2.6\n`);
     }();
     try {
         !function() {
             let cli = cac_dist('rsbuild');
-            cli.help(), cli.version("1.2.4"), applyCommonOptions(cli);
+            cli.help(), cli.version("1.2.6"), applyCommonOptions(cli);
             let devCommand = cli.command('dev', 'starting the dev server'), 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 {
@@ -6553,6 +6584,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.2.4";
+let src_version = "1.2.6";
 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, 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/cli/commands.d.ts

@@ -1,8 +1,11 @@
+import type { ConfigLoader } from '../config';
 import type { RsbuildMode } from '../types';
 export type CommonOptions = {
+    base?: string;
     root?: string;
     mode?: RsbuildMode;
     config?: string;
+    configLoader?: ConfigLoader;
     envDir?: string;
     envMode?: string;
     open?: boolean | string;

package/dist-types/config.d.ts

@@ -46,6 +46,13 @@ export type LoadConfigOptions = {
      * @default process.env.NODE_ENV
      */
     envMode?: string;
+    /**
+     * Specify the config loader, can be `jiti` or `native`.
+     * - 'jiti': Use `jiti` as loader, which supports TypeScript and ESM out of the box
+     * - 'native': Use native Node.js loader, requires TypeScript support in Node.js >= 22.6
+     * @default 'jiti'
+     */
+    loader?: ConfigLoader;
 };
 export type LoadConfigResult = {
     /**
@@ -58,7 +65,8 @@ export type LoadConfigResult = {
      */
     filePath: string | null;
 };
-export declare function loadConfig({ cwd, path, envMode, meta, }?: LoadConfigOptions): Promise<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;

package/dist-types/index.d.ts

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

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

@@ -325,8 +325,16 @@ export interface SecurityConfig {
 export type NormalizedSecurityConfig = Required<SecurityConfig>;
 export type ConsoleType = 'log' | 'info' | 'warn' | 'error' | 'table' | 'group';
 export type BuildCacheOptions = {
-    /** Base directory for the filesystem cache. */
+    /**
+     * The output directory of the cache files.
+     * @default 'node_modules/.cache'
+     */
     cacheDirectory?: string;
+    /**
+     * Add additional cache digests, the previous build cache will be invalidated
+     * when any value in the array changes.
+     * @default undefined
+     */
     cacheDigest?: Array<string | undefined>;
 };
 export type PrintFileSizeAsset = {
@@ -400,7 +408,8 @@ export interface PerformanceConfig {
      */
     removeMomentLocale?: boolean;
     /**
-     * Controls the Rsbuild's caching behavior during the build process.
+     * To enable or configure persistent build cache.
+     * @experimental This feature is experimental and may be changed in the future.
      */
     buildCache?: BuildCacheOptions | boolean;
     /**
@@ -448,7 +457,6 @@ export interface PerformanceConfig {
 }
 export interface NormalizedPerformanceConfig extends PerformanceConfig {
     printFileSize: PrintFileSizeOptions | boolean;
-    buildCache: BuildCacheOptions | boolean;
     chunkSplit: RsbuildChunkSplit;
 }
 export type SplitChunks = Configuration extends {
@@ -456,16 +464,6 @@ export type SplitChunks = Configuration extends {
         splitChunks?: infer P;
     };
 } ? P : never;
-export type CacheGroups = Configuration extends {
-    optimization?: {
-        splitChunks?: {
-            cacheGroups?: infer P;
-        } | false;
-    };
-} ? P : never;
-export type CacheGroup = CacheGroups extends {
-    [key: string]: infer P;
-} ? P : null;
 export type ForceSplitting = RegExp[] | Record<string, RegExp>;
 export interface BaseSplitRules {
     strategy?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.dev",
   "bugs": {
@@ -52,9 +52,9 @@
     "core-js": "~3.40.0"
   },
   "devDependencies": {
-    "@rslib/core": "0.4.0",
+    "@rslib/core": "0.4.1",
     "@types/connect": "3.4.38",
-    "@types/node": "^22.13.0",
+    "@types/node": "^22.13.1",
     "@types/on-finished": "2.3.4",
     "@types/webpack-bundle-analyzer": "4.7.0",
     "@types/ws": "^8.5.14",