@rsbuild/core 1.3.9 → 1.3.10

package/dist/index.js

@@ -97,7 +97,7 @@ var EsmMode, __webpack_modules__ = {
             }, {});
         }, module.exports = deepmerge;
     },
-    "../../node_modules/.pnpm/dotenv-expand@12.0.1/node_modules/dotenv-expand/lib/main.js": function(module) {
+    "../../node_modules/.pnpm/dotenv-expand@12.0.2/node_modules/dotenv-expand/lib/main.js": function(module) {
         function _resolveEscapeSequences(value) {
             return value.replace(/\\\$/g, '$');
         }
@@ -942,7 +942,7 @@ __webpack_require__.r(provider_helpers_namespaceObject), __webpack_require__.d(p
     setHTMLPlugin: ()=>setHTMLPlugin,
     stringifyConfig: ()=>stringifyConfig
 });
-var main = __webpack_require__("../../node_modules/.pnpm/dotenv@16.5.0/node_modules/dotenv/lib/main.js"), lib_main = __webpack_require__("../../node_modules/.pnpm/dotenv-expand@12.0.1/node_modules/dotenv-expand/lib/main.js"), cjs = __webpack_require__("../../node_modules/.pnpm/deepmerge@4.3.1/node_modules/deepmerge/dist/cjs.js"), cjs_default = __webpack_require__.n(cjs);
+var main = __webpack_require__("../../node_modules/.pnpm/dotenv@16.5.0/node_modules/dotenv/lib/main.js"), lib_main = __webpack_require__("../../node_modules/.pnpm/dotenv-expand@12.0.2/node_modules/dotenv-expand/lib/main.js"), cjs = __webpack_require__("../../node_modules/.pnpm/deepmerge@4.3.1/node_modules/deepmerge/dist/cjs.js"), cjs_default = __webpack_require__.n(cjs);
 let constants_filename = (0, __WEBPACK_EXTERNAL_MODULE_node_url_e96de089__.fileURLToPath)(import.meta.url), constants_dirname = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.dirname)(constants_filename), ROOT_DIST_DIR = 'dist', LOADER_PATH = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(constants_dirname), STATIC_PATH = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(constants_dirname, '../static'), COMPILED_PATH = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(constants_dirname, '../compiled'), RSBUILD_OUTPUTS_PATH = '.rsbuild', DEFAULT_DEV_HOST = '0.0.0.0', DEFAULT_ASSET_PREFIX = '/', DEFAULT_WEB_BROWSERSLIST = [
     'chrome >= 87',
     'edge >= 88',
@@ -1057,13 +1057,15 @@ async function emptyDir(dir, keep = [], checkExists = !0) {
         __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.debug(`failed to empty dir: ${dir}`), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.debug(err);
     }
 }
