@bleedingdev/modern-js-create 3.2.0-ultramodern.12 → 3.2.0-ultramodern.121

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

@@ -0,0 +1,56 @@
+import "node:module";
+const EN_LOCALE = {
+    prompt: {
+        projectName: 'Please enter project name: ',
+        legacyModernJsConfirmation: 'Type "{confirmation}" to continue with the original Modern.js setup: '
+    },
+    error: {
+        projectNameEmpty: 'Error: Project name cannot be empty',
+        directoryExists: 'Error: Directory "{projectName}" already exists and is not empty',
+        legacyModernJsNotConfirmed: 'Aborted. UltraModern.js remains the default unattended setup.',
+        createFailed: 'Error creating project:'
+    },
+    message: {
+        welcome: '🚀 Welcome to UltraModern.js',
+        success: '✨ Created successfully!',
+        nextSteps: '📋 Next steps:',
+        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!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+    },
+    help: {
+        title: '🚀 UltraModern.js Project Creator',
+        description: 'Create a new UltraModern.js SuperApp workspace with the full quality baseline by default',
+        usage: '📖 Usage:',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [project-name] [options]',
+        options: '⚙️  Options:',
+        optionHelp: '  -h, --help     Display this help message',
+        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)',
+        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)',
+        optionUltramodernPackageVersion: '      --ultramodern-package-version Pin the exact BleedingDev framework cohort for install package sources',
+        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-)',
+        optionVertical: '      --vertical Mutate the current existing UltraModern workspace and wire a MicroVertical named <project-name>',
+        optionLegacyModernJs: '      --legacy-modern-js Opt into the original Modern.js setup after a large warning and typed confirmation',
+        examples: '💡 Examples:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-workspace',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --no-tailwind',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --workspace',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        moreInfo: '📚 Learn more: https://modernjs.dev'
+    },
+    version: {
+        message: '{name} version: {version}'
+    }
+};
+export { EN_LOCALE };

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

@@ -0,0 +1,10 @@
+import "node:module";
+import { I18n } from "@modern-js/i18n-utils";
+import { EN_LOCALE } from "./en.js";
+import { ZH_LOCALE } from "./zh.js";
+const i18n = new I18n();
+const localeKeys = i18n.init('en', {
+    zh: ZH_LOCALE,
+    en: EN_LOCALE
+});
+export { i18n, localeKeys };

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

@@ -0,0 +1,56 @@
+import "node:module";
+const ZH_LOCALE = {
+    prompt: {
+        projectName: '请输入项目名称: ',
+        legacyModernJsConfirmation: '输入 "{confirmation}" 以继续使用原始 Modern.js 初始化: '
+    },
+    error: {
+        projectNameEmpty: '错误: 项目名称不能为空',
+        directoryExists: '错误: 目录 "{projectName}" 已存在且不为空',
+        legacyModernJsNotConfirmed: '已中止。UltraModern.js 仍是默认的免交互初始化方案。',
+        createFailed: '创建项目时出错:'
+    },
+    message: {
+        welcome: '🚀 欢迎使用 UltraModern.js',
+        success: '✨ 创建成功！',
+        nextSteps: '📋 下一步：',
+        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!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+    },
+    help: {
+        title: '🚀 UltraModern.js 项目创建工具',
+        description: '默认创建带完整质量基线的 UltraModern.js SuperApp 工作区',
+        usage: '📖 用法:',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [项目名称] [选项]',
+        options: '⚙️  选项:',
+        optionHelp: '  -h, --help     显示帮助信息',
+        optionVersion: '  -v, --version  显示版本信息',
+        optionLang: '  -l, --lang     设置语言 (默认 en；zh 需显式选择)',
+        optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 工作区样式',
+        optionBff: '      --bff 保留默认的 Effect BFF 脚手架（每个 MicroVertical 自带 Effect BFF）',
+        optionBffRuntime: '      --bff-runtime 选择 MicroVertical 脚手架的 BFF 运行时（支持: effect；默认: effect）',
+        optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
+        optionUltramodernPackageSource: '      --ultramodern-package-source 选择 UltraModern 依赖来源（workspace 或 install；BleedingDev 默认使用 install alias）',
+        optionUltramodernPackageVersion: '      --ultramodern-package-version 为 install 依赖来源固定精确的 BleedingDev 框架版本',
+        optionUltramodernPackageRegistry: '      --ultramodern-package-registry install 依赖来源使用的 npm registry 地址',
+        optionUltramodernPackageScope: '      --ultramodern-package-scope npm alias 安装使用的发布 scope（例如 bleedingdev）',
+        optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix npm alias 包名前缀（默认：modern-js-）',
+        optionVertical: '      --vertical 修改当前已有的 UltraModern 工作区，并接入名为 <项目名称> 的 MicroVertical',
+        optionLegacyModernJs: '      --legacy-modern-js 在大型警告和输入确认后，选择原始 Modern.js 初始化',
+        examples: '💡 示例:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-workspace',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --no-tailwind',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --workspace',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        moreInfo: '📚 更多信息: https://modernjs.dev'
+    },
+    version: {
+        message: '{name} 版本: {version}'
+    }
+};
+export { ZH_LOCALE };

