@bleedingdev/modern-js-ultramodern-create 3.8.3-ultramodern.2

package/dist/esm-node/cli/project-setup.js

@@ -0,0 +1,103 @@
+import "node:module";
+import { execFileSync } from "node:child_process";
+import node_fs from "node:fs";
+function runSetupCommand(command, args, options = {}) {
+    return execFileSync(command, args, {
+        cwd: options.cwd,
+        encoding: 'utf-8',
+        stdio: options.stdio ?? [
+            'ignore',
+            'pipe',
+            'pipe'
+        ],
+        timeout: options.timeoutMs
+    });
+}
+function commandExists(command) {
+    try {
+        runSetupCommand(command, [
+            '--version'
+        ], {
+            stdio: 'ignore'
+        });
+        return true;
+    } catch  {
+        return false;
+    }
+}
+function assertGitAvailableForGeneratedProject() {
+    if (commandExists('git')) return;
+    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 {
+        return 'true' === runSetupCommand('git', [
+            'rev-parse',
+            '--is-inside-work-tree'
+        ], {
+            cwd: targetDir
+        }).trim();
+    } catch  {
+        return false;
+    }
+}
+function initializeGeneratedGitRepository(targetDir) {
+    assertGitAvailableForGeneratedProject();
+    if (isInsideGitWorkTree(targetDir)) return;
+    try {
+        runSetupCommand('git', [
+            'init',
+            '-b',
+            'main'
+        ], {
+            cwd: targetDir,
+            stdio: 'inherit'
+        });
+    } catch  {
+        runSetupCommand('git', [
+            'init'
+        ], {
+            cwd: targetDir,
+            stdio: 'inherit'
+        });
+        runSetupCommand('git', [
+            'branch',
+            '-M',
+            'main'
+        ], {
+            cwd: targetDir,
+            stdio: 'inherit'
+        });
+    }
+    runSetupCommand('git', [
+        'add',
+        '-A'
+    ], {
+        cwd: targetDir,
+        stdio: 'inherit'
+    });
+    runSetupCommand('git', [
+        '-c',
+        'user.name=UltraModern',
+        '-c',
+        'user.email=ultramodern@bleedingdev.dev',
+        '-c',
+        'commit.gpgsign=false',
+        'commit',
+        '-m',
+        'chore: initial UltraModern scaffold'
+    ], {
+        cwd: targetDir,
+        stdio: 'inherit'
+    });
+}
+function isDirectoryEmpty(dirPath) {
+    if (!node_fs.existsSync(dirPath)) return false;
+    try {
+        const files = node_fs.readdirSync(dirPath);
+        return 0 === files.length;
+    } catch  {
+        return false;
+    }
+}
+export { commandExists, initializeGeneratedGitRepository, isDirectoryEmpty, runSetupCommand };

package/dist/esm-node/cli/prompts.js

