@bleedingdev/modern-js-ultramodern-create 3.9.3-ultramodern.3 → 3.9.3-ultramodern.5

package/README.md

@@ -365,6 +365,30 @@ Cloudflare Worker output. The shell consumes vertical UI through Module
 Federation manifests and vertical APIs through generated Effect clients
 exported by the vertical packages.
 
+Shell routes load federated modules through `createLazyComponent` or the
+generated loaders. A route that drives the runtime itself calls
+`loadRemote()` or `loadShare()` on the instance from `getInstance()`
+(`@module-federation/modern-js-v3/runtime`), and only inside the true branch
+of `import.meta.env.MODERN_TARGET === 'browser'`:
+
+```tsx
+import { getInstance } from '@module-federation/modern-js-v3/runtime';
+
+export const loadWidget = () => {
+  if (import.meta.env.MODERN_TARGET === 'browser') {
+    const host = getInstance();
+    if (host !== null) return host.loadRemote('inventory/Widget');
+  }
+  return undefined;
+};
+```
+
+The React composition defines `import.meta.env.MODERN_TARGET` per bundle as
+`'browser'` or `'node'`, the same value as `process.env.MODERN_TARGET`, so the
+server bundle drops the branch. Shell routes must not read `process.env`:
+`pnpm typecheck` rejects it through Effect's `processEnv` rule and
+`pnpm contract:check` rejects it too.
+
 Route metadata is route-owned and colocated in
 `src/routes/**/route.meta.ts`; each file exports `routeMeta`.
 `ultramodern-create ultramodern routes-generate` (run before every app `dev`

package/dist/cjs/ultramodern-workspace/module-federation/config.cjs

@@ -104,7 +104,8 @@ ${'rest' === (0, external_descriptors_cjs_namespaceObject.resolveApiProtocol)(ap
             localisedUrls: '            localisedUrls: ultramodernLocalisedUrls as Record<string, Record<string, string>>,\n'
         }) : '',
         bffPlugin: (0, external_descriptors_cjs_namespaceObject.appHasApi)(app) ? '        bffPlugin(),\n' : '',
-        federationPlugin: emitsUi ? '        moduleFederationPlugin(),\n' : ''
+        federationPlugin: emitsUi ? '        moduleFederationPlugin(),\n' : '',
+        renderer: emitsUi ? `      renderer: '${renderer}',\n` : ''
     });
 }
 function createModuleFederationBridgeConfig(enableBridgeRouter) {

package/dist/cjs/ultramodern-workspace/validation/architecture.cjs

@@ -417,7 +417,8 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                     if ((0, external_assertions_cjs_namespaceObject.sameJson)(accessPath, [
                         'process',
                         'env'
-                    ]) && !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');
+                    ])) compilerFailure(sourceFile, node, 'framework config API direct-process-env-access', isShellRoute ? 'Shell routes must not read process.env.' : 'Generated config must use the framework config environment API instead of process.env.', isShellRoute ? 'branch on import.meta.env.MODERN_TARGET for the build target' : 'use getBuildConfigEnvironment');
+                    if (!isShellRoute && (0, external_native_shell_runtime_cjs_namespaceObject.isBuildTargetAccess)(typescript, node)) compilerFailure(sourceFile, node, 'framework config API build-target-outside-bundle', 'Config runs in Node, where the framework defines no import.meta.env.MODERN_TARGET.', '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);

package/dist/cjs/ultramodern-workspace/validation/native-shell-runtime.cjs

@@ -32,42 +32,23 @@ const FEDERATION_MEMBER_LOADERS = new Set([
     'loadRemote',
     'loadShare'
 ]);
-const DECLARATION_FILE = /\.d\.[cm]?ts$/u;
+function isBuildTargetAccess(typescript, node) {
+    if (!typescript.isPropertyAccessExpression(node) || void 0 !== node.questionDotToken || 'MODERN_TARGET' !== node.name.text) return false;
+    const env = node.expression;
+    return typescript.isPropertyAccessExpression(env) && void 0 === env.questionDotToken && 'env' === env.name.text && typescript.isMetaProperty(env.expression) && env.expression.keywordToken === typescript.SyntaxKind.ImportKeyword && 'meta' === env.expression.name.text;
+}
 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;
+        const literal = isBuildTargetAccess(typescript, node.left) ? node.right : isBuildTargetAccess(typescript, 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 ? [
@@ -118,16 +99,18 @@ function createNativeShellRuntimeEvidence(typescript, typescriptApi, checker, so
         return void 0 !== receiverType && federationInstanceTypes().has(receiverType.id) && isBrowserGuarded(node);
     };
     return {
-        isBrowserFederationMemberLoad,
-        isBuildTargetCondition
+        isBrowserFederationMemberLoad
     };
 }
 __webpack_require__.d(__webpack_exports__, {
-    createNativeShellRuntimeEvidence: ()=>createNativeShellRuntimeEvidence
+    createNativeShellRuntimeEvidence: ()=>createNativeShellRuntimeEvidence,
+    isBuildTargetAccess: ()=>isBuildTargetAccess
 });
 exports.createNativeShellRuntimeEvidence = __webpack_exports__.createNativeShellRuntimeEvidence;
+exports.isBuildTargetAccess = __webpack_exports__.isBuildTargetAccess;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "createNativeShellRuntimeEvidence"
+    "createNativeShellRuntimeEvidence",
+    "isBuildTargetAccess"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true

package/dist/esm/ultramodern-workspace/module-federation/config.js

@@ -68,7 +68,8 @@ ${'rest' === resolveApiProtocol(app) ? "          openapi: {\n            path:
             localisedUrls: '            localisedUrls: ultramodernLocalisedUrls as Record<string, Record<string, string>>,\n'
         }) : '',
         bffPlugin: appHasApi(app) ? '        bffPlugin(),\n' : '',
-        federationPlugin: emitsUi ? '        moduleFederationPlugin(),\n' : ''
+        federationPlugin: emitsUi ? '        moduleFederationPlugin(),\n' : '',
+        renderer: emitsUi ? `      renderer: '${renderer}',\n` : ''
     });
 }
 function createModuleFederationBridgeConfig(enableBridgeRouter) {

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

@@ -4,7 +4,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 { createNativeShellRuntimeEvidence, isBuildTargetAccess } from "./native-shell-runtime.js";
 import { isForeignRendererPackage } from "./renderer.js";
 function assertCompilerArchitecture(root, workspaceValidationContract) {
     const fullStackVerticals = workspaceValidationContract.apps.filter((app)=>'shell' !== app.kind);
@@ -374,7 +374,8 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                     if (sameJson(accessPath, [
                         'process',
                         'env'
-                    ]) && !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');
+                    ])) compilerFailure(sourceFile, node, 'framework config API direct-process-env-access', isShellRoute ? 'Shell routes must not read process.env.' : 'Generated config must use the framework config environment API instead of process.env.', isShellRoute ? 'branch on import.meta.env.MODERN_TARGET for the build target' : 'use getBuildConfigEnvironment');
+                    if (!isShellRoute && isBuildTargetAccess(typescript, node)) compilerFailure(sourceFile, node, 'framework config API build-target-outside-bundle', 'Config runs in Node, where the framework defines no import.meta.env.MODERN_TARGET.', '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);

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

@@ -3,42 +3,23 @@ const FEDERATION_MEMBER_LOADERS = new Set([
     'loadRemote',
     'loadShare'
 ]);
-const DECLARATION_FILE = /\.d\.[cm]?ts$/u;
+function isBuildTargetAccess(typescript, node) {
+    if (!typescript.isPropertyAccessExpression(node) || void 0 !== node.questionDotToken || 'MODERN_TARGET' !== node.name.text) return false;
+    const env = node.expression;
+    return typescript.isPropertyAccessExpression(env) && void 0 === env.questionDotToken && 'env' === env.name.text && typescript.isMetaProperty(env.expression) && env.expression.keywordToken === typescript.SyntaxKind.ImportKeyword && 'meta' === env.expression.name.text;
+}
 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;
+        const literal = isBuildTargetAccess(typescript, node.left) ? node.right : isBuildTargetAccess(typescript, 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 ? [
@@ -89,8 +70,7 @@ function createNativeShellRuntimeEvidence(typescript, typescriptApi, checker, so
         return void 0 !== receiverType && federationInstanceTypes().has(receiverType.id) && isBrowserGuarded(node);
     };
     return {
-        isBrowserFederationMemberLoad,
-        isBuildTargetCondition
+        isBrowserFederationMemberLoad
     };
 }
-export { createNativeShellRuntimeEvidence };
+export { createNativeShellRuntimeEvidence, isBuildTargetAccess };

package/dist/esm-node/ultramodern-workspace/module-federation/config.js

@@ -69,7 +69,8 @@ ${'rest' === resolveApiProtocol(app) ? "          openapi: {\n            path:
             localisedUrls: '            localisedUrls: ultramodernLocalisedUrls as Record<string, Record<string, string>>,\n'
         }) : '',
         bffPlugin: appHasApi(app) ? '        bffPlugin(),\n' : '',
-        federationPlugin: emitsUi ? '        moduleFederationPlugin(),\n' : ''
+        federationPlugin: emitsUi ? '        moduleFederationPlugin(),\n' : '',
+        renderer: emitsUi ? `      renderer: '${renderer}',\n` : ''
     });
 }
 function createModuleFederationBridgeConfig(enableBridgeRouter) {

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

@@ -5,7 +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 { createNativeShellRuntimeEvidence, isBuildTargetAccess } from "./native-shell-runtime.js";
 import { isForeignRendererPackage } from "./renderer.js";
 function assertCompilerArchitecture(root, workspaceValidationContract) {
     const fullStackVerticals = workspaceValidationContract.apps.filter((app)=>'shell' !== app.kind);
@@ -375,7 +375,8 @@ function assertCompilerArchitecture(root, workspaceValidationContract) {
                     if (sameJson(accessPath, [
                         'process',
                         'env'
-                    ]) && !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');
+                    ])) compilerFailure(sourceFile, node, 'framework config API direct-process-env-access', isShellRoute ? 'Shell routes must not read process.env.' : 'Generated config must use the framework config environment API instead of process.env.', isShellRoute ? 'branch on import.meta.env.MODERN_TARGET for the build target' : 'use getBuildConfigEnvironment');
+                    if (!isShellRoute && isBuildTargetAccess(typescript, node)) compilerFailure(sourceFile, node, 'framework config API build-target-outside-bundle', 'Config runs in Node, where the framework defines no import.meta.env.MODERN_TARGET.', '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);

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

@@ -4,42 +4,23 @@ const FEDERATION_MEMBER_LOADERS = new Set([
     'loadRemote',
     'loadShare'
 ]);
-const DECLARATION_FILE = /\.d\.[cm]?ts$/u;
+function isBuildTargetAccess(typescript, node) {
+    if (!typescript.isPropertyAccessExpression(node) || void 0 !== node.questionDotToken || 'MODERN_TARGET' !== node.name.text) return false;
+    const env = node.expression;
+    return typescript.isPropertyAccessExpression(env) && void 0 === env.questionDotToken && 'env' === env.name.text && typescript.isMetaProperty(env.expression) && env.expression.keywordToken === typescript.SyntaxKind.ImportKeyword && 'meta' === env.expression.name.text;
+}
 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;
+        const literal = isBuildTargetAccess(typescript, node.left) ? node.right : isBuildTargetAccess(typescript, 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 ? [
@@ -90,8 +71,7 @@ function createNativeShellRuntimeEvidence(typescript, typescriptApi, checker, so
         return void 0 !== receiverType && federationInstanceTypes().has(receiverType.id) && isBrowserGuarded(node);
     };
     return {
-        isBrowserFederationMemberLoad,
-        isBuildTargetCondition
+        isBrowserFederationMemberLoad
     };
 }
-export { createNativeShellRuntimeEvidence };
+export { createNativeShellRuntimeEvidence, isBuildTargetAccess };

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

@@ -4,16 +4,19 @@ 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.
+ * `import.meta.env.MODERN_TARGET`, the framework build target. The React
+ * composition 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. `import.meta` cannot be rebound by
+ * application code, and generated type checking admits it where Effect's
+ * `processEnv` diagnostic rejects `process.env`.
+ */
+export declare function isBuildTargetAccess(typescript: TypeScriptAst, node: ts.Node): node is ts.PropertyAccessExpression;
+/**
+ * Compiler evidence for shell source that loads remotes through the native
+ * Module Federation instance inside a browser build-target branch.
  */
 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.3",
+  "version": "3.9.3-ultramodern.5",
   "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.3",
-    "@modern-js/app-tools-extensions": "npm:@bleedingdev/modern-js-app-tools-extensions@3.9.3-ultramodern.3",
-    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.3",
+    "@modern-js/app-tools": "npm:@bleedingdev/modern-js-app-tools@3.9.3-ultramodern.5",
+    "@modern-js/app-tools-extensions": "npm:@bleedingdev/modern-js-app-tools-extensions@3.9.3-ultramodern.5",
+    "@modern-js/backend-federation-contracts": "npm:@bleedingdev/modern-js-backend-federation-contracts@3.9.3-ultramodern.5",
     "@modern-js/codesmith": "2.6.9",
-    "@modern-js/i18n-integration": "npm:@bleedingdev/modern-js-i18n-integration@3.9.3-ultramodern.3",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.9.3-ultramodern.3",
-    "@modern-js/plugin-bff-build-extensions": "npm:@bleedingdev/modern-js-plugin-bff-build-extensions@3.9.3-ultramodern.3",
-    "@modern-js/plugin-i18n": "npm:@bleedingdev/modern-js-plugin-i18n@3.9.3-ultramodern.3",
-    "@modern-js/plugin-tanstack": "npm:@bleedingdev/modern-js-plugin-tanstack@3.9.3-ultramodern.3",
-    "@modern-js/renderer-core": "npm:@bleedingdev/modern-js-renderer-core@3.9.3-ultramodern.3",
-    "@modern-js/renderer-octane": "npm:@bleedingdev/modern-js-renderer-octane@3.9.3-ultramodern.3",
-    "@modern-js/renderer-solid": "npm:@bleedingdev/modern-js-renderer-solid@3.9.3-ultramodern.3",
-    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.3",
-    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.3-ultramodern.3",
-    "@modern-js/ultramodern-app-tools": "npm:@bleedingdev/modern-js-ultramodern-app-tools@3.9.3-ultramodern.3",
-    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.3",
+    "@modern-js/i18n-integration": "npm:@bleedingdev/modern-js-i18n-integration@3.9.3-ultramodern.5",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.9.3-ultramodern.5",
+    "@modern-js/plugin-bff-build-extensions": "npm:@bleedingdev/modern-js-plugin-bff-build-extensions@3.9.3-ultramodern.5",
+    "@modern-js/plugin-i18n": "npm:@bleedingdev/modern-js-plugin-i18n@3.9.3-ultramodern.5",
+    "@modern-js/plugin-tanstack": "npm:@bleedingdev/modern-js-plugin-tanstack@3.9.3-ultramodern.5",
+    "@modern-js/renderer-core": "npm:@bleedingdev/modern-js-renderer-core@3.9.3-ultramodern.5",
+    "@modern-js/renderer-octane": "npm:@bleedingdev/modern-js-renderer-octane@3.9.3-ultramodern.5",
+    "@modern-js/renderer-solid": "npm:@bleedingdev/modern-js-renderer-solid@3.9.3-ultramodern.5",
+    "@modern-js/runtime": "npm:@bleedingdev/modern-js-runtime@3.9.3-ultramodern.5",
+    "@modern-js/runtime-renderer-extensions": "npm:@bleedingdev/modern-js-runtime-renderer-extensions@3.9.3-ultramodern.5",
+    "@modern-js/ultramodern-app-tools": "npm:@bleedingdev/modern-js-ultramodern-app-tools@3.9.3-ultramodern.5",
+    "@modern-js/utils": "npm:@bleedingdev/modern-js-utils@3.9.3-ultramodern.5",
     "@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.3",
+    "@modern-js/i18n-runtime-extensions": "npm:@bleedingdev/modern-js-i18n-runtime-extensions@3.9.3-ultramodern.5",
     "@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.3"
+    "frameworkVersion": "3.9.3-ultramodern.5"
   }
 }

package/release-cohort.json

@@ -54,252 +54,252 @@
     {
       "sourceName": "@modern-js/adapter-rstest",
       "targetName": "@bleedingdev/modern-js-adapter-rstest",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/app-tools",
       "targetName": "@bleedingdev/modern-js-app-tools",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/app-tools-extensions",
       "targetName": "@bleedingdev/modern-js-app-tools-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/backend-federation-contracts",
       "targetName": "@bleedingdev/modern-js-backend-federation-contracts",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/bff-core",
       "targetName": "@bleedingdev/modern-js-bff-core",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/bff-effect",
       "targetName": "@bleedingdev/modern-js-bff-effect",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/bff-runtime",
       "targetName": "@bleedingdev/modern-js-bff-runtime",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/boundary-debugger",
       "targetName": "@bleedingdev/modern-js-boundary-debugger",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/builder",
       "targetName": "@bleedingdev/modern-js-builder",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/code-tools",
       "targetName": "@bleedingdev/modern-js-code-tools",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/create-request",
       "targetName": "@bleedingdev/modern-js-create-request",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/federation-runtime",
       "targetName": "@bleedingdev/modern-js-federation-runtime",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/i18n-integration",
       "targetName": "@bleedingdev/modern-js-i18n-integration",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/i18n-runtime-extensions",
       "targetName": "@bleedingdev/modern-js-i18n-runtime-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/i18n-utils",
       "targetName": "@bleedingdev/modern-js-i18n-utils",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/image",
       "targetName": "@bleedingdev/modern-js-image",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/main-doc",
       "targetName": "@bleedingdev/modern-js-main-doc",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin",
       "targetName": "@bleedingdev/modern-js-plugin",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-bff",
       "targetName": "@bleedingdev/modern-js-plugin-bff",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-bff-build-extensions",
       "targetName": "@bleedingdev/modern-js-plugin-bff-build-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-bff-extensions",
       "targetName": "@bleedingdev/modern-js-plugin-bff-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-data-loader",
       "targetName": "@bleedingdev/modern-js-plugin-data-loader",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-i18n",
       "targetName": "@bleedingdev/modern-js-plugin-i18n",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-polyfill",
       "targetName": "@bleedingdev/modern-js-plugin-polyfill",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-ssg",
       "targetName": "@bleedingdev/modern-js-plugin-ssg",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-styled-components",
       "targetName": "@bleedingdev/modern-js-plugin-styled-components",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/plugin-tanstack",
       "targetName": "@bleedingdev/modern-js-plugin-tanstack",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/prod-server",
       "targetName": "@bleedingdev/modern-js-prod-server",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/render",
       "targetName": "@bleedingdev/modern-js-render",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/renderer-core",
       "targetName": "@bleedingdev/modern-js-renderer-core",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/renderer-octane",
       "targetName": "@bleedingdev/modern-js-renderer-octane",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/renderer-solid",
       "targetName": "@bleedingdev/modern-js-renderer-solid",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/runtime",
       "targetName": "@bleedingdev/modern-js-runtime",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/runtime-extensions",
       "targetName": "@bleedingdev/modern-js-runtime-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/runtime-renderer-extensions",
       "targetName": "@bleedingdev/modern-js-runtime-renderer-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/runtime-utils",
       "targetName": "@bleedingdev/modern-js-runtime-utils",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/sandpack-react",
       "targetName": "@bleedingdev/modern-js-sandpack-react",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/server",
       "targetName": "@bleedingdev/modern-js-server",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/server-core",
       "targetName": "@bleedingdev/modern-js-server-core",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/server-runtime",
       "targetName": "@bleedingdev/modern-js-server-runtime",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/server-runtime-extensions",
       "targetName": "@bleedingdev/modern-js-server-runtime-extensions",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/server-utils",
       "targetName": "@bleedingdev/modern-js-server-utils",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/surface-resolution",
       "targetName": "@bleedingdev/modern-js-surface-resolution",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/tsconfig",
       "targetName": "@bleedingdev/modern-js-tsconfig",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/types",
       "targetName": "@bleedingdev/modern-js-types",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/ultramodern-app-tools",
       "targetName": "@bleedingdev/modern-js-ultramodern-app-tools",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/ultramodern-create",
       "targetName": "@bleedingdev/modern-js-ultramodern-create",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/ultramodern-sandpack-profile",
       "targetName": "@bleedingdev/modern-js-ultramodern-sandpack-profile",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     },
     {
       "sourceName": "@modern-js/utils",
       "targetName": "@bleedingdev/modern-js-utils",
-      "version": "3.9.3-ultramodern.3"
+      "version": "3.9.3-ultramodern.5"
     }
   ],
   "release": {
     "tag": "latest",
-    "version": "3.9.3-ultramodern.3"
+    "version": "3.9.3-ultramodern.5"
   },
   "schema": "bleedingdev.ultramodern.release-cohort",
   "schemaVersion": 2,
