generator-mico-cli 0.2.32 → 0.2.34

package/lib/utils.js

@@ -4,6 +4,7 @@ const fs = require('node:fs');
 const path = require('node:path');
 const { exec, execSync, execFileSync, execFile } = require('node:child_process');
 const os = require('node:os');
+const semver = require('semver');
 
 /**
  * 转换为 kebab-case
@@ -150,6 +151,9 @@ const VALID_PACKAGE_NAME_RE = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/
 /** scope 包含 mico 时使用的 registry（如 @mico-platform/*） */
 const MICO_NPM_REGISTRY = 'https://nexus-vywrajy.micoworld.net/repository/mico-base-common/';
 
+/** 生成器模板中由 micoPackages 管理的包名 */
+const MICO_TEMPLATE_PACKAGES = ['@mico-platform/ui', '@mico-platform/theme'];
+
 /**
  * 根据包名 scope 选择 registry：scope 包含 mico 时用 MICO_NPM_REGISTRY，否则用 npm 默认
  * @param {string} packageName - 包名，如 '@mico-platform/ui'
@@ -161,6 +165,27 @@ function getRegistryForPackage(packageName) {
   return scope.toLowerCase().includes('mico') ? MICO_NPM_REGISTRY : undefined;
 }
 
+/**
+ * 读取版本覆盖（用于测试/验证场景锁定版本，跳过 npm view）
+ * 通过环境变量 MICO_PKG_VERSIONS（JSON 映射，如 {"@mico-platform/ui":"0.0.25"}）指定
+ * @param {string} packageName - 包名，如 '@mico-platform/ui'
+ * @returns {string|undefined} 命中且为合法版本号时返回，否则 undefined
+ */
+function getVersionOverride(packageName) {
+  const raw = process.env.MICO_PKG_VERSIONS;
+  if (!raw) return undefined;
+  try {
+    const map = JSON.parse(raw);
+    const v = map && map[packageName];
+    if (typeof v === 'string' && /^\d+\.\d+\.\d+/.test(v.trim())) {
+      return v.trim();
+    }
+  } catch {
+    // 解析失败时忽略覆盖，回退到正常获取流程
+  }
+  return undefined;
+}
+
 /**
  * 从 npm registry 获取包的最新版本号（同步版本）
  * registry 根据 packageName 的 scope 自动选择：scope 包含 mico 时用 MICO_NPM_REGISTRY，否则用默认
@@ -174,6 +199,8 @@ function getLatestNpmVersion(packageName, fallback = '1.0.0', timeoutMs = 8000,
   if (!VALID_PACKAGE_NAME_RE.test(packageName)) {
     return fallback;
   }
+  const override = getVersionOverride(packageName);
+  if (override) return override;
   const registry = getRegistryForPackage(packageName);
   const args = ['view', packageName, 'version'];
   if (registry) args.push(`--registry=${registry}`);
@@ -203,6 +230,8 @@ function getLatestNpmVersionAsync(packageName, fallback = '1.0.0', timeoutMs = 8
   if (!VALID_PACKAGE_NAME_RE.test(packageName)) {
     return Promise.resolve(fallback);
   }
+  const override = getVersionOverride(packageName);
+  if (override) return Promise.resolve(override);
   return new Promise((resolve) => {
     let settled = false;
     const done = (value) => {
@@ -262,6 +291,195 @@ async function getPackageVersionsParallel(packages, timeoutMs = 8000, cwd) {
   }, {});
 }
 
+/**
+ * 读取 CLI package.json 中的 micoPackages（组件库版本 range 唯一维护点）
+ * @param {string} [cliRoot] - CLI 仓库根目录，默认 lib/ 的上级
+ * @returns {Record<string, string>} 包名 → semver range
+ */
+function loadMicoPackages(cliRoot) {
+  const root = cliRoot || path.resolve(__dirname, '..');
+  const pkgPath = path.join(root, 'package.json');
+  if (!fs.existsSync(pkgPath)) {
+    throw new Error(`CLI package.json not found: ${pkgPath}`);
+  }
+
+  let pkg;
+  try {
+    pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+  } catch (e) {
+    throw new Error(`Failed to parse CLI package.json: ${e.message}`);
+  }
+
+  const { micoPackages } = pkg;
+  if (!micoPackages || typeof micoPackages !== 'object') {
+    throw new Error(
+      'CLI package.json must define "micoPackages" with @mico-platform/ui and @mico-platform/theme ranges',
+    );
+  }
+
+  const result = {};
+  for (const name of MICO_TEMPLATE_PACKAGES) {
+    const range = micoPackages[name];
+    if (typeof range !== 'string' || !range.trim()) {
+      throw new Error(`micoPackages.${name} must be a non-empty semver range string`);
+    }
+    const trimmed = range.trim();
+    if (!semver.validRange(trimmed)) {
+      throw new Error(`micoPackages.${name} is not a valid semver range: ${range}`);
+    }
+    result[name] = trimmed;
+  }
+
+  return result;
+}
+
+/**
+ * 执行 npm view <pkg>@<spec> version
+ * @returns {Promise<string|undefined>}
+ */
+function npmViewVersionAsync(packageName, spec, timeoutMs = 8000, cwd) {
+  if (!VALID_PACKAGE_NAME_RE.test(packageName)) {
+    return Promise.resolve(undefined);
+  }
+
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (value) => {
+      if (!settled) {
+        settled = true;
+        resolve(value);
+      }
+    };
+
+    const registry = getRegistryForPackage(packageName);
+    const args = ['view', `${packageName}@${spec}`, 'version'];
+    if (registry) args.push(`--registry=${registry}`);
+
+    const child = execFile(
+      'npm',
+      args,
+      {
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+        ...(cwd && { cwd }),
+      },
+      (error, stdout) => {
+        if (error) {
+          done(undefined);
+          return;
+        }
+        const v = stdout.trim();
+        done(v && semver.valid(v) ? v : undefined);
+      },
+    );
+
+    setTimeout(() => {
+      child.kill();
+      done(undefined);
+    }, timeoutMs + 100);
+  });
+}
+
+/**
+ * 执行 npm view <pkg> versions --json
+ * @returns {Promise<string[]>}
+ */
+function npmViewAllVersionsAsync(packageName, timeoutMs = 8000, cwd) {
+  if (!VALID_PACKAGE_NAME_RE.test(packageName)) {
+    return Promise.resolve([]);
+  }
+
+  return new Promise((resolve) => {
+    let settled = false;
+    const done = (value) => {
+      if (!settled) {
+        settled = true;
+        resolve(value);
+      }
+    };
+
+    const registry = getRegistryForPackage(packageName);
+    const args = ['view', packageName, 'versions', '--json'];
+    if (registry) args.push(`--registry=${registry}`);
+
+    const child = execFile(
+      'npm',
+      args,
+      {
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+        ...(cwd && { cwd }),
+      },
+      (error, stdout) => {
+        if (error) {
+          done([]);
+          return;
+        }
+        try {
+          const list = JSON.parse(stdout.trim());
+          done(Array.isArray(list) ? list.filter((v) => semver.valid(v)) : []);
+        } catch {
+          done([]);
+        }
+      },
+    );
+
+    setTimeout(() => {
+      child.kill();
+      done([]);
+    }, timeoutMs + 100);
+  });
+}
+
+/**
+ * 在 semver range 内解析包的最新精确版本（用于 CDN / micoUiVersionExact）
+ * MICO_PKG_VERSIONS 可覆盖 resolved，但仍须满足 range
+ * @param {string} packageName
+ * @param {string} range - semver range，如 0.x
+ * @param {number} [timeoutMs=8000]
+ * @param {string} [cwd]
+ * @returns {Promise<string>}
+ */
+async function resolveNpmVersionInRangeAsync(packageName, range, timeoutMs = 8000, cwd) {
+  const override = getVersionOverride(packageName);
+  if (override) {
+    if (!semver.satisfies(override, range, { includePrerelease: true })) {
+      throw new Error(
+        `MICO_PKG_VERSIONS override ${override} does not satisfy range ${range} for ${packageName}`,
+      );
+    }
+    return override;
+  }
+
+  const direct = await npmViewVersionAsync(packageName, range, timeoutMs, cwd);
+  if (direct) return direct;
+
+  const versions = await npmViewAllVersionsAsync(packageName, timeoutMs, cwd);
+  const resolved = semver.maxSatisfying(versions, range, { includePrerelease: false });
+  if (resolved) return resolved;
+
+  throw new Error(`No version found for ${packageName} satisfying range ${range}`);
+}
+
+/**
+ * 读取 micoPackages range，并解析各包在 range 内的最新精确版本
+ * @param {string} cliRoot - CLI 仓库根目录
+ * @param {number} [timeoutMs=8000]
+ * @returns {Promise<Record<string, { range: string, resolved: string }>>}
+ */
+async function getMicoTemplateVersions(cliRoot, timeoutMs = 8000) {
+  const micoPackages = loadMicoPackages(cliRoot);
+  const entries = await Promise.all(
+    MICO_TEMPLATE_PACKAGES.map(async (name) => {
+      const range = micoPackages[name];
+      const resolved = await resolveNpmVersionInRangeAsync(name, range, timeoutMs, cliRoot);
+      return [name, { range, resolved }];
+    }),
+  );
+
+  return Object.fromEntries(entries);
+}
+
 // ============ 配置文件支持 ============
 
 /**
@@ -478,6 +696,10 @@ module.exports = {
   getLatestNpmVersion,
   getLatestNpmVersionAsync,
   getPackageVersionsParallel,
+  MICO_TEMPLATE_PACKAGES,
+  loadMicoPackages,
+  resolveNpmVersionInRangeAsync,
+  getMicoTemplateVersions,
   setupErrorHandlers,
   TEMPLATE_EXTENSIONS,
   // 配置文件

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.2.32",
+  "version": "0.2.34",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": [
     "yeoman-generator",
@@ -35,6 +35,10 @@
   "engines": {
     "node": ">=18"
   },
+  "micoPackages": {
+    "@mico-platform/ui": "0.x",
+    "@mico-platform/theme": "0.x"
+  },
   "dependencies": {
     "semver": "^7.6.3",
     "update-notifier": "^7.3.1",