@bleedingdev/modern-js-ultramodern-app-tools 0.0.0 → 3.9.0-ultramodern.5

package/dist/cjs/native-composition/ssr-integration-plugin.js

@@ -0,0 +1,145 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+const getRspackPlugins = (rspackConfig)=>{
+    if (!rspackConfig) return [];
+    const rspackEntries = Array.isArray(rspackConfig) ? rspackConfig : [
+        rspackConfig
+    ];
+    const plugins = [];
+    for (const entry of rspackEntries){
+        if (!entry || 'function' == typeof entry || 'object' != typeof entry) continue;
+        const maybePlugins = entry.plugins;
+        if (Array.isArray(maybePlugins)) {
+            for (const plugin of maybePlugins)if (plugin) plugins.push(plugin);
+        }
+    }
+    return plugins;
+};
+const getRspackPluginName = (plugin)=>{
+    if ('string' == typeof plugin) return plugin;
+    if ('function' == typeof plugin) return plugin.name;
+    if (Array.isArray(plugin)) {
+        const [first] = plugin;
+        if (!first) return;
+        if ('string' == typeof first) return first;
+        if ('function' == typeof first) return first.name;
+        if ('object' == typeof first) return first.name || first.constructor?.name;
+        return;
+    }
+    return plugin.name || plugin.constructor?.name;
+};
+const hasServerRenderingConfig = (userConfig)=>{
+    const { output, server } = userConfig;
+    if (output?.ssg) return true;
+    if (output?.ssgByEntries && Object.keys(output.ssgByEntries).length > 0) return true;
+    if (server?.ssr) return true;
+    if (server?.ssrByEntries && Object.keys(server.ssrByEntries).length > 0) return true;
+    return false;
+};
+const isModuleFederationAppSSREnabledInConfig = (ssr)=>{
+    if (!ssr || 'object' != typeof ssr) return false;
+    return true === ssr.moduleFederationAppSSR;
+};
+const isModuleFederationAppSSREnabled = (userConfig)=>{
+    if (isModuleFederationAppSSREnabledInConfig(userConfig.server?.ssr)) return true;
+    if (userConfig.server?.ssrByEntries && 'object' == typeof userConfig.server.ssrByEntries) return Object.values(userConfig.server.ssrByEntries).some(isModuleFederationAppSSREnabledInConfig);
+    return false;
+};
+const isModuleFederationRspackPlugin = (plugin)=>{
+    const candidate = getRspackPluginName(plugin);
+    return 'string' == typeof candidate && /modulefederation/i.test(candidate);
+};
+const hasModuleFederationMarker = (config)=>{
+    if ('true' === process.env.MF_SSR_PRJ) return true;
+    const define = config.source?.define || {};
+    if ('REMOTE_IP_STRATEGY' in define || 'FEDERATION_IPV4' in define) return true;
+    const plugins = getRspackPlugins(config.tools?.rspack);
+    return plugins.some(isModuleFederationRspackPlugin);
+};
+const isNodeEnvironmentTarget = (target)=>'string' == typeof target && ('node' === target || 'async-node' === target || target.startsWith('node'));
+const shouldUseModuleFederationNodeOutput = (config)=>isNodeEnvironmentTarget(config.output?.target) && hasModuleFederationMarker(config);
+const ssrIntegrationBuilderPlugin = (modernAPI)=>({
+        name: '@modern-js/ultramodern-builder-plugin-ssr',
+        pre: [
+            '@modern-js/builder-plugin-ssr'
+        ],
+        setup (api) {
+            api.modifyEnvironmentConfig((config, { name, mergeEnvironmentConfig })=>{
+                const isServerEnvironment = isNodeEnvironmentTarget(config.output.target) || 'workerSSR' === name;
+                const userConfig = modernAPI.getNormalizedConfig();
+                const hasServerRendering = hasServerRenderingConfig(userConfig);
+                const hasModuleFederationRuntimeMarker = hasServerRendering && shouldUseModuleFederationNodeOutput(config);
+                const hasExplicitMfSsrFlag = isModuleFederationAppSSREnabled(userConfig);
+                const requireExplicitMfSsrFlag = 'true' === process.env.MODERN_MF_APP_SSR_REQUIRE_EXPLICIT;
+                if (hasServerRendering && hasModuleFederationRuntimeMarker && !hasExplicitMfSsrFlag) {
+                    const warningMessage = '[modernjs][mf-ssr] Module Federation SSR was auto-detected from runtime markers. Set server.ssr.moduleFederationAppSSR=true explicitly in host and remotes to avoid heuristic drift.';
+                    if (requireExplicitMfSsrFlag) throw new Error(`${warningMessage} (enforced by MODERN_MF_APP_SSR_REQUIRE_EXPLICIT=true)`);
+                    console.warn(warningMessage);
+                }
+                const isModuleFederationAppSSR = hasServerRendering && hasExplicitMfSsrFlag;
+                return mergeEnvironmentConfig(config, {
+                    source: {
+                        define: {
+                            'process.env.MODERN_MF_APP_SSR': JSON.stringify(String(isModuleFederationAppSSR))
+                        }
+                    },
+                    ...'workerSSR' === name && userConfig.deploy?.target === 'cloudflare' ? {
+                        output: {
+                            module: true
+                        }
+                    } : {},
+                    splitChunks: isServerEnvironment && (hasModuleFederationRuntimeMarker || hasExplicitMfSsrFlag) ? false : void 0
+                });
+            });
+        }
+    });
+const ultramodernSSRIntegrationPlugin = ()=>({
+        name: '@modern-js/ultramodern-ssr-integration',
+        setup (api) {
+            api.config(()=>({
+                    builderPlugins: [
+                        ssrIntegrationBuilderPlugin(api)
+                    ]
+                }));
+        }
+    });
+__webpack_require__.d(__webpack_exports__, {}, {
+    shouldUseModuleFederationNodeOutput: shouldUseModuleFederationNodeOutput,
+    ultramodernSSRIntegrationPlugin: ultramodernSSRIntegrationPlugin
+});
+exports.shouldUseModuleFederationNodeOutput = __webpack_exports__.shouldUseModuleFederationNodeOutput;
+exports.ultramodernSSRIntegrationPlugin = __webpack_exports__.ultramodernSSRIntegrationPlugin;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "shouldUseModuleFederationNodeOutput",
+    "ultramodernSSRIntegrationPlugin"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/native-composition/types.js

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/esm/native-composition/index.mjs

