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

package/dist/esm/index.js

@@ -0,0 +1,491 @@
+import { execFileSync } from "node:child_process";
+import node_fs from "node:fs";
+import node_path from "node:path";
+import node_readline from "node:readline";
+import { fileURLToPath } from "node:url";
+import { resolveCreatePackageRoot } from "./create-package-root.js";
+import { i18n, localeKeys } from "./locale/index.js";
+import { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, WORKSPACE_PACKAGE_VERSION } from "./ultramodern-package-source.js";
+import { addUltramodernVertical, generateUltramodernWorkspace } from "./ultramodern-workspace/index.js";
+const src_dirname = node_path.dirname(fileURLToPath(import.meta.url));
+const createPackageRoot = resolveCreatePackageRoot(src_dirname);
+const semverPattern = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+const LEGACY_MODERN_JS_FLAG = '--legacy-modern-js';
+const LEGACY_MODERN_JS_CONFIRMATION = 'USE LEGACY MODERN.JS';
+const WORKSPACE_PROTOCOL_FLAG = '--workspace';
+const BFF_FLAG = '--bff';
+const BFF_RUNTIME_OPTION = '--bff-runtime';
+const SUPPORTED_BFF_RUNTIMES = [
+    'effect'
+];
+const REGISTRY_LOOKUP_TIMEOUT_MS = 15000;
+function getOptionValue(args, names) {
+    for (const name of names){
+        const prefix = `${name}=`;
+        const byEquals = args.find((arg)=>arg.startsWith(prefix));
+        if (byEquals) return byEquals.slice(prefix.length);
+        const index = args.findIndex((arg)=>arg === name);
+        if (-1 !== index && args[index + 1] && !args[index + 1].startsWith('-')) return args[index + 1];
+    }
+}
+const detectLanguage = ()=>{
+    const lang = getOptionValue(process.argv.slice(2), [
+        '--lang',
+        '-l'
+    ]);
+    if ('zh' === lang) return 'zh';
+    return 'en';
+};
+i18n.changeLanguage({
+    locale: detectLanguage()
+});
+function readCreatePackageJson() {
+    const createPackageJson = node_path.join(createPackageRoot, 'package.json');
+    return JSON.parse(node_fs.readFileSync(createPackageJson, 'utf-8'));
+}
+function isBleedingDevCreatePackage(createPackage) {
+    return createPackage.name === BLEEDINGDEV_CREATE_PACKAGE;
+}
+function getBleedingDevFrameworkVersion(createPackage, fallbackVersion) {
+    const frameworkVersion = createPackage.ultramodern?.frameworkVersion;
+    return 'string' == typeof frameworkVersion && frameworkVersion.length > 0 ? frameworkVersion : fallbackVersion;
+}
+function showVersion() {
+    const createPackage = readCreatePackageJson();
+    const name = createPackage.name || '@modern-js/create';
+    const version = createPackage.version || 'unknown';
+    console.log(i18n.t(localeKeys.version.message, {
+        name,
+        version
+    }));
+    process.exit(0);
+}
+function showHelp() {
+    console.log(i18n.t(localeKeys.help.title));
+    console.log(i18n.t(localeKeys.help.description));
+    console.log('');
+    console.log(i18n.t(localeKeys.help.usage));
+    console.log(i18n.t(localeKeys.help.usageExample));
+    console.log('');
+    console.log(i18n.t(localeKeys.help.options));
+    console.log(i18n.t(localeKeys.help.optionHelp));
+    console.log(i18n.t(localeKeys.help.optionVersion));
+    console.log(i18n.t(localeKeys.help.optionLang));
+    console.log(i18n.t(localeKeys.help.optionTailwind));
+    console.log(i18n.t(localeKeys.help.optionBff));
+    console.log(i18n.t(localeKeys.help.optionBffRuntime));
+    console.log(i18n.t(localeKeys.help.optionWorkspace));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageSource));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageVersion));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageRegistry));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageScope));
+    console.log(i18n.t(localeKeys.help.optionUltramodernPackageNamePrefix));
+    console.log(i18n.t(localeKeys.help.optionVertical));
+    console.log(i18n.t(localeKeys.help.optionLegacyModernJs));
+    console.log('');
+    console.log(i18n.t(localeKeys.help.examples));
+    console.log(i18n.t(localeKeys.help.example1));
+    console.log(i18n.t(localeKeys.help.example2));
+    console.log(i18n.t(localeKeys.help.example3));
+    console.log(i18n.t(localeKeys.help.example4));
+    console.log(i18n.t(localeKeys.help.example5));
+    console.log(i18n.t(localeKeys.help.example6));
+    console.log(i18n.t(localeKeys.help.example7));
+    console.log('');
+    console.log(i18n.t(localeKeys.help.moreInfo));
+    console.log('');
+    process.exit(0);
+}
+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());
+        });
+    });
+}
+function detectLegacyModernJsFlag(args) {
+    if (args.some((arg)=>arg.startsWith(`${LEGACY_MODERN_JS_FLAG}=`))) {
+        console.error(`${LEGACY_MODERN_JS_FLAG} does not accept a value.`);
+        process.exit(1);
+    }
+    return args.includes(LEGACY_MODERN_JS_FLAG);
+}
+function stripLegacyModernJsArgs(args) {
+    return args.filter((arg)=>arg !== LEGACY_MODERN_JS_FLAG);
+}
+async function confirmLegacyModernJsSetup() {
+    console.error('');
+    console.error(i18n.t(localeKeys.message.legacyModernJsWarning));
+    console.error('');
+    const answer = await promptInput(i18n.t(localeKeys.prompt.legacyModernJsConfirmation, {
+        confirmation: LEGACY_MODERN_JS_CONFIRMATION
+    }));
+    if (answer !== LEGACY_MODERN_JS_CONFIRMATION) {
+        console.error(i18n.t(localeKeys.error.legacyModernJsNotConfirmed));
+        process.exit(1);
+    }
+}
+function delegateLegacyModernJsSetup(args) {
+    const forwardedArgs = stripLegacyModernJsArgs(args);
+    if (commandExists('pnpm')) return void runSetupCommand('pnpm', [
+        'dlx',
+        '@modern-js/create',
+        ...forwardedArgs
+    ], {
+        stdio: 'inherit'
+    });
+    if (commandExists('npx')) return void runSetupCommand('npx', [
+        '@modern-js/create',
+        ...forwardedArgs
+    ], {
+        stdio: 'inherit'
+    });
+    throw new Error('Legacy Modern.js setup requires pnpm or npx to run @modern-js/create.');
+}
+function detectBffRuntime(args) {
+    if (args.some((arg)=>arg.startsWith(`${BFF_FLAG}=`))) {
+        console.error(`${BFF_FLAG} does not accept a value. Use: ${BFF_RUNTIME_OPTION} <runtime>`);
+        process.exit(1);
+    }
+    const runtimeRequested = args.some((arg)=>arg === BFF_RUNTIME_OPTION || arg.startsWith(`${BFF_RUNTIME_OPTION}=`));
+    if (!runtimeRequested) return 'effect';
+    const runtime = getOptionValue(args, [
+        BFF_RUNTIME_OPTION
+    ]);
+    if (!runtime) {
+        console.error(`${BFF_RUNTIME_OPTION} requires a value (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')})`);
+        process.exit(1);
+    }
+    if (!SUPPORTED_BFF_RUNTIMES.includes(runtime)) {
+        console.error(`Unsupported BFF runtime "${runtime}". UltraModern workspaces scaffold an Effect BFF for every MicroVertical (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')}).`);
+        process.exit(1);
+    }
+    return runtime;
+}
+function detectTailwindFlag() {
+    const args = process.argv.slice(2);
+    return !args.includes('--no-tailwind');
+}
+function detectExplicitTailwindFlag() {
+    const args = process.argv.slice(2);
+    if (args.includes('--no-tailwind')) return false;
+    if (args.includes('--tailwind')) return true;
+}
+function detectVerticalFlag() {
+    const args = process.argv.slice(2);
+    if (args.some((arg)=>arg.startsWith('--vertical='))) {
+        console.error('--vertical does not accept a value. Use: create <name> --vertical');
+        process.exit(1);
+    }
+    return args.includes('--vertical');
+}
+function detectUltramodernPackageSource(args, defaultPackageVersion, createPackage) {
+    const bleedingDevDefaults = isBleedingDevCreatePackage(createPackage);
+    const strategy = getOptionValue(args, [
+        '--ultramodern-package-source'
+    ]) ?? (bleedingDevDefaults ? 'install' : 'workspace');
+    if ('workspace' !== strategy && 'install' !== strategy) {
+        console.error('--ultramodern-package-source must be "workspace" or "install"');
+        process.exit(1);
+    }
+    const packageSourceStrategy = strategy;
+    const explicitRegistry = getOptionValue(args, [
+        '--ultramodern-package-registry'
+    ]);
+    const aliasScope = getOptionValue(args, [
+        '--ultramodern-package-scope'
+    ]) ?? (bleedingDevDefaults && 'install' === packageSourceStrategy && !explicitRegistry ? BLEEDINGDEV_PACKAGE_SCOPE : void 0);
+    return {
+        strategy: packageSourceStrategy,
+        modernPackageVersion: getOptionValue(args, [
+            '--ultramodern-package-version'
+        ]) ?? defaultPackageVersion,
+        registry: explicitRegistry,
+        aliasScope,
+        aliasPackageNamePrefix: getOptionValue(args, [
+            '--ultramodern-package-name-prefix'
+        ]) ?? (aliasScope ? BLEEDINGDEV_PACKAGE_NAME_PREFIX : void 0)
+    };
+}
+function hasExplicitUltramodernPackageSource(args, value) {
+    const configuredValue = getOptionValue(args, [
+        '--ultramodern-package-source'
+    ]);
+    return value ? configuredValue === value : void 0 !== configuredValue;
+}
+function readBleedingDevFrameworkVersionFromRegistry(fallbackVersion) {
+    const envVersion = process.env[BLEEDINGDEV_FRAMEWORK_VERSION_ENV]?.trim();
+    if (envVersion) {
+        if (!semverPattern.test(envVersion)) {
+            console.error(`${BLEEDINGDEV_FRAMEWORK_VERSION_ENV} must be a valid semver version`);
+            process.exit(1);
+        }
+        return envVersion;
+    }
+    try {
+        const rawVersion = runSetupCommand('npm', [
+            'view',
+            `${BLEEDINGDEV_CREATE_PACKAGE}@latest`,
+            'ultramodern.frameworkVersion',
+            '--json'
+        ], {
+            timeoutMs: REGISTRY_LOOKUP_TIMEOUT_MS
+        }).trim();
+        const version = JSON.parse(rawVersion);
+        if ('string' == typeof version && semverPattern.test(version)) return version;
+    } catch  {}
+    console.warn([
+        `Could not resolve ${BLEEDINGDEV_CREATE_PACKAGE}@latest ultramodern.frameworkVersion from the npm registry.`,
+        `Falling back to the packaged framework version ${fallbackVersion}.`,
+        `Pass ${WORKSPACE_PROTOCOL_FLAG} to use local workspace protocol dependencies,`,
+        'or pass --ultramodern-package-version with the exact BleedingDev framework cohort.'
+    ].join(' '));
+    return fallbackVersion;
+}
+function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
+    const explicitVersion = getOptionValue(args, [
+        '--ultramodern-package-version'
+    ]);
+    const explicitRegistry = getOptionValue(args, [
+        '--ultramodern-package-registry'
+    ]);
+    const aliasScope = getOptionValue(args, [
+        '--ultramodern-package-scope'
+    ]) ?? packageSource.aliasScope ?? (explicitRegistry ? void 0 : BLEEDINGDEV_PACKAGE_SCOPE);
+    return {
+        ...packageSource,
+        strategy: 'install',
+        modernPackageVersion: explicitVersion ?? (isBleedingDevCreatePackage(createPackage) ? packageSource.modernPackageVersion : readBleedingDevFrameworkVersionFromRegistry(packageSource.modernPackageVersion)),
+        aliasScope,
+        aliasPackageNamePrefix: getOptionValue(args, [
+            '--ultramodern-package-name-prefix'
+        ]) ?? packageSource.aliasPackageNamePrefix ?? (aliasScope ? BLEEDINGDEV_PACKAGE_NAME_PREFIX : void 0)
+    };
+}
+function resolveWorkspacePackageSource(args, createPackage, packageSource) {
+    const workspaceProtocolRequested = args.includes(WORKSPACE_PROTOCOL_FLAG);
+    if (workspaceProtocolRequested && hasExplicitUltramodernPackageSource(args, 'install')) {
+        console.error(`${WORKSPACE_PROTOCOL_FLAG} conflicts with --ultramodern-package-source=install`);
+        process.exit(1);
+    }
+    if (workspaceProtocolRequested || hasExplicitUltramodernPackageSource(args, 'workspace')) return {
+        ...packageSource,
+        strategy: 'workspace',
+        modernPackageVersion: WORKSPACE_PACKAGE_VERSION
+    };
+    return resolveInstallBackedPackageSource(args, createPackage, packageSource);
+}
+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'
+        });
+    }
+}
+function isDirectoryEmpty(dirPath) {
+    if (!node_fs.existsSync(dirPath)) return false;
+    try {
+        const files = node_fs.readdirSync(dirPath);
+        return 0 === files.length;
+    } catch  {
+        return false;
+    }
+}
+async function getProjectName() {
+    const args = process.argv.slice(2);
+    const optionWithValue = new Set([
+        '--lang',
+        '-l',
+        BFF_RUNTIME_OPTION,
+        '--ultramodern-package-source',
+        '--ultramodern-package-version',
+        '--ultramodern-package-registry',
+        '--ultramodern-package-scope',
+        '--ultramodern-package-name-prefix'
+    ]);
+    const optionWithoutValue = new Set([
+        '--help',
+        '-h',
+        '--version',
+        '-v',
+        '--tailwind',
+        '--no-tailwind',
+        BFF_FLAG,
+        WORKSPACE_PROTOCOL_FLAG,
+        '--vertical',
+        LEGACY_MODERN_JS_FLAG
+    ]);
+    const positionalArgs = [];
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (!optionWithoutValue.has(arg)) {
+            if (optionWithValue.has(arg)) {
+                i += 1;
+                continue;
+            }
+            if (!(arg.startsWith('--lang=') || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix='))) positionalArgs.push(arg);
+        }
+    }
+    if (positionalArgs.length > 1) {
+        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
+    };
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) return void showHelp();
+    if (args.includes('--version') || args.includes('-v')) return void showVersion();
+    if (detectLegacyModernJsFlag(args)) {
+        await confirmLegacyModernJsSetup();
+        delegateLegacyModernJsSetup(args);
+        return;
+    }
+    detectBffRuntime(args);
+    console.log(`\n${i18n.t(localeKeys.message.welcome)}\n`);
+    const { name: projectName, useCurrentDir } = await getProjectName();
+    const targetDir = useCurrentDir ? process.cwd() : node_path.isAbsolute(projectName) ? projectName : node_path.resolve(process.cwd(), projectName);
+    const generatedPackageName = useCurrentDir || node_path.isAbsolute(projectName) ? node_path.basename(targetDir) : projectName;
+    const createPackage = readCreatePackageJson();
+    const version = createPackage.version || 'latest';
+    const ultramodernPackageVersion = isBleedingDevCreatePackage(createPackage) ? getBleedingDevFrameworkVersion(createPackage, version) : version;
+    const addVertical = detectVerticalFlag();
+    if (addVertical) {
+        const overridePackageSource = args.some((arg)=>arg.startsWith('--ultramodern-package-')) ? detectUltramodernPackageSource(args, ultramodernPackageVersion, createPackage) : void 0;
+        addUltramodernVertical({
+            workspaceRoot: process.cwd(),
+            name: generatedPackageName,
+            modernVersion: version,
+            enableTailwind: detectExplicitTailwindFlag(),
+            packageSource: overridePackageSource
+        });
+        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;
+    }
+    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));
+    generateUltramodernWorkspace({
+        targetDir,
+        packageName: generatedPackageName,
+        modernVersion: version,
+        enableTailwind: detectTailwindFlag(),
+        packageSource
+    });
+    initializeGeneratedGitRepository(targetDir);
+    const dim = '\x1b[2m\x1b[3m';
+    const reset = '\x1b[0m';
+    console.log(`${i18n.t(localeKeys.message.success)}\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,55 @@
+const EN_LOCALE = {
+    prompt: {
+        projectName: 'Please enter project name: ',
+        legacyModernJsConfirmation: 'Type "{confirmation}" to continue with the original Modern.js setup: '
+    },
+    error: {
+        projectNameEmpty: 'Error: Project name cannot be empty',
+        directoryExists: 'Error: Directory "{projectName}" already exists and is not empty',
+        legacyModernJsNotConfirmed: 'Aborted. UltraModern.js remains the default unattended setup.',
+        createFailed: 'Error creating project:'
+    },
+    message: {
+        welcome: '🚀 Welcome to UltraModern.js',
+        success: '✨ Created successfully!',
+        nextSteps: '📋 Next steps:',
+        step1: 'cd {projectName}',
+        step2: 'pnpm install',
+        step3: 'pnpm dev',
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\nBRUTAL WARNING: YOU ARE OPTING OUT OF ULTRAMODERN.JS DEFAULTS.\nThe unattended default is the best UltraModern.js configuration:\na structured SuperApp workspace, presetUltramodern, TanStack Router,\nEffect BFF, Tailwind CSS v4, and the BleedingDev package cohort.\nThe original Modern.js setup is a dangerous opt-in path.\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+    },
+    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-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)',
+        optionTailwind: '      --no-tailwind Disable default Tailwind CSS v4 workspace styling',
+        optionBff: '      --bff Keep the default Effect BFF scaffolding (every MicroVertical ships an Effect BFF)',
+        optionBffRuntime: '      --bff-runtime Select the BFF runtime for scaffolded MicroVerticals (supported: effect; default: effect)',
+        optionWorkspace: '      --workspace Use workspace protocol for @modern-js dependencies (for local monorepo testing)',
+        optionUltramodernPackageSource: '      --ultramodern-package-source Select UltraModern package source (workspace or install; BleedingDev defaults to install aliases)',
+        optionUltramodernPackageVersion: '      --ultramodern-package-version Pin the exact BleedingDev framework cohort for install package sources',
+        optionUltramodernPackageRegistry: '      --ultramodern-package-registry npm registry URL used for install package sources',
+        optionUltramodernPackageScope: '      --ultramodern-package-scope Publish scope for npm alias installs (for example bleedingdev)',
+        optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix Prefix for npm alias package names (default: modern-js-)',
+        optionVertical: '      --vertical Mutate the current existing UltraModern workspace and wire a MicroVertical named <project-name>',
+        optionLegacyModernJs: '      --legacy-modern-js Opt into the original Modern.js setup after a large warning and typed confirmation',
+        examples: '💡 Examples:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-workspace',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --no-tailwind',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --workspace',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        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,55 @@
+const ZH_LOCALE = {
+    prompt: {
+        projectName: '请输入项目名称: ',
+        legacyModernJsConfirmation: '输入 "{confirmation}" 以继续使用原始 Modern.js 初始化: '
+    },
+    error: {
+        projectNameEmpty: '错误: 项目名称不能为空',
+        directoryExists: '错误: 目录 "{projectName}" 已存在且不为空',
+        legacyModernJsNotConfirmed: '已中止。UltraModern.js 仍是默认的免交互初始化方案。',
+        createFailed: '创建项目时出错:'
+    },
+    message: {
+        welcome: '🚀 欢迎使用 UltraModern.js',
+        success: '✨ 创建成功！',
+        nextSteps: '📋 下一步：',
+        step1: 'cd {projectName}',
+        step2: 'pnpm install',
+        step3: 'pnpm dev',
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n严重警告：你正在退出 ULTRAMODERN.JS 默认配置。\n免交互默认值是最佳 UltraModern.js 配置：\n结构化 SuperApp 工作区、presetUltramodern、TanStack Router、\nEffect BFF、Tailwind CSS v4，以及 BleedingDev 包版本队列。\n原始 Modern.js 初始化是危险的显式选择路径。\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+    },
+    help: {
+        title: '🚀 UltraModern.js 项目创建工具',
+        description: '默认创建带完整质量基线的 UltraModern.js SuperApp 工作区',
+        usage: '📖 用法:',
+        usageExample: '  pnpm dlx @bleedingdev/modern-js-create [项目名称] [选项]',
+        options: '⚙️  选项:',
+        optionHelp: '  -h, --help     显示帮助信息',
+        optionVersion: '  -v, --version  显示版本信息',
+        optionLang: '  -l, --lang     设置语言 (默认 en；zh 需显式选择)',
+        optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 工作区样式',
+        optionBff: '      --bff 保留默认的 Effect BFF 脚手架（每个 MicroVertical 自带 Effect BFF）',
+        optionBffRuntime: '      --bff-runtime 选择 MicroVertical 脚手架的 BFF 运行时（支持: effect；默认: effect）',
+        optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
+        optionUltramodernPackageSource: '      --ultramodern-package-source 选择 UltraModern 依赖来源（workspace 或 install；BleedingDev 默认使用 install alias）',
+        optionUltramodernPackageVersion: '      --ultramodern-package-version 为 install 依赖来源固定精确的 BleedingDev 框架版本',
+        optionUltramodernPackageRegistry: '      --ultramodern-package-registry install 依赖来源使用的 npm registry 地址',
+        optionUltramodernPackageScope: '      --ultramodern-package-scope npm alias 安装使用的发布 scope（例如 bleedingdev）',
+        optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix npm alias 包名前缀（默认：modern-js-）',
+        optionVertical: '      --vertical 修改当前已有的 UltraModern 工作区，并接入名为 <项目名称> 的 MicroVertical',
+        optionLegacyModernJs: '      --legacy-modern-js 在大型警告和输入确认后，选择原始 Modern.js 初始化',
+        examples: '💡 示例:',
+        example1: '  pnpm dlx @bleedingdev/modern-js-create my-workspace',
+        example2: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --lang zh',
+        example3: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --no-tailwind',
+        example4: '  pnpm dlx @bleedingdev/modern-js-create --help',
+        example5: '  pnpm dlx @bleedingdev/modern-js-create .',
+        example6: '  pnpm dlx @bleedingdev/modern-js-create my-workspace --workspace',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        moreInfo: '📚 更多信息: https://modernjs.dev'
+    },
+    version: {
+        message: '{name} 版本: {version}'
+    }
+};
+export { ZH_LOCALE };

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

@@ -0,0 +1,63 @@
+const WORKSPACE_PACKAGE_VERSION = 'workspace:*';
+const BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-create';
+const BLEEDINGDEV_PACKAGE_SCOPE = 'bleedingdev';
+const BLEEDINGDEV_PACKAGE_NAME_PREFIX = 'modern-js-';
+const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = 'MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION';
+const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = [
+    '@modern-js/create',
+    '@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 = [
+    '@modern-js/create',
+    '@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}`;
+}
+function modernPackageAliases(packageNames, packageSource) {
+    if (!packageSource.aliasScope) return;
+    return Object.fromEntries(packageNames.map((packageName)=>[
+            packageName,
+            modernAliasPackageName(packageName, packageSource)
+        ]));
+}
+function createModernPackagesMetadata(packageNames, packageSource, options = {}) {
+    const includeAliases = options.includeAliases ?? Boolean(packageSource.aliasScope);
+    const aliases = includeAliases ? modernPackageAliases(packageNames, packageSource) : void 0;
+    return {
+        packages: [
+            ...packageNames
+        ],
+        specifier: modernPackageVersion(packageSource),
+        ...packageSource.registry ? {
+            registry: packageSource.registry
+        } : {},
+        ...aliases ? {
+            aliases
+        } : {}
+    };
+}
+export { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES, ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, createModernPackagesMetadata, modernAliasPackageName, modernPackageAliases, modernPackageSpecifier, modernPackageVersion };