@bleedingdev/modern-js-create 3.4.0-ultramodern.8 → 3.5.0-ultramodern.0

package/dist/esm-node/index.js

@@ -7,7 +7,9 @@ import { fileURLToPath } from "node:url";
 import { resolveCreatePackageRoot } from "./create-package-root.js";
 import { i18n, localeKeys } from "./locale/index.js";
 import { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, WORKSPACE_PACKAGE_VERSION } from "./ultramodern-package-source.js";
+import { runUltramodernToolingCli } from "./ultramodern-tooling/commands.js";
 import { addUltramodernVertical, generateUltramodernWorkspace, planUltramodernVertical } from "./ultramodern-workspace/index.js";
+import { hasUltramodernBridgeCliOptions, parseUltramodernBridgeCliOptions, ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliValueFlags } from "./ultramodern-workspace/bridge-config.js";
 const src_dirname = node_path.dirname(fileURLToPath(import.meta.url));
 const createPackageRoot = resolveCreatePackageRoot(src_dirname);
 const semverPattern = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
@@ -85,6 +87,16 @@ function showHelp() {
     console.log(i18n.t(localeKeys.help.optionUltramodernPackageRegistry));
     console.log(i18n.t(localeKeys.help.optionUltramodernPackageScope));
     console.log(i18n.t(localeKeys.help.optionUltramodernPackageNamePrefix));
+    console.log(i18n.t(localeKeys.help.optionBridge));
+    console.log(i18n.t(localeKeys.help.optionBridgeParentRoot));
+    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackage));
+    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackageName));
+    console.log(i18n.t(localeKeys.help.optionBridgeTestAlias));
+    console.log(i18n.t(localeKeys.help.optionBridgeDependency));
+    console.log(i18n.t(localeKeys.help.optionBridgeLockfilePolicy));
+    console.log(i18n.t(localeKeys.help.optionBridgeGate));
+    console.log(i18n.t(localeKeys.help.optionBridgeGateCwd));
+    console.log(i18n.t(localeKeys.help.optionBridgeReactSingleton));
     console.log(i18n.t(localeKeys.help.optionVertical));
     console.log(i18n.t(localeKeys.help.optionVerticalName));
     console.log(i18n.t(localeKeys.help.optionDryRun));
@@ -173,7 +185,7 @@ function detectBffRuntime(args) {
         process.exit(1);
     }
     if (!SUPPORTED_BFF_RUNTIMES.includes(runtime)) {
-        console.error(`Unsupported BFF runtime "${runtime}". UltraModern workspaces scaffold an Effect BFF for every MicroVertical (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')}).`);
+        console.error(`Unsupported BFF runtime "${runtime}". UltraModern workspaces scaffold a strict Effect API runtime for every MicroVertical (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')}).`);
         process.exit(1);
     }
     return runtime;
@@ -198,7 +210,8 @@ function collectPositionalArgs(args) {
         '--ultramodern-package-scope',
         '--ultramodern-package-name-prefix',
         VERTICAL_NAME_FLAG,
-        CODESMITH_OVERLAY_FLAG
+        CODESMITH_OVERLAY_FLAG,
+        ...ultramodernBridgeCliValueFlags
     ]);
     const optionWithoutValue = new Set([
         '--help',
@@ -211,7 +224,8 @@ function collectPositionalArgs(args) {
         WORKSPACE_PROTOCOL_FLAG,
         DRY_RUN_FLAG,
         VERTICAL_FLAG,
-        LEGACY_MODERN_JS_FLAG
+        LEGACY_MODERN_JS_FLAG,
+        ...ultramodernBridgeCliBooleanFlags
     ]);
     const positionalArgs = [];
     for(let i = 0; i < args.length; i++){
@@ -221,7 +235,7 @@ function collectPositionalArgs(args) {
                 i += 1;
                 continue;
             }
-            if (!(arg.startsWith('--lang=') || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`))) positionalArgs.push(arg);
+            if (!(arg.startsWith('--lang=') || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`) || ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
         }
     }
     return positionalArgs;
@@ -337,6 +351,14 @@ function detectCodeSmithOverlays(args) {
     }
     return overlays.length > 0 ? overlays : void 0;
 }
