@bleedingdev/modern-js-create 3.4.0-ultramodern.9 → 3.5.0-ultramodern.1

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

@@ -1,5 +1,14 @@
 "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)=>{
@@ -28,41 +37,121 @@ var __webpack_require__ = {};
 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,
-    createUltramodernTypecheckScript: ()=>createUltramodernTypecheckScript,
+    createWorkspaceApiBoundaryValidationScript: ()=>createWorkspaceApiBoundaryValidationScript,
     createWorkspaceI18nBoundaryValidationScript: ()=>createWorkspaceI18nBoundaryValidationScript,
     createWorkspaceValidationScript: ()=>createWorkspaceValidationScript,
     writeGeneratedWorkspaceScripts: ()=>writeGeneratedWorkspaceScripts
 });
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const external_api_cjs_namespaceObject = require("./api.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_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 createToolWrapperScript(command, extraArgs = []) {
+    const commandJson = JSON.stringify(command);
+    const extraArgsJson = JSON.stringify(extraArgs);
+    return `#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const createBin = process.env.ULTRAMODERN_CREATE_BIN;
+const forwardedArgs = process.argv.slice(2);
+const workspaceRoot =
+  process.env.ULTRAMODERN_WORKSPACE_ROOT ??
+  path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const ultramodernArgs = ['ultramodern', ${commandJson}, ...${extraArgsJson}, ...forwardedArgs];
+const result = createBin
+  ? spawnSync(process.execPath, [createBin, ...ultramodernArgs], {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      stdio: 'inherit',
+    })
+  : spawnSync('modern-js-create', ultramodernArgs, {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
     });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);
+`;
+}
+function createSkillsToolWrapperScript() {
+    return `#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const createBin = process.env.ULTRAMODERN_CREATE_BIN;
+const forwardedArgs = process.argv.slice(2);
+const workspaceRoot =
+  process.env.ULTRAMODERN_WORKSPACE_ROOT ??
+  path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const checkOnly = forwardedArgs.includes('--check');
+const skillArgs = checkOnly
+  ? ['skills', 'check', ...forwardedArgs.filter(arg => arg !== '--check')]
+  : ['skills', 'install', ...forwardedArgs];
+const ultramodernArgs = ['ultramodern', ...skillArgs];
+const result = createBin
+  ? spawnSync(process.execPath, [createBin, ...ultramodernArgs], {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      stdio: 'inherit',
+    })
+  : spawnSync('modern-js-create', ultramodernArgs, {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
+    });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);
+`;
+}
+function removeLegacyWorkspaceScript(targetDir, relativePath) {
+    external_node_fs_default().rmSync(external_node_path_default().join(targetDir, relativePath), {
+        force: true
+    });
+}
+function writeWorkspaceOwnedMtsScript(targetDir, name, content) {
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, `scripts/${name}.mts`, content);
+    removeLegacyWorkspaceScript(targetDir, `scripts/${name}.mjs`);
+}
+function migrateCopiedWorkspaceScriptToMts(targetDir, name) {
+    const legacyPath = external_node_path_default().join(targetDir, `scripts/${name}.mjs`);
+    const migratedPath = external_node_path_default().join(targetDir, `scripts/${name}.mts`);
+    if (!external_node_fs_default().existsSync(legacyPath)) return;
+    if (external_node_fs_default().existsSync(migratedPath)) return void external_node_fs_default().rmSync(legacyPath, {
+        force: true
+    });
+    external_node_fs_default().renameSync(legacyPath, migratedPath);
 }
 function createWorkspaceValidationScript(scope, enableTailwind, remotes = []) {
-    const verticals = remotes.filter(external_descriptors_cjs_namespaceObject.appHasEffectApi).map((remote)=>({
+    const verticals = remotes.filter(external_descriptors_cjs_namespaceObject.appHasApi).map((remote)=>({
             id: remote.id,
             domain: remote.domain,
-            stem: remote.effectApi.stem,
-            group: (0, external_effect_api_cjs_namespaceObject.verticalEffectGroupName)(remote),
+            stem: remote.api.stem,
+            group: (0, external_api_cjs_namespaceObject.verticalApiGroupName)(remote),
             path: remote.directory,
             port: remote.port,
             mfName: remote.mfName,
-            apiPrefix: remote.effectApi.prefix,
+            apiPrefix: remote.api.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),
@@ -103,55 +192,36 @@ function createWorkspaceValidationScript(scope, enableTailwind, remotes = []) {
     });
 }
 function createWorkspaceI18nBoundaryValidationScript() {
-    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/check-ultramodern-i18n-boundaries.mjs");
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/check-ultramodern-i18n-boundaries.mts");
 }
-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 createWorkspaceApiBoundaryValidationScript() {
+    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/check-ultramodern-api-boundaries.mts");
 }
 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 createUltramodernTypecheckScript() {
-    return (0, external_fs_io_cjs_namespaceObject.readFileTemplate)("workspace-scripts/ultramodern-typecheck.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());
+function writeGeneratedWorkspaceScripts(targetDir, _scope, _enableTailwind, _remotes = []) {
+    writeWorkspaceOwnedMtsScript(targetDir, 'assert-mf-types', createToolWrapperScript('mf-types'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'validate-ultramodern-workspace', createToolWrapperScript('validate'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'check-ultramodern-i18n-boundaries', createWorkspaceI18nBoundaryValidationScript());
+    writeWorkspaceOwnedMtsScript(targetDir, 'check-ultramodern-api-boundaries', createWorkspaceApiBoundaryValidationScript());
+    writeWorkspaceOwnedMtsScript(targetDir, 'generate-public-surface-assets', createToolWrapperScript('public-surface'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'proof-cloudflare-version', createToolWrapperScript('cloudflare-proof'));
     (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());
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, "scripts/ultramodern-typecheck.mjs", createUltramodernTypecheckScript());
+    writeWorkspaceOwnedMtsScript(targetDir, 'ultramodern-performance-readiness', createToolWrapperScript('performance-readiness'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'migrate-strict-effect', createToolWrapperScript('migrate-strict-effect'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'ultramodern-typecheck', createToolWrapperScript('typecheck'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'bootstrap-agent-skills', createSkillsToolWrapperScript());
+    migrateCopiedWorkspaceScriptToMts(targetDir, 'setup-agent-reference-repos');
 }
-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.createUltramodernTypecheckScript = __webpack_exports__.createUltramodernTypecheckScript;
+exports.createWorkspaceApiBoundaryValidationScript = __webpack_exports__.createWorkspaceApiBoundaryValidationScript;
 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",
-    "createUltramodernTypecheckScript",
+    "createWorkspaceApiBoundaryValidationScript",
     "createWorkspaceI18nBoundaryValidationScript",
     "createWorkspaceValidationScript",
     "writeGeneratedWorkspaceScripts"

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

@@ -37,17 +37,19 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    createCompactUltramodernConfig: ()=>createCompactUltramodernConfig,
     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_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_effect_api_cjs_namespaceObject = require("./effect-api.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");
@@ -59,13 +61,13 @@ const external_package_source_cjs_namespaceObject = require("./package-source.cj
 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 = []) {
+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));
+    (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));
@@ -93,12 +95,12 @@ function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes
     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));
+        (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.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 ((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));
@@ -124,10 +126,36 @@ function writeSharedPackages(targetDir, scope) {
 `);
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-design-tokens/src/tokens.css', (0, external_app_files_cjs_namespaceObject.createSharedDesignTokensCss)());
 }
+function createCompactRootPackageJson(scope, packageSource, remotes, bridge) {
+    const rootPackage = (0, external_package_json_cjs_namespaceObject.createRootPackageJson)(scope, packageSource, remotes, bridge);
+    if (rootPackage.modernjs?.packageSource && 'object' == typeof rootPackage.modernjs.packageSource) rootPackage.modernjs.packageSource.config = `./${external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH}`;
+    return rootPackage;
+}
+function createCompactUltramodernConfig(scope, modernVersion, packageSource, apps = [
+    (0, external_descriptors_cjs_namespaceObject.createShellHost)()
+], enableTailwind = true, bridge) {
+    const config = (0, external_contracts_cjs_namespaceObject.createUltramodernConfig)(scope, modernVersion, packageSource, apps, enableTailwind, bridge);
+    if (config.packageSource && 'object' == typeof config.packageSource && !Array.isArray(config.packageSource)) delete config.packageSource.metadata;
+    return config;
+}
+function writePnpmWorkspacePackages(targetDir, bridge) {
+    if (!bridge) return;
+    const pnpmWorkspacePath = `${targetDir}/pnpm-workspace.yaml`;
+    const pnpmWorkspace = external_node_fs_default().readFileSync(pnpmWorkspacePath, 'utf-8');
+    const packages = [
+        'apps/*',
+        'verticals/*',
+        'packages/*',
+        ...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`));
+}
 function generateUltramodernWorkspace(options) {
     const beforeFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
     const scope = (0, external_naming_cjs_namespaceObject.toPackageScope)(options.packageName);
     const packageSource = (0, external_package_source_cjs_namespaceObject.resolvePackageSource)(options);
+    const bridge = (0, external_bridge_config_cjs_namespaceObject.normalizeUltramodernBridgeConfig)(options.bridge);
     const enableTailwind = false !== options.enableTailwind;
     const initialVerticals = [];
     const createdApps = [
@@ -147,45 +175,60 @@ 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,
+        effectVersion: external_versions_cjs_namespaceObject.EFFECT_VERSION,
+        effectVitestVersion: external_versions_cjs_namespaceObject.EFFECT_VITEST_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,
         tailwindEnabled: String(enableTailwind)
     });
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'package.json', (0, external_package_json_cjs_namespaceObject.createRootPackageJson)(scope, packageSource, initialVerticals));
+    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.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, '.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, createdApps, 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);
+    (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);
     writeSharedPackages(options.targetDir, scope);
     (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir, scope, enableTailwind, initialVerticals);
-    const afterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
-    const { createdPaths, rewrittenPaths } = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, afterFiles);
-    const result = (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
+    const preliminaryAfterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
+    const preliminaryDiff = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, preliminaryAfterFiles);
+    const preliminaryResult = (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
         operation: 'workspace',
         workspaceRoot: options.targetDir,
         packageScope: scope,
         packageSource,
         createdApps,
-        createdPaths,
-        rewrittenPaths
+        createdPaths: preliminaryDiff.createdPaths,
+        rewrittenPaths: preliminaryDiff.rewrittenPaths
     });
     (0, external_overlays_cjs_namespaceObject.runCodeSmithOverlays)({
         workspaceRoot: options.targetDir,
         overlays: options.overlays,
-        result
+        result: preliminaryResult
+    });
+    (0, external_fs_io_cjs_namespaceObject.formatGeneratedWorkspaceFiles)(options.targetDir);
+    const afterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
+    const { createdPaths, rewrittenPaths } = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, afterFiles);
+    return (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
+        operation: 'workspace',
+        workspaceRoot: options.targetDir,
+        packageScope: scope,
+        packageSource,
+        createdApps,
+        createdPaths,
+        rewrittenPaths
     });
-    return result;
 }
