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

package/dist/cjs/index.cjs

@@ -0,0 +1,169 @@
+"use strict";
+const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
+    return "u" < typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+}();
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+var __webpack_exports__ = {};
+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 external_node_url_namespaceObject = require("node:url");
+const external_agents_md_cjs_namespaceObject = require("./agents-md.cjs");
+const flags_cjs_namespaceObject = require("./cli/flags.cjs");
+const help_cjs_namespaceObject = require("./cli/help.cjs");
+const package_source_cjs_namespaceObject = require("./cli/package-source.cjs");
+const project_setup_cjs_namespaceObject = require("./cli/project-setup.cjs");
+const prompts_cjs_namespaceObject = require("./cli/prompts.cjs");
+const index_cjs_namespaceObject = require("./locale/index.cjs");
+const commands_cjs_namespaceObject = require("./ultramodern-tooling/commands.cjs");
+const external_ultramodern_workspace_index_cjs_namespaceObject = require("./ultramodern-workspace/index.cjs");
+const bridge_config_cjs_namespaceObject = require("./ultramodern-workspace/bridge-config.cjs");
+const src_dirname = external_node_path_default().dirname((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
+const templateDir = [
+    external_node_path_default().resolve(src_dirname, '../template-workspace'),
+    external_node_path_default().resolve(src_dirname, '../../template-workspace')
+].find((candidate)=>external_node_fs_default().existsSync(candidate));
+if (!templateDir) throw new Error('Unable to locate the UltraModern workspace templates');
+const availableTemplateDir = templateDir;
+index_cjs_namespaceObject.i18n.changeLanguage({
+    locale: (0, flags_cjs_namespaceObject.detectLanguage)()
+});
+async function main() {
+    const args = process.argv.slice(2);
+    if ('ultramodern' === args[0]) {
+        process.exitCode = await (0, commands_cjs_namespaceObject.runUltramodernToolingCli)(args.slice(1));
+        return;
+    }
+    if (args.includes('--help') || args.includes('-h')) return void (0, help_cjs_namespaceObject.showHelp)();
+    if (args.includes('--version') || args.includes('-v')) return void (0, help_cjs_namespaceObject.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(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.error.agentsMdOnlyConflict));
+            process.exit(1);
+        }
+        (0, external_agents_md_cjs_namespaceObject.runAgentsMd)(availableTemplateDir, process.cwd());
+        return;
+    }
+    (0, flags_cjs_namespaceObject.detectBffRuntime)(args);
+    const dryRun = (0, flags_cjs_namespaceObject.detectDryRunFlag)(args);
+    const verticalInput = (0, flags_cjs_namespaceObject.resolveVerticalCliInput)(args);
+    const overlays = (0, flags_cjs_namespaceObject.detectCodeSmithOverlays)(args);
+    const bridgeRequested = (0, bridge_config_cjs_namespaceObject.hasUltramodernBridgeCliOptions)(args);
+    if (dryRun && !verticalInput.addVertical) {
+        console.error(`${flags_cjs_namespaceObject.DRY_RUN_FLAG} is currently supported only with ${flags_cjs_namespaceObject.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 = (0, flags_cjs_namespaceObject.readBridgeCliOptions)(args);
+    if (!dryRun) console.log(`\n${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.welcome)}\n`);
+    const createPackage = (0, package_source_cjs_namespaceObject.readCreatePackageJson)();
+    const version = createPackage.version || 'latest';
+    const ultramodernPackageVersion = (0, package_source_cjs_namespaceObject.isBleedingDevCreatePackage)(createPackage) ? (0, package_source_cjs_namespaceObject.getBleedingDevFrameworkVersion)(createPackage, version) : version;
+    if (verticalInput.addVertical) {
+        const overridePackageSource = args.some((arg)=>arg.startsWith('--ultramodern-package-')) ? (0, package_source_cjs_namespaceObject.detectUltramodernPackageSource)(args, ultramodernPackageVersion, createPackage) : void 0;
+        const preset = (0, flags_cjs_namespaceObject.detectPresetFlag)(args);
+        const apiProtocol = (0, flags_cjs_namespaceObject.detectApiProtocolFlag)(args);
+        const horizontalRemote = (0, flags_cjs_namespaceObject.detectHorizontalRemoteFlag)(args);
+        const verticalOptions = {
+            workspaceRoot: process.cwd(),
+            name: verticalInput.name,
+            modernVersion: version,
+            enableTailwind: (0, flags_cjs_namespaceObject.detectExplicitTailwindFlag)(),
+            overlays,
+            packageSource: overridePackageSource,
+            ...preset ? {
+                preset
+            } : {},
+            ...apiProtocol ? {
+                apiProtocol
+            } : {},
+            ...horizontalRemote ? {
+                horizontalRemote: true
+            } : {}
+        };
+        if (dryRun) return void console.log(JSON.stringify((0, external_ultramodern_workspace_index_cjs_namespaceObject.planUltramodernVertical)(verticalOptions), null, 2));
+        (0, external_ultramodern_workspace_index_cjs_namespaceObject.addUltramodernVertical)(verticalOptions);
+        const dim = '\x1b[2m\x1b[3m';
+        const reset = '\x1b[0m';
+        console.log(`${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.success)}\n`);
+        console.log(`${dim}   pnpm check${reset}\n`);
+        return;
+    }
+    const { name: projectName, useCurrentDir } = await (0, prompts_cjs_namespaceObject.getProjectName)();
+    const targetDir = useCurrentDir ? process.cwd() : external_node_path_default().isAbsolute(projectName) ? projectName : external_node_path_default().resolve(process.cwd(), projectName);
+    const generatedPackageName = useCurrentDir || external_node_path_default().isAbsolute(projectName) ? external_node_path_default().basename(targetDir) : projectName;
+    if (external_node_fs_default().existsSync(targetDir)) {
+        const files = external_node_fs_default().readdirSync(targetDir);
+        if (files.length > 0) {
+            console.error(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.error.directoryExists, {
+                projectName
+            }));
+            process.exit(1);
+        }
+    }
+    const packageSource = (0, package_source_cjs_namespaceObject.resolveWorkspacePackageSource)(args, createPackage, (0, package_source_cjs_namespaceObject.detectUltramodernPackageSource)(args, ultramodernPackageVersion, createPackage));
+    const generateAgentFiles = !args.includes('--no-agents-md');
+    (0, external_ultramodern_workspace_index_cjs_namespaceObject.generateUltramodernWorkspace)({
+        targetDir,
+        packageName: generatedPackageName,
+        modernVersion: version,
+        enableTailwind: (0, flags_cjs_namespaceObject.detectTailwindFlag)(),
+        bridge,
+        overlays,
+        packageSource,
+        generateAgentFiles
+    });
+    (0, project_setup_cjs_namespaceObject.initializeGeneratedGitRepository)(targetDir);
+    const dim = '\x1b[2m\x1b[3m';
+    const reset = '\x1b[0m';
+    console.log(`${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.success)}\n`);
+    if (generateAgentFiles) console.log(`${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.agentsMd)}\n`);
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.nextSteps));
+    if (!useCurrentDir) console.log(`${dim}   ${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.step1, {
+        projectName
+    })}${reset}`);
+    console.log(`${dim}   ${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.step2)}${reset}`);
+    console.log(`${dim}   pnpm check${reset}`);
+    console.log(`${dim}   ${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.step3)}${reset}\n`);
+}
+main().catch((error)=>{
+    console.error(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.error.createFailed), error);
+    process.exit(1);
+});
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/locale/en.cjs

@@ -0,0 +1,126 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+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}'
+    }
+};
+__webpack_require__.d(__webpack_exports__, {}, {
+    EN_LOCALE: EN_LOCALE
+});
+exports.EN_LOCALE = __webpack_exports__.EN_LOCALE;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "EN_LOCALE"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/locale/index.cjs

@@ -0,0 +1,50 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    i18n: ()=>i18n,
+    localeKeys: ()=>localeKeys
+});
+const i18n_utils_namespaceObject = require("@modern-js/i18n-utils");
+const external_en_cjs_namespaceObject = require("./en.cjs");
+const external_zh_cjs_namespaceObject = require("./zh.cjs");
+const i18n = new i18n_utils_namespaceObject.I18n();
+const localeKeys = i18n.init('en', {
+    zh: external_zh_cjs_namespaceObject.ZH_LOCALE,
+    en: external_en_cjs_namespaceObject.EN_LOCALE
+});
+exports.i18n = __webpack_exports__.i18n;
+exports.localeKeys = __webpack_exports__.localeKeys;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "i18n",
+    "localeKeys"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/locale/zh.cjs

@@ -0,0 +1,126 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+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}'
+    }
+};
+__webpack_require__.d(__webpack_exports__, {}, {
+    ZH_LOCALE: ZH_LOCALE
+});
+exports.ZH_LOCALE = __webpack_exports__.ZH_LOCALE;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "ZH_LOCALE"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/ultramodern-package-source.cjs

@@ -0,0 +1,115 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+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}`;
+}
+__webpack_require__.d(__webpack_exports__, {
+    modernPackageSpecifier: ()=>modernPackageSpecifier,
+    modernPackageVersion: ()=>modernPackageVersion
+}, {
+    BLEEDINGDEV_CREATE_PACKAGE: BLEEDINGDEV_CREATE_PACKAGE,
+    BLEEDINGDEV_FRAMEWORK_VERSION_ENV: BLEEDINGDEV_FRAMEWORK_VERSION_ENV,
+    BLEEDINGDEV_PACKAGE_NAME_PREFIX: BLEEDINGDEV_PACKAGE_NAME_PREFIX,
+    BLEEDINGDEV_PACKAGE_SCOPE: BLEEDINGDEV_PACKAGE_SCOPE,
+    LEGACY_BLEEDINGDEV_CREATE_PACKAGE: LEGACY_BLEEDINGDEV_CREATE_PACKAGE,
+    ULTRAMODERN_CREATE_PACKAGE: ULTRAMODERN_CREATE_PACKAGE,
+    ULTRAMODERN_FRAMEWORK_VERSION_ENV: ULTRAMODERN_FRAMEWORK_VERSION_ENV,
+    ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES: ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES,
+    ULTRAMODERN_WORKSPACE_MODERN_PACKAGES: ULTRAMODERN_WORKSPACE_MODERN_PACKAGES,
+    WORKSPACE_PACKAGE_VERSION: WORKSPACE_PACKAGE_VERSION
+});
+exports.BLEEDINGDEV_CREATE_PACKAGE = __webpack_exports__.BLEEDINGDEV_CREATE_PACKAGE;
+exports.BLEEDINGDEV_FRAMEWORK_VERSION_ENV = __webpack_exports__.BLEEDINGDEV_FRAMEWORK_VERSION_ENV;
+exports.BLEEDINGDEV_PACKAGE_NAME_PREFIX = __webpack_exports__.BLEEDINGDEV_PACKAGE_NAME_PREFIX;
+exports.BLEEDINGDEV_PACKAGE_SCOPE = __webpack_exports__.BLEEDINGDEV_PACKAGE_SCOPE;
+exports.LEGACY_BLEEDINGDEV_CREATE_PACKAGE = __webpack_exports__.LEGACY_BLEEDINGDEV_CREATE_PACKAGE;
+exports.ULTRAMODERN_CREATE_PACKAGE = __webpack_exports__.ULTRAMODERN_CREATE_PACKAGE;
+exports.ULTRAMODERN_FRAMEWORK_VERSION_ENV = __webpack_exports__.ULTRAMODERN_FRAMEWORK_VERSION_ENV;
+exports.ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = __webpack_exports__.ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES;
+exports.ULTRAMODERN_WORKSPACE_MODERN_PACKAGES = __webpack_exports__.ULTRAMODERN_WORKSPACE_MODERN_PACKAGES;
+exports.WORKSPACE_PACKAGE_VERSION = __webpack_exports__.WORKSPACE_PACKAGE_VERSION;
+exports.modernPackageSpecifier = __webpack_exports__.modernPackageSpecifier;
+exports.modernPackageVersion = __webpack_exports__.modernPackageVersion;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "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"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});