@@ -0,0 +1,56 @@
+import { appTools } from "@modern-js/app-tools";
+import backend_federation_build from "@modern-js/app-tools-extensions/backend-federation-build";
+import { createCloudflareBuilderPlugin } from "@modern-js/app-tools-extensions/cloudflare-builder";
+import { createDeployOutputAliasesPlugin } from "@modern-js/app-tools-extensions/deploy-output/plugin";
+import { ultramodernI18nIntegrationPlugin } from "@modern-js/i18n-integration";
+import { ultramodernReleaseEnvelopePlugin } from "./release-envelope-plugin.mjs";
+import { ultramodernRouterIntegrationPlugin } from "./router-integration-plugin.mjs";
+import { rscDisabledRuntimePlugin } from "./rsc-disabled-plugin.mjs";
+import { ultramodernSSRIntegrationPlugin } from "./ssr-integration-plugin.mjs";
+const ultramodernAppTools = ()=>({
+        name: '@modern-js/ultramodern-app-tools',
+        usePlugins: [
+            appTools(),
+            ultramodernI18nIntegrationPlugin(),
+            ultramodernRouterIntegrationPlugin(),
+            ultramodernSSRIntegrationPlugin(),
+            backend_federation_build(),
+            createCloudflareBuilderPlugin(),
+            createDeployOutputAliasesPlugin(),
+            ultramodernReleaseEnvelopePlugin()
+        ],
+        setup (api) {
+            api.modifyResolvedConfig((config)=>{
+                if (config.server?.rsc) return config;
+                return {
+                    ...config,
+                    builderPlugins: [
+                        ...config.builderPlugins ?? [],
+                        rscDisabledRuntimePlugin()
+                    ]
+                };
+            });
+            api._internalServerPlugins(({ plugins })=>{
+                const name = '@modern-js/ultramodern-app-tools/server-plugin';
+                if (!plugins.some((plugin)=>plugin.name === name)) plugins.push({
+                    name
+                });
+                return {
+                    plugins
+                };
+            });
+            api._internalRuntimePlugins(({ entrypoint, plugins })=>{
+                plugins.push({
+                    name: 'rendererHead',
+                    path: '@modern-js/runtime-renderer-extensions',
+                    config: {}
+                });
+                return {
+                    entrypoint,
+                    plugins
+                };
+            });
+        }
+    });
+export { createPresetUltramodernConfig, presetUltramodern } from "./preset.mjs";
+export { ultramodernAppTools, ultramodernReleaseEnvelopePlugin };