@@ -0,0 +1,52 @@
+import "node:module";
+import node_path from "node:path";
+import node_readline from "node:readline";
+import { i18n, localeKeys } from "../locale/index.js";
+import { collectPositionalArgs } from "./flags.js";
+import { isDirectoryEmpty } from "./project-setup.js";
+function promptInput(question) {
+    const rl = node_readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return new Promise((resolve)=>{
+        rl.question(question, (answer)=>{
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function getProjectName() {
+    const args = process.argv.slice(2);
+    const positionalArgs = collectPositionalArgs(args);
+    if (positionalArgs.length > 1) {
+        console.error(`Unexpected positional argument: ${positionalArgs[1]}`);
+        process.exit(1);
+    }
+    const projectNameArg = positionalArgs[0];
+    if (projectNameArg) {
+        if ('.' === projectNameArg) return {
+            name: node_path.basename(process.cwd()),
+            useCurrentDir: true
+        };
+        return {
+            name: projectNameArg,
+            useCurrentDir: false
+        };
+    }
+    const currentDir = process.cwd();
+    if (isDirectoryEmpty(currentDir)) return {
+        name: node_path.basename(currentDir),
+        useCurrentDir: true
+    };
+    const projectName = await promptInput(i18n.t(localeKeys.prompt.projectName));
+    if (!projectName) {
+        console.error(i18n.t(localeKeys.error.projectNameEmpty));
+        process.exit(1);
+    }
+    return {
+        name: projectName,
+        useCurrentDir: false
+    };
+}
+export { getProjectName };

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

@@ -0,0 +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) {
+    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 the @modern-js/ultramodern-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/docs-location.js

@@ -0,0 +1,80 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+const PKG = '@modern-js/app-tools';
+const DOCS_PATH = 'node_modules/@modern-js/app-tools/docs/';
+const BUNDLED_SINCE = '3.8.0';
+function resolveVersion(cwd) {
+    const installed = node_path.join(cwd, 'node_modules', PKG, 'package.json');
+    if (node_fs.existsSync(installed)) try {
+        const { version } = JSON.parse(node_fs.readFileSync(installed, 'utf-8'));
+        if ('string' == typeof version) return version;
+    } catch  {}
+    try {
+        const pkg = JSON.parse(node_fs.readFileSync(node_path.join(cwd, 'package.json'), 'utf-8'));
+        const deps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies
+        };
+        return deps[PKG] ?? null;
+    } catch  {
+        return null;
+    }
+}
+function parseSemver(version) {
+    const match = version.match(/(\d+)\.(\d+)\.(\d+)/);
+    return match ? [
+        Number(match[1]),
+        Number(match[2]),
+        Number(match[3])
+    ] : null;
+}
+function isAtLeast(version, min) {
+    const floor = parseSemver(min);
+    if (!floor) return false;
+    for(let i = 0; i < 3; i++)if (version[i] !== floor[i]) return version[i] > floor[i];
+    return true;
+}
+function supportsBundledDocs(version) {
+    if (!version) return false;
+    if (/^workspace:|-canary[.-]|-alpha[.-]|-beta[.-]/.test(version)) return true;
+    const semver = parseSemver(version);
+    return semver ? isAtLeast(semver, BUNDLED_SINCE) : false;
+}
+function isModernProject(cwd) {
+    try {
+        const pkg = JSON.parse(node_fs.readFileSync(node_path.join(cwd, 'package.json'), 'utf-8'));
+        const deps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies
+        };
+        return Object.keys(deps).some((name)=>name.startsWith('@modern-js/'));
+    } catch  {
+        return false;
+    }
+}
+function buildBlock(markerName) {
+    return [
+        `<!-- BEGIN:${markerName} -->`,
+        '',
+        '# Modern.js: read the docs before you code',
+        '',
+        `> Documentation: **\`${DOCS_PATH}\`**`,
+        `> Index: \`${DOCS_PATH}llms.txt\` — start here when unsure which page to open`,
+        '',
+        'These docs ship inside the package, so they match the Modern.js',
+        'version this project installed exactly. Your training data is likely',
+        'outdated — **treat them as the source of truth**, and do not answer',
+        'from memory on Modern.js configuration, APIs or directory conventions.',
+        '',
+        '**🟢 Read the docs before you touch anything, except for:**',
+        '',
+        '- Writing ordinary React components (not route components)',
+        '- Editing CSS or style files',
+        '- Adding utility functions or business logic',
+        '- Installing ordinary npm packages (unrelated to Modern.js)',
+        '',
+        `<!-- END:${markerName} -->`
+    ].join('\n');
+}
+export { BUNDLED_SINCE, DOCS_PATH, buildBlock, isModernProject, resolveVersion, supportsBundledDocs };

package/dist/esm-node/index.js

@@ -0,0 +1,134 @@
+import "node:module";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { fileURLToPath } from "node:url";
+import { runAgentsMd } from "./agents-md.js";
+import { DRY_RUN_FLAG, VERTICAL_FLAG, detectApiProtocolFlag, detectBffRuntime, detectCodeSmithOverlays, detectDryRunFlag, detectExplicitTailwindFlag, detectHorizontalRemoteFlag, detectLanguage, detectPresetFlag, detectTailwindFlag, readBridgeCliOptions, resolveVerticalCliInput } from "./cli/flags.js";
+import { showHelp, showVersion } from "./cli/help.js";
+import { detectUltramodernPackageSource, getBleedingDevFrameworkVersion, isBleedingDevCreatePackage, readCreatePackageJson, resolveWorkspacePackageSource } from "./cli/package-source.js";
+import { initializeGeneratedGitRepository } from "./cli/project-setup.js";
+import { getProjectName } from "./cli/prompts.js";
+import { i18n, localeKeys } from "./locale/index.js";
+import { runUltramodernToolingCli } from "./ultramodern-tooling/commands.js";
+import { addUltramodernVertical, generateUltramodernWorkspace, planUltramodernVertical } from "./ultramodern-workspace/index.js";
+import { hasUltramodernBridgeCliOptions } from "./ultramodern-workspace/bridge-config.js";
+const src_dirname = node_path.dirname(fileURLToPath(import.meta.url));
+const templateDir = [
+    node_path.resolve(src_dirname, '../template-workspace'),
+    node_path.resolve(src_dirname, '../../template-workspace')
+].find((candidate)=>node_fs.existsSync(candidate));
+if (!templateDir) throw new Error('Unable to locate the UltraModern workspace templates');
+const availableTemplateDir = templateDir;
+i18n.changeLanguage({
+    locale: detectLanguage()
+});
+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 (args.includes('--agents-md-only')) {
+        const valueFlags = [
+            '--lang',
+            '-l'
+        ];
+        const hasProjectName = args.some((arg, index)=>!arg.startsWith('-') && !valueFlags.includes(args[index - 1]));
+        if (hasProjectName || args.includes('--no-agents-md')) {
+            console.error(i18n.t(localeKeys.error.agentsMdOnlyConflict));
+            process.exit(1);
+        }
+        runAgentsMd(availableTemplateDir, process.cwd());
+        return;
+    }
+    detectBffRuntime(args);
+    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';
+    const ultramodernPackageVersion = isBleedingDevCreatePackage(createPackage) ? getBleedingDevFrameworkVersion(createPackage, version) : version;
+    if (verticalInput.addVertical) {
+        const overridePackageSource = args.some((arg)=>arg.startsWith('--ultramodern-package-')) ? detectUltramodernPackageSource(args, ultramodernPackageVersion, createPackage) : void 0;
+        const preset = detectPresetFlag(args);
+        const apiProtocol = detectApiProtocolFlag(args);
+        const horizontalRemote = detectHorizontalRemoteFlag(args);
+        const verticalOptions = {
+            workspaceRoot: process.cwd(),
+            name: verticalInput.name,
+            modernVersion: version,
+            enableTailwind: detectExplicitTailwindFlag(),
+            overlays,
+            packageSource: overridePackageSource,
+            ...preset ? {
+                preset
+            } : {},
+            ...apiProtocol ? {
+                apiProtocol
+            } : {},
+            ...horizontalRemote ? {
+                horizontalRemote: true
+            } : {}
+        };
+        if (dryRun) return void console.log(JSON.stringify(planUltramodernVertical(verticalOptions), null, 2));
+        addUltramodernVertical(verticalOptions);
+        const dim = '\x1b[2m\x1b[3m';
+        const reset = '\x1b[0m';
+        console.log(`${i18n.t(localeKeys.message.success)}\n`);
+        console.log(`${dim}   pnpm check${reset}\n`);
+        return;
+    }
+    const { name: projectName, useCurrentDir } = await getProjectName();
+    const targetDir = useCurrentDir ? process.cwd() : node_path.isAbsolute(projectName) ? projectName : node_path.resolve(process.cwd(), projectName);
+    const generatedPackageName = useCurrentDir || node_path.isAbsolute(projectName) ? node_path.basename(targetDir) : projectName;
+    if (node_fs.existsSync(targetDir)) {
+        const files = node_fs.readdirSync(targetDir);
+        if (files.length > 0) {
+            console.error(i18n.t(localeKeys.error.directoryExists, {
+                projectName
+            }));
+            process.exit(1);
+        }
+    }
+    const packageSource = resolveWorkspacePackageSource(args, createPackage, detectUltramodernPackageSource(args, ultramodernPackageVersion, createPackage));
+    const generateAgentFiles = !args.includes('--no-agents-md');
+    generateUltramodernWorkspace({
+        targetDir,
+        packageName: generatedPackageName,
+        modernVersion: version,
+        enableTailwind: detectTailwindFlag(),
+        bridge,
+        overlays,
+        packageSource,
+        generateAgentFiles
+    });
+    initializeGeneratedGitRepository(targetDir);
+    const dim = '\x1b[2m\x1b[3m';
+    const reset = '\x1b[0m';
+    console.log(`${i18n.t(localeKeys.message.success)}\n`);
+    if (generateAgentFiles) console.log(`${i18n.t(localeKeys.message.agentsMd)}\n`);
+    console.log(i18n.t(localeKeys.message.nextSteps));
+    if (!useCurrentDir) console.log(`${dim}   ${i18n.t(localeKeys.message.step1, {
+        projectName
+    })}${reset}`);
+    console.log(`${dim}   ${i18n.t(localeKeys.message.step2)}${reset}`);
+    console.log(`${dim}   pnpm check${reset}`);
+    console.log(`${dim}   ${i18n.t(localeKeys.message.step3)}${reset}\n`);
+}
+main().catch((error)=>{
+    console.error(i18n.t(localeKeys.error.createFailed), error);
+    process.exit(1);
+});

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

@@ -0,0 +1,89 @@
+import "node:module";
+const EN_LOCALE = {
+    prompt: {
+        projectName: 'Please enter project name: '
+    },
+    error: {
+        projectNameEmpty: 'Error: Project name cannot be empty',
+        directoryExists: 'Error: Directory "{projectName}" already exists and is not empty',
+        verticalNameMissing: 'Error: Missing MicroVertical name. Use <name> --vertical, --vertical=<name>, or --vertical-name <name>.',
+        verticalNameAmbiguous: 'Error: Ambiguous MicroVertical name: "{firstName}" from {firstSource} does not match "{secondName}" from {secondSource}.',
+        createFailed: 'Error creating project:',
+        agentsMdOnlyConflict: 'Error: --agents-md-only only updates the current project and cannot be combined with a project name or --no-agents-md'
+    },
+    message: {
+        welcome: '🚀 Welcome to UltraModern.js',
+        success: '✨ Created successfully!',
+        agentsMd: '✔ AGENTS.md & CLAUDE.md generated — AI coding agents will pick them up automatically. (--no-agents-md to skip)',
+        nextSteps: '📋 Next steps:',
+        step1: 'cd {projectName}',
+        step2: 'pnpm install',
+        step3: 'pnpm dev'
+    },
+    agentsCmd: {
+        created: '✔ Created {file}',
+        updatedBlock: '✔ Updated the modernjs-agent-rules block in {file}',
+        addedBlock: '✔ Added the modernjs-agent-rules block to the top of {file}',
+        linked: '✔ Added the `@AGENTS.md` import to {file}',
+        unchanged: '• {file} is already up to date',
+        done: '✨ Done — AI coding agents will read {location}.',
+        targetNotFound: 'Error: target directory "{dir}" does not exist',
+        notAProject: 'Error: not a Modern.js project — run this in a project root',
+        unsupportedVersion: '• @modern-js/app-tools@{version} does not ship bundled docs; nothing was changed. Add https://modernjs.dev/llms.txt to AGENTS.md so AI tools can reach the framework docs, or upgrade to {since} or later and re-run this command'
+    },
+    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-ultramodern-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)',
+        optionNoAgentsMd: '      --no-agents-md Skip generating AGENTS.md / CLAUDE.md for AI coding agents',
+        optionAgentsMdOnly: '      --agents-md-only Only add/refresh AGENTS.md / CLAUDE.md in the current project (no scaffolding)',
+        optionTailwind: '      --no-tailwind Disable default Tailwind CSS v4 workspace styling',
+        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)',
+        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-)',
+        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,react-dom/client)',
+        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)',
+        optionCodeSmithOverlay: '      --codesmith-overlay <package-or-path> Run an explicit CodeSmith overlay after generation',
+        optionPreset: '      --preset=<full-stack|api-only|ui-only> Restrict a MicroVertical to API-only or UI-only surfaces (default full-stack)',
+        optionApiProtocol: '      --api-protocol=<rest|rpc> Select the MicroVertical API protocol (default rest)',
+        optionHorizontalRemote: '      --horizontal-remote Generate a components-only Horizontal Remote delivery unit',
+        examples: '💡 Examples:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace',
+        example2: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --no-tailwind',
+        example4: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --workspace',
+        example7: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical',
+        example8: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical=catalog',
+        example9: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical --dry-run',
+        example10: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical --codesmith-overlay ./overlay-generator',
+        example11: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create --agents-md-only',
+        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,89 @@
+import "node:module";
+const ZH_LOCALE = {
+    prompt: {
+        projectName: '请输入项目名称: '
+    },
+    error: {
+        projectNameEmpty: '错误: 项目名称不能为空',
+        directoryExists: '错误: 目录 "{projectName}" 已存在且不为空',
+        verticalNameMissing: '错误: 缺少 MicroVertical 名称。请使用 <名称> --vertical、--vertical=<名称> 或 --vertical-name <名称>。',
+        verticalNameAmbiguous: '错误: MicroVertical 名称不明确：{firstSource} 的 "{firstName}" 与 {secondSource} 的 "{secondName}" 不一致。',
+        createFailed: '创建项目时出错:',
+        agentsMdOnlyConflict: '错误: --agents-md-only 只更新当前项目，不能与项目名或 --no-agents-md 同时使用'
+    },
+    message: {
+        welcome: '🚀 欢迎使用 UltraModern.js',
+        success: '✨ 创建成功！',
+        agentsMd: '✔ 已生成 AGENTS.md 和 CLAUDE.md —— AI 编码助手会自动读取。（--no-agents-md 可跳过）',
+        nextSteps: '📋 下一步：',
+        step1: 'cd {projectName}',
+        step2: 'pnpm install',
+        step3: 'pnpm dev'
+    },
+    agentsCmd: {
+        created: '✔ 已创建 {file}',
+        updatedBlock: '✔ 已更新 {file} 中的 modernjs-agent-rules 块',
+        addedBlock: '✔ 已在 {file} 顶部添加 modernjs-agent-rules 块',
+        linked: '✔ 已向 {file} 添加 `@AGENTS.md` 引用',
+        unchanged: '• {file} 已是最新',
+        done: '✨ 完成 —— AI 编码助手会读取 {location}。',
+        targetNotFound: '错误: 目标目录 "{dir}" 不存在',
+        notAProject: '错误: 当前目录不是 Modern.js 项目，请在项目根目录运行',
+        unsupportedVersion: '• 当前 @modern-js/app-tools@{version} 不支持随包文档，未修改任何文件。可在 AGENTS.md 中补充 https://modernjs.dev/llms.txt 供 AI 工具获取框架知识，或升级到 {since} 及以上后重新执行本命令'
+    },
+    help: {
+        title: '🚀 UltraModern.js 项目创建工具',
+        description: '默认创建带完整质量基线的 UltraModern.js SuperApp 工作区',
+        usage: '📖 用法:',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create [项目名称] [选项]',
+        options: '⚙️  选项:',
+        optionHelp: '  -h, --help     显示帮助信息',
+        optionVersion: '  -v, --version  显示版本信息',
+        optionLang: '  -l, --lang     设置语言 (默认 en；zh 需显式选择)',
+        optionNoAgentsMd: '      --no-agents-md 跳过生成 AGENTS.md / CLAUDE.md（AI 编码助手指引文件）',
+        optionAgentsMdOnly: '      --agents-md-only 仅为当前项目补齐/更新 AGENTS.md / CLAUDE.md（不创建项目）',
+        optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 工作区样式',
+        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）',
+        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-）',
+        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,react-dom/client）',
+        optionVertical: '      --vertical[=<名称>] 修改当前已有的 UltraModern 工作区，并接入 MicroVertical',
+        optionVerticalName: '      --vertical-name <名称> 为自动化工作流显式指定 MicroVertical 名称',
+        optionDryRun: '      --dry-run 预览 MicroVertical 修改计划但不写入文件（与 --vertical 一起使用）',
+        optionCodeSmithOverlay: '      --codesmith-overlay <包或路径> 生成完成后运行显式配置的 CodeSmith overlay',
+        optionPreset: '      --preset=<full-stack|api-only|ui-only> 将 MicroVertical 限定为仅 API 或仅 UI 表面（默认 full-stack）',
+        optionApiProtocol: '      --api-protocol=<rest|rpc> 选择 MicroVertical API 协议（默认 rest）',
+        optionHorizontalRemote: '      --horizontal-remote 生成仅包含组件的 Horizontal Remote 交付单元',
+        examples: '💡 示例:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace',
+        example2: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --no-tailwind',
+        example4: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create my-workspace --workspace',
+        example7: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical',
+        example8: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create --vertical=catalog',
+        example9: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical --dry-run',
+        example10: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create catalog --vertical --codesmith-overlay ./overlay-generator',
+        example11: '  pnpm dlx @bleedingdev/modern-js-ultramodern-create --agents-md-only',
+        moreInfo: '📚 更多信息: https://modernjs.dev'
+    },
+    version: {
+        message: '{name} 版本: {version}'
+    }
+};
+export { ZH_LOCALE };

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

@@ -0,0 +1,44 @@
+import "node:module";
+const WORKSPACE_PACKAGE_VERSION = 'workspace:*';
+const ULTRAMODERN_CREATE_PACKAGE = '@modern-js/ultramodern-create';
+const BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-ultramodern-create';
+const LEGACY_BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-create';
+const BLEEDINGDEV_PACKAGE_SCOPE = 'bleedingdev';
+const BLEEDINGDEV_PACKAGE_NAME_PREFIX = 'modern-js-';
+const ULTRAMODERN_FRAMEWORK_VERSION_ENV = 'ULTRAMODERN_CREATE_FRAMEWORK_VERSION';
+const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = 'MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION';
+const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = [
+    ULTRAMODERN_CREATE_PACKAGE,
+    '@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 = [
+    ULTRAMODERN_CREATE_PACKAGE,
+    '@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}`;
+}
+export { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, LEGACY_BLEEDINGDEV_CREATE_PACKAGE, ULTRAMODERN_CREATE_PACKAGE, ULTRAMODERN_FRAMEWORK_VERSION_ENV, ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES, ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, modernPackageSpecifier, modernPackageVersion };