@bleedingdev/modern-js-builder 3.4.0-ultramodern.2 → 3.4.0-ultramodern.20

package/dist/cjs/plugins/rscConfig.js

@@ -37,6 +37,7 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    enrichServerOnlyDiagnostics: ()=>enrichServerOnlyDiagnostics,
     getRscPlugins: ()=>getRscPlugins,
     pluginRscConfig: ()=>pluginRscConfig
 });
@@ -45,15 +46,148 @@ var external_path_default = /*#__PURE__*/ __webpack_require__.n(external_path_na
 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\.mjs$/;
+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 RSC_COMMON_LAYER = 'rsc-common';
 const ENTRY_NAME_VAR = '__MODERN_JS_ENTRY_NAME';
+const SERVER_ONLY_MARKER_PATTERN = /(?:^|[/\\])server-only[/\\]index\.js(?:\?|$)/;
+const SERVER_ONLY_MESSAGE_PATTERN = /server-only|server only|only works in a Server Component|cannot be imported (?:directly )?(?:from|into) (?:a )?Client Component/i;
+const SERVER_ONLY_DIAGNOSTIC_PREFIX = '[Modern.js RSC server-only diagnostic context]';
 const createVirtualModule = (content)=>`data:text/javascript,${encodeURIComponent(content)}`;
 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;
 };
