@rsbuild/core 1.4.5 → 1.4.6

package/compiled/css-loader/index.js

@@ -1,19 +1,19 @@
 (() => {
   var __webpack_modules__ = {
-    5860: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    5067: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
-      const loader = __nccwpck_require__(6218);
+      const loader = __nccwpck_require__(7733);
       module.exports = loader.default;
       module.exports.defaultGetLocalIdent =
-        __nccwpck_require__(6091).defaultGetLocalIdent;
+        __nccwpck_require__(8320).defaultGetLocalIdent;
     },
-    6218: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    7733: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = loader;
       var _postcss = _interopRequireDefault(__nccwpck_require__(9409));
-      var _plugins = __nccwpck_require__(9609);
-      var _utils = __nccwpck_require__(6091);
+      var _plugins = __nccwpck_require__(6154);
+      var _utils = __nccwpck_require__(8320);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -236,7 +236,7 @@
         callback(null, `${importCode}${moduleCode}${exportCode}`);
       }
     },
-    9609: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    6154: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       Object.defineProperty(exports, "icssParser", {
@@ -258,22 +258,20 @@
         },
       });
       var _postcssImportParser = _interopRequireDefault(
-        __nccwpck_require__(8034),
+        __nccwpck_require__(3353),
       );
-      var _postcssIcssParser = _interopRequireDefault(
-        __nccwpck_require__(7323),
-      );
-      var _postcssUrlParser = _interopRequireDefault(__nccwpck_require__(3294));
+      var _postcssIcssParser = _interopRequireDefault(__nccwpck_require__(400));
+      var _postcssUrlParser = _interopRequireDefault(__nccwpck_require__(343));
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
     },
