@bleedingdev/modern-js-create 3.2.0-ultramodern.120 → 3.2.0-ultramodern.122

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

@@ -0,0 +1,153 @@
+"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__, {
+    createAssertMfTypesScript: ()=>createAssertMfTypesScript,
+    createCloudflareProofHelperScript: ()=>createCloudflareProofHelperScript,
+    createCloudflareVersionProofScript: ()=>createCloudflareVersionProofScript,
+    createPerformanceReadinessConfigScript: ()=>createPerformanceReadinessConfigScript,
+    createPerformanceReadinessScript: ()=>createPerformanceReadinessScript,
+    createPublicSurfaceAssetsScript: ()=>createPublicSurfaceAssetsScript,
+    createWorkspaceI18nBoundaryValidationScript: ()=>createWorkspaceI18nBoundaryValidationScript,
+    createWorkspaceValidationScript: ()=>createWorkspaceValidationScript,
+    writeGeneratedWorkspaceScripts: ()=>writeGeneratedWorkspaceScripts
+});
+const external_demo_components_cjs_namespaceObject = require("./demo-components.cjs");
+const external_descriptors_cjs_namespaceObject = require("./descriptors.cjs");
+const external_effect_api_cjs_namespaceObject = require("./effect-api.cjs");
+const external_fs_io_cjs_namespaceObject = require("./fs-io.cjs");
+const external_naming_cjs_namespaceObject = require("./naming.cjs");
+const external_policy_cjs_namespaceObject = require("./policy.cjs");
+const external_public_surface_cjs_namespaceObject = require("./public-surface.cjs");
+const external_routes_cjs_namespaceObject = require("./routes.cjs");
+const external_versions_cjs_namespaceObject = require("./versions.cjs");
+function createAssertMfTypesScript(remotes = []) {
+    return (0, external_fs_io_cjs_namespaceObject.renderFileTemplate)("workspace-scripts/assert-mf-types.mjs", {
+        defaultAppDirsJson: JSON.stringify(remotes.map((remote)=>remote.directory), null, 2)
+    });
+}
+function createWorkspaceValidationScript(scope, enableTailwind, remotes = []) {
+    const verticals = remotes.filter(external_descriptors_cjs_namespaceObject.appHasEffectApi).map((remote)=>({
+            id: remote.id,
+            domain: remote.domain,
+            stem: remote.effectApi.stem,
+            group: (0, external_effect_api_cjs_namespaceObject.verticalEffectGroupName)(remote),
+            path: remote.directory,
+            mfName: remote.mfName,
+            apiPrefix: remote.effectApi.prefix,
+            tailwindPrefix: (0, external_naming_cjs_namespaceObject.tailwindPrefixForApp)(remote),
+            zephyrAlias: (0, external_descriptors_cjs_namespaceObject.remoteDependencyAlias)(remote),
+            packageName: (0, external_naming_cjs_namespaceObject.packageName)(scope, remote.packageSuffix),
+            exposes: Object.keys(remote.exposes ?? {}),
+            componentPaths: Object.keys(remote.exposes ?? {}).map((expose)=>(0, external_demo_components_cjs_namespaceObject.remoteComponentOutputPath)(remote, expose)).filter((componentPath)=>Boolean(componentPath)),
+            namespace: (0, external_descriptors_cjs_namespaceObject.appI18nNamespace)(remote),
+            routePagePaths: (0, external_routes_cjs_namespaceObject.createRouteOwnedI18nPaths)(remote).filter((route)=>'/' !== route.canonicalPath).map((route)=>(0, external_routes_cjs_namespaceObject.createRoutePageFilePath)(remote, route.canonicalPath)),
+            routeMetaPaths: (0, external_routes_cjs_namespaceObject.createRouteOwnedI18nPaths)(remote).map((route)=>(0, external_routes_cjs_namespaceObject.createRouteMetaFilePath)(remote, route.canonicalPath)),
+            localisedUrls: (0, external_routes_cjs_namespaceObject.createLocalisedUrlsMap)(remote),
+            verticalRefs: remote.verticalRefs ?? []
+        }));
+    const shellRouteMetaPaths = (0, external_routes_cjs_namespaceObject.createRouteOwnedI18nPaths)(external_descriptors_cjs_namespaceObject.shellApp).map((route)=>(0, external_routes_cjs_namespaceObject.createRouteMetaFilePath)(external_descriptors_cjs_namespaceObject.shellApp, route.canonicalPath));
+    const shellNamespace = (0, external_descriptors_cjs_namespaceObject.appI18nNamespace)(external_descriptors_cjs_namespaceObject.shellApp);
+    const oldRemotePaths = [
+        'apps/remotes'
+    ];
+    const expectedBuildScript = remotes.length > 0 ? 'ULTRAMODERN_ZEPHYR=false pnpm -r --filter "./verticals/*" run build && ULTRAMODERN_ZEPHYR=false pnpm --filter "./apps/shell-super-app" run build && pnpm mf:types && pnpm performance:readiness' : 'ULTRAMODERN_ZEPHYR=false pnpm --filter "./apps/shell-super-app" run build && pnpm mf:types && pnpm performance:readiness';
+    const expectedCloudflareBuildScript = remotes.length > 0 ? 'pnpm -r --filter "./verticals/*" run cloudflare:build && pnpm --filter "./apps/shell-super-app" run cloudflare:build && pnpm mf:types' : 'pnpm --filter "./apps/shell-super-app" run cloudflare:build && pnpm mf:types';
+    const expectedCloudflareDeployScript = remotes.length > 0 ? 'pnpm -r --filter "./verticals/*" run cloudflare:deploy && pnpm --filter "./apps/shell-super-app" run cloudflare:deploy' : 'pnpm --filter "./apps/shell-super-app" run cloudflare:deploy';
+    const expectedCloudflareSecurity = (0, external_policy_cjs_namespaceObject.createCloudflareSecurityContract)();
+    return (0, external_fs_io_cjs_namespaceObject.renderFileTemplate)("workspace-scripts/validate-ultramodern-workspace.mjs", {
+        packageScope: scope,
+        nodeVersion: external_versions_cjs_namespaceObject.NODE_VERSION,
+        pnpmVersion: external_versions_cjs_namespaceObject.PNPM_VERSION,
+        tailwindEnabledJson: JSON.stringify(enableTailwind),
+        fullStackVerticalsJson: JSON.stringify(verticals, null, 2),
+        shellNamespaceJson: JSON.stringify(shellNamespace),
+        oldRemotePathsJson: JSON.stringify(oldRemotePaths, null, 2),
+        expectedBuildScriptJson: JSON.stringify(expectedBuildScript),
+        expectedCloudflareBuildScriptJson: JSON.stringify(expectedCloudflareBuildScript),
+        expectedCloudflareDeployScriptJson: JSON.stringify(expectedCloudflareDeployScript),
+        expectedCloudflareSecurityJson: JSON.stringify(expectedCloudflareSecurity, null, 2),
+        publicSurfaceManagedSourceAssetPathsJson: JSON.stringify([
+            ...external_public_surface_cjs_namespaceObject.publicSurfaceManagedSourceAssetPaths
+        ], null, 2),
+        shellRouteMetaPathsJson: JSON.stringify(shellRouteMetaPaths, null, 2),
+        cloudflareCompatibilityDate: external_versions_cjs_namespaceObject.CLOUDFLARE_COMPATIBILITY_DATE
+    });
+}
+function createWorkspaceI18nBoundaryValidationScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/check-ultramodern-i18n-boundaries.mjs");
+}
+function createPublicSurfaceAssetsScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/generate-public-surface-assets.mjs");
+}
+function createCloudflareProofHelperScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/ultramodern-cloudflare-proof.mjs");
+}
+function createCloudflareVersionProofScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/proof-cloudflare-version.mjs");
+}
+function createPerformanceReadinessConfigScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/ultramodern-performance-readiness.config.mjs");
+}
+function createPerformanceReadinessScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/ultramodern-performance-readiness.mjs");
+}
+function writeGeneratedWorkspaceScripts(targetDir, scope, enableTailwind, remotes = []) {
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/assert-mf-types.mjs", createAssertMfTypesScript(remotes));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/validate-ultramodern-workspace.mjs", createWorkspaceValidationScript(scope, enableTailwind, remotes));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/check-ultramodern-i18n-boundaries.mjs", createWorkspaceI18nBoundaryValidationScript());
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/generate-public-surface-assets.mjs", createPublicSurfaceAssetsScript());
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/ultramodern-cloudflare-proof.mjs", createCloudflareProofHelperScript());
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/proof-cloudflare-version.mjs", createCloudflareVersionProofScript());
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/ultramodern-performance-readiness.config.mjs", createPerformanceReadinessConfigScript());
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/ultramodern-performance-readiness.mjs", createPerformanceReadinessScript());
+}
+exports.createAssertMfTypesScript = __webpack_exports__.createAssertMfTypesScript;
+exports.createCloudflareProofHelperScript = __webpack_exports__.createCloudflareProofHelperScript;
+exports.createCloudflareVersionProofScript = __webpack_exports__.createCloudflareVersionProofScript;
+exports.createPerformanceReadinessConfigScript = __webpack_exports__.createPerformanceReadinessConfigScript;
+exports.createPerformanceReadinessScript = __webpack_exports__.createPerformanceReadinessScript;
+exports.createPublicSurfaceAssetsScript = __webpack_exports__.createPublicSurfaceAssetsScript;
+exports.createWorkspaceI18nBoundaryValidationScript = __webpack_exports__.createWorkspaceI18nBoundaryValidationScript;
+exports.createWorkspaceValidationScript = __webpack_exports__.createWorkspaceValidationScript;
+exports.writeGeneratedWorkspaceScripts = __webpack_exports__.writeGeneratedWorkspaceScripts;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createAssertMfTypesScript",
+    "createCloudflareProofHelperScript",
+    "createCloudflareVersionProofScript",
+    "createPerformanceReadinessConfigScript",
+    "createPerformanceReadinessScript",
+    "createPublicSurfaceAssetsScript",
+    "createWorkspaceI18nBoundaryValidationScript",
+    "createWorkspaceValidationScript",
+    "writeGeneratedWorkspaceScripts"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -0,0 +1,175 @@
+"use strict";
+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);
+})();
+(()=>{
+    __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__, {
+    generateUltramodernWorkspace: ()=>generateUltramodernWorkspace,
+    writeApp: ()=>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_app_files_cjs_namespaceObject = require("./app-files.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_effect_api_cjs_namespaceObject = require("./effect-api.cjs");
+const external_fs_io_cjs_namespaceObject = require("./fs-io.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_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 = []) {
+    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));
+    (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${resolvedApp.directory}/tsconfig.json`, (0, external_package_json_cjs_namespaceObject.createPackageTsConfig)(resolvedApp.directory, (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(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.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/effect/vertical-clients.ts`, (0, external_effect_api_cjs_namespaceObject.createShellEffectClient)(scope, remotes));
+    }
+    if ((0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(resolvedApp)) {
+        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/shared/effect/api.ts`, (0, external_effect_api_cjs_namespaceObject.createEffectSharedApi)(resolvedApp));
+        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/api/effect/index.ts`, (0, external_effect_api_cjs_namespaceObject.createEffectServiceEntry)(resolvedApp, '../../shared/effect/api.ts'));
+        (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, `${resolvedApp.directory}/src/effect/${resolvedApp.effectApi.stem}-client.ts`, (0, external_effect_api_cjs_namespaceObject.createEffectClient)(resolvedApp, '../../shared/effect/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));
+        }
+    }
+}
+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));
+        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/tsconfig.json`, {
+            extends: `${(0, external_naming_cjs_namespaceObject.relativeRootFor)(sharedPackage.directory)}/tsconfig.base.json`,
+            include: [
+                'src'
+            ]
+        });
+    }
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/index.ts', (0, external_package_json_cjs_namespaceObject.createSharedContractsIndex)());
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-design-tokens/src/index.ts', `export const sharedDesignTokens = {
+  color: {
+    accent: '#2f8f68',
+    foreground: '#133225',
+    surface: '#f6fbf7',
+  },
+} as const;
+`);
+    (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-design-tokens/src/tokens.css', (0, external_app_files_cjs_namespaceObject.createSharedDesignTokensCss)());
+}
+function generateUltramodernWorkspace(options) {
+    const scope = (0, external_naming_cjs_namespaceObject.toPackageScope)(options.packageName);
+    const packageSource = (0, external_package_source_cjs_namespaceObject.resolvePackageSource)(options);
+    const enableTailwind = false !== options.enableTailwind;
+    const initialVerticals = [];
+    (0, external_naming_cjs_namespaceObject.assertUniqueTailwindPrefixes)([
+        external_descriptors_cjs_namespaceObject.shellApp,
+        ...initialVerticals
+    ]);
+    external_node_fs_default().mkdirSync(options.targetDir, {
+        recursive: true
+    });
+    (0, external_fs_io_cjs_namespaceObject.copyRootTemplate)(options.targetDir, {
+        packageName: options.packageName,
+        packageScope: scope,
+        nodeVersion: external_versions_cjs_namespaceObject.NODE_VERSION,
+        pnpmVersion: external_versions_cjs_namespaceObject.PNPM_VERSION,
+        nodeFetchVersion: external_versions_cjs_namespaceObject.NODE_FETCH_VERSION,
+        tanstackRouterVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_VERSION,
+        tailwindEnabled: String(enableTailwind)
+    });
+    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'package.json', (0, external_package_json_cjs_namespaceObject.createRootPackageJson)(scope, packageSource, initialVerticals));
+    (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, '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, '.modernjs/ultramodern-workspace-template-manifest.json', (0, external_contracts_cjs_namespaceObject.createTemplateManifest)(options.modernVersion, packageSource));
+    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, '.modernjs/ultramodern-package-source.json', (0, external_contracts_cjs_namespaceObject.createPackageSourceMetadata)(scope, packageSource));
+    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH, (0, external_contracts_cjs_namespaceObject.createGeneratedContract)(scope, [
+        (0, external_descriptors_cjs_namespaceObject.createShellHost)(initialVerticals),
+        ...initialVerticals
+    ], enableTailwind));
+    writeApp(options.targetDir, scope, external_descriptors_cjs_namespaceObject.shellApp, packageSource, enableTailwind, initialVerticals);
+    for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals);
+    writeSharedPackages(options.targetDir, scope);
+    (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir, scope, enableTailwind, initialVerticals);
+}
+exports.generateUltramodernWorkspace = __webpack_exports__.generateUltramodernWorkspace;
+exports.writeApp = __webpack_exports__.writeApp;
+exports.writeSharedPackages = __webpack_exports__.writeSharedPackages;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "generateUltramodernWorkspace",
+    "writeApp",
+    "writeSharedPackages"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -1,16 +1,14 @@
 import node_fs from "node:fs";
 import node_path from "node:path";
+const MAX_WALK_UP_LEVELS = 5;
 function resolveCreatePackageRoot(fromDir) {
-    const candidates = [
-        fromDir,
-        node_path.resolve(fromDir, '..'),
-        node_path.resolve(fromDir, '..', '..')
-    ];
-    const seen = new Set();
-    for (const candidate of candidates)if (!seen.has(candidate)) {
-        seen.add(candidate);
+    let candidate = fromDir;
+    for(let level = 0; level <= MAX_WALK_UP_LEVELS; level++){
         if (node_fs.existsSync(node_path.join(candidate, 'package.json')) && node_fs.existsSync(node_path.join(candidate, 'template-workspace'))) return candidate;
+        const parent = node_path.dirname(candidate);
+        if (parent === candidate) break;
+        candidate = parent;
     }
-    throw new Error('Unable to resolve create package root');
+    throw new Error(`Unable to resolve the @modern-js/create package root (a directory containing both package.json and template-workspace/) within ${MAX_WALK_UP_LEVELS} levels above ${fromDir}`);
 }
 export { resolveCreatePackageRoot };

package/dist/esm/index.js

@@ -6,12 +6,19 @@ 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.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}=`;
@@ -45,8 +52,10 @@ function getBleedingDevFrameworkVersion(createPackage, 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);
@@ -62,20 +71,26 @@ function showHelp() {
     console.log(i18n.t(localeKeys.help.optionHelp));
     console.log(i18n.t(localeKeys.help.optionVersion));
     console.log(i18n.t(localeKeys.help.optionLang));
-    if (localeKeys.help.optionTailwind) console.log(i18n.t(localeKeys.help.optionTailwind));
-    if (localeKeys.help.optionUltramodernPackageSource) console.log(i18n.t(localeKeys.help.optionUltramodernPackageSource));
-    if (localeKeys.help.optionUltramodernPackageScope) console.log(i18n.t(localeKeys.help.optionUltramodernPackageScope));
-    if (localeKeys.help.optionUltramodernPackageNamePrefix) console.log(i18n.t(localeKeys.help.optionUltramodernPackageNamePrefix));
-    if (localeKeys.help.optionVertical) console.log(i18n.t(localeKeys.help.optionVertical));
-    if (localeKeys.help.optionLegacyModernJs) console.log(i18n.t(localeKeys.help.optionLegacyModernJs));
+    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));
-    if (localeKeys.help.example4) console.log(i18n.t(localeKeys.help.example4));
-    if (localeKeys.help.example5) console.log(i18n.t(localeKeys.help.example5));
-    if (localeKeys.help.example6) console.log(i18n.t(localeKeys.help.example6));
-    if (localeKeys.help.example12) console.log(i18n.t(localeKeys.help.example12));
+    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('');
@@ -132,6 +147,26 @@ function delegateLegacyModernJsSetup(args) {
     });
     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');
