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

package/README.md

@@ -17,6 +17,12 @@ UltraModern SuperApp workspace.
 pnpm dlx @bleedingdev/modern-js-create my-workspace
 ```
 
+The supported pnpm command contract is the scoped package specifier above:
+`pnpm dlx @bleedingdev/modern-js-create <target>`. Do not shorten it to
+`pnpm dlx modern-js-create`; there is no unscoped `modern-js-create` npm
+package. Release proof runs this scoped form from a temporary pnpm store/cache
+so it cannot pass because of a local link cache.
+
 To initialize the empty directory you are already in, pass `.` explicitly:
 
 ```bash
@@ -44,6 +50,10 @@ pnpm check
 pnpm build
 ```
 
+The generated toolchain baseline is Node `>=26` with pnpm `11.5.3`.
+`packageManager`, `.mise.toml`, generated validation, and CI should all agree
+on that baseline; do not reintroduce Corepack or older pnpm aliases.
+
 Generated CI does not call the local aggregate. It runs format, lint,
 typecheck, skills, i18n boundary validation, contract validation, and build as
 separate matrix jobs so failures are isolated and parallelizable. Generated
@@ -103,6 +113,13 @@ outputs generated by `scripts/generate-public-surface-assets.mjs` into
 `dist/public` and `.output/public`, not source files under `config/public`.
 Generated public files use only explicit `public && indexable` route metadata,
 so private app screens publish only a disallowing `robots.txt` by default.
+JSON-LD is not inferred from route titles, descriptions, localized paths, app
+names, BFF APIs, or Module Federation metadata. To publish structured data,
+author `jsonLd` explicitly in route metadata for a `public && indexable` route;
+generated apps provide `src/routes/ultramodern-jsonld.ts` helpers for
+`WebPage`, `WebApplication`, `SoftwareApplication`, `BreadcrumbList`,
+`FAQPage`, and `Organization`, while raw JSON-LD remains possible for other
+schema types.
 
 Dynamic public routes can expand sitemap entries through route-owned,
 Node-safe ESM providers, normally `route.sitemap.mjs` beside the route
@@ -125,25 +142,31 @@ CSS federation is explicit:
 
 ## Public URL Environment Variables
 
-Generated apps no longer bake absolute `http://localhost:<port>` URLs into
-asset configuration. Two environment variables now have distinct roles in
-controlling where assets are served from and where SEO output links point.
+Generated apps must not bake absolute `http://localhost:<port>` URLs into asset
+configuration. Public URL and asset prefix environment variables have distinct
+roles, and stale aliases should not be carried forward when regenerating or
+updating workspaces.
 
 | Variable | Role | Feeds |
 | --- | --- | --- |
-| `ULTRAMODERN_PUBLIC_URL_<APP_ID>` | Per-app deployment and asset origin | `output.assetPrefix`, Module Federation remote URLs |
-| `MODERN_PUBLIC_SITE_URL` | Site-wide public origin for SEO output | Canonical, hreflang, sitemap `<loc>`, robots `Sitemap:` |
-
-Asset URLs use this precedence: `ULTRAMODERN_PUBLIC_URL_<APP_ID>` →
-`MODERN_PUBLIC_SITE_URL` → inferred workers.dev URL → origin-relative `/`.
-SEO and site origin prefer: `MODERN_PUBLIC_SITE_URL` →
-`ULTRAMODERN_PUBLIC_URL_<APP_ID>` → inferred workers.dev → `http://localhost:<port>`.
+| `MODERN_PUBLIC_SITE_URL` | Canonical site origin for public SEO output only | Canonical, hreflang, sitemap `<loc>`, robots `Sitemap:` |
+| `MODERN_ASSET_PREFIX` | Preferred JS/CSS/static asset prefix | Modern/Rspack-emitted asset URLs |
+| `ULTRAMODERN_ASSET_PREFIX` | UltraModern compatibility asset prefix | Modern/Rspack-emitted asset URLs when `MODERN_ASSET_PREFIX` is unset |
+| `ULTRAMODERN_PUBLIC_URL_<APP_ID>` | Per-app deployment/proof URL | Cloudflare proof inputs and Module Federation remote URLs |
+
+Asset URLs use this precedence: `MODERN_ASSET_PREFIX` →
+`ULTRAMODERN_ASSET_PREFIX` → origin-relative `/`. `MODERN_PUBLIC_SITE_URL` is
+canonical/SEO-only and must not be used as an asset-prefix fallback.
+SEO output uses `MODERN_PUBLIC_SITE_URL`; if it is unset, generated local and
+preview outputs remain non-public until deployment proof provides explicit
+public URLs.
 
 Without public URLs configured, asset paths are origin-relative (`/`), and the
 dev server uses `dev.assetPrefix: '/'` — so apps work through tunnels and
 reverse proxies (ngrok, cloudflared) without triggering Chrome's Local Network