-    7323: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    400: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _icssUtils = __nccwpck_require__(9028);
-      var _utils = __nccwpck_require__(6091);
+      var _utils = __nccwpck_require__(8320);
       const plugin = (options = {}) => ({
         postcssPlugin: "postcss-icss-parser",
         async OnceExit(root) {
@@ -372,14 +370,14 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    8034: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    3353: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _postcssValueParser = _interopRequireDefault(
         __nccwpck_require__(2948),
       );
-      var _utils = __nccwpck_require__(6091);
+      var _utils = __nccwpck_require__(8320);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -684,14 +682,14 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    3294: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    343: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports["default"] = void 0;
       var _postcssValueParser = _interopRequireDefault(
         __nccwpck_require__(2948),
       );
-      var _utils = __nccwpck_require__(6091);
+      var _utils = __nccwpck_require__(8320);
       function _interopRequireDefault(obj) {
         return obj && obj.__esModule ? obj : { default: obj };
       }
@@ -1034,7 +1032,7 @@
       plugin.postcss = true;
       var _default = (exports["default"] = plugin);
     },
-    6091: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    8320: (__unused_webpack_module, exports, __nccwpck_require__) => {
       "use strict";
       Object.defineProperty(exports, "__esModule", { value: true });
       exports.WEBPACK_IGNORE_COMMENT_REGEXP = void 0;
@@ -8098,6 +8096,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(5860);
+  var __webpack_exports__ = __nccwpck_require__(5067);
   module.exports = __webpack_exports__;
 })();

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

@@ -1,8 +1,8 @@
 (() => {
   var __webpack_modules__ = {
-    1: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    822: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
-      const { HtmlWebpackChildCompiler } = __nccwpck_require__(34);
+      const { HtmlWebpackChildCompiler } = __nccwpck_require__(431);
       const compilerMap = new WeakMap();
       class CachedChildCompilation {
         constructor(compiler) {
@@ -311,7 +311,7 @@
       }
       module.exports = { CachedChildCompilation };
     },
-    34: (module) => {
+    431: (module) => {
       "use strict";
       class HtmlWebpackChildCompiler {
         constructor(templates) {
@@ -480,7 +480,7 @@
       }
       module.exports = { HtmlWebpackChildCompiler };
     },
-    578: (module) => {
+    293: (module) => {
       "use strict";
       module.exports = {};
       module.exports.none = (chunks) => chunks;
@@ -499,7 +499,7 @@
       };
       module.exports.auto = module.exports.none;
     },
-    909: (module) => {
+    124: (module) => {
       "use strict";
       module.exports = function (err) {
         return {
@@ -520,7 +520,7 @@
         };
       };
     },
-    468: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    827: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const { AsyncSeriesWaterfallHook } = __nccwpck_require__(408);
       const htmlWebpackPluginHooksMap = new WeakMap();
@@ -546,7 +546,7 @@
       }
       module.exports = { getHtmlRspackPluginHooks };
     },
-    113: (module) => {
+    218: (module) => {
       const voidTags = [
         "area",
         "base",
@@ -614,19 +614,19 @@
         htmlTagObjectToString,
       };
     },
-    404: (module, __unused_webpack_exports, __nccwpck_require__) => {
+    43: (module, __unused_webpack_exports, __nccwpck_require__) => {
       "use strict";
       const promisify = __nccwpck_require__(23).promisify;
       const vm = __nccwpck_require__(154);
       const fs = __nccwpck_require__(896);
       const path = __nccwpck_require__(928);
-      const { CachedChildCompilation } = __nccwpck_require__(1);
+      const { CachedChildCompilation } = __nccwpck_require__(822);
       const { createHtmlTagObject, htmlTagObjectToString, HtmlTagArray } =
-        __nccwpck_require__(113);
-      const prettyError = __nccwpck_require__(909);
-      const chunkSorter = __nccwpck_require__(578);
+        __nccwpck_require__(218);
+      const prettyError = __nccwpck_require__(124);
+      const chunkSorter = __nccwpck_require__(293);
       const getHtmlRspackPluginHooks =
-        __nccwpck_require__(468).getHtmlRspackPluginHooks;
+        __nccwpck_require__(827).getHtmlRspackPluginHooks;
       const WITH_PLACEHOLDER = "function __with_placeholder__";
       class HtmlRspackPlugin {
         constructor(userOptions = {}) {
@@ -1597,6 +1597,6 @@
   }
   if (typeof __nccwpck_require__ !== "undefined")
     __nccwpck_require__.ab = __dirname + "/";
-  var __webpack_exports__ = __nccwpck_require__(404);
+  var __webpack_exports__ = __nccwpck_require__(43);
   module.exports = __webpack_exports__;
 })();

package/compiled/postcss-loader/index.js

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

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

@@ -1,7 +1,7 @@
 (() => {
   "use strict";
   var __webpack_modules__ = {
-    139: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    642: (__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;
     },
-    782: (__unused_webpack_module, exports, __nccwpck_require__) => {
+    531: (__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__(896);
       const path_1 = __nccwpck_require__(928);
       const lite_tapable_1 = __nccwpck_require__(408);
-      const helpers_1 = __nccwpck_require__(139);
+      const helpers_1 = __nccwpck_require__(642);
       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__(928);
-    const hooks_1 = __nccwpck_require__(782);
+    const hooks_1 = __nccwpck_require__(531);
     Object.defineProperty(exports, "getCompilerHooks", {
       enumerable: true,
       get: function () {

package/dist/index.cjs

@@ -2250,7 +2250,7 @@ ${section.body}` : section.body).join("\n\n"));
     async function createContext(options, userConfig) {
         let { cwd } = options, rootPath = userConfig.root ? ensureAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = (0, external_node_path_namespaceObject.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0, bundlerType = userConfig.provider ? 'webpack' : 'rspack';
         return {
-            version: "1.4.5",
+            version: "1.4.6",
             rootPath,
             distPath: '',
             cachePath,
@@ -3583,7 +3583,7 @@ ${section.body}` : section.body).join("\n\n"));
             if (mountPoint) return mountPoint;
             let configFilePath = '/etc/wsl.conf', isConfigFileExists = !1;
             try {
-                await promises_namespaceObject.access(configFilePath, promises_namespaceObject.constants.F_OK), isConfigFileExists = !0;
+                await promises_namespaceObject.access(configFilePath, external_node_fs_namespaceObject.constants.F_OK), isConfigFileExists = !0;
             } catch  {}
             if (!isConfigFileExists) return defaultMountPoint;
             let configContent = await promises_namespaceObject.readFile(configFilePath, {
@@ -3678,7 +3678,7 @@ ${section.body}` : section.body).join("\n\n"));
             else {
                 let isBundled = !open_dirname || '/' === open_dirname, exeLocalXdgOpen = !1;
                 try {
-                    await promises_namespaceObject.access(localXdgOpenPath, promises_namespaceObject.constants.X_OK), exeLocalXdgOpen = !0;
+                    await promises_namespaceObject.access(localXdgOpenPath, external_node_fs_namespaceObject.constants.X_OK), exeLocalXdgOpen = !0;
                 } catch  {}
                 command = external_node_process_namespaceObject.versions.electron ?? ('android' === platform || isBundled || !exeLocalXdgOpen) ? 'xdg-open' : localXdgOpenPath;
             }
@@ -7864,11 +7864,11 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             ].includes(level) && (index_js_namespaceObject.logger.level = level);
         }
         let { npm_execpath } = process.env;
-        (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && index_js_namespaceObject.logger.log(), index_js_namespaceObject.logger.greet(`  Rsbuild v1.4.5\n`);
+        (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && index_js_namespaceObject.logger.log(), index_js_namespaceObject.logger.greet(`  Rsbuild v1.4.6\n`);
         try {
             !function() {
                 let cli = ((name = "")=>new CAC(name))('rsbuild');
-                cli.help(), cli.version("1.4.5"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
+                cli.help(), cli.version("1.4.6"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
                     default: 'jiti'
                 }).option('-r, --root <root>', 'specify the project root directory, can be an absolute path or a path relative to cwd').option('-m, --mode <mode>', 'specify the build mode, can be `development`, `production` or `none`').option('--log-level <level>', 'specify the log level, can be `info`, `warn`, `error` or `silent`').option('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
                     type: [
@@ -7926,7 +7926,7 @@ throw new Error('Failed to load Node.js addon: "${name}"\\n' + error);
             index_js_namespaceObject.logger.error('Failed to start Rsbuild CLI.'), index_js_namespaceObject.logger.error(err);
         }
     }
-    let src_version = "1.4.5";
+    let src_version = "1.4.6";
 })(), exports.PLUGIN_CSS_NAME = __webpack_exports__.PLUGIN_CSS_NAME, exports.PLUGIN_SWC_NAME = __webpack_exports__.PLUGIN_SWC_NAME, exports.createRsbuild = __webpack_exports__.createRsbuild, exports.defaultAllowedOrigins = __webpack_exports__.defaultAllowedOrigins, exports.defineConfig = __webpack_exports__.defineConfig, exports.ensureAssetPrefix = __webpack_exports__.ensureAssetPrefix, exports.loadConfig = __webpack_exports__.loadConfig, exports.loadEnv = __webpack_exports__.loadEnv, exports.logger = __webpack_exports__.logger, exports.mergeRsbuildConfig = __webpack_exports__.mergeRsbuildConfig, exports.rspack = __webpack_exports__.rspack, exports.runCLI = __webpack_exports__.runCLI, exports.version = __webpack_exports__.version, __webpack_exports__)-1 === [
     "PLUGIN_CSS_NAME",
     "PLUGIN_SWC_NAME",

package/dist/index.js

@@ -5,7 +5,7 @@ import { logger } from "../compiled/rslog/index.js";
 import node_path, { dirname, isAbsolute as external_node_path_isAbsolute, join, posix, relative, sep } from "node:path";
 import { URL as external_node_url_URL, fileURLToPath, pathToFileURL } from "node:url";
 import picocolors from "../compiled/picocolors/index.js";
-import node_fs, { existsSync } from "node:fs";
+import node_fs, { constants as external_node_fs_constants, existsSync } from "node:fs";
 import { EventEmitter } from "events";
 import { createRequire } from "node:module";
 import node_os, { constants as external_node_os_constants } from "node:os";
@@ -17,7 +17,7 @@ import { lookup } from "../compiled/mrmime/index.js";
 import node_zlib from "node:zlib";
 import { Buffer as external_node_buffer_Buffer } from "node:buffer";
 import node_child_process, { execFile } from "node:child_process";
-import promises, { constants as promises_constants } from "node:fs/promises";
+import promises from "node:fs/promises";
 var EsmMode, __webpack_modules__ = {
     "../../node_modules/.pnpm/clone-deep@4.0.1/node_modules/clone-deep/index.js": function(module, __unused_webpack_exports, __webpack_require__) {
         let clone = __webpack_require__("../../node_modules/.pnpm/shallow-clone@3.0.1/node_modules/shallow-clone/index.js"), typeOf = __webpack_require__("../../node_modules/.pnpm/kind-of@6.0.3/node_modules/kind-of/index.js"), isPlainObject = __webpack_require__("../../node_modules/.pnpm/is-plain-object@2.0.4/node_modules/is-plain-object/index.js");
@@ -2065,7 +2065,7 @@ async function updateEnvironmentContext(context, configs) {
 async function createContext(options, userConfig) {
     let { cwd } = options, rootPath = userConfig.root ? ensureAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = join(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0, bundlerType = userConfig.provider ? 'webpack' : 'rspack';
     return {
-        version: "1.4.5",
+        version: "1.4.6",
         rootPath,
         distPath: '',
         cachePath,
@@ -3388,7 +3388,7 @@ let open_execFile = node_util.promisify(node_child_process.execFile), open_dirna
         if (mountPoint) return mountPoint;
         let configFilePath = '/etc/wsl.conf', isConfigFileExists = !1;
         try {
-            await promises.access(configFilePath, promises_constants.F_OK), isConfigFileExists = !0;
+            await promises.access(configFilePath, external_node_fs_constants.F_OK), isConfigFileExists = !0;
         } catch  {}
         if (!isConfigFileExists) return defaultMountPoint;
         let configContent = await promises.readFile(configFilePath, {
@@ -3483,7 +3483,7 @@ let pTryEach = async (array, mapper)=>{
         else {
             let exeLocalXdgOpen = !1;
             try {
-                await promises.access(localXdgOpenPath, promises_constants.X_OK), exeLocalXdgOpen = !0;
+                await promises.access(localXdgOpenPath, external_node_fs_constants.X_OK), exeLocalXdgOpen = !0;
             } catch  {}
             command = node_process.versions.electron ?? ('android' === platform || !open_dirname || '/' === open_dirname || !exeLocalXdgOpen) ? 'xdg-open' : localXdgOpenPath;
         }
@@ -7647,11 +7647,11 @@ async function runCLI() {
         ].includes(level) && (logger.level = level);
     }
     let { npm_execpath } = process.env;
-    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && logger.log(), logger.greet(`  Rsbuild v1.4.5\n`);
+    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && logger.log(), logger.greet(`  Rsbuild v1.4.6\n`);
     try {
         !function() {
             let cli = ((name = "")=>new CAC(name))('rsbuild');
-            cli.help(), cli.version("1.4.5"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
+            cli.help(), cli.version("1.4.6"), cli.option('--base <base>', 'specify the base path of the server').option('-c, --config <config>', 'specify the configuration file, can be a relative or absolute path').option('--config-loader <loader>', 'specify the loader to load the config file, can be `jiti` or `native`', {
                 default: 'jiti'
             }).option('-r, --root <root>', 'specify the project root directory, can be an absolute path or a path relative to cwd').option('-m, --mode <mode>', 'specify the build mode, can be `development`, `production` or `none`').option('--log-level <level>', 'specify the log level, can be `info`, `warn`, `error` or `silent`').option('--env-mode <mode>', 'specify the env mode to load the `.env.[mode]` file').option('--environment <name>', 'specify the name of environment to build', {
                 type: [
@@ -7709,5 +7709,5 @@ async function runCLI() {
         logger.error('Failed to start Rsbuild CLI.'), logger.error(err);
     }
 }
-let src_version = "1.4.5";
+let src_version = "1.4.6";
 export { PLUGIN_CSS_NAME, PLUGIN_SWC_NAME, createRsbuild, defaultAllowedOrigins, defineConfig, ensureAssetPrefix, loadConfig_loadConfig as loadConfig, loadEnv, logger, mergeRsbuildConfig, rspack, runCLI, src_version as version };

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

@@ -1110,25 +1110,76 @@ export type MetaOptions = {
     [name: string]: string | false | MetaAttrs;
 };
 export type HtmlBasicTag = {
+    /**
+     * The HTML tag name to be generated. Should be a valid HTML element name.
+     * @example
+     * - `'script'` for JavaScript files
+     * - `'link'` for stylesheets or external resources
+     * - `'meta'` for metadata
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element
+     */
     tag: string;
+    /**
+     * HTML attributes to be applied to the tag.
+     * - `string` values will be rendered as `attribute="value"`
+     * - `true` renders as boolean attribute (e.g., `<input disabled>`)
+     * - `false` or `null` or `undefined` values will omit the attribute
+     *
+     * @example
+     * // String attributes
+     * attrs: {
+     *   src: 'https://example.com/script.js',
+     *   type: 'text/javascript',
+     * }
+     * // Result: <script src="https://example.com/script.js" type="text/javascript">
+  
+     * // Boolean attributes
+     * attrs: {
+     *   async: true,      // <script async>
+     *   defer: false,     // attribute omitted
+     * }
+     * // Result: <script async>
+     */
     attrs?: Record<string, string | boolean | null | undefined>;
+    /**
+     * The innerHTML content of the tag. The content is inserted as-is without
+     * HTML escaping, so ensure it's safe to prevent XSS vulnerabilities.
+     */
     children?: string;
 };
 export type HtmlTag = HtmlBasicTag & {
-    /** @default false */
+    /**
+     * Controls whether to add a hash query parameter to asset URLs for cache invalidation.
+     * Only affects the `src` attribute of the `script` tag and the `href` attribute of the `link` tag.
+     * - `false`: No hash query
+     * - `true`: Generate hash based on HTML content
+     * - `string`: Uses a custom hash string
+     * - `function`: Custom hash generation via a function
+     * @default false
+     */
     hash?: boolean | string | ((url: string, hash: string) => string);
-    /** @default true */
+    /**
+     * Controls whether to prepend the asset prefix to resource URLs.
+     * Only affects the `src` attribute of the `script` tag and the `href` attribute of the `link` tag.
+     * - `true`: Prepends asset prefix to the URL
+     * - `false`: Uses the URL as-is
+     * - `string`: Uses a custom prefix
+     * - `function`: Custom path transformation via a function
+     * @default true
+     */
     publicPath?: boolean | string | ((url: string, publicPath: string) => string);
     /**
-     * Defines the injection position of the current tag relative to existing tags
-     * - When set to `true`, the tag will be inserted after existing tags
-     * - When set to `false`, the tag will be inserted before existing tags
+     * Defines the injection position relative to existing tags.
+     * - `true`: Insert after existing tags
+     * - `false`: Insert before existing tags
      * @default true
      */
     append?: boolean;
     /**
-     * Specifies whether to add the current tag to the HTML `<head>` element
-     * @default defaults to `true` for element types allowed in the `<head>`, otherwise `false`
+     * Specifies whether to inject the tag into the HTML `<head>` element.
+     * - `true`: Inject into `<head>`
+     * - `false`: Inject into `<body>`
+     * @default Auto-detect: `true` for head-allowed elements, `false` otherwise
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/head#see_also
      */
     head?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.rs",
   "bugs": {
@@ -46,7 +46,7 @@
     "types.d.ts"
   ],
   "dependencies": {
-    "@rspack/core": "1.4.5",
+    "@rspack/core": "1.4.6",
     "@rspack/lite-tapable": "~1.0.1",
     "@swc/helpers": "^0.5.17",
     "core-js": "~3.44.0",