package/dist/esm/native-composition/preset.mjs

@@ -0,0 +1,126 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { builderPluginAdapterPrecompress } from "@modern-js/app-tools-extensions/build-config/precompress/plugin";
+import { resolveEffectTsgoCompiler } from "@modern-js/app-tools-extensions/config";
+import { configureUltramodernTypeChecker } from "@modern-js/app-tools-extensions/native-type-checker";
+import { resolveUltramodernReleaseIdentity } from "@modern-js/app-tools-extensions/release-identity";
+import { mergeConfig } from "@modern-js/plugin/cli";
+import { rspack } from "@rsbuild/core";
+const DEFAULT_OTLP_ENDPOINT = 'http://127.0.0.1:4318/v1/logs';
+const DEFAULT_VICTORIA_METRICS_ENDPOINT = 'http://127.0.0.1:8428/api/v1/import/prometheus';
+const resolveReactRouterPackageDir = (appDirectory)=>{
+    const resolveNodeModulePackageJson = (packageName, fromDirectory)=>{
+        let currentDirectory = node_path.resolve(fromDirectory);
+        while(true){
+            const packageJson = node_path.join(currentDirectory, 'node_modules', packageName, 'package.json');
+            if (node_fs.existsSync(packageJson)) return node_fs.realpathSync(packageJson);
+            const parentDirectory = node_path.dirname(currentDirectory);
+            if (parentDirectory === currentDirectory) return;
+            currentDirectory = parentDirectory;
+        }
+    };
+    const reactRouterPackageJson = resolveNodeModulePackageJson('react-router', appDirectory);
+    if (reactRouterPackageJson) return node_path.dirname(reactRouterPackageJson);
+    const reactRouterDomPackageJson = resolveNodeModulePackageJson('react-router-dom', appDirectory);
+    if (!reactRouterDomPackageJson) return;
+    const nestedReactRouterPackageJson = resolveNodeModulePackageJson('react-router', node_path.dirname(reactRouterDomPackageJson));
+    if (nestedReactRouterPackageJson) return node_path.dirname(nestedReactRouterPackageJson);
+};
+const setReactRouterBridgeSafeAliases = (chain, { isProd })=>{
+    const chainContext = chain.get('context');
+    const appDirectory = 'string' == typeof chainContext && chainContext.length > 0 ? chainContext : process.cwd();
+    const reactRouterPackageDir = resolveReactRouterPackageDir(appDirectory);
+    if (!reactRouterPackageDir) return;
+    const productionEntry = node_path.join(reactRouterPackageDir, 'dist/production/index.mjs');
+    const developmentEntry = node_path.join(reactRouterPackageDir, 'dist/development/index.mjs');
+    chain.resolve.alias.set('react-router$', isProd ? productionEntry : developmentEntry);
+    chain.resolve.alias.set('react-router/dist/production/index.js', productionEntry);
+    chain.resolve.alias.set('react-router/dist/development/index.js', developmentEntry);
+};
+const createPresetUltramodernConfig = (options = {})=>{
+    const { appId = 'app', deliveryUnit, enableBffRequestId = true, enableTelemetry = true, enableTelemetryExporters, otlpEndpoint = process.env.MODERN_TELEMETRY_OTLP_ENDPOINT, victoriaMetricsEndpoint = process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT, telemetryFailLoudStartup = false, enableModuleFederationSSR = true } = options;
+    const server = {};
+    const releaseIdentity = deliveryUnit ? resolveUltramodernReleaseIdentity({
+        generationBuildMarker: deliveryUnit.buildMarker,
+        unitId: deliveryUnit.unitId
+    }) : void 0;
+    const bundledReleaseIdentity = releaseIdentity ? {
+        ...releaseIdentity,
+        releaseVersion: deliveryUnit.version
+    } : void 0;
+    if (enableTelemetry) {
+        server.telemetry = {
+            enabled: true,
+            failLoudStartup: telemetryFailLoudStartup
+        };
+        if (false !== enableTelemetryExporters) {
+            const exporters = {};
+            if (true === enableTelemetryExporters || otlpEndpoint) exporters.otlp = {
+                enabled: true,
+                endpoint: otlpEndpoint || DEFAULT_OTLP_ENDPOINT
+            };
+            if (true === enableTelemetryExporters || victoriaMetricsEndpoint) exporters.victoriaMetrics = {
+                enabled: true,
+                endpoint: victoriaMetricsEndpoint || DEFAULT_VICTORIA_METRICS_ENDPOINT
+            };
+            if (Object.keys(exporters).length > 0) server.telemetry.exporters = exporters;
+        }
+    }
+    if (enableModuleFederationSSR) server.ssr = {
+        mode: 'stream',
+        moduleFederationAppSSR: true
+    };
+    const presetConfig = {
+        output: {
+            precompress: true
+        },
+        server,
+        source: {
+            reactCompiler: true,
+            ...deliveryUnit ? {
+                globalVars: {
+                    ULTRAMODERN_BUILD_MARKER: releaseIdentity?.buildMarker,
+                    ULTRAMODERN_RELEASE_VERSION: deliveryUnit.version,
+                    ULTRAMODERN_SOURCE_REVISION: releaseIdentity?.sourceRevision
+                }
+            } : {}
+        },
+        tools: {
+            bundlerChain: (chain, utils)=>{
+                setReactRouterBridgeSafeAliases(chain, utils);
+                configureUltramodernTypeChecker(chain, utils.CHAIN_ID.PLUGIN.TS_CHECKER, (from)=>resolveEffectTsgoCompiler({
+                        from
+                    }));
+            },
+            lightningcssLoader: true,
+            ...bundledReleaseIdentity ? {
+                rspack: (config)=>{
+                    config.plugins ??= [];
+                    config.plugins.push(new rspack.BannerPlugin({
+                        banner: `void ${JSON.stringify(bundledReleaseIdentity.buildMarker)};void ${JSON.stringify(bundledReleaseIdentity.sourceRevision)};void ${JSON.stringify(bundledReleaseIdentity.releaseVersion)};`,
+                        raw: true,
+                        stage: rspack.Compilation.PROCESS_ASSETS_STAGE_SUMMARIZE,
+                        test: /\.(?:c|m)?js$/u
+                    }));
+                    return config;
+                }
+            } : {}
+        }
+    };
+    if (enableBffRequestId) presetConfig.bff = {
+        requestId: appId
+    };
+    return presetConfig;
+};
+const presetUltramodern = (config, options = {})=>{
+    const merged = mergeConfig([
+        createPresetUltramodernConfig(options),
+        config
+    ]);
+    merged.builderPlugins = [
+        builderPluginAdapterPrecompress(merged.output?.precompress),
+        ...merged.builderPlugins ?? []
+    ];
+    return merged;
+};
+export { createPresetUltramodernConfig, presetUltramodern };

