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

package/dist/esm/builder/generator/getBuilderEnvironments.mjs

@@ -94,13 +94,53 @@ function getCloudflareWorkerNodeExternals() {
 function getEffectBffEntry(normalizedConfig, appContext) {
     if (!normalizedConfig.bff || 'hono' === normalizedConfig.bff.runtimeFramework) return;
     const configuredEntry = normalizedConfig.bff.effect?.entry;
-    const entryWithoutOrWithExtension = configuredEntry ? node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appContext.appDirectory, configuredEntry) : node_path.resolve(appContext.apiDirectory, 'effect', 'index');
-    return resolveJsOrTsEntry(entryWithoutOrWithExtension);
+    if (configuredEntry) {
+        const entryWithoutOrWithExtension = node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appContext.appDirectory, configuredEntry);
+        return resolveJsOrTsEntry(entryWithoutOrWithExtension);
+    }
+    return resolveJsOrTsEntry(node_path.resolve(appContext.apiDirectory, 'index'));
 }
 function isCloudflareWorkerDeploy(normalizedConfig) {
     return normalizedConfig.deploy?.target === 'cloudflare' || 'cloudflare' === process.env.MODERNJS_DEPLOY;
 }
+function getConsumingReactRuntimeAliases(appContext) {
+    const resolvePaths = [
+        appContext.appDirectory,
+        process.cwd()
+    ];
+    return {
+        react$: resolvePackageFile('react', 'index.js', resolvePaths),
+        'react/jsx-runtime$': resolvePackageFile('react', 'jsx-runtime.js', resolvePaths),
+        'react/jsx-dev-runtime$': resolvePackageFile('react', 'jsx-dev-runtime.js', resolvePaths),
+        'react/compiler-runtime$': resolvePackageFile('react', 'compiler-runtime.js', resolvePaths)
+    };
+}
+function setResolvedAliases(alias, aliases) {
+    for (const [name, value] of Object.entries(aliases))setAliasIfPresent(alias, name, value);
+}
+function appendBundlerChain(config, handler) {
+    const bundlerChain = config.tools?.bundlerChain;
+    config.tools = {
+        ...config.tools,
+        bundlerChain: bundlerChain ? Array.isArray(bundlerChain) ? [
+            ...bundlerChain,
+            handler
+        ] : [
+            bundlerChain,
+            handler
+        ] : handler
+    };
+}
+function applySourceBuildReactRuntimeAliases(normalizedConfig, appContext, tempBuilderConfig) {
+    if (!normalizedConfig.experiments?.sourceBuild) return;
+    const aliases = getConsumingReactRuntimeAliases(appContext);
+    if (!Object.values(aliases).some(Boolean)) return;
+    appendBundlerChain(tempBuilderConfig, (chain)=>{
+        setResolvedAliases(chain.resolve.alias, aliases);
+    });
+}
 function getBuilderEnvironments(normalizedConfig, appContext, tempBuilderConfig) {
+    applySourceBuildReactRuntimeAliases(normalizedConfig, appContext, tempBuilderConfig);
     const entries = {};
     const { entrypoints = [], checkedEntries } = appContext;
     for (const { entryName, internalEntry, entry } of entrypoints){
@@ -147,7 +187,7 @@ function getBuilderEnvironments(normalizedConfig, appContext, tempBuilderConfig)
     const useWorkerTarget = isServiceWorker(normalizedConfig);
     if (useWorkerTarget) {
         const useCloudflareModuleWorker = isCloudflareWorkerDeploy(normalizedConfig);
-        const effectBffEntry = useCloudflareModuleWorker ? getEffectBffEntry(normalizedConfig, appContext) : void 0;
+        const effectApiEntry = useCloudflareModuleWorker ? getEffectBffEntry(normalizedConfig, appContext) : void 0;
         const tanstackRouterSsrServerFile = useCloudflareModuleWorker ? resolvePackageFile('@tanstack/router-core', 'dist/esm/ssr/ssr-server.js', [
             appContext.appDirectory,
             process.cwd()
@@ -189,10 +229,10 @@ function getBuilderEnvironments(normalizedConfig, appContext, tempBuilderConfig)
         const fsPromisesWorkerFile = useCloudflareModuleWorker ? getCloudflareWorkerCompatFile('cloudflare-worker-fs-promises.mjs') : void 0;
         const pathWorkerFile = useCloudflareModuleWorker ? getCloudflareWorkerCompatFile('cloudflare-worker-path.mjs') : void 0;
         const baseWorkerEntries = useCloudflareModuleWorker ? cloudflareWorkerServerEntries : serverEntries;
-        const workerEntries = effectBffEntry ? {
+        const workerEntries = effectApiEntry ? {
             ...baseWorkerEntries,
             [BFF_EFFECT_WORKER_ENTRY_NAME]: [
-                `${effectBffEntry}?${BFF_EFFECT_WORKER_RUNTIME_QUERY}`
+                `${effectApiEntry}?${BFF_EFFECT_WORKER_RUNTIME_QUERY}`
             ]
         } : baseWorkerEntries;
         environments[SERVICE_WORKER_ENVIRONMENT_NAME] = {

package/dist/esm/builder/generator/index.mjs

@@ -1,6 +1,6 @@
 import { createBuilder } from "@modern-js/builder";
 import { mergeRsbuildConfig } from "@rsbuild/core";
-import { builderPluginAdapterBasic, builderPluginAdapterHooks, builderPluginAdapterHtml, builderPluginAdapterPrecompress, builderPluginAdapterSSR } from "../shared/builderPlugins/index.mjs";
+import { builderPluginAdapterBasic, builderPluginAdapterHooks, builderPluginAdapterHtml, builderPluginAdapterLazyCompilation, builderPluginAdapterPrecompress, builderPluginAdapterSSR } from "../shared/builderPlugins/index.mjs";
 import { builderPluginAdapterCopy } from "./adapterCopy.mjs";
 import { createBuilderProviderConfig } from "./createBuilderProviderConfig.mjs";
 import { getBuilderEnvironments } from "./getBuilderEnvironments.mjs";
@@ -38,6 +38,7 @@ async function generateBuilder(options, bundlerType) {
 async function applyBuilderPlugins(builder, options) {
     builder.addPlugins([
         builderPluginAdapterBasic(options),
+        builderPluginAdapterLazyCompilation(options),
         builderPluginAdapterSSR(options),
         builderPluginAdapterHtml(options),
         builderPluginAdapterPrecompress(options),

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

@@ -0,0 +1,36 @@
+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/builder/shared/builderPlugins/adapterSSR.mjs

@@ -1,30 +1,21 @@
 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;
@@ -60,22 +51,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/builder/shared/builderPlugins/index.mjs

@@ -1,5 +1,6 @@
 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/builder/shared/lazyCompilation.mjs

@@ -11,7 +11,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;
@@ -20,7 +20,8 @@ function buildSSRLazyCompilationTest(eagerRouteFiles, userTest) {
         return userTestFn(m);
     };
 }
-function planSSRLazyCompilation(current, info) {
+const buildSSRLazyCompilationTest = buildRouteEagerLazyCompilationTest;
+function planRouteEagerLazyCompilation(current, info) {
     if (!current) return {
         apply: false
     };
@@ -37,8 +38,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/plugins/deploy/index.mjs

@@ -14,7 +14,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/plugins/deploy/platforms/cloudflare.mjs

@@ -3,6 +3,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}`;
@@ -11,10 +13,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',
@@ -103,6 +123,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
@@ -195,6 +222,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 {
@@ -206,7 +293,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)=>{
@@ -222,9 +309,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: {
@@ -253,7 +340,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
@@ -276,12 +363,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);
@@ -303,15 +400,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));
@@ -327,27 +425,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/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/rsbuild.mjs

@@ -23,9 +23,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/utils/initAppContext.mjs

@@ -1,5 +1,16 @@
 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');
@@ -13,7 +24,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/esm-node/builder/generator/getBuilderEnvironments.mjs

@@ -99,13 +99,53 @@ function getCloudflareWorkerNodeExternals() {
 function getEffectBffEntry(normalizedConfig, appContext) {
     if (!normalizedConfig.bff || 'hono' === normalizedConfig.bff.runtimeFramework) return;
     const configuredEntry = normalizedConfig.bff.effect?.entry;
-    const entryWithoutOrWithExtension = configuredEntry ? node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appContext.appDirectory, configuredEntry) : node_path.resolve(appContext.apiDirectory, 'effect', 'index');
-    return resolveJsOrTsEntry(entryWithoutOrWithExtension);
+    if (configuredEntry) {
+        const entryWithoutOrWithExtension = node_path.isAbsolute(configuredEntry) ? configuredEntry : node_path.resolve(appContext.appDirectory, configuredEntry);
+        return resolveJsOrTsEntry(entryWithoutOrWithExtension);
+    }
+    return resolveJsOrTsEntry(node_path.resolve(appContext.apiDirectory, 'index'));
 }
 function isCloudflareWorkerDeploy(normalizedConfig) {
     return normalizedConfig.deploy?.target === 'cloudflare' || 'cloudflare' === process.env.MODERNJS_DEPLOY;
 }
+function getConsumingReactRuntimeAliases(appContext) {
+    const resolvePaths = [
+        appContext.appDirectory,
+        process.cwd()
+    ];
+    return {
+        react$: resolvePackageFile('react', 'index.js', resolvePaths),
+        'react/jsx-runtime$': resolvePackageFile('react', 'jsx-runtime.js', resolvePaths),
+        'react/jsx-dev-runtime$': resolvePackageFile('react', 'jsx-dev-runtime.js', resolvePaths),
+        'react/compiler-runtime$': resolvePackageFile('react', 'compiler-runtime.js', resolvePaths)
+    };
+}
+function setResolvedAliases(alias, aliases) {
+    for (const [name, value] of Object.entries(aliases))setAliasIfPresent(alias, name, value);
+}
+function appendBundlerChain(config, handler) {
+    const bundlerChain = config.tools?.bundlerChain;
+    config.tools = {
+        ...config.tools,
+        bundlerChain: bundlerChain ? Array.isArray(bundlerChain) ? [
+            ...bundlerChain,
+            handler
+        ] : [
+            bundlerChain,
+            handler
+        ] : handler
+    };
+}
+function applySourceBuildReactRuntimeAliases(normalizedConfig, appContext, tempBuilderConfig) {
+    if (!normalizedConfig.experiments?.sourceBuild) return;
+    const aliases = getConsumingReactRuntimeAliases(appContext);
+    if (!Object.values(aliases).some(Boolean)) return;
+    appendBundlerChain(tempBuilderConfig, (chain)=>{
+        setResolvedAliases(chain.resolve.alias, aliases);
+    });
+}
 function getBuilderEnvironments(normalizedConfig, appContext, tempBuilderConfig) {
+    applySourceBuildReactRuntimeAliases(normalizedConfig, appContext, tempBuilderConfig);
     const entries = {};
     const { entrypoints = [], checkedEntries } = appContext;
     for (const { entryName, internalEntry, entry } of entrypoints){
@@ -152,7 +192,7 @@ function getBuilderEnvironments(normalizedConfig, appContext, tempBuilderConfig)
     const useWorkerTarget = isServiceWorker(normalizedConfig);
     if (useWorkerTarget) {
         const useCloudflareModuleWorker = isCloudflareWorkerDeploy(normalizedConfig);
-        const effectBffEntry = useCloudflareModuleWorker ? getEffectBffEntry(normalizedConfig, appContext) : void 0;
+        const effectApiEntry = useCloudflareModuleWorker ? getEffectBffEntry(normalizedConfig, appContext) : void 0;
         const tanstackRouterSsrServerFile = useCloudflareModuleWorker ? resolvePackageFile('@tanstack/router-core', 'dist/esm/ssr/ssr-server.js', [
             appContext.appDirectory,
             process.cwd()
@@ -194,10 +234,10 @@ function getBuilderEnvironments(normalizedConfig, appContext, tempBuilderConfig)
         const fsPromisesWorkerFile = useCloudflareModuleWorker ? getCloudflareWorkerCompatFile('cloudflare-worker-fs-promises.mjs') : void 0;
         const pathWorkerFile = useCloudflareModuleWorker ? getCloudflareWorkerCompatFile('cloudflare-worker-path.mjs') : void 0;
         const baseWorkerEntries = useCloudflareModuleWorker ? cloudflareWorkerServerEntries : serverEntries;
-        const workerEntries = effectBffEntry ? {
+        const workerEntries = effectApiEntry ? {
             ...baseWorkerEntries,
             [BFF_EFFECT_WORKER_ENTRY_NAME]: [
-                `${effectBffEntry}?${BFF_EFFECT_WORKER_RUNTIME_QUERY}`
+                `${effectApiEntry}?${BFF_EFFECT_WORKER_RUNTIME_QUERY}`
             ]
         } : baseWorkerEntries;
         environments[SERVICE_WORKER_ENVIRONMENT_NAME] = {

package/dist/esm-node/builder/generator/index.mjs

@@ -1,7 +1,7 @@
 import "node:module";
 import { createBuilder } from "@modern-js/builder";
 import { mergeRsbuildConfig } from "@rsbuild/core";
-import { builderPluginAdapterBasic, builderPluginAdapterHooks, builderPluginAdapterHtml, builderPluginAdapterPrecompress, builderPluginAdapterSSR } from "../shared/builderPlugins/index.mjs";
+import { builderPluginAdapterBasic, builderPluginAdapterHooks, builderPluginAdapterHtml, builderPluginAdapterLazyCompilation, builderPluginAdapterPrecompress, builderPluginAdapterSSR } from "../shared/builderPlugins/index.mjs";
 import { builderPluginAdapterCopy } from "./adapterCopy.mjs";
 import { createBuilderProviderConfig } from "./createBuilderProviderConfig.mjs";
 import { getBuilderEnvironments } from "./getBuilderEnvironments.mjs";
@@ -39,6 +39,7 @@ async function generateBuilder(options, bundlerType) {
 async function applyBuilderPlugins(builder, options) {
     builder.addPlugins([
         builderPluginAdapterBasic(options),
+        builderPluginAdapterLazyCompilation(options),
         builderPluginAdapterSSR(options),
         builderPluginAdapterHtml(options),
         builderPluginAdapterPrecompress(options),