generator-mico-cli 0.1.29 → 0.2.2-8.beta.1

package/generators/subapp-react/index.js

@@ -9,7 +9,11 @@ const {
   collectFiles,
   transformDestPath,
   isTemplateFile,
-  setupErrorHandlers
+  getPackageVersionsParallel,
+  detectPackageScope,
+  setupErrorHandlers,
+  createLogger,
+  loadMicorc,
 } = require('../../lib/utils');
 
 const IGNORE_LIST = require('./ignore-list.json');
@@ -20,6 +24,19 @@ setupErrorHandlers();
 module.exports = class extends Generator {
   initializing() {
     this.monorepoRoot = process.cwd();
+    this.logger = createLogger(this);
+
+    // 检查 dry-run 模式
+    this.isDryRun = this.options.dryRun || process.env.MICO_DRY_RUN === '1';
+
+    // 加载 .micorc 配置
+    const { config: rcConfig, configPath } = loadMicorc(this.monorepoRoot);
+    this.rcConfig = rcConfig;
+    if (configPath) {
+      this.logger.verbose('Loaded config from:', configPath);
+      this.logger.verbose('Config:', JSON.stringify(rcConfig, null, 2));
+    }
+
     const appsDir = path.join(this.monorepoRoot, 'apps');
     const workspaceFile = path.join(this.monorepoRoot, 'pnpm-workspace.yaml');
 
@@ -45,37 +62,6 @@ module.exports = class extends Generator {
     }
   }
 
-  _detectPackageScope() {
-    // 尝试从 packages/shared-styles/package.json 读取
-    const sharedStylesPath = path.join(this.monorepoRoot, 'packages/shared-styles/package.json');
-    if (fs.existsSync(sharedStylesPath)) {
-      try {
-        const pkg = JSON.parse(fs.readFileSync(sharedStylesPath, 'utf-8'));
-        if (pkg.name && pkg.name.startsWith('@')) {
-          const match = pkg.name.match(/^(@[^/]+)\//);
-          if (match) return match[1];
-        }
-      } catch (e) {
-        // 忽略解析错误
-      }
-    }
-
-    // 尝试从根 package.json 读取
-    const rootPkgPath = path.join(this.monorepoRoot, 'package.json');
-    if (fs.existsSync(rootPkgPath)) {
-      try {
-        const pkg = JSON.parse(fs.readFileSync(rootPkgPath, 'utf-8'));
-        if (pkg.name) {
-          return `@${pkg.name}`;
-        }
-      } catch (e) {
-        // 忽略解析错误
-      }
-    }
-
-    return null;
-  }
-
   async prompting() {
     try {
       if (!this.monorepoRoot) {
@@ -85,14 +71,15 @@ module.exports = class extends Generator {
         process.exit(1);
       }
 
-      const detectedScope = this._detectPackageScope();
+      const detectedScope = detectPackageScope(this.monorepoRoot);
+      const rc = this.rcConfig || {};
 
       this.answers = await this.prompt([
         {
           type: 'input',
           name: 'appName',
           message: 'Sub app name',
-          default: 'subapp',
+          default: rc.defaultSubappName || 'subapp',
           filter: (input) => toKebab(input),
           validate: (input) => {
             const value = toKebab(input);
@@ -108,18 +95,32 @@ module.exports = class extends Generator {
           type: 'input',
           name: 'packageScope',
           message: 'Package scope',
-          default: detectedScope || '@my-project',
+          default: rc.packageScope || detectedScope || '@my-project',
           validate: (input) => {
             if (!input) return 'Package scope is required';
             if (!input.startsWith('@')) return 'Package scope must start with @';
             return true;
           }
+        },
+        {
+          type: 'input',
+          name: 'devPort',
+          message: 'Dev server port',
+          default: rc.devPort || '8010',
+          validate: (input) => {
+            const port = Number(input);
+            if (!Number.isInteger(port) || port < 1024 || port > 65535) {
+              return 'Port must be an integer between 1024 and 65535';
+            }
+            return true;
+          }
         }
       ]);
 
       this.appName = toKebab(this.answers.appName);
       this.appNamePascal = toPascal(this.appName);
       this.packageScope = this.answers.packageScope;
+      this.devPort = this.answers.devPort;
       this.templateDir = this.templatePath('homepage');
       this.destDir = path.join(this.monorepoRoot, 'apps', this.appName);
     } catch (error) {
@@ -131,7 +132,7 @@ module.exports = class extends Generator {
     }
   }
 
-  writing() {
+  async writing() {
     try {
       if (!fs.existsSync(this.templateDir)) {
         console.error('');
@@ -141,12 +142,41 @@ module.exports = class extends Generator {
         process.exit(1);
       }
 
+      this.logger.verbose('Template directory:', this.templateDir);
+      this.logger.verbose('Destination directory:', this.destDir);
+
+      // 在 mico_cli 根目录执行 npm view，以使用该目录 .npmrc 中的 Nexus 认证
+      const cliRoot = path.resolve(__dirname, '../..');
+      this.logger.verbose('Fetching latest package versions (parallel)...');
+
+      // 并行获取版本
+      const versions = await getPackageVersionsParallel(
+        [
+          { name: '@mico-platform/ui', fallback: '1.0.0' },
+          { name: '@mico-platform/theme', fallback: '1.0.0' },
+        ],
+        8000,
+        cliRoot,
+      );
+
+      const micoUiVer = versions['@mico-platform/ui'];
+      const themeVer = versions['@mico-platform/theme'];
+
+      this.logger.verbose('@mico-platform/ui version:', micoUiVer);
+      this.logger.verbose('@mico-platform/theme version:', themeVer);
+
       const templateData = {
         appName: this.appName,
         AppName: this.appNamePascal,
-        packageScope: this.packageScope
+        packageScope: this.packageScope,
+        devPort: this.devPort,
+        micoUiVersion: `^${micoUiVer}`,
+        themeVersion: `^${themeVer}`,
+        micoUiVersionExact: micoUiVer
       };
 
+      this.logger.verbose('Template data:', JSON.stringify(templateData, null, 2));
+
       const files = collectFiles(this.templateDir, this.templateDir, IGNORE_LIST);
 
       if (files.length === 0) {
@@ -157,17 +187,77 @@ module.exports = class extends Generator {
         process.exit(1);
       }
 
+      // Dry-run 模式：只列出文件，不实际创建
+      if (this.isDryRun) {
+        this.log('');
+        this.log('\x1b[33m📋 Dry run mode - no files will be created\x1b[0m');
+        this.log('');
+        this.log(`   Sub-app: ${this.appName}`);
+        this.log(`   Scope: ${this.packageScope}`);
+        this.log(`   Destination: apps/${this.appName}`);
+        this.log('');
+        this.log('   Would create the following files:');
+        this.log('');
+
+        let templateCount = 0;
+        let copyCount = 0;
+
+        for (const relPath of files) {
+          const destRelPath = transformDestPath(relPath);
+          const isTemplate = isTemplateFile(relPath) || path.basename(relPath) === '.env';
+          const tag = isTemplate ? '\x1b[32m[tpl]\x1b[0m' : '\x1b[36m[cpy]\x1b[0m';
+          this.log(`   ${tag} apps/${this.appName}/${destRelPath}`);
+
+          if (isTemplate) {
+            templateCount++;
+          } else {
+            copyCount++;
+          }
+        }
+
+        this.log('');
+        this.log(`   Total: ${files.length} files (${templateCount} templates, ${copyCount} static)`);
+        this.log('');
+        this.log('   Run without --dry-run to actually create these files.');
+        this.log('');
+
+        // 设置标记以跳过后续阶段
+        this._skipInstall = true;
+        return;
+      }
+
+      this.log('');
+      this.log(`📦 Creating sub-app: ${this.appName}`);
+      this.log(`   Destination: apps/${this.appName}`);
+      this.log('');
+
+      this.logger.verbose(`Processing ${files.length} files...`);
+
+      let templateCount = 0;
+      let copyCount = 0;
+
       for (const relPath of files) {
         const srcPath = path.join(this.templateDir, relPath);
         const destRelPath = transformDestPath(relPath);
         const destPath = path.join(this.destDir, destRelPath);
 
-        if (isTemplateFile(relPath)) {
+        const isEnvFile = path.basename(relPath) === '.env';
+        if (isTemplateFile(relPath) || isEnvFile) {
+          this.logger.file('template', destRelPath);
           this.fs.copyTpl(srcPath, destPath, templateData);
+          templateCount++;
         } else {
+          this.logger.file('copy', destRelPath);
           this.fs.copy(srcPath, destPath);
+          copyCount++;
         }
       }
+
+      this.logger.verbose(`Processed: ${templateCount} templates, ${copyCount} copied`);
+
+      this._updateDevPreset();
+      this._updateMockPages();
+      this._updateConfigDev();
     } catch (error) {
       console.error('');
       console.error('❌ Error during file generation:');
@@ -177,12 +267,208 @@ module.exports = class extends Generator {
     }
   }
 
+  _updateDevPreset() {
+    const presetPath = path.join(this.monorepoRoot, 'dev.preset.json');
+    if (!fs.existsSync(presetPath)) {
+      this.logger.verbose('dev.preset.json not found, skipping preset update');
+      return;
+    }
+
+    try {
+      const preset = JSON.parse(fs.readFileSync(presetPath, 'utf-8'));
+      const fullApps = preset.presets?.full?.apps;
+
+      if (!Array.isArray(fullApps)) {
+        this.logger.verbose('dev.preset.json has no full.apps array, skipping');
+        return;
+      }
+
+      if (fullApps.includes(this.appName)) {
+        this.logger.verbose(`"${this.appName}" already in full preset, skipping`);
+        return;
+      }
+
+      fullApps.push(this.appName);
+      fs.writeFileSync(presetPath, `${JSON.stringify(preset, null, 2)}\n`, 'utf-8');
+
+      this.log(`   📝 已将 "${this.appName}" 添加到 dev.preset.json 的 full 预设中`);
+    } catch (e) {
+      console.warn(`   ⚠️  更新 dev.preset.json 失败: ${e.message}`);
+    }
+  }
+
+  _updateMockPages() {
+    const pagesPath = path.join(this.monorepoRoot, 'apps/layout/mock/pages.ts');
+    if (!fs.existsSync(pagesPath)) {
+      this.logger.verbose('apps/layout/mock/pages.ts not found, skipping');
+      return;
+    }
+
+    try {
+      const content = fs.readFileSync(pagesPath, 'utf-8');
+
+      if (content.includes(`route: '/${this.appName}'`)) {
+        this.logger.verbose(`Route "/${this.appName}" already in mock pages, skipping`);
+        return;
+      }
+
+      // 找出已有的最大 id
+      const idMatches = [...content.matchAll(/id:\s*(\d+)/g)];
+      const maxId = idMatches.reduce((max, m) => Math.max(max, Number(m[1])), 0);
+
+      const newEntry = [
+        '  {',
+        `    id: ${maxId + 1},`,
+        `    name: '${this.appNamePascal}',`,
+        `    nameEn: '${this.appNamePascal}',`,
+        `    nameKey: 'page.${this.appName}',`,
+        `    route: '/${this.appName}',`,
+        `    base: '/${this.appName}',`,
+        `    htmlUrl: '//localhost:${this.devPort}',`,
+        '    jsUrls: [],',
+        '    cssUrls: [],',
+        "    prefixPath: '',",
+        "    routeMode: 'prefix',",
+        '    enabled: true,',
+        '    accessControlEnabled: false,',
+        '    adminOnly: false,',
+        '    routeKey: null,',
+        `    mainDocumentId: ${maxId + 1},`,
+        "    version: '',",
+        '  },',
+      ].join('\n');
+
+      // 插入到兜底路由 (route: '/*') 之前
+      const lines = content.split('\n');
+      let insertIdx = -1;
+
+      for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes("route: '/*'")) {
+          for (let j = i - 1; j >= 0; j--) {
+            if (lines[j].trim() === '{') {
+              insertIdx = j;
+              break;
+            }
+          }
+          break;
+        }
+      }
+
+      if (insertIdx === -1) {
+        const closingIdx = lines.findIndex((l) => l.trim() === '];');
+        if (closingIdx > 0) insertIdx = closingIdx;
+      }
+
+      if (insertIdx > 0) {
+        lines.splice(insertIdx, 0, newEntry);
+        fs.writeFileSync(pagesPath, lines.join('\n'), 'utf-8');
+        this.log(`   📝 已将 "${this.appName}" 的页面配置添加到 mock/pages.ts`);
+      }
+    } catch (e) {
+      console.warn(`   ⚠️  更新 mock/pages.ts 失败: ${e.message}`);
+    }
+  }
+
+  _updateConfigDev() {
+    const configPath = path.join(this.monorepoRoot, 'apps/layout/config/config.dev.ts');
+    if (!fs.existsSync(configPath)) {
+      this.logger.verbose('apps/layout/config/config.dev.ts not found, skipping');
+      return;
+    }
+
+    try {
+      const content = fs.readFileSync(configPath, 'utf-8');
+      const routeEntry = `'/${this.appName}/*'`;
+
+      if (content.includes(routeEntry)) {
+        this.logger.verbose(`Route "${routeEntry}" already in noPermissionRouteList, skipping`);
+        return;
+      }
+
+      const updated = content.replace(
+        /noPermissionRouteList:\s*\[([^\]]*)\]/,
+        (match, inner) => {
+          const trimmed = inner.trim();
+          const entries = trimmed ? `${trimmed}, ${routeEntry}` : routeEntry;
+          return `noPermissionRouteList: [${entries}]`;
+        },
+      );
+
+      if (updated === content) {
+        this.logger.verbose('noPermissionRouteList not found in config.dev.ts, skipping');
+        return;
+      }
+
+      fs.writeFileSync(configPath, updated, 'utf-8');
+      this.log(`   📝 已将 "${routeEntry}" 添加到 config.dev.ts 的 noPermissionRouteList 中`);
+    } catch (e) {
+      console.warn(`   ⚠️  更新 config.dev.ts 失败: ${e.message}`);
+    }
+  }
+
+  install() {
+    // 跳过 dry-run 模式
+    if (this._skipInstall) return;
+
+    this.log('');
+    this.log('📦 正在安装依赖...');
+    try {
+      this.spawnCommandSync('pnpm', ['install'], {
+        cwd: this.monorepoRoot
+      });
+    } catch (e) {
+      this._installFailed = true;
+      this.log('');
+      this.log('⚠️  依赖安装失败，但子应用文件已全部生成。');
+      this.logger.verbose('Install error:', e.message);
+      return;
+    }
+
+    // 依赖安装成功后，格式化被修改的 layout 文件
+    const layoutDir = path.join(this.monorepoRoot, 'apps/layout');
+    if (fs.existsSync(path.join(layoutDir, '.prettierrc'))) {
+      const filesToFormat = [
+        path.join(layoutDir, 'mock/pages.ts'),
+        path.join(layoutDir, 'config/config.dev.ts'),
+      ].filter((f) => fs.existsSync(f));
+
+      if (filesToFormat.length > 0) {
+        try {
+          this.spawnCommandSync(
+            'pnpm',
+            ['-C', 'apps/layout', 'exec', 'prettier', '--write', ...filesToFormat],
+            { cwd: this.monorepoRoot },
+          );
+        } catch (e) {
+          this.logger.verbose('Formatting failed (non-critical):', e.message);
+        }
+      }
+    }
+  }
+
   end() {
+    // 跳过 dry-run 模式
+    if (this._skipInstall) return;
+
+    this.log('');
+
+    if (this._installFailed) {
+      this.log('⚠️  子应用文件已创建，但依赖安装未完成。');
+      this.log('');
+      this.log('   请手动安装依赖:');
+      this.log('');
+      this.log('   pnpm install');
+      this.log('');
+      this.log('   如果安装仍然失败，可尝试:');
+      this.log('   pnpm install --network-concurrency 4');
+    } else {
+      this.log('✅ 子应用创建成功！');
+    }
+
     this.log('');
-    this.log('✅ 子应用创建成功！');
+    this.log('   后续步骤:');
     this.log('');
     this.log(`   cd apps/${this.appName}`);
-    this.log('   pnpm install');
     this.log('   pnpm dev');
     this.log('');
   }

package/generators/subapp-react/meta.json

@@ -0,0 +1,10 @@
+{
+  "name": "subapp-react",
+  "description": "在现有 Monorepo 中创建 React 微前端子应用",
+  "usage": "cd <monorepo-root> && mico create subapp-react",
+  "features": [
+    "UmiJS 4 + React 18",
+    "qiankun 子应用配置",
+    "自动继承主应用主题和请求模块"
+  ]
+}

package/generators/subapp-react/templates/homepage/.env

@@ -1,4 +1,5 @@
 # Default: 5
 CHECK_TIMEOUT=10
 DID_YOU_KNOW=none
-PORT=8010
+PORT=<%= devPort %>
+SOCKET_SERVER=http://localhost:<%= devPort %>

package/generators/subapp-react/templates/homepage/README.md

@@ -89,12 +89,12 @@ PORT=8001
 }
 ```
 
-## 共享依赖
+## 主题变量
 
-如项目配置了共享样式包，可在 Less 文件中引入：
+使用 @mico-platform/theme 时，在 Less 中引入：
 
 ```less
-@import '@your-scope/shared-styles/variables';
+@import '@mico-platform/theme/variables';
 ```
 
 ## 相关文档

package/generators/subapp-react/templates/homepage/config/config.dev.ts

@@ -2,6 +2,13 @@
 
 import { defineConfig } from '@umijs/max';
 
+/**
+ * ⚠️⚠️ 不要修改这个变量名，版本升级工具会读取这个变量名，进行版本升级
+ * @name mico-ui 版本
+ * @description 开发环境使用 mico-ui 的最新版本
+ */
+const MICO_UI_VERSION = '<%= micoUiVersionExact %>';
+
 /**
  * 开发环境配置
  * - 不配置 externals，直接打包依赖，方便独立运行调试
@@ -22,17 +29,17 @@ const config: ReturnType<typeof defineConfig> = {
   // headScripts: [
   //   'https://unpkg.com/react@18/umd/react.development.js',
   //   'https://unpkg.com/react-dom@18/umd/react-dom.development.js',
-  //   'https://unpkg.com/@arco-design/web-react@latest/dist/arco.min.js',
+  //   'https://unpkg.com/@mico-platform/ui@<%= micoUiVersionExact %>/dist/arco.min.js',
   // ],
 
   // /**
   //  * @name 样式加载配置
-  //  * @description 开发环境独立运行时加载 Arco Design CSS
+  //  * @description 开发环境独立运行时加载 @mico-platform/ui CSS
   //  */
   // links: [
   //   {
   //     rel: 'stylesheet',
-  //     href: 'https://unpkg.com/@arco-design/web-react@latest/dist/css/arco.min.css',
+  //     href: 'https://unpkg.com/@mico-platform/ui@<%= micoUiVersionExact %>/dist/css/arco.min.css',
   //   },
   // ],
 
@@ -43,16 +50,16 @@ const config: ReturnType<typeof defineConfig> = {
   // externals: {
   //   react: 'window.React',
   //   'react-dom': 'window.ReactDOM',
-  //   '@arco-design/web-react': 'window.arco',
+  //   '@mico-platform/ui': 'window.micoUI',
   // },
   /**
    * @name 样式加载配置
-   * @description 开发环境独立运行时加载 Arco Design CSS
+   * @description 开发环境独立运行时加载 @mico-platform/ui CSS
    * 作为微前端子应用运行时，样式由主应用提供
    */
   styles: [
-    // Arco Design 基础样式
-    'https://unpkg.com/@arco-design/web-react@2.66.6/dist/css/arco.min.css',
+    // @mico-platform/ui 基础样式（使用运行时解析的最新版本号，避免 latest 标签）
+    `https://cdn-portal.micoplatform.com/portal-center/mico-ui/${MICO_UI_VERSION}/ui/dist/css/mico-ui.min.css`,
   ],
 };
 

package/generators/subapp-react/templates/homepage/config/config.prod.development.ts

@@ -1,25 +1,35 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+// 开发环境，不上传 sourcemap。调试时如有需要再解开
+// import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
-  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}homepage/`
-  : '/homepage/';
+  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}<%= appName %>/`
+  : '/<%= appName %>/';
 
 const config: ReturnType<typeof defineConfig> = {
+  // 开发环境，不上传 sourcemap。调试时如有需要再解开
+  // devtool: 'hidden-source-map',
+
   // 测试环境：将所有代码打包到一个文件
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
+  publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
+
   // 禁用代码分割，只输出一个 JS 和一个 CSS
   chainWebpack(memo) {
     // 禁用 splitChunks
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    memo.plugins.delete('runtimePublicPath');
+    // 开发环境，不上传 sourcemap。调试时如有需要再解开
+    // applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;
   },
-  publicPath: PUBLIC_PATH,
 
   /**
    * @name 外部依赖配置
@@ -28,12 +38,13 @@ const config: ReturnType<typeof defineConfig> = {
    *
    * 作为 qiankun 子应用时，这些库由主应用提供：
    * - react / react-dom: 主应用已加载，避免多实例问题
-   * - @arco-design/web-react: 主应用已加载，复用组件和样式
+   * - @mico-platform/ui: 主应用已加载，复用组件和样式
    */
   externals: {
     react: 'React',
     'react-dom': 'ReactDOM',
-    '@arco-design/web-react': 'arco',
+    '@mico-platform/ui': 'micoUI',
+    '@common-web/sentry': 'CommonWebSentry',
   },
 };
 

package/generators/subapp-react/templates/homepage/config/config.prod.testing.ts

@@ -1,25 +1,35 @@
 // https://umijs.org/config/
 
 import { defineConfig } from '@umijs/max';
+// 测试环境，不上传 sourcemap。调试时如有需要再解开
+// import { applySentryPlugin } from "../../../scripts/apply-sentry-plugin";
 const { CDN_PUBLIC_PATH } = process.env;
 
 const PUBLIC_PATH: string = CDN_PUBLIC_PATH
-  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}homepage/`
-  : '/homepage/';
+  ? `${CDN_PUBLIC_PATH.replace(/\/?$/, '/')}<%= appName %>/`
+  : '/<%= appName %>/';
 
 const config: ReturnType<typeof defineConfig> = {
+  // 测试环境，不上传 sourcemap。调试时如有需要再解开
+  // devtool: 'hidden-source-map',
+
   // 测试环境：将所有代码打包到一个文件
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
+  publicPath: PUBLIC_PATH,
+  cssPublicPath: PUBLIC_PATH,
+
   // 禁用代码分割，只输出一个 JS 和一个 CSS
   chainWebpack(memo) {
     // 禁用 splitChunks
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    memo.plugins.delete('runtimePublicPath');
+    // 测试环境，不上传 sourcemap。调试时如有需要再解开
+    // applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;
   },
-  publicPath: PUBLIC_PATH,
 
   /**
    * @name 外部依赖配置
@@ -28,12 +38,13 @@ const config: ReturnType<typeof defineConfig> = {
    *
    * 作为 qiankun 子应用时，这些库由主应用提供：
    * - react / react-dom: 主应用已加载，避免多实例问题
-   * - @arco-design/web-react: 主应用已加载，复用组件和样式
+   * - @mico-platform/ui: 主应用已加载，复用组件和样式
    */
   externals: {
     react: 'React',
     'react-dom': 'ReactDOM',
-    '@arco-design/web-react': 'arco',
+    '@mico-platform/ui': 'micoUI',
+    '@common-web/sentry': 'CommonWebSentry',
   },
 };