package/dist/esm/native-composition/release-envelope-plugin.mjs

@@ -0,0 +1,6 @@
+import { resolveDeployTarget } from "@modern-js/app-tools-extensions/deploy-output/target";
+import { createUltramodernReleaseEnvelopePlugin } from "@modern-js/app-tools-extensions/release-envelope/plugin";
+const ultramodernReleaseEnvelopePlugin = ()=>createUltramodernReleaseEnvelopePlugin({
+        resolveDeployTarget: resolveDeployTarget
+    });
+export { ultramodernReleaseEnvelopePlugin };

package/dist/esm/native-composition/router-integration-plugin.mjs

@@ -0,0 +1,17 @@
+const ultramodernRouterIntegrationPlugin = ()=>({
+        name: '@modern-js/ultramodern-router-integration',
+        pre: [
+            '@modern-js/plugin-router',
+            '@modern-js/plugin-tanstack'
+        ],
+        setup (api) {
+            api._internalRuntimePlugins(({ entrypoint, plugins })=>({
+                    entrypoint,
+                    plugins: plugins.map((plugin)=>'@modern-js/runtime/router/internal' === plugin.path ? {
+                            ...plugin,
+                            path: '@modern-js/ultramodern-app-tools/router-runtime'
+                        } : plugin)
+                }));
+        }
+    });
+export { ultramodernRouterIntegrationPlugin };

package/dist/esm/native-composition/router-runtime.mjs