+exports.createCompactUltramodernConfig = __webpack_exports__.createCompactUltramodernConfig;
 exports.generateUltramodernWorkspace = __webpack_exports__.generateUltramodernWorkspace;
 exports.writeApp = __webpack_exports__.writeApp;
 exports.writeSharedPackages = __webpack_exports__.writeSharedPackages;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createCompactUltramodernConfig",
     "generateUltramodernWorkspace",
     "writeApp",
     "writeSharedPackages"

package/dist/esm/index.js

@@ -6,7 +6,9 @@ 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 { runUltramodernToolingCli } from "./ultramodern-tooling/commands.js";
 import { addUltramodernVertical, generateUltramodernWorkspace, planUltramodernVertical } from "./ultramodern-workspace/index.js";
+import { hasUltramodernBridgeCliOptions, parseUltramodernBridgeCliOptions, ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliValueFlags } from "./ultramodern-workspace/bridge-config.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.-]+)?$/;
@@ -84,6 +86,16 @@ function showHelp() {
     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));
@@ -172,7 +184,7 @@ function detectBffRuntime(args) {
         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(', ')}).`);
+        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;
@@ -197,7 +209,8 @@ function collectPositionalArgs(args) {
         '--ultramodern-package-scope',
         '--ultramodern-package-name-prefix',
         VERTICAL_NAME_FLAG,
-        CODESMITH_OVERLAY_FLAG
+        CODESMITH_OVERLAY_FLAG,
+        ...ultramodernBridgeCliValueFlags
     ]);
     const optionWithoutValue = new Set([
         '--help',
@@ -210,7 +223,8 @@ function collectPositionalArgs(args) {
         WORKSPACE_PROTOCOL_FLAG,
         DRY_RUN_FLAG,
         VERTICAL_FLAG,
-        LEGACY_MODERN_JS_FLAG
+        LEGACY_MODERN_JS_FLAG,
+        ...ultramodernBridgeCliBooleanFlags
     ]);
     const positionalArgs = [];
     for(let i = 0; i < args.length; i++){
@@ -220,7 +234,7 @@ function collectPositionalArgs(args) {
                 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}=`))) 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=') || 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;
