feat(builder): support inline assets by file size

.changeset/rare-wolves-tease.md

@@ -0,0 +1,10 @@
+---
+'@modern-js/builder-shared': patch
+'@modern-js/builder': patch
+'@modern-js/utils': patch
+'@modern-js/core': patch
+---
+
+feat(builder): support inline assets by file size
+
+feat(builder): 支持基于文件体积来内联资源

packages/builder/builder-rspack-provider/tests/plugins/__snapshots__/default.test.ts.snap

@@ -1493,9 +1493,10 @@ exports[`applyDefaultPlugins > should apply default plugins correctly when prod
       "htmlPlugin": [Function],
       "inlinedAssets": Set {},
       "name": "InlineChunkHtmlPlugin",
-      "tests": [
+      "scriptTests": [
         /builder-runtime\\(\\[\\.\\]\\.\\+\\)\\?\\\\\\.js\\$/,
       ],
+      "styleTests": [],
     },
   ],
   "resolve": {

packages/builder/builder-shared/src/mergeBuilderConfig.ts

@@ -1,4 +1,5 @@
 import _ from '@modern-js/utils/lodash';
+import { isOverriddenConfigKey } from '@modern-js/utils';
 
 export const mergeBuilderConfig = <T>(...configs: T[]): T =>
   _.mergeWith(
@@ -11,8 +12,8 @@ export const mergeBuilderConfig = <T>(...configs: T[]): T =>
         return undefined;
       }
 
-      // always use source override target, if target defined.
-      if (['removeConsole'].includes(key)) {
+      // Some keys should use source to override target
+      if (isOverriddenConfigKey(key)) {
         return source ?? target;
       }
 

packages/builder/builder-shared/src/plugins/InlineChunkHtmlPlugin.ts

@@ -6,15 +6,22 @@
  * modified from https://github.com/facebook/create-react-app/blob/master/packages/react-dev-utils/InlineChunkHtmlPlugin.js
  */
 import { join } from 'path';
-import { isString } from '@modern-js/utils';
+import { isFunction, isString } from '@modern-js/utils';
 import { addTrailingSlash } from '../utils';
 import type { Compiler, Compilation } from 'webpack';
 import type HtmlWebpackPlugin from 'html-webpack-plugin';
 import type { HtmlTagObject } from 'html-webpack-plugin';
 import { COMPILATION_PROCESS_STAGE, getPublicPathFromCompiler } from './util';
 
+export type InlineChunkTestFunction = (params: {
+  size: number;
+  name: string;
+}) => boolean;
+export type InlineChunkTest = RegExp | InlineChunkTestFunction;
+
 export type InlineChunkHtmlPluginOptions = {
-  tests: RegExp[];
+  styleTests: InlineChunkTest[];
+  scriptTests: InlineChunkTest[];
   distPath: {
     js?: string;
     css?: string;
@@ -24,7 +31,9 @@ export type InlineChunkHtmlPluginOptions = {
 export class InlineChunkHtmlPlugin {
   name: string;
 
-  tests: RegExp[];
+  styleTests: InlineChunkTest[];
+
+  scriptTests: InlineChunkTest[];
 
   distPath: InlineChunkHtmlPluginOptions['distPath'];
 
@@ -34,10 +43,11 @@ export class InlineChunkHtmlPlugin {
 
   constructor(
     htmlPlugin: typeof HtmlWebpackPlugin,
-    { tests, distPath }: InlineChunkHtmlPluginOptions,
+    { styleTests, scriptTests, distPath }: InlineChunkHtmlPluginOptions,
   ) {
     this.name = 'InlineChunkHtmlPlugin';
-    this.tests = tests;
+    this.styleTests = styleTests;
+    this.scriptTests = scriptTests;
     this.distPath = distPath;
     this.inlinedAssets = new Set();
     this.htmlPlugin = htmlPlugin;
@@ -80,28 +90,42 @@ export class InlineChunkHtmlPlugin {
     return source;
   }
 
+  matchTests(name: string, source: string, tests: InlineChunkTest[]) {
+    return tests.some(test => {
+      if (isFunction(test)) {
+        const size = source.length;
+        return test({ name, size });
+      }
+      return test.exec(name);
+    });
+  }
+
   getInlinedScriptTag(
     publicPath: string,
     tag: HtmlTagObject,
     compilation: Compilation,
   ) {
     const { assets } = compilation;
 
+    // No need to inline scripts with src attribute
     if (!(tag?.attributes.src && isString(tag.attributes.src))) {
       return tag;
     }
+
     const { src, ...otherAttrs } = tag.attributes;
     const scriptName = publicPath ? src.replace(publicPath, '') : src;
 
-    if (!this.tests.some(test => test.exec(scriptName))) {
-      return tag;
-    }
+    // If asset is not found, skip it
     const asset = assets[scriptName];
     if (asset == null) {
       return tag;
     }
 
     const source = asset.source().toString();
+    const shouldInline = this.matchTests(scriptName, source, this.scriptTests);
+    if (!shouldInline) {
+      return tag;
+    }
 
     const ret = {
       tagName: 'script',
@@ -130,6 +154,7 @@ export class InlineChunkHtmlPlugin {
   ) {
     const { assets } = compilation;
 
+    // No need to inline styles with href attribute
     if (!(tag.attributes.href && isString(tag.attributes.href))) {
       return tag;
     }
@@ -138,13 +163,18 @@ export class InlineChunkHtmlPlugin {
       ? tag.attributes.href.replace(publicPath, '')
       : tag.attributes.href;
 
-    if (!this.tests.some(test => test.exec(linkName))) {
+    // If asset is not found, skip it
+    const asset = assets[linkName];
+    if (asset == null) {
       return tag;
     }
 
-    const asset = assets[linkName];
-
     const source = asset.source().toString();
+    const shouldInline = this.matchTests(linkName, source, this.styleTests);
+    if (!shouldInline) {
+      return tag;
+    }
+
     const ret = {
       tagName: 'style',
       innerHTML: this.updateSourceMappingURL({

packages/builder/builder-shared/src/plugins/index.ts

@@ -5,7 +5,10 @@ export { HtmlCrossOriginPlugin } from './HtmlCrossOriginPlugin';
 export { HtmlNoncePlugin } from './HtmlNoncePlugin';
 export { HtmlAppIconPlugin } from './HtmlAppIconPlugin';
 export { HtmlFaviconUrlPlugin, type FaviconUrls } from './HtmlFaviconUrlPlugin';
-export { InlineChunkHtmlPlugin } from './InlineChunkHtmlPlugin';
+export {
+  InlineChunkHtmlPlugin,
+  type InlineChunkTest,
+} from './InlineChunkHtmlPlugin';
 export { AssetsRetryPlugin } from './AssetsRetryPlugin';
 export { CheckSyntaxPlugin } from './CheckSyntaxPlugin';
 export { HtmlNetworkPerformancePlugin } from './HtmlNetworkPerformancePlugin';

packages/builder/builder-shared/src/schema/output.ts

@@ -77,6 +77,12 @@ export const SvgDefaultExportSchema: ZodType<SvgDefaultExport> = z.enum([
   'url',
 ]);
 
+const inlineSchema = z.union([
+  z.boolean(),
+  z.instanceof(RegExp),
+  z.anyFunction(),
+]);
+
 export const sharedOutputConfigSchema = z.partialObj({
   distPath: DistPathConfigSchema,
   filename: FilenameConfigSchema,
@@ -100,8 +106,8 @@ export const sharedOutputConfigSchema = z.partialObj({
   enableAssetFallback: z.boolean(),
   enableLatestDecorators: z.boolean(),
   enableCssModuleTSDeclaration: z.boolean(),
-  enableInlineScripts: z.union([z.boolean(), z.instanceof(RegExp)]),
-  enableInlineStyles: z.union([z.boolean(), z.instanceof(RegExp)]),
+  enableInlineScripts: inlineSchema,
+  enableInlineStyles: inlineSchema,
   externals: z.any(),
   overrideBrowserslist: z.union([
     z.array(z.string()),

packages/builder/builder-shared/src/types/config/output.ts

@@ -1,3 +1,4 @@
+import type { InlineChunkTest } from '../../plugins/InlineChunkHtmlPlugin';
 import type { BuilderTarget } from '../builder';
 import type { CrossOrigin } from './html';
 import type { Externals } from 'webpack';
@@ -261,11 +262,11 @@ export interface SharedOutputConfig {
   /**
    * Whether to inline output scripts files (.js files) into HTML with `<script>` tags.
    */
-  enableInlineScripts?: boolean | RegExp;
+  enableInlineScripts?: boolean | InlineChunkTest;
   /**
    * Whether to inline output style files (.css files) into html with `<style>` tags.
    */
-  enableInlineStyles?: boolean | RegExp;
+  enableInlineStyles?: boolean | InlineChunkTest;
   /**
    * Specifies the range of target browsers that the project is compatible with.
    * This value will be used by [@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env) and
@@ -300,8 +301,8 @@ export interface NormalizedSharedOutputConfig extends SharedOutputConfig {
   enableAssetFallback: boolean;
   enableLatestDecorators: boolean;
   enableCssModuleTSDeclaration: boolean;
-  enableInlineScripts: boolean | RegExp;
-  enableInlineStyles: boolean | RegExp;
+  enableInlineScripts: boolean | InlineChunkTest;
+  enableInlineStyles: boolean | InlineChunkTest;
   svgDefaultExport: SvgDefaultExport;
   cssModules: {
     exportLocalsConvention: CssModuleLocalsConvention;

packages/builder/builder-webpack-provider/tests/plugins/__snapshots__/default.test.ts.snap

@@ -1833,9 +1833,10 @@ exports[`applyDefaultPlugins > should apply default plugins correctly when produ
       "htmlPlugin": [Function],
       "inlinedAssets": Set {},
       "name": "InlineChunkHtmlPlugin",
-      "tests": [
+      "scriptTests": [
         /builder-runtime\\(\\[\\.\\]\\.\\+\\)\\?\\\\\\.js\\$/,
       ],
+      "styleTests": [],
     },
     MiniCssExtractPlugin {
       "_sortedModulesCache": WeakMap {},

packages/builder/builder-webpack-provider/tests/plugins/__snapshots__/inlineChunk.test.ts.snap

@@ -49,9 +49,10 @@ exports[`plugins/inlineChunk > should add InlineChunkHtmlPlugin properly by defa
       "htmlPlugin": [Function],
       "inlinedAssets": Set {},
       "name": "InlineChunkHtmlPlugin",
-      "tests": [
+      "scriptTests": [
         /builder-runtime\\(\\[\\.\\]\\.\\+\\)\\?\\\\\\.js\\$/,
       ],
+      "styleTests": [],
     },
   ],
 }
@@ -106,7 +107,8 @@ exports[`plugins/inlineChunk > should use proper plugin options when disableInli
       "htmlPlugin": [Function],
       "inlinedAssets": Set {},
       "name": "InlineChunkHtmlPlugin",
-      "tests": [],
+      "scriptTests": [],
+      "styleTests": [],
     },
   ],
 }