@@ -0,0 +1,26 @@
+import { routerPlugin, routerProviderRegistryHooks } from "@modern-js/runtime/router/internal";
+import { createRouterPlugin } from "@modern-js/runtime-extensions/router-provider";
+import { createRouterStatePlugin } from "@modern-js/runtime-extensions/router-state-plugin";
+const createProvider = createRouterPlugin({
+    defaultProvider: {
+        name: 'react-router',
+        factory: routerPlugin
+    },
+    registryHooks: routerProviderRegistryHooks
+});
+const router_runtime_routerPlugin = (config)=>{
+    const state = createRouterStatePlugin({
+        registryHooks: routerProviderRegistryHooks
+    });
+    const provider = createProvider(config);
+    return {
+        ...provider,
+        setup (api) {
+            state.setup?.(api);
+            return provider.setup?.(api);
+        }
+    };
+};
+const router_runtime = router_runtime_routerPlugin;
+export default router_runtime;
+export { router_runtime_routerPlugin as routerPlugin };

package/dist/esm/native-composition/rsc-disabled-plugin.mjs

@@ -0,0 +1,79 @@
+const disabledRuntimeModules = {
+    'react-server-dom-rspack/client.browser': './rscDisabledClientBrowserRuntime',
+    'react-server-dom-rspack/client.edge': './rscDisabledClientEdgeRuntime',
+    'react-server-dom-rspack/client.node': './rscDisabledClientNodeRuntime',
+    'react-server-dom-rspack/server.edge': './rscDisabledServerEdgeRuntime',
+    'react-server-dom-rspack/server.node': './rscDisabledServerNodeRuntime'
+};
+const disabledRuntimeRequests = Object.keys(disabledRuntimeModules);
+function aliasMatchesRequest(aliasName, request) {
+    const exact = aliasName.endsWith('$');
+    const normalizedName = exact ? aliasName.slice(0, -1) : aliasName;
+    return exact ? normalizedName === request : request === normalizedName || request.startsWith(`${normalizedName}/`);
+}
+function objectAliasMatchesDisabledRuntime(aliasName) {
+    return disabledRuntimeRequests.some((request)=>aliasMatchesRequest(aliasName, request));
+}
+function arrayAliasMatchesDisabledRuntime(alias) {
+    const aliasName = `${alias.name}${alias.onlyModule ? '$' : ''}`;
+    return objectAliasMatchesDisabledRuntime(aliasName);
+}
+function normalizeArrayAliases(aliases) {
+    const normalized = {};
+    for (const alias of aliases){
+        if (arrayAliasMatchesDisabledRuntime(alias)) continue;
+        const aliasName = `${alias.name}${alias.onlyModule ? '$' : ''}`;
+        const existing = normalized[aliasName];
+        if (void 0 === existing) {
+            normalized[aliasName] = alias.alias;
+            continue;
+        }
+        normalized[aliasName] = [
+            ...Array.isArray(existing) ? existing : [
+                existing
+            ],
+            ...Array.isArray(alias.alias) ? alias.alias : [
+                alias.alias
+            ]
+        ];
+    }
+    return normalized;
+}
+function resolveDisabledRuntimeModules() {
+    return Object.fromEntries(Object.entries(disabledRuntimeModules).map(([request, moduleRequest])=>[
+            `${request}$`,
+            require.resolve(`@modern-js/runtime-extensions/rsc-disabled/${moduleRequest.slice(2)}`)
+        ]));
+}
+function applyDisabledRuntimeAliases(config, disabledAliases) {
+    config.resolve ??= {};
+    if (Array.isArray(config.resolve.alias)) config.resolve.alias = {
+        ...disabledAliases,
+        ...normalizeArrayAliases(config.resolve.alias)
+    };
+    else config.resolve.alias = {
+        ...disabledAliases,
+        ...Object.fromEntries(Object.entries(config.resolve.alias ?? {}).filter(([aliasName])=>!objectAliasMatchesDisabledRuntime(aliasName)))
+    };
+}
+function rscDisabledRuntimePlugin() {
+    return {
+        name: 'builder:rsc-disabled-runtime',
+        setup (api) {
+            const disabledAliases = resolveDisabledRuntimeModules();
+            api.modifyRspackConfig({
+                order: 'post',
+                handler (config) {
+                    applyDisabledRuntimeAliases(config, disabledAliases);
+                }
+            });
+            api.onBeforeCreateCompiler({
+                order: 'post',
+                handler ({ bundlerConfigs }) {
+                    for (const config of bundlerConfigs)applyDisabledRuntimeAliases(config, disabledAliases);
+                }
+            });
+        }
+    };
+}
+export { rscDisabledRuntimePlugin };

