@bleedingdev/modern-js-create 3.5.0-ultramodern.3 → 3.5.0-ultramodern.31

package/dist/cjs/ultramodern-workspace/write-workspace.cjs

@@ -39,77 +39,25 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     createCompactUltramodernConfig: ()=>createCompactUltramodernConfig,
     generateUltramodernWorkspace: ()=>generateUltramodernWorkspace,
-    writeApp: ()=>writeApp,
+    writeApp: ()=>external_write_app_cjs_namespaceObject.writeApp,
     writeSharedPackages: ()=>writeSharedPackages
 });
 const external_node_fs_namespaceObject = require("node:fs");
 var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
-const external_api_cjs_namespaceObject = require("./api.cjs");
 const external_app_files_cjs_namespaceObject = require("./app-files.cjs");
 const external_bridge_config_cjs_namespaceObject = require("./bridge-config.cjs");
 const external_contracts_cjs_namespaceObject = require("./contracts.cjs");
-const external_demo_components_cjs_namespaceObject = require("./demo-components.cjs");
 const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
 const external_fs_io_cjs_namespaceObject = require("./fs-io.cjs");
 const external_generation_result_cjs_namespaceObject = require("./generation-result.cjs");
-const external_locales_cjs_namespaceObject = require("./locales.cjs");
-const external_module_federation_cjs_namespaceObject = require("./module-federation.cjs");
 const external_naming_cjs_namespaceObject = require("./naming.cjs");
 const external_overlays_cjs_namespaceObject = require("./overlays.cjs");
 const external_package_json_cjs_namespaceObject = require("./package-json.cjs");
 const external_package_source_cjs_namespaceObject = require("./package-source.cjs");
-const external_public_surface_cjs_namespaceObject = require("./public-surface.cjs");
 const external_versions_cjs_namespaceObject = require("./versions.cjs");
 const external_workspace_scripts_cjs_namespaceObject = require("./workspace-scripts.cjs");