-let formatFileName = (fileName)=>/:\d+:\d+/.test(fileName) ? `File: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan(fileName)}\n` : `File: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan(fileName)}:1:1\n`, hintNodePolyfill = (message)=>{
+let formatFileName = (fileName)=>/:\d+:\d+/.test(fileName) ? `File: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan(fileName)}\n` : `File: ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan(`${fileName}:1:1`)}\n`, hintNodePolyfill = (message)=>{
     let getTips = (moduleName)=>{
         let tips = [
-            `Tip: "${moduleName}" is a built-in Node.js module. It cannot be imported in client-side code.`,
-            `Check if you need to import Node.js module. If needed, you can use "${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.cyan('@rsbuild/plugin-node-polyfill')}" to polyfill it.`
+            `Error: "${moduleName}" is a built-in Node.js module and cannot be imported in client-side code.\n`,
+            'Solution: Check if you need to import Node.js module.',
+            '  - If not needed, remove the import.',
+            `  - If needed, use "${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow('@rsbuild/plugin-node-polyfill')}" to polyfill it. (See ${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow('https://npmjs.com/package/@rsbuild/plugin-node-polyfill')})`
         ];
-        return `${message}\n\n${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.yellow(tips.join('\n'))}`;
+        return `${message}\n\n${__WEBPACK_EXTERNAL_MODULE__compiled_picocolors_index_js_ea7a20e9__.default.red(tips.join('\n'))}`;
     };
     if (message.includes('need an additional plugin to handle "node:" URIs')) return getTips('node:*');
     if (!message.includes("Can't resolve")) return message;
@@ -2115,7 +2117,7 @@ async function updateEnvironmentContext(context, configs) {
 async function createContext(options, userConfig) {
     let { cwd } = options, rootPath = userConfig.root ? getAbsolutePath(cwd, userConfig.root) : cwd, rsbuildConfig = await withDefaultConfig(rootPath, userConfig), cachePath = (0, __WEBPACK_EXTERNAL_MODULE_node_path_c5b9b54f__.join)(rootPath, 'node_modules', '.cache'), specifiedEnvironments = options.environment && options.environment.length > 0 ? options.environment : void 0;
     return {
-        version: "1.3.9",
+        version: "1.3.10",
         rootPath,
         distPath: '',
         cachePath,
@@ -3340,13 +3342,19 @@ function updateSourceMappingURL({ source, compilation, publicPath, type, config
     }
     return source;
 }
-function matchTests(name, source, tests) {
+function matchTests(name, asset, tests) {
     return tests.some((test)=>isFunction(test) ? test({
             name,
-            size: source.length
+            size: asset.size()
         }) : test.exec(name));
 }
-let pluginInlineChunk = ()=>({
+let getInlineTests = (config)=>{
+    let isProd = 'production' === config.mode, { inlineStyles, inlineScripts } = config.output, scriptTests = [], styleTests = [];
+    return inlineScripts && (!0 === inlineScripts ? isProd && scriptTests.push(JS_REGEX) : (0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(inlineScripts) || isFunction(inlineScripts) ? isProd && scriptTests.push(inlineScripts) : ('auto' === inlineScripts.enable ? isProd : inlineScripts.enable) && scriptTests.push(inlineScripts.test)), inlineStyles && (!0 === inlineStyles ? isProd && styleTests.push(CSS_REGEX) : (0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(inlineStyles) || isFunction(inlineStyles) ? isProd && styleTests.push(inlineStyles) : ('auto' === inlineStyles.enable ? isProd : inlineStyles.enable) && styleTests.push(inlineStyles.test)), {
+        scriptTests,
+        styleTests
+    };
+}, pluginInlineChunk = ()=>({
         name: 'rsbuild:inline-chunk',
         setup (api) {
             let inlinedAssets = new Set(), getInlinedScriptTag = (publicPath, tag, compilation, scriptTests, config)=>{
@@ -3354,13 +3362,11 @@ let pluginInlineChunk = ()=>({
                 let { assets } = compilation;
                 if (!((null == (_tag_attrs = tag.attrs) ? void 0 : _tag_attrs.src) && 'string' == typeof tag.attrs.src)) return tag;
                 let { src, ...otherAttrs } = tag.attrs, scriptName = publicPath ? src.replace(publicPath, '') : src, asset = assets[scriptName];
-                if (null == asset) return tag;
-                let source = asset.source().toString();
-                if (!matchTests(scriptName, source, scriptTests)) return tag;
+                if (null == asset || !matchTests(scriptName, asset, scriptTests)) return tag;
                 let ret = {
                     tag: "script",
                     children: updateSourceMappingURL({
-                        source,
+                        source: asset.source().toString(),
                         compilation,
                         publicPath,
                         type: 'js',
@@ -3376,13 +3382,11 @@ let pluginInlineChunk = ()=>({
                 let { assets } = compilation;
                 if (!((null == (_tag_attrs = tag.attrs) ? void 0 : _tag_attrs.href) && 'string' == typeof tag.attrs.href)) return tag;
                 let linkName = publicPath ? tag.attrs.href.replace(publicPath, '') : tag.attrs.href, asset = assets[linkName];
-                if (null == asset) return tag;
-                let source = asset.source().toString();
-                if (!matchTests(linkName, source, styleTests)) return tag;
+                if (null == asset || !matchTests(linkName, asset, styleTests)) return tag;
                 let ret = {
                     tag: 'style',
                     children: updateSourceMappingURL({
-                        source,
+                        source: asset.source().toString(),
                         compilation,
                         publicPath,
                         type: 'css',
@@ -3404,8 +3408,8 @@ let pluginInlineChunk = ()=>({
                     headTags,
                     bodyTags
                 };
-                let { inlineStyles, inlineScripts } = config.output, scriptTests = [], styleTests = [], isProdMode = 'production' === environment.config.mode;
-                if (inlineScripts && (!0 === inlineScripts ? isProdMode && scriptTests.push(JS_REGEX) : (0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(inlineScripts) || isFunction(inlineScripts) ? isProdMode && scriptTests.push(inlineScripts) : ('auto' === inlineScripts.enable ? isProdMode : inlineScripts.enable) && scriptTests.push(inlineScripts.test)), inlineStyles && (!0 === inlineStyles ? isProdMode && styleTests.push(CSS_REGEX) : (0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(inlineStyles) || isFunction(inlineStyles) ? isProdMode && styleTests.push(inlineStyles) : ('auto' === inlineStyles.enable ? isProdMode : inlineStyles.enable) && styleTests.push(inlineStyles.test)), !scriptTests.length && !styleTests.length) return {
+                let { scriptTests, styleTests } = getInlineTests(config);
+                if (!scriptTests.length && !styleTests.length) return {
                     headTags,
                     bodyTags
                 };
@@ -3417,9 +3421,6 @@ let pluginInlineChunk = ()=>({
             });
         }
     });
-function isAsync(chunk) {
-    return 'canBeInitial' in chunk ? !chunk.canBeInitial() : 'isInitial' in chunk && !chunk.isInitial();
-}
 function recursiveChunkEntryNames(chunk) {
     let [...chunkGroups] = chunk.groupsIterable;
     return [
@@ -3996,7 +3997,10 @@ let getJsAsyncPath = (jsPath, isServer, jsAsync)=>void 0 !== jsAsync ? jsAsync :
             });
         }
     });
-function HtmlPreloadOrPrefetchPlugin_define_property(obj, key, value) {
+function isAsyncChunk(chunk) {
+    return 'canBeInitial' in chunk ? !chunk.canBeInitial() : 'isInitial' in chunk && !chunk.isInitial();
+}
+function HtmlResourceHintsPlugin_define_property(obj, key, value) {
     return key in obj ? Object.defineProperty(obj, key, {
         value: value,
         enumerable: !0,
@@ -4004,20 +4008,35 @@ function HtmlPreloadOrPrefetchPlugin_define_property(obj, key, value) {
         writable: !0
     }) : obj[key] = value, obj;
 }
-let HtmlPreloadOrPrefetchPlugin_defaultOptions = {
+let HtmlResourceHintsPlugin_defaultOptions = {
     type: 'async-chunks',
-    dedupe: !0
+    dedupe: !0,
+    exclude: /.map$/
+}, applyFilter = (files, include, exclude)=>{
+    let includeRegExp = [], excludeRegExp = [], includeFn = [], excludeFn = [];
+    if (include) for (let item of castArray(include))'string' == typeof item ? includeRegExp.push(new RegExp(item)) : isFunction(item) ? includeFn.push(item) : includeRegExp.push(item);
+    if (exclude) for (let item of castArray(exclude))'string' == typeof item ? excludeRegExp.push(new RegExp(item)) : isFunction(item) ? excludeFn.push(item) : excludeRegExp.push(item);
+    return files.filter((file)=>{
+        let includeMatched = !1;
+        for (let item of includeRegExp)item.test(file) && (includeMatched = !0);
+        for (let item of includeFn)item(file) && (includeMatched = !0);
+        if (includeRegExp.length + includeFn.length > 0 && !includeMatched) return !1;
+        for (let item of excludeRegExp)if (item.test(file)) return !1;
+        for (let item of excludeFn)if (item(file)) return !1;
+        return !0;
+    });
 };
-class HtmlPreloadOrPrefetchPlugin {
+class HtmlResourceHintsPlugin {
     apply(compiler) {
         compiler.hooks.compilation.tap(this.name, (compilation)=>{
-            getHTMLPlugin().getHooks(compilation).beforeAssetTagGeneration.tap(`HTML${upperFirst(this.type)}Plugin`, (htmlPluginData)=>(this.resourceHints = function(options, type, compilation, htmlPluginData, HTMLCount) {
-                    let extractedChunks = function({ compilation, includeType }) {
+            let pluginHooks = getHTMLPlugin().getCompilationHooks(compilation), pluginName = `HTML${upperFirst(this.type)}Plugin`;
+            pluginHooks.beforeAssetTagGeneration.tap(pluginName, (data)=>(this.resourceHints = function(options, type, compilation, data, HTMLCount) {
+                    let extractedChunks = function(compilation, includeType) {
                         let chunks = [
                             ...compilation.chunks
                         ];
-                        if (void 0 === includeType || 'async-chunks' === includeType) return chunks.filter(isAsync);
-                        if ('initial' === includeType) return chunks.filter((chunk)=>!isAsync(chunk));
+                        if (void 0 === includeType || 'async-chunks' === includeType) return chunks.filter(isAsyncChunk);
+                        if ('initial' === includeType) return chunks.filter((chunk)=>!isAsyncChunk(chunk));
                         if ('all-chunks' === includeType) return chunks;
                         if ('all-assets' === includeType) {
                             var _compilation_assetsInfo;
@@ -4034,10 +4053,7 @@ class HtmlPreloadOrPrefetchPlugin {
                             ];
                         }
                         return chunks;
-                    }({
-                        compilation,
-                        includeType: options.type
-                    }), sortedFilteredFiles = [
+                    }(compilation, options.type), sortedFilteredFiles = applyFilter([
                         ...new Set(('all-assets' === options.type || 1 === HTMLCount ? extractedChunks : extractedChunks.filter((chunk)=>(function({ chunk, htmlPluginData }) {
                                 let { options } = htmlPluginData.plugin;
                                 return recursiveChunkEntryNames(chunk).some((chunkName)=>{
@@ -4047,15 +4063,13 @@ class HtmlPreloadOrPrefetchPlugin {
                             })({
                                 chunk: chunk,
                                 compilation,
-                                htmlPluginData,
+                                htmlPluginData: data,
                                 pluginOptions: options
                             }))).reduce((accumulated, chunk)=>accumulated.concat([
                                 ...chunk.files,
                                 ...chunk.auxiliaryFiles || []
                             ]), []))
-                    ].filter((file)=>[
-                            /.map$/
-                        ].every((regex)=>!regex.test(file))).filter((file)=>!options.include || ('function' == typeof options.include ? options.include(file) : options.include.some((regex)=>new RegExp(regex).test(file)))).filter((file)=>!options.exclude || ('function' == typeof options.exclude ? !options.exclude(file) : options.exclude.every((regex)=>!new RegExp(regex).test(file)))).sort(), links = [], { publicPath, crossOriginLoading } = compilation.outputOptions;
+                    ], options.include, options.exclude).sort(), links = [], { publicPath, crossOriginLoading } = compilation.outputOptions;
                     for (let file of sortedFilteredFiles){
                         let href = ensureAssetPrefix(file, publicPath), attributes = {
                             href,
@@ -4079,19 +4093,19 @@ class HtmlPreloadOrPrefetchPlugin {
                         });
                     }
                     return links;
-                }(this.options, this.type, compilation, htmlPluginData, this.HTMLCount), htmlPluginData)), getHTMLPlugin().getHooks(compilation).alterAssetTags.tap(`HTML${upperFirst(this.type)}Plugin`, (htmlPluginData)=>{
+                }(this.options, this.type, compilation, data, this.HTMLCount), data)), pluginHooks.alterAssetTags.tap(pluginName, (data)=>{
                 var resourceHints, scripts;
-                return this.resourceHints && (htmlPluginData.assetTags.styles = [
-                    ...this.options.dedupe ? (resourceHints = this.resourceHints, scripts = htmlPluginData.assetTags.scripts, resourceHints.filter((resourceHint)=>!scripts.find((script)=>script.attributes.src === resourceHint.attributes.href))) : this.resourceHints,
-                    ...htmlPluginData.assetTags.styles
-                ]), htmlPluginData;
+                return this.resourceHints && (data.assetTags.styles = [
+                    ...this.options.dedupe ? (resourceHints = this.resourceHints, scripts = data.assetTags.scripts, resourceHints.filter((resourceHint)=>!scripts.find((script)=>script.attributes.src === resourceHint.attributes.href))) : this.resourceHints,
+                    ...data.assetTags.styles
+                ]), data;
             });
         });
     }
     constructor(options, type, HTMLCount){
-        HtmlPreloadOrPrefetchPlugin_define_property(this, "options", void 0), HtmlPreloadOrPrefetchPlugin_define_property(this, "name", 'HtmlPreloadOrPrefetchPlugin'), HtmlPreloadOrPrefetchPlugin_define_property(this, "resourceHints", []), HtmlPreloadOrPrefetchPlugin_define_property(this, "type", void 0), HtmlPreloadOrPrefetchPlugin_define_property(this, "HTMLCount", void 0), this.options = {
-            ...HtmlPreloadOrPrefetchPlugin_defaultOptions,
-            ...'boolean' == typeof options ? {} : options
+        HtmlResourceHintsPlugin_define_property(this, "options", void 0), HtmlResourceHintsPlugin_define_property(this, "name", 'HtmlResourceHintsPlugin'), HtmlResourceHintsPlugin_define_property(this, "resourceHints", []), HtmlResourceHintsPlugin_define_property(this, "type", void 0), HtmlResourceHintsPlugin_define_property(this, "HTMLCount", void 0), this.options = {
+            ...HtmlResourceHintsPlugin_defaultOptions,
+            ...options
         }, this.type = type, this.HTMLCount = HTMLCount;
     }
 }
@@ -4101,7 +4115,13 @@ let resourceHints_generateLinks = (options, rel)=>options.map((option)=>({
                 rel,
                 ...option
             }
-        })), pluginResourceHints = ()=>({
+        })), getInlineExcludes = (config)=>{
+    let { scriptTests, styleTests } = getInlineTests(config);
+    return [
+        ...scriptTests,
+        ...styleTests
+    ].filter((item)=>(0, __WEBPACK_EXTERNAL_MODULE_node_util_types_ce11fc49__.isRegExp)(item));
+}, pluginResourceHints = ()=>({
         name: 'rsbuild:resource-hints',
         setup (api) {
             api.modifyHTMLTags(({ headTags, bodyTags }, { environment })=>{
@@ -4125,16 +4145,29 @@ let resourceHints_generateLinks = (options, rel)=>options.map((option)=>({
             }), api.modifyBundlerChain(async (chain, { CHAIN_ID, environment })=>{
                 let { config, htmlPaths } = environment;
                 if (0 === Object.keys(htmlPaths).length) return;
-                let { performance: { preload, prefetch } } = config, HTMLCount = chain.entryPoints.values().length;
-                prefetch && chain.plugin(CHAIN_ID.PLUGIN.HTML_PREFETCH).use(HtmlPreloadOrPrefetchPlugin, [
-                    prefetch,
-                    'prefetch',
-                    HTMLCount
-                ]), preload && chain.plugin(CHAIN_ID.PLUGIN.HTML_PRELOAD).use(HtmlPreloadOrPrefetchPlugin, [
-                    preload,
-                    'preload',
-                    HTMLCount
-                ]);
+                let { performance: { preload, prefetch } } = config, HTMLCount = chain.entryPoints.values().length, excludes = getInlineExcludes(config);
+                if (prefetch) {
+                    let options = !0 === prefetch ? {} : prefetch;
+                    excludes.length && (options.exclude = options.exclude ? [
+                        ...castArray(options.exclude),
+                        ...excludes
+                    ] : excludes), chain.plugin(CHAIN_ID.PLUGIN.HTML_PREFETCH).use(HtmlResourceHintsPlugin, [
+                        options,
+                        'prefetch',
+                        HTMLCount
+                    ]);
+                }
+                if (preload) {
+                    let options = !0 === preload ? {} : preload;
+                    excludes.length && (options.exclude = options.exclude ? [
+                        ...castArray(options.exclude),
+                        ...excludes
+                    ] : excludes), chain.plugin(CHAIN_ID.PLUGIN.HTML_PRELOAD).use(HtmlResourceHintsPlugin, [
+                        options,
+                        'preload',
+                        HTMLCount
+                    ]);
+                }
             });
         }
     }), rsdoctor_require = (0, __WEBPACK_EXTERNAL_MODULE_node_module_ab9f2194__.createRequire)(import.meta.url), pluginRsdoctor = ()=>({
@@ -7291,11 +7324,11 @@ async function runCLI() {
     }
     process.title = 'rsbuild-node';
     let { npm_execpath } = process.env;
-    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.greet(`  Rsbuild v1.3.9\n`);
+    (!npm_execpath || npm_execpath.includes('npx-cli.js') || npm_execpath.includes('.bun')) && console.log(), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.greet(`  Rsbuild v1.3.10\n`);
     try {
         !function() {
             let cli = cac_dist('rsbuild');
-            cli.help(), cli.version("1.3.9"), applyCommonOptions(cli);
+            cli.help(), cli.version("1.3.10"), applyCommonOptions(cli);
             let devCommand = cli.command('', 'starting the dev server').alias('dev'), buildCommand = cli.command('build', 'build the app for production'), previewCommand = cli.command('preview', 'preview the production build locally'), inspectCommand = cli.command('inspect', 'inspect the Rspack and Rsbuild configs');
             applyServerOptions(devCommand), applyServerOptions(previewCommand), devCommand.action(async (options)=>{
                 try {
@@ -7346,6 +7379,6 @@ async function runCLI() {
         __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error('Failed to start Rsbuild CLI.'), __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger.error(err);
     }
 }
-let src_version = "1.3.9";
+let src_version = "1.3.10";
 var __webpack_exports__logger = __WEBPACK_EXTERNAL_MODULE__compiled_rslog_index_js_c302f6e3__.logger, __webpack_exports__rspack = __WEBPACK_EXTERNAL_MODULE__rspack_core_e0096ff7__.rspack;
 export { PLUGIN_CSS_NAME, PLUGIN_SWC_NAME, createRsbuild, defineConfig, ensureAssetPrefix, config_loadConfig as loadConfig, loadEnv, mergeRsbuildConfig, runCLI, src_version as version, __webpack_exports__logger as logger, __webpack_exports__rspack as rspack };

package/dist-types/configChain.d.ts

@@ -125,9 +125,9 @@ export declare const CHAIN_ID: {
         readonly BUNDLE_ANALYZER: "bundle-analyze";
         /** ModuleFederationPlugin */
         readonly MODULE_FEDERATION: "module-federation";
-        /** htmlPrefetchPlugin */
+        /** HtmlResourceHintsPlugin (prefetch) */
         readonly HTML_PREFETCH: "html-prefetch-plugin";
-        /** htmlPreloadPlugin */
+        /** HtmlResourceHintsPlugin (preload) */
         readonly HTML_PRELOAD: "html-preload-plugin";
         /** CssExtractRspackPlugin */
         readonly MINI_CSS_EXTRACT: "mini-css-extract";

package/dist-types/index.d.ts

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

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

@@ -1,2 +1,6 @@
-import type { RsbuildPlugin } from '../types';
+import type { InlineChunkTest, NormalizedEnvironmentConfig, RsbuildPlugin } from '../types';
+export declare const getInlineTests: (config: NormalizedEnvironmentConfig) => {
+    scriptTests: InlineChunkTest[];
+    styleTests: InlineChunkTest[];
+};
 export declare const pluginInlineChunk: () => RsbuildPlugin;

package/dist-types/rspack/{preload/HtmlPreloadOrPrefetchPlugin.d.ts → resource-hints/HtmlResourceHintsPlugin.d.ts}

@@ -16,15 +16,15 @@
  * limitations under the License.
  */
 import type { Compiler, RspackPluginInstance } from '@rspack/core';
-import type { HtmlRspackPlugin, PreloadOrPrefetchOption } from '../../types';
+import type { HtmlRspackPlugin, ResourceHintsOptions } from '../../types';
 type LinkType = 'preload' | 'prefetch';
-export declare class HtmlPreloadOrPrefetchPlugin implements RspackPluginInstance {
-    readonly options: PreloadOrPrefetchOption;
+export declare class HtmlResourceHintsPlugin implements RspackPluginInstance {
+    readonly options: ResourceHintsOptions;
     name: string;
     resourceHints: HtmlRspackPlugin.HtmlTagObject[];
     type: LinkType;
     HTMLCount: number;
-    constructor(options: true | PreloadOrPrefetchOption, type: LinkType, HTMLCount: number);
+    constructor(options: ResourceHintsOptions, type: LinkType, HTMLCount: number);
     apply(compiler: Compiler): void;
 }
 export {};

package/dist-types/rspack/{preload/helpers → resource-hints}/doesChunkBelongToHtml.d.ts

@@ -16,13 +16,13 @@
  * limitations under the License.
  */
 import type { Chunk, Compilation } from '@rspack/core';
-import type { PreloadOrPrefetchOption } from '../../../types';
-import type { BeforeAssetTagGenerationHtmlPluginData } from './type';
+import type { ResourceHintsOptions } from '../../types';
+import type { HtmlRspackPlugin } from '../../types';
 interface DoesChunkBelongToHtmlOptions {
     chunk: Chunk;
     compilation?: Compilation;
-    htmlPluginData: BeforeAssetTagGenerationHtmlPluginData;
-    pluginOptions?: PreloadOrPrefetchOption;
+    htmlPluginData: HtmlRspackPlugin.BeforeAssetTagGenerationData;
+    pluginOptions?: ResourceHintsOptions;
 }
 export declare function recursiveChunkEntryNames(chunk: Chunk): string[];
 export declare function doesChunkBelongToHtml({ chunk, htmlPluginData, }: DoesChunkBelongToHtmlOptions): boolean;

package/dist-types/rspack/{preload/helpers → resource-hints}/extractChunks.d.ts

@@ -16,13 +16,8 @@
  * limitations under the License.
  */
 import type { Chunk, Compilation } from '@rspack/core';
-import type { PreloadIncludeType } from '../../../types';
-interface ExtractChunks {
-    compilation: Compilation;
-    includeType?: PreloadIncludeType;
-}
-export declare function extractChunks({ compilation, includeType }: ExtractChunks): Chunk[] | Array<{
+import type { ResourceHintsIncludeType } from '../../types';
+export declare function extractChunks(compilation: Compilation, includeType?: ResourceHintsIncludeType): Chunk[] | Array<{
     files: string[];
     auxiliaryFiles?: string[];
 }>;
-export {};

package/dist-types/rspack/{preload/helpers/determineAsValue.d.ts → resource-hints/getResourceType.d.ts}

@@ -15,8 +15,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { As } from './type';
-export declare function determineAsValue({ href, file, }: {
+export type ResourceType = 'audio' | 'document' | 'embed' | 'fetch' | 'font' | 'image' | 'object' | 'script' | 'style' | 'track' | 'worker' | 'video';
+export declare function getResourceType({ href, file, }: {
     href: string;
     file: string;
-}): As;
+}): ResourceType;

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

@@ -435,16 +435,38 @@ export interface PreconnectOption {
 }
 export type Preconnect = Array<string | PreconnectOption>;
 export type DnsPrefetch = string[];
-export type PreloadIncludeType = 'async-chunks' | 'initial' | 'all-assets' | 'all-chunks';
-export type Filter = Array<string | RegExp> | ((filename: string) => boolean);
-export interface PreloadOrPrefetchOption {
-    type?: PreloadIncludeType;
-    include?: Filter;
-    exclude?: Filter;
+export type ResourceHintsIncludeType = 'async-chunks' | 'initial' | 'all-assets' | 'all-chunks';
+export type ResourceHintsFilterFn = (filename: string) => boolean;
+export type ResourceHintsFilter = OneOrMany<string | RegExp | ResourceHintsFilterFn>;
+export interface ResourceHintsOptions {
+    /**
+     * Specifies which types of resources will be included.
+     * - `async-chunks`: Includes all async resources on the current page, such as async JS
+     * chunks, and its associated CSS, images, fonts, and other static resources.
+     * - `initial`: Includes all non-async resources on the current page.
+     * - `all-chunks`: Includes all async and non-async resources on the current page.
+     * - `all-assets`: Includes all resources from all pages.
+     * @default 'async-chunks'
+     */
+    type?: ResourceHintsIncludeType;
+    /**
+     * A extra filter to determine which resources to include.
+     */
+    include?: ResourceHintsFilter;
+    /**
+     * A extra filter to determine which resources to exclude.
+     */
+    exclude?: ResourceHintsFilter;
+    /**
+     * Whether to dedupe script resources that already exist in the current HTML content.
+     * By default, if a resource has been added to the current HTML via a script tag, it will
+     * not be preloaded additionally.
+     * @default true
+     */
     dedupe?: boolean;
 }
-export type PreloadOption = PreloadOrPrefetchOption;
-export type PrefetchOption = Omit<PreloadOrPrefetchOption, 'dedupe'>;
+export type PreloadOptions = ResourceHintsOptions;
+export type PrefetchOptions = Omit<ResourceHintsOptions, 'dedupe'>;
 export interface PerformanceConfig {
     /**
      * Whether to remove `console.[methodName]` in production build.
@@ -485,19 +507,37 @@ export interface PerformanceConfig {
      */
     dnsPrefetch?: DnsPrefetch;
     /**
-     * Used to control resource `Preload`.
+     * Inject the `<link rel="preload">` tags for the static assets generated by Rsbuild.
+     *
+     * `performance.preload` can be set to an object to specify the options.
      *
-     * Specifies that the user agent must preemptively fetch and cache the target resource for
-     * current navigation.
+     * When `performance.preload` is set to `true`, Rsbuild will use the following default options
+     * to preload resources. This means preloading all async resources on the current page, including
+     * async JS and its associated CSS, image, font, and other resources.
+     *
+     * ```js
+     * const defaultOptions = {
+     *   type: 'async-chunks',
+     * };
+     * ```
      */
-    preload?: true | PreloadOption;
+    preload?: true | PreloadOptions;
     /**
-     * Used to control resource `Prefetch`.
+     * Inject the `<link rel="prefetch">` tags for the static assets generated by Rsbuild.
+     *
+     * `performance.prefetch` can be set to an object to specify the options.
      *
-     * Specifies that the user agent should preemptively fetch and cache the target resource as it
-     * is likely to be required for a followup navigation.
+     * When `performance.prefetch` is set to `true`, Rsbuild will use the following default options
+     * to prefetch resources. This means prefetching all async resources on the current page, including
+     * async JS and its associated CSS, image, font, and other resources.
+     *
+     * ```js
+     * const defaultOptions = {
+     *   type: 'async-chunks',
+     * };
+     * ```
      */
-    prefetch?: true | PrefetchOption;
+    prefetch?: true | PrefetchOptions;
     /**
      * Whether capture timing information for each module,
      * same as the [profile](https://rspack.dev/config/other-options#profile) config of Rspack.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsbuild/core",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "description": "The Rspack-based build tool.",
   "homepage": "https://rsbuild.dev",
   "bugs": {
@@ -53,7 +53,7 @@
     "jiti": "^2.4.2"
   },
   "devDependencies": {
-    "@rslib/core": "0.6.3",
+    "@rslib/core": "0.6.6",
     "@types/connect": "3.4.38",
     "@types/cors": "^2.8.17",
     "@types/node": "^22.14.1",
@@ -69,8 +69,8 @@
     "css-loader": "7.1.2",
     "deepmerge": "^4.3.1",
     "dotenv": "16.5.0",
-    "dotenv-expand": "12.0.1",
-    "html-rspack-plugin": "6.0.4",
+    "dotenv-expand": "12.0.2",
+    "html-rspack-plugin": "6.0.5",
     "http-proxy-middleware": "^2.0.7",
     "launch-editor-middleware": "^2.10.0",
     "mrmime": "^2.0.1",
@@ -88,7 +88,7 @@
     "rspack-manifest-plugin": "5.0.3",
     "sirv": "^3.0.1",
     "style-loader": "3.3.4",
-    "tinyglobby": "^0.2.12",
+    "tinyglobby": "^0.2.13",
     "typescript": "^5.8.3",
     "webpack": "^5.98.0",
     "webpack-bundle-analyzer": "^4.10.2",

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

@@ -1,4 +0,0 @@
-export * from './extractChunks';
-export * from './determineAsValue';
-export * from './doesChunkBelongToHtml';
-export * from './type';

package/dist-types/rspack/preload/helpers/type.d.ts

@@ -1,13 +0,0 @@
-import type { HtmlRspackPlugin } from '../../../types';
-export type BeforeAssetTagGenerationHtmlPluginData = {
-    assets: {
-        publicPath: string;
-        js: Array<string>;
-        css: Array<string>;
-        favicon?: string;
-        manifest?: string;
-    };
-    outputName: string;
-    plugin: HtmlRspackPlugin;
-};
-export type As = 'audio' | 'document' | 'embed' | 'fetch' | 'font' | 'image' | 'object' | 'script' | 'style' | 'track' | 'worker' | 'video';