@rsbuild/core 1.2.3 → 1.2.4

package/dist/index.cjs

@@ -384,7 +384,6 @@ var __webpack_exports__ = {};
     });
     var provider_helpers_namespaceObject = {};
     __webpack_require__.r(provider_helpers_namespaceObject), __webpack_require__.d(provider_helpers_namespaceObject, {
-        chainToConfig: ()=>chainToConfig,
         createDevServer: ()=>devServer_createDevServer,
         formatStats: ()=>formatStats,
         getChainUtils: ()=>getChainUtils,
@@ -1703,7 +1702,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.3",
+            version: "1.2.4",
             rootPath,
             distPath: '',
             cachePath,
@@ -1846,26 +1845,6 @@ var __webpack_exports__ = {};
         if (null === (_utils_environment_config_tools = utils.environment.config.tools) || void 0 === _utils_environment_config_tools ? void 0 : _utils_environment_config_tools.bundlerChain) for (let item of castArray(utils.environment.config.tools.bundlerChain))await item(modifiedBundlerChain, utils);
         return rslog_index_js_namespaceObject.logger.debug('modify bundler chain done'), modifiedBundlerChain;
     }
-    function chainToConfig(chain) {
-        let config = chain.toConfig(), { entry } = config;
-        if (!isPlainObject(entry)) return config;
-        let formattedEntry = {};
-        for (let [entryName, entryValue] of Object.entries(entry)){
-            let entryImport = [], entryDescription = null;
-            for (let item of castArray(entryValue)){
-                if ('string' == typeof item) {
-                    entryImport.push(item);
-                    continue;
-                }
-                item.import && entryImport.push(...castArray(item.import)), entryDescription ? Object.assign(entryDescription, item) : entryDescription = item;
-            }
-            formattedEntry[entryName] = entryDescription ? {
-                ...entryDescription,
-                import: entryImport
-            } : entryImport;
-        }
-        return config.entry = formattedEntry, config;
-    }
     let configChain_CHAIN_ID = {
         RULE: {
             MJS: 'mjs',
@@ -1993,7 +1972,7 @@ var __webpack_exports__ = {};
                     }
                 });
             }