@@ -183,7 +218,7 @@ function hasExplicitUltramodernPackageSource(args, value) {
     ]);
     return value ? configuredValue === value : void 0 !== configuredValue;
 }
-function readBleedingDevFrameworkVersionFromRegistry() {
+function readBleedingDevFrameworkVersionFromRegistry(fallbackVersion) {
     const envVersion = process.env[BLEEDINGDEV_FRAMEWORK_VERSION_ENV]?.trim();
     if (envVersion) {
         if (!semverPattern.test(envVersion)) {
@@ -198,16 +233,19 @@ function readBleedingDevFrameworkVersionFromRegistry() {
             `${BLEEDINGDEV_CREATE_PACKAGE}@latest`,
             'ultramodern.frameworkVersion',
             '--json'
-        ]).trim();
+        ], {
+            timeoutMs: REGISTRY_LOOKUP_TIMEOUT_MS
+        }).trim();
         const version = JSON.parse(rawVersion);
         if ('string' == typeof version && semverPattern.test(version)) return version;
     } catch  {}
-    console.error([
-        `Could not resolve ${BLEEDINGDEV_CREATE_PACKAGE}@latest ultramodern.frameworkVersion.`,
-        'Pass --workspace to use local workspace protocol dependencies,',
+    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(' '));
-    process.exit(1);
+    return fallbackVersion;
 }
 function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
     const explicitVersion = getOptionValue(args, [
@@ -222,7 +260,7 @@ function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
     return {
         ...packageSource,
         strategy: 'install',
-        modernPackageVersion: explicitVersion ?? (isBleedingDevCreatePackage(createPackage) ? packageSource.modernPackageVersion : readBleedingDevFrameworkVersionFromRegistry()),
+        modernPackageVersion: explicitVersion ?? (isBleedingDevCreatePackage(createPackage) ? packageSource.modernPackageVersion : readBleedingDevFrameworkVersionFromRegistry(packageSource.modernPackageVersion)),
         aliasScope,
         aliasPackageNamePrefix: getOptionValue(args, [
             '--ultramodern-package-name-prefix'
@@ -230,7 +268,12 @@ function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
     };
 }
 function resolveWorkspacePackageSource(args, createPackage, packageSource) {
-    if (hasExplicitUltramodernPackageSource(args, 'workspace')) return {
+    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
@@ -245,7 +288,8 @@ function runSetupCommand(command, args, options = {}) {
             'ignore',
             'pipe',
             'pipe'
-        ]
+        ],
+        timeout: options.timeoutMs
     });
 }
 function commandExists(command) {
@@ -260,26 +304,9 @@ function commandExists(command) {
         return false;
     }
 }
-function installGitForGeneratedProject() {
+function assertGitAvailableForGeneratedProject() {
     if (commandExists('git')) return;
-    const runShell = (script)=>runSetupCommand('sh', [
-            '-lc',
-            script
-        ], {
-            stdio: 'inherit'
-        });
-    const sudo = 'function' == typeof process.getuid && 0 === process.getuid() ? '' : 'sudo ';
-    if (commandExists('brew')) runSetupCommand('brew', [
-        'install',
-        'git'
-    ], {
-        stdio: 'inherit'
-    });
-    else if ('linux' === process.platform && commandExists('apt-get')) runShell(`${sudo}apt-get update && ${sudo}apt-get install -y git`);
-    else if ('linux' === process.platform && commandExists('dnf')) runShell(`${sudo}dnf install -y git`);
-    else if ('linux' === process.platform && commandExists('yum')) runShell(`${sudo}yum install -y git`);
-    else if ('linux' === process.platform && commandExists('apk')) runShell('apk add --no-cache git');
-    if (!commandExists('git')) throw new Error('Git is required for UltraModern setup. Install git and rerun create, or run pnpm skills:install after installing git.');
+    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 {
@@ -294,7 +321,7 @@ function isInsideGitWorkTree(targetDir) {
     }
 }
 function initializeGeneratedGitRepository(targetDir) {
-    installGitForGeneratedProject();
+    assertGitAvailableForGeneratedProject();
     if (isInsideGitWorkTree(targetDir)) return;
     try {
         runSetupCommand('git', [
@@ -336,6 +363,7 @@ async function getProjectName() {
     const optionWithValue = new Set([
         '--lang',
         '-l',
+        BFF_RUNTIME_OPTION,
         '--ultramodern-package-source',
         '--ultramodern-package-version',
         '--ultramodern-package-registry',
@@ -349,7 +377,8 @@ async function getProjectName() {
         '-v',
         '--tailwind',
         '--no-tailwind',
-        '--workspace',
+        BFF_FLAG,
+        WORKSPACE_PROTOCOL_FLAG,
         '--vertical',
         LEGACY_MODERN_JS_FLAG
     ]);
@@ -361,7 +390,7 @@ async function getProjectName() {
                 i += 1;
                 continue;
             }
-            if (!(arg.startsWith('--lang=') || 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 (!(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) {
@@ -403,6 +432,7 @@ async function main() {
         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);

package/dist/esm/locale/en.js

@@ -28,8 +28,12 @@ const EN_LOCALE = {
         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>',
@@ -41,16 +45,11 @@ const EN_LOCALE = {
         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: '',
-        example8: '',
-        example9: '',
-        example10: '',
-        example11: '',
-        example12: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
+        example7: '  pnpm dlx @bleedingdev/modern-js-create catalog --vertical',
         moreInfo: '📚 Learn more: https://modernjs.dev'
     },
     version: {
-        message: '@bleedingdev/modern-js-create version: {version}'
+        message: '{name} version: {version}'
     }
 };
 export { EN_LOCALE };