@bleedingdev/modern-js-ultramodern-create 3.9.3-ultramodern.1 → 3.9.3-ultramodern.2

package/dist/esm/ultramodern-workspace/validation/native-shell-runtime.js

@@ -0,0 +1,96 @@
+const FEDERATION_RUNTIME = '@module-federation/modern-js-v3/runtime';
+const FEDERATION_MEMBER_LOADERS = new Set([
+    'loadRemote',
+    'loadShare'
+]);
+const DECLARATION_FILE = /\.d\.[cm]?ts$/u;
+function createNativeShellRuntimeEvidence(typescript, typescriptApi, checker, sourceFile) {
+    const unwrapParentheses = (node)=>{
+        while(typescript.isParenthesizedExpression(node))node = node.expression;
+        return node;
+    };
+    const isAmbientProcess = (node)=>{
+        if (!typescript.isIdentifier(node) || 'process' !== node.text) return false;
+        const symbol = checker.getSymbolAtLocation(node);
+        return void 0 === symbol || symbol.declarations.every((declaration)=>DECLARATION_FILE.test(declaration.path));
+    };
+    const isBuildTargetAccess = (node)=>typescript.isPropertyAccessExpression(node) && void 0 === node.questionDotToken && 'MODERN_TARGET' === node.name.text && typescript.isPropertyAccessExpression(node.expression) && void 0 === node.expression.questionDotToken && 'env' === node.expression.name.text && isAmbientProcess(node.expression.expression);
+    const isBuildTargetLiteral = (node)=>typescript.isStringLiteral(node) && ('browser' === node.text || 'node' === node.text);
+    const buildTargetComparison = (node)=>{
+        node = unwrapParentheses(node);
+        if (!typescript.isBinaryExpression(node) || node.operatorToken.kind !== typescript.SyntaxKind.EqualsEqualsEqualsToken) return;
+        const literal = isBuildTargetAccess(node.left) ? node.right : isBuildTargetAccess(node.right) ? node.left : void 0;
+        return void 0 !== literal && isBuildTargetLiteral(literal) ? literal.text : void 0;
+    };
+    const isConditionOf = (node)=>{
+        let condition = node;
+        for(;;){
+            const parent = condition.parent;
+            if (typescript.isParenthesizedExpression(parent) || typescript.isPrefixUnaryExpression(parent) && parent.operator === typescript.SyntaxKind.ExclamationToken || typescript.isBinaryExpression(parent) && (parent.operatorToken.kind === typescript.SyntaxKind.AmpersandAmpersandToken || parent.operatorToken.kind === typescript.SyntaxKind.BarBarToken)) {
+                condition = parent;
+                continue;
+            }
+            return typescript.isIfStatement(parent) && parent.expression === condition || typescript.isConditionalExpression(parent) && parent.condition === condition;
+        }
+    };
+    const isBuildTargetCondition = (node)=>{
+        const access = node.parent;
+        if (!isBuildTargetAccess(access) || access.expression !== node) return false;
+        const comparison = access.parent;
+        return void 0 !== buildTargetComparison(comparison) && isConditionOf(comparison);
+    };
+    const conjuncts = (node)=>{
+        node = unwrapParentheses(node);
+        return typescript.isBinaryExpression(node) && node.operatorToken.kind === typescript.SyntaxKind.AmpersandAmpersandToken ? [
+            ...conjuncts(node.left),
+            ...conjuncts(node.right)
+        ] : [
+            node
+        ];
+    };
+    const requiresBrowserTarget = (condition)=>conjuncts(condition).some((conjunct)=>'browser' === buildTargetComparison(conjunct));
+    const isBrowserGuarded = (node)=>{
+        for(let child = node; void 0 !== child.parent; child = child.parent){
+            const parent = child.parent;
+            if (typescript.isIfStatement(parent) && parent.thenStatement === child && requiresBrowserTarget(parent.expression)) return true;
+            if (typescript.isConditionalExpression(parent) && parent.whenTrue === child && requiresBrowserTarget(parent.condition)) return true;
+        }
+        return false;
+    };
+    let federationInstanceTypeIds;
+    const federationInstanceTypes = ()=>{
+        if (void 0 !== federationInstanceTypeIds) return federationInstanceTypeIds;
+        const typeIds = new Set();
+        const recordRuntime = (specifier)=>{
+            const runtime = checker.getSymbolAtLocation(specifier);
+            const getInstance = void 0 === runtime ? void 0 : checker.getMemberInModuleExports(runtime, 'getInstance');
+            const getInstanceType = void 0 === getInstance ? void 0 : checker.getTypeOfSymbol(getInstance);
+            if (void 0 === getInstanceType) return;
+            for (const signature of checker.getSignaturesOfType(getInstanceType, typescriptApi.SignatureKind.Call)){
+                const returnType = checker.getReturnTypeOfSignature(signature);
+                const instanceType = void 0 === returnType ? void 0 : checker.getNonNullableType(returnType);
+                if (void 0 !== instanceType && instanceType.getSymbol()?.name === 'ModuleFederation') typeIds.add(instanceType.id);
+            }
+        };
+        const visit = (node)=>{
+            if (typescript.isImportDeclaration(node) && typescript.isStringLiteralLikeNode(node.moduleSpecifier) && node.moduleSpecifier.text === FEDERATION_RUNTIME && node.importClause?.phaseModifier !== typescript.SyntaxKind.TypeKeyword) recordRuntime(node.moduleSpecifier);
+            else if (typescript.isCallExpression(node) && node.expression.kind === typescript.SyntaxKind.ImportKeyword && 1 === node.arguments.length && typescript.isStringLiteralLikeNode(node.arguments[0]) && node.arguments[0].text === FEDERATION_RUNTIME) recordRuntime(node.arguments[0]);
+            node.forEachChild(visit);
+        };
+        visit(sourceFile);
+        federationInstanceTypeIds = typeIds;
+        return typeIds;
+    };
+    const isBrowserFederationMemberLoad = (node)=>{
+        if (!typescript.isCallExpression(node)) return false;
+        const callee = unwrapParentheses(node.expression);
+        if (!typescript.isPropertyAccessExpression(callee) || !FEDERATION_MEMBER_LOADERS.has(callee.name.text)) return false;
+        const receiverType = checker.getTypeAtLocation(callee.expression);
+        return void 0 !== receiverType && federationInstanceTypes().has(receiverType.id) && isBrowserGuarded(node);
+    };
+    return {
+        isBrowserFederationMemberLoad,
+        isBuildTargetCondition
+    };
+}
+export { createNativeShellRuntimeEvidence };