-function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge) {
-    const resolvedApp = 'shell' === app.kind ? (0, external_descriptors_cjs_namespaceObject.createShellHost)(remotes) : app;
-    const publicWeb = (0, external_public_surface_cjs_namespaceObject.createPublicWebAppArtifacts)(resolvedApp);
-    const writeAppFile = (relativePath, content)=>{
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
-    };
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createAppPackage)(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/tsconfig.json`, (0, external_package_json_cjs_namespaceObject.createAppTsConfig)(resolvedApp, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, (0, external_package_json_cjs_namespaceObject.createAppMfTypesTsConfig)(resolvedApp));
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, (0, external_app_files_cjs_namespaceObject.createAppEnvDts)(resolvedApp, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, (0, external_module_federation_cjs_namespaceObject.createUltramodernBuildReexportModule)());
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, (0, external_module_federation_cjs_namespaceObject.createUltramodernBuildModule)(scope, resolvedApp));
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/modern.config.ts`, (0, external_module_federation_cjs_namespaceObject.createAppModernConfig)(scope, resolvedApp));
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, (0, external_app_files_cjs_namespaceObject.createAppRuntimeConfig)(resolvedApp, scope, remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(resolvedApp, 'en', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/locales/en/${(0, external_descriptors_cjs_namespaceObject.appI18nNamespace)(resolvedApp)}.json`, (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(resolvedApp, 'en', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/locales/cs/translation.json`, (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(resolvedApp, 'cs', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/locales/cs/${(0, external_descriptors_cjs_namespaceObject.appI18nNamespace)(resolvedApp)}.json`, (0, external_locales_cjs_namespaceObject.createAppPublicLocaleMessages)(resolvedApp, 'cs', remotes));
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/routes/index.css`, (0, external_app_files_cjs_namespaceObject.createAppStyles)(enableTailwind, scope, resolvedApp));
-    if (enableTailwind) {
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/postcss.config.mjs`, (0, external_app_files_cjs_namespaceObject.createPostcssConfig)());
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/tailwind.config.ts`, (0, external_app_files_cjs_namespaceObject.createTailwindConfig)());
-    }
-    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? (0, external_module_federation_cjs_namespaceObject.createShellModuleFederationConfig)(scope, remotes) : (0, external_module_federation_cjs_namespaceObject.createRemoteModuleFederationConfig)(scope, resolvedApp, remotes));
-    writeAppFile('src/routes/layout.tsx', (0, external_demo_components_cjs_namespaceObject.createLayout)(resolvedApp.id));
-    writeAppFile('src/routes/[lang]/page.tsx', 'shell' === resolvedApp.kind ? (0, external_demo_components_cjs_namespaceObject.createShellPage)(remotes) : (0, external_demo_components_cjs_namespaceObject.createRemotePage)(resolvedApp));
-    for (const generatedFile of publicWeb.routeMetaFiles)(0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, generatedFile.path, generatedFile.content);
-    for (const generatedFile of publicWeb.routeAliasFiles)(0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, generatedFile.path, generatedFile.content);
-    if ('shell' === resolvedApp.kind) {
-        writeAppFile('src/routes/vertical-components.tsx', (0, external_demo_components_cjs_namespaceObject.createShellRemoteComponents)(scope, remotes));
-        writeAppFile('src/routes/shell-frame.tsx', (0, external_app_files_cjs_namespaceObject.createShellFrameComponent)());
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, (0, external_api_cjs_namespaceObject.createShellApiClient)(scope, remotes));
-    }
-    if ((0, external_descriptors_cjs_namespaceObject.appHasApi)(resolvedApp)) {
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/api.ts`, (0, external_api_cjs_namespaceObject.createSharedApi)(resolvedApp));
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/index.ts`, (0, external_api_cjs_namespaceObject.createApiServiceEntry)(resolvedApp, '../shared/api.ts'));
-        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, (0, external_api_cjs_namespaceObject.createApiClient)(resolvedApp, '../../shared/api'));
-    }
-    if ('vertical' === resolvedApp.kind) {
-        writeAppFile('src/federation-entry.tsx', (0, external_demo_components_cjs_namespaceObject.createRemoteEntry)(resolvedApp));
-        for (const expose of Object.keys(resolvedApp.exposes ?? {})){
-            const outputPath = (0, external_demo_components_cjs_namespaceObject.remoteComponentOutputPath)(resolvedApp, expose);
-            if (outputPath) writeAppFile(outputPath.slice(resolvedApp.directory.length + 1), (0, external_demo_components_cjs_namespaceObject.createRemoteExposeComponent)(resolvedApp, expose));
-        }
-    }
-}
+const external_write_app_cjs_namespaceObject = require("./write-app.cjs");
+const external_zerops_cjs_namespaceObject = require("./zerops.cjs");
 function writeSharedPackages(targetDir, scope) {
     for (const sharedPackage of external_descriptors_cjs_namespaceObject.sharedPackages){
         (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description));
@@ -149,7 +97,7 @@ function writePnpmWorkspacePackages(targetDir, bridge) {
         ...bridge.workspacePackages.map((entry)=>entry.pattern)
     ];
     const renderedPackages = packages.map((pattern)=>`  - ${pattern}`).join('\n');
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\n(?: {2}- .+\n)+/u, `packages:\n${renderedPackages}\n`));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\r?\n(?: {2}- .+\r?\n)+/u, `packages:\n${renderedPackages}\n`));
 }
 function generateUltramodernWorkspace(options) {
     const beforeFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
@@ -175,8 +123,10 @@ function generateUltramodernWorkspace(options) {
         nodeVersion: external_versions_cjs_namespaceObject.NODE_VERSION,
         pnpmVersion: external_versions_cjs_namespaceObject.PNPM_VERSION,
         nodeFetchVersion: external_versions_cjs_namespaceObject.NODE_FETCH_VERSION,
+        drizzleOrmVersion: external_versions_cjs_namespaceObject.DRIZZLE_ORM_VERSION,
         effectVersion: external_versions_cjs_namespaceObject.EFFECT_VERSION,
         effectVitestVersion: external_versions_cjs_namespaceObject.EFFECT_VITEST_VERSION,
+        moduleFederationVersion: external_versions_cjs_namespaceObject.MODULE_FEDERATION_VERSION,
         tanstackRouterCoreVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_CORE_VERSION,
         tanstackRouterVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_VERSION,
         typescriptVersion: external_versions_cjs_namespaceObject.TYPESCRIPT_VERSION,
@@ -184,14 +134,15 @@ function generateUltramodernWorkspace(options) {
     });
     writePnpmWorkspacePackages(options.targetDir, bridge);
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(options.targetDir, 'zerops.yaml', `${(0, external_zerops_cjs_namespaceObject.createZeropsYaml)(scope, createdApps)}\n`);
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'tsconfig.base.json', (0, external_package_json_cjs_namespaceObject.createTsConfigBase)());
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'tsconfig.json', (0, external_package_json_cjs_namespaceObject.createRootTsConfig)(createdApps));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/reference-topology.json', (0, external_contracts_cjs_namespaceObject.createTopology)(scope, initialVerticals));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/ownership.json', (0, external_contracts_cjs_namespaceObject.createOwnership)(scope, initialVerticals));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/local-overlays/development.json', (0, external_contracts_cjs_namespaceObject.createDevelopmentOverlay)(initialVerticals));
+    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/local-overlays/development.json', (0, external_contracts_cjs_namespaceObject.createDevelopmentOverlay)(scope, initialVerticals));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
-    writeApp(options.targetDir, scope, external_descriptors_cjs_namespaceObject.shellApp, packageSource, enableTailwind, initialVerticals, bridge);
-    for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
+    (0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, external_descriptors_cjs_namespaceObject.shellApp, packageSource, enableTailwind, initialVerticals, bridge);
+    for (const remote of initialVerticals)(0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
     writeSharedPackages(options.targetDir, scope);
     (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir, scope, enableTailwind, initialVerticals);
     const preliminaryAfterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);