+function readBridgeCliOptions(args) {
+    try {
+        return parseUltramodernBridgeCliOptions(args);
+    } catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
 function detectUltramodernPackageSource(args, defaultPackageVersion, createPackage) {
     const bleedingDevDefaults = isBleedingDevCreatePackage(createPackage);
     const strategy = getOptionValue(args, [
@@ -546,6 +568,10 @@ async function getProjectName() {
 }
 async function main() {
     const args = process.argv.slice(2);
+    if ('ultramodern' === args[0]) {
+        process.exitCode = await runUltramodernToolingCli(args.slice(1));
+        return;
+    }
     if (args.includes('--help') || args.includes('-h')) return void showHelp();
     if (args.includes('--version') || args.includes('-v')) return void showVersion();
     if (detectLegacyModernJsFlag(args)) {
@@ -557,10 +583,16 @@ async function main() {
     const dryRun = detectDryRunFlag(args);
     const verticalInput = resolveVerticalCliInput(args);
     const overlays = detectCodeSmithOverlays(args);
+    const bridgeRequested = hasUltramodernBridgeCliOptions(args);
     if (dryRun && !verticalInput.addVertical) {
         console.error(`${DRY_RUN_FLAG} is currently supported only with ${VERTICAL_FLAG}`);
         process.exit(1);
     }
+    if (verticalInput.addVertical && bridgeRequested) {
+        console.error('Bridge options are supported only when creating a new UltraModern workspace.');
+        process.exit(1);
+    }
+    const bridge = readBridgeCliOptions(args);
     if (!dryRun) console.log(`\n${i18n.t(localeKeys.message.welcome)}\n`);
     const createPackage = readCreatePackageJson();
     const version = createPackage.version || 'latest';
@@ -601,6 +633,7 @@ async function main() {
         packageName: generatedPackageName,
         modernVersion: version,
         enableTailwind: detectTailwindFlag(),
+        bridge,
         overlays,
         packageSource
     });

package/dist/esm-node/locale/en.js

@@ -19,7 +19,7 @@ const EN_LOCALE = {
         step1: 'cd {projectName}',
         step2: 'pnpm install',
         step3: 'pnpm dev',
-        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\nBRUTAL WARNING: YOU ARE OPTING OUT OF ULTRAMODERN.JS DEFAULTS.\nThe unattended default is the best UltraModern.js configuration:\na structured SuperApp workspace, presetUltramodern, TanStack Router,\nEffect BFF, Tailwind CSS v4, and the BleedingDev package cohort.\nThe original Modern.js setup is a dangerous opt-in path.\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\nBRUTAL WARNING: YOU ARE OPTING OUT OF ULTRAMODERN.JS DEFAULTS.\nThe unattended default is the best UltraModern.js configuration:\na structured SuperApp workspace, presetUltramodern, TanStack Router,\na strict Effect API runtime, Tailwind CSS v4, and the BleedingDev package cohort.\nThe original Modern.js setup is a dangerous opt-in path.\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
     },
     help: {
         title: '🚀 UltraModern.js Project Creator',
@@ -31,7 +31,7 @@ const EN_LOCALE = {
         optionVersion: '  -v, --version  Display version information',
         optionLang: '  -l, --lang     Set the language (en default; zh opt-in)',
         optionTailwind: '      --no-tailwind Disable default Tailwind CSS v4 workspace styling',
-        optionBff: '      --bff Keep the default Effect BFF scaffolding (every MicroVertical ships an Effect BFF)',
+        optionBff: '      --bff Keep the default strict Effect API runtime (every MicroVertical ships one)',
         optionBffRuntime: '      --bff-runtime Select the BFF runtime for scaffolded MicroVerticals (supported: effect; default: effect)',
         optionWorkspace: '      --workspace Use workspace protocol for @modern-js dependencies (for local monorepo testing)',
         optionUltramodernPackageSource: '      --ultramodern-package-source Select UltraModern package source (workspace or install; BleedingDev defaults to install aliases)',
@@ -39,6 +39,16 @@ const EN_LOCALE = {
         optionUltramodernPackageRegistry: '      --ultramodern-package-registry npm registry URL used for install package sources',
         optionUltramodernPackageScope: '      --ultramodern-package-scope Publish scope for npm alias installs (for example bleedingdev)',
         optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix Prefix for npm alias package names (default: modern-js-)',
+        optionBridge: '      --bridge Enable explicit nested parent-monorepo bridge mode for new workspaces',
+        optionBridgeParentRoot: '      --bridge-parent-root <path> Parent monorepo root for bridge mode',
+        optionBridgeWorkspacePackage: '      --bridge-workspace-package <glob> Parent workspace package glob consumed by generated apps',
+        optionBridgeWorkspacePackageName: '      --bridge-workspace-package-name <glob=package[,package]> Package names covered by a bridge workspace glob',
+        optionBridgeTestAlias: '      --bridge-test-alias <glob:alias=target> Test/source alias for a bridge workspace package glob',
+        optionBridgeDependency: '      --bridge-dependency <package[,package]> Explicit parent package dependency consumed by generated apps',
+        optionBridgeLockfilePolicy: '      --bridge-lockfile-policy <nested|parent> Bridge lockfile ownership policy (default: nested)',
+        optionBridgeGate: '      --bridge-gate <name=command> Delegated parent workspace gate command for bridge packages',
+        optionBridgeGateCwd: '      --bridge-gate-cwd <name=cwd> Working directory for a named bridge gate',
+        optionBridgeReactSingleton: '      --bridge-react-singleton <package[,package]> React singleton package expectation (default: react,react-dom)',
         optionVertical: '      --vertical[=<name>] Mutate the current existing UltraModern workspace and wire a MicroVertical',
         optionVerticalName: '      --vertical-name <name> Explicit MicroVertical name for automation-friendly workspace mutation',
         optionDryRun: '      --dry-run Preview a MicroVertical mutation plan without writing files (supported with --vertical)',

package/dist/esm-node/locale/zh.js

@@ -19,7 +19,7 @@ const ZH_LOCALE = {
         step1: 'cd {projectName}',
         step2: 'pnpm install',
         step3: 'pnpm dev',
-        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n严重警告：你正在退出 ULTRAMODERN.JS 默认配置。\n免交互默认值是最佳 UltraModern.js 配置：\n结构化 SuperApp 工作区、presetUltramodern、TanStack Router、\nEffect BFF、Tailwind CSS v4，以及 BleedingDev 包版本队列。\n原始 Modern.js 初始化是危险的显式选择路径。\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n严重警告：你正在退出 ULTRAMODERN.JS 默认配置。\n免交互默认值是最佳 UltraModern.js 配置：\n结构化 SuperApp 工作区、presetUltramodern、TanStack Router、\n严格 Effect API 运行时、Tailwind CSS v4，以及 BleedingDev 包版本队列。\n原始 Modern.js 初始化是危险的显式选择路径。\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
     },
     help: {
         title: '🚀 UltraModern.js 项目创建工具',
@@ -31,7 +31,7 @@ const ZH_LOCALE = {
         optionVersion: '  -v, --version  显示版本信息',
         optionLang: '  -l, --lang     设置语言 (默认 en；zh 需显式选择)',
         optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 工作区样式',
-        optionBff: '      --bff 保留默认的 Effect BFF 脚手架（每个 MicroVertical 自带 Effect BFF）',
+        optionBff: '      --bff 保留默认的严格 Effect API 运行时（每个 MicroVertical 自带一个）',
         optionBffRuntime: '      --bff-runtime 选择 MicroVertical 脚手架的 BFF 运行时（支持: effect；默认: effect）',
         optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
         optionUltramodernPackageSource: '      --ultramodern-package-source 选择 UltraModern 依赖来源（workspace 或 install；BleedingDev 默认使用 install alias）',
@@ -39,6 +39,16 @@ const ZH_LOCALE = {
         optionUltramodernPackageRegistry: '      --ultramodern-package-registry install 依赖来源使用的 npm registry 地址',
         optionUltramodernPackageScope: '      --ultramodern-package-scope npm alias 安装使用的发布 scope（例如 bleedingdev）',
         optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix npm alias 包名前缀（默认：modern-js-）',
+        optionBridge: '      --bridge 为新工作区启用显式的嵌套父 monorepo 桥接模式',
+        optionBridgeParentRoot: '      --bridge-parent-root <路径> 桥接模式使用的父 monorepo 根目录',
+        optionBridgeWorkspacePackage: '      --bridge-workspace-package <glob> 生成应用消费的父工作区包 glob',
+        optionBridgeWorkspacePackageName: '      --bridge-workspace-package-name <glob=包名[,包名]> 桥接工作区 glob 覆盖的包名',
+        optionBridgeTestAlias: '      --bridge-test-alias <glob:别名=目标> 桥接工作区包 glob 的测试/源码 alias',
+        optionBridgeDependency: '      --bridge-dependency <包名[,包名]> 生成应用显式消费的父包依赖',
+        optionBridgeLockfilePolicy: '      --bridge-lockfile-policy <nested|parent> 桥接 lockfile 归属策略（默认：nested）',
+        optionBridgeGate: '      --bridge-gate <名称=命令> 桥接包委托给父工作区执行的 gate 命令',
+        optionBridgeGateCwd: '      --bridge-gate-cwd <名称=目录> 指定桥接 gate 的工作目录',
+        optionBridgeReactSingleton: '      --bridge-react-singleton <包名[,包名]> React 单例包预期（默认：react,react-dom）',
         optionVertical: '      --vertical[=<名称>] 修改当前已有的 UltraModern 工作区，并接入 MicroVertical',
         optionVerticalName: '      --vertical-name <名称> 为自动化工作流显式指定 MicroVertical 名称',
         optionDryRun: '      --dry-run 预览 MicroVertical 修改计划但不写入文件（与 --vertical 一起使用）',

package/dist/esm-node/ultramodern-tooling/commands.js

@@ -0,0 +1,133 @@
+import "node:module";
+import { spawnSync } from "node:child_process";
+import node_fs from "node:fs";
+import node_os from "node:os";
+import node_path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveCreatePackageRoot } from "../create-package-root.js";
+import { validateModuleFederationTypes } from "../ultramodern-workspace/mf-validation.js";
+import { createWorkspaceValidationScript } from "../ultramodern-workspace/workspace-scripts.js";
+import { readUltramodernConfig, workspaceAppsFromToolingConfig } from "./config.js";
+const commands_dirname = node_path.dirname(fileURLToPath(import.meta.url));
+const createPackageRoot = resolveCreatePackageRoot(commands_dirname);
+function printHelp() {
+    process.stdout.write(`Usage:
+  modern-js-create ultramodern <command> [args]
+
+Commands:
+  validate
+  typecheck
+  mf-types
+  public-surface
+  cloudflare-proof
+  performance-readiness
+  skills install
+  skills check
+`);
+}
+function spawnNodeScript(relativeScriptPath, args, context, options = {}) {
+    const scriptPath = node_path.join(createPackageRoot, relativeScriptPath);
+    const result = spawnSync(process.execPath, [
+        scriptPath,
+        ...args
+    ], {
+        cwd: options.cwd ?? context.workspaceRoot,
+        env: {
+            ...process.env,
+            ULTRAMODERN_WORKSPACE_ROOT: context.workspaceRoot
+        },
+        stdio: 'inherit'
+    });
+    if (result.error) throw result.error;
+    return result.status ?? 1;
+}
+function runRenderedModule(source, context) {
+    const tempDir = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), 'ultramodern-tool-'));
+    const tempFile = node_path.join(tempDir, 'command.mjs');
+    try {
+        node_fs.writeFileSync(tempFile, source, 'utf-8');
+        const result = spawnSync(process.execPath, [
+            tempFile
+        ], {
+            cwd: context.workspaceRoot,
+            stdio: 'inherit'
+        });
+        if (result.error) throw result.error;
+        return result.status ?? 1;
+    } finally{
+        node_fs.rmSync(tempDir, {
+            force: true,
+            recursive: true
+        });
+    }
+}
+function runValidate(context) {
+    const config = readUltramodernConfig(context.workspaceRoot);
+    const apps = workspaceAppsFromToolingConfig(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    const source = createWorkspaceValidationScript(config.workspace.packageScope, config.features.tailwind, remotes);
+    return runRenderedModule(source, context);
+}
+function runMfTypes(args, context) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(`Usage:
+  modern-js-create ultramodern mf-types [app-dir...]
+
+Checks real Module Federation config files and DTS archives for exposed apps.
+`);
+        return 0;
+    }
+    validateModuleFederationTypes({
+        workspaceRoot: context.workspaceRoot,
+        appDirs: args.length > 0 ? args : void 0
+    });
+    return 0;
+}
+function runSkills(args, context) {
+    const [subcommand, ...rest] = args;
+    if ('install' === subcommand) return spawnNodeScript("template-workspace/scripts/bootstrap-agent-skills.mjs", rest, context);
+    if ('check' === subcommand) return spawnNodeScript("template-workspace/scripts/bootstrap-agent-skills.mjs", [
+        '--check',
+        ...rest
+    ], context);
+    throw new Error('Usage: modern-js-create ultramodern skills <install|check>');
+}
+async function runUltramodernToolingCli(args, workspaceRoot = process.env.ULTRAMODERN_WORKSPACE_ROOT ?? process.cwd()) {
+    try {
+        const [command, ...rest] = args;
+        const context = {
+            workspaceRoot: node_path.resolve(workspaceRoot),
+            invocationCwd: process.cwd()
+        };
+        switch(command){
+            case void 0:
+            case '--help':
+            case '-h':
+                printHelp();
+                return 0;
+            case 'validate':
+                return runValidate(context);
+            case 'typecheck':
+                return spawnNodeScript("templates/workspace-scripts/ultramodern-typecheck.mjs", rest, context, {
+                    cwd: context.invocationCwd
+                });
+            case 'mf-types':
+                return runMfTypes(rest, context);
+            case 'public-surface':
+                return spawnNodeScript("templates/workspace-scripts/generate-public-surface-assets.mjs", rest, context);
+            case 'cloudflare-proof':
+                return spawnNodeScript("templates/workspace-scripts/proof-cloudflare-version.mjs", rest, context);
+            case 'performance-readiness':
+                return spawnNodeScript("templates/workspace-scripts/ultramodern-performance-readiness.mjs", rest, context);
+            case 'skills':
+                return runSkills(rest, context);
+            default:
+                throw new Error(`Unknown UltraModern command: ${command}`);
+        }
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[ultramodern] ${message}\n`);
+        return 1;
+    }
+}
+export { runUltramodernToolingCli };

package/dist/esm-node/ultramodern-tooling/config.js

@@ -0,0 +1,121 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { normalizeUltramodernBridgeConfig } from "../ultramodern-workspace/bridge-config.js";
+import { ULTRAMODERN_CONFIG_PATH, createNeutralOwnership, shellApp } from "../ultramodern-workspace/descriptors.js";
+import { toKebabCase } from "../ultramodern-workspace/naming.js";
+function readJsonObject(filePath) {
+    const value = JSON.parse(node_fs.readFileSync(filePath, 'utf-8'));
+    if (null === value || 'object' != typeof value || Array.isArray(value)) throw new Error(`UltraModern config must contain a JSON object: ${filePath}`);
+    return value;
+}
+function readOptionalJsonObject(filePath) {
+    return node_fs.existsSync(filePath) ? readJsonObject(filePath) : {};
+}
+function packageScopeFromRoot(workspaceRoot1) {
+    const rootPackage = readOptionalJsonObject(node_path.join(workspaceRoot1, 'package.json'));
+    return 'string' == typeof rootPackage.name && rootPackage.name.length > 0 ? rootPackage.name : node_path.basename(workspaceRoot1);
+}
+function normalizeCompactConfig(sourcePath, config) {
+    const packageSource = config.packageSource && 'object' == typeof config.packageSource ? {
+        strategy: 'install' === config.packageSource.strategy ? 'install' : 'workspace',
+        modernPackageVersion: 'string' == typeof config.packageSource.modernPackageVersion ? config.packageSource.modernPackageVersion : 'workspace:*',
+        registry: 'string' == typeof config.packageSource.registry ? config.packageSource.registry : void 0,
+        aliasScope: 'string' == typeof config.packageSource.aliasScope ? config.packageSource.aliasScope : void 0,
+        aliasPackageNamePrefix: 'string' == typeof config.packageSource.aliasPackageNamePrefix ? config.packageSource.aliasPackageNamePrefix : void 0
+    } : void 0;
+    return {
+        schemaVersion: 'number' == typeof config.schemaVersion ? config.schemaVersion : 1,
+        profile: 'string' == typeof config.profile ? config.profile : void 0,
+        source: 'compact',
+        sourcePath,
+        workspace: {
+            packageScope: 'string' == typeof config.workspace?.packageScope ? config.workspace.packageScope : packageScopeFromRoot(workspaceRoot)
+        },
+        packageSource,
+        features: {
+            tailwind: config.features?.tailwind !== false
+        },
+        bridge: normalizeUltramodernBridgeConfig(config.bridge),
+        topology: {
+            apps: Array.isArray(config.topology?.apps) ? config.topology.apps.map((app)=>({
+                    id: String(app.id),
+                    kind: 'vertical' === app.kind ? 'vertical' : 'shell',
+                    path: 'string' == typeof app.path ? app.path : '.',
+                    package: 'string' == typeof app.package ? app.package : void 0,
+                    packageSuffix: 'string' == typeof app.packageSuffix ? app.packageSuffix : void 0,
+                    displayName: 'string' == typeof app.displayName ? app.displayName : void 0,
+                    domain: 'string' == typeof app.domain ? app.domain : void 0,
+                    port: 'number' == typeof app.port ? app.port : void 0,
+                    portEnv: 'string' == typeof app.portEnv ? app.portEnv : void 0,
+                    moduleFederation: app.moduleFederation && 'object' == typeof app.moduleFederation ? {
+                        role: 'remote' === app.moduleFederation.role ? 'remote' : 'host',
+                        name: 'string' == typeof app.moduleFederation.name ? app.moduleFederation.name : void 0,
+                        exposes: Array.isArray(app.moduleFederation.exposes) ? app.moduleFederation.exposes.filter((expose)=>'string' == typeof expose) : void 0,
+                        exposePaths: null === app.moduleFederation.exposePaths || 'object' != typeof app.moduleFederation.exposePaths || Array.isArray(app.moduleFederation.exposePaths) ? void 0 : Object.fromEntries(Object.entries(app.moduleFederation.exposePaths).filter((entry)=>'string' == typeof entry[0] && 'string' == typeof entry[1])),
+                        verticalRefs: Array.isArray(app.moduleFederation.verticalRefs) ? app.moduleFederation.verticalRefs.filter((ref)=>'string' == typeof ref) : void 0,
+                        hostOnly: true === app.moduleFederation.hostOnly,
+                        noExposes: true === app.moduleFederation.noExposes
+                    } : void 0,
+                    api: app.api && 'object' == typeof app.api ? {
+                        stem: 'string' == typeof app.api.stem ? app.api.stem : String(app.id),
+                        prefix: 'string' == typeof app.api.prefix ? app.api.prefix : `/${String(app.id)}-api`,
+                        consumedBy: Array.isArray(app.api.consumedBy) ? app.api.consumedBy.filter((consumer)=>'string' == typeof consumer) : [
+                            shellApp.id,
+                            String(app.id)
+                        ]
+                    } : void 0
+                })) : []
+        }
+    };
+}
+function readUltramodernConfig(workspaceRoot1 = process.cwd()) {
+    const compactPath = node_path.join(workspaceRoot1, ULTRAMODERN_CONFIG_PATH);
+    if (node_fs.existsSync(compactPath)) return normalizeCompactConfig(compactPath, readJsonObject(compactPath));
+    throw new Error(`Missing UltraModern config. Expected ${ULTRAMODERN_CONFIG_PATH}.`);
+}
+function workspaceAppsFromToolingConfig(config) {
+    return config.topology.apps.map((app)=>{
+        if ('shell' === app.kind) return {
+            ...shellApp,
+            directory: app.path,
+            packageSuffix: app.packageSuffix ?? shellApp.packageSuffix,
+            displayName: app.displayName ?? shellApp.displayName,
+            port: app.port ?? shellApp.port,
+            portEnv: app.portEnv ?? shellApp.portEnv,
+            mfName: app.moduleFederation?.name ?? shellApp.mfName,
+            verticalRefs: app.moduleFederation?.verticalRefs ?? []
+        };
+        const domain = app.domain ?? app.id;
+        const packageSuffix = app.packageSuffix ?? domain;
+        const exposePaths = app.moduleFederation?.exposePaths ?? {};
+        const exposes = Object.fromEntries((app.moduleFederation?.exposes ?? []).map((expose)=>{
+            const configuredPath = exposePaths[expose];
+            const inferredPath = './Route' === expose ? './src/federation-entry.tsx' : './Widget' === expose ? `./src/components/${domain}-widget.tsx` : `./src/components/${toKebabCase(expose.replace(/^\.\//u, ''))}.tsx`;
+            return [
+                expose,
+                configuredPath ?? inferredPath
+            ];
+        }));
+        return {
+            id: app.id,
+            directory: app.path,
+            packageSuffix,
+            displayName: app.displayName ?? `${domain} Vertical`,
+            kind: 'vertical',
+            domain,
+            portEnv: app.portEnv ?? `VERTICAL_${domain.replace(/[^a-zA-Z0-9]+/g, '_').toUpperCase()}_PORT`,
+            port: app.port ?? 0,
+            mfName: app.moduleFederation?.name ?? app.id,
+            exposes,
+            ...app.moduleFederation?.verticalRefs ? {
+                verticalRefs: app.moduleFederation.verticalRefs
+            } : {},
+            ...app.api ? {
+                api: app.api
+            } : {},
+            ownership: createNeutralOwnership(app.id)
+        };
+    });
+}
+export { readUltramodernConfig, workspaceAppsFromToolingConfig };