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

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

@@ -0,0 +1,121 @@
+import node_fs from "node:fs";
+import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createPostcssConfig, createSharedDesignTokensCss, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
+import { createDevelopmentOverlay, createGeneratedContract, createOwnership, createPackageSourceMetadata, createTemplateManifest, createTopology } from "./contracts.js";
+import { createLayout, createRemoteEntry, createRemoteExposeComponent, createRemotePage, createShellPage, createShellRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
+import { GENERATED_CONTRACT_PATH, appHasEffectApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
+import { createEffectClient, createEffectServiceEntry, createEffectSharedApi, createShellEffectClient } from "./effect-api.js";
+import { copyRootTemplate, writeFile, writeJson } from "./fs-io.js";
+import { createAppPublicLocaleMessages } from "./locales.js";
+import { createAppModernConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig, createUltramodernBuildModule } from "./module-federation.js";
+import { assertUniqueTailwindPrefixes, relativeRootFor, toPackageScope } from "./naming.js";
+import { createAppPackage, createPackageTsConfig, createRootPackageJson, createSharedContractsIndex, createSharedPackage, createTsConfigBase } from "./package-json.js";
+import { resolvePackageSource } from "./package-source.js";
+import { createPublicWebAppArtifacts } from "./public-surface.js";
+import { NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_VERSION } from "./versions.js";
+import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
+function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = []) {
+    const resolvedApp = 'shell' === app.kind ? createShellHost(remotes) : app;
+    const publicWeb = createPublicWebAppArtifacts(resolvedApp);
+    const writeAppFile = (relativePath, content)=>{
+        writeFile(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
+    };
+    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.json`, createPackageTsConfig(resolvedApp.directory, appHasEffectApi(resolvedApp)));
+    writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes));
+    writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildModule(scope, resolvedApp));
+    writeFile(targetDir, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
+    writeFile(targetDir, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
+    writeFile(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
+    writeFile(targetDir, `${resolvedApp.directory}/modern.config.ts`, createAppModernConfig(scope, resolvedApp));
+    writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/en/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
+    writeFile(targetDir, `${resolvedApp.directory}/src/routes/index.css`, createAppStyles(enableTailwind, scope, resolvedApp));
+    if (enableTailwind) {
+        writeFile(targetDir, `${resolvedApp.directory}/postcss.config.mjs`, createPostcssConfig());
+        writeFile(targetDir, `${resolvedApp.directory}/tailwind.config.ts`, createTailwindConfig());
+    }
+    writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
+    writeAppFile('src/routes/layout.tsx', createLayout(resolvedApp.id));
+    writeAppFile('src/routes/[lang]/page.tsx', 'shell' === resolvedApp.kind ? createShellPage(remotes) : createRemotePage(resolvedApp));
+    for (const generatedFile of publicWeb.routeMetaFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
+    for (const generatedFile of publicWeb.routeAliasFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
+    if ('shell' === resolvedApp.kind) {
+        writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(scope, remotes));
+        writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent());
+        writeFile(targetDir, `${resolvedApp.directory}/src/effect/vertical-clients.ts`, createShellEffectClient(scope, remotes));
+    }
+    if (appHasEffectApi(resolvedApp)) {
+        writeFile(targetDir, `${resolvedApp.directory}/shared/effect/api.ts`, createEffectSharedApi(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/effect/index.ts`, createEffectServiceEntry(resolvedApp, '../../shared/effect/api.ts'));
+        writeFile(targetDir, `${resolvedApp.directory}/src/effect/${resolvedApp.effectApi.stem}-client.ts`, createEffectClient(resolvedApp, '../../shared/effect/api'));
+    }
+    if ('vertical' === resolvedApp.kind) {
+        writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));
+        for (const expose of Object.keys(resolvedApp.exposes ?? {})){
+            const outputPath = remoteComponentOutputPath(resolvedApp, expose);
+            if (outputPath) writeAppFile(outputPath.slice(resolvedApp.directory.length + 1), createRemoteExposeComponent(resolvedApp, expose));
+        }
+    }
+}
+function writeSharedPackages(targetDir, scope) {
+    for (const sharedPackage of sharedPackages){
+        writeJson(targetDir, `${sharedPackage.directory}/package.json`, createSharedPackage(scope, sharedPackage.id, sharedPackage.description));
+        writeJson(targetDir, `${sharedPackage.directory}/tsconfig.json`, {
+            extends: `${relativeRootFor(sharedPackage.directory)}/tsconfig.base.json`,
+            include: [
+                'src'
+            ]
+        });
+    }
+    writeFile(targetDir, 'packages/shared-contracts/src/index.ts', createSharedContractsIndex());
+    writeFile(targetDir, 'packages/shared-design-tokens/src/index.ts', `export const sharedDesignTokens = {
+  color: {
+    accent: '#2f8f68',
+    foreground: '#133225',
+    surface: '#f6fbf7',
+  },
+} as const;
+`);
+    writeFile(targetDir, 'packages/shared-design-tokens/src/tokens.css', createSharedDesignTokensCss());
+}
+function generateUltramodernWorkspace(options) {
+    const scope = toPackageScope(options.packageName);
+    const packageSource = resolvePackageSource(options);
+    const enableTailwind = false !== options.enableTailwind;
+    const initialVerticals = [];
+    assertUniqueTailwindPrefixes([
+        shellApp,
+        ...initialVerticals
+    ]);
+    node_fs.mkdirSync(options.targetDir, {
+        recursive: true
+    });
+    copyRootTemplate(options.targetDir, {
+        packageName: options.packageName,
+        packageScope: scope,
+        nodeVersion: NODE_VERSION,
+        pnpmVersion: PNPM_VERSION,
+        nodeFetchVersion: NODE_FETCH_VERSION,
+        tanstackRouterVersion: TANSTACK_ROUTER_VERSION,
+        tailwindEnabled: String(enableTailwind)
+    });
+    writeJson(options.targetDir, 'package.json', createRootPackageJson(scope, packageSource, initialVerticals));
+    writeJson(options.targetDir, 'tsconfig.base.json', createTsConfigBase());
+    writeJson(options.targetDir, 'topology/reference-topology.json', createTopology(scope, initialVerticals));
+    writeJson(options.targetDir, 'topology/ownership.json', createOwnership(scope, initialVerticals));
+    writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(initialVerticals));
+    writeJson(options.targetDir, '.modernjs/ultramodern-workspace-template-manifest.json', createTemplateManifest(options.modernVersion, packageSource));
+    writeJson(options.targetDir, '.modernjs/ultramodern-package-source.json', createPackageSourceMetadata(scope, packageSource));
+    writeJson(options.targetDir, GENERATED_CONTRACT_PATH, createGeneratedContract(scope, [
+        createShellHost(initialVerticals),
+        ...initialVerticals
+    ], enableTailwind));
+    writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals);
+    for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals);
+    writeSharedPackages(options.targetDir, scope);
+    writeGeneratedWorkspaceScripts(options.targetDir, scope, enableTailwind, initialVerticals);
+}
+export { generateUltramodernWorkspace, writeApp, writeSharedPackages };

