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

package/dist/esm-node/builder/shared/builderPlugins/adapterLazyCompilation.mjs

@@ -0,0 +1,37 @@
+import "node:module";
+import { isUseRsc, logger } from "@modern-js/utils";
+import { aggregateEagerRouteComponentFiles, planRouteEagerLazyCompilation } from "../lazyCompilation.mjs";
+const builderPluginAdapterLazyCompilation = (options)=>({
+        name: 'builder-plugin-adapter-modern-lazy-compilation',
+        setup (api) {
+            api.modifyRsbuildConfig((config)=>{
+                const lazyCompilation = getRouteEagerLazyCompilation(options, config);
+                if (void 0 === lazyCompilation) return config;
+                return {
+                    ...config,
+                    dev: {
+                        ...config.dev,
+                        lazyCompilation
+                    }
+                };
+            });
+        }
+    });
+function getRouteEagerLazyCompilation(options, config) {
+    const current = config.dev?.lazyCompilation;
+    if (!current || isUseRsc(options.normalizedConfig)) return;
+    const plan = planRouteEagerLazyCompilation(current, aggregateEagerRouteComponentFiles(options.eagerRouteComponentFilesByEntry));
+    if (!plan.apply) {
+        if (plan.unresolvedByEntry) warnUnresolvedRouteComponents(options.appContext.appDirectory, plan.unresolvedByEntry);
+        return;
+    }
+    return plan.lazyCompilation;
+}
+const warnedLazyApps = new Set();
+function warnUnresolvedRouteComponents(appDirectory, unresolvedByEntry) {
+    if (warnedLazyApps.has(appDirectory)) return;
+    warnedLazyApps.add(appDirectory);
+    const detail = Array.from(unresolvedByEntry).map(([entry, components])=>`${entry}: ${components.join(', ')}`).join('; ');
+    logger.warn(`[lazyCompilation] Skipped route-eager optimization because some route components could not be resolved to a file (${detail}). Lazy compilation may delay route rendering for these routes.`);
+}
+export { builderPluginAdapterLazyCompilation };

package/dist/esm-node/builder/shared/builderPlugins/adapterSSR.mjs

@@ -1,32 +1,23 @@
 import __rslib_shim_module__ from "node:module";
 const require = /*#__PURE__*/ __rslib_shim_module__.createRequire(/*#__PURE__*/ (()=>import.meta.url)());
 import { SERVICE_WORKER_ENVIRONMENT_NAME, isHtmlDisabled } from "@modern-js/builder";
-import { fs, isUseRsc, isUseSSRBundle, logger } from "@modern-js/utils";
+import { fs, isUseRsc, isUseSSRBundle } from "@modern-js/utils";
 import { mergeRsbuildConfig } from "@rsbuild/core";
 import { getServerCombinedModuleFile } from "../../../plugins/analyze/utils.mjs";
 import { HtmlAsyncChunkPlugin, RouterPlugin } from "../bundlerPlugins/index.mjs";
