@rsbuild/core 1.0.9 → 1.0.10

package/dist/index.cjs

@@ -4194,6 +4194,7 @@ var init_config = __esm({
     getDefaultDevConfig = () => ({
       hmr: true,
       liveReload: true,
+      // Temporary placeholder, default: `${server.base}`
       assetPrefix: DEFAULT_ASSET_PREFIX,
       writeToDisk: false,
       client: {
@@ -4208,6 +4209,7 @@ var init_config = __esm({
       port: DEFAULT_PORT,
       host: DEFAULT_DEV_HOST,
       open: false,
+      base: "/",
       htmlFallback: "index",
       compress: true,
       printUrls: true,
@@ -4271,6 +4273,7 @@ var init_config = __esm({
         image: IMAGE_DIST_DIR,
         media: MEDIA_DIST_DIR
       },
+      // Temporary placeholder, default: `${server.base}`
       assetPrefix: DEFAULT_ASSET_PREFIX,
       filename: {},
       charset: "utf8",
@@ -4315,6 +4318,16 @@ var init_config = __esm({
       const merged = mergeRsbuildConfig(createDefaultConfig(), config);
       merged.root ||= rootPath;
       merged.source ||= {};
+      if (merged.server?.base) {
+        if (config.dev?.assetPrefix === void 0) {
+          merged.dev ||= {};
+          merged.dev.assetPrefix = merged.server.base;
+        }
+        if (config.output?.assetPrefix === void 0) {
+          merged.output ||= {};
+          merged.output.assetPrefix = merged.server.base;
+        }
+      }
       if (!merged.source.tsconfigPath) {
         const tsconfigPath = (0, import_node_path6.join)(rootPath, TS_CONFIG_FILE);
         if (await isFileExists(tsconfigPath)) {
@@ -5982,7 +5995,7 @@ async function createContext(options, userConfig, bundlerType) {
   const rsbuildConfig = await withDefaultConfig(rootPath, userConfig);
   const cachePath = (0, import_node_path10.join)(rootPath, "node_modules", ".cache");
   return {
-    version: "1.0.9",
+    version: "1.0.10",
     rootPath,
     distPath: "",
     cachePath,
@@ -7279,128 +7292,472 @@ var init_environment = __esm({
   }
 });
 
-// src/server/middlewares.ts
-var import_node_path16, import_picocolors9, faviconFallbackMiddleware, getStatusCodeColor, getRequestLoggerMiddleware, notFoundMiddleware, isFileExists2, maybeHTMLRequest, postfixRE, getUrlPathname, getHtmlCompletionMiddleware, getHtmlFallbackMiddleware;
-var init_middlewares = __esm({
-  "src/server/middlewares.ts"() {
+// src/server/helper.ts
+function getURLMessages(urls, routes) {
+  if (routes.length === 1) {
+    return urls.map(
+      ({ label, url: url2 }) => `  ${`➜ ${label.padEnd(10)}`}${import_picocolors9.default.cyan(
+        normalizeUrl(`${url2}${routes[0].pathname}`)
+      )}
+`
+    ).join("");
+  }
+  let message = "";
+  const maxNameLength = Math.max(...routes.map((r) => r.entryName.length));
+  urls.forEach(({ label, url: url2 }, index) => {
+    if (index > 0) {
+      message += "\n";
+    }
+    message += `  ${`➜ ${label}`}
+`;
+    for (const r of routes) {
+      message += `  ${import_picocolors9.default.dim("-")} ${import_picocolors9.default.dim(
+        r.entryName.padEnd(maxNameLength + 4)
+      )}${import_picocolors9.default.cyan(normalizeUrl(`${url2}${r.pathname}`))}
+`;
+    }
+  });
+  return message;
+}
+function printServerURLs({
+  urls: originalUrls,
+  port,
+  routes,
+  protocol,
+  printUrls
+}) {
+  if (printUrls === false) {
+    return null;
+  }
+  let urls = originalUrls;
+  if (isFunction(printUrls)) {
+    const newUrls = printUrls({
+      urls: urls.map((item) => item.url),
+      port,
+      routes,
+      protocol
+    });
+    if (!newUrls) {
+      return null;
+    }
+    if (!Array.isArray(newUrls)) {
+      throw new Error(
+        `"server.printUrls" must return an array, but got ${typeof newUrls}.`
+      );
+    }
+    urls = newUrls.map((url2) => ({
+      url: url2,
+      label: getUrlLabel(url2)
+    }));
+  }
+  if (urls.length === 0 || routes.length === 0) {
+    return null;
+  }
+  const message = getURLMessages(urls, routes);
+  import_rslog.logger.log(message);
+  return message;
+}
+function getServerTerminator(server) {
+  let listened = false;
+  const pendingSockets = /* @__PURE__ */ new Set();
+  const onConnection = (socket) => {
+    pendingSockets.add(socket);
+    socket.on("close", () => {
+      pendingSockets.delete(socket);
+    });
+  };
+  server.on("connection", onConnection);
+  server.on("secureConnection", onConnection);
+  server.once("listening", () => {
+    listened = true;
+  });
+  return () => new Promise((resolve2, reject) => {
+    for (const socket of pendingSockets) {
+      socket.destroy();
+    }
+    if (listened) {
+      server.close((err) => err ? reject(err) : resolve2());
+    } else {
+      resolve2();
+    }
+  });
+}
+var import_node_net, import_node_os, import_node_path16, import_picocolors9, normalizeUrl, formatPrefix, joinUrlSegments, stripBase, getRoutes, formatRoutes, getPort, getServerConfig, getIpv4Interfaces, isLoopbackHost, getHostInUrl, concatUrl, LOCAL_LABEL, NETWORK_LABEL, getUrlLabel, getAddressUrls, COMPILATION_ID_REGEX, getCompilationId;
+var init_helper = __esm({
+  "src/server/helper.ts"() {
     "use strict";
-    import_node_path16 = __toESM(require("path"));
+    import_node_net = __toESM(require("net"));
+    import_node_os = __toESM(require("os"));
+    import_node_path16 = require("path");
     import_picocolors9 = __toESM(require("../compiled/picocolors/index.js"));
+    init_constants();
+    init_helpers();
     init_logger();
-    faviconFallbackMiddleware = (req, res, next) => {
-      if (req.url === "/favicon.ico") {
-        res.statusCode = 204;
-        res.end();
-      } else {
-        next();
-      }
-    };
-    getStatusCodeColor = (status) => {
-      if (status >= 500) {
-        return import_picocolors9.default.red;
+    normalizeUrl = (url2) => url2.replace(/([^:]\/)\/+/g, "$1");
+    formatPrefix = (input) => {
+      let prefix = input;
+      if (prefix?.startsWith("./")) {
+        prefix = prefix.replace("./", "");
       }
-      if (status >= 400) {
-        return import_picocolors9.default.yellow;
+      if (!prefix) {
+        return "/";
       }
-      if (status >= 300) {
-        return import_picocolors9.default.cyan;
+      const hasLeadingSlash = prefix.startsWith("/");
+      const hasTailSlash = prefix.endsWith("/");
+      return `${hasLeadingSlash ? "" : "/"}${prefix}${hasTailSlash ? "" : "/"}`;
+    };
+    joinUrlSegments = (s1, s2) => {
+      if (!s1 || !s2) {
+        return s1 || s2 || "";
       }
-      if (status >= 200) {
-        return import_picocolors9.default.green;
+      return addTrailingSlash(s1) + removeLeadingSlash(s2);
+    };
+    stripBase = (path21, base) => {
+      if (path21 === base) {
+        return "/";
       }
-      return (res) => res;
+      const trailingSlashBase = addTrailingSlash(base);
+      return path21.startsWith(trailingSlashBase) ? path21.slice(trailingSlashBase.length - 1) : path21;
     };
-    getRequestLoggerMiddleware = async () => {
-      const { default: onFinished } = await import("../compiled/on-finished/index.js");
-      return (req, res, next) => {
-        const _startAt = process.hrtime();
-        const logRequest = () => {
-          const method = req.method;
-          const url2 = req.originalUrl || req.url;
-          const status = Number(res.statusCode);
-          const statusColor = getStatusCodeColor(status);
-          const endAt = process.hrtime();
-          const totalTime = (endAt[0] - _startAt[0]) * 1e3 + (endAt[1] - _startAt[1]) * 1e-6;
-          import_rslog.logger.debug(
-            `${statusColor(status)} ${method} ${import_picocolors9.default.gray(url2)} ${import_picocolors9.default.gray(
-              `${totalTime.toFixed(3)} ms`
-            )}`
+    getRoutes = (context) => {
+      return Object.values(context.environments).reduce(
+        (prev, environmentContext) => {
+          const { distPath, config } = environmentContext;
+          const distPrefix = import_node_path16.posix.relative(context.distPath, distPath);
+          const routes = formatRoutes(
+            environmentContext.htmlPaths,
+            context.normalizedConfig.server.base,
+            import_node_path16.posix.join(distPrefix, config.output.distPath.html),
+            config.html.outputStructure
           );
-        };
-        onFinished(res, logRequest);
-        next();
-      };
+          return prev.concat(...routes);
+        },
+        []
+      );
     };
-    notFoundMiddleware = (_req, res, _next) => {
-      res.statusCode = 404;
-      res.end();
+    formatRoutes = (entry, base, distPathPrefix, outputStructure) => {
+      const prefix = joinUrlSegments(base, formatPrefix(distPathPrefix));
+      return Object.keys(entry).map((entryName) => {
+        const isIndex = entryName === "index" && outputStructure !== "nested";
+        const displayName = isIndex ? "" : entryName;
+        return {
+          entryName,
+          pathname: prefix + displayName
+        };
+      }).sort((a) => a.entryName === "index" ? -1 : 1);
     };
-    isFileExists2 = async (filePath, outputFileSystem) => new Promise((resolve2) => {
-      outputFileSystem.stat(filePath, (_error, stats) => {
-        resolve2(stats?.isFile());
-      });
-    });
-    maybeHTMLRequest = (req) => {
-      if (
-        // require headers and url
-        !req.url || !req.headers || // only accept GET or HEAD
-        req.method !== "GET" && req.method !== "HEAD"
-      ) {
-        return false;
+    getPort = async ({
+      host,
+      port,
+      strictPort,
+      tryLimits = 20
+    }) => {
+      if (typeof port === "string") {
+        port = Number.parseInt(port, 10);
       }
-      const { accept } = req.headers;
-      return typeof accept === "string" && (accept.includes("text/html") || accept.includes("*/*"));
-    };
-    postfixRE = /[?#].*$/;
-    getUrlPathname = (url2) => {
-      return url2.replace(postfixRE, "");
-    };
-    getHtmlCompletionMiddleware = ({ distPath, callback, outputFileSystem }) => {
-      return async (req, res, next) => {
-        if (!maybeHTMLRequest(req)) {
-          return next();
-        }
-        const url2 = req.url;
-        const pathname = getUrlPathname(url2);
-        const rewrite = (newUrl) => {
-          req.url = newUrl;
-          return callback(req, res, (...args) => {
-            next(...args);
+      if (strictPort) {
+        tryLimits = 1;
+      }
+      const original = port;
+      let found = false;
+      let attempts = 0;
+      while (!found && attempts <= tryLimits) {
+        try {
+          await new Promise((resolve2, reject) => {
+            const server = import_node_net.default.createServer();
+            server.unref();
+            server.on("error", reject);
+            server.listen({ port, host }, () => {
+              found = true;
+              server.close(resolve2);
+            });
           });
-        };
-        if (pathname.endsWith("/")) {
-          const newUrl = `${pathname}index.html`;
-          const filePath = import_node_path16.default.join(distPath, newUrl);
-          if (await isFileExists2(filePath, outputFileSystem)) {
-            return rewrite(newUrl);
-          }
-        } else if (!import_node_path16.default.extname(pathname)) {
-          const newUrl = `${pathname}.html`;
-          const filePath = import_node_path16.default.join(distPath, newUrl);
-          if (await isFileExists2(filePath, outputFileSystem)) {
-            return rewrite(newUrl);
+        } catch (e) {
+          if (e.code !== "EADDRINUSE") {
+            throw e;
           }
+          port++;
+          attempts++;
         }
-        next();
-      };
-    };
-    getHtmlFallbackMiddleware = ({ htmlFallback, distPath, callback, outputFileSystem }) => {
-      return async (req, res, next) => {
-        if (!maybeHTMLRequest(req) || "/favicon.ico" === req.url || htmlFallback !== "index") {
-          return next();
-        }
-        const filePath = import_node_path16.default.join(distPath, "index.html");
-        if (await isFileExists2(filePath, outputFileSystem)) {
-          const newUrl = "/index.html";
-          if (import_rslog.logger.level === "verbose") {
-            import_rslog.logger.debug(
-              `${req.method} ${import_picocolors9.default.gray(
-                `${req.url} ${import_picocolors9.default.yellow("fallback")} to ${newUrl}`
-              )}`
-            );
-          }
-          req.url = newUrl;
-          return callback(req, res, (...args) => next(...args));
+      }
+      if (port !== original) {
+        if (strictPort) {
+          throw new Error(
+            `Port "${original}" is occupied, please choose another one.`
+          );
+        }
+      }
+      return port;
+    };
+    getServerConfig = async ({
+      config
+    }) => {
+      const host = config.server.host || DEFAULT_DEV_HOST;
+      const originalPort = config.server.port || DEFAULT_PORT;
+      const port = await getPort({
+        host,
+        port: originalPort,
+        strictPort: config.server.strictPort || false
+      });
+      const https = Boolean(config.server.https) || false;
+      const portTip = port !== originalPort ? `Port ${originalPort} is in use, ${import_picocolors9.default.yellow(`using port ${port}.`)}` : void 0;
+      return {
+        port,
+        host,
+        https,
+        portTip
+      };
+    };
+    getIpv4Interfaces = () => {
+      const interfaces = import_node_os.default.networkInterfaces();
+      const ipv4Interfaces = /* @__PURE__ */ new Map();
+      for (const key of Object.keys(interfaces)) {
+        for (const detail of interfaces[key]) {
+          const familyV4Value = typeof detail.family === "string" ? "IPv4" : 4;
+          if (detail.family === familyV4Value && !ipv4Interfaces.has(detail.address)) {
+            ipv4Interfaces.set(detail.address, detail);
+          }
+        }
+      }
+      return Array.from(ipv4Interfaces.values());
+    };
+    isLoopbackHost = (host) => {
+      const loopbackHosts = [
+        "localhost",
+        "127.0.0.1",
+        "::1",
+        "0000:0000:0000:0000:0000:0000:0000:0001"
+      ];
+      return loopbackHosts.includes(host);
+    };
+    getHostInUrl = (host) => {
+      if (import_node_net.default.isIPv6(host)) {
+        return host === "::" ? "[::1]" : `[${host}]`;
+      }
+      return host;
+    };
+    concatUrl = ({
+      host,
+      port,
+      protocol
+    }) => `${protocol}://${host}:${port}`;
+    LOCAL_LABEL = "Local:  ";
+    NETWORK_LABEL = "Network:  ";
+    getUrlLabel = (url2) => {
+      try {
+        const { host } = new URL(url2);
+        return isLoopbackHost(host) ? LOCAL_LABEL : NETWORK_LABEL;
+      } catch (err) {
+        return NETWORK_LABEL;
+      }
+    };
+    getAddressUrls = ({
+      protocol = "http",
+      port,
+      host
+    }) => {
+      if (host && host !== DEFAULT_DEV_HOST) {
+        return [
+          {
+            label: isLoopbackHost(host) ? LOCAL_LABEL : NETWORK_LABEL,
+            url: concatUrl({
+              port,
+              host: getHostInUrl(host),
+              protocol
+            })
+          }
+        ];
+      }
+      const ipv4Interfaces = getIpv4Interfaces();
+      const addressUrls = [];
+      let hasLocalUrl = false;
+      for (const detail of ipv4Interfaces) {
+        if (isLoopbackHost(detail.address) || detail.internal) {
+          if (hasLocalUrl) {
+            continue;
+          }
+          addressUrls.push({
+            label: LOCAL_LABEL,
+            url: concatUrl({ host: "localhost", port, protocol })
+          });
+          hasLocalUrl = true;
+        } else {
+          addressUrls.push({
+            label: NETWORK_LABEL,
+            url: concatUrl({ host: detail.address, port, protocol })
+          });
+        }
+      }
+      return addressUrls;
+    };
+    COMPILATION_ID_REGEX = /[^a-zA-Z0-9_-]/g;
+    getCompilationId = (compiler) => {
+      const uniqueName = compiler.options.output.uniqueName ?? "";
+      return `${compiler.name ?? ""}_${uniqueName.replace(COMPILATION_ID_REGEX, "_")}`;
+    };
+  }
+});
+
+// src/server/middlewares.ts
+var import_node_path17, import_picocolors10, faviconFallbackMiddleware, getStatusCodeColor, getRequestLoggerMiddleware, notFoundMiddleware, isFileExists2, maybeHTMLRequest, postfixRE, getUrlPathname, getHtmlCompletionMiddleware, getBaseMiddleware, getHtmlFallbackMiddleware;
+var init_middlewares = __esm({
+  "src/server/middlewares.ts"() {
+    "use strict";
+    import_node_path17 = __toESM(require("path"));
+    import_picocolors10 = __toESM(require("../compiled/picocolors/index.js"));
+    init_helpers();
+    init_logger();
+    init_helper();
+    faviconFallbackMiddleware = (req, res, next) => {
+      if (req.url === "/favicon.ico") {
+        res.statusCode = 204;
+        res.end();
+      } else {
+        next();
+      }
+    };
+    getStatusCodeColor = (status) => {
+      if (status >= 500) {
+        return import_picocolors10.default.red;
+      }
+      if (status >= 400) {
+        return import_picocolors10.default.yellow;
+      }
+      if (status >= 300) {
+        return import_picocolors10.default.cyan;
+      }
+      if (status >= 200) {
+        return import_picocolors10.default.green;
+      }
+      return (res) => res;
+    };
+    getRequestLoggerMiddleware = async () => {
+      const { default: onFinished } = await import("../compiled/on-finished/index.js");
+      return (req, res, next) => {
+        const _startAt = process.hrtime();
+        const logRequest = () => {
+          const method = req.method;
+          const url2 = req.originalUrl || req.url;
+          const status = Number(res.statusCode);
+          const statusColor = getStatusCodeColor(status);
+          const endAt = process.hrtime();
+          const totalTime = (endAt[0] - _startAt[0]) * 1e3 + (endAt[1] - _startAt[1]) * 1e-6;
+          import_rslog.logger.debug(
+            `${statusColor(status)} ${method} ${import_picocolors10.default.gray(url2)} ${import_picocolors10.default.gray(
+              `${totalTime.toFixed(3)} ms`
+            )}`
+          );
+        };
+        onFinished(res, logRequest);
+        next();
+      };
+    };
+    notFoundMiddleware = (_req, res, _next) => {
+      res.statusCode = 404;
+      res.end();
+    };
+    isFileExists2 = async (filePath, outputFileSystem) => new Promise((resolve2) => {
+      outputFileSystem.stat(filePath, (_error, stats) => {
+        resolve2(stats?.isFile());
+      });
+    });
+    maybeHTMLRequest = (req) => {
+      if (
+        // require headers and url
+        !req.url || !req.headers || // only accept GET or HEAD
+        req.method !== "GET" && req.method !== "HEAD"
+      ) {
+        return false;
+      }
+      const { accept } = req.headers;
+      return typeof accept === "string" && (accept.includes("text/html") || accept.includes("*/*"));
+    };
+    postfixRE = /[?#].*$/;
+    getUrlPathname = (url2) => {
+      return url2.replace(postfixRE, "");
+    };
+    getHtmlCompletionMiddleware = ({ distPath, callback, outputFileSystem }) => {
+      return async (req, res, next) => {
+        if (!maybeHTMLRequest(req)) {
+          return next();
+        }
+        const url2 = req.url;
+        const pathname = getUrlPathname(url2);
+        const rewrite = (newUrl) => {
+          req.url = newUrl;
+          return callback(req, res, (...args) => {
+            next(...args);
+          });
+        };
+        if (pathname.endsWith("/")) {
+          const newUrl = `${pathname}index.html`;
+          const filePath = import_node_path17.default.join(distPath, newUrl);
+          if (await isFileExists2(filePath, outputFileSystem)) {
+            return rewrite(newUrl);
+          }
+        } else if (!import_node_path17.default.extname(pathname)) {
+          const newUrl = `${pathname}.html`;
+          const filePath = import_node_path17.default.join(distPath, newUrl);
+          if (await isFileExists2(filePath, outputFileSystem)) {
+            return rewrite(newUrl);
+          }
+        }
+        next();
+      };
+    };
+    getBaseMiddleware = ({
+      base
+    }) => {
+      return async (req, res, next) => {
+        const url2 = req.url;
+        const pathname = getUrlPathname(url2);
+        if (pathname.startsWith(base)) {
+          req.url = stripBase(url2, base);
+          return next();
+        }
+        const redirectPath = addTrailingSlash(url2) !== base ? joinUrlSegments(base, url2) : base;
+        if (pathname === "/" || pathname === "/index.html") {
+          res.writeHead(302, {
+            Location: redirectPath
+          });
+          res.end();
+          return;
+        }
+        if (req.headers.accept?.includes("text/html")) {
+          res.writeHead(404, {
+            "Content-Type": "text/html"
+          });
+          res.end(
+            `The server is configured with a base URL of ${base} - did you mean to visit <a href="${redirectPath}">${redirectPath}</a> instead?`
+          );
+          return;
+        }
+        res.writeHead(404, {
+          "Content-Type": "text/plain"
+        });
+        res.end(
+          `The server is configured with a base URL of ${base} - did you mean to visit ${redirectPath} instead?`
+        );
+        return;
+      };
+    };
+    getHtmlFallbackMiddleware = ({ htmlFallback, distPath, callback, outputFileSystem }) => {
+      return async (req, res, next) => {
+        if (!maybeHTMLRequest(req) || "/favicon.ico" === req.url || htmlFallback !== "index") {
+          return next();
+        }
+        const filePath = import_node_path17.default.join(distPath, "index.html");
+        if (await isFileExists2(filePath, outputFileSystem)) {
+          const newUrl = "/index.html";
+          if (import_rslog.logger.level === "verbose") {
+            import_rslog.logger.debug(
+              `${req.method} ${import_picocolors10.default.gray(
+                `${req.url} ${import_picocolors10.default.yellow("fallback")} to ${newUrl}`
+              )}`
+            );
+          }
+          req.url = newUrl;
+          return callback(req, res, (...args) => next(...args));
         }
         next();
       };
@@ -7584,11 +7941,11 @@ var init_proxy = __esm({
 });
 
 // src/server/getDevMiddlewares.ts
-var import_node_path17, import_node_url2, applySetupMiddlewares, applyDefaultMiddlewares, getMiddlewares;
+var import_node_path18, import_node_url2, applySetupMiddlewares, applyDefaultMiddlewares, getMiddlewares;
 var init_getDevMiddlewares = __esm({
   "src/server/getDevMiddlewares.ts"() {
     "use strict";
-    import_node_path17 = require("path");
+    import_node_path18 = require("path");
     import_node_url2 = __toESM(require("url"));
     init_config();
     init_logger();
@@ -7605,437 +7962,148 @@ var init_getDevMiddlewares = __esm({
         handler(
           {
             unshift: (...handlers) => before.unshift(...handlers),
-            push: (...handlers) => after.push(...handlers)
-          },
-          serverOptions
-        );
-      }
-      return { before, after };
-    };
-    applyDefaultMiddlewares = async ({
-      middlewares,
-      server,
-      compileMiddlewareAPI,
-      output,
-      pwd,
-      outputFileSystem
-    }) => {
-      const upgradeEvents = [];
-      if (server.compress) {
-        const { gzipMiddleware: gzipMiddleware2 } = await Promise.resolve().then(() => (init_gzipMiddleware(), gzipMiddleware_exports));
-        middlewares.push(gzipMiddleware2());
-      }
-      middlewares.push((req, res, next) => {
-        res.setHeader("Access-Control-Allow-Origin", "*");
-        const path21 = req.url ? import_node_url2.default.parse(req.url).pathname : "";
-        if (path21?.includes("hot-update")) {
-          res.setHeader("Access-Control-Allow-Credentials", "false");
-        }
-        const confHeaders = server.headers;
-        if (confHeaders) {
-          for (const [key, value] of Object.entries(confHeaders)) {
-            res.setHeader(key, value);
-          }
-        }
-        next();
-      });
-      if (server.proxy) {
-        const { createProxyMiddleware: createProxyMiddleware2 } = await Promise.resolve().then(() => (init_proxy(), proxy_exports));
-        const { middlewares: proxyMiddlewares, upgrade } = await createProxyMiddleware2(server.proxy);
-        upgradeEvents.push(upgrade);
-        for (const middleware of proxyMiddlewares) {
-          middlewares.push(middleware);
-        }
-      }
-      const { default: launchEditorMiddleware } = await import("../compiled/launch-editor-middleware/index.js");
-      middlewares.push(["/__open-in-editor", launchEditorMiddleware()]);
-      if (compileMiddlewareAPI) {
-        middlewares.push(compileMiddlewareAPI.middleware);
-        upgradeEvents.push(
-          compileMiddlewareAPI.onUpgrade.bind(compileMiddlewareAPI)
-        );
-        middlewares.push((req, res, next) => {
-          if (req.url?.endsWith(".hot-update.json") && req.method !== "OPTIONS") {
-            res.statusCode = 404;
-            res.end();
-          } else {
-            next();
-          }
-        });
-      }
-      const distPath = (0, import_node_path17.isAbsolute)(output.distPath) ? output.distPath : (0, import_node_path17.join)(pwd, output.distPath);
-      if (compileMiddlewareAPI) {
-        middlewares.push(
-          getHtmlCompletionMiddleware({
-            distPath,
-            callback: compileMiddlewareAPI.middleware,
-            outputFileSystem
-          })
-        );
-      }
-      const publicDirs = normalizePublicDirs(server?.publicDir);
-      for (const publicDir of publicDirs) {
-        const { default: sirv } = await import("../compiled/sirv/index.js");
-        const { name } = publicDir;
-        const normalizedPath = (0, import_node_path17.isAbsolute)(name) ? name : (0, import_node_path17.join)(pwd, name);
-        const assetMiddleware = sirv(normalizedPath, {
-          etag: true,
-          dev: true
-        });
-        middlewares.push(assetMiddleware);
-      }
-      if (compileMiddlewareAPI) {
-        middlewares.push(
-          getHtmlFallbackMiddleware({
-            distPath,
-            callback: compileMiddlewareAPI.middleware,
-            htmlFallback: server.htmlFallback,
-            outputFileSystem
-          })
-        );
-      }
-      if (server.historyApiFallback) {
-        const { default: connectHistoryApiFallback } = await import("../compiled/connect-history-api-fallback/index.js");
-        const historyApiFallbackMiddleware = connectHistoryApiFallback(
-          server.historyApiFallback === true ? {} : server.historyApiFallback
-        );
-        middlewares.push(historyApiFallbackMiddleware);
-        compileMiddlewareAPI?.middleware && middlewares.push(compileMiddlewareAPI.middleware);
-      }
-      middlewares.push(faviconFallbackMiddleware);
-      middlewares.push((req, res, next) => {
-        if (req.method === "OPTIONS") {
-          res.statusCode = 204;
-          res.setHeader("Content-Length", "0");
-          res.end();
-          return;
-        }
-        next();
-      });
-      return {
-        onUpgrade: (...args) => {
-          for (const cb of upgradeEvents) {
-            cb(...args);
-          }
-        }
-      };
-    };
-    getMiddlewares = async (options) => {
-      const middlewares = [];
-      const { environments, compileMiddlewareAPI } = options;
-      if (import_rslog.logger.level === "verbose") {
-        middlewares.push(await getRequestLoggerMiddleware());
-      }
-      const { before, after } = applySetupMiddlewares(
-        options.dev,
-        environments,
-        compileMiddlewareAPI
-      );
-      middlewares.push(...before);
-      const { onUpgrade } = await applyDefaultMiddlewares({
-        ...options,
-        middlewares
-      });
-      middlewares.push(...after);
-      return {
-        close: async () => {
-          compileMiddlewareAPI?.close();
-        },
-        onUpgrade,
-        middlewares
-      };
-    };
-  }
-});
-
-// src/server/helper.ts
-function getURLMessages(urls, routes) {
-  if (routes.length === 1) {
-    return urls.map(
-      ({ label, url: url2 }) => `  ${`➜ ${label.padEnd(10)}`}${import_picocolors10.default.cyan(
-        normalizeUrl(`${url2}${routes[0].pathname}`)
-      )}
-`
-    ).join("");
-  }
-  let message = "";
-  const maxNameLength = Math.max(...routes.map((r) => r.entryName.length));
-  urls.forEach(({ label, url: url2 }, index) => {
-    if (index > 0) {
-      message += "\n";
-    }
-    message += `  ${`➜ ${label}`}
-`;
-    for (const r of routes) {
-      message += `  ${import_picocolors10.default.dim("-")} ${import_picocolors10.default.dim(
-        r.entryName.padEnd(maxNameLength + 4)
-      )}${import_picocolors10.default.cyan(normalizeUrl(`${url2}${r.pathname}`))}
-`;
-    }
-  });
-  return message;
-}
-function printServerURLs({
-  urls: originalUrls,
-  port,
-  routes,
-  protocol,
-  printUrls
-}) {
-  if (printUrls === false) {
-    return null;
-  }
-  let urls = originalUrls;
-  if (isFunction(printUrls)) {
-    const newUrls = printUrls({
-      urls: urls.map((item) => item.url),
-      port,
-      routes,
-      protocol
-    });
-    if (!newUrls) {
-      return null;
-    }
-    if (!Array.isArray(newUrls)) {
-      throw new Error(
-        `"server.printUrls" must return an array, but got ${typeof newUrls}.`
-      );
-    }
-    urls = newUrls.map((url2) => ({
-      url: url2,
-      label: getUrlLabel(url2)
-    }));
-  }
-  if (urls.length === 0 || routes.length === 0) {
-    return null;
-  }
-  const message = getURLMessages(urls, routes);
-  import_rslog.logger.log(message);
-  return message;
-}
-function getServerTerminator(server) {
-  let listened = false;
-  const pendingSockets = /* @__PURE__ */ new Set();
-  const onConnection = (socket) => {
-    pendingSockets.add(socket);
-    socket.on("close", () => {
-      pendingSockets.delete(socket);
-    });
-  };
-  server.on("connection", onConnection);
-  server.on("secureConnection", onConnection);
-  server.once("listening", () => {
-    listened = true;
-  });
-  return () => new Promise((resolve2, reject) => {
-    for (const socket of pendingSockets) {
-      socket.destroy();
-    }
-    if (listened) {
-      server.close((err) => err ? reject(err) : resolve2());
-    } else {
-      resolve2();
-    }
-  });
-}
-var import_node_net, import_node_os, import_node_path18, import_picocolors10, normalizeUrl, formatPrefix, getRoutes, formatRoutes, getPort, getServerConfig, getIpv4Interfaces, isLoopbackHost, getHostInUrl, concatUrl, LOCAL_LABEL, NETWORK_LABEL, getUrlLabel, getAddressUrls, COMPILATION_ID_REGEX, getCompilationId;
-var init_helper = __esm({
-  "src/server/helper.ts"() {
-    "use strict";
-    import_node_net = __toESM(require("net"));
-    import_node_os = __toESM(require("os"));
-    import_node_path18 = require("path");
-    import_picocolors10 = __toESM(require("../compiled/picocolors/index.js"));
-    init_constants();
-    init_helpers();
-    init_logger();
-    normalizeUrl = (url2) => url2.replace(/([^:]\/)\/+/g, "$1");
-    formatPrefix = (input) => {
-      let prefix = input;
-      if (prefix?.startsWith("./")) {
-        prefix = prefix.replace("./", "");
-      }
-      if (!prefix) {
-        return "/";
-      }
-      const hasLeadingSlash = prefix.startsWith("/");
-      const hasTailSlash = prefix.endsWith("/");
-      return `${hasLeadingSlash ? "" : "/"}${prefix}${hasTailSlash ? "" : "/"}`;
-    };
-    getRoutes = (context) => {
-      return Object.values(context.environments).reduce(
-        (prev, environmentContext) => {
-          const { distPath, config } = environmentContext;
-          const distPrefix = import_node_path18.posix.relative(context.distPath, distPath);
-          const routes = formatRoutes(
-            environmentContext.htmlPaths,
-            import_node_path18.posix.join(distPrefix, config.output.distPath.html),
-            config.html.outputStructure
-          );
-          return prev.concat(...routes);
-        },
-        []
-      );
-    };
-    formatRoutes = (entry, prefix, outputStructure) => {
-      const formattedPrefix = formatPrefix(prefix);
-      return Object.keys(entry).map((entryName) => {
-        const isIndex = entryName === "index" && outputStructure !== "nested";
-        const displayName = isIndex ? "" : entryName;
-        return {
-          entryName,
-          pathname: formattedPrefix + displayName
-        };
-      }).sort((a) => a.entryName === "index" ? -1 : 1);
-    };
-    getPort = async ({
-      host,
-      port,
-      strictPort,
-      tryLimits = 20
-    }) => {
-      if (typeof port === "string") {
-        port = Number.parseInt(port, 10);
+            push: (...handlers) => after.push(...handlers)
+          },
+          serverOptions
+        );
       }
-      if (strictPort) {
-        tryLimits = 1;
+      return { before, after };
+    };
+    applyDefaultMiddlewares = async ({
+      middlewares,
+      server,
+      compileMiddlewareAPI,
+      output,
+      pwd,
+      outputFileSystem
+    }) => {
+      const upgradeEvents = [];
+      if (server.compress) {
+        const { gzipMiddleware: gzipMiddleware2 } = await Promise.resolve().then(() => (init_gzipMiddleware(), gzipMiddleware_exports));
+        middlewares.push(gzipMiddleware2());
       }
-      const original = port;
-      let found = false;
-      let attempts = 0;
-      while (!found && attempts <= tryLimits) {
-        try {
-          await new Promise((resolve2, reject) => {
-            const server = import_node_net.default.createServer();
-            server.unref();
-            server.on("error", reject);
-            server.listen({ port, host }, () => {
-              found = true;
-              server.close(resolve2);
-            });
-          });
-        } catch (e) {
-          if (e.code !== "EADDRINUSE") {
-            throw e;
+      middlewares.push((req, res, next) => {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        const path21 = req.url ? import_node_url2.default.parse(req.url).pathname : "";
+        if (path21?.includes("hot-update")) {
+          res.setHeader("Access-Control-Allow-Credentials", "false");
+        }
+        const confHeaders = server.headers;
+        if (confHeaders) {
+          for (const [key, value] of Object.entries(confHeaders)) {
+            res.setHeader(key, value);
           }
-          port++;
-          attempts++;
         }
-      }
-      if (port !== original) {
-        if (strictPort) {
-          throw new Error(
-            `Port "${original}" is occupied, please choose another one.`
-          );
+        next();
+      });
+      if (server.proxy) {
+        const { createProxyMiddleware: createProxyMiddleware2 } = await Promise.resolve().then(() => (init_proxy(), proxy_exports));
+        const { middlewares: proxyMiddlewares, upgrade } = await createProxyMiddleware2(server.proxy);
+        upgradeEvents.push(upgrade);
+        for (const middleware of proxyMiddlewares) {
+          middlewares.push(middleware);
         }
       }
-      return port;
-    };
-    getServerConfig = async ({
-      config
-    }) => {
-      const host = config.server.host || DEFAULT_DEV_HOST;
-      const originalPort = config.server.port || DEFAULT_PORT;
-      const port = await getPort({
-        host,
-        port: originalPort,
-        strictPort: config.server.strictPort || false
-      });
-      const https = Boolean(config.server.https) || false;
-      const portTip = port !== originalPort ? `Port ${originalPort} is in use, ${import_picocolors10.default.yellow(`using port ${port}.`)}` : void 0;
-      return {
-        port,
-        host,
-        https,
-        portTip
-      };
-    };
-    getIpv4Interfaces = () => {
-      const interfaces = import_node_os.default.networkInterfaces();
-      const ipv4Interfaces = /* @__PURE__ */ new Map();
-      for (const key of Object.keys(interfaces)) {
-        for (const detail of interfaces[key]) {
-          const familyV4Value = typeof detail.family === "string" ? "IPv4" : 4;
-          if (detail.family === familyV4Value && !ipv4Interfaces.has(detail.address)) {
-            ipv4Interfaces.set(detail.address, detail);
+      if (server.base && server.base !== "/") {
+        middlewares.push(getBaseMiddleware({ base: server.base }));
+      }
+      const { default: launchEditorMiddleware } = await import("../compiled/launch-editor-middleware/index.js");
+      middlewares.push(["/__open-in-editor", launchEditorMiddleware()]);
+      if (compileMiddlewareAPI) {
+        middlewares.push(compileMiddlewareAPI.middleware);
+        upgradeEvents.push(
+          compileMiddlewareAPI.onUpgrade.bind(compileMiddlewareAPI)
+        );
+        middlewares.push((req, res, next) => {
+          if (req.url?.endsWith(".hot-update.json") && req.method !== "OPTIONS") {
+            res.statusCode = 404;
+            res.end();
+          } else {
+            next();
           }
-        }
+        });
       }
-      return Array.from(ipv4Interfaces.values());
-    };
-    isLoopbackHost = (host) => {
-      const loopbackHosts = [
-        "localhost",
-        "127.0.0.1",
-        "::1",
-        "0000:0000:0000:0000:0000:0000:0000:0001"
-      ];
-      return loopbackHosts.includes(host);
-    };
-    getHostInUrl = (host) => {
-      if (import_node_net.default.isIPv6(host)) {
-        return host === "::" ? "[::1]" : `[${host}]`;
+      const distPath = (0, import_node_path18.isAbsolute)(output.distPath) ? output.distPath : (0, import_node_path18.join)(pwd, output.distPath);
+      if (compileMiddlewareAPI) {
+        middlewares.push(
+          getHtmlCompletionMiddleware({
+            distPath,
+            callback: compileMiddlewareAPI.middleware,
+            outputFileSystem
+          })
+        );
       }
-      return host;
-    };
-    concatUrl = ({
-      host,
-      port,
-      protocol
-    }) => `${protocol}://${host}:${port}`;
-    LOCAL_LABEL = "Local:  ";
-    NETWORK_LABEL = "Network:  ";
-    getUrlLabel = (url2) => {
-      try {
-        const { host } = new URL(url2);
-        return isLoopbackHost(host) ? LOCAL_LABEL : NETWORK_LABEL;
-      } catch (err) {
-        return NETWORK_LABEL;
+      const publicDirs = normalizePublicDirs(server?.publicDir);
+      for (const publicDir of publicDirs) {
+        const { default: sirv } = await import("../compiled/sirv/index.js");
+        const { name } = publicDir;
+        const normalizedPath = (0, import_node_path18.isAbsolute)(name) ? name : (0, import_node_path18.join)(pwd, name);
+        const assetMiddleware = sirv(normalizedPath, {
+          etag: true,
+          dev: true
+        });
+        middlewares.push(assetMiddleware);
       }
-    };
-    getAddressUrls = ({
-      protocol = "http",
-      port,
-      host
-    }) => {
-      if (host && host !== DEFAULT_DEV_HOST) {
-        return [
-          {
-            label: isLoopbackHost(host) ? LOCAL_LABEL : NETWORK_LABEL,
-            url: concatUrl({
-              port,
-              host: getHostInUrl(host),
-              protocol
-            })
-          }
-        ];
+      if (compileMiddlewareAPI) {
+        middlewares.push(
+          getHtmlFallbackMiddleware({
+            distPath,
+            callback: compileMiddlewareAPI.middleware,
+            htmlFallback: server.htmlFallback,
+            outputFileSystem
+          })
+        );
       }
-      const ipv4Interfaces = getIpv4Interfaces();
-      const addressUrls = [];
-      let hasLocalUrl = false;
-      for (const detail of ipv4Interfaces) {
-        if (isLoopbackHost(detail.address) || detail.internal) {
-          if (hasLocalUrl) {
-            continue;
+      if (server.historyApiFallback) {
+        const { default: connectHistoryApiFallback } = await import("../compiled/connect-history-api-fallback/index.js");
+        const historyApiFallbackMiddleware = connectHistoryApiFallback(
+          server.historyApiFallback === true ? {} : server.historyApiFallback
+        );
+        middlewares.push(historyApiFallbackMiddleware);
+        compileMiddlewareAPI?.middleware && middlewares.push(compileMiddlewareAPI.middleware);
+      }
+      middlewares.push(faviconFallbackMiddleware);
+      middlewares.push((req, res, next) => {
+        if (req.method === "OPTIONS") {
+          res.statusCode = 204;
+          res.setHeader("Content-Length", "0");
+          res.end();
+          return;
+        }
+        next();
+      });
+      return {
+        onUpgrade: (...args) => {
+          for (const cb of upgradeEvents) {
+            cb(...args);
           }
-          addressUrls.push({
-            label: LOCAL_LABEL,
-            url: concatUrl({ host: "localhost", port, protocol })
-          });
-          hasLocalUrl = true;
-        } else {
-          addressUrls.push({
-            label: NETWORK_LABEL,
-            url: concatUrl({ host: detail.address, port, protocol })
-          });
         }
-      }
-      return addressUrls;
+      };
     };
-    COMPILATION_ID_REGEX = /[^a-zA-Z0-9_-]/g;
-    getCompilationId = (compiler) => {
-      const uniqueName = compiler.options.output.uniqueName ?? "";
-      return `${compiler.name ?? ""}_${uniqueName.replace(COMPILATION_ID_REGEX, "_")}`;
+    getMiddlewares = async (options) => {
+      const middlewares = [];
+      const { environments, compileMiddlewareAPI } = options;
+      if (import_rslog.logger.level === "verbose") {
+        middlewares.push(await getRequestLoggerMiddleware());
+      }
+      const { before, after } = applySetupMiddlewares(
+        options.dev,
+        environments,
+        compileMiddlewareAPI
+      );
+      middlewares.push(...before);
+      const { onUpgrade } = await applyDefaultMiddlewares({
+        ...options,
+        middlewares
+      });
+      middlewares.push(...after);
+      return {
+        close: async () => {
+          compileMiddlewareAPI?.close();
+        },
+        onUpgrade,
+        middlewares
+      };
     };
   }
 });
@@ -8606,6 +8674,7 @@ var init_compilerDevMiddleware = __esm({
     "use strict";
     init_path();
     init_devMiddleware();
+    init_helper();
     init_socketServer();
     noop = () => {
     };
@@ -8642,7 +8711,10 @@ var init_compilerDevMiddleware = __esm({
         });
       }
       setupDevMiddleware(devMiddleware, publicPaths) {
-        const { devConfig, serverConfig } = this;
+        const {
+          devConfig,
+          serverConfig: { headers, base }
+        } = this;
         const callbacks = {
           onInvalid: (compilationId) => {
             this.socketServer.sockWrite({
@@ -8656,7 +8728,7 @@ var init_compilerDevMiddleware = __esm({
         };
         const clientPaths = getClientPaths(devConfig);
         const middleware = devMiddleware({
-          headers: serverConfig.headers,
+          headers,
           publicPath: "/",
           stats: false,
           callbacks,
@@ -8669,7 +8741,9 @@ var init_compilerDevMiddleware = __esm({
           // https://developer.mozilla.org/en-US/docs/Web/HTTP/Conditional_requests#weak_validation
           etag: "weak"
         });
-        const assetPrefixes = publicPaths.map(pathnameParse);
+        const assetPrefixes = publicPaths.map(pathnameParse).map(
+          (prefix) => base && base !== "/" ? stripBase(prefix, base) : prefix
+        );
         const warp = async (req, res, next) => {
           const { url: url2 } = req;
           const assetPrefix = url2 && assetPrefixes.find((prefix) => url2.startsWith(prefix));
@@ -10881,13 +10955,16 @@ var init_define = __esm({
       setup(api) {
         api.modifyBundlerChain((chain, { CHAIN_ID: CHAIN_ID2, bundler, environment }) => {
           const { config } = environment;
+          const baseUrl = JSON.stringify(config.server.base);
           const builtinVars = {
             "import.meta.env.MODE": JSON.stringify(config.mode),
             "import.meta.env.DEV": config.mode === "development",
             "import.meta.env.PROD": config.mode === "production",
+            "import.meta.env.BASE_URL": baseUrl,
             "process.env.ASSET_PREFIX": JSON.stringify(
               getPublicPathFromChain(chain, false)
-            )
+            ),
+            "process.env.BASE_URL": baseUrl
           };
           chain.plugin(CHAIN_ID2.PLUGIN.DEFINE).use(bundler.DefinePlugin, [
             { ...builtinVars, ...config.source.define }
@@ -12895,7 +12972,7 @@ var init_prodServer = __esm({
         await this.applyDefaultMiddlewares();
       }
       async applyDefaultMiddlewares() {
-        const { headers, proxy, historyApiFallback, compress } = this.options.serverConfig;
+        const { headers, proxy, historyApiFallback, compress, base } = this.options.serverConfig;
         if (import_rslog.logger.level === "verbose") {
           this.middlewares.use(await getRequestLoggerMiddleware());
         }
@@ -12924,6 +13001,9 @@ var init_prodServer = __esm({
           }
           this.app.on("upgrade", upgrade);
         }
+        if (base && base !== "/") {
+          this.middlewares.use(getBaseMiddleware({ base }));
+        }
         this.applyStaticAssetMiddleware();
         if (historyApiFallback) {
           const { default: connectHistoryApiFallback } = await import("../compiled/connect-history-api-fallback/index.js");
@@ -13267,7 +13347,7 @@ var init_init = __esm({
 
 // src/cli/commands.ts
 function runCli() {
-  program.name("rsbuild").usage("<command> [options]").version("1.0.9");
+  program.name("rsbuild").usage("<command> [options]").version("1.0.10");
   const devCommand = program.command("dev");
   const buildCommand = program.command("build");
   const previewCommand = program.command("preview");
@@ -13386,16 +13466,25 @@ function initNodeEnv() {
 }
 function prepareCli() {
   initNodeEnv();
+  const { enableCompileCache } = import_node_module.default;
+  if (enableCompileCache && !process.env.NODE_DISABLE_COMPILE_CACHE) {
+    try {
+      enableCompileCache();
+    } catch {
+    }
+  }
   const { npm_execpath } = process.env;
   if (!npm_execpath || npm_execpath.includes("npx-cli.js") || npm_execpath.includes(".bun")) {
     console.log();
   }
-  import_rslog.logger.greet(`  ${`Rsbuild v${"1.0.9"}`}
+  import_rslog.logger.greet(`  ${`Rsbuild v${"1.0.10"}`}
 `);
 }
+var import_node_module;
 var init_prepare = __esm({
   "src/cli/prepare.ts"() {
     "use strict";
+    import_node_module = __toESM(require("module"));
     init_logger();
   }
 });
@@ -13474,7 +13563,7 @@ init_logger();
 init_mergeConfig();
 init_helpers();
 init_constants();
-var version = "1.0.9";
+var version = "1.0.10";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PLUGIN_CSS_NAME,