package/dist/esm-node/create-package-root.js

@@ -1,17 +1,15 @@
 import "node:module";
 import node_fs from "node:fs";
 import node_path from "node:path";
+const MAX_WALK_UP_LEVELS = 5;
 function resolveCreatePackageRoot(fromDir) {
-    const candidates = [
-        fromDir,
-        node_path.resolve(fromDir, '..'),
-        node_path.resolve(fromDir, '..', '..')
-    ];
-    const seen = new Set();
-    for (const candidate of candidates)if (!seen.has(candidate)) {
-        seen.add(candidate);
+    let candidate = fromDir;
+    for(let level = 0; level <= MAX_WALK_UP_LEVELS; level++){
         if (node_fs.existsSync(node_path.join(candidate, 'package.json')) && node_fs.existsSync(node_path.join(candidate, 'template-workspace'))) return candidate;
+        const parent = node_path.dirname(candidate);
+        if (parent === candidate) break;
+        candidate = parent;
     }
-    throw new Error('Unable to resolve create package root');
+    throw new Error(`Unable to resolve the @modern-js/create package root (a directory containing both package.json and template-workspace/) within ${MAX_WALK_UP_LEVELS} levels above ${fromDir}`);
 }
 export { resolveCreatePackageRoot };

package/dist/esm-node/index.js

@@ -7,12 +7,19 @@ 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 { addUltramodernVertical, generateUltramodernWorkspace } from "./ultramodern-workspace.js";
+import { addUltramodernVertical, generateUltramodernWorkspace } from "./ultramodern-workspace/index.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.-]+)?$/;
 const LEGACY_MODERN_JS_FLAG = '--legacy-modern-js';
 const LEGACY_MODERN_JS_CONFIRMATION = 'USE LEGACY MODERN.JS';
+const WORKSPACE_PROTOCOL_FLAG = '--workspace';
+const BFF_FLAG = '--bff';
+const BFF_RUNTIME_OPTION = '--bff-runtime';
+const SUPPORTED_BFF_RUNTIMES = [
+    'effect'
+];
+const REGISTRY_LOOKUP_TIMEOUT_MS = 15000;
 function getOptionValue(args, names) {
     for (const name of names){
         const prefix = `${name}=`;
@@ -46,8 +53,10 @@ function getBleedingDevFrameworkVersion(createPackage, fallbackVersion) {
 }
 function showVersion() {
     const createPackage = readCreatePackageJson();
+    const name = createPackage.name || '@modern-js/create';
     const version = createPackage.version || 'unknown';
     console.log(i18n.t(localeKeys.version.message, {
+        name,
         version
     }));
     process.exit(0);
@@ -63,20 +72,26 @@ function showHelp() {
     console.log(i18n.t(localeKeys.help.optionHelp));
     console.log(i18n.t(localeKeys.help.optionVersion));
     console.log(i18n.t(localeKeys.help.optionLang));
-    if (localeKeys.help.optionTailwind) console.log(i18n.t(localeKeys.help.optionTailwind));
-    if (localeKeys.help.optionUltramodernPackageSource) console.log(i18n.t(localeKeys.help.optionUltramodernPackageSource));
-    if (localeKeys.help.optionUltramodernPackageScope) console.log(i18n.t(localeKeys.help.optionUltramodernPackageScope));
-    if (localeKeys.help.optionUltramodernPackageNamePrefix) console.log(i18n.t(localeKeys.help.optionUltramodernPackageNamePrefix));
-    if (localeKeys.help.optionVertical) console.log(i18n.t(localeKeys.help.optionVertical));
-    if (localeKeys.help.optionLegacyModernJs) console.log(i18n.t(localeKeys.help.optionLegacyModernJs));
+    console.log(i18n.t(localeKeys.help.optionTailwind));
+    console.log(i18n.t(localeKeys.help.optionBff));
+    console.log(i18n.t(localeKeys.help.optionBffRuntime));
+    console.log(i18n.t(localeKeys.help.optionWorkspace));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageSource));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageVersion));
+    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.optionVertical));
+    console.log(i18n.t(localeKeys.help.optionLegacyModernJs));
     console.log('');
     console.log(i18n.t(localeKeys.help.examples));
     console.log(i18n.t(localeKeys.help.example1));
     console.log(i18n.t(localeKeys.help.example2));