-import { aggregateEagerRouteComponentFiles, planSSRLazyCompilation } from "../lazyCompilation.mjs";
 import * as __rspack_external_path from "path";
 const builderPluginAdapterSSR = (options)=>({
         name: 'builder-plugin-adapter-modern-ssr',
         setup (api) {
-            const { normalizedConfig, appContext, eagerRouteComponentFilesByEntry } = options;
-            api.modifyRsbuildConfig((config)=>{
-                const merged = mergeRsbuildConfig(config, {
+            const { normalizedConfig, appContext } = options;
+            api.modifyRsbuildConfig((config)=>mergeRsbuildConfig(config, {
                     html: {
                         inject: isStreamingSSR(normalizedConfig) ? 'head' : void 0
                     },
                     server: {
                         compress: isStreamingSSR(normalizedConfig) || isUseRsc(normalizedConfig) ? false : void 0
                     }
-                });
-                const lazyCompilation = getSSRLazyCompilation(merged.dev?.lazyCompilation, normalizedConfig, appContext, eagerRouteComponentFilesByEntry);
-                if (void 0 !== lazyCompilation) merged.dev = {
-                    ...merged.dev,
-                    lazyCompilation
-                };
-                return merged;
-            });
+                }));
             api.modifyBundlerChain(async (chain, { target, isProd, HtmlPlugin: HtmlBundlerPlugin, isServer, environment })=>{
                 const builderConfig = environment.config;
                 const { normalizedConfig } = options;
@@ -62,22 +53,6 @@ const isStreamingSSR = (userConfig)=>{
     }
     return false;
 };
-function getSSRLazyCompilation(current, normalizedConfig, appContext, eagerRouteComponentFilesByEntry) {
-    if (!current || isUseRsc(normalizedConfig) || !isStreamingSSR(normalizedConfig)) return;
-    const plan = planSSRLazyCompilation(current, aggregateEagerRouteComponentFiles(eagerRouteComponentFilesByEntry));
-    if (!plan.apply) {
-        if (plan.unresolvedByEntry) warnUnresolvedRouteComponents(appContext.appDirectory, plan.unresolvedByEntry);
-        return;
-    }
-    return plan.lazyCompilation;
-}
-const warnedLazyApps = new Set();
-function warnUnresolvedRouteComponents(appDirectory, unresolvedByEntry) {
-    if (warnedLazyApps.has(appDirectory)) return;
-    warnedLazyApps.add(appDirectory);
-    const detail = Array.from(unresolvedByEntry).map(([entry, comps])=>`${entry}: ${comps.join(', ')}`).join('; ');
-    logger.warn(`[lazyCompilation] Skipped stream SSR route-eager optimization because some route components could not be resolved to a file (${detail}). Lazy compilation may break first-screen CSS/JS for these routes.`);
-}
 function applyAsyncChunkHtmlPlugin({ chain, modernConfig, HtmlBundlerPlugin }) {
     if (isStreamingSSR(modernConfig) || isUseRsc(modernConfig)) chain.plugin('html-async-chunk').use(HtmlAsyncChunkPlugin, [
         HtmlBundlerPlugin

package/dist/esm-node/builder/shared/builderPlugins/index.mjs

@@ -1,6 +1,7 @@
 import "node:module";
 export * from "./adapterBasic.mjs";
 export * from "./adapterHtml.mjs";
+export * from "./adapterLazyCompilation.mjs";
 export * from "./adapterPrecompress.mjs";
 export * from "./adapterSSR.mjs";
 export * from "./builderHooks.mjs";

package/dist/esm-node/builder/shared/lazyCompilation.mjs

@@ -12,7 +12,7 @@ function aggregateEagerRouteComponentFiles(byEntry) {
         unresolvedByEntry
     };
 }
-function buildSSRLazyCompilationTest(eagerRouteFiles, userTest) {
+function buildRouteEagerLazyCompilationTest(eagerRouteFiles, userTest) {
     const userTestFn = 'function' == typeof userTest ? userTest : userTest instanceof RegExp ? (m)=>userTest.test(m.resource || '') : ()=>true;
     return (m)=>{
         const resource = m.resource;
@@ -21,7 +21,8 @@ function buildSSRLazyCompilationTest(eagerRouteFiles, userTest) {
         return userTestFn(m);
     };
 }
-function planSSRLazyCompilation(current, info) {
+const buildSSRLazyCompilationTest = buildRouteEagerLazyCompilationTest;
+function planRouteEagerLazyCompilation(current, info) {
     if (!current) return {
         apply: false
     };
@@ -38,8 +39,9 @@ function planSSRLazyCompilation(current, info) {
         apply: true,
         lazyCompilation: {
             ...base,
-            test: buildSSRLazyCompilationTest(info.files, userTest)
+            test: buildRouteEagerLazyCompilationTest(info.files, userTest)
         }
     };
 }
-export { aggregateEagerRouteComponentFiles, buildSSRLazyCompilationTest, collectRouteComponentFiles, normalizeModulePath, planSSRLazyCompilation };
+const planSSRLazyCompilation = planRouteEagerLazyCompilation;
+export { aggregateEagerRouteComponentFiles, buildRouteEagerLazyCompilationTest, buildSSRLazyCompilationTest, collectRouteComponentFiles, normalizeModulePath, planRouteEagerLazyCompilation, planSSRLazyCompilation };

package/dist/esm-node/plugins/deploy/index.mjs

@@ -15,7 +15,15 @@ const deployPresets = {
 };
 const getSupportedDeployTargets = ()=>Object.keys(deployPresets);
 const isDeployTarget = (target)=>Object.prototype.hasOwnProperty.call(deployPresets, target);
-const resolveDeployTarget = (modernConfig, envDeployTarget = process.env.MODERNJS_DEPLOY, detectedProvider = provider)=>modernConfig.deploy?.target || envDeployTarget || detectedProvider || 'node';
+const providerDeployTargets = {
+    vercel: 'vercel',
+    netlify: 'netlify',
+    cloudflare: 'cloudflare',
+    cloudflare_pages: 'cloudflare',
+    cloudflare_workers: 'cloudflare'
+};
+const normalizeDetectedProvider = (value)=>value ? providerDeployTargets[value] : void 0;
+const resolveDeployTarget = (modernConfig, envDeployTarget = process.env.MODERNJS_DEPLOY, detectedProvider = provider)=>modernConfig.deploy?.target || envDeployTarget || normalizeDetectedProvider(detectedProvider) || 'node';
 async function getDeployPreset(appContext, modernConfig, deployTarget, api) {
     const { appDirectory, distDirectory, metaName } = appContext;
     const { useSSR, useAPI, useWebServer } = getProjectUsage(appDirectory, distDirectory, metaName);

package/dist/esm-node/plugins/deploy/platforms/cloudflare.mjs

@@ -4,6 +4,8 @@ import { fs } from "@modern-js/utils";
 import { readTemplate } from "../utils/index.mjs";
 const WORKER_ENTRY = 'server/index.mjs';
 const WORKER_MANIFEST = 'server/modern-worker-manifest.json';
+const WRANGLER_CONFIG_FILE = 'wrangler.json';
+const OUTPUT_PACKAGE_FILE = 'package.json';
 const ASSETS_BINDING = 'ASSETS';
 const ROUTE_SPEC_FILE = 'route.json';
 const ROUTE_SPEC_OUTPUT = `server/${ROUTE_SPEC_FILE}`;
@@ -12,10 +14,28 @@ const ROUTE_MANIFEST_FILE = 'routes-manifest.json';
 const PUBLIC_ASSETS_DIRECTORY = 'public';
 const WORKER_BUNDLE_DIRECTORY = 'worker';
 const SERVER_BUNDLE_DIRECTORY = 'bundles';
+const SERVER_OUTPUT_DIRECTORY = 'server';
+const DEFAULT_SERVER_ONLY_PUBLIC_ASSET_EXCLUDES = [
+    'api',
+    'shared'
+];
 const BFF_EFFECT_WORKER_ENTRY = `${WORKER_BUNDLE_DIRECTORY}/__modern_bff_effect.js`;
-const EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE = 'Ensure the Effect BFF entry exists at api/effect/index.ts or bff.effect.entry, and import Cloudflare edge handlers from @modern-js/plugin-bff/effect-edge instead of lambda/Hono server helpers.';
+const EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE = 'Ensure the Effect API entry exists at api/index.ts or bff.effect.entry, and import Cloudflare edge handlers from @modern-js/plugin-bff/effect-edge instead of lambda/Hono server helpers.';
 const DEFAULT_COMPATIBILITY_DATE = '2026-06-02';
 const COMPATIBILITY_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/u;
+const REQUIRED_COMPATIBILITY_FLAGS = [
+    'nodejs_compat',
+    'global_fetch_strictly_public'
+];
+const RESERVED_ARTIFACT_DESTINATION_FILES = new Set([
+    WRANGLER_CONFIG_FILE,
+    OUTPUT_PACKAGE_FILE
+]);
+const RESERVED_ARTIFACT_DESTINATION_DIRECTORIES = new Set([
+    PUBLIC_ASSETS_DIRECTORY,
+    SERVER_OUTPUT_DIRECTORY,
+    WORKER_BUNDLE_DIRECTORY
+]);
 const DEFAULT_SECURITY_HEADERS = {
     referrerPolicy: 'strict-origin-when-cross-origin',
     contentTypeOptions: 'nosniff',
@@ -104,6 +124,13 @@ const getConfiguredWorkerName = (appDirectory, modernConfig)=>{
     const configuredName = modernConfig.deploy?.worker?.name?.trim();
     return configuredName || getWorkerName(appDirectory);
 };
+const normalizeRelativePath = (value, label, scope = 'app output')=>{
+    if ('string' != typeof value) throw new Error(`${label} must be a relative path inside the ${scope}.`);
+    const normalized = value.trim().replace(/\\/g, '/').replace(/^\.\/+/u, '').replace(/\/+$/u, '');
+    const segments = normalized.split('/');
+    if (!normalized || node_path.isAbsolute(normalized) || '.' === normalized || segments.includes('..')) throw new Error(`${label} must be a relative path inside the ${scope}.`);
+    return normalized;
+};
 const normalizeDirectiveValues = (value)=>{
     const values = Array.isArray(value) ? value : [
         value
@@ -196,6 +223,66 @@ const createCloudflareWorkerSecurityPolicy = (modernConfig)=>{
         reason: security?.reason
     };
 };
+const isJsonRecord = (value)=>'object' == typeof value && null !== value && !Array.isArray(value);
+const getConfiguredWrangler = (modernConfig)=>{
+    const wrangler = modernConfig.deploy?.worker?.wrangler;
+    if (void 0 === wrangler) return {};
+    if (!isJsonRecord(wrangler)) throw new Error('deploy.worker.wrangler must be a JSON object.');
+    return wrangler;
+};
+const createWranglerCompatibilityFlags = (configuredFlags)=>{
+    if (void 0 === configuredFlags) return [
+        ...REQUIRED_COMPATIBILITY_FLAGS
+    ];
+    if (!Array.isArray(configuredFlags) || configuredFlags.some((flag)=>'string' != typeof flag)) throw new Error('deploy.worker.wrangler.compatibility_flags must be an array of strings.');
+    return [
+        ...new Set([
+            ...configuredFlags,
+            ...REQUIRED_COMPATIBILITY_FLAGS
+        ])
+    ];
+};
+const createWranglerAssetsConfig = (configuredAssets)=>{
+    if (void 0 !== configuredAssets && !isJsonRecord(configuredAssets)) throw new Error('deploy.worker.wrangler.assets must be an object.');
+    return {
+        ...isJsonRecord(configuredAssets) ? configuredAssets : {},
+        directory: `./${PUBLIC_ASSETS_DIRECTORY}`,
+        binding: ASSETS_BINDING,
+        run_worker_first: true
+    };
+};
+const createWranglerConfig = (appDirectory, modernConfig)=>{
+    const wrangler = getConfiguredWrangler(modernConfig);
+    return {
+        $schema: 'node_modules/wrangler/config-schema.json',
+        name: getConfiguredWorkerName(appDirectory, modernConfig),
+        compatibility_date: getCompatibilityDate(modernConfig),
+        ...wrangler,
+        main: WORKER_ENTRY,
+        compatibility_flags: createWranglerCompatibilityFlags(wrangler.compatibility_flags),
+        assets: createWranglerAssetsConfig(wrangler.assets)
+    };
+};
+const normalizeCloudflareArtifact = (artifact, index)=>{
+    const from = normalizeRelativePath(artifact.from, `deploy.worker.artifacts[${index}].from`, 'app root');
+    const to = normalizeRelativePath(artifact.to, `deploy.worker.artifacts[${index}].to`, 'Cloudflare output');
+    const [topLevelDestination] = to.split('/');
+    const reservedDestination = RESERVED_ARTIFACT_DESTINATION_FILES.has(to) ? to : topLevelDestination;
+    if (RESERVED_ARTIFACT_DESTINATION_FILES.has(to) || RESERVED_ARTIFACT_DESTINATION_DIRECTORIES.has(topLevelDestination)) throw new Error(`deploy.worker.artifacts[${index}].to must not target generated Cloudflare output path ${JSON.stringify(reservedDestination)}.`);
+    return {
+        from,
+        to,
+        index
+    };
+};
+const getCloudflareArtifacts = (modernConfig)=>(modernConfig.deploy?.worker?.artifacts ?? []).map(normalizeCloudflareArtifact);
+const copyCloudflareArtifacts = async (appDirectory, outputDirectory, artifacts)=>{
+    for (const artifact of artifacts){
+        const sourcePath = node_path.join(appDirectory, artifact.from);
+        if (!await fs.pathExists(sourcePath)) throw new Error(`deploy.worker.artifacts[${artifact.index}].from does not exist: ${artifact.from}`);
+        await fs.copy(sourcePath, node_path.join(outputDirectory, artifact.to));
+    }
+};
 const readRouteSpec = async (outputDirectory)=>{
     const routeSpecPath = node_path.join(outputDirectory, ROUTE_SPEC_OUTPUT);
     if (!await fs.pathExists(routeSpecPath)) return {
@@ -207,7 +294,7 @@ const readRouteSpec = async (outputDirectory)=>{
         routes: Array.isArray(routeSpec.routes) ? routeSpec.routes : []
     };
 };
-const createMissingEffectBffWorkerError = (outputDirectory, worker)=>new Error(`Cloudflare Effect BFF is configured, but the BFF worker bundle is missing: ${node_path.join(outputDirectory, worker)}. ${EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE}`);
+const createMissingEffectBffWorkerError = (outputDirectory, worker)=>new Error(`Cloudflare Effect API runtime is configured, but the BFF worker bundle is missing: ${node_path.join(outputDirectory, worker)}. ${EFFECT_BFF_CLOUDFLARE_IMPORT_GUIDANCE}`);
 const createWorkerManifest = async (outputDirectory, modernConfig)=>{
     const routeSpec = await readRouteSpec(outputDirectory);
     const routes = await Promise.all(routeSpec.routes.map(async (route)=>{
@@ -223,9 +310,9 @@ const createWorkerManifest = async (outputDirectory, modernConfig)=>{
     }));
     const bffPrefix = modernConfig.bff?.prefix;
     const primaryBffPrefix = Array.isArray(bffPrefix) ? bffPrefix[0] : bffPrefix;
-    const isEffectBff = Boolean(modernConfig.bff) && modernConfig.bff?.runtimeFramework !== 'hono';
-    const effectBffWorkerExists = await fs.pathExists(node_path.join(outputDirectory, BFF_EFFECT_WORKER_ENTRY));
-    if (isEffectBff && primaryBffPrefix && !effectBffWorkerExists) throw createMissingEffectBffWorkerError(outputDirectory, BFF_EFFECT_WORKER_ENTRY);
+    const isEffectApi = Boolean(modernConfig.bff) && modernConfig.bff?.runtimeFramework !== 'hono';
+    const effectApiWorkerExists = await fs.pathExists(node_path.join(outputDirectory, BFF_EFFECT_WORKER_ENTRY));
+    if (isEffectApi && primaryBffPrefix && !effectApiWorkerExists) throw createMissingEffectBffWorkerError(outputDirectory, BFF_EFFECT_WORKER_ENTRY);
     return {
         version: 1,
         runtime: {
@@ -254,7 +341,7 @@ const createWorkerManifest = async (outputDirectory, modernConfig)=>{
             routeManifest: ROUTE_MANIFEST_FILE
         },
         security: createCloudflareWorkerSecurityPolicy(modernConfig),
-        bff: isEffectBff && primaryBffPrefix && effectBffWorkerExists ? {
+        bff: isEffectApi && primaryBffPrefix && effectApiWorkerExists ? {
             runtimeFramework: 'effect',
             prefix: primaryBffPrefix,
             worker: BFF_EFFECT_WORKER_ENTRY
@@ -277,12 +364,22 @@ const createWorkerModuleLoaders = (manifest)=>{
     ].map(([worker, loader])=>`${JSON.stringify(worker)}: ${loader}`);
     return `{\n${loaders.join(',\n')}\n}`;
 };
-const shouldCopyToPublicAssets = (src, distDirectory)=>{
+const getPublicAssetExcludes = (appDirectory, modernConfig)=>[
+        ...DEFAULT_SERVER_ONLY_PUBLIC_ASSET_EXCLUDES.filter((directory)=>{
+            try {
+                return fs.statSync(node_path.join(appDirectory, directory)).isDirectory();
+            } catch  {
+                return false;
+            }
+        }),
+        ...modernConfig.deploy?.worker?.publicAssetExcludes ?? []
+    ].map((entry)=>normalizeRelativePath(entry, 'deploy.worker.publicAssetExcludes'));
+const shouldCopyToPublicAssets = (src, distDirectory, publicAssetExcludes)=>{
     const relativePath = node_path.relative(distDirectory, src);
     if (!relativePath) return true;
     const normalizedRelativePath = relativePath.replace(/\\/g, '/');
     const [topLevelDirectory] = normalizedRelativePath.split('/');
-    return normalizedRelativePath !== ROUTE_SPEC_FILE && topLevelDirectory !== WORKER_BUNDLE_DIRECTORY && topLevelDirectory !== SERVER_BUNDLE_DIRECTORY;
+    return normalizedRelativePath !== ROUTE_SPEC_FILE && topLevelDirectory !== WORKER_BUNDLE_DIRECTORY && topLevelDirectory !== SERVER_BUNDLE_DIRECTORY && !publicAssetExcludes.some((exclude)=>normalizedRelativePath === exclude || normalizedRelativePath.startsWith(`${exclude}/`));
 };
 const shouldCopyToWorkerBundle = (src, workerBundleDirectory)=>{
     const relativePath = node_path.relative(workerBundleDirectory, src);
@@ -304,15 +401,16 @@ const createCloudflarePreset = ({ appContext, modernConfig })=>{
     const workerEntryPath = node_path.join(outputDirectory, WORKER_ENTRY);
     const workerManifestPath = node_path.join(outputDirectory, WORKER_MANIFEST);
     const routeSpecOutputPath = node_path.join(outputDirectory, ROUTE_SPEC_OUTPUT);
-    const wranglerConfigPath = node_path.join(outputDirectory, 'wrangler.json');
-    const workerName = getConfiguredWorkerName(appDirectory, modernConfig);
+    const wranglerConfigPath = node_path.join(outputDirectory, WRANGLER_CONFIG_FILE);
+    const cloudflareArtifacts = getCloudflareArtifacts(modernConfig);
+    const publicAssetExcludes = getPublicAssetExcludes(appDirectory, modernConfig);
     return {
         async prepare () {
             await fs.remove(outputDirectory);
         },
         async writeOutput () {
             await fs.copy(distDirectory, publicDirectory, {
-                filter: (src)=>shouldCopyToPublicAssets(src, distDirectory)
+                filter: (src)=>shouldCopyToPublicAssets(src, distDirectory, publicAssetExcludes)
             });
             await fs.ensureDir(node_path.dirname(workerEntryPath));
             await fs.ensureDir(node_path.dirname(workerManifestPath));
@@ -328,27 +426,14 @@ const createCloudflarePreset = ({ appContext, modernConfig })=>{
                     type: 'commonjs'
                 });
             }
-            await fs.writeJSON(wranglerConfigPath, {
-                $schema: 'node_modules/wrangler/config-schema.json',
-                name: workerName,
-                main: WORKER_ENTRY,
-                compatibility_date: getCompatibilityDate(modernConfig),
-                compatibility_flags: [
-                    'nodejs_compat',
-                    'global_fetch_strictly_public'
-                ],
-                assets: {
-                    directory: `./${PUBLIC_ASSETS_DIRECTORY}`,
-                    binding: ASSETS_BINDING,
-                    run_worker_first: true
-                }
-            }, {
+            await copyCloudflareArtifacts(appDirectory, outputDirectory, cloudflareArtifacts);
+            await fs.writeJSON(wranglerConfigPath, createWranglerConfig(appDirectory, modernConfig), {
                 spaces: 2
             });
             await fs.writeJSON(workerManifestPath, await createWorkerManifest(outputDirectory, modernConfig), {
                 spaces: 2
             });
-            await fs.writeJSON(node_path.join(outputDirectory, 'package.json'), {
+            await fs.writeJSON(node_path.join(outputDirectory, OUTPUT_PACKAGE_FILE), {
                 type: 'module'
             });
         },

package/dist/esm-node/plugins/deploy/platforms/templates/cloudflare-entry.mjs

@@ -312,6 +312,19 @@ function getRemoteManifestUrl(remote, request) {
     if ('string' != typeof entry || 0 === entry.length) return;
     return new URL(entry, request.url).toString();
 }
+function ensureTrailingSlash(value) {
+    return value.endsWith('/') ? value : `${value}/`;
+}
+function getRemoteAssetBase(remoteManifest, manifestUrl) {
+    const publicPath = 'string' == typeof remoteManifest?.metaData?.publicPath ? remoteManifest.metaData.publicPath : void 0;
+    const fallbackBase = new URL('.', manifestUrl).toString();
+    if (!publicPath || 'auto' === publicPath) return fallbackBase;
+    try {
+        return new URL(ensureTrailingSlash(publicPath), manifestUrl).toString();
+    } catch  {
+        return fallbackBase;
+    }
+}
 async function fetchRemoteJson(jsonUrl) {
     if (!remoteJsonPromises.has(jsonUrl)) remoteJsonPromises.set(jsonUrl, fetch(jsonUrl).then((response)=>{
         if (!response.ok) {
@@ -374,7 +387,7 @@ async function collectRenderedRemoteCssHrefs(html, request, env) {
         if (!manifestUrl) return;
         const remoteManifest = await fetchRemoteJson(manifestUrl);
         const remoteExpose = findRemoteExpose(remoteManifest, expose);
-        const publicPath = 'string' == typeof remoteManifest?.metaData?.publicPath ? remoteManifest.metaData.publicPath : manifestUrl;
+        const publicPath = getRemoteAssetBase(remoteManifest, manifestUrl);
         const remoteRouteManifest = await fetchRemoteJson(new URL('routes-manifest.json', publicPath).toString());
         for (const asset of collectCssAssetEntries(remoteExpose?.assets))hrefs.add(new URL(asset, publicPath).toString());
         for (const asset of collectRouteManifestCssAssets(remoteRouteManifest))hrefs.add(new URL(asset, publicPath).toString());

package/dist/esm-node/rsbuild.mjs

@@ -24,9 +24,13 @@ async function resolveModernRsbuildConfig(options) {
         plugins: modernConfig.builderPlugins
     };
     const appContext = getAppContext();
-    const { rsbuildConfig, rsbuildPlugins } = await parseRspackConfig(nonStandardConfig, {
-        cwd
-    });
+    const builderOptions = {
+        cwd,
+        ...void 0 === options.disableReactCompiler ? {} : {
+            disableReactCompiler: options.disableReactCompiler
+        }
+    };
+    const { rsbuildConfig, rsbuildPlugins } = await parseRspackConfig(nonStandardConfig, builderOptions);
     const adapterParams = {
         appContext,
         normalizedConfig: modernConfig

package/dist/esm-node/utils/initAppContext.mjs

@@ -1,6 +1,17 @@
 import "node:module";
 import { address, fs } from "@modern-js/utils";
 import path from "path";
+function isSymlinkedNodeModules(appDirectory) {
+    try {
+        return fs.lstatSync(path.resolve(appDirectory, 'node_modules')).isSymbolicLink();
+    } catch  {
+        return false;
+    }
+}
+function getDefaultInternalDirectory(appDirectory, metaName) {
+    if (isSymlinkedNodeModules(appDirectory)) return path.resolve(appDirectory, `.${metaName}`);
+    return path.resolve(appDirectory, `./node_modules/.${metaName}`);
+}
 const initAppContext = ({ metaName, appDirectory, runtimeConfigFile, options, tempDir })=>{
     const { apiDir = 'api', sharedDir = 'shared', bffRuntimeFramework = 'hono' } = options || {};
     const pkgPath = path.resolve(appDirectory, './package.json');
@@ -14,7 +25,7 @@ const initAppContext = ({ metaName, appDirectory, runtimeConfigFile, options, te
         lambdaDirectory: path.resolve(appDirectory, apiDir, 'lambda'),
         sharedDirectory: path.resolve(appDirectory, sharedDir),
         serverPlugins: [],
-        internalDirectory: path.resolve(appDirectory, tempDir || `./node_modules/.${metaName}`),
+        internalDirectory: tempDir ? path.resolve(appDirectory, tempDir) : getDefaultInternalDirectory(appDirectory, metaName),
         htmlTemplates: {},
         serverRoutes: [],
         entrypoints: [],

package/dist/types/builder/shared/builderPlugins/adapterLazyCompilation.d.ts

@@ -0,0 +1,3 @@
+import type { RsbuildPlugin } from '@rsbuild/core';
+import type { BuilderOptions } from '../types';
+export declare const builderPluginAdapterLazyCompilation: (options: BuilderOptions) => RsbuildPlugin;

package/dist/types/builder/shared/builderPlugins/index.d.ts

@@ -1,5 +1,6 @@
 export * from './adapterBasic';
 export * from './adapterHtml';
+export * from './adapterLazyCompilation';
 export * from './adapterPrecompress';
 export * from './adapterSSR';
 export * from './builderHooks';

package/dist/types/builder/shared/lazyCompilation.d.ts

@@ -15,8 +15,8 @@ export type EagerRouteComponentInfo = {
  * Aggregate the per-entry route component data (collected by the router plugin
  * during route generation and threaded in as
  * `BuilderOptions.eagerRouteComponentFilesByEntry`) into the flat shape
- * {@link planSSRLazyCompilation} expects: one Set of all route files plus the
- * unresolved specifiers keyed by entry.
+ * {@link planRouteEagerLazyCompilation} expects: one Set of all route files
+ * plus the unresolved specifiers keyed by entry.
  */
 export declare function aggregateEagerRouteComponentFiles(byEntry: EagerRouteComponentFilesByEntry | undefined): EagerRouteComponentInfo;
 /**
@@ -25,7 +25,8 @@ export declare function aggregateEagerRouteComponentFiles(byEntry: EagerRouteCom
  * render time), while delegating all other modules to the user's `test`
  * (defaulting to lazy when the user did not provide one).
  */
-export declare function buildSSRLazyCompilationTest(eagerRouteFiles: Set<string>, userTest?: LazyCompilationTest): LazyCompilationTestFn;
+export declare function buildRouteEagerLazyCompilationTest(eagerRouteFiles: Set<string>, userTest?: LazyCompilationTest): LazyCompilationTestFn;
+export declare const buildSSRLazyCompilationTest: typeof buildRouteEagerLazyCompilationTest;
 export type SSRLazyPlan = {
     apply: false;
     unresolvedByEntry?: Map<string, string[]>;
@@ -34,10 +35,11 @@ export type SSRLazyPlan = {
     lazyCompilation: Record<string, unknown>;
 };
 /**
- * Decide whether to apply the route-eager lazy compilation for an SSR project.
+ * Decide whether to apply route-eager lazy compilation for a project.
  * Checks unresolved route components FIRST: if any exist we cannot guarantee
  * they are eager, so we skip the optimization (and surface them so the caller
  * can warn) rather than silently leaving a route lazy. `current` is the
  * existing `dev.lazyCompilation` value (lazy must be enabled for this to apply).
  */
-export declare function planSSRLazyCompilation(current: unknown, info: EagerRouteComponentInfo): SSRLazyPlan;
+export declare function planRouteEagerLazyCompilation(current: unknown, info: EagerRouteComponentInfo): SSRLazyPlan;
+export declare const planSSRLazyCompilation: typeof planRouteEagerLazyCompilation;

package/dist/types/builder/shared/types.d.ts

@@ -8,9 +8,9 @@ export type BuilderOptions = {
      * Route component files collected from the FINAL file-system routes (after
      * all `modifyFileSystemRoutes` consumers ran), keyed by entry name. Populated
      * by the router plugin during route generation and threaded in here (read
-     * FRESH from the app context AFTER `generateEntryCode` runs) so the SSR
-     * builder plugin can force route component chunks eager under lazy
-     * compilation. Explicit param instead of a direct `_internalContext` read.
+     * FRESH from the app context AFTER `generateEntryCode` runs) so builder
+     * plugins can force route component chunks eager under lazy compilation.
+     * Explicit param instead of a direct `_internalContext` read.
      */
     eagerRouteComponentFilesByEntry?: EagerRouteComponentFilesByEntry;
 };

package/dist/types/rsbuild.d.ts

@@ -3,6 +3,7 @@ type ResolveModernRsbuildConfigOptions = {
     command: string;
     configPath?: string;
     cwd?: string;
+    disableReactCompiler?: boolean;
     metaName?: string;
     modifyModernConfig?: (config: AppUserConfig) => AppUserConfig | Promise<AppUserConfig>;
 };

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

@@ -1,5 +1,19 @@
 export type DeployTarget = 'node' | 'vercel' | 'netlify' | 'ghPages' | 'cloudflare';
 export type CloudflareWorkerSecurityCspMode = 'enforce' | 'report-only' | 'off';
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export interface CloudflareWorkerArtifactConfig {
+    /**
+     * Source file or directory, relative to the app root, to copy into
+     * `.output` after framework output has been staged.
+     */
+    from: string;
+    /**
+     * Destination path relative to `.output`.
+     */
+    to: string;
+}
 export interface CloudflareWorkerSecurityCspConfig {
     mode?: CloudflareWorkerSecurityCspMode;
     directives?: Record<string, string[] | string | false>;

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

@@ -1,5 +1,5 @@
-import type { CloudflareWorkerSecurityConfig, DeployTarget } from './cloudflareDeploy';
-export type { CloudflareWorkerSecurityConfig, CloudflareWorkerSecurityCorsConfig, CloudflareWorkerSecurityCspConfig, CloudflareWorkerSecurityCspMode, CloudflareWorkerSecurityNoindexConfig, DeployTarget, } from './cloudflareDeploy';
+import type { CloudflareWorkerArtifactConfig, CloudflareWorkerSecurityConfig, DeployTarget, JsonValue } from './cloudflareDeploy';
+export type { CloudflareWorkerArtifactConfig, CloudflareWorkerSecurityConfig, CloudflareWorkerSecurityCorsConfig, CloudflareWorkerSecurityCspConfig, CloudflareWorkerSecurityCspMode, CloudflareWorkerSecurityNoindexConfig, DeployTarget, JsonValue, } from './cloudflareDeploy';
 export interface MicroFrontend {
     /**
      * Specifies whether to enable the HTML entry.
@@ -36,5 +36,24 @@ export interface DeployUserConfig {
         compatibilityDate?: string;
         ssr?: boolean;
         security?: CloudflareWorkerSecurityConfig;
+        /**
+         * Raw Wrangler-compatible config merged into `.output/wrangler.json`.
+         * Framework-owned worker invariants still win for `main`, the assets
+         * binding/directory/run mode, and required compatibility flags.
+         */
+        wrangler?: Record<string, JsonValue>;
+        /**
+         * Additional app-root files or directories to stage under `.output`.
+         * Use this for provider resources such as migrations or generated config.
+         */
+        artifacts?: CloudflareWorkerArtifactConfig[];
+        /**
+         * Dist output paths that must not be copied into Cloudflare public assets.
+         * Entries are slash-normalized path prefixes relative to the app dist root.
+         * Top-level `api` and `shared` dist directories are excluded when matching
+         * source directories exist in the app root because they conventionally
+         * contain server-only implementation code.
+         */
+        publicAssetExcludes?: string[];
     };
 }