package/dist/cjs/ultramodern-workspace/zerops.cjs

@@ -0,0 +1,103 @@
+"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__, {
+    createZeropsYaml: ()=>createZeropsYaml
+});
+const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
+const external_naming_cjs_namespaceObject = require("./naming.cjs");
+const external_versions_cjs_namespaceObject = require("./versions.cjs");
+const zeropsNodeRuntime = `nodejs@${external_versions_cjs_namespaceObject.NODE_VERSION.split('.')[0]}`;
+function quoteYamlString(value) {
+    return `'${value.replace(/'/gu, "''")}'`;
+}
+function quoteShellValue(value) {
+    return `'${value.replace(/'/gu, "'\\''")}'`;
+}
+function readinessPath(app) {
+    if (!(0, external_descriptors_cjs_namespaceObject.appHasApi)(app)) return '/';
+    return `${(0, external_descriptors_cjs_namespaceObject.resolveApiPrefix)(app)}/${(0, external_descriptors_cjs_namespaceObject.resolveApiStem)(app)}/readiness`;
+}
+function createZeropsService(scope, app) {
+    const runtimeDirectory = `.zerops/runtime/${app.id}`;
+    const appPackageName = (0, external_naming_cjs_namespaceObject.packageName)(scope, app.packageSuffix);
+    const commands = [
+        'curl https://mise.run | sh',
+        '~/.local/bin/mise install',
+        '~/.local/bin/mise exec -- pnpm install --frozen-lockfile',
+        `~/.local/bin/mise exec -- pnpm --filter ${quoteShellValue(appPackageName)} run build`,
+        `~/.local/bin/mise exec -- pnpm run zerops:materialize -- --app ${quoteShellValue(app.id)} --package ${quoteShellValue(appPackageName)} --package-dir ${quoteShellValue(app.directory)}`,
+        `cp ${quoteShellValue('topology/reference-topology.json')} ${quoteShellValue(`${runtimeDirectory}/topology.json`)}`,
+        `cp ${quoteShellValue('topology/local-overlays/development.json')} ${quoteShellValue(`${runtimeDirectory}/local-overlay.json`)}`
+    ];
+    return [
+        `  - setup: ${quoteYamlString(app.id)}`,
+        '    build:',
+        `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      buildCommands:',
+        '        - |',
+        ...commands.map((command)=>`          ${command}`),
+        '      deployFiles:',
+        `        - ${quoteYamlString(runtimeDirectory)}`,
+        '    deploy:',
+        '      temporaryShutdown: false',
+        '      readinessCheck:',
+        '        httpGet:',
+        `          port: ${app.port}`,
+        `          path: ${quoteYamlString(readinessPath(app))}`,
+        '        failureTimeout: 120',
+        '        retryPeriod: 10',
+        '    run:',
+        `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      ports:',
+        `        - port: ${app.port}`,
+        '          protocol: TCP',
+        '          httpSupport: true',
+        '      envVariables:',
+        '        NODE_ENV: production',
+        `        ${app.portEnv}: ${quoteYamlString(String(app.port))}`,
+        `        ULTRAMODERN_ZEROPS_SERVICE: ${quoteYamlString(app.id)}`,
+        `      start: cd ${quoteShellValue(runtimeDirectory)} && npm run serve`
+    ].join('\n');
+}
+function createZeropsYaml(scope, apps) {
+    return [
+        '# Generated by Modern.js UltraModern workspace tooling.',
+        '# Zerops runs each full-stack MicroVertical as a package-owned Node service.',
+        'zerops:',
+        ...apps.map((app)=>createZeropsService(scope, app))
+    ].join('\n\n');
+}
+exports.createZeropsYaml = __webpack_exports__.createZeropsYaml;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createZeropsYaml"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/esm/cli/flags.js