@@ -336,6 +350,14 @@ function detectCodeSmithOverlays(args) {
     }
     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);
+    }
+}
 function detectUltramodernPackageSource(args, defaultPackageVersion, createPackage) {
     const bleedingDevDefaults = isBleedingDevCreatePackage(createPackage);
     const strategy = getOptionValue(args, [
@@ -545,6 +567,10 @@ async function getProjectName() {
 }
 async function main() {
     const args = process.argv.slice(2);
+    if ('ultramodern' === args[0]) {
+        process.exitCode = await runUltramodernToolingCli(args.slice(1));
+        return;
+    }
     if (args.includes('--help') || args.includes('-h')) return void showHelp();
     if (args.includes('--version') || args.includes('-v')) return void showVersion();
     if (detectLegacyModernJsFlag(args)) {
@@ -556,10 +582,16 @@ async function main() {
     const dryRun = detectDryRunFlag(args);
     const verticalInput = resolveVerticalCliInput(args);
     const overlays = detectCodeSmithOverlays(args);
+    const bridgeRequested = hasUltramodernBridgeCliOptions(args);
     if (dryRun && !verticalInput.addVertical) {
         console.error(`${DRY_RUN_FLAG} is currently supported only with ${VERTICAL_FLAG}`);
         process.exit(1);
     }
+    if (verticalInput.addVertical && bridgeRequested) {
+        console.error('Bridge options are supported only when creating a new UltraModern workspace.');
+        process.exit(1);
+    }
+    const bridge = readBridgeCliOptions(args);
     if (!dryRun) console.log(`\n${i18n.t(localeKeys.message.welcome)}\n`);
     const createPackage = readCreatePackageJson();
     const version = createPackage.version || 'latest';
@@ -600,6 +632,7 @@ async function main() {
         packageName: generatedPackageName,
         modernVersion: version,
         enableTailwind: detectTailwindFlag(),
+        bridge,
         overlays,
         packageSource
     });

package/dist/esm/locale/en.js

@@ -18,7 +18,7 @@ const EN_LOCALE = {
         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!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+        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,\na strict Effect API runtime, 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',
@@ -30,7 +30,7 @@ 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)',
+        optionBff: '      --bff Keep the default strict Effect API runtime (every MicroVertical ships one)',
         optionBffRuntime: '      --bff-runtime Select the BFF runtime for scaffolded MicroVerticals (supported: effect; default: effect)',
         optionWorkspace: '      --workspace Use workspace protocol for @modern-js dependencies (for local monorepo testing)',
         optionUltramodernPackageSource: '      --ultramodern-package-source Select UltraModern package source (workspace or install; BleedingDev defaults to install aliases)',
@@ -38,6 +38,16 @@ const EN_LOCALE = {
         optionUltramodernPackageRegistry: '      --ultramodern-package-registry npm registry URL used for install package sources',
         optionUltramodernPackageScope: '      --ultramodern-package-scope Publish scope for npm alias installs (for example bleedingdev)',
         optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix Prefix for npm alias package names (default: modern-js-)',
+        optionBridge: '      --bridge Enable explicit nested parent-monorepo bridge mode for new workspaces',
+        optionBridgeParentRoot: '      --bridge-parent-root <path> Parent monorepo root for bridge mode',
+        optionBridgeWorkspacePackage: '      --bridge-workspace-package <glob> Parent workspace package glob consumed by generated apps',
+        optionBridgeWorkspacePackageName: '      --bridge-workspace-package-name <glob=package[,package]> Package names covered by a bridge workspace glob',
+        optionBridgeTestAlias: '      --bridge-test-alias <glob:alias=target> Test/source alias for a bridge workspace package glob',
+        optionBridgeDependency: '      --bridge-dependency <package[,package]> Explicit parent package dependency consumed by generated apps',
+        optionBridgeLockfilePolicy: '      --bridge-lockfile-policy <nested|parent> Bridge lockfile ownership policy (default: nested)',
+        optionBridgeGate: '      --bridge-gate <name=command> Delegated parent workspace gate command for bridge packages',
+        optionBridgeGateCwd: '      --bridge-gate-cwd <name=cwd> Working directory for a named bridge gate',
+        optionBridgeReactSingleton: '      --bridge-react-singleton <package[,package]> React singleton package expectation (default: react,react-dom)',
         optionVertical: '      --vertical[=<name>] Mutate the current existing UltraModern workspace and wire a MicroVertical',
         optionVerticalName: '      --vertical-name <name> Explicit MicroVertical name for automation-friendly workspace mutation',
         optionDryRun: '      --dry-run Preview a MicroVertical mutation plan without writing files (supported with --vertical)',

package/dist/esm/locale/zh.js

@@ -18,7 +18,7 @@ const ZH_LOCALE = {
         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!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n严重警告：你正在退出 ULTRAMODERN.JS 默认配置。\n免交互默认值是最佳 UltraModern.js 配置：\n结构化 SuperApp 工作区、presetUltramodern、TanStack Router、\n严格 Effect API 运行时、Tailwind CSS v4，以及 BleedingDev 包版本队列。\n原始 Modern.js 初始化是危险的显式选择路径。\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
     },
     help: {
         title: '🚀 UltraModern.js 项目创建工具',
@@ -30,7 +30,7 @@ const ZH_LOCALE = {
         optionVersion: '  -v, --version  显示版本信息',
         optionLang: '  -l, --lang     设置语言 (默认 en；zh 需显式选择)',
         optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 工作区样式',
-        optionBff: '      --bff 保留默认的 Effect BFF 脚手架（每个 MicroVertical 自带 Effect BFF）',
+        optionBff: '      --bff 保留默认的严格 Effect API 运行时（每个 MicroVertical 自带一个）',
         optionBffRuntime: '      --bff-runtime 选择 MicroVertical 脚手架的 BFF 运行时（支持: effect；默认: effect）',
         optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
         optionUltramodernPackageSource: '      --ultramodern-package-source 选择 UltraModern 依赖来源（workspace 或 install；BleedingDev 默认使用 install alias）',
@@ -38,6 +38,16 @@ const ZH_LOCALE = {
         optionUltramodernPackageRegistry: '      --ultramodern-package-registry install 依赖来源使用的 npm registry 地址',
         optionUltramodernPackageScope: '      --ultramodern-package-scope npm alias 安装使用的发布 scope（例如 bleedingdev）',
         optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix npm alias 包名前缀（默认：modern-js-）',
+        optionBridge: '      --bridge 为新工作区启用显式的嵌套父 monorepo 桥接模式',
+        optionBridgeParentRoot: '      --bridge-parent-root <路径> 桥接模式使用的父 monorepo 根目录',
+        optionBridgeWorkspacePackage: '      --bridge-workspace-package <glob> 生成应用消费的父工作区包 glob',
+        optionBridgeWorkspacePackageName: '      --bridge-workspace-package-name <glob=包名[,包名]> 桥接工作区 glob 覆盖的包名',
+        optionBridgeTestAlias: '      --bridge-test-alias <glob:别名=目标> 桥接工作区包 glob 的测试/源码 alias',
+        optionBridgeDependency: '      --bridge-dependency <包名[,包名]> 生成应用显式消费的父包依赖',
+        optionBridgeLockfilePolicy: '      --bridge-lockfile-policy <nested|parent> 桥接 lockfile 归属策略（默认：nested）',
+        optionBridgeGate: '      --bridge-gate <名称=命令> 桥接包委托给父工作区执行的 gate 命令',
+        optionBridgeGateCwd: '      --bridge-gate-cwd <名称=目录> 指定桥接 gate 的工作目录',
+        optionBridgeReactSingleton: '      --bridge-react-singleton <包名[,包名]> React 单例包预期（默认：react,react-dom）',
         optionVertical: '      --vertical[=<名称>] 修改当前已有的 UltraModern 工作区，并接入 MicroVertical',
         optionVerticalName: '      --vertical-name <名称> 为自动化工作流显式指定 MicroVertical 名称',
         optionDryRun: '      --dry-run 预览 MicroVertical 修改计划但不写入文件（与 --vertical 一起使用）',