-    if (localeKeys.help.example4) console.log(i18n.t(localeKeys.help.example4));
-    if (localeKeys.help.example5) console.log(i18n.t(localeKeys.help.example5));
-    if (localeKeys.help.example6) console.log(i18n.t(localeKeys.help.example6));
-    if (localeKeys.help.example12) console.log(i18n.t(localeKeys.help.example12));
+    console.log(i18n.t(localeKeys.help.example3));
+    console.log(i18n.t(localeKeys.help.example4));
+    console.log(i18n.t(localeKeys.help.example5));
+    console.log(i18n.t(localeKeys.help.example6));
+    console.log(i18n.t(localeKeys.help.example7));
     console.log('');
     console.log(i18n.t(localeKeys.help.moreInfo));
     console.log('');
@@ -133,6 +148,26 @@ function delegateLegacyModernJsSetup(args) {
     });
     throw new Error('Legacy Modern.js setup requires pnpm or npx to run @modern-js/create.');
 }
+function detectBffRuntime(args) {
+    if (args.some((arg)=>arg.startsWith(`${BFF_FLAG}=`))) {
+        console.error(`${BFF_FLAG} does not accept a value. Use: ${BFF_RUNTIME_OPTION} <runtime>`);
+        process.exit(1);
+    }
+    const runtimeRequested = args.some((arg)=>arg === BFF_RUNTIME_OPTION || arg.startsWith(`${BFF_RUNTIME_OPTION}=`));
+    if (!runtimeRequested) return 'effect';
+    const runtime = getOptionValue(args, [
+        BFF_RUNTIME_OPTION
+    ]);
+    if (!runtime) {
+        console.error(`${BFF_RUNTIME_OPTION} requires a value (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')})`);
+        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(', ')}).`);
+        process.exit(1);
+    }
+    return runtime;
+}
 function detectTailwindFlag() {
     const args = process.argv.slice(2);
     return !args.includes('--no-tailwind');
@@ -184,7 +219,7 @@ function hasExplicitUltramodernPackageSource(args, value) {
     ]);
     return value ? configuredValue === value : void 0 !== configuredValue;
 }
-function readBleedingDevFrameworkVersionFromRegistry() {
+function readBleedingDevFrameworkVersionFromRegistry(fallbackVersion) {
     const envVersion = process.env[BLEEDINGDEV_FRAMEWORK_VERSION_ENV]?.trim();
     if (envVersion) {
         if (!semverPattern.test(envVersion)) {
@@ -199,16 +234,19 @@ function readBleedingDevFrameworkVersionFromRegistry() {
             `${BLEEDINGDEV_CREATE_PACKAGE}@latest`,
             'ultramodern.frameworkVersion',
             '--json'
-        ]).trim();
+        ], {
+            timeoutMs: REGISTRY_LOOKUP_TIMEOUT_MS
+        }).trim();
         const version = JSON.parse(rawVersion);
         if ('string' == typeof version && semverPattern.test(version)) return version;
     } catch  {}
-    console.error([
-        `Could not resolve ${BLEEDINGDEV_CREATE_PACKAGE}@latest ultramodern.frameworkVersion.`,
-        'Pass --workspace to use local workspace protocol dependencies,',
+    console.warn([
+        `Could not resolve ${BLEEDINGDEV_CREATE_PACKAGE}@latest ultramodern.frameworkVersion from the npm registry.`,
+        `Falling back to the packaged framework version ${fallbackVersion}.`,
+        `Pass ${WORKSPACE_PROTOCOL_FLAG} to use local workspace protocol dependencies,`,
         'or pass --ultramodern-package-version with the exact BleedingDev framework cohort.'
     ].join(' '));
-    process.exit(1);
+    return fallbackVersion;
 }
 function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
     const explicitVersion = getOptionValue(args, [
@@ -223,7 +261,7 @@ function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
     return {
         ...packageSource,
         strategy: 'install',
-        modernPackageVersion: explicitVersion ?? (isBleedingDevCreatePackage(createPackage) ? packageSource.modernPackageVersion : readBleedingDevFrameworkVersionFromRegistry()),
+        modernPackageVersion: explicitVersion ?? (isBleedingDevCreatePackage(createPackage) ? packageSource.modernPackageVersion : readBleedingDevFrameworkVersionFromRegistry(packageSource.modernPackageVersion)),
         aliasScope,
         aliasPackageNamePrefix: getOptionValue(args, [
             '--ultramodern-package-name-prefix'
@@ -231,7 +269,12 @@ function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
     };
 }
 function resolveWorkspacePackageSource(args, createPackage, packageSource) {
-    if (hasExplicitUltramodernPackageSource(args, 'workspace')) return {
+    const workspaceProtocolRequested = args.includes(WORKSPACE_PROTOCOL_FLAG);
+    if (workspaceProtocolRequested && hasExplicitUltramodernPackageSource(args, 'install')) {
+        console.error(`${WORKSPACE_PROTOCOL_FLAG} conflicts with --ultramodern-package-source=install`);
+        process.exit(1);
+    }
+    if (workspaceProtocolRequested || hasExplicitUltramodernPackageSource(args, 'workspace')) return {
         ...packageSource,
         strategy: 'workspace',
         modernPackageVersion: WORKSPACE_PACKAGE_VERSION
@@ -246,7 +289,8 @@ function runSetupCommand(command, args, options = {}) {
             'ignore',
             'pipe',
             'pipe'
-        ]
+        ],
+        timeout: options.timeoutMs
     });
 }
 function commandExists(command) {
@@ -261,26 +305,9 @@ function commandExists(command) {
         return false;
     }
 }
-function installGitForGeneratedProject() {
+function assertGitAvailableForGeneratedProject() {
     if (commandExists('git')) return;
-    const runShell = (script)=>runSetupCommand('sh', [
-            '-lc',
-            script
-        ], {
-            stdio: 'inherit'
-        });
-    const sudo = 'function' == typeof process.getuid && 0 === process.getuid() ? '' : 'sudo ';
-    if (commandExists('brew')) runSetupCommand('brew', [
-        'install',
-        'git'
-    ], {
-        stdio: 'inherit'
-    });
-    else if ('linux' === process.platform && commandExists('apt-get')) runShell(`${sudo}apt-get update && ${sudo}apt-get install -y git`);
-    else if ('linux' === process.platform && commandExists('dnf')) runShell(`${sudo}dnf install -y git`);
-    else if ('linux' === process.platform && commandExists('yum')) runShell(`${sudo}yum install -y git`);
-    else if ('linux' === process.platform && commandExists('apk')) runShell('apk add --no-cache git');
-    if (!commandExists('git')) throw new Error('Git is required for UltraModern setup. Install git and rerun create, or run pnpm skills:install after installing git.');
+    throw new Error('Git is required for UltraModern setup. Install git yourself (for example "brew install git" or "sudo apt-get install git") and rerun create. This tool never installs system packages on your behalf.');
 }
 function isInsideGitWorkTree(targetDir) {
     try {
@@ -295,7 +322,7 @@ function isInsideGitWorkTree(targetDir) {
     }
 }
 function initializeGeneratedGitRepository(targetDir) {
-    installGitForGeneratedProject();
+    assertGitAvailableForGeneratedProject();
     if (isInsideGitWorkTree(targetDir)) return;
     try {
         runSetupCommand('git', [
@@ -337,6 +364,7 @@ async function getProjectName() {
     const optionWithValue = new Set([
         '--lang',
         '-l',
+        BFF_RUNTIME_OPTION,
         '--ultramodern-package-source',
         '--ultramodern-package-version',
         '--ultramodern-package-registry',
@@ -350,7 +378,8 @@ async function getProjectName() {
         '-v',
         '--tailwind',
         '--no-tailwind',
-        '--workspace',
+        BFF_FLAG,
+        WORKSPACE_PROTOCOL_FLAG,
         '--vertical',
         LEGACY_MODERN_JS_FLAG
     ]);
@@ -362,7 +391,7 @@ async function getProjectName() {
                 i += 1;
                 continue;
             }
-            if (!(arg.startsWith('--lang=') || 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='))) 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='))) positionalArgs.push(arg);
         }
     }
     if (positionalArgs.length > 1) {
@@ -404,6 +433,7 @@ async function main() {
         delegateLegacyModernJsSetup(args);
         return;
     }
+    detectBffRuntime(args);
     console.log(`\n${i18n.t(localeKeys.message.welcome)}\n`);
     const { name: projectName, useCurrentDir } = await getProjectName();
     const targetDir = useCurrentDir ? process.cwd() : node_path.isAbsolute(projectName) ? projectName : node_path.resolve(process.cwd(), projectName);

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

@@ -29,8 +29,12 @@ 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)',
+        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>',
@@ -42,16 +46,11 @@ const EN_LOCALE = {
         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: '',
-        example8: '',
-        example9: '',
-        example10: '',
-        example11: '',
-        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
         moreInfo: '📚 Learn more: https://modernjs.dev'
     },
     version: {
-        message: '@bleedingdev/modern-js-create version: {version}'
+        message: '{name} version: {version}'
     }
 };
 export { EN_LOCALE };

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

@@ -29,8 +29,12 @@ const ZH_LOCALE = {
         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',
@@ -42,16 +46,11 @@ const ZH_LOCALE = {
         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: '',
-        example8: '',
-        example9: '',
-        example10: '',
-        example11: '',
-        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
         moreInfo: '📚 更多信息: https://modernjs.dev'
     },
     version: {
-        message: '@bleedingdev/modern-js-create 版本: {version}'
+        message: '{name} 版本: {version}'
     }
 };
 export { ZH_LOCALE };