@@ -161,10 +163,11 @@ exports[`plugins/inlineChunk > should use proper plugin options when enableInlin
       "htmlPlugin": [Function],
       "inlinedAssets": Set {},
       "name": "InlineChunkHtmlPlugin",
-      "tests": [
-        /\\\\\\.js\\$/,
+      "scriptTests": [
+        /\\\\\\.\\(js\\|mjs\\|cjs\\|jsx\\)\\$/,
         /builder-runtime\\(\\[\\.\\]\\.\\+\\)\\?\\\\\\.js\\$/,
       ],
+      "styleTests": [],
     },
   ],
 }
@@ -219,10 +222,12 @@ exports[`plugins/inlineChunk > should use proper plugin options when enableInlin
       "htmlPlugin": [Function],
       "inlinedAssets": Set {},
       "name": "InlineChunkHtmlPlugin",
-      "tests": [
-        /\\\\\\.css\\$/,
+      "scriptTests": [
         /builder-runtime\\(\\[\\.\\]\\.\\+\\)\\?\\\\\\.js\\$/,
       ],
+      "styleTests": [
+        /\\\\\\.css\\$/,
+      ],
     },
   ],
 }

packages/builder/builder/src/plugins/inlineChunk.ts

@@ -1,8 +1,11 @@
 import {
   pick,
+  JS_REGEX,
+  CSS_REGEX,
   RUNTIME_CHUNK_NAME,
   isHtmlDisabled,
   DefaultBuilderPlugin,
+  type InlineChunkTest,
 } from '@modern-js/builder-shared';
 
 export const builderPluginInlineChunk = (): DefaultBuilderPlugin => ({
@@ -28,22 +31,23 @@ export const builderPluginInlineChunk = (): DefaultBuilderPlugin => ({
           enableInlineScripts,
         } = config.output;
 
-        const tests: RegExp[] = [];
+        const scriptTests: InlineChunkTest[] = [];
+        const styleTests: InlineChunkTest[] = [];
 
         if (enableInlineScripts) {
-          tests.push(
-            enableInlineScripts === true ? /\.js$/ : enableInlineScripts,
+          scriptTests.push(
+            enableInlineScripts === true ? JS_REGEX : enableInlineScripts,
           );
         }
 
         if (enableInlineStyles) {
-          tests.push(
-            enableInlineStyles === true ? /\.css$/ : enableInlineStyles,
+          styleTests.push(
+            enableInlineStyles === true ? CSS_REGEX : enableInlineStyles,
           );
         }
 
         if (!disableInlineRuntimeChunk) {
-          tests.push(
+          scriptTests.push(
             // RegExp like /builder-runtime([.].+)?\.js$/
             // matches builder-runtime.js and builder-runtime.123456.js
             new RegExp(`${RUNTIME_CHUNK_NAME}([.].+)?\\.js$`),
@@ -53,7 +57,8 @@ export const builderPluginInlineChunk = (): DefaultBuilderPlugin => ({
         chain.plugin(CHAIN_ID.PLUGIN.INLINE_HTML).use(InlineChunkHtmlPlugin, [
           HtmlPlugin,
           {
-            tests,
+            styleTests,
+            scriptTests,
             distPath: pick(config.output.distPath, ['js', 'css']),
           },
         ]);

packages/cli/core/src/utils/mergeConfig.ts

@@ -1,19 +1,24 @@
-import { ensureArray } from '@modern-js/utils';
+import { ensureArray, isOverriddenConfigKey } from '@modern-js/utils';
 import { mergeWith, isFunction } from '@modern-js/utils/lodash';
 import { UserConfig, NormalizedConfig } from '../types';
 
 export const mergeConfig = <ExtendConfig extends Record<string, any>>(
   configs: Array<UserConfig<ExtendConfig> | NormalizedConfig<ExtendConfig>>,
 ): NormalizedConfig<ExtendConfig> =>
   mergeWith({}, ...configs, (target: any, source: any, key: string) => {
-    // Do not use the following merge logic for source.designSystem and tools.tailwind(css)
+    // Do not use the following merge logic for some keys
     if (
       key === 'designSystem' ||
       (key === 'tailwindcss' && typeof source === 'object')
     ) {
       return mergeWith({}, target ?? {}, source ?? {});
     }
 
+    // Some keys should use source to override target
+    if (isOverriddenConfigKey(key)) {
+      return source ?? target;
+    }
+
     if (Array.isArray(target) || Array.isArray(source)) {
       if (target === undefined) {
         return source;