package/dist/esm/native-composition/server-plugin.mjs

@@ -0,0 +1 @@
+export { default } from "@modern-js/server-runtime-extensions/server-plugin";

package/dist/esm/native-composition/ssr-integration-plugin.mjs

@@ -0,0 +1,104 @@
+const getRspackPlugins = (rspackConfig)=>{
+    if (!rspackConfig) return [];
+    const rspackEntries = Array.isArray(rspackConfig) ? rspackConfig : [
+        rspackConfig
+    ];
+    const plugins = [];
+    for (const entry of rspackEntries){
+        if (!entry || 'function' == typeof entry || 'object' != typeof entry) continue;
+        const maybePlugins = entry.plugins;
+        if (Array.isArray(maybePlugins)) {
+            for (const plugin of maybePlugins)if (plugin) plugins.push(plugin);
+        }
+    }
+    return plugins;
+};
+const getRspackPluginName = (plugin)=>{
+    if ('string' == typeof plugin) return plugin;
+    if ('function' == typeof plugin) return plugin.name;
+    if (Array.isArray(plugin)) {
+        const [first] = plugin;
+        if (!first) return;
+        if ('string' == typeof first) return first;
+        if ('function' == typeof first) return first.name;
+        if ('object' == typeof first) return first.name || first.constructor?.name;
+        return;
+    }
+    return plugin.name || plugin.constructor?.name;
+};
+const hasServerRenderingConfig = (userConfig)=>{
+    const { output, server } = userConfig;
+    if (output?.ssg) return true;
+    if (output?.ssgByEntries && Object.keys(output.ssgByEntries).length > 0) return true;
+    if (server?.ssr) return true;
+    if (server?.ssrByEntries && Object.keys(server.ssrByEntries).length > 0) return true;
+    return false;
+};
+const isModuleFederationAppSSREnabledInConfig = (ssr)=>{
+    if (!ssr || 'object' != typeof ssr) return false;
+    return true === ssr.moduleFederationAppSSR;
+};
+const isModuleFederationAppSSREnabled = (userConfig)=>{
+    if (isModuleFederationAppSSREnabledInConfig(userConfig.server?.ssr)) return true;
+    if (userConfig.server?.ssrByEntries && 'object' == typeof userConfig.server.ssrByEntries) return Object.values(userConfig.server.ssrByEntries).some(isModuleFederationAppSSREnabledInConfig);
+    return false;
+};
+const isModuleFederationRspackPlugin = (plugin)=>{
+    const candidate = getRspackPluginName(plugin);
+    return 'string' == typeof candidate && /modulefederation/i.test(candidate);
+};
+const hasModuleFederationMarker = (config)=>{
+    if ('true' === process.env.MF_SSR_PRJ) return true;
+    const define = config.source?.define || {};
+    if ('REMOTE_IP_STRATEGY' in define || 'FEDERATION_IPV4' in define) return true;
+    const plugins = getRspackPlugins(config.tools?.rspack);
+    return plugins.some(isModuleFederationRspackPlugin);
+};
+const isNodeEnvironmentTarget = (target)=>'string' == typeof target && ('node' === target || 'async-node' === target || target.startsWith('node'));
+const shouldUseModuleFederationNodeOutput = (config)=>isNodeEnvironmentTarget(config.output?.target) && hasModuleFederationMarker(config);
+const ssrIntegrationBuilderPlugin = (modernAPI)=>({
+        name: '@modern-js/ultramodern-builder-plugin-ssr',
+        pre: [
+            '@modern-js/builder-plugin-ssr'
+        ],
+        setup (api) {
+            api.modifyEnvironmentConfig((config, { name, mergeEnvironmentConfig })=>{
+                const isServerEnvironment = isNodeEnvironmentTarget(config.output.target) || 'workerSSR' === name;
+                const userConfig = modernAPI.getNormalizedConfig();
+                const hasServerRendering = hasServerRenderingConfig(userConfig);
+                const hasModuleFederationRuntimeMarker = hasServerRendering && shouldUseModuleFederationNodeOutput(config);
+                const hasExplicitMfSsrFlag = isModuleFederationAppSSREnabled(userConfig);
+                const requireExplicitMfSsrFlag = 'true' === process.env.MODERN_MF_APP_SSR_REQUIRE_EXPLICIT;
+                if (hasServerRendering && hasModuleFederationRuntimeMarker && !hasExplicitMfSsrFlag) {
+                    const warningMessage = '[modernjs][mf-ssr] Module Federation SSR was auto-detected from runtime markers. Set server.ssr.moduleFederationAppSSR=true explicitly in host and remotes to avoid heuristic drift.';
+                    if (requireExplicitMfSsrFlag) throw new Error(`${warningMessage} (enforced by MODERN_MF_APP_SSR_REQUIRE_EXPLICIT=true)`);
+                    console.warn(warningMessage);
+                }
+                const isModuleFederationAppSSR = hasServerRendering && hasExplicitMfSsrFlag;
+                return mergeEnvironmentConfig(config, {
+                    source: {
+                        define: {
+                            'process.env.MODERN_MF_APP_SSR': JSON.stringify(String(isModuleFederationAppSSR))
+                        }
+                    },
+                    ...'workerSSR' === name && userConfig.deploy?.target === 'cloudflare' ? {
+                        output: {
+                            module: true
+                        }
+                    } : {},
+                    splitChunks: isServerEnvironment && (hasModuleFederationRuntimeMarker || hasExplicitMfSsrFlag) ? false : void 0
+                });
+            });
+        }
+    });
+const ultramodernSSRIntegrationPlugin = ()=>({
+        name: '@modern-js/ultramodern-ssr-integration',
+        setup (api) {
+            api.config(()=>({
+                    builderPlugins: [
+                        ssrIntegrationBuilderPlugin(api)
+                    ]
+                }));
+        }
+    });
+export { shouldUseModuleFederationNodeOutput, ultramodernSSRIntegrationPlugin };

