@rsbuild/core 1.0.1-beta.13 → 1.0.1-beta.14

package/compiled/css-loader/index.js

@@ -1,22 +1,22 @@
 (() => {
   var __webpack_modules__ = {
-    1657: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    3904: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
-      const loader = __nccwpck_require__(2403);
+      const loader = __nccwpck_require__(6927);
       module.exports = loader.default;
       module.exports.defaultGetLocalIdent =
-        __nccwpck_require__(6481).defaultGetLocalIdent;
+        __nccwpck_require__(8737).defaultGetLocalIdent;
     },
-    2403: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    6927: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = loader;
       var _postcss = _interopRequireDefault(__nccwpck_require__(9961));
       var _package = _interopRequireDefault(__nccwpck_require__(3357));
       var _semver = __nccwpck_require__(938);
-      var _options = _interopRequireDefault(__nccwpck_require__(4754));
-      var _plugins = __nccwpck_require__(3386);
-      var _utils = __nccwpck_require__(6481);
+      var _options = _interopRequireDefault(__nccwpck_require__(6503));
+      var _plugins = __nccwpck_require__(8503);
+      var _utils = __nccwpck_require__(8737);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -243,7 +243,7 @@
         callback(null, `${importCode}${moduleCode}${exportCode}`);
       }
     },
-    3386: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    8503: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       Object.defineProperty(exports, "icssParser", {
@@ -265,22 +265,22 @@
         },
       });
       var _postcssImportParser = _interopRequireDefault(
-        __nccwpck_require__(8460),
+        __nccwpck_require__(2662),
       );
       var _postcssIcssParser = _interopRequireDefault(
-        __nccwpck_require__(4048),
+        __nccwpck_require__(5161),
       );
-      var _postcssUrlParser = _interopRequireDefault(__nccwpck_require__(6531));
+      var _postcssUrlParser = _interopRequireDefault(__nccwpck_require__(6837));
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
     },