@@ -398,7 +398,7 @@
     }
   ],
   "source": {
-    "commit": "456db809fc1015ba28371e80aeab7c6ccbb5747b",
+    "commit": "981dc5f2536faa044d1058f8da35cf0b3120b994",
     "repository": "ultramodernjs/ultramodern.js"
   }
 }

package/templates/workspace/apps/modern.config.ts.handlebars

@@ -8,8 +8,7 @@ export default defineConfig(
     {
 {{bffConfig}}{{builderPlugins}}      plugins: [
 {{uiPlugins}}{{bffPlugin}}{{federationPlugin}}      ],
-      renderer: 'react',
-    },
+{{renderer}}    },
     {
       appId: '{{appId}}',
       from: import.meta.url,

package/templates/workspace-scripts/ultramodern-performance-readiness.mjs

@@ -89,6 +89,7 @@ const readGeneratedContractView = () => {
         id: app.id,
         path: app.path,
         api: app.api,
+        renderer: app.renderer,
         surfaceProfile: app.surfaceProfile,
         deploy: { cloudflare: app.cloudflare },
         moduleFederation: { remotes: app.moduleFederation?.remotes ?? [] },
@@ -129,6 +130,8 @@ const evaluateApp = (app, contract, failOn) => {
   );
   const remotes = app.moduleFederation?.remotes ?? [];
   const apiOnly = app.surfaceProfile === 'api-only';
+  // Headless units (renderer `none`) render no UI, so they have no router.
+  const rendersUi = !apiOnly && app.renderer !== 'none';
   const cloudflareRoutes = app.deploy?.cloudflare?.routes;
   const apiRouteKey = app.api?.protocol === 'rpc' ? 'rpc' : 'apiReadiness';
   const otherApiRouteKey = apiRouteKey === 'rpc' ? 'apiReadiness' : 'rpc';
@@ -189,14 +192,14 @@ const evaluateApp = (app, contract, failOn) => {
     ),
     createSignal(
       'save-data-behavior',
-      /\btanstackRouterPlugin\b/u.test(generatedSource) &&
+      (!rendersUi || /\btanstackRouterPlugin\b/u.test(generatedSource)) &&
         contract.performanceReadiness?.signals?.some(
           signal => signal.id === 'save-data-behavior',
         )
         ? 'configuration-valid'
         : 'configuration-invalid',
       [
-        'tanstack-router-plugin-declared',
+        rendersUi ? 'tanstack-router-plugin-declared' : 'ui-router-absent',
         'runtime-save-data-behavior-not-measured',
       ],
     ),