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

package/lib/utils.js

@@ -2,6 +2,8 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
+const { exec, execSync, execFileSync, execFile } = require('node:child_process');
+const os = require('node:os');
 
 /**
  * 转换为 kebab-case
@@ -107,7 +109,8 @@ const TEMPLATE_EXTENSIONS = new Set([
   '.less',
   '.md',
   '.mdc',
-  '.sh'
+  '.sh',
+  '.html'
 ]);
 
 /**
@@ -119,10 +122,321 @@ function isTemplateFile(filePath) {
   return TEMPLATE_EXTENSIONS.has(path.extname(filePath));
 }
 
+/**
+ * 从 monorepo 根目录的 package.json 推断包 scope
+ * @param {string} monorepoRoot - monorepo 根目录路径
+ * @returns {string|null} 推断出的 scope（如 '@my-project'），未找到返回 null
+ */
+function detectPackageScope(monorepoRoot) {
+  const rootPkgPath = path.join(monorepoRoot, 'package.json');
+  if (fs.existsSync(rootPkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(rootPkgPath, 'utf-8'));
+      if (pkg.name) {
+        return pkg.name.startsWith('@')
+          ? pkg.name.replace(/^(@[^/]+)\/.*/, '$1')
+          : `@${pkg.name}`;
+      }
+    } catch {
+      // ignore
+    }
+  }
+  return null;
+}
+
+/** 合法 npm 包名正则：可选 @scope/name，仅允许字母数字、连字符、点、下划线 */
+const VALID_PACKAGE_NAME_RE = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/i;
+
+/** scope 包含 mico 时使用的 registry（如 @mico-platform/*） */
+const MICO_NPM_REGISTRY = 'https://nexus-vywrajy.micoworld.net/repository/mico-base-common/';
+
+/**
+ * 根据包名 scope 选择 registry：scope 包含 mico 时用 MICO_NPM_REGISTRY，否则用 npm 默认
+ * @param {string} packageName - 包名，如 '@mico-platform/ui'
+ * @returns {string|undefined} registry URL 或 undefined（使用默认）
+ */
+function getRegistryForPackage(packageName) {
+  if (!packageName.startsWith('@')) return undefined;
+  const scope = packageName.slice(1).split('/')[0] || '';
+  return scope.toLowerCase().includes('mico') ? MICO_NPM_REGISTRY : undefined;
+}
+
+/**
+ * 从 npm registry 获取包的最新版本号（同步版本）
+ * registry 根据 packageName 的 scope 自动选择：scope 包含 mico 时用 MICO_NPM_REGISTRY，否则用默认
+ * @param {string} packageName - 包名，如 '@mico-platform/ui'
+ * @param {string} [fallback='1.0.0'] - 网络或超时时的回退版本
+ * @param {number} [timeoutMs=8000] - 超时毫秒
+ * @param {string} [cwd] - 执行 npm view 的 cwd，用于加载该目录下的 .npmrc（含 Nexus 认证时必传）
+ * @returns {string} 版本号，如 '1.2.3'
+ */
+function getLatestNpmVersion(packageName, fallback = '1.0.0', timeoutMs = 8000, cwd) {
+  if (!VALID_PACKAGE_NAME_RE.test(packageName)) {
+    return fallback;
+  }
+  const registry = getRegistryForPackage(packageName);
+  const args = ['view', packageName, 'version'];
+  if (registry) args.push(`--registry=${registry}`);
+  try {
+    const out = execFileSync('npm', args, {
+      encoding: 'utf-8',
+      timeout: timeoutMs,
+      stdio: ['pipe', 'pipe', 'pipe'],
+      ...(cwd && { cwd })
+    });
+    const v = out.trim();
+    return v && /^\d+\.\d+\.\d+/.test(v) ? v : fallback;
+  } catch (e) {
+    return fallback;
+  }
+}
+
+/**
+ * 从 npm registry 获取包的最新版本号（异步版本）
+ * @param {string} packageName - 包名，如 '@mico-platform/ui'
+ * @param {string} [fallback='1.0.0'] - 网络或超时时的回退版本
+ * @param {number} [timeoutMs=8000] - 超时毫秒
+ * @param {string} [cwd] - 执行 npm view 的 cwd
+ * @returns {Promise<string>} 版本号，如 '1.2.3'
+ */
+function getLatestNpmVersionAsync(packageName, fallback = '1.0.0', timeoutMs = 8000, cwd) {
+  if (!VALID_PACKAGE_NAME_RE.test(packageName)) {
+    return Promise.resolve(fallback);
+  }
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (value) => {
+      if (!settled) {
+        settled = true;
+        resolve(value);
+      }
+    };
+
+    const registry = getRegistryForPackage(packageName);
+    const args = ['view', packageName, 'version'];
+    if (registry) args.push(`--registry=${registry}`);
+
+    const child = execFile('npm', args, {
+      encoding: 'utf-8',
+      timeout: timeoutMs,
+      ...(cwd && { cwd })
+    }, (error, stdout) => {
+      if (error) {
+        done(fallback);
+        return;
+      }
+      const v = stdout.trim();
+      done(v && /^\d+\.\d+\.\d+/.test(v) ? v : fallback);
+    });
+
+    setTimeout(() => {
+      child.kill();
+      done(fallback);
+    }, timeoutMs + 100);
+  });
+}
+
+/**
+ * 并行获取多个包的版本号
+ * @param {Array<{name: string, fallback?: string}>} packages - 包列表
+ * @param {number} [timeoutMs=8000] - 超时毫秒
+ * @param {string} [cwd] - 执行 npm view 的 cwd
+ * @returns {Promise<Record<string, string>>} 包名到版本号的映射
+ */
+async function getPackageVersionsParallel(packages, timeoutMs = 8000, cwd) {
+  const results = await Promise.all(
+    packages.map(async (pkg) => {
+      const version = await getLatestNpmVersionAsync(
+        pkg.name,
+        pkg.fallback || '1.0.0',
+        timeoutMs,
+        cwd
+      );
+      return { name: pkg.name, version };
+    })
+  );
+
+  return results.reduce((acc, { name, version }) => {
+    acc[name] = version;
+    return acc;
+  }, {});
+}
+
+// ============ 配置文件支持 ============
+
+/**
+ * 查找并加载 .micorc 配置文件
+ * 按优先级从高到低查找：当前目录 -> 用户主目录
+ * @param {string} [startDir] - 开始查找的目录，默认为 process.cwd()
+ * @returns {object} 配置对象，找不到则返回空对象
+ */
+function loadMicorc(startDir = process.cwd()) {
+  const configNames = ['.micorc', '.micorc.json'];
+  const searchPaths = [
+    startDir,
+    os.homedir()
+  ];
+
+  for (const dir of searchPaths) {
+    for (const name of configNames) {
+      const configPath = path.join(dir, name);
+      if (fs.existsSync(configPath)) {
+        try {
+          const content = fs.readFileSync(configPath, 'utf-8');
+          const config = JSON.parse(content);
+          return { config, configPath };
+        } catch (e) {
+          // 解析失败，继续查找
+          console.warn(`Warning: Failed to parse ${configPath}: ${e.message}`);
+        }
+      }
+    }
+  }
+
+  return { config: {}, configPath: null };
+}
+
+/**
+ * 合并配置与用户输入
+ * @param {object} defaults - 默认值
+ * @param {object} rcConfig - .micorc 配置
+ * @returns {object} 合并后的默认值
+ */
+function mergeDefaults(defaults, rcConfig) {
+  return { ...defaults, ...rcConfig };
+}
+
+// ============ 环境检查 ============
+
+/**
+ * 检查命令是否可用
+ * @param {string} command - 命令名称
+ * @returns {{available: boolean, version?: string, error?: string}}
+ */
+function checkCommand(command) {
+  try {
+    const out = execSync(`${command} --version`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000
+    });
+    const version = out.trim().split('\n')[0];
+    return { available: true, version };
+  } catch (e) {
+    return { available: false, error: e.message };
+  }
+}
+
+/**
+ * 检查 Node.js 版本是否满足要求
+ * @param {string} required - 要求的最低版本，如 '18'
+ * @returns {{satisfied: boolean, current: string, required: string}}
+ */
+function checkNodeVersion(required = '18') {
+  const current = process.version.replace(/^v/, '');
+  const currentMajor = parseInt(current.split('.')[0], 10);
+  const requiredMajor = parseInt(required, 10);
+  return {
+    satisfied: currentMajor >= requiredMajor,
+    current,
+    required
+  };
+}
+
+/**
+ * 检查网络连接（npm registry）
+ * @param {number} [timeoutMs=5000] - 超时毫秒
+ * @returns {Promise<{reachable: boolean, registry: string, error?: string}>}
+ */
+async function checkNpmRegistry(timeoutMs = 5000) {
+  const registry = 'https://registry.npmjs.org';
+  return new Promise((resolve) => {
+    const child = exec(`npm ping --registry=${registry}`, {
+      timeout: timeoutMs
+    }, (error) => {
+      if (error) {
+        resolve({ reachable: false, registry, error: error.message });
+      } else {
+        resolve({ reachable: true, registry });
+      }
+    });
+
+    setTimeout(() => {
+      child.kill();
+      resolve({ reachable: false, registry, error: 'Timeout' });
+    }, timeoutMs + 100);
+  });
+}
+
+/**
+ * 运行完整的环境检查
+ * @returns {Promise<object>} 检查结果
+ */
+async function runDoctorChecks() {
+  const results = {
+    node: checkNodeVersion('18'),
+    pnpm: checkCommand('pnpm'),
+    git: checkCommand('git'),
+    npm: null
+  };
+
+  // 异步检查 npm registry
+  results.npm = await checkNpmRegistry();
+
+  return results;
+}
+
+/**
+ * 检查是否启用了 verbose 模式
+ * @returns {boolean}
+ */
+function isVerbose() {
+  return process.env.MICO_VERBOSE === '1';
+}
+
+/**
+ * 详细日志输出（仅在 verbose 模式下打印）
+ * @param {...any} args - 要打印的内容
+ */
+function verboseLog(...args) {
+  if (isVerbose()) {
+    console.log('\x1b[2m[verbose]', ...args, '\x1b[0m');
+  }
+}
+
+/**
+ * 创建一个带有 verbose 支持的 Logger
+ * @param {object} generator - Yeoman generator 实例
+ * @returns {object} Logger 对象
+ */
+function createLogger(generator) {
+  const log = generator.log.bind(generator);
+  return {
+    info: (...args) => log(...args),
+    verbose: (...args) => {
+      if (isVerbose()) {
+        log('\x1b[2m[verbose]', ...args, '\x1b[0m');
+      }
+    },
+    success: (msg) => log(`\x1b[32m✓\x1b[0m ${msg}`),
+    warn: (msg) => log(`\x1b[33m⚠\x1b[0m ${msg}`),
+    error: (msg) => log(`\x1b[31m✗\x1b[0m ${msg}`),
+    file: (action, filePath) => {
+      if (isVerbose()) {
+        const actionColor = action === 'create' ? '\x1b[32m' : action === 'copy' ? '\x1b[36m' : '\x1b[33m';
+        log(`  ${actionColor}${action}\x1b[0m ${filePath}`);
+      }
+    }
+  };
+}
+
 /**
  * 安装全局未捕获异常处理
+ * 在 Vitest 等测试环境中自动跳过，避免干扰测试 runner 的进程管理
  */
 function setupErrorHandlers() {
+  if (process.env.VITEST) return;
+
   process.on('uncaughtException', (error) => {
     console.error('');
     console.error('❌ Unexpected error:');
@@ -156,10 +470,26 @@ module.exports = {
   toPascal,
   toCamel,
   // Generator 工具
+  detectPackageScope,
   shouldIgnorePath,
   collectFiles,
   transformDestPath,
   isTemplateFile,
+  getLatestNpmVersion,
+  getLatestNpmVersionAsync,
+  getPackageVersionsParallel,
   setupErrorHandlers,
-  TEMPLATE_EXTENSIONS
+  TEMPLATE_EXTENSIONS,
+  // 配置文件
+  loadMicorc,
+  mergeDefaults,
+  // 环境检查
+  checkCommand,
+  checkNodeVersion,
+  checkNpmRegistry,
+  runDoctorChecks,
+  // Verbose 日志
+  isVerbose,
+  verboseLog,
+  createLogger
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.1.29",
+  "version": "0.2.28.beta.1",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": [
     "yeoman-generator",
@@ -18,7 +18,19 @@
     "generators"
   ],
   "scripts": {
-    "sync:subapp-react-template": "node scripts/sync-subapp-react-template.js"
+    "prepare": "husky",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "sync:subapp-react-template": "node scripts/sync-subapp-react-template.js",
+    "verify:micro-react": "node scripts/verify-micro-react.js"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "husky": "^9.1.7",
+    "vitest": "^4.0.18",
+    "yeoman-test": "^6.3.0"
   },
   "engines": {
     "node": ">=18"
@@ -26,6 +38,7 @@
   "dependencies": {
     "semver": "^7.6.3",
     "update-notifier": "^7.3.1",
+    "yeoman-environment": "^3.19.3",
     "yeoman-generator": "^5.9.0"
   }
 }

package/generators/micro-react/templates/apps/layout/mock/menus.json

@@ -1,100 +0,0 @@
-[
-  {
-    "id": 1,
-    "name": "首页",
-    "type": "page",
-    "path": null,
-    "icon": "Home",
-    "enabled": true,
-    "sortOrder": 0,
-    "pageId": 1,
-    "page": {
-      "id": 1,
-      "name": "home",
-      "route": "/",
-      "enabled": true,
-      "htmlUrl": null,
-      "jsUrls": [],
-      "cssUrls": []
-    },
-    "children": []
-  },
-  {
-    "id": 2,
-    "name": "示例模块",
-    "type": "group",
-    "path": null,
-    "icon": "List",
-    "enabled": true,
-    "sortOrder": 1,
-    "pageId": null,
-    "page": null,
-    "children": [
-      {
-        "id": 3,
-        "name": "示例页面",
-        "type": "page",
-        "path": "/example/page",
-        "icon": "File",
-        "enabled": true,
-        "sortOrder": 1,
-        "pageId": 45,
-        "page": {
-          "id": 45,
-          "name": "example-page",
-          "route": "/example/page",
-          "enabled": true,
-          "htmlUrl": null,
-          "jsUrls": [],
-          "cssUrls": []
-        },
-        "children": []
-      }
-    ]
-  },
-  {
-    "id": 5,
-    "name": "微应用示例",
-    "type": "group",
-    "path": null,
-    "icon": "Apps",
-    "enabled": true,
-    "sortOrder": 2,
-    "pageId": null,
-    "page": null,
-    "children": [
-      {
-        "id": 6,
-        "name": "子应用页面",
-        "type": "page",
-        "path": null,
-        "icon": "Desktop",
-        "enabled": true,
-        "sortOrder": 1,
-        "pageId": 55,
-        "page": {
-          "id": 55,
-          "name": "subapp-example",
-          "route": "/subapp",
-          "enabled": true,
-          "htmlUrl": "//localhost:8010",
-          "jsUrls": [],
-          "cssUrls": []
-        },
-        "children": []
-      }
-    ]
-  },
-  {
-    "id": 7,
-    "name": "外部链接",
-    "type": "link",
-    "path": "https://github.com",
-    "icon": "Link",
-    "enabled": true,
-    "sortOrder": 3,
-    "pageId": null,
-    "page": null,
-    "children": []
-  }
-]

package/generators/micro-react/templates/apps/layout/src/common/constants.ts

@@ -1,38 +0,0 @@
-/**
- * 应用常量定义
- */
-
-/**
- * 路由路径常量
- */
-export const ROUTES = {
-  /** 登录页 */
-  LOGIN: '/user/login',
-  /** 注册页 */
-  REGISTER: '/user/register',
-  /** 注册结果页 */
-  REGISTER_RESULT: '/user/register-result',
-  /** 无需认证的路由列表 */
-  NO_AUTH_ROUTES: ['/user/login', '/user/register', '/user/register-result'],
-} as const;
-
-/**
- * 主题相关常量
- */
-export const THEME = {
-  /** localStorage 存储键 */
-  STORAGE_KEY: '<%= projectName %>-theme',
-  /** 默认主题 */
-  DEFAULT: 'light' as const,
-  /** 可选主题值 */
-  VALUES: ['light', 'dark'] as const,
-} as const;
-
-/**
- * 存储键常量
- */
-export const STORAGE_KEYS = {
-  APP_INFO: 'appInfo',
-  IS_SUPERUSER: 'is_superuser',
-  GROUPS: 'groups',
-} as const;