-        }), getJsSourceMap = (config)=>{
+        }), getDevtool = (config)=>{
         let { sourceMap } = config.output, isProd = 'production' === config.mode;
         return !1 !== sourceMap && (!0 === sourceMap ? isProd ? 'source-map' : 'cheap-module-source-map' : void 0 === sourceMap.js ? !isProd && 'cheap-module-source-map' : sourceMap.js);
     }, pluginBasic = ()=>({
@@ -2001,7 +1980,16 @@ var __webpack_exports__ = {};
             setup (api) {
                 api.modifyBundlerChain((chain, { env, isDev, target, bundler, environment, CHAIN_ID })=>{
                     let { config } = environment;
-                    chain.name(environment.name), chain.devtool(getJsSourceMap(config)), chain.context(api.context.rootPath), chain.mode(environment.config.mode), chain.merge({
+                    chain.name(environment.name);
+                    let devtool = getDevtool(config);
+                    chain.devtool(devtool);
+                    let { sourceMap } = config.output;
+                    !devtool && 'object' == typeof sourceMap && sourceMap.css && chain.plugin('source-map-css').use(bundler.SourceMapDevToolPlugin, [
+                        {
+                            test: /\.css$/,
+                            filename: '[file].map[query]'
+                        }
+                    ]), chain.context(api.context.rootPath), chain.mode(environment.config.mode), chain.merge({
                         infrastructureLogging: {
                             level: 'error'
                         }
@@ -3227,12 +3215,16 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             detail.family !== familyV4Value || ipv4Interfaces.has(detail.address) || ipv4Interfaces.set(detail.address, detail);
         }
         return Array.from(ipv4Interfaces.values());
-    }, isLoopbackHost = (host)=>[
+    }, isWildcardHost = (host)=>new Set([
+            '0.0.0.0',
+            '::',
+            '0000:0000:0000:0000:0000:0000:0000:0000'
+        ]).has(host), isLoopbackHost = (host)=>new Set([
             'localhost',
             '127.0.0.1',
             '::1',
             '0000:0000:0000:0000:0000:0000:0000:0001'
-        ].includes(host), getHostInUrl = (host)=>host === DEFAULT_DEV_HOST ? 'localhost' : external_node_net_default().isIPv6(host) ? '::' === host ? '[::1]' : `[${host}]` : host, concatUrl = ({ host, port, protocol })=>`${protocol}://${host}:${port}`, LOCAL_LABEL = 'Local:  ', NETWORK_LABEL = 'Network:  ', getUrlLabel = (url)=>{
+        ]).has(host), getHostInUrl = (host)=>host === DEFAULT_DEV_HOST ? 'localhost' : external_node_net_default().isIPv6(host) ? '::' === host ? '[::1]' : `[${host}]` : host, concatUrl = ({ host, port, protocol })=>`${protocol}://${host}:${port}`, LOCAL_LABEL = 'Local:  ', NETWORK_LABEL = 'Network:  ', getUrlLabel = (url)=>{
         try {
             let { host } = new URL(url);
             return isLoopbackHost(host) ? LOCAL_LABEL : NETWORK_LABEL;
@@ -4227,16 +4219,17 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
         };
     }
     async function generateRspackConfig({ target, context, environment }) {
-        let chainUtils = getChainUtils(target, context.environments[environment]), { BannerPlugin, DefinePlugin, IgnorePlugin, ProvidePlugin, HotModuleReplacementPlugin } = core_namespaceObject.rspack, rspackConfig = chainToConfig(await modifyBundlerChain(context, {
+        let chainUtils = getChainUtils(target, context.environments[environment]), { BannerPlugin, DefinePlugin, IgnorePlugin, ProvidePlugin, SourceMapDevToolPlugin, HotModuleReplacementPlugin } = core_namespaceObject.rspack, rspackConfig = (await modifyBundlerChain(context, {
             ...chainUtils,
             bundler: {
                 BannerPlugin,
                 DefinePlugin,
                 IgnorePlugin,
                 ProvidePlugin,
+                SourceMapDevToolPlugin,
                 HotModuleReplacementPlugin
             }
-        }));
+        })).toConfig();
         return !function(config) {
             if (config.plugins) {
                 for (let plugin of config.plugins)if (plugin && void 0 === plugin.apply && 'name' in plugin && 'setup' in plugin) {
@@ -4449,6 +4442,31 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             rl.close();
         };
     }
+    let external_node_dns_namespaceObject = require("node:dns");
+    async function getLocalhostResolvedAddress() {
+        let [defaultLookup, explicitLookup] = await Promise.all([
+            external_node_dns_namespaceObject.promises.lookup('localhost'),
+            external_node_dns_namespaceObject.promises.lookup('localhost', {
+                verbatim: !0
+            })
+        ]);
+        return defaultLookup.family === explicitLookup.family && defaultLookup.address === explicitLookup.address ? void 0 : defaultLookup.address;
+    }
+    async function resolveHostname(host = 'localhost') {
+        if ('localhost' === host) {
+            let resolvedAddress = await getLocalhostResolvedAddress();
+            if (resolvedAddress) return resolvedAddress;
+        }
+        return void 0 === host || isWildcardHost(host) ? 'localhost' : host;
+    }
+    async function getResolvedClientConfig(clientConfig, serverConfig) {
+        let resolvedHost = await resolveHostname(serverConfig.host);
+        return {
+            ...clientConfig,
+            host: resolvedHost,
+            port: serverConfig.port
+        };
+    }
     let isClientCompiler = (compiler)=>{
         let { target } = compiler.options;
         return !!target && (Array.isArray(target) ? target.includes('web') : 'web' === target);
@@ -4465,13 +4483,14 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
         }), done.tap('rsbuild-dev-server', hookCallbacks.onDone);
     }, getDevMiddleware = async (multiCompiler)=>{
         let { default: rsbuildDevMiddleware } = await Promise.resolve().then(__webpack_require__.bind(__webpack_require__, "../../compiled/rsbuild-dev-middleware/index.js"));
-        return (options)=>{
-            let { clientPaths, clientConfig, callbacks, liveReload, ...restOptions } = options;
+        return async (options)=>{
+            let { clientPaths, clientConfig, callbacks, liveReload, serverConfig, ...restOptions } = options, resolvedClientConfig = await getResolvedClientConfig(clientConfig, serverConfig);
             return applyToCompiler(multiCompiler, (compiler)=>{
-                clientPaths && function({ compiler, clientPaths, clientConfig = {}, liveReload = !0 }) {
+                clientPaths && function({ compiler, clientPaths, clientConfig = {}, resolvedClientConfig = {}, liveReload = !0 }) {
                     if (isClientCompiler(compiler)) for (let clientPath of (new compiler.webpack.DefinePlugin({
                         RSBUILD_COMPILATION_NAME: JSON.stringify(getCompilationId(compiler)),
                         RSBUILD_CLIENT_CONFIG: JSON.stringify(clientConfig),
+                        RSBUILD_RESOLVED_CLIENT_CONFIG: JSON.stringify(resolvedClientConfig),
                         RSBUILD_DEV_LIVE_RELOAD: liveReload
                     }).apply(compiler), clientPaths))new compiler.webpack.EntryPlugin(compiler.context, clientPath, {
                         name: void 0
@@ -4480,6 +4499,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                     compiler,
                     clientPaths,
                     clientConfig,
+                    resolvedClientConfig,
                     liveReload
                 }), setupServerHooks(compiler, callbacks);
             }), rsbuildDevMiddleware(multiCompiler, restOptions);
@@ -4818,7 +4838,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
     class CompilerDevMiddleware {
         async init() {
             let devMiddleware = await getDevMiddleware(this.compiler);
-            this.middleware = this.setupDevMiddleware(devMiddleware, this.publicPaths), await this.socketServer.prepare();
+            this.middleware = await this.setupDevMiddleware(devMiddleware, this.publicPaths), await this.socketServer.prepare();
         }
         upgrade(req, sock, head) {
             this.socketServer.upgrade(req, sock, head);
@@ -4840,8 +4860,12 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                 data
             });
         }
-        setupDevMiddleware(devMiddleware, publicPaths) {
-            let { devConfig, serverConfig: { headers, base } } = this, middleware = devMiddleware({
+        async setupDevMiddleware(devMiddleware, publicPaths) {
+            let { devConfig, serverConfig } = this, { headers, base } = serverConfig, clientPaths = function(devConfig) {
+                var _devConfig_client;
+                let clientPaths = [];
+                return (devConfig.hmr || devConfig.liveReload) && (clientPaths.push(compilerDevMiddleware_require.resolve('@rsbuild/core/client/hmr')), (null === (_devConfig_client = devConfig.client) || void 0 === _devConfig_client ? void 0 : _devConfig_client.overlay) && clientPaths.push(`${compilerDevMiddleware_require.resolve('@rsbuild/core/client/overlay')}`)), clientPaths;
+            }(devConfig), middleware = await devMiddleware({
                 headers,
                 publicPath: '/',
                 stats: !1,
@@ -4863,16 +4887,13 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                         this.socketServer.updateStats(stats);
                     }
                 },
-                clientPaths: function(devConfig) {
-                    var _devConfig_client;
-                    let clientPaths = [];
-                    return (devConfig.hmr || devConfig.liveReload) && (clientPaths.push(compilerDevMiddleware_require.resolve('@rsbuild/core/client/hmr')), (null === (_devConfig_client = devConfig.client) || void 0 === _devConfig_client ? void 0 : _devConfig_client.overlay) && clientPaths.push(`${compilerDevMiddleware_require.resolve('@rsbuild/core/client/overlay')}`)), clientPaths;
-                }(devConfig),
+                clientPaths: clientPaths,
                 clientConfig: devConfig.client,
                 liveReload: devConfig.liveReload,
                 writeToDisk: devConfig.writeToDisk,
                 serverSideRender: !0,
-                etag: 'weak'
+                etag: 'weak',
+                serverConfig
             }), assetPrefixes = publicPaths.map(pathnameParse).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)=>{
@@ -5300,7 +5321,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
         }(proxyOptions), proxyMiddlewares = [], middlewares = [], { createProxyMiddleware: baseMiddleware } = await Promise.resolve().then(__webpack_require__.bind(__webpack_require__, "../../compiled/http-proxy-middleware/index.js"));
         for (let opts of formattedOptions){
             let proxyMiddleware = baseMiddleware(opts.context, opts), middleware = async (req, res, next)=>{
-                let bypassUrl = 'function' == typeof opts.bypass ? opts.bypass(req, res, opts) : null;
+                let bypassUrl = 'function' == typeof opts.bypass ? await opts.bypass(req, res, opts) : null;
                 !1 === bypassUrl ? (res.statusCode = 404, next()) : 'string' == typeof bypassUrl ? (req.url = bypassUrl, next()) : !0 === bypassUrl ? next() : proxyMiddleware(req, res, next);
             };
             middlewares.push(middleware), opts.ws && proxyMiddlewares.push(proxyMiddleware);
@@ -5960,7 +5981,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
                             if (isFunction(plugin.apply)) {
                                 let { name = 'SomeWebpackPlugin' } = plugin.constructor || {};
                                 throw Error([
-                                    `${index_js_default().yellow(name)} looks like a Webpack or Rspack plugin, please use ${index_js_default().yellow('`tools.rspack`')} to register it:`,
+                                    `${index_js_default().yellow(name)} looks like a webpack or Rspack plugin, please use ${index_js_default().yellow('`tools.rspack`')} to register it:`,
                                     index_js_default().green(`
   // rsbuild.config.ts
   export default {
@@ -6588,12 +6609,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.3\n`);
+            (!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`);
         }();
         try {
             !function() {
                 let cli = cac_dist('rsbuild');
-                cli.help(), cli.version("1.2.3"), applyCommonOptions(cli);
+                cli.help(), cli.version("1.2.4"), 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 {
@@ -6644,7 +6665,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.3";
+    let src_rslib_entry_version = "1.2.4";
 })();
 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

@@ -22,6 +22,7 @@ import * as __WEBPACK_EXTERNAL_MODULE_node_os_74b4b876__ from "node:os";
 import * as __WEBPACK_EXTERNAL_MODULE_node_inspector_dd9822d6__ from "node:inspector";
 import * as __WEBPACK_EXTERNAL_MODULE_node_assert_3e74d44e__ from "node:assert";
 import * as __WEBPACK_EXTERNAL_MODULE_node_readline_91c31510__ from "node:readline";
+import * as __WEBPACK_EXTERNAL_MODULE_node_dns_78d346ee__ from "node:dns";
 import * as __WEBPACK_EXTERNAL_MODULE_node_querystring_aeb3c0b4__ from "node:querystring";
 import * as __WEBPACK_EXTERNAL_MODULE_node_vm_bd3d9cea__ from "node:vm";
 import * as __WEBPACK_EXTERNAL_MODULE_events__ from "events";
@@ -305,7 +306,6 @@ __webpack_require__.n = function(module) {
 };
 var provider_helpers_namespaceObject = {};
 __webpack_require__.r(provider_helpers_namespaceObject), __webpack_require__.d(provider_helpers_namespaceObject, {
-    chainToConfig: ()=>chainToConfig,
     createDevServer: ()=>devServer_createDevServer,
     formatStats: ()=>formatStats,
     getChainUtils: ()=>getChainUtils,
@@ -1611,7 +1611,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.3",
+        version: "1.2.4",
         rootPath,
         distPath: '',
         cachePath,
@@ -1754,26 +1754,6 @@ async function modifyBundlerChain(context, utils) {
     if (null === (_utils_environment_config_tools = utils.environment.config.tools) || void 0 === _utils_environment_config_tools ? void 0 : _utils_environment_config_tools.bundlerChain) for (let item of castArray(utils.environment.config.tools.bundlerChain))await item(modifiedBundlerChain, utils);
     return __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.debug('modify bundler chain done'), modifiedBundlerChain;
 }
-function chainToConfig(chain) {
-    let config = chain.toConfig(), { entry } = config;
-    if (!isPlainObject(entry)) return config;
-    let formattedEntry = {};
-    for (let [entryName, entryValue] of Object.entries(entry)){
-        let entryImport = [], entryDescription = null;
-        for (let item of castArray(entryValue)){
-            if ('string' == typeof item) {
-                entryImport.push(item);
-                continue;
-            }
-            item.import && entryImport.push(...castArray(item.import)), entryDescription ? Object.assign(entryDescription, item) : entryDescription = item;
-        }
-        formattedEntry[entryName] = entryDescription ? {
-            ...entryDescription,
-            import: entryImport
-        } : entryImport;
-    }
-    return config.entry = formattedEntry, config;
-}
 let configChain_CHAIN_ID = {
     RULE: {
         MJS: 'mjs',
@@ -1901,7 +1881,7 @@ let configChain_CHAIN_ID = {
                 }
             });
         }
-    }), getJsSourceMap = (config)=>{
+    }), getDevtool = (config)=>{
     let { sourceMap } = config.output, isProd = 'production' === config.mode;
     return !1 !== sourceMap && (!0 === sourceMap ? isProd ? 'source-map' : 'cheap-module-source-map' : void 0 === sourceMap.js ? !isProd && 'cheap-module-source-map' : sourceMap.js);
 }, pluginBasic = ()=>({
@@ -1909,7 +1889,16 @@ let configChain_CHAIN_ID = {
         setup (api) {
             api.modifyBundlerChain((chain, { env, isDev, target, bundler, environment, CHAIN_ID })=>{
                 let { config } = environment;
-                chain.name(environment.name), chain.devtool(getJsSourceMap(config)), chain.context(api.context.rootPath), chain.mode(environment.config.mode), chain.merge({
+                chain.name(environment.name);
+                let devtool = getDevtool(config);
+                chain.devtool(devtool);
+                let { sourceMap } = config.output;
+                !devtool && 'object' == typeof sourceMap && sourceMap.css && chain.plugin('source-map-css').use(bundler.SourceMapDevToolPlugin, [
+                    {
+                        test: /\.css$/,
+                        filename: '[file].map[query]'
+                    }
+                ]), chain.context(api.context.rootPath), chain.mode(environment.config.mode), chain.merge({
                     infrastructureLogging: {
                         level: 'error'
                     }
@@ -3127,12 +3116,16 @@ let getPort = async ({ host, port, strictPort, tryLimits = 20 })=>{
         detail.family !== familyV4Value || ipv4Interfaces.has(detail.address) || ipv4Interfaces.set(detail.address, detail);
     }
     return Array.from(ipv4Interfaces.values());
-}, isLoopbackHost = (host)=>[
+}, isWildcardHost = (host)=>new Set([
+        '0.0.0.0',
+        '::',
+        '0000:0000:0000:0000:0000:0000:0000:0000'
+    ]).has(host), isLoopbackHost = (host)=>new Set([
         'localhost',
         '127.0.0.1',
         '::1',
         '0000:0000:0000:0000:0000:0000:0000:0001'
-    ].includes(host), getHostInUrl = (host)=>host === DEFAULT_DEV_HOST ? 'localhost' : __WEBPACK_EXTERNAL_MODULE_node_net_0373943e__.default.isIPv6(host) ? '::' === host ? '[::1]' : `[${host}]` : host, concatUrl = ({ host, port, protocol })=>`${protocol}://${host}:${port}`, LOCAL_LABEL = 'Local:  ', NETWORK_LABEL = 'Network:  ', getUrlLabel = (url)=>{
+    ]).has(host), getHostInUrl = (host)=>host === DEFAULT_DEV_HOST ? 'localhost' : __WEBPACK_EXTERNAL_MODULE_node_net_0373943e__.default.isIPv6(host) ? '::' === host ? '[::1]' : `[${host}]` : host, concatUrl = ({ host, port, protocol })=>`${protocol}://${host}:${port}`, LOCAL_LABEL = 'Local:  ', NETWORK_LABEL = 'Network:  ', getUrlLabel = (url)=>{
     try {
         let { host } = new URL(url);
         return isLoopbackHost(host) ? LOCAL_LABEL : NETWORK_LABEL;
@@ -4123,16 +4116,17 @@ function getChainUtils(target, environment) {
     };
 }
 async function generateRspackConfig({ target, context, environment }) {
-    let chainUtils = getChainUtils(target, context.environments[environment]), { BannerPlugin, DefinePlugin, IgnorePlugin, ProvidePlugin, HotModuleReplacementPlugin } = __WEBPACK_EXTERNAL_MODULE__rspack_core_e0096ff7__.rspack, rspackConfig = chainToConfig(await modifyBundlerChain(context, {
+    let chainUtils = getChainUtils(target, context.environments[environment]), { BannerPlugin, DefinePlugin, IgnorePlugin, ProvidePlugin, SourceMapDevToolPlugin, HotModuleReplacementPlugin } = __WEBPACK_EXTERNAL_MODULE__rspack_core_e0096ff7__.rspack, rspackConfig = (await modifyBundlerChain(context, {
         ...chainUtils,
         bundler: {
             BannerPlugin,
             DefinePlugin,
             IgnorePlugin,
             ProvidePlugin,
+            SourceMapDevToolPlugin,
             HotModuleReplacementPlugin
         }
-    }));
+    })).toConfig();
     return !function(config) {
         if (config.plugins) {
             for (let plugin of config.plugins)if (plugin && void 0 === plugin.apply && 'name' in plugin && 'setup' in plugin) {
@@ -4343,6 +4337,30 @@ function setupCliShortcuts({ help = !0, openPage, closeServer, printUrls, restar
         rl.close();
     };
 }
+async function getLocalhostResolvedAddress() {
+    let [defaultLookup, explicitLookup] = await Promise.all([
+        __WEBPACK_EXTERNAL_MODULE_node_dns_78d346ee__.promises.lookup('localhost'),
+        __WEBPACK_EXTERNAL_MODULE_node_dns_78d346ee__.promises.lookup('localhost', {
+            verbatim: !0
+        })
+    ]);
+    return defaultLookup.family === explicitLookup.family && defaultLookup.address === explicitLookup.address ? void 0 : defaultLookup.address;
+}
+async function resolveHostname(host = 'localhost') {
+    if ('localhost' === host) {
+        let resolvedAddress = await getLocalhostResolvedAddress();
+        if (resolvedAddress) return resolvedAddress;
+    }
+    return void 0 === host || isWildcardHost(host) ? 'localhost' : host;
+}
+async function getResolvedClientConfig(clientConfig, serverConfig) {
+    let resolvedHost = await resolveHostname(serverConfig.host);
+    return {
+        ...clientConfig,
+        host: resolvedHost,
+        port: serverConfig.port
+    };
+}
 let isClientCompiler = (compiler)=>{
     let { target } = compiler.options;
     return !!target && (Array.isArray(target) ? target.includes('web') : 'web' === target);
@@ -4359,13 +4377,14 @@ let isClientCompiler = (compiler)=>{
     }), done.tap('rsbuild-dev-server', hookCallbacks.onDone);
 }, getDevMiddleware = async (multiCompiler)=>{
     let { default: rsbuildDevMiddleware } = await import("../compiled/rsbuild-dev-middleware/index.js");
-    return (options)=>{
-        let { clientPaths, clientConfig, callbacks, liveReload, ...restOptions } = options;
+    return async (options)=>{
+        let { clientPaths, clientConfig, callbacks, liveReload, serverConfig, ...restOptions } = options, resolvedClientConfig = await getResolvedClientConfig(clientConfig, serverConfig);
         return applyToCompiler(multiCompiler, (compiler)=>{
-            clientPaths && function({ compiler, clientPaths, clientConfig = {}, liveReload = !0 }) {
+            clientPaths && function({ compiler, clientPaths, clientConfig = {}, resolvedClientConfig = {}, liveReload = !0 }) {
                 if (isClientCompiler(compiler)) for (let clientPath of (new compiler.webpack.DefinePlugin({
                     RSBUILD_COMPILATION_NAME: JSON.stringify(getCompilationId(compiler)),
                     RSBUILD_CLIENT_CONFIG: JSON.stringify(clientConfig),
+                    RSBUILD_RESOLVED_CLIENT_CONFIG: JSON.stringify(resolvedClientConfig),
                     RSBUILD_DEV_LIVE_RELOAD: liveReload
                 }).apply(compiler), clientPaths))new compiler.webpack.EntryPlugin(compiler.context, clientPath, {
                     name: void 0
@@ -4374,6 +4393,7 @@ let isClientCompiler = (compiler)=>{
                 compiler,
                 clientPaths,
                 clientConfig,
+                resolvedClientConfig,
                 liveReload
             }), setupServerHooks(compiler, callbacks);
         }), rsbuildDevMiddleware(multiCompiler, restOptions);
@@ -4712,7 +4732,7 @@ let compilerDevMiddleware_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module_ab
 class CompilerDevMiddleware {
     async init() {
         let devMiddleware = await getDevMiddleware(this.compiler);
-        this.middleware = this.setupDevMiddleware(devMiddleware, this.publicPaths), await this.socketServer.prepare();
+        this.middleware = await this.setupDevMiddleware(devMiddleware, this.publicPaths), await this.socketServer.prepare();
     }
     upgrade(req, sock, head) {
         this.socketServer.upgrade(req, sock, head);
@@ -4734,8 +4754,12 @@ class CompilerDevMiddleware {
             data
         });
     }
-    setupDevMiddleware(devMiddleware, publicPaths) {
-        let { devConfig, serverConfig: { headers, base } } = this, middleware = devMiddleware({
+    async setupDevMiddleware(devMiddleware, publicPaths) {
+        let { devConfig, serverConfig } = this, { headers, base } = serverConfig, clientPaths = function(devConfig) {
+            var _devConfig_client;
+            let clientPaths = [];
+            return (devConfig.hmr || devConfig.liveReload) && (clientPaths.push(compilerDevMiddleware_require.resolve('@rsbuild/core/client/hmr')), (null === (_devConfig_client = devConfig.client) || void 0 === _devConfig_client ? void 0 : _devConfig_client.overlay) && clientPaths.push(`${compilerDevMiddleware_require.resolve('@rsbuild/core/client/overlay')}`)), clientPaths;
+        }(devConfig), middleware = await devMiddleware({
             headers,
             publicPath: '/',
             stats: !1,
@@ -4757,16 +4781,13 @@ class CompilerDevMiddleware {
                     this.socketServer.updateStats(stats);
                 }
             },
-            clientPaths: function(devConfig) {
-                var _devConfig_client;
-                let clientPaths = [];
-                return (devConfig.hmr || devConfig.liveReload) && (clientPaths.push(compilerDevMiddleware_require.resolve('@rsbuild/core/client/hmr')), (null === (_devConfig_client = devConfig.client) || void 0 === _devConfig_client ? void 0 : _devConfig_client.overlay) && clientPaths.push(`${compilerDevMiddleware_require.resolve('@rsbuild/core/client/overlay')}`)), clientPaths;
-            }(devConfig),
+            clientPaths: clientPaths,
             clientConfig: devConfig.client,
             liveReload: devConfig.liveReload,
             writeToDisk: devConfig.writeToDisk,
             serverSideRender: !0,
-            etag: 'weak'
+            etag: 'weak',
+            serverConfig
         }), assetPrefixes = publicPaths.map(pathnameParse).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)=>{
@@ -5189,7 +5210,7 @@ let runner_run = async (bundlePath, outputPath, compilerOptions, readFileSync)=>
     }(proxyOptions), proxyMiddlewares = [], middlewares = [], { createProxyMiddleware: baseMiddleware } = await import("../compiled/http-proxy-middleware/index.js");
     for (let opts of formattedOptions){
         let proxyMiddleware = baseMiddleware(opts.context, opts), middleware = async (req, res, next)=>{
-            let bypassUrl = 'function' == typeof opts.bypass ? opts.bypass(req, res, opts) : null;
+            let bypassUrl = 'function' == typeof opts.bypass ? await opts.bypass(req, res, opts) : null;
             !1 === bypassUrl ? (res.statusCode = 404, next()) : 'string' == typeof bypassUrl ? (req.url = bypassUrl, next()) : !0 === bypassUrl ? next() : proxyMiddleware(req, res, next);
         };
         middlewares.push(middleware), opts.ws && proxyMiddlewares.push(proxyMiddleware);
@@ -5849,7 +5870,7 @@ async function createRsbuild(options = {}) {
                         if (isFunction(plugin.apply)) {
                             let { name = 'SomeWebpackPlugin' } = plugin.constructor || {};
                             throw Error([
-                                `${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(name)} looks like a Webpack or Rspack plugin, please use ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow('`tools.rspack`')} to register it:`,
+                                `${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(name)} looks like a webpack or Rspack plugin, please use ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow('`tools.rspack`')} to register it:`,
                                 __WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.green(`
   // rsbuild.config.ts
   export default {
@@ -6476,12 +6497,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.3\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.4\n`);
     }();
     try {
         !function() {
             let cli = cac_dist('rsbuild');
-            cli.help(), cli.version("1.2.3"), applyCommonOptions(cli);
+            cli.help(), cli.version("1.2.4"), 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 {
@@ -6532,6 +6553,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.3";
+let src_version = "1.2.4";
 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/configChain.d.ts

@@ -1,8 +1,7 @@
 import RspackChain from '../compiled/rspack-chain/index.js';
-import type { InternalContext, ModifyBundlerChainUtils, Rspack } from './types';
+import type { InternalContext, ModifyBundlerChainUtils } from './types';
 export declare function getBundlerChain(): RspackChain;
 export declare function modifyBundlerChain(context: InternalContext, utils: ModifyBundlerChainUtils): Promise<RspackChain>;
-export declare function chainToConfig(chain: RspackChain): Rspack.Configuration;
 export declare const CHAIN_ID: {
     /** Predefined rules */
     readonly RULE: {

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, ProxyConfig, 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, 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 { ChainIdentifier } from './configChain';
 export type { RsbuildDevServer } from './server/devServer';

package/dist-types/plugins/basic.d.ts

@@ -1,5 +1,5 @@
 import type { RsbuildPlugin } from '../types';
 /**
- * Provide some basic configs of rspack
+ * Set some basic Rspack configs
  */
 export declare const pluginBasic: () => RsbuildPlugin;

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

@@ -1,4 +1,4 @@
-import type { DevConfig, Rspack } from '../types';
+import type { DevConfig, Rspack, ServerConfig } from '../types';
 import { type InitConfigsOptions } from './initConfigs';
 export declare function createCompiler(options: InitConfigsOptions): Promise<{
     compiler: Rspack.Compiler | Rspack.MultiCompiler;
@@ -24,4 +24,5 @@ export type DevMiddlewareOptions = {
     callbacks: MiddlewareCallbacks;
     /** whether use Server Side Render */
     serverSideRender?: boolean;
+    serverConfig: ServerConfig;
 };

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

@@ -8,5 +8,5 @@ export { getHTMLPlugin } from '../pluginHelper';
 export { formatStats, getStatsOptions, prettyTime } from '../helpers';
 export { registerBuildHook, registerDevHook } from '../hooks';
 export { getChainUtils, getConfigUtils } from './rspackConfig';
-export { chainToConfig, modifyBundlerChain } from '../configChain';
+export { modifyBundlerChain } from '../configChain';
 export { createDevServer } from '../server/devServer';

package/dist-types/server/devMiddleware.d.ts

@@ -22,6 +22,6 @@ export type DevMiddlewareAPI = Middleware & {
  * - Inject the HMR client path into page （the HMR client rsbuild/server already provide）.
  * - Notify server when compiler hooks are triggered.
  */
-export type DevMiddleware = (options: DevMiddlewareOptions) => DevMiddlewareAPI;
+export type DevMiddleware = (options: DevMiddlewareOptions) => Promise<DevMiddlewareAPI>;
 export declare const getDevMiddleware: (multiCompiler: Compiler | MultiCompiler) => Promise<NonNullable<DevMiddleware>>;
 export {};

package/dist-types/server/helper.d.ts

@@ -50,6 +50,7 @@ export declare const getServerConfig: ({ config, }: {
     https: boolean;
     portTip: string | undefined;
 }>;
+export declare const isWildcardHost: (host: string) => boolean;
 export declare const getHostInUrl: (host: string) => string;
 type AddressUrl = {
     label: string;

package/dist-types/server/hmrFallback.d.ts

@@ -0,0 +1,10 @@
+import type { DevConfig, ServerConfig } from '../types/config';
+/**
+ * Checks if localhost resolves differently between node's default DNS lookup
+ * and explicit DNS lookup.
+ *
+ * Returns the resolved address if there's a difference, undefined otherwise.
+ * This helps detect cases where IPv4/IPv6 resolution might vary.
+ */
+export declare function getLocalhostResolvedAddress(): Promise<string | undefined>;
+export declare function getResolvedClientConfig(clientConfig: DevConfig['client'], serverConfig: ServerConfig): Promise<DevConfig['client']>;

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

@@ -174,7 +174,8 @@ export interface NormalizedSourceConfig extends SourceConfig {
     decorators: Required<Decorators>;
 }
 export type HtmlFallback = false | 'index';
-export type ProxyBypass = (req: IncomingMessage, res: ServerResponse, proxyOptions: ProxyOptions) => string | undefined | null | boolean;
+export type ProxyBypass = (req: IncomingMessage, res: ServerResponse, proxyOptions: ProxyOptions) => MaybePromise<string | undefined | null | boolean>;
+export type { ProxyFilter };
 export type ProxyOptions = HttpProxyOptions & {
     /**
      * Bypass the proxy based on the return value of a function.
@@ -182,6 +183,7 @@ export type ProxyOptions = HttpProxyOptions & {
      * - Return `true` to continue processing the request without proxy.
      * - Return `false` to produce a 404 error for the request.
      * - Return a path to serve from, instead of continuing to proxy the request.
+     * - Return a Promise to handle the request asynchronously.
      */
     bypass?: ProxyBypass;
     /**

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

@@ -135,6 +135,7 @@ export type ModifyBundlerChainUtils = ModifyChainUtils & {
         DefinePlugin: PluginInstance;
         IgnorePlugin: PluginInstance;
         ProvidePlugin: PluginInstance;
+        SourceMapDevToolPlugin: PluginInstance;
         HotModuleReplacementPlugin: PluginInstance;
     };
 };