package/dist/esm-node/ultramodern-package-source.js

@@ -0,0 +1,64 @@
+import "node:module";
+const WORKSPACE_PACKAGE_VERSION = 'workspace:*';
+const BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-create';
+const BLEEDINGDEV_PACKAGE_SCOPE = 'bleedingdev';
+const BLEEDINGDEV_PACKAGE_NAME_PREFIX = 'modern-js-';
+const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = 'MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION';
+const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = [
+    '@modern-js/create',
+    '@modern-js/code-tools',
+    '@modern-js/runtime',
+    '@modern-js/app-tools',
+    '@modern-js/tsconfig',
+    '@modern-js/plugin-i18n',
+    '@modern-js/plugin-tanstack',
+    '@modern-js/plugin-bff',
+    '@modern-js/adapter-rstest'
+];
+const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES = [
+    '@modern-js/create',
+    '@modern-js/code-tools',
+    '@modern-js/app-tools',
+    '@modern-js/plugin-bff',
+    '@modern-js/plugin-i18n',
+    '@modern-js/plugin-tanstack',
+    '@modern-js/runtime'
+];
+function modernPackageVersion(packageSource) {
+    return 'install' === packageSource.strategy ? packageSource.modernPackageVersion : WORKSPACE_PACKAGE_VERSION;
+}
+function modernAliasPackageName(packageName, packageSource) {
+    if (!packageSource.aliasScope) return packageName;
+    const scope = packageSource.aliasScope.replace(/^@/, '');
+    const unscopedName = packageName.split('/').at(-1);
+    return `@${scope}/${packageSource.aliasPackageNamePrefix ?? ''}${unscopedName}`;
+}
+function modernPackageSpecifier(packageName, packageSource) {
+    if ('install' !== packageSource.strategy) return WORKSPACE_PACKAGE_VERSION;
+    if (!packageSource.aliasScope) return packageSource.modernPackageVersion;
+    return `npm:${modernAliasPackageName(packageName, packageSource)}@${packageSource.modernPackageVersion}`;
+}
+function modernPackageAliases(packageNames, packageSource) {
+    if (!packageSource.aliasScope) return;
+    return Object.fromEntries(packageNames.map((packageName)=>[
+            packageName,
+            modernAliasPackageName(packageName, packageSource)
+        ]));
+}
+function createModernPackagesMetadata(packageNames, packageSource, options = {}) {
+    const includeAliases = options.includeAliases ?? Boolean(packageSource.aliasScope);
+    const aliases = includeAliases ? modernPackageAliases(packageNames, packageSource) : void 0;
+    return {
+        packages: [
+            ...packageNames
+        ],
+        specifier: modernPackageVersion(packageSource),
+        ...packageSource.registry ? {
+            registry: packageSource.registry
+        } : {},
+        ...aliases ? {
+            aliases
+        } : {}
+    };
+}
+export { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES, ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, createModernPackagesMetadata, modernAliasPackageName, modernPackageAliases, modernPackageSpecifier, modernPackageVersion };

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

