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

package/dist/esm/docs-location.js

@@ -0,0 +1,79 @@
+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/index.js

@@ -0,0 +1,133 @@
+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/locale/en.js

@@ -0,0 +1,88 @@
+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/locale/index.js

@@ -0,0 +1,9 @@
+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/locale/zh.js

@@ -0,0 +1,88 @@
+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/ultramodern-package-source.js

@@ -0,0 +1,43 @@
+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 };

package/dist/esm/ultramodern-release-cohort.js

@@ -0,0 +1,133 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { createPackageRoot, writeFile } from "./ultramodern-workspace/fs-io.js";
+const RELEASE_COHORT_PROJECTION_PATH = '.modernjs/release-cohort.json';
+const RELEASE_COHORT_PROJECTION_SCHEMA = 'bleedingdev.ultramodern.release-cohort';
+const RELEASE_COHORT_PROJECTION_SCHEMA_VERSION = 1;
+function assert(condition, message) {
+    if (!condition) throw new Error(message);
+}
+function isRecord(value) {
+    return Boolean(value) && 'object' == typeof value && !Array.isArray(value);
+}
+function assertExactKeys(value, expectedKeys, label) {
+    assert(isRecord(value), `${label} must be a JSON object.`);
+    const actualKeys = Object.keys(value).sort();
+    const expected = [
+        ...expectedKeys
+    ].sort();
+    assert(JSON.stringify(actualKeys) === JSON.stringify(expected), `${label} has unknown or missing fields: expected ${expected.join(', ')}; found ${actualKeys.join(', ')}.`);
+}
+function assertNonEmptyString(value, label) {
+    assert('string' == typeof value && value.length > 0 && value.trim() === value, `${label} must be a non-empty trimmed string.`);
+}
+function sourcePackageSuffix(sourceName) {
+    assert(sourceName.startsWith('@modern-js/') && sourceName.lastIndexOf('/') > 0, `Release cohort sourceName must be an @modern-js package: ${sourceName}.`);
+    return sourceName.slice(sourceName.lastIndexOf('/') + 1);
+}
+function targetAliasProfile(sourceName, targetName) {
+    const match = /^@([^/]+)\/([^/]+)$/u.exec(targetName);
+    assert(match, `Release cohort targetName is invalid: ${targetName}.`);
+    const [, aliasScope, targetPackageName] = match;
+    const suffix = sourcePackageSuffix(sourceName);
+    assert(targetPackageName.endsWith(suffix), `Release cohort alias ${sourceName} -> ${targetName} does not preserve the source package suffix.`);
+    return {
+        aliasPackageNamePrefix: targetPackageName.slice(0, targetPackageName.length - suffix.length),
+        aliasScope
+    };
+}
+function parseUltramodernReleaseCohort(value) {
+    assertExactKeys(value, [
+        'aliases',
+        'packages',
+        'release',
+        'schema',
+        'schemaVersion',
+        'source'
+    ], 'Release cohort projection');
+    const cohort = value;
+    assert(cohort.schema === RELEASE_COHORT_PROJECTION_SCHEMA && cohort.schemaVersion === RELEASE_COHORT_PROJECTION_SCHEMA_VERSION, `Unknown release cohort projection schema ${String(cohort.schema)}@${String(cohort.schemaVersion)}.`);
+    assertExactKeys(cohort.source, [
+        'commit',
+        'repository'
+    ], 'Release cohort source');
+    assertNonEmptyString(cohort.source.commit, 'Release cohort source.commit');
+    assertNonEmptyString(cohort.source.repository, 'Release cohort source.repository');
+    assertExactKeys(cohort.release, [
+        'tag',
+        'version'
+    ], 'Release cohort release');
+    assertNonEmptyString(cohort.release.tag, 'Release cohort release.tag');
+    assertNonEmptyString(cohort.release.version, 'Release cohort release.version');
+    assert(isRecord(cohort.aliases), 'Release cohort aliases must be an object.');
+    assert(Array.isArray(cohort.packages), 'Release cohort packages must be an array.');
+    const aliasNames = Object.keys(cohort.aliases).sort();
+    assert(aliasNames.length > 0, 'Release cohort aliases must not be empty.');
+    const packageSourceNames = [];
+    const packageTargetNames = new Set();
+    for (const [index, item] of cohort.packages.entries()){
+        assertExactKeys(item, [
+            'sourceName',
+            'targetName',
+            'version'
+        ], `Release cohort packages[${index}]`);
+        assertNonEmptyString(item.sourceName, `Release cohort packages[${index}].sourceName`);
+        assertNonEmptyString(item.targetName, `Release cohort packages[${index}].targetName`);
+        assertNonEmptyString(item.version, `Release cohort packages[${index}].version`);
+        sourcePackageSuffix(item.sourceName);
+        assert(cohort.aliases[item.sourceName] === item.targetName, `Release cohort packages[${index}] targetName does not match aliases for ${item.sourceName}.`);
+        assert(item.version === cohort.release.version, `Release cohort packages[${index}] version does not match release.version.`);
+        packageSourceNames.push(item.sourceName);
+        assert(!packageTargetNames.has(item.targetName), `Release cohort packages contains duplicate targetName ${item.targetName}.`);
+        packageTargetNames.add(item.targetName);
+    }
+    assert(JSON.stringify(packageSourceNames) === JSON.stringify(aliasNames), 'Release cohort packages must exactly match aliases in source-name order.');
+    return cohort;
+}
+function readCohortFile(filePath) {
+    const stat = node_fs.lstatSync(filePath, {
+        throwIfNoEntry: false
+    });
+    assert(stat?.isFile() && !stat.isSymbolicLink(), `Authenticated release cohort projection is missing or unsafe: ${filePath}.`);
+    let value;
+    try {
+        value = JSON.parse(node_fs.readFileSync(filePath, 'utf8'));
+    } catch (error) {
+        throw new Error(`Authenticated release cohort projection is invalid JSON: ${error instanceof Error ? error.message : String(error)}.`);
+    }
+    return parseUltramodernReleaseCohort(value);
+}
+function readCreateReleaseCohort() {
+    return readCohortFile(node_path.join(createPackageRoot, 'template-workspace', RELEASE_COHORT_PROJECTION_PATH));
+}
+function hasCreateReleaseCohort() {
+    return node_fs.existsSync(node_path.join(createPackageRoot, 'template-workspace', RELEASE_COHORT_PROJECTION_PATH));
+}
+function isCreatePackageSourceCheckout() {
+    return node_fs.existsSync(node_path.join(createPackageRoot, 'src'));
+}
+function readWorkspaceReleaseCohort(workspaceRoot) {
+    return readCohortFile(node_path.join(workspaceRoot, RELEASE_COHORT_PROJECTION_PATH));
+}
+function copyCreateReleaseCohort(workspaceRoot) {
+    const sourcePath = node_path.join(createPackageRoot, 'template-workspace', RELEASE_COHORT_PROJECTION_PATH);
+    const cohort = readCohortFile(sourcePath);
+    writeFile(workspaceRoot, RELEASE_COHORT_PROJECTION_PATH, node_fs.readFileSync(sourcePath, 'utf8'));
+    return cohort;
+}
+function assertReleaseCohortPackageSource(cohort, packageSource) {
+    if ('install' !== packageSource.strategy) return;
+    assert(packageSource.modernPackageVersion === cohort.release.version, `Package source release ${packageSource.modernPackageVersion} does not match authenticated release cohort ${cohort.release.version}.`);
+    let expectedProfile;
+    for (const item of cohort.packages){
+        const profile = targetAliasProfile(item.sourceName, item.targetName);
+        expectedProfile ??= profile;
+        assert(profile.aliasScope === expectedProfile.aliasScope && profile.aliasPackageNamePrefix === expectedProfile.aliasPackageNamePrefix, 'Authenticated release cohort aliases cannot be represented by one package-source profile.');
+    }
+    assert(packageSource.aliasScope?.replace(/^@/u, '') === expectedProfile?.aliasScope && (packageSource.aliasPackageNamePrefix ?? '') === expectedProfile?.aliasPackageNamePrefix, 'Package source aliases rebind the authenticated release cohort.');
+    return cohort;
+}
+function releaseCohortSelectors(cohort) {
+    return cohort.packages.map((item)=>`${item.targetName}@${item.version}`).sort();
+}
+export { RELEASE_COHORT_PROJECTION_PATH, assertReleaseCohortPackageSource, copyCreateReleaseCohort, hasCreateReleaseCohort, isCreatePackageSourceCheckout, parseUltramodernReleaseCohort, readCreateReleaseCohort, readWorkspaceReleaseCohort, releaseCohortSelectors };