package/dist/esm-node/native-composition/index.mjs

@@ -0,0 +1,57 @@
+import "node:module";
+import { appTools } from "@modern-js/app-tools";
+import backend_federation_build from "@modern-js/app-tools-extensions/backend-federation-build";
+import { createCloudflareBuilderPlugin } from "@modern-js/app-tools-extensions/cloudflare-builder";
+import { createDeployOutputAliasesPlugin } from "@modern-js/app-tools-extensions/deploy-output/plugin";
+import { ultramodernI18nIntegrationPlugin } from "@modern-js/i18n-integration";
+import { ultramodernReleaseEnvelopePlugin } from "./release-envelope-plugin.mjs";
+import { ultramodernRouterIntegrationPlugin } from "./router-integration-plugin.mjs";
+import { rscDisabledRuntimePlugin } from "./rsc-disabled-plugin.mjs";
+import { ultramodernSSRIntegrationPlugin } from "./ssr-integration-plugin.mjs";
+const ultramodernAppTools = ()=>({
+        name: '@modern-js/ultramodern-app-tools',
+        usePlugins: [
+            appTools(),
+            ultramodernI18nIntegrationPlugin(),
+            ultramodernRouterIntegrationPlugin(),
+            ultramodernSSRIntegrationPlugin(),
+            backend_federation_build(),
+            createCloudflareBuilderPlugin(),
+            createDeployOutputAliasesPlugin(),
+            ultramodernReleaseEnvelopePlugin()
+        ],
+        setup (api) {
+            api.modifyResolvedConfig((config)=>{
+                if (config.server?.rsc) return config;
+                return {
+                    ...config,
+                    builderPlugins: [
+                        ...config.builderPlugins ?? [],
+                        rscDisabledRuntimePlugin()
+                    ]
+                };
+            });
+            api._internalServerPlugins(({ plugins })=>{
+                const name = '@modern-js/ultramodern-app-tools/server-plugin';
+                if (!plugins.some((plugin)=>plugin.name === name)) plugins.push({
+                    name
+                });
+                return {
+                    plugins
+                };
+            });
+            api._internalRuntimePlugins(({ entrypoint, plugins })=>{
+                plugins.push({
+                    name: 'rendererHead',
+                    path: '@modern-js/runtime-renderer-extensions',
+                    config: {}
+                });
+                return {
+                    entrypoint,
+                    plugins
+                };
+            });
+        }
+    });
+export { createPresetUltramodernConfig, presetUltramodern } from "./preset.mjs";
+export { ultramodernAppTools, ultramodernReleaseEnvelopePlugin };