@@ -0,0 +1,253 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { WORKSPACE_PACKAGE_VERSION } from "../ultramodern-package-source.js";
+import { createAppEnvDts, createAppRuntimeConfig, createShellFrameComponent } from "./app-files.js";
+import { createGeneratedContract } from "./contracts.js";
+import { createShellPage, createShellRemoteComponents } from "./demo-components.js";
+import { GENERATED_CONTRACT_PATH, appHasEffectApi, appI18nNamespace, createModuleFederationRemoteContracts, createNeutralOwnership, createShellHost, createVerticalDescriptor, effectApiPrefix, remoteDependencyAlias, shellApp, zephyrRemoteDependency } from "./descriptors.js";
+import { createShellEffectClient, effectApiTopologyMetadata } from "./effect-api.js";
+import { readJsonFile, writeFileReplacing, writeJsonFile } from "./fs-io.js";
+import { createAppPublicLocaleMessages } from "./locales.js";
+import { createShellModuleFederationConfig } from "./module-federation.js";
+import { assertUniqueTailwindPrefixes, packageName, toEnvSegment, toKebabCase, toPackageScope, toPascalCase } from "./naming.js";
+import { createAppPackage, createRootPackageJson } from "./package-json.js";
+import { resolvePackageSource } from "./package-source.js";
+import { createCloudflareDeployContract } from "./policy.js";
+import { createPublicWebAppArtifacts, rewriteWorkspaceAssetsForApp } from "./public-surface.js";
+import { isRecord } from "./types.js";
+import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
+import { writeApp } from "./write-workspace.js";
+const FIRST_VERTICAL_PORT = 4101;
+function existingPackageSource(workspaceRoot, modernVersion, packageSource) {
+    if (packageSource) return resolvePackageSource({
+        targetDir: workspaceRoot,
+        packageName: node_path.basename(workspaceRoot),
+        modernVersion,
+        packageSource
+    });
+    const metadataPath = node_path.join(workspaceRoot, '.modernjs/ultramodern-package-source.json');
+    if (!node_fs.existsSync(metadataPath)) return resolvePackageSource({
+        targetDir: workspaceRoot,
+        packageName: node_path.basename(workspaceRoot),
+        modernVersion
+    });
+    const metadata = readJsonFile(metadataPath);
+    const aliases = metadata.modernPackages?.aliases ?? {};
+    const firstAlias = Object.values(aliases).find((value)=>'string' == typeof value);
+    const firstPackage = Object.keys(aliases)[0];
+    const aliasScope = firstAlias?.match(/^@([^/]+)\//)?.[1];
+    const unscopedName = firstPackage?.split('/').at(-1) ?? '';
+    const aliasUnscopedName = firstAlias?.split('/').at(-1) ?? '';
+    const aliasPackageNamePrefix = aliasUnscopedName && unscopedName && aliasUnscopedName.endsWith(unscopedName) ? aliasUnscopedName.slice(0, -unscopedName.length) : void 0;
+    return {
+        strategy: 'install' === metadata.strategy ? 'install' : 'workspace',
+        modernPackageVersion: 'string' == typeof metadata.modernPackages?.specifier ? metadata.modernPackages.specifier : modernVersion,
+        registry: metadata.modernPackages?.registry,
+        aliasScope,
+        aliasPackageNamePrefix
+    };
+}
+function existingTailwindEnabled(workspaceRoot) {
+    const contractPath = node_path.join(workspaceRoot, GENERATED_CONTRACT_PATH);
+    if (!node_fs.existsSync(contractPath)) return true;
+    const contract = readJsonFile(contractPath);
+    const apps = isRecord(contract) && Array.isArray(contract.apps) ? contract.apps : [];
+    const shell = apps.find((app)=>isRecord(app) && app.id === shellApp.id);
+    return shell?.styling && isRecord(shell.styling) ? false !== shell.styling.tailwind : true;
+}
+function assertValidVerticalName(name) {
+    const normalized = toKebabCase(name);
+    if (!normalized || normalized !== name) throw new Error(`Invalid Vertical name "${name}". Use lowercase kebab-case.`);
+    return normalized;
+}
+function nextAvailablePort(ports) {
+    const numericPorts = Object.values(ports).filter((value)=>'number' == typeof value && Number.isFinite(value));
+    return Math.max(FIRST_VERTICAL_PORT - 1, ...numericPorts) + 1;
+}
+function assertCanCreate(workspaceRoot, relativePath) {
+    if (node_fs.existsSync(node_path.join(workspaceRoot, relativePath))) throw new Error(`Refusing to overwrite existing path: ${relativePath}`);
+}
+function updateRootWorkspaceScripts(workspaceRoot, scope, packageSource, remotes) {
+    const packagePath = node_path.join(workspaceRoot, 'package.json');
+    const rootPackage = readJsonFile(packagePath);
+    const generatedRootPackage = createRootPackageJson(scope, packageSource, remotes);
+    rootPackage.scripts = generatedRootPackage.scripts;
+    writeJsonFile(packagePath, rootPackage);
+}
+function rewriteShellAppFiles(workspaceRoot, scope, packageSource, enableTailwind, remotes) {
+    const shellHost = createShellHost(remotes);
+    const publicWeb = createPublicWebAppArtifacts(shellHost);
+    writeJsonFile(node_path.join(workspaceRoot, `${shellApp.directory}/package.json`), createAppPackage(scope, shellHost, packageSource, enableTailwind, remotes));
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(shellHost, remotes));
+    writeFileReplacing(workspaceRoot, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
+    writeFileReplacing(workspaceRoot, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
+    writeFileReplacing(workspaceRoot, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
+    for (const generatedFile of publicWeb.routeMetaFiles)writeFileReplacing(workspaceRoot, generatedFile.path, generatedFile.content);
+    rewriteWorkspaceAssetsForApp(workspaceRoot, shellHost);
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(shellHost, scope, remotes));
+    writeJsonFile(node_path.join(workspaceRoot, `${shellApp.directory}/locales/en/translation.json`), createAppPublicLocaleMessages(shellHost, 'en', remotes));
+    writeJsonFile(node_path.join(workspaceRoot, `${shellApp.directory}/locales/en/${appI18nNamespace(shellHost)}.json`), createAppPublicLocaleMessages(shellHost, 'en', remotes));
+    writeJsonFile(node_path.join(workspaceRoot, `${shellApp.directory}/locales/cs/translation.json`), createAppPublicLocaleMessages(shellHost, 'cs', remotes));
+    writeJsonFile(node_path.join(workspaceRoot, `${shellApp.directory}/locales/cs/${appI18nNamespace(shellHost)}.json`), createAppPublicLocaleMessages(shellHost, 'cs', remotes));
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/module-federation.config.ts`, createShellModuleFederationConfig(scope, remotes));
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/src/routes/[lang]/page.tsx`, createShellPage(remotes));
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/src/routes/vertical-components.tsx`, createShellRemoteComponents(scope, remotes));
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/src/routes/shell-frame.tsx`, createShellFrameComponent());
+    writeFileReplacing(workspaceRoot, `${shellApp.directory}/src/effect/vertical-clients.ts`, createShellEffectClient(scope, remotes));
+}
+function addShellZephyrDependency(workspaceRoot, scope, remote) {
+    const packagePath = node_path.join(workspaceRoot, shellApp.directory, 'package.json');
+    const shellPackage = readJsonFile(packagePath);
+    shellPackage['zephyr:dependencies'] ??= {};
+    shellPackage['zephyr:dependencies'][remoteDependencyAlias(remote)] = zephyrRemoteDependency(scope, remote);
+    writeJsonFile(packagePath, shellPackage);
+}
+function addShellWorkspaceDependency(workspaceRoot, scope, remote) {
+    if (!appHasEffectApi(remote)) return;
+    const packagePath = node_path.join(workspaceRoot, shellApp.directory, 'package.json');
+    const shellPackage = readJsonFile(packagePath);
+    shellPackage.dependencies ??= {};
+    shellPackage.dependencies[packageName(scope, remote.packageSuffix)] = WORKSPACE_PACKAGE_VERSION;
+    writeJsonFile(packagePath, shellPackage);
+}
+function verticalTopologyEntry(scope, vertical, remotes = []) {
+    return {
+        id: vertical.id,
+        kind: vertical.kind,
+        domain: vertical.domain,
+        package: packageName(scope, vertical.packageSuffix),
+        path: vertical.directory,
+        moduleFederation: {
+            role: 'remote',
+            name: vertical.mfName,
+            manifestUrl: `http://localhost:${vertical.port}/mf-manifest.json`,
+            exposes: Object.keys(vertical.exposes ?? {}),
+            ...vertical.verticalRefs?.length ? {
+                verticalRefs: vertical.verticalRefs,
+                remotes: createModuleFederationRemoteContracts(vertical, remotes)
+            } : {},
+            ssr: true,
+            fallbackTelemetryEvent: 'modernjs:mv-runtime-parity',
+            sharedContractVersion: 'mf-ssr-contract-v1'
+        },
+        ...effectApiTopologyMetadata(vertical) ? {
+            api: effectApiTopologyMetadata(vertical)
+        } : {},
+        cloudflare: createCloudflareDeployContract(scope, vertical),
+        ownership: vertical.ownership
+    };
+}
+function ownershipEntry(scope, owner) {
+    return {
+        id: owner.id,
+        package: packageName(scope, owner.packageSuffix),
+        path: owner.directory,
+        ownership: owner.ownership
+    };
+}
+function verticalsFromTopology(topology, ports) {
+    return (topology.verticals ?? []).map((vertical)=>{
+        const domain = vertical.domain ?? String(vertical.id);
+        const packageSuffix = vertical.package?.split('/').at(-1) ?? domain;
+        const effectApi = vertical.api?.effect ? {
+            stem: 'string' == typeof vertical.api.effect.basePath ? vertical.api.effect.basePath.split('/').filter(Boolean).at(-1) ?? domain : domain,
+            prefix: vertical.api.effect.bff?.prefix ?? `/${domain}-api`,
+            consumedBy: Array.isArray(vertical.api.effect.consumedBy) ? vertical.api.effect.consumedBy : [
+                shellApp.id,
+                vertical.id
+            ]
+        } : void 0;
+        return {
+            id: vertical.id,
+            directory: 'string' == typeof vertical.path ? vertical.path : `verticals/${domain}`,
+            packageSuffix,
+            displayName: vertical.displayName ?? `${toPascalCase(domain)} Vertical`,
+            kind: 'vertical',
+            domain,
+            portEnv: `VERTICAL_${toEnvSegment(domain)}_PORT`,
+            port: 'number' == typeof ports[vertical.id] ? ports[vertical.id] : 0,
+            mfName: vertical.moduleFederation?.name ?? `vertical${toPascalCase(domain)}`,
+            ...Array.isArray(vertical.moduleFederation?.exposes) ? {
+                exposes: Object.fromEntries(vertical.moduleFederation.exposes.map((expose)=>[
+                        expose,
+                        './Route' === expose ? './src/federation-entry.tsx' : './Widget' === expose ? `./src/components/${domain}-widget.tsx` : ''
+                    ]))
+            } : {},
+            ...Array.isArray(vertical.moduleFederation?.verticalRefs) ? {
+                verticalRefs: vertical.moduleFederation.verticalRefs
+            } : Array.isArray(vertical.moduleFederation?.remotes) ? {
+                verticalRefs: vertical.moduleFederation.remotes.map((entry)=>entry.id).filter((id)=>'string' == typeof id)
+            } : {},
+            ...effectApi ? {
+                effectApi
+            } : {},
+            ownership: vertical.ownership ?? createNeutralOwnership(vertical.id)
+        };
+    });
+}
+function addUltramodernVertical(options) {
+    const name = assertValidVerticalName(options.name);
+    const rootPackage = readJsonFile(node_path.join(options.workspaceRoot, 'package.json'));
+    const scope = toPackageScope(String(rootPackage.name ?? node_path.basename(options.workspaceRoot)));
+    const topologyPath = node_path.join(options.workspaceRoot, 'topology/reference-topology.json');
+    const ownershipPath = node_path.join(options.workspaceRoot, 'topology/ownership.json');
+    const overlayPath = node_path.join(options.workspaceRoot, 'topology/local-overlays/development.json');
+    for (const requiredPath of [
+        topologyPath,
+        ownershipPath,
+        overlayPath
+    ])if (!node_fs.existsSync(requiredPath)) throw new Error(`Missing UltraModern workspace file: ${requiredPath}`);
+    const topology = readJsonFile(topologyPath);
+    const ownership = readJsonFile(ownershipPath);
+    const overlay = readJsonFile(overlayPath);
+    overlay.ports ??= {};
+    const packageSource = existingPackageSource(options.workspaceRoot, options.modernVersion, options.packageSource);
+    const enableTailwind = options.enableTailwind ?? existingTailwindEnabled(options.workspaceRoot);
+    const port = nextAvailablePort(overlay.ports);
+    const vertical = createVerticalDescriptor(name, port);
+    assertCanCreate(options.workspaceRoot, vertical.directory);
+    if ((topology.verticals ?? []).some((entry)=>entry.id === vertical.id)) throw new Error(`Topology already contains ${vertical.id}`);
+    if (Object.values(overlay.ports).includes(vertical.port)) throw new Error(`Development port ${vertical.port} is already in use`);
+    writeApp(options.workspaceRoot, scope, vertical, packageSource, enableTailwind);
+    topology.shell ??= {};
+    topology.shell.verticalRefs ??= [];
+    topology.shell.verticalRefs.push(vertical.id);
+    topology.shell.moduleFederation ??= {};
+    topology.shell.moduleFederation.remotes ??= [];
+    topology.shell.moduleFederation.remotes.push({
+        id: vertical.id,
+        name: vertical.mfName,
+        manifestUrl: `http://localhost:${vertical.port}/mf-manifest.json`
+    });
+    topology.verticals ??= [];
+    topology.verticals.push(verticalTopologyEntry(scope, vertical));
+    ownership.owners ??= [];
+    ownership.owners.push(ownershipEntry(scope, vertical));
+    overlay.ports[vertical.id] = vertical.port;
+    overlay.manifests ??= {};
+    overlay.manifests[vertical.id] = `http://localhost:${vertical.port}/mf-manifest.json`;
+    overlay.apis ??= {};
+    overlay.apis[vertical.id] = `http://localhost:${vertical.port}${effectApiPrefix(vertical)}`;
+    writeJsonFile(topologyPath, topology);
+    writeJsonFile(ownershipPath, ownership);
+    writeJsonFile(overlayPath, overlay);
+    const updatedVerticals = verticalsFromTopology(topology, overlay.ports);
+    assertUniqueTailwindPrefixes([
+        shellApp,
+        ...updatedVerticals
+    ]);
+    writeJsonFile(node_path.join(options.workspaceRoot, GENERATED_CONTRACT_PATH), createGeneratedContract(scope, [
+        {
+            ...shellApp,
+            verticalRefs: updatedVerticals.map((vertical)=>vertical.id)
+        },
+        ...updatedVerticals
+    ], enableTailwind));
+    rewriteShellAppFiles(options.workspaceRoot, scope, packageSource, enableTailwind, updatedVerticals);
+    writeGeneratedWorkspaceScripts(options.workspaceRoot, scope, enableTailwind, updatedVerticals);
+    addShellZephyrDependency(options.workspaceRoot, scope, vertical);
+    addShellWorkspaceDependency(options.workspaceRoot, scope, vertical);
+    updateRootWorkspaceScripts(options.workspaceRoot, scope, packageSource, updatedVerticals);
+}
+export { addShellWorkspaceDependency, addShellZephyrDependency, addUltramodernVertical, assertCanCreate, assertValidVerticalName, existingPackageSource, existingTailwindEnabled, nextAvailablePort, ownershipEntry, rewriteShellAppFiles, updateRootWorkspaceScripts, verticalTopologyEntry, verticalsFromTopology };

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