+const asRecord = (value)=>{
+    if (value && 'object' == typeof value && !Array.isArray(value)) return value;
+};
+const disableReactCompilerInSwcLoaders = (value, seen = new WeakSet())=>{
+    if (!value || 'object' != typeof value) return;
+    if (seen.has(value)) return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value)disableReactCompilerInSwcLoaders(item, seen);
+        return;
+    }
+    const record = value;
+    if ('builtin:swc-loader' === record.loader) {
+        let options = asRecord(record.options);
+        if (!options) {
+            options = {};
+            record.options = options;
+        }
+        let jsc = asRecord(options.jsc);
+        if (!jsc) {
+            jsc = {};
+            options.jsc = jsc;
+        }
+        let transform = asRecord(jsc.transform);
+        if (!transform) {
+            transform = {};
+            jsc.transform = transform;
+        }
+        transform.reactCompiler = false;
+    }
+    for (const item of Object.values(record))disableReactCompilerInSwcLoaders(item, seen);
+};
+const normalizeDiagnosticText = (diagnostic)=>[
+        diagnostic.message,
+        diagnostic.details,
+        diagnostic.file,
+        getModulePath(diagnostic.module),
+        getModuleIdentifier(diagnostic.module)
+    ].filter((item)=>Boolean(item)).join('\n');
+const isServerOnlyDiagnostic = (diagnostic)=>{
+    const text = normalizeDiagnosticText(diagnostic);
+    return SERVER_ONLY_MARKER_PATTERN.test(text) || SERVER_ONLY_MESSAGE_PATTERN.test(text);
+};
+const isEnrichedServerOnlyDiagnostic = (diagnostic)=>diagnostic.message.includes(SERVER_ONLY_DIAGNOSTIC_PREFIX) || diagnostic.details?.includes(SERVER_ONLY_DIAGNOSTIC_PREFIX);
+const getModulePath = (module)=>{
+    if (!module) return;
+    return module.resource || module.nameForCondition?.() || module.userRequest;
+};
+const getModuleIdentifier = (module)=>{
+    if (!module) return;
+    return getModulePath(module) || module.readableIdentifier?.() || module.identifier?.() || module.request || module.rawRequest;
+};
+const formatModuleContext = (module)=>{
+    const id = getModuleIdentifier(module);
+    if (!id) return;
+    const layer = module?.layer ? ` [layer: ${module.layer}]` : '';
+    return `${id}${layer}`;
+};
+const getIssuerChain = (compilation, module)=>{
+    const chain = [];
+    const seen = new Set();
+    let current = module;
+    while(current && !seen.has(current) && chain.length < 8){
+        seen.add(current);
+        const issuer = compilation.moduleGraph?.getIssuer?.(current);
+        const formatted = formatModuleContext(issuer);
+        if (!issuer || !formatted) break;
+        chain.push(formatted);
+        current = issuer;
+    }
+    return chain;
+};
+const getModuleTraceChain = (diagnostic)=>{
+    const trace = diagnostic.moduleTrace || [];
+    const chain = [];
+    for (const item of trace){
+        const formatted = formatModuleContext(item.origin) || item.originName || formatModuleContext(item.module) || item.moduleName;
+        if (formatted && !chain.includes(formatted)) chain.push(formatted);
+    }
+    return chain.slice(0, 8);
+};
+const appendDiagnosticDetails = (diagnostic, lines)=>{
+    const context = `${SERVER_ONLY_DIAGNOSTIC_PREFIX}\n${lines.join('\n')}`;
+    diagnostic.details = diagnostic.details ? `${diagnostic.details}\n\n${context}` : context;
+};
+const enrichServerOnlyDiagnostics = (compilation, environmentName)=>{
+    const diagnostics = [
+        ...compilation.warnings,
+        ...compilation.errors
+    ];
+    for (const diagnostic of diagnostics){
+        if (!isServerOnlyDiagnostic(diagnostic) || isEnrichedServerOnlyDiagnostic(diagnostic)) continue;
+        const lines = [
+            `Environment: ${environmentName || compilation.name || 'unknown'}`
+        ];
+        const markerModule = formatModuleContext(diagnostic.module);
+        if (markerModule) lines.push(`Matched module: ${markerModule}`);
+        const issuerChain = getIssuerChain(compilation, diagnostic.module);
+        const moduleTraceChain = getModuleTraceChain(diagnostic);
+        const importerChain = issuerChain.length > 0 ? issuerChain : moduleTraceChain;
+        if (importerChain.length > 0) lines.push(`Importer chain: ${importerChain.join(' -> ')}`);
+        appendDiagnosticDetails(diagnostic, lines);
+    }
+};
+const applyServerOnlyDiagnosticPlugin = (compiler, environmentName)=>{
+    compiler.hooks.thisCompilation.tap('ModernJsServerOnlyDiagnosticContextPlugin', (compilation)=>{
+        compilation.hooks.processWarnings.tap('ModernJsServerOnlyDiagnosticContextPlugin', (warnings)=>{
+            enrichServerOnlyDiagnostics({
+                errors: compilation.errors,
+                moduleGraph: compilation.moduleGraph,
+                warnings
+            }, environmentName || compilation.name || compiler.name);
+            return warnings;
+        });
+        compilation.hooks.afterSeal.tapPromise('ModernJsServerOnlyDiagnosticContextPlugin', async ()=>{
+            enrichServerOnlyDiagnostics(compilation, environmentName || compilation.name || compiler.name);
+        });
+    });
+};
+const applyServerOnlyDiagnosticPlugins = (compiler, environments)=>{
+    const compilers = 'compilers' in compiler ? compiler.compilers : [
+        compiler
+    ];
+    compilers.forEach((childCompiler, index)=>{
+        const environmentName = childCompiler.name || Object.values(environments).find((environment)=>environment.index === index)?.name;
+        applyServerOnlyDiagnosticPlugin(childCompiler, environmentName);
+    });
+};
 function pluginRscConfig() {
     return {
         name: 'builder:rsc-config',
@@ -69,6 +203,7 @@ function pluginRscConfig() {
             api.modifyBundlerChain({
                 handler: (chain, { isServer })=>{
                     if (isServer) {
+                        chain.resolve.alias.set(`${RENDER_RSC_RUNTIME}$`, RENDER_RSC_WORKER_RUNTIME);
                         const routeFilePattern = /[/\\]routes[/\\](?:.*[/\\])?(?:layout|page|\$)\.[tj]sx?$/;
                         const appFilePattern = /[/\\]App\.[tj]sx?$/;
                         const combinedPattern = new RegExp(`(${routeFilePattern.source}|${appFilePattern.source})`);
@@ -107,6 +242,7 @@ function pluginRscConfig() {
                 }
                 if (config.module?.rules) {
                     const rules = config.module.rules;
+                    disableReactCompilerInSwcLoaders(rules);
                     for (const rule of rules)if (rule.layer === Layers.rsc) {
                         if (rule.exclude) {
                             if (!Array.isArray(rule.exclude)) rule.exclude = [
@@ -123,6 +259,9 @@ function pluginRscConfig() {
                     });
                 }
             });
+            api.onAfterCreateCompiler(({ compiler, environments })=>{
+                applyServerOnlyDiagnosticPlugins(compiler, environments);
+            });
             api.modifyBundlerChain((chain, { isServer, isWebWorker })=>{
                 if (!isServer && !isWebWorker) {
                     const entries = chain.entryPoints.entries();
@@ -160,9 +299,11 @@ async function getRscPlugins(enableRsc, internalDirectory, environments) {
     }
     return [];
 }
+exports.enrichServerOnlyDiagnostics = __webpack_exports__.enrichServerOnlyDiagnostics;
 exports.getRscPlugins = __webpack_exports__.getRscPlugins;
 exports.pluginRscConfig = __webpack_exports__.pluginRscConfig;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "enrichServerOnlyDiagnostics",
     "getRscPlugins",
     "pluginRscConfig"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/cjs/shared/parseCommonConfig.js

@@ -178,7 +178,7 @@ async function parseCommonConfig(builderConfig, options) {
         const { pluginSourceBuild } = await import("@rsbuild/plugin-source-build");
         rsbuildPlugins.push(pluginSourceBuild(true === sourceBuild ? {} : sourceBuild));
     }
-    rsbuildPlugins.push((0, plugin_react_namespaceObject.pluginReact)({
+    rsbuildPlugins.push((0, plugin_react_namespaceObject.pluginReact)(options?.disableReactCompiler ? {} : {
         reactCompiler: reactCompiler ?? true
     }));
     if (!disableSvgr) {

package/dist/cjs/shared/tsgo.js

@@ -3,6 +3,15 @@ const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
     return "u" < typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
 }();
 var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
 (()=>{
     __webpack_require__.d = (exports1, getters, values)=>{
         var define = (defs, kind)=>{
@@ -33,9 +42,16 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     withTsgoDefaults: ()=>withTsgoDefaults
 });
+const external_node_crypto_namespaceObject = require("node:crypto");
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
 const external_node_module_namespaceObject = require("node:module");
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const utils_namespaceObject = require("@modern-js/utils");
 const builderRequire = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
 const TSGO_PACKAGE = "@typescript/native-preview/package.json";
+const TSGO_CHECKER_DIR = external_node_path_default().join('.modern-js', 'tsgo');
 const tryResolve = (request, rootPath)=>{
     try {
         return builderRequire.resolve(request, {
@@ -47,6 +63,111 @@ const tryResolve = (request, rootPath)=>{
         return;
     }
 };
+const toPosixPath = (input)=>input.replaceAll(external_node_path_default().sep, '/');
+const asTsConfigPath = (request)=>{
+    if (external_node_path_default().extname(request)) return [
+        request
+    ];
+    return [
+        request,
+        `${request}.json`
+    ];
+};
+const resolveExtends = (request, configDirectory)=>{
+    const configRequire = (0, external_node_module_namespaceObject.createRequire)(external_node_path_default().join(configDirectory, 'tsconfig.json'));
+    for (const candidate of asTsConfigPath(request)){
+        if (candidate.startsWith('.') || external_node_path_default().isAbsolute(candidate)) {
+            const resolved = external_node_path_default().resolve(configDirectory, candidate);
+            if (external_node_fs_default().existsSync(resolved)) return resolved;
+            continue;
+        }
+        try {
+            return configRequire.resolve(candidate);
+        } catch  {}
+    }
+};
+const readTsConfig = (configFile, visited = new Set())=>{
+    if (visited.has(configFile) || !external_node_fs_default().existsSync(configFile)) return {};
+    visited.add(configFile);
+    const config = utils_namespaceObject.json5.parse(external_node_fs_default().readFileSync(configFile, 'utf8'));
+    const configDirectory = external_node_path_default().dirname(configFile);
+    const extendsList = Array.isArray(config.extends) ? config.extends : config.extends ? [
+        config.extends
+    ] : [];
+    const baseConfig = extendsList.reduce((merged, request)=>{
+        const resolved = resolveExtends(request, configDirectory);
+        if (!resolved) return merged;
+        const parentConfig = readTsConfig(resolved, visited);
+        return {
+            ...merged,
+            compilerOptions: {
+                ...merged.compilerOptions ?? {},
+                ...parentConfig.compilerOptions ?? {}
+            }
+        };
+    }, {});
+    return {
+        ...baseConfig,
+        compilerOptions: {
+            ...baseConfig.compilerOptions ?? {},
+            ...config.compilerOptions ?? {}
+        }
+    };
+};
+const toRelativeConfigPath = (fromDirectory, target)=>{
+    const relative = toPosixPath(external_node_path_default().relative(fromDirectory, target));
+    if (relative.startsWith('.')) return relative;
+    return `./${relative}`;
+};
+const writeFileIfChanged = (file, content)=>{
+    if (external_node_fs_default().existsSync(file) && external_node_fs_default().readFileSync(file, 'utf8') === content) return;
+    external_node_fs_default().writeFileSync(file, content);
+};
+const createTsgoCheckerConfig = (configFile)=>{
+    const configDirectory = external_node_path_default().dirname(configFile);
+    const checkerConfigDirectory = external_node_path_default().join(configDirectory, TSGO_CHECKER_DIR);
+    const hash = (0, external_node_crypto_namespaceObject.createHash)('sha1').update(configFile).digest('hex').slice(0, 10);
+    const checkerConfigFile = external_node_path_default().join(checkerConfigDirectory, `tsconfig.${hash}.json`);
+    const tsConfig = readTsConfig(configFile);
+    const compilerOptions = {
+        baseUrl: null
+    };
+    const moduleResolution = String(tsConfig.compilerOptions?.moduleResolution).toLowerCase();
+    if ([
+        'node',
+        'node10'
+    ].includes(moduleResolution)) compilerOptions.moduleResolution = null;
+    const checkerConfig = {
+        extends: toRelativeConfigPath(checkerConfigDirectory, configFile),
+        compilerOptions
+    };
+    external_node_fs_default().mkdirSync(checkerConfigDirectory, {
+        recursive: true
+    });
+    writeFileIfChanged(checkerConfigFile, `${JSON.stringify(checkerConfig, null, 2)}\n`);
+    return checkerConfigFile;
+};
+const normalizeTsgoConfig = (config, rootPath)=>{
+    const { typescript } = config;
+    if (typescript?.tsgo === false) return config;
+    const compilerOptions = {
+        ...typescript?.configOverwrite?.compilerOptions ?? {},
+        baseUrl: null
+    };
+    if ([
+        'node',
+        'node10'
+    ].includes(String(compilerOptions.moduleResolution).toLowerCase())) compilerOptions.moduleResolution = null;
+    config.typescript = {
+        ...typescript,
+        configOverwrite: {
+            ...typescript?.configOverwrite ?? {},
+            compilerOptions
+        }
+    };
+    if (typescript?.configFile) config.typescript.configFile = createTsgoCheckerConfig(external_node_path_default().resolve(rootPath, typescript.configFile));
+    return config;
+};
 const withTsgoDefaults = (userOptions, rootPath)=>{
     const tsgoPath = tryResolve(TSGO_PACKAGE, rootPath) ?? builderRequire.resolve(TSGO_PACKAGE);
     const userChain = userOptions ? Array.isArray(userOptions) ? userOptions : [
@@ -63,7 +184,7 @@ const withTsgoDefaults = (userOptions, rootPath)=>{
         (config)=>{
             const { typescript } = config;
             if (typescript?.tsgo === false && typescript.typescriptPath === tsgoPath) typescript.typescriptPath = tryResolve("typescript", rootPath);
-            return config;
+            return normalizeTsgoConfig(config, rootPath);
         }
     ];
 };

package/dist/esm/plugins/rscConfig.mjs

@@ -2,15 +2,148 @@ import path from "path";
 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\.mjs$/;
+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 RSC_COMMON_LAYER = 'rsc-common';
 const ENTRY_NAME_VAR = '__MODERN_JS_ENTRY_NAME';
+const SERVER_ONLY_MARKER_PATTERN = /(?:^|[/\\])server-only[/\\]index\.js(?:\?|$)/;
+const SERVER_ONLY_MESSAGE_PATTERN = /server-only|server only|only works in a Server Component|cannot be imported (?:directly )?(?:from|into) (?:a )?Client Component/i;
+const SERVER_ONLY_DIAGNOSTIC_PREFIX = '[Modern.js RSC server-only diagnostic context]';
 const createVirtualModule = (content)=>`data:text/javascript,${encodeURIComponent(content)}`;
 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;
 };
+const asRecord = (value)=>{
+    if (value && 'object' == typeof value && !Array.isArray(value)) return value;
+};
+const disableReactCompilerInSwcLoaders = (value, seen = new WeakSet())=>{
+    if (!value || 'object' != typeof value) return;
+    if (seen.has(value)) return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value)disableReactCompilerInSwcLoaders(item, seen);
+        return;
+    }
+    const record = value;
+    if ('builtin:swc-loader' === record.loader) {
+        let options = asRecord(record.options);
+        if (!options) {
+            options = {};
+            record.options = options;
+        }
+        let jsc = asRecord(options.jsc);
+        if (!jsc) {
+            jsc = {};
+            options.jsc = jsc;
+        }
+        let transform = asRecord(jsc.transform);
+        if (!transform) {
+            transform = {};
+            jsc.transform = transform;
+        }
+        transform.reactCompiler = false;
+    }
+    for (const item of Object.values(record))disableReactCompilerInSwcLoaders(item, seen);
+};
+const normalizeDiagnosticText = (diagnostic)=>[
+        diagnostic.message,
+        diagnostic.details,
+        diagnostic.file,
+        getModulePath(diagnostic.module),
+        getModuleIdentifier(diagnostic.module)
+    ].filter((item)=>Boolean(item)).join('\n');
+const isServerOnlyDiagnostic = (diagnostic)=>{
+    const text = normalizeDiagnosticText(diagnostic);
+    return SERVER_ONLY_MARKER_PATTERN.test(text) || SERVER_ONLY_MESSAGE_PATTERN.test(text);
+};
+const isEnrichedServerOnlyDiagnostic = (diagnostic)=>diagnostic.message.includes(SERVER_ONLY_DIAGNOSTIC_PREFIX) || diagnostic.details?.includes(SERVER_ONLY_DIAGNOSTIC_PREFIX);
+const getModulePath = (module)=>{
+    if (!module) return;
+    return module.resource || module.nameForCondition?.() || module.userRequest;
+};
+const getModuleIdentifier = (module)=>{
+    if (!module) return;
+    return getModulePath(module) || module.readableIdentifier?.() || module.identifier?.() || module.request || module.rawRequest;
+};
+const formatModuleContext = (module)=>{
+    const id = getModuleIdentifier(module);
+    if (!id) return;
+    const layer = module?.layer ? ` [layer: ${module.layer}]` : '';
+    return `${id}${layer}`;
+};
+const getIssuerChain = (compilation, module)=>{
+    const chain = [];
+    const seen = new Set();
+    let current = module;
+    while(current && !seen.has(current) && chain.length < 8){
+        seen.add(current);
+        const issuer = compilation.moduleGraph?.getIssuer?.(current);
+        const formatted = formatModuleContext(issuer);
+        if (!issuer || !formatted) break;
+        chain.push(formatted);
+        current = issuer;
+    }
+    return chain;
+};
+const getModuleTraceChain = (diagnostic)=>{
+    const trace = diagnostic.moduleTrace || [];
+    const chain = [];
+    for (const item of trace){
+        const formatted = formatModuleContext(item.origin) || item.originName || formatModuleContext(item.module) || item.moduleName;
+        if (formatted && !chain.includes(formatted)) chain.push(formatted);
+    }
+    return chain.slice(0, 8);
+};
+const appendDiagnosticDetails = (diagnostic, lines)=>{
+    const context = `${SERVER_ONLY_DIAGNOSTIC_PREFIX}\n${lines.join('\n')}`;
+    diagnostic.details = diagnostic.details ? `${diagnostic.details}\n\n${context}` : context;
+};
+const enrichServerOnlyDiagnostics = (compilation, environmentName)=>{
+    const diagnostics = [
+        ...compilation.warnings,
+        ...compilation.errors
+    ];
+    for (const diagnostic of diagnostics){
+        if (!isServerOnlyDiagnostic(diagnostic) || isEnrichedServerOnlyDiagnostic(diagnostic)) continue;
+        const lines = [
+            `Environment: ${environmentName || compilation.name || 'unknown'}`
+        ];
+        const markerModule = formatModuleContext(diagnostic.module);
+        if (markerModule) lines.push(`Matched module: ${markerModule}`);
+        const issuerChain = getIssuerChain(compilation, diagnostic.module);
+        const moduleTraceChain = getModuleTraceChain(diagnostic);
+        const importerChain = issuerChain.length > 0 ? issuerChain : moduleTraceChain;
+        if (importerChain.length > 0) lines.push(`Importer chain: ${importerChain.join(' -> ')}`);
+        appendDiagnosticDetails(diagnostic, lines);
+    }
+};
+const applyServerOnlyDiagnosticPlugin = (compiler, environmentName)=>{
+    compiler.hooks.thisCompilation.tap('ModernJsServerOnlyDiagnosticContextPlugin', (compilation)=>{
+        compilation.hooks.processWarnings.tap('ModernJsServerOnlyDiagnosticContextPlugin', (warnings)=>{
+            enrichServerOnlyDiagnostics({
+                errors: compilation.errors,
+                moduleGraph: compilation.moduleGraph,
+                warnings
+            }, environmentName || compilation.name || compiler.name);
+            return warnings;
+        });
+        compilation.hooks.afterSeal.tapPromise('ModernJsServerOnlyDiagnosticContextPlugin', async ()=>{
+            enrichServerOnlyDiagnostics(compilation, environmentName || compilation.name || compiler.name);
+        });
+    });
+};
+const applyServerOnlyDiagnosticPlugins = (compiler, environments)=>{
+    const compilers = 'compilers' in compiler ? compiler.compilers : [
+        compiler
+    ];
+    compilers.forEach((childCompiler, index)=>{
+        const environmentName = childCompiler.name || Object.values(environments).find((environment)=>environment.index === index)?.name;
+        applyServerOnlyDiagnosticPlugin(childCompiler, environmentName);
+    });
+};
 function pluginRscConfig() {
     return {
         name: 'builder:rsc-config',
@@ -26,6 +159,7 @@ function pluginRscConfig() {
             api.modifyBundlerChain({
                 handler: (chain, { isServer })=>{
                     if (isServer) {
+                        chain.resolve.alias.set(`${RENDER_RSC_RUNTIME}$`, RENDER_RSC_WORKER_RUNTIME);
                         const routeFilePattern = /[/\\]routes[/\\](?:.*[/\\])?(?:layout|page|\$)\.[tj]sx?$/;
                         const appFilePattern = /[/\\]App\.[tj]sx?$/;
                         const combinedPattern = new RegExp(`(${routeFilePattern.source}|${appFilePattern.source})`);
@@ -64,6 +198,7 @@ function pluginRscConfig() {
                 }
                 if (config.module?.rules) {
                     const rules = config.module.rules;
+                    disableReactCompilerInSwcLoaders(rules);
                     for (const rule of rules)if (rule.layer === Layers.rsc) {
                         if (rule.exclude) {
                             if (!Array.isArray(rule.exclude)) rule.exclude = [
@@ -80,6 +215,9 @@ function pluginRscConfig() {
                     });
                 }
             });
+            api.onAfterCreateCompiler(({ compiler, environments })=>{
+                applyServerOnlyDiagnosticPlugins(compiler, environments);
+            });
             api.modifyBundlerChain((chain, { isServer, isWebWorker })=>{
                 if (!isServer && !isWebWorker) {
                     const entries = chain.entryPoints.entries();
@@ -117,4 +255,4 @@ async function getRscPlugins(enableRsc, internalDirectory, environments) {
     }
     return [];
 }
-export { getRscPlugins, pluginRscConfig };
+export { enrichServerOnlyDiagnostics, getRscPlugins, pluginRscConfig };

package/dist/esm/shared/parseCommonConfig.mjs

@@ -145,7 +145,7 @@ async function parseCommonConfig(builderConfig, options) {
         const { pluginSourceBuild } = await import("@rsbuild/plugin-source-build");
         rsbuildPlugins.push(pluginSourceBuild(true === sourceBuild ? {} : sourceBuild));
     }
-    rsbuildPlugins.push(pluginReact({
+    rsbuildPlugins.push(pluginReact(options?.disableReactCompiler ? {} : {
         reactCompiler: reactCompiler ?? true
     }));
     if (!disableSvgr) {

package/dist/esm/shared/tsgo.mjs

@@ -1,6 +1,11 @@
+import { createHash } from "node:crypto";
+import node_fs from "node:fs";
 import { createRequire } from "node:module";
+import node_path from "node:path";
+import { json5 } from "@modern-js/utils";
 const builderRequire = createRequire(import.meta.url);
 const TSGO_PACKAGE = "@typescript/native-preview/package.json";
+const TSGO_CHECKER_DIR = node_path.join('.modern-js', 'tsgo');
 const tryResolve = (request, rootPath)=>{
     try {
         return builderRequire.resolve(request, {
@@ -12,6 +17,111 @@ const tryResolve = (request, rootPath)=>{
         return;
     }
 };
+const toPosixPath = (input)=>input.replaceAll(node_path.sep, '/');
+const asTsConfigPath = (request)=>{
+    if (node_path.extname(request)) return [
+        request
+    ];
+    return [
+        request,
+        `${request}.json`
+    ];
+};
+const resolveExtends = (request, configDirectory)=>{
+    const configRequire = createRequire(node_path.join(configDirectory, 'tsconfig.json'));
+    for (const candidate of asTsConfigPath(request)){
+        if (candidate.startsWith('.') || node_path.isAbsolute(candidate)) {
+            const resolved = node_path.resolve(configDirectory, candidate);
+            if (node_fs.existsSync(resolved)) return resolved;
+            continue;
+        }
+        try {
+            return configRequire.resolve(candidate);
+        } catch  {}
+    }
+};
+const readTsConfig = (configFile, visited = new Set())=>{
+    if (visited.has(configFile) || !node_fs.existsSync(configFile)) return {};
+    visited.add(configFile);
+    const config = json5.parse(node_fs.readFileSync(configFile, 'utf8'));
+    const configDirectory = node_path.dirname(configFile);
+    const extendsList = Array.isArray(config.extends) ? config.extends : config.extends ? [
+        config.extends
+    ] : [];
+    const baseConfig = extendsList.reduce((merged, request)=>{
+        const resolved = resolveExtends(request, configDirectory);
+        if (!resolved) return merged;
+        const parentConfig = readTsConfig(resolved, visited);
+        return {
+            ...merged,
+            compilerOptions: {
+                ...merged.compilerOptions ?? {},
+                ...parentConfig.compilerOptions ?? {}
+            }
+        };
+    }, {});
+    return {
+        ...baseConfig,
+        compilerOptions: {
+            ...baseConfig.compilerOptions ?? {},
+            ...config.compilerOptions ?? {}
+        }
+    };
+};
+const toRelativeConfigPath = (fromDirectory, target)=>{
+    const relative = toPosixPath(node_path.relative(fromDirectory, target));
+    if (relative.startsWith('.')) return relative;
+    return `./${relative}`;
+};
+const writeFileIfChanged = (file, content)=>{
+    if (node_fs.existsSync(file) && node_fs.readFileSync(file, 'utf8') === content) return;
+    node_fs.writeFileSync(file, content);
+};
+const createTsgoCheckerConfig = (configFile)=>{
+    const configDirectory = node_path.dirname(configFile);
+    const checkerConfigDirectory = node_path.join(configDirectory, TSGO_CHECKER_DIR);
+    const hash = createHash('sha1').update(configFile).digest('hex').slice(0, 10);
+    const checkerConfigFile = node_path.join(checkerConfigDirectory, `tsconfig.${hash}.json`);
+    const tsConfig = readTsConfig(configFile);
+    const compilerOptions = {
+        baseUrl: null
+    };
+    const moduleResolution = String(tsConfig.compilerOptions?.moduleResolution).toLowerCase();
+    if ([
+        'node',
+        'node10'
+    ].includes(moduleResolution)) compilerOptions.moduleResolution = null;
+    const checkerConfig = {
+        extends: toRelativeConfigPath(checkerConfigDirectory, configFile),
+        compilerOptions
+    };
+    node_fs.mkdirSync(checkerConfigDirectory, {
+        recursive: true
+    });
+    writeFileIfChanged(checkerConfigFile, `${JSON.stringify(checkerConfig, null, 2)}\n`);
+    return checkerConfigFile;
+};
+const normalizeTsgoConfig = (config, rootPath)=>{
+    const { typescript } = config;
+    if (typescript?.tsgo === false) return config;
+    const compilerOptions = {
+        ...typescript?.configOverwrite?.compilerOptions ?? {},
+        baseUrl: null
+    };
+    if ([
+        'node',
+        'node10'
+    ].includes(String(compilerOptions.moduleResolution).toLowerCase())) compilerOptions.moduleResolution = null;
+    config.typescript = {
+        ...typescript,
+        configOverwrite: {
+            ...typescript?.configOverwrite ?? {},
+            compilerOptions
+        }
+    };
+    if (typescript?.configFile) config.typescript.configFile = createTsgoCheckerConfig(node_path.resolve(rootPath, typescript.configFile));
+    return config;
+};
 const withTsgoDefaults = (userOptions, rootPath)=>{
     const tsgoPath = tryResolve(TSGO_PACKAGE, rootPath) ?? builderRequire.resolve(TSGO_PACKAGE);
     const userChain = userOptions ? Array.isArray(userOptions) ? userOptions : [
@@ -28,7 +138,7 @@ const withTsgoDefaults = (userOptions, rootPath)=>{
         (config)=>{
             const { typescript } = config;
             if (typescript?.tsgo === false && typescript.typescriptPath === tsgoPath) typescript.typescriptPath = tryResolve("typescript", rootPath);
-            return config;
+            return normalizeTsgoConfig(config, rootPath);
         }
     ];
 };

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

@@ -7,15 +7,148 @@ var rscConfig_dirname = __rspack_dirname(__rspack_fileURLToPath(import.meta.url)
 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\.mjs$/;
+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 RSC_COMMON_LAYER = 'rsc-common';
 const ENTRY_NAME_VAR = '__MODERN_JS_ENTRY_NAME';
+const SERVER_ONLY_MARKER_PATTERN = /(?:^|[/\\])server-only[/\\]index\.js(?:\?|$)/;
+const SERVER_ONLY_MESSAGE_PATTERN = /server-only|server only|only works in a Server Component|cannot be imported (?:directly )?(?:from|into) (?:a )?Client Component/i;
+const SERVER_ONLY_DIAGNOSTIC_PREFIX = '[Modern.js RSC server-only diagnostic context]';
 const createVirtualModule = (content)=>`data:text/javascript,${encodeURIComponent(content)}`;
 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;
 };
+const asRecord = (value)=>{
+    if (value && 'object' == typeof value && !Array.isArray(value)) return value;
+};
+const disableReactCompilerInSwcLoaders = (value, seen = new WeakSet())=>{
+    if (!value || 'object' != typeof value) return;
+    if (seen.has(value)) return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value)disableReactCompilerInSwcLoaders(item, seen);
+        return;
+    }
+    const record = value;
+    if ('builtin:swc-loader' === record.loader) {
+        let options = asRecord(record.options);
+        if (!options) {
+            options = {};
+            record.options = options;
+        }
+        let jsc = asRecord(options.jsc);
+        if (!jsc) {
+            jsc = {};
+            options.jsc = jsc;
+        }
+        let transform = asRecord(jsc.transform);
+        if (!transform) {
+            transform = {};
+            jsc.transform = transform;
+        }
+        transform.reactCompiler = false;
+    }
+    for (const item of Object.values(record))disableReactCompilerInSwcLoaders(item, seen);
+};
+const normalizeDiagnosticText = (diagnostic)=>[
+        diagnostic.message,
+        diagnostic.details,
+        diagnostic.file,
+        getModulePath(diagnostic.module),
+        getModuleIdentifier(diagnostic.module)
+    ].filter((item)=>Boolean(item)).join('\n');
+const isServerOnlyDiagnostic = (diagnostic)=>{
+    const text = normalizeDiagnosticText(diagnostic);
+    return SERVER_ONLY_MARKER_PATTERN.test(text) || SERVER_ONLY_MESSAGE_PATTERN.test(text);
+};
+const isEnrichedServerOnlyDiagnostic = (diagnostic)=>diagnostic.message.includes(SERVER_ONLY_DIAGNOSTIC_PREFIX) || diagnostic.details?.includes(SERVER_ONLY_DIAGNOSTIC_PREFIX);
+const getModulePath = (module)=>{
+    if (!module) return;
+    return module.resource || module.nameForCondition?.() || module.userRequest;
+};
+const getModuleIdentifier = (module)=>{
+    if (!module) return;
+    return getModulePath(module) || module.readableIdentifier?.() || module.identifier?.() || module.request || module.rawRequest;
+};
+const formatModuleContext = (module)=>{
+    const id = getModuleIdentifier(module);
+    if (!id) return;
+    const layer = module?.layer ? ` [layer: ${module.layer}]` : '';
+    return `${id}${layer}`;
+};
+const getIssuerChain = (compilation, module)=>{
+    const chain = [];
+    const seen = new Set();
+    let current = module;
+    while(current && !seen.has(current) && chain.length < 8){
+        seen.add(current);
+        const issuer = compilation.moduleGraph?.getIssuer?.(current);
+        const formatted = formatModuleContext(issuer);
+        if (!issuer || !formatted) break;
+        chain.push(formatted);
+        current = issuer;
+    }
+    return chain;
+};
+const getModuleTraceChain = (diagnostic)=>{
+    const trace = diagnostic.moduleTrace || [];
+    const chain = [];
+    for (const item of trace){
+        const formatted = formatModuleContext(item.origin) || item.originName || formatModuleContext(item.module) || item.moduleName;
+        if (formatted && !chain.includes(formatted)) chain.push(formatted);
+    }
+    return chain.slice(0, 8);
+};
+const appendDiagnosticDetails = (diagnostic, lines)=>{
+    const context = `${SERVER_ONLY_DIAGNOSTIC_PREFIX}\n${lines.join('\n')}`;
+    diagnostic.details = diagnostic.details ? `${diagnostic.details}\n\n${context}` : context;
+};
+const enrichServerOnlyDiagnostics = (compilation, environmentName)=>{
+    const diagnostics = [
+        ...compilation.warnings,
+        ...compilation.errors
+    ];
+    for (const diagnostic of diagnostics){
+        if (!isServerOnlyDiagnostic(diagnostic) || isEnrichedServerOnlyDiagnostic(diagnostic)) continue;
+        const lines = [
+            `Environment: ${environmentName || compilation.name || 'unknown'}`
+        ];
+        const markerModule = formatModuleContext(diagnostic.module);
+        if (markerModule) lines.push(`Matched module: ${markerModule}`);
+        const issuerChain = getIssuerChain(compilation, diagnostic.module);
+        const moduleTraceChain = getModuleTraceChain(diagnostic);
+        const importerChain = issuerChain.length > 0 ? issuerChain : moduleTraceChain;
+        if (importerChain.length > 0) lines.push(`Importer chain: ${importerChain.join(' -> ')}`);
+        appendDiagnosticDetails(diagnostic, lines);
+    }
+};
+const applyServerOnlyDiagnosticPlugin = (compiler, environmentName)=>{
+    compiler.hooks.thisCompilation.tap('ModernJsServerOnlyDiagnosticContextPlugin', (compilation)=>{
+        compilation.hooks.processWarnings.tap('ModernJsServerOnlyDiagnosticContextPlugin', (warnings)=>{
+            enrichServerOnlyDiagnostics({
+                errors: compilation.errors,
+                moduleGraph: compilation.moduleGraph,
+                warnings
+            }, environmentName || compilation.name || compiler.name);
+            return warnings;
+        });
+        compilation.hooks.afterSeal.tapPromise('ModernJsServerOnlyDiagnosticContextPlugin', async ()=>{
+            enrichServerOnlyDiagnostics(compilation, environmentName || compilation.name || compiler.name);
+        });
+    });
+};
+const applyServerOnlyDiagnosticPlugins = (compiler, environments)=>{
+    const compilers = 'compilers' in compiler ? compiler.compilers : [
+        compiler
+    ];
+    compilers.forEach((childCompiler, index)=>{
+        const environmentName = childCompiler.name || Object.values(environments).find((environment)=>environment.index === index)?.name;
+        applyServerOnlyDiagnosticPlugin(childCompiler, environmentName);
+    });
+};
 function pluginRscConfig() {
     return {
         name: 'builder:rsc-config',
@@ -31,6 +164,7 @@ function pluginRscConfig() {
             api.modifyBundlerChain({
                 handler: (chain, { isServer })=>{
                     if (isServer) {
+                        chain.resolve.alias.set(`${RENDER_RSC_RUNTIME}$`, RENDER_RSC_WORKER_RUNTIME);
                         const routeFilePattern = /[/\\]routes[/\\](?:.*[/\\])?(?:layout|page|\$)\.[tj]sx?$/;
                         const appFilePattern = /[/\\]App\.[tj]sx?$/;
                         const combinedPattern = new RegExp(`(${routeFilePattern.source}|${appFilePattern.source})`);
@@ -69,6 +203,7 @@ function pluginRscConfig() {
                 }
                 if (config.module?.rules) {
                     const rules = config.module.rules;
+                    disableReactCompilerInSwcLoaders(rules);
                     for (const rule of rules)if (rule.layer === Layers.rsc) {
                         if (rule.exclude) {
                             if (!Array.isArray(rule.exclude)) rule.exclude = [
@@ -85,6 +220,9 @@ function pluginRscConfig() {
                     });
                 }
             });
+            api.onAfterCreateCompiler(({ compiler, environments })=>{
+                applyServerOnlyDiagnosticPlugins(compiler, environments);
+            });
             api.modifyBundlerChain((chain, { isServer, isWebWorker })=>{
                 if (!isServer && !isWebWorker) {
                     const entries = chain.entryPoints.entries();
@@ -122,4 +260,4 @@ async function getRscPlugins(enableRsc, internalDirectory, environments) {
     }
     return [];
 }
-export { getRscPlugins, pluginRscConfig };
+export { enrichServerOnlyDiagnostics, getRscPlugins, pluginRscConfig };

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

@@ -146,7 +146,7 @@ async function parseCommonConfig(builderConfig, options) {
         const { pluginSourceBuild } = await import("@rsbuild/plugin-source-build");
         rsbuildPlugins.push(pluginSourceBuild(true === sourceBuild ? {} : sourceBuild));
     }
-    rsbuildPlugins.push(pluginReact({
+    rsbuildPlugins.push(pluginReact(options?.disableReactCompiler ? {} : {
         reactCompiler: reactCompiler ?? true
     }));
     if (!disableSvgr) {

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

@@ -1,7 +1,12 @@
 import "node:module";
+import { createHash } from "node:crypto";
+import node_fs from "node:fs";
 import { createRequire } from "node:module";
+import node_path from "node:path";
+import { json5 } from "@modern-js/utils";
 const builderRequire = createRequire(import.meta.url);
 const TSGO_PACKAGE = "@typescript/native-preview/package.json";
+const TSGO_CHECKER_DIR = node_path.join('.modern-js', 'tsgo');
 const tryResolve = (request, rootPath)=>{
     try {
         return builderRequire.resolve(request, {
@@ -13,6 +18,111 @@ const tryResolve = (request, rootPath)=>{
         return;
     }
 };
+const toPosixPath = (input)=>input.replaceAll(node_path.sep, '/');
+const asTsConfigPath = (request)=>{
+    if (node_path.extname(request)) return [
+        request
+    ];
+    return [
+        request,
+        `${request}.json`
+    ];
+};
+const resolveExtends = (request, configDirectory)=>{
+    const configRequire = createRequire(node_path.join(configDirectory, 'tsconfig.json'));
+    for (const candidate of asTsConfigPath(request)){
+        if (candidate.startsWith('.') || node_path.isAbsolute(candidate)) {
+            const resolved = node_path.resolve(configDirectory, candidate);
+            if (node_fs.existsSync(resolved)) return resolved;
+            continue;
+        }
+        try {
+            return configRequire.resolve(candidate);
+        } catch  {}
+    }
+};
+const readTsConfig = (configFile, visited = new Set())=>{
+    if (visited.has(configFile) || !node_fs.existsSync(configFile)) return {};
+    visited.add(configFile);
+    const config = json5.parse(node_fs.readFileSync(configFile, 'utf8'));
+    const configDirectory = node_path.dirname(configFile);
+    const extendsList = Array.isArray(config.extends) ? config.extends : config.extends ? [
+        config.extends
+    ] : [];
+    const baseConfig = extendsList.reduce((merged, request)=>{
+        const resolved = resolveExtends(request, configDirectory);
+        if (!resolved) return merged;
+        const parentConfig = readTsConfig(resolved, visited);
+        return {
+            ...merged,
+            compilerOptions: {
+                ...merged.compilerOptions ?? {},
+                ...parentConfig.compilerOptions ?? {}
+            }
+        };
+    }, {});
+    return {
+        ...baseConfig,
+        compilerOptions: {
+            ...baseConfig.compilerOptions ?? {},
+            ...config.compilerOptions ?? {}
+        }
+    };
+};
+const toRelativeConfigPath = (fromDirectory, target)=>{
+    const relative = toPosixPath(node_path.relative(fromDirectory, target));
+    if (relative.startsWith('.')) return relative;
+    return `./${relative}`;
+};
+const writeFileIfChanged = (file, content)=>{
+    if (node_fs.existsSync(file) && node_fs.readFileSync(file, 'utf8') === content) return;
+    node_fs.writeFileSync(file, content);
+};
+const createTsgoCheckerConfig = (configFile)=>{
+    const configDirectory = node_path.dirname(configFile);
+    const checkerConfigDirectory = node_path.join(configDirectory, TSGO_CHECKER_DIR);
+    const hash = createHash('sha1').update(configFile).digest('hex').slice(0, 10);
+    const checkerConfigFile = node_path.join(checkerConfigDirectory, `tsconfig.${hash}.json`);
+    const tsConfig = readTsConfig(configFile);
+    const compilerOptions = {
+        baseUrl: null
+    };
+    const moduleResolution = String(tsConfig.compilerOptions?.moduleResolution).toLowerCase();
+    if ([
+        'node',
+        'node10'
+    ].includes(moduleResolution)) compilerOptions.moduleResolution = null;
+    const checkerConfig = {
+        extends: toRelativeConfigPath(checkerConfigDirectory, configFile),
+        compilerOptions
+    };
+    node_fs.mkdirSync(checkerConfigDirectory, {
+        recursive: true
+    });
+    writeFileIfChanged(checkerConfigFile, `${JSON.stringify(checkerConfig, null, 2)}\n`);
+    return checkerConfigFile;
+};
+const normalizeTsgoConfig = (config, rootPath)=>{
+    const { typescript } = config;
+    if (typescript?.tsgo === false) return config;
+    const compilerOptions = {
+        ...typescript?.configOverwrite?.compilerOptions ?? {},
+        baseUrl: null
+    };
+    if ([
+        'node',
+        'node10'
+    ].includes(String(compilerOptions.moduleResolution).toLowerCase())) compilerOptions.moduleResolution = null;
+    config.typescript = {
+        ...typescript,
+        configOverwrite: {
+            ...typescript?.configOverwrite ?? {},
+            compilerOptions
+        }
+    };
+    if (typescript?.configFile) config.typescript.configFile = createTsgoCheckerConfig(node_path.resolve(rootPath, typescript.configFile));
+    return config;
+};
 const withTsgoDefaults = (userOptions, rootPath)=>{
     const tsgoPath = tryResolve(TSGO_PACKAGE, rootPath) ?? builderRequire.resolve(TSGO_PACKAGE);
     const userChain = userOptions ? Array.isArray(userOptions) ? userOptions : [
@@ -29,7 +139,7 @@ const withTsgoDefaults = (userOptions, rootPath)=>{
         (config)=>{
             const { typescript } = config;
             if (typescript?.tsgo === false && typescript.typescriptPath === tsgoPath) typescript.typescriptPath = tryResolve("typescript", rootPath);
-            return config;
+            return normalizeTsgoConfig(config, rootPath);
         }
     ];
 };

package/dist/types/plugins/rscConfig.d.ts

@@ -1,4 +1,35 @@
 import type { RsbuildPlugin } from '@rsbuild/core';
+type RspackDiagnostic = Error & {
+    details?: string;
+    file?: string;
+    module?: DiagnosticModule | null;
+    moduleTrace?: Array<{
+        module?: DiagnosticModule | null;
+        moduleName?: string;
+        origin?: DiagnosticModule | null;
+        originName?: string;
+    }>;
+};
+type DiagnosticModule = {
+    resource?: string;
+    request?: string;
+    userRequest?: string;
+    rawRequest?: string;
+    layer?: string;
+    context?: string;
+    identifier?: () => string;
+    readableIdentifier?: (requestShortener?: unknown) => string;
+    nameForCondition?: () => string | undefined;
+};
+type DiagnosticCompilation = {
+    errors: RspackDiagnostic[];
+    name?: string;
+    moduleGraph?: {
+        getIssuer?: (module: DiagnosticModule) => DiagnosticModule | null;
+    };
+    warnings: RspackDiagnostic[];
+};
+export declare const enrichServerOnlyDiagnostics: (compilation: DiagnosticCompilation, environmentName?: string) => void;
 /**
  * Unified plugin for RSC (React Server Components) configuration
  * Handles:
@@ -25,3 +56,4 @@ export declare function getRscPlugins(enableRsc: boolean, internalDirectory: str
     server?: string;
     client?: string;
 }): Promise<RsbuildPlugin[]>;
+export {};

package/dist/types/types.d.ts

@@ -33,6 +33,11 @@ export type MetaOptions = {
 };
 export type CreateBuilderCommonOptions = {
     frameworkConfigPath?: string;
+    /**
+     * Disable Modern's default React Compiler SWC option for consumers whose
+     * build pipeline does not support Rspack's `jsc.transform.reactCompiler`.
+     */
+    disableReactCompiler?: boolean;
     /** The root path of current project. */
     cwd: string;
     rscClientRuntimePath?: string;
@@ -94,7 +99,7 @@ export type BuilderExtraConfig = {
          */
         devServer?: ToolsDevServerConfig;
         /**
-         * Modify the options of [fork-ts-checker-webpack-plugin](https://github.com/TypeStrong/fork-ts-checker-webpack-plugin).
+         * Modify the options of [ts-checker-rspack-plugin](https://github.com/rstackjs/ts-checker-rspack-plugin).
          */
         tsChecker?: PluginTypeCheckerOptions['tsCheckerOptions'];
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bleedingdev/modern-js-builder",
-  "version": "3.4.0-ultramodern.2",
+  "version": "3.4.0-ultramodern.20",
   "description": "A builder for Modern.js",
   "repository": {
     "type": "git",
@@ -59,7 +59,7 @@
     "rsbuild-plugin-rsc": "0.1.1",
     "rspack-manifest-plugin": "5.2.2",
     "ts-deepmerge": "8.0.0",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.4.0-ultramodern.2"
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.4.0-ultramodern.20"
   },
   "devDependencies": {
     "@rslib/core": "0.23.0",
@@ -68,8 +68,8 @@
     "react": "^19.2.7",
     "terser": "^5.48.0",
     "typescript": "^6.0.3",
-    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.4.0-ultramodern.2",
-    "@scripts/rstest-config": "2.66.0"
+    "@scripts/rstest-config": "2.66.0",
+    "@modern-js/types": "npm:@bleedingdev/modern-js-types@3.4.0-ultramodern.20"
   },
   "publishConfig": {
     "access": "public",