-    4048: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    5161: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _icssUtils = __nccwpck_require__(6370);
-      var _utils = __nccwpck_require__(6481);
+      var _utils = __nccwpck_require__(8737);
       const plugin = (options = {}) => ({
         postcssPlugin: "postcss-icss-parser",
         async OnceExit(root) {
@@ -379,14 +379,14 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    8460: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    2662: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _postcssValueParser = _interopRequireDefault(
         __nccwpck_require__(7555),
       );
-      var _utils = __nccwpck_require__(6481);
+      var _utils = __nccwpck_require__(8737);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -691,14 +691,14 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    6531: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    6837: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _postcssValueParser = _interopRequireDefault(
         __nccwpck_require__(7555),
       );
-      var _utils = __nccwpck_require__(6481);
+      var _utils = __nccwpck_require__(8737);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -1041,7 +1041,7 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    6481: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    8737: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.WEBPACK_IGNORE_COMMENT_REGEXP = void 0;
@@ -7964,7 +7964,7 @@
       "use strict";
       module.exports = require("util");
     },
-    4754: (module) => {
+    6503: (module) => {
       "use strict";
       module.exports = JSON.parse(
         '{"title":"CSS Loader options","additionalProperties":false,"properties":{"url":{"description":"Allows to enables/disables `url()`/`image-set()` functions handling.","link":"https://github.com/webpack-contrib/css-loader#url","anyOf":[{"type":"boolean"},{"type":"object","properties":{"filter":{"instanceof":"Function"}},"additionalProperties":false}]},"import":{"description":"Allows to enables/disables `@import` at-rules handling.","link":"https://github.com/webpack-contrib/css-loader#import","anyOf":[{"type":"boolean"},{"type":"object","properties":{"filter":{"instanceof":"Function"}},"additionalProperties":false}]},"modules":{"description":"Allows to enable/disable CSS Modules or ICSS and setup configuration.","link":"https://github.com/webpack-contrib/css-loader#modules","anyOf":[{"type":"boolean"},{"enum":["local","global","pure","icss"]},{"type":"object","additionalProperties":false,"properties":{"auto":{"description":"Allows auto enable CSS modules based on filename.","link":"https://github.com/webpack-contrib/css-loader#auto","anyOf":[{"instanceof":"RegExp"},{"instanceof":"Function"},{"type":"boolean"}]},"mode":{"description":"Setup `mode` option.","link":"https://github.com/webpack-contrib/css-loader#mode","anyOf":[{"enum":["local","global","pure","icss"]},{"instanceof":"Function"}]},"localIdentName":{"description":"Allows to configure the generated local ident name.","link":"https://github.com/webpack-contrib/css-loader#localidentname","type":"string","minLength":1},"localIdentContext":{"description":"Allows to redefine basic loader context for local ident name.","link":"https://github.com/webpack-contrib/css-loader#localidentcontext","type":"string","minLength":1},"localIdentHashSalt":{"description":"Allows to add custom hash to generate more unique classes.","link":"https://github.com/webpack-contrib/css-loader#localidenthashsalt","type":"string","minLength":1},"localIdentHashFunction":{"description":"Allows to specify hash function to generate classes.","link":"https://github.com/webpack-contrib/css-loader#localidenthashfunction","type":"string","minLength":1},"localIdentHashDigest":{"description":"Allows to specify hash digest to generate classes.","link":"https://github.com/webpack-contrib/css-loader#localidenthashdigest","type":"string","minLength":1},"localIdentHashDigestLength":{"description":"Allows to specify hash digest length to generate classes.","link":"https://github.com/webpack-contrib/css-loader#localidenthashdigestlength","type":"number"},"hashStrategy":{"description":"Allows to specify should localName be used when computing the hash.","link":"https://github.com/webpack-contrib/css-loader#hashstrategy","enum":["resource-path-and-local-name","minimal-subset"]},"localIdentRegExp":{"description":"Allows to specify custom RegExp for local ident name.","link":"https://github.com/webpack-contrib/css-loader#localidentregexp","anyOf":[{"type":"string","minLength":1},{"instanceof":"RegExp"}]},"getLocalIdent":{"description":"Allows to specify a function to generate the classname.","link":"https://github.com/webpack-contrib/css-loader#getlocalident","instanceof":"Function"},"namedExport":{"description":"Enables/disables ES modules named export for locals.","link":"https://github.com/webpack-contrib/css-loader#namedexport","type":"boolean"},"exportGlobals":{"description":"Allows to export names from global class or id, so you can use that as local name.","link":"https://github.com/webpack-contrib/css-loader#exportglobals","type":"boolean"},"exportLocalsConvention":{"description":"Style of exported classnames.","link":"https://github.com/webpack-contrib/css-loader#localsconvention","anyOf":[{"enum":["asIs","as-is","camelCase","camel-case","camelCaseOnly","camel-case-only","dashes","dashesOnly","dashes-only"]},{"instanceof":"Function"}]},"exportOnlyLocals":{"description":"Export only locals.","link":"https://github.com/webpack-contrib/css-loader#exportonlylocals","type":"boolean"},"getJSON":{"description":"Allows outputting of CSS modules mapping through a callback.","link":"https://github.com/webpack-contrib/css-loader#getJSON","instanceof":"Function"}}}]},"sourceMap":{"description":"Allows to enable/disable source maps.","link":"https://github.com/webpack-contrib/css-loader#sourcemap","type":"boolean"},"importLoaders":{"description":"Allows enables/disables or setups number of loaders applied before CSS loader for `@import`/CSS Modules and ICSS imports.","link":"https://github.com/webpack-contrib/css-loader#importloaders","anyOf":[{"type":"boolean"},{"type":"string"},{"type":"integer"}]},"esModule":{"description":"Use the ES modules syntax.","link":"https://github.com/webpack-contrib/css-loader#esmodule","type":"boolean"},"exportType":{"description":"Allows exporting styles as array with modules, string or constructable stylesheet (i.e. `CSSStyleSheet`).","link":"https://github.com/webpack-contrib/css-loader#exporttype","enum":["array","string","css-style-sheet"]}},"type":"object"}',
@@ -7999,6 +7999,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(1657);
+  var __webpack_exports__ = __nccwpck_require__(3904);
   module.exports = __webpack_exports__;
 })();

package/compiled/html-rspack-plugin/index.js

@@ -1,8 +1,8 @@
 (() => {
   var __webpack_modules__ = {
-    993: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    523: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
-      const { HtmlWebpackChildCompiler } = __nccwpck_require__(595);
+      const { HtmlWebpackChildCompiler } = __nccwpck_require__(862);
       const compilerMap = new WeakMap();
       class CachedChildCompilation {
         constructor(compiler) {
@@ -304,7 +304,7 @@
       }
       module.exports = { CachedChildCompilation };
     },
-    595: (module) => {
+    862: (module) => {
       "use strict";
       class HtmlWebpackChildCompiler {
         constructor(templates) {
@@ -465,7 +465,7 @@
       }
       module.exports = { HtmlWebpackChildCompiler };
     },
-    112: (module) => {
+    122: (module) => {
       "use strict";
       module.exports = {};
       module.exports.none = (chunks) => chunks;
@@ -484,7 +484,7 @@
       };
       module.exports.auto = module.exports.none;
     },
-    409: (module) => {
+    929: (module) => {
       "use strict";
       module.exports = function (err) {
         return {
@@ -505,7 +505,7 @@
         };
       };
     },
-    600: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    309: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const { AsyncSeriesWaterfallHook } = __nccwpck_require__(348);
       const htmlWebpackPluginHooksMap = new WeakMap();
@@ -531,7 +531,7 @@
       }
       module.exports = { getHtmlRspackPluginHooks };
     },
-    429: (module) => {
+    624: (module) => {
       const voidTags = [
         "area",
         "base",
@@ -599,19 +599,19 @@
         htmlTagObjectToString,
       };
     },
-    964: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    31: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const promisify = __nccwpck_require__(837).promisify;
       const vm = __nccwpck_require__(144);
       const fs = __nccwpck_require__(147);
       const path = __nccwpck_require__(17);
-      const { CachedChildCompilation } = __nccwpck_require__(993);
+      const { CachedChildCompilation } = __nccwpck_require__(523);
       const { createHtmlTagObject, htmlTagObjectToString, HtmlTagArray } =
-        __nccwpck_require__(429);
-      const prettyError = __nccwpck_require__(409);
-      const chunkSorter = __nccwpck_require__(112);
+        __nccwpck_require__(624);
+      const prettyError = __nccwpck_require__(929);
+      const chunkSorter = __nccwpck_require__(122);
       const getHtmlRspackPluginHooks =
-        __nccwpck_require__(600).getHtmlRspackPluginHooks;
+        __nccwpck_require__(309).getHtmlRspackPluginHooks;
       class HtmlRspackPlugin {
         constructor(userOptions = {}) {
           this.version = HtmlRspackPlugin.version;
@@ -1569,6 +1569,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(964);
+  var __webpack_exports__ = __nccwpck_require__(31);
   module.exports = __webpack_exports__;
 })();

package/compiled/postcss-loader/index.js

@@ -1,17 +1,17 @@
 (() => {
   "use strict";
   var __webpack_modules__ = {
-    736: (module, __unused_webpack_exports, __nccwpck_require__) => {
-      module.exports = __nccwpck_require__(724)["default"];
+    83: (module, __unused_webpack_exports, __nccwpck_require__) => {
+      module.exports = __nccwpck_require__(71)["default"];
     },
-    724: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    71: (__unused_webpack_module, exports, __nccwpck_require__) => {
       var __webpack_unused_export__;
       __webpack_unused_export__ = { value: true };
       exports["default"] = loader;
       var _path = _interopRequireDefault(__nccwpck_require__(17));
       var _package = _interopRequireDefault(__nccwpck_require__(357));
-      var _options = _interopRequireDefault(__nccwpck_require__(922));
-      var _utils = __nccwpck_require__(493);
+      var _options = _interopRequireDefault(__nccwpck_require__(978));
+      var _utils = __nccwpck_require__(516);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -189,7 +189,7 @@
         callback(null, result.css, map, { ast });
       }
     },
-    493: (module, exports, __nccwpck_require__) => {
+    516: (module, exports, __nccwpck_require__) => {
       module = __nccwpck_require__.nmd(module);
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.exec = exec;
@@ -694,7 +694,7 @@
     310: (module) => {
       module.exports = require("url");
     },
-    922: (module) => {
+    978: (module) => {
       module.exports = JSON.parse(
         '{"title":"PostCSS Loader options","type":"object","properties":{"postcssOptions":{"description":"Options to pass through to `Postcss`.","link":"https://github.com/webpack-contrib/postcss-loader#postcssOptions","anyOf":[{"type":"object","additionalProperties":true,"properties":{"config":{"description":"Allows to specify PostCSS config path.","link":"https://github.com/webpack-contrib/postcss-loader#config","anyOf":[{"description":"Allows to specify the path to the configuration file","type":"string"},{"description":"Enables/Disables autoloading config","type":"boolean"}]}}},{"instanceof":"Function"}]},"execute":{"description":"Enables/Disables PostCSS parser support in \'CSS-in-JS\'.","link":"https://github.com/webpack-contrib/postcss-loader#execute","type":"boolean"},"sourceMap":{"description":"Enables/Disables generation of source maps.","link":"https://github.com/webpack-contrib/postcss-loader#sourcemap","type":"boolean"},"implementation":{"description":"The implementation of postcss to use, instead of the locally installed version","link":"https://github.com/webpack-contrib/postcss-loader#implementation","anyOf":[{"type":"string"},{"instanceof":"Function"}]}},"additionalProperties":false}',
       );
@@ -739,6 +739,6 @@
   })();
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(736);
+  var __webpack_exports__ = __nccwpck_require__(83);
   module.exports = __webpack_exports__;
 })();

package/compiled/rspack-manifest-plugin/index.js

@@ -1,7 +1,7 @@
 (() => {
   "use strict";
   var __webpack_modules__ = {
-    834: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    345: (__unused_webpack_module, exports, __nccwpck_require__) => {
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.transformFiles =
         exports.reduceChunk =
@@ -120,7 +120,7 @@
           .map(standardizeFilePaths);
       exports.transformFiles = transformFiles;
     },
-    672: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    77: (__unused_webpack_module, exports, __nccwpck_require__) => {
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.normalModuleLoaderHook =
         exports.getCompilerHooks =
@@ -130,7 +130,7 @@
       const fs_1 = __nccwpck_require__(147);
       const path_1 = __nccwpck_require__(17);
       const lite_tapable_1 = __nccwpck_require__(348);
-      const helpers_1 = __nccwpck_require__(834);
+      const helpers_1 = __nccwpck_require__(345);
       const compilerHookMap = new WeakMap();
       const getCompilerHooks = (compiler) => {
         let hooks = compilerHookMap.get(compiler);
@@ -312,7 +312,7 @@
       exports.getCompilerHooks =
         void 0;
     const path_1 = __nccwpck_require__(17);
-    const hooks_1 = __nccwpck_require__(672);
+    const hooks_1 = __nccwpck_require__(77);
     Object.defineProperty(exports, "getCompilerHooks", {
       enumerable: true,
       get: function () {

package/dist/index.cjs

@@ -1174,6 +1174,7 @@ var init_config = __esm({
     });
     getDefaultOutputConfig = () => ({
       target: "web",
+      cleanDistPath: "auto",
       distPath: {
         root: ROOT_DIST_DIR,
         css: CSS_DIST_DIR,
@@ -2282,7 +2283,7 @@ async function createContext(options, userConfig, bundlerType) {
   const rsbuildConfig = await withDefaultConfig(rootPath, userConfig);
   const cachePath = (0, import_node_path9.join)(rootPath, "node_modules", ".cache");
   return {
-    version: "1.0.1-beta.13",
+    version: "1.0.1-beta.14",
     rootPath,
     distPath: "",
     cachePath,
@@ -4857,9 +4858,6 @@ async function createDevServer(options, createDevMiddleware2, config, {
   getPortSilently,
   runCompile = true
 } = {}) {
-  if (!getNodeEnv()) {
-    setNodeEnv("development");
-  }
   import_rslog.logger.debug("create dev server");
   const { port, host, https } = await getServerConfig({
     config,
@@ -5042,7 +5040,9 @@ async function createDevServer(options, createDevMiddleware2, config, {
         environments: options.context.environments
       });
     },
-    onHTTPUpgrade: devMiddlewares.onUpgrade,
+    connectWebSocket: ({ server: server2 }) => {
+      server2.on("upgrade", devMiddlewares.onUpgrade);
+    },
     close: async () => {
       await options.context.hooks.onCloseDevServer.call();
       await devMiddlewares.close();
@@ -5086,15 +5086,11 @@ var init_build = __esm({
   "src/provider/build.ts"() {
     "use strict";
     import_core4 = require("@rspack/core");
-    init_helpers();
     init_hooks();
     init_logger();
     init_createCompiler();
     init_initConfigs();
     build = async (initOptions, { watch, compiler: customCompiler } = {}) => {
-      if (!getNodeEnv()) {
-        setNodeEnv("production");
-      }
       const { context } = initOptions;
       let compiler;
       let bundlerConfigs;
@@ -6332,7 +6328,7 @@ var init_cleanOutput = __esm({
           const config = api.getNormalizedConfig();
           const cleanPath = (0, import_node_path23.join)(distPath, RSBUILD_OUTPUTS_PATH);
           const { cleanDistPath } = config.output;
-          if (cleanDistPath && isStrictSubdir(rootPath, cleanPath)) {
+          if (cleanDistPath === true || cleanDistPath === "auto" && isStrictSubdir(rootPath, cleanPath)) {
             return cleanPath;
           }
           return void 0;
@@ -6341,7 +6337,7 @@ var init_cleanOutput = __esm({
           const { rootPath } = api.context;
           const { config, distPath } = environment;
           let { cleanDistPath } = config.output;
-          if (cleanDistPath === void 0) {
+          if (cleanDistPath === "auto") {
             cleanDistPath = isStrictSubdir(rootPath, distPath);
             if (!cleanDistPath) {
               import_rslog.logger.warn(
@@ -6964,68 +6960,111 @@ var init_appIcon = __esm({
     pluginAppIcon = () => ({
       name: "rsbuild:app-icon",
       setup(api) {
-        const cache = /* @__PURE__ */ new Map();
-        const getIconPath = ({ config, name }) => {
-          const { appIcon } = config.html;
-          if (!appIcon) {
-            return;
-          }
-          const cached = cache.get(name);
+        const htmlTagsMap = /* @__PURE__ */ new Map();
+        const iconPathMap = /* @__PURE__ */ new Map();
+        const formatIcon = (icon, distDir, publicPath) => {
+          const { src, size } = icon;
+          const cached = iconPathMap.get(src);
+          const sizes = `${size}x${size}`;
           if (cached) {
-            cached;
+            return {
+              sizes,
+              ...cached,
+              ...icon
+            };
           }
-          const distDir = config.output.distPath.image;
-          const absolutePath = import_node_path27.default.isAbsolute(appIcon) ? appIcon : import_node_path27.default.join(api.context.rootPath, appIcon);
+          const absolutePath = import_node_path27.default.isAbsolute(src) ? src : import_node_path27.default.join(api.context.rootPath, src);
           const relativePath = import_node_path27.default.posix.join(
             distDir,
             import_node_path27.default.basename(absolutePath)
           );
+          const requestPath = ensureAssetPrefix(relativePath, publicPath);
           const paths = {
+            requestPath,
             absolutePath,
             relativePath
           };
-          cache.set(name, paths);
-          return paths;
+          iconPathMap.set(src, paths);
+          return {
+            sizes,
+            ...paths,
+            ...icon
+          };
         };
         api.processAssets(
           { stage: "additional" },
           async ({ compilation, environment, sources }) => {
-            const iconPath = getIconPath(environment);
-            if (!iconPath) {
+            const { config } = environment;
+            const { appIcon } = config.html;
+            if (!appIcon) {
               return;
             }
-            if (!await isFileExists(iconPath.absolutePath)) {
-              throw new Error(
-                `[rsbuild:app-icon] Can not find the app icon, please check if the '${iconPath.relativePath}' file exists'.`
+            const distDir = config.output.distPath.image;
+            const publicPath = getPublicPathFromCompiler(compilation);
+            const icons = appIcon.icons.map(
+              (icon) => formatIcon(icon, distDir, publicPath)
+            );
+            const tags = [];
+            for (const icon of icons) {
+              if (!await isFileExists(icon.absolutePath)) {
+                throw new Error(
+                  `[rsbuild:app-icon] Can not find the app icon, please check if the '${icon.relativePath}' file exists'.`
+                );
+              }
+              const source = await import_node_fs8.default.promises.readFile(icon.absolutePath);
+              compilation.emitAsset(
+                icon.relativePath,
+                new sources.RawSource(source)
               );
+              if (icon.size < 200) {
+                tags.push({
+                  tag: "link",
+                  attrs: {
+                    rel: "apple-touch-icon",
+                    sizes: icon.sizes,
+                    href: icon.requestPath
+                  }
+                });
+              }
             }
-            const source = await import_node_fs8.default.promises.readFile(iconPath.absolutePath);
-            compilation.emitAsset(
-              iconPath.relativePath,
-              new sources.RawSource(source)
-            );
-          }
-        );
-        api.modifyHTMLTags(
-          ({ headTags, bodyTags }, { environment, compilation }) => {
-            const iconPath = getIconPath(environment);
-            if (!iconPath) {
-              return { headTags, bodyTags };
+            if (appIcon.name) {
+              const manifestIcons = icons.map((icon) => ({
+                src: icon.requestPath,
+                sizes: icon.sizes
+              }));
+              const manifest = {
+                name: appIcon.name,
+                icons: manifestIcons
+              };
+              const manifestFile = "manifest.webmanifest";
+              compilation.emitAsset(
+                manifestFile,
+                new sources.RawSource(JSON.stringify(manifest))
+              );
+              tags.push({
+                tag: "link",
+                attrs: {
+                  rel: "manifest",
+                  href: ensureAssetPrefix(manifestFile, publicPath)
+                }
+              });
+            }
+            if (tags.length) {
+              htmlTagsMap.set(environment.name, tags);
             }
-            headTags.unshift({
-              tag: "link",
-              attrs: {
-                rel: "apple-touch-icon",
-                sizes: "180*180",
-                href: ensureAssetPrefix(
-                  iconPath.relativePath,
-                  compilation.outputOptions.publicPath
-                )
-              }
-            });
-            return { headTags, bodyTags };
           }
         );
+        api.modifyHTMLTags(({ headTags, bodyTags }, { environment }) => {
+          const tags = htmlTagsMap.get(environment.name);
+          if (tags) {
+            headTags.unshift(...tags);
+          }
+          return { headTags, bodyTags };
+        });
+        api.onCloseDevServer(() => {
+          htmlTagsMap.clear();
+          iconPathMap.clear();
+        });
       }
     });
   }
@@ -9077,9 +9116,6 @@ __export(prodServer_exports, {
   startProdServer: () => startProdServer
 });
 async function startProdServer(context, config, { getPortSilently } = {}) {
-  if (!getNodeEnv()) {
-    setNodeEnv("production");
-  }
   const { port, host, https } = await getServerConfig({
     config,
     getPortSilently
@@ -9148,7 +9184,6 @@ var RsbuildProdServer;
 var init_prodServer = __esm({
   "src/server/prodServer.ts"() {
     "use strict";
-    init_helpers();
     init_path();
     init_logger();
     init_helper();
@@ -9342,11 +9377,36 @@ async function createRsbuild(options = {}) {
     setCssExtractPlugin
   });
   const preview = async (options2) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("production");
+    }
     const { startProdServer: startProdServer2 } = await Promise.resolve().then(() => (init_prodServer(), prodServer_exports));
     const config = await initRsbuildConfig({ context, pluginManager });
     return startProdServer2(context, config, options2);
   };
+  const build2 = (...args) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("production");
+    }
+    return providerInstance.build(...args);
+  };
+  const startDevServer = (...args) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("development");
+    }
+    return providerInstance.startDevServer(...args);
+  };
+  const createDevServer2 = (...args) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("development");
+    }
+    return providerInstance.createDevServer(...args);
+  };
   const rsbuild = {
+    build: build2,
+    preview,
+    startDevServer,
+    createDevServer: createDevServer2,
     ...pick(pluginManager, [
       "addPlugins",
       "getPlugins",
@@ -9354,6 +9414,7 @@ async function createRsbuild(options = {}) {
       "isPluginExists"
     ]),
     ...pick(globalPluginAPI, [
+      "context",
       "onBeforeBuild",
       "onBeforeCreateCompiler",
       "onBeforeStartDevServer",
@@ -9369,15 +9430,10 @@ async function createRsbuild(options = {}) {
       "getNormalizedConfig"
     ]),
     ...pick(providerInstance, [
-      "build",
       "initConfigs",
       "inspectConfig",
-      "createCompiler",
-      "createDevServer",
-      "startDevServer"
-    ]),
-    preview,
-    context: globalPluginAPI.context
+      "createCompiler"
+    ])
   };
   if (rsbuildConfig.plugins) {
     const plugins = await Promise.all(rsbuildConfig.plugins);
@@ -9510,7 +9566,7 @@ var init_init = __esm({
 
 // src/cli/commands.ts
 function runCli() {
-  import_commander.program.name("rsbuild").usage("<command> [options]").version("1.0.1-beta.13");
+  import_commander.program.name("rsbuild").usage("<command> [options]").version("1.0.1-beta.14");
   const devCommand = import_commander.program.command("dev");
   const buildCommand = import_commander.program.command("build");
   const previewCommand = import_commander.program.command("preview");
@@ -9633,7 +9689,7 @@ function prepareCli() {
   if (!npm_execpath || npm_execpath.includes("npx-cli.js") || npm_execpath.includes(".bun")) {
     console.log();
   }
-  import_rslog.logger.greet(`  ${`Rsbuild v${"1.0.1-beta.13"}`}
+  import_rslog.logger.greet(`  ${`Rsbuild v${"1.0.1-beta.14"}`}
 `);
 }
 var init_prepare = __esm({
@@ -9719,7 +9775,7 @@ init_logger();
 init_mergeConfig();
 init_helpers();
 init_constants();
-var version = "1.0.1-beta.13";
+var version = "1.0.1-beta.14";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PLUGIN_CSS_NAME,

package/dist/index.js

@@ -1207,6 +1207,7 @@ var init_config = __esm({
     });
     getDefaultOutputConfig = () => ({
       target: "web",
+      cleanDistPath: "auto",
       distPath: {
         root: ROOT_DIST_DIR,
         css: CSS_DIST_DIR,
@@ -2320,7 +2321,7 @@ async function createContext(options, userConfig, bundlerType) {
   const rsbuildConfig = await withDefaultConfig(rootPath, userConfig);
   const cachePath = join6(rootPath, "node_modules", ".cache");
   return {
-    version: "1.0.1-beta.13",
+    version: "1.0.1-beta.14",
     rootPath,
     distPath: "",
     cachePath,
@@ -4917,9 +4918,6 @@ async function createDevServer(options, createDevMiddleware2, config, {
   getPortSilently,
   runCompile = true
 } = {}) {
-  if (!getNodeEnv()) {
-    setNodeEnv("development");
-  }
   logger.debug("create dev server");
   const { port, host, https } = await getServerConfig({
     config,
@@ -5102,7 +5100,9 @@ async function createDevServer(options, createDevMiddleware2, config, {
         environments: options.context.environments
       });
     },
-    onHTTPUpgrade: devMiddlewares.onUpgrade,
+    connectWebSocket: ({ server: server2 }) => {
+      server2.on("upgrade", devMiddlewares.onUpgrade);
+    },
     close: async () => {
       await options.context.hooks.onCloseDevServer.call();
       await devMiddlewares.close();
@@ -5147,15 +5147,11 @@ var init_build = __esm({
   "src/provider/build.ts"() {
     "use strict";
     init_esm();
-    init_helpers();
     init_hooks();
     init_logger();
     init_createCompiler();
     init_initConfigs();
     build = async (initOptions, { watch, compiler: customCompiler } = {}) => {
-      if (!getNodeEnv()) {
-        setNodeEnv("production");
-      }
       const { context } = initOptions;
       let compiler;
       let bundlerConfigs;
@@ -6405,7 +6401,7 @@ var init_cleanOutput = __esm({
           const config = api.getNormalizedConfig();
           const cleanPath = join11(distPath, RSBUILD_OUTPUTS_PATH);
           const { cleanDistPath } = config.output;
-          if (cleanDistPath && isStrictSubdir(rootPath, cleanPath)) {
+          if (cleanDistPath === true || cleanDistPath === "auto" && isStrictSubdir(rootPath, cleanPath)) {
             return cleanPath;
           }
           return void 0;
@@ -6414,7 +6410,7 @@ var init_cleanOutput = __esm({
           const { rootPath } = api.context;
           const { config, distPath } = environment;
           let { cleanDistPath } = config.output;
-          if (cleanDistPath === void 0) {
+          if (cleanDistPath === "auto") {
             cleanDistPath = isStrictSubdir(rootPath, distPath);
             if (!cleanDistPath) {
               logger.warn(
@@ -7041,68 +7037,111 @@ var init_appIcon = __esm({
     pluginAppIcon = () => ({
       name: "rsbuild:app-icon",
       setup(api) {
-        const cache = /* @__PURE__ */ new Map();
-        const getIconPath = ({ config, name }) => {
-          const { appIcon } = config.html;
-          if (!appIcon) {
-            return;
-          }
-          const cached = cache.get(name);
+        const htmlTagsMap = /* @__PURE__ */ new Map();
+        const iconPathMap = /* @__PURE__ */ new Map();
+        const formatIcon = (icon, distDir, publicPath) => {
+          const { src, size } = icon;
+          const cached = iconPathMap.get(src);
+          const sizes = `${size}x${size}`;
           if (cached) {
-            cached;
+            return {
+              sizes,
+              ...cached,
+              ...icon
+            };
           }
-          const distDir = config.output.distPath.image;
-          const absolutePath = path14.isAbsolute(appIcon) ? appIcon : path14.join(api.context.rootPath, appIcon);
+          const absolutePath = path14.isAbsolute(src) ? src : path14.join(api.context.rootPath, src);
           const relativePath = path14.posix.join(
             distDir,
             path14.basename(absolutePath)
           );
+          const requestPath = ensureAssetPrefix(relativePath, publicPath);
           const paths = {
+            requestPath,
             absolutePath,
             relativePath
           };
-          cache.set(name, paths);
-          return paths;
+          iconPathMap.set(src, paths);
+          return {
+            sizes,
+            ...paths,
+            ...icon
+          };
         };
         api.processAssets(
           { stage: "additional" },
           async ({ compilation, environment, sources }) => {
-            const iconPath = getIconPath(environment);
-            if (!iconPath) {
+            const { config } = environment;
+            const { appIcon } = config.html;
+            if (!appIcon) {
               return;
             }
-            if (!await isFileExists(iconPath.absolutePath)) {
-              throw new Error(
-                `[rsbuild:app-icon] Can not find the app icon, please check if the '${iconPath.relativePath}' file exists'.`
+            const distDir = config.output.distPath.image;
+            const publicPath = getPublicPathFromCompiler(compilation);
+            const icons = appIcon.icons.map(
+              (icon) => formatIcon(icon, distDir, publicPath)
+            );
+            const tags = [];
+            for (const icon of icons) {
+              if (!await isFileExists(icon.absolutePath)) {
+                throw new Error(
+                  `[rsbuild:app-icon] Can not find the app icon, please check if the '${icon.relativePath}' file exists'.`
+                );
+              }
+              const source = await fs8.promises.readFile(icon.absolutePath);
+              compilation.emitAsset(
+                icon.relativePath,
+                new sources.RawSource(source)
               );
+              if (icon.size < 200) {
+                tags.push({
+                  tag: "link",
+                  attrs: {
+                    rel: "apple-touch-icon",
+                    sizes: icon.sizes,
+                    href: icon.requestPath
+                  }
+                });
+              }
             }
-            const source = await fs8.promises.readFile(iconPath.absolutePath);
-            compilation.emitAsset(
-              iconPath.relativePath,
-              new sources.RawSource(source)
-            );
-          }
-        );
-        api.modifyHTMLTags(
-          ({ headTags, bodyTags }, { environment, compilation }) => {
-            const iconPath = getIconPath(environment);
-            if (!iconPath) {
-              return { headTags, bodyTags };
+            if (appIcon.name) {
+              const manifestIcons = icons.map((icon) => ({
+                src: icon.requestPath,
+                sizes: icon.sizes
+              }));
+              const manifest = {
+                name: appIcon.name,
+                icons: manifestIcons
+              };
+              const manifestFile = "manifest.webmanifest";
+              compilation.emitAsset(
+                manifestFile,
+                new sources.RawSource(JSON.stringify(manifest))
+              );
+              tags.push({
+                tag: "link",
+                attrs: {
+                  rel: "manifest",
+                  href: ensureAssetPrefix(manifestFile, publicPath)
+                }
+              });
+            }
+            if (tags.length) {
+              htmlTagsMap.set(environment.name, tags);
             }
-            headTags.unshift({
-              tag: "link",
-              attrs: {
-                rel: "apple-touch-icon",
-                sizes: "180*180",
-                href: ensureAssetPrefix(
-                  iconPath.relativePath,
-                  compilation.outputOptions.publicPath
-                )
-              }
-            });
-            return { headTags, bodyTags };
           }
         );
+        api.modifyHTMLTags(({ headTags, bodyTags }, { environment }) => {
+          const tags = htmlTagsMap.get(environment.name);
+          if (tags) {
+            headTags.unshift(...tags);
+          }
+          return { headTags, bodyTags };
+        });
+        api.onCloseDevServer(() => {
+          htmlTagsMap.clear();
+          iconPathMap.clear();
+        });
       }
     });
   }
@@ -9180,9 +9219,6 @@ __export(prodServer_exports, {
   startProdServer: () => startProdServer
 });
 async function startProdServer(context, config, { getPortSilently } = {}) {
-  if (!getNodeEnv()) {
-    setNodeEnv("production");
-  }
   const { port, host, https } = await getServerConfig({
     config,
     getPortSilently
@@ -9252,7 +9288,6 @@ var init_prodServer = __esm({
   "src/server/prodServer.ts"() {
     "use strict";
     init_esm();
-    init_helpers();
     init_path();
     init_logger();
     init_helper();
@@ -9446,11 +9481,36 @@ async function createRsbuild(options = {}) {
     setCssExtractPlugin
   });
   const preview = async (options2) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("production");
+    }
     const { startProdServer: startProdServer2 } = await Promise.resolve().then(() => (init_prodServer(), prodServer_exports));
     const config = await initRsbuildConfig({ context, pluginManager });
     return startProdServer2(context, config, options2);
   };
+  const build2 = (...args) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("production");
+    }
+    return providerInstance.build(...args);
+  };
+  const startDevServer = (...args) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("development");
+    }
+    return providerInstance.startDevServer(...args);
+  };
+  const createDevServer2 = (...args) => {
+    if (!getNodeEnv()) {
+      setNodeEnv("development");
+    }
+    return providerInstance.createDevServer(...args);
+  };
   const rsbuild = {
+    build: build2,
+    preview,
+    startDevServer,
+    createDevServer: createDevServer2,
     ...pick(pluginManager, [
       "addPlugins",
       "getPlugins",
@@ -9458,6 +9518,7 @@ async function createRsbuild(options = {}) {
       "isPluginExists"
     ]),
     ...pick(globalPluginAPI, [
+      "context",
       "onBeforeBuild",
       "onBeforeCreateCompiler",
       "onBeforeStartDevServer",
@@ -9473,15 +9534,10 @@ async function createRsbuild(options = {}) {
       "getNormalizedConfig"
     ]),
     ...pick(providerInstance, [
-      "build",
       "initConfigs",
       "inspectConfig",
-      "createCompiler",
-      "createDevServer",
-      "startDevServer"
-    ]),
-    preview,
-    context: globalPluginAPI.context
+      "createCompiler"
+    ])
   };
   if (rsbuildConfig.plugins) {
     const plugins = await Promise.all(rsbuildConfig.plugins);
@@ -9619,7 +9675,7 @@ import { existsSync } from "fs";
 import { program } from "../compiled/commander/index.js";
 import color16 from "../compiled/picocolors/index.js";
 function runCli() {
-  program.name("rsbuild").usage("<command> [options]").version("1.0.1-beta.13");
+  program.name("rsbuild").usage("<command> [options]").version("1.0.1-beta.14");
   const devCommand = program.command("dev");
   const buildCommand = program.command("build");
   const previewCommand = program.command("preview");
@@ -9740,7 +9796,7 @@ function prepareCli() {
   if (!npm_execpath || npm_execpath.includes("npx-cli.js") || npm_execpath.includes(".bun")) {
     console.log();
   }
-  logger.greet(`  ${`Rsbuild v${"1.0.1-beta.13"}`}
+  logger.greet(`  ${`Rsbuild v${"1.0.1-beta.14"}`}
 `);
 }
 var init_prepare = __esm({
@@ -9813,7 +9869,7 @@ init_mergeConfig();
 init_helpers();
 init_constants();
 import { rspack as rspack10 } from "@rspack/core";
-var version = "1.0.1-beta.13";
+var version = "1.0.1-beta.14";
 export {
   PLUGIN_CSS_NAME,
   PLUGIN_SWC_NAME,

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

@@ -19,7 +19,7 @@ export declare const removeTailingSlash: (s: string) => string;
 export declare const addTrailingSlash: (s: string) => string;
 export declare const formatPublicPath: (publicPath: string, withSlash?: boolean) => string;
 export declare const getPublicPathFromChain: (chain: RspackChain, withSlash?: boolean) => string;
-export declare const getPublicPathFromCompiler: (compiler: Rspack.Compiler) => string;
+export declare const getPublicPathFromCompiler: (compiler: Rspack.Compiler | Rspack.Compilation) => string;
 export declare const canParse: (url: string) => boolean;
 export declare const ensureAssetPrefix: (url: string, assetPrefix?: Rspack.PublicPath) => string;
 export declare function getFilename(config: NormalizedConfig | NormalizedEnvironmentConfig, type: 'js', isProd: boolean, isServer?: boolean): NonNullable<FilenameConfig['js']>;

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

@@ -1,7 +1,9 @@
+import type { Server } from 'node:http';
+import type { Http2SecureServer } from 'node:http2';
 import type Connect from '../../compiled/connect';
 import type { CreateDevMiddlewareReturns } from '../provider/createCompiler';
 import type { CreateDevServerOptions, EnvironmentAPI, InternalContext, NormalizedConfig, StartDevServerOptions } from '../types';
-import { type UpgradeEvent } from './helper';
+type HTTPServer = Server | Http2SecureServer;
 export type RsbuildDevServer = {
     /**
      * Use rsbuild inner server to listen
@@ -35,11 +37,13 @@ export type RsbuildDevServer = {
      */
     afterListen: () => Promise<void>;
     /**
-     * Subscribe http upgrade event
+     * Activate socket connection
      *
      * It will used when you use custom server
      */
-    onHTTPUpgrade: UpgradeEvent;
+    connectWebSocket: (options: {
+        server: HTTPServer;
+    }) => void;
     /**
      * Close the Rsbuild server.
      */
@@ -48,3 +52,4 @@ export type RsbuildDevServer = {
 export declare function createDevServer<Options extends {
     context: InternalContext;
 }>(options: Options, createDevMiddleware: (options: Options, compiler: StartDevServerOptions['compiler']) => Promise<CreateDevMiddlewareReturns>, config: NormalizedConfig, { compiler: customCompiler, getPortSilently, runCompile, }?: CreateDevServerOptions): Promise<RsbuildDevServer>;
+export {};

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

@@ -40,6 +40,10 @@ export type HtmlTagDescriptor = HtmlTag | HtmlTagHandler;
 type ChainedHtmlOption<O> = ConfigChainMergeContext<O, {
     entryName: string;
 }>;
+export type AppIconItem = {
+    src: string;
+    size: number;
+};
 export interface HtmlConfig {
     /**
      * Configure the `<meta>` tag of the HTML.
@@ -63,8 +67,20 @@ export interface HtmlConfig {
     favicon?: ChainedHtmlOption<string>;
     /**
      * Set the file path of the app icon, which can be a relative path or an absolute path.
+     *
+     * @example
+     * appIcon: {
+     *   name: 'My Website',
+     *   icons: [
+     *     { src: './icon-192.png', size: 192 },
+     *     { src: './icon-512.png', size: 512 },
+     *   ]
+     * }
      */
-    appIcon?: string;
+    appIcon?: {
+        name?: string;
+        icons: AppIconItem[];
+    };
     /**
      * Set the id of root element.
      */

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

@@ -223,8 +223,9 @@ export interface OutputConfig {
     legalComments?: LegalComments;
     /**
      * Whether to clean all files in the dist path before starting compilation.
+     * @default 'auto'
      */
-    cleanDistPath?: boolean;
+    cleanDistPath?: boolean | 'auto';
     /**
      * Allow to custom CSS Modules options.
      */

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

@@ -61,17 +61,20 @@ export type CreateRsbuildOptions = {
     environment?: string[];
 };
 export type ResolvedCreateRsbuildOptions = CreateRsbuildOptions & Required<Omit<CreateRsbuildOptions, 'environment'>>;
+export type CreateDevServer = (options?: CreateDevServerOptions) => Promise<RsbuildDevServer>;
+export type StartDevServer = (options?: StartDevServerOptions) => Promise<StartServerResult>;
+export type Build = (options?: BuildOptions) => Promise<void | {
+    close: () => Promise<void>;
+}>;
 export type ProviderInstance<B extends 'rspack' | 'webpack' = 'rspack'> = {
     readonly bundler: Bundler;
     createCompiler: CreateCompiler;
     /**
-     * It is designed for high-level frameworks that require a custom server
+     * It is designed for upper-level frameworks that require a custom server
      */
-    createDevServer: (options?: CreateDevServerOptions) => Promise<RsbuildDevServer>;
-    startDevServer: (options?: StartDevServerOptions) => Promise<StartServerResult>;
-    build: (options?: BuildOptions) => Promise<void | {
-        close: () => Promise<void>;
-    }>;
+    createDevServer: CreateDevServer;
+    startDevServer: StartDevServer;
+    build: Build;
     initConfigs: () => Promise<B extends 'rspack' ? Rspack.Configuration[] : WebpackConfig[]>;
     inspectConfig: (options?: InspectConfigOptions) => Promise<InspectConfigResult<B>>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.0.1-beta.13",
+  "version": "1.0.1-beta.14",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.dev",
   "bugs": {
@@ -46,7 +46,7 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "1.0.0-beta.4",
+    "@rspack/core": "1.0.0-beta.5",
     "@rspack/lite-tapable": "1.0.0",
     "@swc/helpers": "0.5.11",
     "caniuse-lite": "^1.0.30001651",