@@ -0,0 +1,150 @@
+import "node:module";
+import { appI18nNamespace, remoteDependencyAlias, resolveRemoteRefs, shellApp } from "./descriptors.js";
+import { readFileTemplate, renderFileTemplate } from "./fs-io.js";
+import { packageName, tailwindPrefixForApp } from "./naming.js";
+function createBoundaryDebugMetadata(scope, remotes = []) {
+    return {
+        appId: shellApp.id,
+        boundaries: [
+            shellApp,
+            ...remotes
+        ].map((app)=>({
+                appId: app.id,
+                label: app.displayName,
+                mfName: app.mfName,
+                ownerTeam: app.ownership.team,
+                packageName: packageName(scope, app.packageSuffix),
+                role: 'shell' === app.kind ? 'host' : 'vertical'
+            })),
+        schemaVersion: 1
+    };
+}
+function createAppEnvDts(app, remotes = []) {
+    const remoteModuleDeclarations = resolveRemoteRefs(app, remotes).flatMap((remote)=>Object.keys(remote.exposes ?? {}).filter((expose)=>'./Route' !== expose).map((expose)=>{
+            const moduleName = `${remoteDependencyAlias(remote)}/${expose.replace(/^\.\//u, '')}`;
+            return `declare module '${moduleName}' {
+  const Component: React.ComponentType<Record<string, never>>;
+  export default Component;
+}
+`;
+        })).join('\n');
+    const reactTypeReference = remoteModuleDeclarations ? "/// <reference types='react' />\n" : '';
+    const siteUrlDeclaration = 'declare const ULTRAMODERN_SITE_URL: string;';
+    return `${reactTypeReference}/// <reference types='@modern-js/app-tools/types' />
+
+${siteUrlDeclaration}
+declare module '*.svg' {
+  const url: string;
+  export default url;
+}
+declare module '*.css';
+${remoteModuleDeclarations ? `\n${remoteModuleDeclarations}` : ''}`;
+}
+function createAppRuntimeConfig(app, scope, remotes = []) {
+    const pluginsConfig = 'shell' === app.kind ? `  plugins: [
+    ultramodernBoundaryDebuggerPlugin({
+      metadata: ${JSON.stringify(createBoundaryDebugMetadata(scope, remotes), null, 6).split('\n').join('\n      ')},
+    }),
+  ],
+` : '';
+    return `import { defineRuntimeConfig } from '@modern-js/runtime';
+${'shell' === app.kind ? "import { ultramodernBoundaryDebuggerPlugin } from '@modern-js/runtime/boundary-debugger';\n" : ''}import { createInstance } from 'i18next';
+import csResource from '../locales/cs/${appI18nNamespace(app)}.json';
+import enResource from '../locales/en/${appI18nNamespace(app)}.json';
+import { ultramodernRouteNamespace } from './routes/ultramodern-route-metadata';
+
+type LocaleResource = string | { readonly [key: string]: LocaleResource };
+
+const flattenLocaleResource = (
+  resource: LocaleResource,
+  prefix = '',
+): Record<string, string> => {
+  if (typeof resource === 'string') {
+    return prefix.length > 0 ? { [prefix]: resource } : {};
+  }
+
+  return Object.fromEntries(
+    Object.entries(resource).flatMap(([key, value]) => {
+      const nextKey = prefix.length > 0 ? \`\${prefix}.\${key}\` : key;
+      return typeof value === 'string'
+        ? [[nextKey, value]]
+        : Object.entries(flattenLocaleResource(value, nextKey));
+    }),
+  );
+};
+
+const i18nInstance = createInstance();
+const resources = {
+  cs: { [ultramodernRouteNamespace]: flattenLocaleResource(csResource) },
+  en: { [ultramodernRouteNamespace]: flattenLocaleResource(enResource) },
+} as const;
+
+export default defineRuntimeConfig({
+  i18n: {
+    i18nInstance,
+    initOptions: {
+      defaultNS: ultramodernRouteNamespace,
+      fallbackLng: 'en',
+      interpolation: {
+        escapeValue: false,
+      },
+      ns: [ultramodernRouteNamespace, 'translation'],
+      resources,
+      supportedLngs: ['en', 'cs'],
+    },
+  },
+${pluginsConfig}
+  router: {
+    framework: 'tanstack',
+  },
+});
+`;
+}
+function createCssTokenImport(scope) {
+    return `@import '${packageName(scope, 'shared-design-tokens')}/tokens.css';\n`;
+}
+function createTailwindImport(prefix) {
+    return `@import 'tailwindcss' prefix(${prefix}) source(none);\n@source '..';\n`;
+}
+function createShellStyles(enableTailwind, scope) {
+    return `${enableTailwind ? createTailwindImport(tailwindPrefixForApp(shellApp)) : ''}${createCssTokenImport(scope)}`;
+}
+function createRemoteStyles(enableTailwind, scope, app) {
+    return `${enableTailwind ? createTailwindImport(tailwindPrefixForApp(app)) : ''}${createCssTokenImport(scope)}`;
+}
+function createAppStyles(enableTailwind, scope, app) {
+    return 'shell' === app.kind ? createShellStyles(enableTailwind, scope) : createRemoteStyles(enableTailwind, scope, app);
+}
+function createPostcssConfig() {
+    return `export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};
+`;
+}
+function createTailwindConfig() {
+    return `import type { Config } from 'tailwindcss';
+
+export default {} satisfies Config;
+`;
+}
+function createSharedDesignTokensCss() {
+    return `@theme {
+  --color-um-accent: #2f8f68;
+  --color-um-canvas: #f1eadc;
+  --color-um-foreground: #133225;
+  --color-um-link: #166b4b;
+  --color-um-surface: #f6fbf7;
+}
+`;
+}
+function createRouteHeadModule(app) {
+    return renderFileTemplate('app/ultramodern-route-head.tsx', {
+        appDisplayNameJson: JSON.stringify(app.displayName)
+    });
+}
+function createShellFrameComponent() {
+    return readFileTemplate('app/shell-frame.tsx');
+}
+export { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createBoundaryDebugMetadata, createCssTokenImport, createPostcssConfig, createRemoteStyles, createRouteHeadModule, createSharedDesignTokensCss, createShellFrameComponent, createShellStyles, createTailwindConfig, createTailwindImport };