-Access prompt or mixed-content errors. Shell-only workspaces can set just
-`MODERN_PUBLIC_SITE_URL` for SEO output.
+Access prompt or mixed-content errors. Shell-only workspaces can set
+`MODERN_PUBLIC_SITE_URL` for SEO output without changing where assets load
+from.
 
 ## Cloudflare And Zephyr Proof
 

package/dist/cjs/create-package-root.cjs

@@ -43,18 +43,16 @@ const external_node_fs_namespaceObject = require("node:fs");
 var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
 const external_node_path_namespaceObject = require("node:path");
 var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const MAX_WALK_UP_LEVELS = 5;
 function resolveCreatePackageRoot(fromDir) {
-    const candidates = [
-        fromDir,
-        external_node_path_default().resolve(fromDir, '..'),
-        external_node_path_default().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 (external_node_fs_default().existsSync(external_node_path_default().join(candidate, 'package.json')) && external_node_fs_default().existsSync(external_node_path_default().join(candidate, 'template-workspace'))) return candidate;
+        const parent = external_node_path_default().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}`);
 }
 exports.resolveCreatePackageRoot = __webpack_exports__.resolveCreatePackageRoot;
 for(var __rspack_i in __webpack_exports__)if (-1 === [

package/dist/cjs/index.cjs

@@ -39,12 +39,19 @@ const external_node_url_namespaceObject = require("node:url");
 const external_create_package_root_cjs_namespaceObject = require("./create-package-root.cjs");
 const index_cjs_namespaceObject = require("./locale/index.cjs");
 const external_ultramodern_package_source_cjs_namespaceObject = require("./ultramodern-package-source.cjs");
-const external_ultramodern_workspace_cjs_namespaceObject = require("./ultramodern-workspace.cjs");
+const external_ultramodern_workspace_index_cjs_namespaceObject = require("./ultramodern-workspace/index.cjs");
 const src_dirname = external_node_path_default().dirname((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
 const createPackageRoot = (0, external_create_package_root_cjs_namespaceObject.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}=`;
@@ -78,8 +85,10 @@ function getBleedingDevFrameworkVersion(createPackage, fallbackVersion) {
 }
 function showVersion() {
     const createPackage = readCreatePackageJson();
+    const name = createPackage.name || '@modern-js/create';
     const version = createPackage.version || 'unknown';
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.version.message, {
+        name,
         version
     }));
     process.exit(0);
@@ -95,20 +104,26 @@ function showHelp() {
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionHelp));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionVersion));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionLang));
-    if (index_cjs_namespaceObject.localeKeys.help.optionTailwind) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionTailwind));
-    if (index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageSource) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageSource));
-    if (index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageScope) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageScope));
-    if (index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageNamePrefix) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageNamePrefix));
-    if (index_cjs_namespaceObject.localeKeys.help.optionVertical) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionVertical));
-    if (index_cjs_namespaceObject.localeKeys.help.optionLegacyModernJs) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionLegacyModernJs));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionTailwind));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBff));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBffRuntime));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionWorkspace));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageSource));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageVersion));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageRegistry));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageScope));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageNamePrefix));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionVertical));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionLegacyModernJs));
     console.log('');
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.examples));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example1));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example2));
-    if (index_cjs_namespaceObject.localeKeys.help.example4) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example4));
-    if (index_cjs_namespaceObject.localeKeys.help.example5) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example5));
-    if (index_cjs_namespaceObject.localeKeys.help.example6) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example6));
-    if (index_cjs_namespaceObject.localeKeys.help.example12) console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example12));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example3));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example4));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example5));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example6));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.example7));
     console.log('');
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.moreInfo));
     console.log('');
@@ -165,6 +180,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');
@@ -216,7 +251,7 @@ function hasExplicitUltramodernPackageSource(args, value) {
     ]);
     return value ? configuredValue === value : void 0 !== configuredValue;
 }