package/dist/esm/ultramodern-workspace/write-app.js

@@ -1,4 +1,3 @@
-import { createShellApiClient } from "./api.js";
 import { writeAppApiFiles } from "./api/write-app-api.js";
 import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
 import { createFederatedComponentsRegistry, createLayout, createRemoteEntry, createRemoteExposeComponent, createRemoteExposeFragmentPage, createRemotePage, createShellPage, createShellRemoteComponents, createShellWorkerRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
@@ -78,7 +77,7 @@ function writeAppFederationConfigFiles({ targetDir, scope, resolvedApp, emitsUi,
     if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, resolvedApp, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
     if (appHasApi(resolvedApp)) writeFile(targetDir, `${resolvedApp.directory}/backend-federation.config.ts`, createBackendModuleFederationConfig(resolvedApp));
 }
-function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, availableRemotes, publicWeb, writeAppFile }) {
+function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, publicWeb, writeAppFile }) {
     if (!emitsUi) return;
     if ((resolvedApp.verticalRefs?.length ?? 0) > 0) {
         writeAppFile('src/federated-components.tsx', createFederatedComponentsRegistry(scope, resolvedApp, remotes));
@@ -92,7 +91,6 @@ function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, re
         writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
         writeAppFile('src/routes/vertical-components.worker.tsx', createShellWorkerRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
         writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, availableRemotes));
     } else for (const expose of distributedSsrExposes(resolvedApp))writeAppFile(`src/routes/[lang]/_mf/fragment/${distributedSsrFragmentSlug(expose)}/page.tsx`, createRemoteExposeFragmentPage(resolvedApp, expose));
 }
 function writeAppRemoteExposeFiles({ resolvedApp, emitsUi, writeAppFile }) {

package/dist/esm-node/ultramodern-workspace/add-vertical/shell-files.js

@@ -1,10 +1,9 @@
 import "node:module";
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { createShellApiClient } from "../api.js";
 import { createAppEnvDts, createAppRuntimeConfig, createShellFrameComponent } from "../app-files.js";
 import { createShellPage, createShellRemoteComponents, createShellWorkerRemoteComponents } from "../demo-components.js";
-import { appEmitsBrowserUi, appHasApi, appI18nNamespace, resolveRemoteRefs, shellApp } from "../descriptors.js";
+import { appEmitsBrowserUi, appI18nNamespace, resolveRemoteRefs, shellApp } from "../descriptors.js";
 import { readJsonFile, writeJsonFile } from "../fs-io.js";
 import { createAppPublicLocaleMessages } from "../locales.js";
 import { createAppModernConfig, createShellModuleFederationConfig } from "../module-federation.js";
@@ -41,10 +40,7 @@ function shellAppArtifacts(scope, packageSource, enableTailwind, remotes, bridge
             ...Object.fromEntries(createNativeFederationArtifacts(scope, shellHost, remotes).map((artifact)=>[
                     `${shellHost.directory}/${artifact.path}`,
                     artifact.content
-                ])),
-            ...remotes.some(appHasApi) ? {
-                [`${shellHost.directory}/src/api/vertical-clients.ts`]: createShellApiClient(scope, remotes)
-            } : {}
+                ]))
         };
         return {
             shellHost,
@@ -84,8 +80,7 @@ function shellAppArtifacts(scope, packageSource, enableTailwind, remotes, bridge
         [`${shellHost.directory}/src/routes/[lang]/page.tsx`]: createShellPage(shellHost, uiRemotes),
         [`${shellHost.directory}/src/routes/vertical-components.tsx`]: createShellRemoteComponents(shellHost, uiRemotes),
         [`${shellHost.directory}/src/routes/vertical-components.worker.tsx`]: createShellWorkerRemoteComponents(shellHost, uiRemotes),
-        [`${shellHost.directory}/src/routes/shell-frame.tsx`]: createShellFrameComponent(shellHost),
-        [`${shellHost.directory}/src/api/vertical-clients.ts`]: createShellApiClient(scope, remotes)
+        [`${shellHost.directory}/src/routes/shell-frame.tsx`]: createShellFrameComponent(shellHost)
     };
     return {
         shellHost,

package/dist/esm-node/ultramodern-workspace/api/client.js

@@ -1,7 +1,7 @@
 import "node:module";
-import { resolveApiProtocol, resolveApiStem, verticalApiApps } from "../descriptors.js";
-import { packageName, toPascalCase } from "../naming.js";
-import { createCheckoutCartClientExports, serviceHasCheckoutCartState } from "./checkout-cart.js";
+import { resolveApiStem } from "../descriptors.js";
+import { toPascalCase } from "../naming.js";
+import { createCheckoutCartClientExports } from "./checkout-cart.js";
 import { verticalApiErrorStem, verticalApiExport, verticalApiGroupName, verticalApiNotFoundErrorExport } from "./names.js";
 function createApiClient(service, contractImportPath, options) {
     const apiExport = verticalApiExport(service);
@@ -149,36 +149,4 @@ export const ${createName} = (
   );${checkoutCartClientExports}
 `;
 }
-function createShellApiClient(scope, remotes = []) {
-    const exports = verticalApiApps(remotes).map((remote)=>{
-        const stem = resolveApiStem(remote);
-        const pascalStem = toPascalCase(stem);
-        const rpc = 'rpc' === resolveApiProtocol(remote);
-        const pascalSingular = toPascalCase(verticalApiErrorStem(remote));
-        const checkoutCartExports = !rpc && serviceHasCheckoutCartState(remote) ? `  addCheckoutCartItem,
-  clearCheckoutCart,
-  getCheckoutCart,
-  removeCheckoutCartItem,
-  type CheckoutAddCartItemInput,
-  type CheckoutCart,
-  type CheckoutCartLine,
-` : '';
-        if (rpc) return `export {
-  get${pascalStem}Rpc,
-  list${pascalStem}Rpc,
-  make${pascalStem}RpcClient,
-  type ${pascalStem}RpcClientOptions,
-} from '${packageName(scope, remote.packageSuffix)}/api/rpc-client';`;
-        return `export {
-${checkoutCartExports}  create${pascalSingular},
-  create${pascalStem}Client,
-  get${pascalSingular},
-  get${pascalStem}Readiness,
-  list${pascalStem},
-  type ${pascalStem}ClientOptions,
-} from '${packageName(scope, remote.packageSuffix)}/api/client';`;
-    }).join('\n\n');
-    return exports ? `${exports}\n` : `export const ultramodernVerticalClients = [] as const;
-`;
-}
-export { createApiClient, createShellApiClient };
+export { createApiClient };

package/dist/esm-node/ultramodern-workspace/api.js

@@ -1,5 +1,5 @@
 import "node:module";
-export { createApiClient, createShellApiClient } from "./api/client.js";
+export { createApiClient } from "./api/client.js";
 export { apiTopologyMetadata } from "./api/contracts.js";
 export { verticalApiCreatePayloadSchemaExport, verticalApiErrorStem, verticalApiExport, verticalApiGroupName, verticalApiMarkerSchemaExport, verticalApiName, verticalApiNotFoundErrorExport, verticalApiNotFoundSchemaExport, verticalApiReadinessSchemaExport, verticalApiSchemaExport } from "./api/names.js";
 export { createRpcApiServiceEntry, createRpcClientFile, createRpcContractFile, rpcPath, verticalRpcContractExport, verticalRpcGroupExport } from "./api/rpc.js";

package/dist/esm-node/ultramodern-workspace/native-app.js

@@ -1,5 +1,4 @@
 import "node:module";
-import { createShellApiClient } from "./api.js";
 import { writeAppApiFiles } from "./api/write-app-api.js";
 import { createAppStyles, createTailwindConfig } from "./app-files.js";
 import { appHasApi } from "./descriptors.js";
@@ -62,6 +61,5 @@ function writeNativeApp(targetDir, scope, app, packageSource, enableTailwind, re
         resolvedApp: app,
         emitsUi: true
     });
-    if ('shell' === app.kind && remotes.some(appHasApi)) write('src/api/vertical-clients.ts', createShellApiClient(scope, remotes));
 }
 export { writeNativeApp };

package/dist/esm-node/ultramodern-workspace/package-json.js

@@ -270,9 +270,7 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
             './api': './shared/api.ts',
             './api/client': `./${clientDirectory}/${app.api.stem}-client.ts`
         });
-    } else if ('shell' === app.kind && ('react' === resolveWorkspaceRenderer(app) || verticalApiApps(remotes).length > 0)) Object.assign(packageExports, {
-        './api/clients': './src/api/vertical-clients.ts'
-    });
+    }
     if (Object.keys(packageExports).length > 0) packageJson.exports = packageExports;
     return packageJson;
 }

package/dist/esm-node/ultramodern-workspace/validation/architecture.js

@@ -5,6 +5,7 @@ import node_path from "node:path";
 import { hasNativeAppGeneration } from "../renderer-generations.js";
 import { getRendererGenerationProfile, isApplicationRenderer } from "../renderer-profile.js";
 import { assert, sameJson, selfCheckFailure } from "./assertions.js";
+import { createNativeShellRuntimeEvidence } from "./native-shell-runtime.js";
 import { isForeignRendererPackage } from "./renderer.js";
 function assertCompilerArchitecture(root, workspaceValidationContract) {
     const fullStackVerticals = workspaceValidationContract.apps.filter((app)=>'shell' !== app.kind);
@@ -63,12 +64,16 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                 ]
             });
         };
-        const parseCompilerInput = (absolutePath)=>{
+        const compilerInput = (absolutePath)=>{
             const project = compilerSnapshot?.getDefaultProjectForFile(absolutePath);
             const sourceFile = project?.program.getSourceFile(absolutePath);
-            assert(void 0 !== sourceFile, `Native TypeScript compiler could not parse ${node_path.relative(root, absolutePath)}`);
-            return sourceFile;
+            assert(void 0 !== project && void 0 !== sourceFile, `Native TypeScript compiler could not parse ${node_path.relative(root, absolutePath)}`);
+            return {
+                checker: project.checker,
+                sourceFile
+            };
         };
+        const parseCompilerInput = (absolutePath)=>compilerInput(absolutePath).sourceFile;
         const nodeName = (node)=>{
             if (!node) return;
             if (typescript.isIdentifier(node) || typescript.isPrivateIdentifier(node) || typescript.isStringLiteralLikeNode(node) || typescript.isNumericLiteral(node)) return node.text;
@@ -156,6 +161,12 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
             const accessPath = propertyAccessPath(node.expression);
             return void 0 !== accessPath && names.has(accessPath.at(-1));
         };
+        const calleeName = (node)=>{
+            let callee = node.expression;
+            while(typescript.isParenthesizedExpression(callee) || typescript.isNonNullExpression(callee) || typescript.isAsExpression(callee))callee = callee.expression;
+            if (typescript.isIdentifier(callee)) return callee.text;
+            if (typescript.isPropertyAccessExpression(callee)) return callee.name.text;
+        };
         const objectLiteralProperty = (objectLiteral, name)=>objectLiteral.properties.find((property)=>typescript.isPropertyAssignment(property) && nodeName(property.name) === name);
         const moduleFederationConfigArgument = (sourceFile)=>{
             let argument;
@@ -303,11 +314,12 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                 ...configFiles.map((relativePath)=>node_path.join(root, relativePath)).filter((absolutePath)=>node_fs.existsSync(absolutePath))
             ]);
             for (const absolutePath of checkedFiles){
-                const sourceFile = parseCompilerInput(absolutePath);
+                const { checker, sourceFile } = compilerInput(absolutePath);
                 const isShellRoute = shellRouteDirectories.some((relativeDirectory)=>{
                     const absoluteDirectory = node_path.join(root, relativeDirectory);
                     return absolutePath.startsWith(absoluteDirectory + node_path.sep);
                 });
+                const shellRuntime = isShellRoute ? createNativeShellRuntimeEvidence(typescript, typescriptApi, checker, sourceFile) : void 0;
                 const moduleFederationAppPath = moduleFederationConfigAppPaths.get(absolutePath);
                 const nativeFederation = void 0 === moduleFederationAppPath ? void 0 : nativeModuleFederationApps.get(moduleFederationAppPath);
                 const tailwindFactories = new Set();
@@ -330,6 +342,12 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                         ].includes(imported)) presetFactories.add(binding.name.text);
                     }
                 }
+                const manualLoadingCallees = new Set([
+                    'hydrateRoot',
+                    'loadRemote',
+                    'loadShare',
+                    ...nativeRemoteLoaders
+                ]);
                 const modernConfigApp = workspaceValidationContract.apps.find((app)=>absolutePath === node_path.join(root, app.path, 'modern.config.ts'));
                 let insideDefaultExport = false;
                 const visit = (node)=>{
@@ -357,7 +375,7 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                     if (sameJson(accessPath, [
                         'process',
                         'env'
-                    ])) compilerFailure(sourceFile, node, 'framework config API direct-process-env-access', 'Generated config must use the framework config environment API instead of process.env.', 'use getBuildConfigEnvironment');
+                    ]) && !shellRuntime?.isBuildTargetCondition(node)) compilerFailure(sourceFile, node, 'framework config API direct-process-env-access', 'Generated config must use the framework config environment API instead of process.env.', 'use getBuildConfigEnvironment');
                     if (typescript.isIdentifier(node) && 'ULTRAMODERN_ZEPHYR' === node.text) compilerFailure(sourceFile, node, 'zephyr gating ultramodern-zephyr-environment-gate', 'Generated Zephyr integration must not be gated through ULTRAMODERN_ZEPHYR.', 'use Zephyr native deploy-token behavior');
                     if (typescript.isPropertyAssignment(node) || typescript.isShorthandPropertyAssignment(node)) {
                         const property = nodeName(node.name);
@@ -365,12 +383,7 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                     }
                     if (isShellRoute) {
                         if (typescript.isJsxOpeningElement(node) && 'a' === jsxTagName(node.tagName) && void 0 !== jsxAttribute(node.attributes, 'onClick')) compilerFailure(sourceFile, node, 'shell routing synthetic-anchor-click-interception', 'Shell routing must not intercept anchor clicks synthetically.', 'use the router Link primitive');
-                        if (isCallNamed(node, new Set([
-                            'hydrateRoot',
-                            'loadRemote',
-                            'loadShare',
-                            ...nativeRemoteLoaders
-                        ])) && !nativeLoaderCalls.has(node)) compilerFailure(sourceFile, node, 'module federation native loading', 'Shell routing must use framework Module Federation loading primitives.', 'remove manual hydration or remote-loading wrappers');
+                        if (typescript.isCallExpression(node) && manualLoadingCallees.has(calleeName(node) ?? '') && !nativeLoaderCalls.has(node) && !shellRuntime?.isBrowserFederationMemberLoad(node)) compilerFailure(sourceFile, node, 'module federation native loading', 'Shell routing must use framework Module Federation loading primitives.', 'remove manual hydration or remote-loading wrappers');
                         if (typescript.isBinaryExpression(node) && node.operatorToken.kind === typescript.SyntaxKind.EqualsToken && propertyAccessPath(node.left)?.slice(0, 2).join('.') === 'window.location' || typescript.isCallExpression(node) && propertyAccessPath(node.expression)?.slice(0, 2).join('.') === 'window.location') compilerFailure(sourceFile, node, 'shell routing window-location-navigation', 'Shell routing must use router navigation instead of window.location.', 'use the router navigation primitive');
                     }
                     node.forEachChild(visit);

package/dist/esm-node/ultramodern-workspace/validation/native-shell-runtime.js

@@ -0,0 +1,97 @@
+import "node:module";
+const FEDERATION_RUNTIME = '@module-federation/modern-js-v3/runtime';
+const FEDERATION_MEMBER_LOADERS = new Set([
+    'loadRemote',
+    'loadShare'
+]);
+const DECLARATION_FILE = /\.d\.[cm]?ts$/u;
+function createNativeShellRuntimeEvidence(typescript, typescriptApi, checker, sourceFile) {
+    const unwrapParentheses = (node)=>{
+        while(typescript.isParenthesizedExpression(node))node = node.expression;
+        return node;
+    };
+    const isAmbientProcess = (node)=>{
+        if (!typescript.isIdentifier(node) || 'process' !== node.text) return false;
+        const symbol = checker.getSymbolAtLocation(node);
+        return void 0 === symbol || symbol.declarations.every((declaration)=>DECLARATION_FILE.test(declaration.path));
+    };
+    const isBuildTargetAccess = (node)=>typescript.isPropertyAccessExpression(node) && void 0 === node.questionDotToken && 'MODERN_TARGET' === node.name.text && typescript.isPropertyAccessExpression(node.expression) && void 0 === node.expression.questionDotToken && 'env' === node.expression.name.text && isAmbientProcess(node.expression.expression);
+    const isBuildTargetLiteral = (node)=>typescript.isStringLiteral(node) && ('browser' === node.text || 'node' === node.text);
+    const buildTargetComparison = (node)=>{
+        node = unwrapParentheses(node);
+        if (!typescript.isBinaryExpression(node) || node.operatorToken.kind !== typescript.SyntaxKind.EqualsEqualsEqualsToken) return;
+        const literal = isBuildTargetAccess(node.left) ? node.right : isBuildTargetAccess(node.right) ? node.left : void 0;
+        return void 0 !== literal && isBuildTargetLiteral(literal) ? literal.text : void 0;
+    };
+    const isConditionOf = (node)=>{
+        let condition = node;
+        for(;;){
+            const parent = condition.parent;
+            if (typescript.isParenthesizedExpression(parent) || typescript.isPrefixUnaryExpression(parent) && parent.operator === typescript.SyntaxKind.ExclamationToken || typescript.isBinaryExpression(parent) && (parent.operatorToken.kind === typescript.SyntaxKind.AmpersandAmpersandToken || parent.operatorToken.kind === typescript.SyntaxKind.BarBarToken)) {
+                condition = parent;
+                continue;
+            }
+            return typescript.isIfStatement(parent) && parent.expression === condition || typescript.isConditionalExpression(parent) && parent.condition === condition;
+        }
+    };
+    const isBuildTargetCondition = (node)=>{
+        const access = node.parent;
+        if (!isBuildTargetAccess(access) || access.expression !== node) return false;
+        const comparison = access.parent;
+        return void 0 !== buildTargetComparison(comparison) && isConditionOf(comparison);
+    };
+    const conjuncts = (node)=>{
+        node = unwrapParentheses(node);
+        return typescript.isBinaryExpression(node) && node.operatorToken.kind === typescript.SyntaxKind.AmpersandAmpersandToken ? [
+            ...conjuncts(node.left),
+            ...conjuncts(node.right)
+        ] : [
+            node
+        ];
+    };
+    const requiresBrowserTarget = (condition)=>conjuncts(condition).some((conjunct)=>'browser' === buildTargetComparison(conjunct));
+    const isBrowserGuarded = (node)=>{
+        for(let child = node; void 0 !== child.parent; child = child.parent){
+            const parent = child.parent;
+            if (typescript.isIfStatement(parent) && parent.thenStatement === child && requiresBrowserTarget(parent.expression)) return true;
+            if (typescript.isConditionalExpression(parent) && parent.whenTrue === child && requiresBrowserTarget(parent.condition)) return true;
+        }
+        return false;
+    };
+    let federationInstanceTypeIds;
+    const federationInstanceTypes = ()=>{
+        if (void 0 !== federationInstanceTypeIds) return federationInstanceTypeIds;
+        const typeIds = new Set();
+        const recordRuntime = (specifier)=>{
+            const runtime = checker.getSymbolAtLocation(specifier);
+            const getInstance = void 0 === runtime ? void 0 : checker.getMemberInModuleExports(runtime, 'getInstance');
+            const getInstanceType = void 0 === getInstance ? void 0 : checker.getTypeOfSymbol(getInstance);
+            if (void 0 === getInstanceType) return;
+            for (const signature of checker.getSignaturesOfType(getInstanceType, typescriptApi.SignatureKind.Call)){
+                const returnType = checker.getReturnTypeOfSignature(signature);
+                const instanceType = void 0 === returnType ? void 0 : checker.getNonNullableType(returnType);
+                if (void 0 !== instanceType && instanceType.getSymbol()?.name === 'ModuleFederation') typeIds.add(instanceType.id);
+            }
+        };
+        const visit = (node)=>{
+            if (typescript.isImportDeclaration(node) && typescript.isStringLiteralLikeNode(node.moduleSpecifier) && node.moduleSpecifier.text === FEDERATION_RUNTIME && node.importClause?.phaseModifier !== typescript.SyntaxKind.TypeKeyword) recordRuntime(node.moduleSpecifier);
+            else if (typescript.isCallExpression(node) && node.expression.kind === typescript.SyntaxKind.ImportKeyword && 1 === node.arguments.length && typescript.isStringLiteralLikeNode(node.arguments[0]) && node.arguments[0].text === FEDERATION_RUNTIME) recordRuntime(node.arguments[0]);
+            node.forEachChild(visit);
+        };
+        visit(sourceFile);
+        federationInstanceTypeIds = typeIds;
+        return typeIds;
+    };
+    const isBrowserFederationMemberLoad = (node)=>{
+        if (!typescript.isCallExpression(node)) return false;
+        const callee = unwrapParentheses(node.expression);
+        if (!typescript.isPropertyAccessExpression(callee) || !FEDERATION_MEMBER_LOADERS.has(callee.name.text)) return false;
+        const receiverType = checker.getTypeAtLocation(callee.expression);
+        return void 0 !== receiverType && federationInstanceTypes().has(receiverType.id) && isBrowserGuarded(node);
+    };
+    return {
+        isBrowserFederationMemberLoad,
+        isBuildTargetCondition
+    };
+}
+export { createNativeShellRuntimeEvidence };

package/dist/esm-node/ultramodern-workspace/write-app.js

@@ -1,5 +1,4 @@
 import "node:module";
-import { createShellApiClient } from "./api.js";
 import { writeAppApiFiles } from "./api/write-app-api.js";
 import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
 import { createFederatedComponentsRegistry, createLayout, createRemoteEntry, createRemoteExposeComponent, createRemoteExposeFragmentPage, createRemotePage, createShellPage, createShellRemoteComponents, createShellWorkerRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
@@ -79,7 +78,7 @@ function writeAppFederationConfigFiles({ targetDir, scope, resolvedApp, emitsUi,
     if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, resolvedApp, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
     if (appHasApi(resolvedApp)) writeFile(targetDir, `${resolvedApp.directory}/backend-federation.config.ts`, createBackendModuleFederationConfig(resolvedApp));
 }
-function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, availableRemotes, publicWeb, writeAppFile }) {
+function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, publicWeb, writeAppFile }) {
     if (!emitsUi) return;
     if ((resolvedApp.verticalRefs?.length ?? 0) > 0) {
         writeAppFile('src/federated-components.tsx', createFederatedComponentsRegistry(scope, resolvedApp, remotes));
@@ -93,7 +92,6 @@ function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, re
         writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
         writeAppFile('src/routes/vertical-components.worker.tsx', createShellWorkerRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
         writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, availableRemotes));
     } else for (const expose of distributedSsrExposes(resolvedApp))writeAppFile(`src/routes/[lang]/_mf/fragment/${distributedSsrFragmentSlug(expose)}/page.tsx`, createRemoteExposeFragmentPage(resolvedApp, expose));
 }
 function writeAppRemoteExposeFiles({ resolvedApp, emitsUi, writeAppFile }) {

package/dist/types/ultramodern-workspace/api/client.d.ts

@@ -1,8 +1,7 @@
-import type { WorkspaceApi, WorkspaceApp } from '../types.js';
+import type { WorkspaceApi } from '../types.js';
 export declare function createApiClient(service: {
     id: string;
     api?: WorkspaceApi;
 }, contractImportPath: string, options?: {
     readonly scope: string;
 }): string;
-export declare function createShellApiClient(scope: string, remotes?: WorkspaceApp[]): string;

package/dist/types/ultramodern-workspace/api.d.ts

@@ -1,4 +1,4 @@
-export { createApiClient, createShellApiClient } from './api/client.js';
+export { createApiClient } from './api/client.js';
 export { apiTopologyMetadata } from './api/contracts.js';
 export { verticalApiCreatePayloadSchemaExport, verticalApiErrorStem, verticalApiExport, verticalApiGroupName, verticalApiMarkerSchemaExport, verticalApiName, verticalApiNotFoundErrorExport, verticalApiNotFoundSchemaExport, verticalApiReadinessSchemaExport, verticalApiSchemaExport, } from './api/names.js';
 export { createRpcApiServiceEntry, createRpcClientFile, createRpcContractFile, rpcPath, verticalRpcContractExport, verticalRpcGroupExport, } from './api/rpc.js';

package/dist/types/ultramodern-workspace/validation/native-shell-runtime.d.ts

@@ -0,0 +1,19 @@
+import type * as ts from '@typescript/native/unstable/ast';
+import type { Checker } from '@typescript/native/unstable/sync';
+type TypeScriptAst = typeof import('@typescript/native/unstable/ast');
+type TypeScriptApi = typeof import('@typescript/native/unstable/sync');
+export type ModernBuildTarget = 'browser' | 'node';
+/**
+ * Compiler evidence for shell source that branches on the framework build
+ * target and loads remotes through the native Module Federation instance.
+ *
+ * `process.env.MODERN_TARGET` is not ambient environment access: the Modern.js
+ * runtime plugin defines it as `'browser'` or `'node'` for every bundler
+ * environment, so a strict comparison is a compile-time constant that dead-code
+ * elimination folds per target.
+ */
+export declare function createNativeShellRuntimeEvidence(typescript: TypeScriptAst, typescriptApi: TypeScriptApi, checker: Checker, sourceFile: ts.SourceFile): {
+    isBrowserFederationMemberLoad: (node: ts.Node) => boolean;
+    isBuildTargetCondition: (node: ts.Node) => boolean;
+};
+export {};

package/package.json

@@ -26,7 +26,7 @@
   "engines": {
     "node": ">=26.10.0"
   },
-  "version": "3.9.3-ultramodern.1",
+  "version": "3.9.3-ultramodern.2",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/esm-node/index.js",
   "bin": {
@@ -86,22 +86,22 @@
     "@babel/core": "7.29.7",
     "@babel/parser": "^8.0.6",
     "@effect/tsgo": "0.47.2",
-    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.3-ultramodern.1",
-    "@modern-js/app-tools-extensions": "npm:@bleedingdev/modern-js-app-tools-extensions@3.9.3-ultramodern.1",
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.1",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.3-ultramodern.2",
+    "@modern-js/app-tools-extensions": "npm:@bleedingdev/modern-js-app-tools-extensions@3.9.3-ultramodern.2",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.2",
     "@modern-js/codesmith": "2.6.9",
-    "@modern-js/i18n-integration": "npm:@bleedingdev/modern-js-i18n-integration@3.9.3-ultramodern.1",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.9.3-ultramodern.1",
-    "@modern-js/plugin-bff-build-extensions": "npm:@bleedingdev/modern-js-plugin-bff-build-extensions@3.9.3-ultramodern.1",
-    "@modern-js/plugin-i18n": "npm:@bleedingdev/modern-js-plugin-i18n@3.9.3-ultramodern.1",
-    "@modern-js/plugin-tanstack": "npm:@bleedingdev/modern-js-plugin-tanstack@3.9.3-ultramodern.1",
-    "@modern-js/renderer-core": "npm:@bleedingdev/modern-js-renderer-core@3.9.3-ultramodern.1",
-    "@modern-js/renderer-octane": "npm:@bleedingdev/modern-js-renderer-octane@3.9.3-ultramodern.1",
-    "@modern-js/renderer-solid": "npm:@bleedingdev/modern-js-renderer-solid@3.9.3-ultramodern.1",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.1",
-    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.3-ultramodern.1",
-    "@modern-js/ultramodern-app-tools": "npm:@bleedingdev/modern-js-ultramodern-app-tools@3.9.3-ultramodern.1",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.1",
+    "@modern-js/i18n-integration": "npm:@bleedingdev/modern-js-i18n-integration@3.9.3-ultramodern.2",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.9.3-ultramodern.2",
+    "@modern-js/plugin-bff-build-extensions": "npm:@bleedingdev/modern-js-plugin-bff-build-extensions@3.9.3-ultramodern.2",
+    "@modern-js/plugin-i18n": "npm:@bleedingdev/modern-js-plugin-i18n@3.9.3-ultramodern.2",
+    "@modern-js/plugin-tanstack": "npm:@bleedingdev/modern-js-plugin-tanstack@3.9.3-ultramodern.2",
+    "@modern-js/renderer-core": "npm:@bleedingdev/modern-js-renderer-core@3.9.3-ultramodern.2",
+    "@modern-js/renderer-octane": "npm:@bleedingdev/modern-js-renderer-octane@3.9.3-ultramodern.2",
+    "@modern-js/renderer-solid": "npm:@bleedingdev/modern-js-renderer-solid@3.9.3-ultramodern.2",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.2",
+    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.3-ultramodern.2",
+    "@modern-js/ultramodern-app-tools": "npm:@bleedingdev/modern-js-ultramodern-app-tools@3.9.3-ultramodern.2",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.2",
     "@module-federation/modern-js-v3": "npm:@bleedingdev/mf-modern-js-v3@2.9.4",
     "@rsbuild/plugin-tailwindcss": "2.0.3",
     "@typescript/native": "npm:typescript@7.0.2",
@@ -118,7 +118,7 @@
     "zephyr-rspack-plugin": "1.4.2"
   },
   "devDependencies": {
-    "@modern-js/i18n-runtime-extensions": "npm:@bleedingdev/modern-js-i18n-runtime-extensions@3.9.3-ultramodern.1",
+    "@modern-js/i18n-runtime-extensions": "npm:@bleedingdev/modern-js-i18n-runtime-extensions@3.9.3-ultramodern.2",
     "@octanejs/rspack-plugin": "0.1.55",
     "@rslib/core": "1.0.3",
     "@scripts/rstest-config": "2.66.0",
@@ -142,6 +142,6 @@
   },
   "ultramodern": {
     "sourceName": "@modern-js/ultramodern-create",
-    "frameworkVersion": "3.9.3-ultramodern.1"
+    "frameworkVersion": "3.9.3-ultramodern.2"
   }
 }