@bleedingdev/modern-js-builder 3.9.0-ultramodern.9 → 3.9.3-ultramodern.1

package/dist/esm/shared/parseCommonConfig.mjs

@@ -1,7 +1,6 @@
 import { mergeRsbuildConfig } from "@rsbuild/core";
 import { pluginCssMinimizer } from "@rsbuild/plugin-css-minimizer";
 import { pluginLess } from "@rsbuild/plugin-less";
-import { pluginReact } from "@rsbuild/plugin-react";
 import { pluginSass } from "@rsbuild/plugin-sass";
 import { pluginDevtool } from "../plugins/devtools.mjs";
 import { pluginEmitRouteFile } from "../plugins/emitRouteFile.mjs";
@@ -10,8 +9,9 @@ import { pluginGlobalVars } from "../plugins/globalVars.mjs";
 import { pluginHtmlMinifierTerser } from "../plugins/htmlMinify.mjs";
 import { pluginRuntimeChunk } from "../plugins/runtimeChunk.mjs";
 import { transformToRsbuildServerOptions } from "./devServer.mjs";
+import { normalizeLessOptions, normalizeSassOptions, resolveSvgrOptions } from "./pluginOptions.mjs";
 import { withTsgoDefaults } from "./tsgo.mjs";
-import { NODE_MODULES_REGEX } from "./utils.mjs";
+import { NODE_MODULES_REGEX, SERVICE_WORKER_ENVIRONMENT_NAME } from "./utils.mjs";
 const CSS_MODULES_REGEX = /\.modules?\.\w+$/i;
 const GLOBAL_CSS_REGEX = /\.global\.\w+$/;
 const DEFAULT_CSS_MINIFIER_OPTIONS = {
@@ -37,7 +37,7 @@ function removeUndefinedKey(obj) {
 }
 async function parseCommonConfig(builderConfig, options) {
     const frameworkConfigPath = options?.frameworkConfigPath;
-    const { plugins: [...plugins] = [], splitChunks, performance: { ...performanceConfig } = {}, output: { module = false, enableCssModuleTSDeclaration, disableCssModuleExtension, disableTsChecker, disableSvgr, svgDefaultExport, assetsRetry, enableAssetManifest, sourceMap, convertToRem, polyfill, dataUriLimit = 10000, distPath = {}, ...outputConfig } = {}, html: { outputStructure, appIcon, ...htmlConfig } = {}, source: { alias, globalVars, transformImport, reactCompiler, ...sourceConfig } = {}, dev = {}, server = {}, security: { checkSyntax, sri, ...securityConfig } = {}, tools: { devServer, tsChecker, minifyCss, less, sass, htmlPlugin, autoprefixer, ...toolsConfig } = {}, environments = {}, resolve = {} } = builderConfig;
+    const { plugins: [...plugins] = [], splitChunks, performance: { ...performanceConfig } = {}, output: { module = false, enableCssModuleTSDeclaration, disableCssModuleExtension, disableTsChecker, disableSvgr, svgDefaultExport, assetsRetry, enableAssetManifest, sourceMap, convertToRem, polyfill, dataUriLimit = 10000, distPath = {}, ...outputConfig } = {}, html: { outputStructure, appIcon, ...htmlConfig } = {}, source: { alias, globalVars, transformImport, reactCompiler, ...sourceConfig } = {}, dev = {}, server = {}, security: { checkSyntax, sri, ...securityConfig } = {}, tools: { devServer, tsChecker, minifyCss, less, sass, svgr, htmlPlugin, autoprefixer, ...toolsConfig } = {}, environments = {}, resolve = {} } = builderConfig;
     let combinedAlias;
     if (alias || resolve.alias) combinedAlias = [].concat(alias ?? []).concat(resolve.alias ?? []);
     const rsbuildConfig = {
@@ -120,12 +120,8 @@ async function parseCommonConfig(builderConfig, options) {
             sourceMap
         }),
         pluginEmitRouteFile(),
-        pluginSass({
-            sassLoaderOptions: sass
-        }),
-        pluginLess({
-            lessLoaderOptions: less
-        }),
+        pluginSass(normalizeSassOptions(sass)),
+        pluginLess(normalizeLessOptions(less)),
         pluginEnvironmentDefaults(distPath),
         pluginHtmlMinifierTerser()
     ];
@@ -152,19 +148,44 @@ async function parseCommonConfig(builderConfig, options) {
         const { pluginSourceBuild } = await import("@rsbuild/plugin-source-build");
         rsbuildPlugins.push(pluginSourceBuild(true === sourceBuild ? {} : sourceBuild));
     }
-    rsbuildPlugins.push(pluginReact(options?.disableReactCompiler || void 0 === reactCompiler ? {} : {
-        reactCompiler
-    }));
-    if (!disableSvgr) {
-        const { pluginSvgr } = await import("@rsbuild/plugin-svgr");
-        rsbuildPlugins.push(pluginSvgr({
-            mixedImport: true,
-            parallel: true,
-            svgrOptions: {
-                exportType: 'component' === svgDefaultExport ? 'default' : 'named'
-            }
-        }));
-    }
+    rsbuildPlugins.push({
+        name: 'rsbuild:react',
+        async setup (api) {
+            const { pluginReact } = await import("@rsbuild/plugin-react");
+            return pluginReact().setup(api);
+        }
+    });
+    if (!options?.disableReactCompiler && void 0 !== reactCompiler) rsbuildPlugins.push({
+        name: 'builder:react-compiler',
+        setup (api) {
+            api.modifyEnvironmentConfig((config, { name, mergeEnvironmentConfig })=>'web' === config.output.target && name !== SERVICE_WORKER_ENVIRONMENT_NAME ? mergeEnvironmentConfig({
+                    tools: {
+                        swc: {
+                            jsc: {
+                                transform: {
+                                    reactCompiler
+                                }
+                            }
+                        }
+                    }
+                }, config) : config);
+        }
+    });
+    const svgrOptions = resolveSvgrOptions({
+        svgr,
+        disableSvgr,
+        svgDefaultExport
+    });
+    if (false !== svgrOptions) rsbuildPlugins.push({
+        name: 'rsbuild:svgr',
+        pre: [
+            'rsbuild:react'
+        ],
+        async setup (api) {
+            const { pluginSvgr } = await import("@rsbuild/plugin-svgr");
+            await pluginSvgr(svgrOptions).setup(api);
+        }
+    });
     if (assetsRetry) {
         const { pluginAssetsRetry } = await import("@rsbuild/plugin-assets-retry");
         rsbuildPlugins.push(pluginAssetsRetry(assetsRetry));

package/dist/esm/shared/pluginOptions.mjs

@@ -0,0 +1,75 @@
+import { applyOptionsChain, isDevCommand, logger } from "@modern-js/utils";
+const LESS_PLUGIN_KEYS = [
+    'lessLoaderOptions',
+    'include',
+    'exclude',
+    'parallel'
+];
+const SASS_PLUGIN_KEYS = [
+    'sassLoaderOptions',
+    'include',
+    'exclude',
+    'rewriteUrls'
+];
+const warned = new Set();
+const resetPluginOptionsWarnings = ()=>{
+    warned.clear();
+};
+const warnOnceInDev = (key, message)=>{
+    if (!isDevCommand() || warned.has(key)) return;
+    warned.add(key);
+    logger.warn(message);
+};
+const isPlainObject = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const isPluginLevelOptions = (value, pluginKeys)=>isPlainObject(value) && pluginKeys.some((key)=>key in value);
+const isEmptyObject = (value)=>isPlainObject(value) && 0 === Object.keys(value).length;
+const warnIgnoredKeys = (name, value, pluginKeys, loaderOptionsKey)=>{
+    const pluginLevel = Object.keys(value).filter((key)=>pluginKeys.includes(key));
+    const ignored = Object.keys(value).filter((key)=>!pluginKeys.includes(key));
+    if (0 === ignored.length) return;
+    warnOnceInDev(`${name}:mixed`, `\`${name}\` contains plugin-level options (${pluginLevel.join(', ')}) together with other keys (${ignored.join(', ')}). The whole object is passed to the plugin, so the other keys are ignored. Move loader options under \`${loaderOptionsKey}\`.`);
+};
+const normalizeLessOptions = (less)=>{
+    if (isPluginLevelOptions(less, LESS_PLUGIN_KEYS)) {
+        warnIgnoredKeys('tools.less', less, LESS_PLUGIN_KEYS, 'lessLoaderOptions');
+        return less;
+    }
+    if (void 0 !== less && !isEmptyObject(less)) warnOnceInDev('tools.less', "`tools.less` now accepts the full options of @rsbuild/plugin-less. Passing less-loader options directly is deprecated and will stop working in the next major version. Move them under `lessLoaderOptions`:\n  before: tools: { less: { lessOptions: { javascriptEnabled: true } } }\n  after:  tools: { less: { lessLoaderOptions: { lessOptions: { javascriptEnabled: true } } } }");
+    return {
+        lessLoaderOptions: less
+    };
+};
+const normalizeSassOptions = (sass)=>{
+    if (isPluginLevelOptions(sass, SASS_PLUGIN_KEYS)) {
+        warnIgnoredKeys('tools.sass', sass, SASS_PLUGIN_KEYS, 'sassLoaderOptions');
+        return sass;
+    }
+    if (void 0 !== sass && !isEmptyObject(sass)) warnOnceInDev('tools.sass', "`tools.sass` now accepts the full options of @rsbuild/plugin-sass. Passing sass-loader options directly is deprecated and will stop working in the next major version. Move them under `sassLoaderOptions`:\n  before: tools: { sass: { sassOptions: { quietDeps: true } } }\n  after:  tools: { sass: { sassLoaderOptions: { sassOptions: { quietDeps: true } } } }");
+    return {
+        sassLoaderOptions: sass
+    };
+};
+const mergeSvgrOptions = (target, source)=>{
+    const svgrOptions = source.svgrOptions ? {
+        ...target.svgrOptions,
+        ...source.svgrOptions
+    } : target.svgrOptions;
+    return Object.assign(target, source, {
+        svgrOptions
+    });
+};
+const resolveSvgrOptions = ({ svgr, disableSvgr, svgDefaultExport })=>{
+    if (void 0 !== disableSvgr) warnOnceInDev('output.disableSvgr', disableSvgr ? '`output.disableSvgr` is deprecated and will be removed in the next major version. Use `tools: { svgr: false }` instead.' : '`output.disableSvgr` is deprecated and will be removed in the next major version. SVGR is enabled by default, so `output.disableSvgr: false` can be removed (or use `tools: { svgr: {} }` to keep it explicit).');
+    if (void 0 !== svgDefaultExport) warnOnceInDev('output.svgDefaultExport', "`output.svgDefaultExport` is deprecated and will be removed in the next major version. Use `tools.svgr.svgrOptions.exportType` instead:\n  before: output: { svgDefaultExport: 'component' }\n  after:  tools: { svgr: { svgrOptions: { exportType: 'default' } } }\n  ('url' maps to exportType: 'named')");
+    if (false === svgr) return false;
+    if (void 0 === svgr && disableSvgr) return false;
+    const defaults = {
+        mixedImport: true,
+        parallel: true,
+        svgrOptions: {
+            exportType: 'component' === svgDefaultExport ? 'default' : 'named'
+        }
+    };
+    return applyOptionsChain(defaults, svgr, void 0, mergeSvgrOptions);
+};
+export { normalizeLessOptions, normalizeSassOptions, resetPluginOptionsWarnings, resolveSvgrOptions };

package/dist/esm/shared/tsgo.mjs

@@ -5,7 +5,6 @@ import node_path from "node:path";
 import { json5 } from "@modern-js/utils";
 const builderRequire = createRequire(import.meta.url);
 const STABLE_TSGO_PACKAGE = "typescript/package.json";
-const NATIVE_PREVIEW_TSGO_PACKAGE = "@typescript/native-preview/package.json";
 const TSGO_CHECKER_DIR = node_path.join('.modern-js', 'tsgo');
 const tryResolve = (request, rootPath)=>{
     try {
@@ -18,25 +17,11 @@ const tryResolve = (request, rootPath)=>{
         return;
     }
 };
-const readPackageMajorVersion = (packageJsonPath)=>{
-    try {
-        const packageJson = JSON.parse(node_fs.readFileSync(packageJsonPath, 'utf8'));
-        const major = Number.parseInt(String(packageJson.version).split('.')[0], 10);
-        return Number.isFinite(major) ? major : void 0;
-    } catch  {
-        return;
-    }
-};
 const resolveTsgoPackagePath = (rootPath)=>{
-    const stableTypeScriptPath = tryResolve(STABLE_TSGO_PACKAGE, rootPath);
-    if (stableTypeScriptPath && (readPackageMajorVersion(stableTypeScriptPath) ?? 0) >= 7) return stableTypeScriptPath;
-    const previewFromProject = tryResolve(NATIVE_PREVIEW_TSGO_PACKAGE, rootPath);
-    if (previewFromProject) return previewFromProject;
-    try {
-        return builderRequire.resolve(NATIVE_PREVIEW_TSGO_PACKAGE);
-    } catch  {
-        return;
-    }
+    const packageJsonPath = tryResolve(STABLE_TSGO_PACKAGE, rootPath) ?? builderRequire.resolve(STABLE_TSGO_PACKAGE);
+    const packageJson = JSON.parse(node_fs.readFileSync(packageJsonPath, 'utf8'));
+    if ("typescript" !== packageJson.name || '7.0.2' !== packageJson.version) throw new Error(`The native type checker requires typescript@7.0.2; found ${String(packageJson.name)}@${String(packageJson.version)} at ${packageJsonPath}.`);
+    return packageJsonPath;
 };
 const toPosixPath = (input)=>input.replaceAll(node_path.sep, '/');
 const asTsConfigPath = (request)=>{
@@ -137,7 +122,7 @@ const createTsgoCheckerConfig = (configFile, checkerConfigFile = defaultTsgoChec
     };
     const declaredRootDir = tsConfig.compilerOptions?.rootDir;
     if ('string' == typeof declaredRootDir) compilerOptions.rootDir = toPosixPath(declaredRootDir);
-    else if (tsConfig.compilerOptions?.composite === true) compilerOptions.rootDir = toPosixPath(configDirectory);
+    else compilerOptions.rootDir = toPosixPath(configDirectory);
     const moduleResolution = String(tsConfig.compilerOptions?.moduleResolution).toLowerCase();
     if ([
         'node',
@@ -201,19 +186,13 @@ const withTsgoDefaults = (userOptions, rootPath)=>{
     ] : [];
     return [
         {
-            typescript: tsgoPath ? {
+            typescript: {
                 tsgo: true,
                 typescriptPath: tsgoPath
-            } : {
-                tsgo: true
             }
         },
         ...userChain,
-        (config)=>{
-            const { typescript } = config;
-            if (typescript?.tsgo === false && typescript.typescriptPath === tsgoPath) typescript.typescriptPath = tryResolve("typescript", rootPath);
-            return normalizeTsgoConfig(config, rootPath);
-        }
+        (config)=>normalizeTsgoConfig(config, rootPath)
     ];
 };
 export { refreshTsgoCheckerConfig, withTsgoDefaults };

package/dist/esm-node/plugins/environmentDefaults.mjs

@@ -57,14 +57,15 @@ const pluginEnvironmentDefaults = (distPath = {})=>({
             });
             api.modifyBundlerChain(async (chain, { environment })=>{
                 const isServiceWorker = environment.name === SERVICE_WORKER_ENVIRONMENT_NAME;
-                if (isServiceWorker && true === chain.output.get('module')) chain.output.library({
-                    ...chain.output.get('library') || {},
-                    type: 'module'
-                });
-                else if (isServiceWorker) chain.output.library({
-                    ...chain.output.get('library') || {},
-                    type: 'commonjs2'
-                });
+                if (isServiceWorker) {
+                    const library = chain.output.get('library');
+                    chain.output.library({
+                        ...'string' == typeof library || Array.isArray(library) ? {
+                            name: library
+                        } : library,
+                        type: true === chain.output.get('module') ? 'module' : 'commonjs2'
+                    });
+                }
             });
         }
     });

package/dist/esm-node/plugins/manifest.mjs

@@ -9,7 +9,9 @@ const pluginManifest = ()=>({
                 chain.plugin(CHAIN_ID.PLUGIN.MANIFEST).use(RspackManifestPlugin, [
                     {
                         fileName: 'web' === target ? 'asset-manifest.json' : `asset-manifest-${target}.json`,
-                        publicPath,
+                        ...'string' == typeof publicPath ? {
+                            publicPath
+                        } : {},
                         generate: generateManifest
                     }
                 ]);

package/dist/esm-node/plugins/rscConfig.mjs

@@ -7,19 +7,26 @@ var __rspack_import_meta_dirname__ = __rspack_dirname(__rspack_fileURLToPath(imp
 const ASYNC_STORAGE_PATTERN = /universal[/\\]async_storage/;
 const SERVER_LOADER_ENTRY_PATTERN = /[/\\](?:server-loader-combined|route-server-loaders)\.js$/;
 const RENDER_RSC_SOURCE_PATTERN = /render[/\\].*[/\\]server[/\\]rsc/;
-const RENDER_RSC_RSLIB_ENTRY_PATTERN = /render[/\\]dist[/\\]esm[/\\]rsc(?:Worker)?\.mjs$/;
-const RENDER_RSC_RUNTIME = '@modern-js/render/rsc';
-const RENDER_RSC_WORKER_RUNTIME = '@modern-js/render/rsc-worker';
+const RENDER_RSC_RSLIB_ENTRY_PATTERN = /render[/\\]dist[/\\]esm[/\\]rsc(?:\.edge)?\.mjs$/;
 const RSC_COMMON_LAYER = 'rsc-common';
 const ENTRY_NAME_VAR = '__MODERN_JS_ENTRY_NAME';
 const ROUTE_DATA_FILE_PATTERN = /[/\\]routes[/\\](?:.*[/\\])?(?:layout|page|\$)\.(?:loader|data)\.[tj]sx?(?:\?.*)?$/;
 const createVirtualModule = (content)=>`data:text/javascript,${encodeURIComponent(content)}`;
+const resolveRscEnvironments = (environments)=>{
+    const resolved = {
+        server: environments?.server ?? 'server',
+        client: environments?.client ?? 'client'
+    };
+    for (const [role, name] of Object.entries(resolved))if ('string' != typeof name || !name.trim()) throw new TypeError(`RSC ${role} environment must have a nonempty name`);
+    return resolved;
+};
 const isAsyncStorageExclude = (exclude)=>{
     if ('string' == typeof exclude) return ASYNC_STORAGE_PATTERN.test(exclude);
     if (exclude instanceof RegExp) return exclude.test('universal/async_storage') || exclude.test('universal\\async_storage');
     return false;
 };
-function pluginRscConfig() {
+function pluginRscConfig(environments, rscLayerMatchers = []) {
+    const serverEnvironment = resolveRscEnvironments(environments).server;
     return {
         name: 'builder:rsc-config',
         setup (api) {
@@ -32,9 +39,8 @@ function pluginRscConfig() {
                 return layersCache;
             };
             api.modifyBundlerChain({
-                handler: (chain, { isServer })=>{
-                    if (isServer) {
-                        chain.resolve.alias.set(`${RENDER_RSC_RUNTIME}$`, RENDER_RSC_WORKER_RUNTIME);
+                handler: (chain, { isServer, environment })=>{
+                    if (isServer || environment.name === serverEnvironment) {
                         let emptyModulePath;
                         try {
                             emptyModulePath = require.resolve('../shared/rsc/rscEmptyModule');
@@ -57,9 +63,25 @@ function pluginRscConfig() {
                 order: 'pre'
             });
             api.modifyRspackConfig(async (config, utils)=>{
-                const isServer = 'node' === config.target || 'node' === utils.target || utils.environment?.name === 'server';
+                const isServer = 'node' === config.target || 'node' === utils.target || utils.environment?.name === serverEnvironment;
                 if (!isServer) return;
                 const Layers = await getLayers();
+                if (utils.environment?.name !== serverEnvironment && rscLayerMatchers.length > 0) {
+                    config.module ??= {};
+                    config.module.rules ??= [];
+                    config.module.rules.push({
+                        test: rscLayerMatchers,
+                        layer: Layers.rsc
+                    }, {
+                        issuerLayer: Layers.rsc,
+                        resolve: {
+                            conditionNames: [
+                                'react-server',
+                                '...'
+                            ]
+                        }
+                    });
+                }
                 if (config.entry) {
                     const entries = config.entry;
                     const newEntries = {};
@@ -96,8 +118,8 @@ function pluginRscConfig() {
                     });
                 }
             });
-            api.modifyBundlerChain((chain, { isServer, isWebWorker })=>{
-                if (!isServer && !isWebWorker) {
+            api.modifyBundlerChain((chain, { isServer, isWebWorker, environment })=>{
+                if (!isServer && !isWebWorker && environment.name !== serverEnvironment) {
                     const entries = chain.entryPoints.entries();
                     if (entries && 'object' == typeof entries) for (const entryName of Object.keys(entries)){
                         const entryPoint = chain.entry(entryName);
@@ -111,13 +133,12 @@ function pluginRscConfig() {
 }
 async function getRscPlugins(enableRsc, internalDirectory, environments) {
     if (enableRsc) {
+        const rscEnvironments = resolveRscEnvironments(environments);
         const rscLayerMatchers = createRscLayerMatchers(internalDirectory);
         const { pluginRSC } = await import("rsbuild-plugin-rsc");
         return [
             pluginRSC({
-                ...environments ? {
-                    environments
-                } : {},
+                environments: rscEnvironments,
                 layers: {
                     ssr: SERVER_LOADER_ENTRY_PATTERN,
                     rsc: [
@@ -128,7 +149,7 @@ async function getRscPlugins(enableRsc, internalDirectory, environments) {
                     ]
                 }
             }),
-            pluginRscConfig()
+            pluginRscConfig(rscEnvironments, rscLayerMatchers)
         ];
     }
     return [];

package/dist/esm-node/shared/parseCommonConfig.mjs

@@ -2,7 +2,6 @@ import "node:module";
 import { mergeRsbuildConfig } from "@rsbuild/core";
 import { pluginCssMinimizer } from "@rsbuild/plugin-css-minimizer";
 import { pluginLess } from "@rsbuild/plugin-less";
-import { pluginReact } from "@rsbuild/plugin-react";
 import { pluginSass } from "@rsbuild/plugin-sass";
 import { pluginDevtool } from "../plugins/devtools.mjs";
 import { pluginEmitRouteFile } from "../plugins/emitRouteFile.mjs";
@@ -11,8 +10,9 @@ import { pluginGlobalVars } from "../plugins/globalVars.mjs";
 import { pluginHtmlMinifierTerser } from "../plugins/htmlMinify.mjs";
 import { pluginRuntimeChunk } from "../plugins/runtimeChunk.mjs";
 import { transformToRsbuildServerOptions } from "./devServer.mjs";
+import { normalizeLessOptions, normalizeSassOptions, resolveSvgrOptions } from "./pluginOptions.mjs";
 import { withTsgoDefaults } from "./tsgo.mjs";
-import { NODE_MODULES_REGEX } from "./utils.mjs";
+import { NODE_MODULES_REGEX, SERVICE_WORKER_ENVIRONMENT_NAME } from "./utils.mjs";
 const CSS_MODULES_REGEX = /\.modules?\.\w+$/i;
 const GLOBAL_CSS_REGEX = /\.global\.\w+$/;
 const DEFAULT_CSS_MINIFIER_OPTIONS = {
@@ -38,7 +38,7 @@ function removeUndefinedKey(obj) {
 }
 async function parseCommonConfig(builderConfig, options) {
     const frameworkConfigPath = options?.frameworkConfigPath;
-    const { plugins: [...plugins] = [], splitChunks, performance: { ...performanceConfig } = {}, output: { module = false, enableCssModuleTSDeclaration, disableCssModuleExtension, disableTsChecker, disableSvgr, svgDefaultExport, assetsRetry, enableAssetManifest, sourceMap, convertToRem, polyfill, dataUriLimit = 10000, distPath = {}, ...outputConfig } = {}, html: { outputStructure, appIcon, ...htmlConfig } = {}, source: { alias, globalVars, transformImport, reactCompiler, ...sourceConfig } = {}, dev = {}, server = {}, security: { checkSyntax, sri, ...securityConfig } = {}, tools: { devServer, tsChecker, minifyCss, less, sass, htmlPlugin, autoprefixer, ...toolsConfig } = {}, environments = {}, resolve = {} } = builderConfig;
+    const { plugins: [...plugins] = [], splitChunks, performance: { ...performanceConfig } = {}, output: { module = false, enableCssModuleTSDeclaration, disableCssModuleExtension, disableTsChecker, disableSvgr, svgDefaultExport, assetsRetry, enableAssetManifest, sourceMap, convertToRem, polyfill, dataUriLimit = 10000, distPath = {}, ...outputConfig } = {}, html: { outputStructure, appIcon, ...htmlConfig } = {}, source: { alias, globalVars, transformImport, reactCompiler, ...sourceConfig } = {}, dev = {}, server = {}, security: { checkSyntax, sri, ...securityConfig } = {}, tools: { devServer, tsChecker, minifyCss, less, sass, svgr, htmlPlugin, autoprefixer, ...toolsConfig } = {}, environments = {}, resolve = {} } = builderConfig;
     let combinedAlias;
     if (alias || resolve.alias) combinedAlias = [].concat(alias ?? []).concat(resolve.alias ?? []);
     const rsbuildConfig = {
@@ -121,12 +121,8 @@ async function parseCommonConfig(builderConfig, options) {
             sourceMap
         }),
         pluginEmitRouteFile(),
-        pluginSass({
-            sassLoaderOptions: sass
-        }),
-        pluginLess({
-            lessLoaderOptions: less
-        }),
+        pluginSass(normalizeSassOptions(sass)),
+        pluginLess(normalizeLessOptions(less)),
         pluginEnvironmentDefaults(distPath),
         pluginHtmlMinifierTerser()
     ];
@@ -153,19 +149,44 @@ async function parseCommonConfig(builderConfig, options) {
         const { pluginSourceBuild } = await import("@rsbuild/plugin-source-build");
         rsbuildPlugins.push(pluginSourceBuild(true === sourceBuild ? {} : sourceBuild));
     }
-    rsbuildPlugins.push(pluginReact(options?.disableReactCompiler || void 0 === reactCompiler ? {} : {
-        reactCompiler
-    }));
-    if (!disableSvgr) {
-        const { pluginSvgr } = await import("@rsbuild/plugin-svgr");
-        rsbuildPlugins.push(pluginSvgr({
-            mixedImport: true,
-            parallel: true,
-            svgrOptions: {
-                exportType: 'component' === svgDefaultExport ? 'default' : 'named'
-            }
-        }));
-    }
+    rsbuildPlugins.push({
+        name: 'rsbuild:react',
+        async setup (api) {
+            const { pluginReact } = await import("@rsbuild/plugin-react");
+            return pluginReact().setup(api);
+        }
+    });
+    if (!options?.disableReactCompiler && void 0 !== reactCompiler) rsbuildPlugins.push({
+        name: 'builder:react-compiler',
+        setup (api) {
+            api.modifyEnvironmentConfig((config, { name, mergeEnvironmentConfig })=>'web' === config.output.target && name !== SERVICE_WORKER_ENVIRONMENT_NAME ? mergeEnvironmentConfig({
+                    tools: {
+                        swc: {
+                            jsc: {
+                                transform: {
+                                    reactCompiler
+                                }
+                            }
+                        }
+                    }
+                }, config) : config);
+        }
+    });
+    const svgrOptions = resolveSvgrOptions({
+        svgr,
+        disableSvgr,
+        svgDefaultExport
+    });
+    if (false !== svgrOptions) rsbuildPlugins.push({
+        name: 'rsbuild:svgr',
+        pre: [
+            'rsbuild:react'
+        ],
+        async setup (api) {
+            const { pluginSvgr } = await import("@rsbuild/plugin-svgr");
+            await pluginSvgr(svgrOptions).setup(api);
+        }
+    });
     if (assetsRetry) {
         const { pluginAssetsRetry } = await import("@rsbuild/plugin-assets-retry");
         rsbuildPlugins.push(pluginAssetsRetry(assetsRetry));

package/dist/esm-node/shared/pluginOptions.mjs

@@ -0,0 +1,76 @@
+import "node:module";
+import { applyOptionsChain, isDevCommand, logger } from "@modern-js/utils";
+const LESS_PLUGIN_KEYS = [
+    'lessLoaderOptions',
+    'include',
+    'exclude',
+    'parallel'
+];
+const SASS_PLUGIN_KEYS = [
+    'sassLoaderOptions',
+    'include',
+    'exclude',
+    'rewriteUrls'
+];
+const warned = new Set();
+const resetPluginOptionsWarnings = ()=>{
+    warned.clear();
+};
+const warnOnceInDev = (key, message)=>{
+    if (!isDevCommand() || warned.has(key)) return;
+    warned.add(key);
+    logger.warn(message);
+};
+const isPlainObject = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const isPluginLevelOptions = (value, pluginKeys)=>isPlainObject(value) && pluginKeys.some((key)=>key in value);
+const isEmptyObject = (value)=>isPlainObject(value) && 0 === Object.keys(value).length;
+const warnIgnoredKeys = (name, value, pluginKeys, loaderOptionsKey)=>{
+    const pluginLevel = Object.keys(value).filter((key)=>pluginKeys.includes(key));
+    const ignored = Object.keys(value).filter((key)=>!pluginKeys.includes(key));
+    if (0 === ignored.length) return;
+    warnOnceInDev(`${name}:mixed`, `\`${name}\` contains plugin-level options (${pluginLevel.join(', ')}) together with other keys (${ignored.join(', ')}). The whole object is passed to the plugin, so the other keys are ignored. Move loader options under \`${loaderOptionsKey}\`.`);
+};
+const normalizeLessOptions = (less)=>{
+    if (isPluginLevelOptions(less, LESS_PLUGIN_KEYS)) {
+        warnIgnoredKeys('tools.less', less, LESS_PLUGIN_KEYS, 'lessLoaderOptions');
+        return less;
+    }
+    if (void 0 !== less && !isEmptyObject(less)) warnOnceInDev('tools.less', "`tools.less` now accepts the full options of @rsbuild/plugin-less. Passing less-loader options directly is deprecated and will stop working in the next major version. Move them under `lessLoaderOptions`:\n  before: tools: { less: { lessOptions: { javascriptEnabled: true } } }\n  after:  tools: { less: { lessLoaderOptions: { lessOptions: { javascriptEnabled: true } } } }");
+    return {
+        lessLoaderOptions: less
+    };
+};
+const normalizeSassOptions = (sass)=>{
+    if (isPluginLevelOptions(sass, SASS_PLUGIN_KEYS)) {
+        warnIgnoredKeys('tools.sass', sass, SASS_PLUGIN_KEYS, 'sassLoaderOptions');
+        return sass;
+    }
+    if (void 0 !== sass && !isEmptyObject(sass)) warnOnceInDev('tools.sass', "`tools.sass` now accepts the full options of @rsbuild/plugin-sass. Passing sass-loader options directly is deprecated and will stop working in the next major version. Move them under `sassLoaderOptions`:\n  before: tools: { sass: { sassOptions: { quietDeps: true } } }\n  after:  tools: { sass: { sassLoaderOptions: { sassOptions: { quietDeps: true } } } }");
+    return {
+        sassLoaderOptions: sass
+    };
+};
+const mergeSvgrOptions = (target, source)=>{
+    const svgrOptions = source.svgrOptions ? {
+        ...target.svgrOptions,
+        ...source.svgrOptions
+    } : target.svgrOptions;
+    return Object.assign(target, source, {
+        svgrOptions
+    });
+};
+const resolveSvgrOptions = ({ svgr, disableSvgr, svgDefaultExport })=>{
+    if (void 0 !== disableSvgr) warnOnceInDev('output.disableSvgr', disableSvgr ? '`output.disableSvgr` is deprecated and will be removed in the next major version. Use `tools: { svgr: false }` instead.' : '`output.disableSvgr` is deprecated and will be removed in the next major version. SVGR is enabled by default, so `output.disableSvgr: false` can be removed (or use `tools: { svgr: {} }` to keep it explicit).');
+    if (void 0 !== svgDefaultExport) warnOnceInDev('output.svgDefaultExport', "`output.svgDefaultExport` is deprecated and will be removed in the next major version. Use `tools.svgr.svgrOptions.exportType` instead:\n  before: output: { svgDefaultExport: 'component' }\n  after:  tools: { svgr: { svgrOptions: { exportType: 'default' } } }\n  ('url' maps to exportType: 'named')");
+    if (false === svgr) return false;
+    if (void 0 === svgr && disableSvgr) return false;
+    const defaults = {
+        mixedImport: true,
+        parallel: true,
+        svgrOptions: {
+            exportType: 'component' === svgDefaultExport ? 'default' : 'named'
+        }
+    };
+    return applyOptionsChain(defaults, svgr, void 0, mergeSvgrOptions);
+};
+export { normalizeLessOptions, normalizeSassOptions, resetPluginOptionsWarnings, resolveSvgrOptions };

package/dist/esm-node/shared/tsgo.mjs

@@ -6,7 +6,6 @@ import node_path from "node:path";
 import { json5 } from "@modern-js/utils";
 const builderRequire = createRequire(import.meta.url);
 const STABLE_TSGO_PACKAGE = "typescript/package.json";
-const NATIVE_PREVIEW_TSGO_PACKAGE = "@typescript/native-preview/package.json";
 const TSGO_CHECKER_DIR = node_path.join('.modern-js', 'tsgo');
 const tryResolve = (request, rootPath)=>{
     try {
@@ -19,25 +18,11 @@ const tryResolve = (request, rootPath)=>{
         return;
     }
 };
-const readPackageMajorVersion = (packageJsonPath)=>{
-    try {
-        const packageJson = JSON.parse(node_fs.readFileSync(packageJsonPath, 'utf8'));
-        const major = Number.parseInt(String(packageJson.version).split('.')[0], 10);
-        return Number.isFinite(major) ? major : void 0;
-    } catch  {
-        return;
-    }
-};
 const resolveTsgoPackagePath = (rootPath)=>{
-    const stableTypeScriptPath = tryResolve(STABLE_TSGO_PACKAGE, rootPath);
-    if (stableTypeScriptPath && (readPackageMajorVersion(stableTypeScriptPath) ?? 0) >= 7) return stableTypeScriptPath;
-    const previewFromProject = tryResolve(NATIVE_PREVIEW_TSGO_PACKAGE, rootPath);
-    if (previewFromProject) return previewFromProject;
-    try {
-        return builderRequire.resolve(NATIVE_PREVIEW_TSGO_PACKAGE);
-    } catch  {
-        return;
-    }
+    const packageJsonPath = tryResolve(STABLE_TSGO_PACKAGE, rootPath) ?? builderRequire.resolve(STABLE_TSGO_PACKAGE);
+    const packageJson = JSON.parse(node_fs.readFileSync(packageJsonPath, 'utf8'));
+    if ("typescript" !== packageJson.name || '7.0.2' !== packageJson.version) throw new Error(`The native type checker requires typescript@7.0.2; found ${String(packageJson.name)}@${String(packageJson.version)} at ${packageJsonPath}.`);
+    return packageJsonPath;
 };
 const toPosixPath = (input)=>input.replaceAll(node_path.sep, '/');
 const asTsConfigPath = (request)=>{
@@ -138,7 +123,7 @@ const createTsgoCheckerConfig = (configFile, checkerConfigFile = defaultTsgoChec
     };
     const declaredRootDir = tsConfig.compilerOptions?.rootDir;
     if ('string' == typeof declaredRootDir) compilerOptions.rootDir = toPosixPath(declaredRootDir);
-    else if (tsConfig.compilerOptions?.composite === true) compilerOptions.rootDir = toPosixPath(configDirectory);
+    else compilerOptions.rootDir = toPosixPath(configDirectory);
     const moduleResolution = String(tsConfig.compilerOptions?.moduleResolution).toLowerCase();
     if ([
         'node',
@@ -202,19 +187,13 @@ const withTsgoDefaults = (userOptions, rootPath)=>{
     ] : [];
     return [
         {
-            typescript: tsgoPath ? {
+            typescript: {
                 tsgo: true,
                 typescriptPath: tsgoPath
-            } : {
-                tsgo: true
             }
         },
         ...userChain,
-        (config)=>{
-            const { typescript } = config;
-            if (typescript?.tsgo === false && typescript.typescriptPath === tsgoPath) typescript.typescriptPath = tryResolve("typescript", rootPath);
-            return normalizeTsgoConfig(config, rootPath);
-        }
+        (config)=>normalizeTsgoConfig(config, rootPath)
     ];
 };
 export { refreshTsgoCheckerConfig, withTsgoDefaults };

package/dist/types/index.d.ts

@@ -4,6 +4,6 @@ export { type ChainIdentifier, type ConfigChain, logger, type NormalizedConfig,
 export { parseConfig as parseRspackConfig } from './createBuilder.js';
 export { refreshTsgoCheckerConfig } from './shared/tsgo.js';
 export { castArray, isHtmlDisabled, RUNTIME_CHUNK_NAME, RUNTIME_CHUNK_REGEX, SERVICE_WORKER_ENVIRONMENT_NAME, } from './shared/utils.js';
-export type { BuilderConfig, BundlerType, CacheGroup, MetaOptions, MultiStats, RspackConfig, Stats, ToolsDevServerConfig, } from './types.js';
+export type { BuilderConfig, BuilderSvgOptions, BundlerType, CacheGroup, MetaOptions, MultiStats, RspackConfig, Stats, ToolsDevServerConfig, } from './types.js';
 export type { BuilderInstance, CreateBuilderOptions };
 export { createRspackBuilder as createBuilder };