-function readBleedingDevFrameworkVersionFromRegistry() {
+function readBleedingDevFrameworkVersionFromRegistry(fallbackVersion) {
     const envVersion = process.env[external_ultramodern_package_source_cjs_namespaceObject.BLEEDINGDEV_FRAMEWORK_VERSION_ENV]?.trim();
     if (envVersion) {
         if (!semverPattern.test(envVersion)) {
@@ -231,16 +266,19 @@ function readBleedingDevFrameworkVersionFromRegistry() {
             `${external_ultramodern_package_source_cjs_namespaceObject.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 ${external_ultramodern_package_source_cjs_namespaceObject.BLEEDINGDEV_CREATE_PACKAGE}@latest ultramodern.frameworkVersion.`,
-        'Pass --workspace to use local workspace protocol dependencies,',
+    console.warn([
+        `Could not resolve ${external_ultramodern_package_source_cjs_namespaceObject.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, [
@@ -255,7 +293,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'
@@ -263,7 +301,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: external_ultramodern_package_source_cjs_namespaceObject.WORKSPACE_PACKAGE_VERSION
@@ -278,7 +321,8 @@ function runSetupCommand(command, args, options = {}) {
             'ignore',
             'pipe',
             'pipe'
-        ]
+        ],
+        timeout: options.timeoutMs
     });
 }
 function commandExists(command) {
@@ -293,26 +337,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 {
@@ -327,7 +354,7 @@ function isInsideGitWorkTree(targetDir) {
     }
 }
 function initializeGeneratedGitRepository(targetDir) {
-    installGitForGeneratedProject();
+    assertGitAvailableForGeneratedProject();
     if (isInsideGitWorkTree(targetDir)) return;
     try {
         runSetupCommand('git', [
@@ -369,6 +396,7 @@ async function getProjectName() {
     const optionWithValue = new Set([
         '--lang',
         '-l',
+        BFF_RUNTIME_OPTION,
         '--ultramodern-package-source',
         '--ultramodern-package-version',
         '--ultramodern-package-registry',
@@ -382,7 +410,8 @@ async function getProjectName() {
         '-v',
         '--tailwind',
         '--no-tailwind',
-        '--workspace',
+        BFF_FLAG,
+        WORKSPACE_PROTOCOL_FLAG,
         '--vertical',
         LEGACY_MODERN_JS_FLAG
     ]);
@@ -394,7 +423,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) {
@@ -436,6 +465,7 @@ async function main() {
         delegateLegacyModernJsSetup(args);
         return;
     }
+    detectBffRuntime(args);
     console.log(`\n${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.welcome)}\n`);
     const { name: projectName, useCurrentDir } = await getProjectName();
     const targetDir = useCurrentDir ? process.cwd() : external_node_path_default().isAbsolute(projectName) ? projectName : external_node_path_default().resolve(process.cwd(), projectName);
@@ -446,7 +476,7 @@ async function main() {
     const addVertical = detectVerticalFlag();
     if (addVertical) {
         const overridePackageSource = args.some((arg)=>arg.startsWith('--ultramodern-package-')) ? detectUltramodernPackageSource(args, ultramodernPackageVersion, createPackage) : void 0;
-        (0, external_ultramodern_workspace_cjs_namespaceObject.addUltramodernVertical)({
+        (0, external_ultramodern_workspace_index_cjs_namespaceObject.addUltramodernVertical)({
             workspaceRoot: process.cwd(),
             name: generatedPackageName,
             modernVersion: version,
@@ -469,7 +499,7 @@ async function main() {
         }
     }
     const packageSource = resolveWorkspacePackageSource(args, createPackage, detectUltramodernPackageSource(args, ultramodernPackageVersion, createPackage));
-    (0, external_ultramodern_workspace_cjs_namespaceObject.generateUltramodernWorkspace)({
+    (0, external_ultramodern_workspace_index_cjs_namespaceObject.generateUltramodernWorkspace)({
         targetDir,
         packageName: generatedPackageName,
         modernVersion: version,

package/dist/cjs/locale/en.cjs

@@ -57,8 +57,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>',
@@ -70,16 +74,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}'
     }
 };
 __webpack_require__.d(__webpack_exports__, {}, {

package/dist/cjs/locale/zh.cjs

@@ -57,8 +57,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',
@@ -70,16 +74,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}'
     }
 };
 __webpack_require__.d(__webpack_exports__, {}, {