@@ -0,0 +1,228 @@
+import { i18n, localeKeys } from "../locale/index.js";
+import { parseUltramodernBridgeCliOptions, ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliValueFlags } from "../ultramodern-workspace/bridge-config.js";
+const LEGACY_MODERN_JS_FLAG = '--legacy-modern-js';
+const LEGACY_MODERN_JS_CONFIRMATION = 'USE LEGACY MODERN.JS';
+const WORKSPACE_PROTOCOL_FLAG = '--workspace';
+const DRY_RUN_FLAG = '--dry-run';
+const VERTICAL_FLAG = '--vertical';
+const VERTICAL_NAME_FLAG = '--vertical-name';
+const CODESMITH_OVERLAY_FLAG = '--codesmith-overlay';
+const BFF_FLAG = '--bff';
+const BFF_RUNTIME_OPTION = '--bff-runtime';
+const SUPPORTED_BFF_RUNTIMES = [
+    'effect'
+];
+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';
+};
+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 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 a strict Effect API runtime 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 collectPositionalArgs(args) {
+    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',
+        VERTICAL_NAME_FLAG,
+        CODESMITH_OVERLAY_FLAG,
+        ...ultramodernBridgeCliValueFlags
+    ]);
+    const optionWithoutValue = new Set([
+        '--help',
+        '-h',
+        '--version',
+        '-v',
+        '--tailwind',
+        '--no-tailwind',
+        BFF_FLAG,
+        WORKSPACE_PROTOCOL_FLAG,
+        DRY_RUN_FLAG,
+        VERTICAL_FLAG,
+        LEGACY_MODERN_JS_FLAG,
+        ...ultramodernBridgeCliBooleanFlags
+    ]);
+    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=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`) || ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
+        }
+    }
+    return positionalArgs;
+}
+function readRequiredVerticalNameValue(args, index) {
+    const value = args[index + 1];
+    if (!value || value.startsWith('-')) {
+        console.error(i18n.t(localeKeys.error.verticalNameMissing));
+        process.exit(1);
+    }
+    return value;
+}
+function resolveVerticalCliInput(args) {
+    const candidates = [];
+    let addVertical = false;
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (arg === VERTICAL_FLAG) {
+            addVertical = true;
+            continue;
+        }
+        if (arg.startsWith(`${VERTICAL_FLAG}=`)) {
+            addVertical = true;
+            candidates.push({
+                value: arg.slice(`${VERTICAL_FLAG}=`.length),
+                source: `${VERTICAL_FLAG}=<name>`
+            });
+            continue;
+        }
+        if (arg === VERTICAL_NAME_FLAG) {
+            addVertical = true;
+            candidates.push({
+                value: readRequiredVerticalNameValue(args, i),
+                source: VERTICAL_NAME_FLAG
+            });
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith(`${VERTICAL_NAME_FLAG}=`)) {
+            addVertical = true;
+            candidates.push({
+                value: arg.slice(`${VERTICAL_NAME_FLAG}=`.length),
+                source: `${VERTICAL_NAME_FLAG}=<name>`
+            });
+        }
+    }
+    if (!addVertical) return {
+        addVertical: false
+    };
+    const positionalArgs = collectPositionalArgs(args);
+    if (positionalArgs.length > 1) {
+        console.error(`Unexpected positional argument: ${positionalArgs[1]}`);
+        process.exit(1);
+    }
+    if (positionalArgs[0]) candidates.push({
+        value: positionalArgs[0],
+        source: 'positional argument'
+    });
+    const emptyCandidate = candidates.find((candidate)=>'' === candidate.value);
+    if (!candidates.length || emptyCandidate) {
+        console.error(i18n.t(localeKeys.error.verticalNameMissing));
+        process.exit(1);
+    }
+    const [firstCandidate] = candidates;
+    const disagreement = candidates.find((candidate)=>candidate.value !== firstCandidate.value);
+    if (disagreement) {
+        console.error(i18n.t(localeKeys.error.verticalNameAmbiguous, {
+            firstName: firstCandidate.value,
+            firstSource: firstCandidate.source,
+            secondName: disagreement.value,
+            secondSource: disagreement.source
+        }));
+        process.exit(1);
+    }
+    return {
+        addVertical: true,
+        name: firstCandidate.value
+    };
+}
+function detectDryRunFlag(args) {
+    if (args.some((arg)=>arg.startsWith(`${DRY_RUN_FLAG}=`))) {
+        console.error(`${DRY_RUN_FLAG} does not accept a value.`);
+        process.exit(1);
+    }
+    return args.includes(DRY_RUN_FLAG);
+}
+function detectCodeSmithOverlays(args) {
+    const overlays = [];
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (arg === CODESMITH_OVERLAY_FLAG) {
+            const generator = args[i + 1];
+            if (!generator || generator.startsWith('-')) {
+                console.error(`${CODESMITH_OVERLAY_FLAG} requires a package or path.`);
+                process.exit(1);
+            }
+            overlays.push({
+                generator
+            });
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`)) {
+            const generator = arg.slice(`${CODESMITH_OVERLAY_FLAG}=`.length);
+            if (!generator) {
+                console.error(`${CODESMITH_OVERLAY_FLAG} requires a package or path.`);
+                process.exit(1);
+            }
+            overlays.push({
+                generator
+            });
+        }
+    }
+    return overlays.length > 0 ? overlays : void 0;
+}
+function readBridgeCliOptions(args) {
+    try {
+        return parseUltramodernBridgeCliOptions(args);
+    } catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+export { BFF_FLAG, BFF_RUNTIME_OPTION, CODESMITH_OVERLAY_FLAG, DRY_RUN_FLAG, LEGACY_MODERN_JS_CONFIRMATION, LEGACY_MODERN_JS_FLAG, SUPPORTED_BFF_RUNTIMES, VERTICAL_FLAG, VERTICAL_NAME_FLAG, WORKSPACE_PROTOCOL_FLAG, collectPositionalArgs, detectBffRuntime, detectCodeSmithOverlays, detectDryRunFlag, detectExplicitTailwindFlag, detectLanguage, detectLegacyModernJsFlag, detectTailwindFlag, getOptionValue, readBridgeCliOptions, resolveVerticalCliInput };

package/dist/esm/cli/help.js

@@ -0,0 +1,65 @@
+import { i18n, localeKeys } from "../locale/index.js";
+import { readCreatePackageJson } from "./package-source.js";
+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.optionBridge));
+    console.log(i18n.t(localeKeys.help.optionBridgeParentRoot));
+    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackage));
+    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackageName));
+    console.log(i18n.t(localeKeys.help.optionBridgeTestAlias));
+    console.log(i18n.t(localeKeys.help.optionBridgeDependency));
+    console.log(i18n.t(localeKeys.help.optionBridgeLockfilePolicy));
+    console.log(i18n.t(localeKeys.help.optionBridgeGate));
+    console.log(i18n.t(localeKeys.help.optionBridgeGateCwd));
+    console.log(i18n.t(localeKeys.help.optionBridgeReactSingleton));
+    console.log(i18n.t(localeKeys.help.optionVertical));
+    console.log(i18n.t(localeKeys.help.optionVerticalName));
+    console.log(i18n.t(localeKeys.help.optionDryRun));
+    console.log(i18n.t(localeKeys.help.optionCodeSmithOverlay));
+    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(i18n.t(localeKeys.help.example8));
+    console.log(i18n.t(localeKeys.help.example9));
+    console.log(i18n.t(localeKeys.help.example10));
+    console.log('');
+    console.log(i18n.t(localeKeys.help.moreInfo));
+    console.log('');
+    process.exit(0);
+}
+export { showHelp, showVersion };

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

@@ -0,0 +1,119 @@
+import node_fs from "node:fs";
+import node_path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveCreatePackageRoot } from "../create-package-root.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 { WORKSPACE_PROTOCOL_FLAG, getOptionValue } from "./flags.js";
+import { runSetupCommand } from "./project-setup.js";
+const package_source_dirname = node_path.dirname(fileURLToPath(import.meta.url));
+const createPackageRoot = resolveCreatePackageRoot(package_source_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 REGISTRY_LOOKUP_TIMEOUT_MS = 15000;
+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 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);
+}
+export { detectUltramodernPackageSource, getBleedingDevFrameworkVersion, isBleedingDevCreatePackage, readCreatePackageJson, resolveInstallBackedPackageSource, resolveWorkspacePackageSource };