@infly/vue2-vite 1.0.0

package/src/config/env.mjs

@@ -0,0 +1,148 @@
+/**
+ * 环境变量加载
+ *
+ * 从项目目录加载 .env 文件，仅白名单变量注入浏览器。
+ * 从 compat/env.js 迁移（95% 可复用）。
+ *
+ * 文件加载顺序（从低到高）：
+ *   .env → .env.local → .env.[mode] → .env.[mode].local
+ *
+ * 浏览器变量白名单：
+ *   VUE_APP_*, NODE_ENV, ENV, BASE_URL
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 简易 .env 文件解析器（不依赖 dotenv）
+ * 支持：KEY=VALUE, KEY="VALUE", KEY='VALUE', 注释行 #
+ *
+ * @param {string} filePath
+ * @returns {Record<string, string>}
+ */
+export function parseEnvFile(filePath) {
+  if (!fs.existsSync(filePath)) return {};
+
+  const content = fs.readFileSync(filePath, 'utf8');
+  const result = {};
+
+  for (const rawLine of content.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith('#')) continue;
+
+    const eqIndex = line.indexOf('=');
+    if (eqIndex === -1) continue;
+
+    const key = line.slice(0, eqIndex).trim();
+    let value = line.slice(eqIndex + 1).trim();
+
+    // 去除引号
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1);
+    }
+
+    result[key] = value;
+  }
+
+  return result;
+}
+
+/**
+ * 按优先级合并多个 .env 文件
+ *
+ * @param {string} projectRoot - 项目根目录
+ * @param {string} mode - 构建模式
+ * @returns {Record<string, string>}
+ */
+export function loadEnvFiles(projectRoot, mode) {
+  const baseEnv = parseEnvFile(path.join(projectRoot, '.env'));
+  const localEnv = parseEnvFile(path.join(projectRoot, '.env.local'));
+  const modeEnv = parseEnvFile(path.join(projectRoot, `.env.${mode}`));
+  const modeLocalEnv = parseEnvFile(path.join(projectRoot, `.env.${mode}.local`));
+
+  return { ...baseEnv, ...localEnv, ...modeEnv, ...modeLocalEnv };
+}
+
+const VUE_APP_PREFIX = 'VUE_APP_';
+
+/**
+ * production-like mode 集合
+ */
+const PRODUCTION_LIKE_MODES = new Set([
+  'production', 'prod', 'staging', 'stage', 'release',
+]);
+
+/**
+ * 生成 Vite define 配置
+ *
+ * 映射规则：
+ * - 所有 VUE_APP_* → process.env.VUE_APP_*
+ * - NODE_ENV → process.env.NODE_ENV（production-like mode 时为 "production"）
+ * - ENV → process.env.ENV
+ * - VUE_APP_PLATFORM → process.env.VUE_APP_PLATFORM（target 优先）
+ *
+ * @param {object} options
+ * @param {string} options.projectRoot - 项目根目录
+ * @param {string} options.mode - 构建模式
+ * @param {string} [options.target] - CLI 或环境变量指定的 target
+ * @param {string} [options.defaultTarget] - 默认 target
+ * @returns {{ define: Record<string, string>, target: string, envVars: Record<string, string> }}
+ */
+export function buildDefine(options = {}) {
+  const {
+    projectRoot,
+    mode = 'development',
+    target,
+    defaultTarget = 'DEFAULT',
+    base = '/',
+  } = options;
+  const envVars = loadEnvFiles(projectRoot, mode);
+
+  const define = {};
+
+  // 白名单注入 VUE_APP_* 变量
+  for (const [key, value] of Object.entries(envVars)) {
+    if (key.startsWith(VUE_APP_PREFIX)) {
+      define[`process.env.${key}`] = JSON.stringify(value);
+    }
+  }
+
+  // 标准变量
+  define['process.env.NODE_ENV'] = JSON.stringify(
+    PRODUCTION_LIKE_MODES.has(mode) ? 'production' : 'development'
+  );
+  define['process.env.ENV'] = JSON.stringify(envVars.ENV || mode);
+  define['process.env.BASE_URL'] = JSON.stringify(base);
+
+  // VUE_APP_PLATFORM（target）优先级：CLI > 环境变量 > 默认值
+  const resolvedTarget = target ||
+    process.env.VUE_APP_PLATFORM ||
+    envVars.VUE_APP_PLATFORM ||
+    defaultTarget;
+  define['process.env.VUE_APP_PLATFORM'] = JSON.stringify(resolvedTarget);
+
+  // 确保 VUE_APP_BASE_API 存在（mock 服务器需要）
+  if (!define['process.env.VUE_APP_BASE_API']) {
+    define['process.env.VUE_APP_BASE_API'] = JSON.stringify(envVars.VUE_APP_BASE_API || '');
+  }
+
+  return { define, target: resolvedTarget, envVars };
+}
+
+/**
+ * 获取解析后的 target 值（不生成 define）
+ *
+ * @param {object} options
+ * @returns {string}
+ */
+export function resolveTarget(options = {}) {
+  const { projectRoot, mode = 'development', target, defaultTarget = 'DEFAULT' } = options;
+  const envVars = loadEnvFiles(projectRoot, mode);
+
+  return target ||
+    process.env.VUE_APP_PLATFORM ||
+    envVars.VUE_APP_PLATFORM ||
+    defaultTarget;
+}

package/src/config/merge.mjs

@@ -0,0 +1,65 @@
+/**
+ * 深度合并工具
+ *
+ * 将多个配置源按优先级合并。规则：
+ * - undefined 值不覆盖已定义值
+ * - 对象深度合并（不替换）
+ * - 数组替换（不拼接）
+ * - null 显式清空
+ */
+
+/**
+ * 深度合并多个配置对象。后面的覆盖前面的。
+ *
+ * @param {...object} sources - 从低到高优先级的配置源
+ * @returns {object}
+ */
+export function deepMerge(...sources) {
+  const target = {};
+
+  for (const source of sources) {
+    if (!source || typeof source !== 'object') continue;
+    mergeInto(target, source);
+  }
+
+  return target;
+}
+
+/**
+ * 将 source 合并到 target（修改 target）
+ */
+function mergeInto(target, source) {
+  for (const key of Object.keys(source)) {
+    const sourceValue = source[key];
+    const targetValue = target[key];
+
+    // null 显式清空
+    if (sourceValue === null) {
+      target[key] = null;
+      continue;
+    }
+
+    // undefined → 跳过
+    if (sourceValue === undefined) {
+      continue;
+    }
+
+    // 双方都是普通对象 → 深度合并
+    if (isPlainObject(targetValue) && isPlainObject(sourceValue)) {
+      target[key] = mergeInto({ ...targetValue }, sourceValue);
+      continue;
+    }
+
+    // 否则直接替换（包括数组）
+    target[key] = sourceValue;
+  }
+
+  return target;
+}
+
+/**
+ * 检查值是否为普通对象（非数组、非 null）
+ */
+function isPlainObject(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/src/config/project-config.mjs

@@ -0,0 +1,87 @@
+/**
+ * 归一化项目配置 schema
+ *
+ * 所有配置来源（vue.config.js、package.json inflyVite、infly.vite.config.js、CLI 参数）
+ * 合并为统一的配置对象。此模块定义默认值和 schema。
+ */
+
+/**
+ * 创建默认配置（包层级安全默认值）
+ *
+ * @param {object} context - { command, mode, target, projectRoot, isBuild, isServe }
+ * @returns {object} 默认配置
+ */
+export function createDefaultConfig(context) {
+  const { command, mode, target, projectRoot, isBuild, isServe } = context;
+
+  return {
+    // 构建输出
+    outputDir: null,          // 必须由 vue.config.js 或 infly.vite.config.js 提供
+    mainEntry: 'src/main.js',
+    htmlTemplate: 'public/index.html',
+    assetsDir: 'static',
+    base: '/',
+    productionSourceMap: false,
+
+    // 开发服务器
+    server: {
+      port: null,             // 从 vue.config.js devServer.port 或配置提供
+      // 单项目直接启动默认开放局域网访问；注册表启动仍可显式覆盖为 localhost。
+      host: '0.0.0.0',
+      proxy: {},
+      open: false,
+      strictPort: false,
+    },
+
+    // HTML
+    html: {
+      title: undefined,
+      favicon: 'favicon.ico',
+    },
+
+    // CSS / Sass
+    css: {
+      additionalData: '',
+      preprocessorOptions: {},
+      devSourcemap: true,
+    },
+
+    // 模块解析
+    resolve: {
+      alias: {},
+    },
+
+    // Mock
+    mock: {
+      enabled: false,
+      entry: 'mock/mock-server.js',
+    },
+
+    // 构建策略
+    strictCompatibility: false,
+
+    // 从 vue.config.js 推断的兼容性字段
+    vueConfig: {
+      configureWebpack: null,   // null=不存在, object=普通对象, 'function'=函数形式
+      chainWebpack: false,
+      transpileDependencies: [],
+    },
+
+    // 上下文（传给 infly.vite.config.js 函数）
+    context: {
+      command,
+      mode,
+      target,
+      projectRoot,
+      isBuild,
+      isServe,
+    },
+  };
+}
+
+/**
+ * 检查配置对象是否包含有效输出目录
+ */
+export function hasOutputDir(config) {
+  return config.outputDir !== null && typeof config.outputDir === 'string' && config.outputDir.length > 0;
+}

package/src/config/registered.mjs

@@ -0,0 +1,152 @@
+import path from 'node:path';
+
+import { createViteConfig } from '../factory/create-vite-config.mjs';
+import { loadEnvFiles } from './env.mjs';
+
+function resolveTarget(app, requestedTarget) {
+  const target = requestedTarget || app.defaultTarget;
+  const targetConfig = app.targets?.[target];
+  if (!targetConfig) {
+    throw new Error(
+      `应用 "${app.id}" 不存在 target "${target}"；可用值: ${Object.keys(app.targets || {}).join(', ')}`,
+    );
+  }
+  return { target, targetConfig };
+}
+
+function resolveOutputDir(app, targetConfig, rootDir) {
+  if (!app.outputRoot || !targetConfig.outputDir) {
+    throw new Error(`${app.id} 缺少登记的输出目录`);
+  }
+
+  const outputRoot = path.resolve(rootDir, app.outputRoot);
+  const outputDir = path.resolve(rootDir, targetConfig.outputDir);
+  const relative = path.relative(outputRoot, outputDir);
+  if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) {
+    throw new Error(`拒绝不安全的输出目录: ${outputDir}`);
+  }
+
+  const registered = Object.values(app.targets || {}).some(
+    (entry) => path.resolve(rootDir, entry.outputDir) === outputDir,
+  );
+  if (!registered) {
+    throw new Error(`输出目录未登记: ${outputDir}`);
+  }
+  return outputDir;
+}
+
+function createProxy(proxy = {}, envVars = {}) {
+  const dynamic = proxy.__dynamic;
+  if (dynamic) {
+    if (typeof dynamic !== 'object' || !dynamic.prefixEnv || !dynamic.target) {
+      throw new Error('动态代理缺少 prefixEnv 或 target 配置');
+    }
+    const prefix = envVars[dynamic.prefixEnv];
+    if (!prefix) return {};
+    const escaped = prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const entry = { ...dynamic };
+    delete entry.prefixEnv;
+    return {
+      [prefix]: {
+        ...entry,
+        rewrite: (requestPath) => requestPath.replace(new RegExp(`^${escaped}`), ''),
+      },
+    };
+  }
+
+  return Object.fromEntries(Object.entries(proxy).map(([prefix, rawEntry]) => {
+    const entry = { ...rawEntry };
+    if (entry.pathRewrite) {
+      const pathRewrite = { ...entry.pathRewrite };
+      entry.rewrite = (requestPath) => Object.entries(pathRewrite).reduce(
+        (result, [pattern, replacement]) => result.replace(new RegExp(pattern), replacement),
+        requestPath,
+      );
+      delete entry.pathRewrite;
+    }
+    return [prefix, entry];
+  }));
+}
+
+function createAliases(aliases = {}, rootDir) {
+  return Object.fromEntries(
+    Object.entries(aliases).map(([name, replacement]) => [
+      name,
+      path.resolve(rootDir, replacement),
+    ]),
+  );
+}
+
+export function createRegisteredConfig(app, options = {}) {
+  const rootDir = path.resolve(options.rootDir || process.cwd());
+  const command = options.command || 'build';
+  const mode = options.mode || (command === 'serve' ? 'development' : 'production');
+  const { target, targetConfig } = resolveTarget(app, options.target);
+  const projectRoot = path.resolve(rootDir, app.subProjectPath);
+  const envVars = loadEnvFiles(projectRoot, mode);
+  const theme = options.theme || targetConfig.theme || 'default';
+  const additionalData = app.css?.additionalData
+    ? app.css.additionalData.replace(/\$\{theme\}/g, theme)
+    : '';
+
+  return {
+    outputDir: resolveOutputDir(app, targetConfig, rootDir),
+    mainEntry: app.mainEntry || 'src/main.js',
+    htmlTemplate: app.htmlTemplate || 'public/index.html',
+    assetsDir: 'static',
+    base: targetConfig.base || app.base || '/',
+    productionSourceMap: app.productionSourceMap ?? false,
+    server: {
+      port: options.port || targetConfig.port || app.defaultPort || 3000,
+      host: options.host || 'localhost',
+      proxy: createProxy(app.proxy, envVars),
+      open: options.open || false,
+      strictPort: options.strictPort || false,
+    },
+    html: {
+      title: targetConfig.title || app.title || app.id,
+      favicon: targetConfig.favicon || app.favicon?.path || 'favicon.ico',
+    },
+    css: {
+      additionalData,
+      preprocessorOptions: {},
+      devSourcemap: true,
+      sassModern: app.css?.sassModern === true,
+    },
+    resolve: {
+      alias: createAliases(app.aliases, rootDir),
+    },
+    compat: {
+      emptyModuleStubs: (app.compat?.emptyModuleStubs || []).map((entry) => ({
+        id: path.resolve(projectRoot, entry.path),
+        exports: entry.exports || [],
+      })),
+    },
+    mock: {
+      enabled: command === 'serve' && app.mock !== false,
+      entry: 'mock/mock-server.js',
+    },
+    build: {
+      rollupOptions: {
+        external: app.external || [],
+      },
+    },
+    strictCompatibility: false,
+    workspace: {
+      rootDir,
+      appSourcePaths: options.appSourcePaths || [app.subProjectPath],
+    },
+    context: {
+      command,
+      mode,
+      target,
+      projectRoot,
+      isBuild: command === 'build',
+      isServe: command === 'serve',
+    },
+  };
+}
+
+export function createRegisteredViteConfig(app, options = {}) {
+  return createViteConfig(createRegisteredConfig(app, options));
+}

package/src/config/validation.mjs

@@ -0,0 +1,122 @@
+/**
+ * 严格兼容模式验证
+ *
+ * 规范 §9.5：strictCompatibility 为 true 时必须检测并失败：
+ * 1. 存在未确认的 chainWebpack
+ * 2. configureWebpack 是函数
+ * 3. outputDir 无法确定
+ * 4. main entry 或 HTML 模板不存在
+ * 5. 多个项目配置文件同时存在
+ * 6. target 不在显式 targets 中
+ * 7. Vite 输出目录等于项目根目录、磁盘根目录或用户主目录
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+/**
+ * 执行严格兼容检查
+ *
+ * @param {object} config - 归一化后的完整配置
+ * @param {object} options - { hasChainWebpack, hasFunctionConfigureWebpack, projectRoot, targets }
+ * @returns {{ valid: boolean, errors: string[] }}
+ */
+export function validateStrictCompatibility(config, options = {}) {
+  const errors = [];
+
+  // 1. chainWebpack 存在
+  if (options.hasChainWebpack) {
+    errors.push(
+      '项目使用了 chainWebpack，无法自动转换为 Vite 配置。' +
+      '请在 infly.vite.config.js 中显式提供等价的 Vite 配置，或关闭严格兼容模式。'
+    );
+  }
+
+  // 2. configureWebpack 是函数
+  if (options.hasFunctionConfigureWebpack) {
+    errors.push(
+      'configureWebpack 是函数形式，无法自动转换为 Vite 配置。' +
+      '请在 infly.vite.config.js 中显式提供等价的 Vite 配置，或关闭严格兼容模式。'
+    );
+  }
+
+  // 3. outputDir 无法确定
+  if (!config.outputDir || typeof config.outputDir !== 'string') {
+    errors.push(
+      '无法确定 outputDir。请在 vue.config.js 中设置 outputDir，' +
+      '或在 infly.vite.config.js 中显式提供。'
+    );
+  }
+
+  // 4. main entry 或 HTML 模板不存在
+  if (options.projectRoot) {
+    const mainEntry = path.resolve(options.projectRoot, config.mainEntry || 'src/main.js');
+    if (!fs.existsSync(mainEntry)) {
+      errors.push(`入口文件不存在: ${mainEntry}`);
+    }
+
+    const htmlTemplate = path.resolve(options.projectRoot, config.htmlTemplate || 'public/index.html');
+    if (!fs.existsSync(htmlTemplate)) {
+      errors.push(`HTML 模板不存在: ${htmlTemplate}`);
+    }
+  }
+
+  // 5. 多个项目配置文件（在 discover 阶段检测）
+
+  // 6. target 验证 - target 在配置中应该存在
+  if (options.targets && config.context && config.context.target) {
+    const target = config.context.target;
+    if (!options.targets.includes(target)) {
+      errors.push(
+        `未知 target "${target}"。可用值: ${options.targets.join(', ')}`
+      );
+    }
+  }
+
+  // 7. outputDir 安全检查
+  if (config.outputDir && options.projectRoot) {
+    const outDir = path.resolve(options.projectRoot, config.outputDir);
+    const projectRoot = path.resolve(options.projectRoot);
+    const rootDir = path.parse(projectRoot).root;
+
+    if (outDir === projectRoot) {
+      errors.push(`输出目录不能等于项目根目录: ${outDir}`);
+    }
+    if (outDir === rootDir || outDir === rootDir.slice(0, -1)) {
+      errors.push(`输出目录不能为磁盘根目录: ${outDir}`);
+    }
+    if (outDir === os.homedir()) {
+      errors.push(`输出目录不能为用户主目录: ${outDir}`);
+    }
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors,
+  };
+}
+
+/**
+ * 非严格模式诊断（仅产生警告，不失败）
+ *
+ * @param {object} config
+ * @param {object} options
+ * @returns {string[]}
+ */
+export function diagnoseCompatIssues(config, options = {}) {
+  const warnings = [];
+
+  // chainWebpack 不再产生非严格模式诊断：其行为已由内置默认能力覆盖，
+  // 仅严格兼容模式（validateStrictCompatibility）继续校验失败。
+
+  if (options.hasFunctionConfigureWebpack) {
+    warnings.push('[诊断] configureWebpack 是函数形式：纯 JavaScript 配置无法可靠映射为 Vite。请显式提供 Vite 插件或配置。');
+  }
+
+  if (!config.outputDir) {
+    warnings.push('[诊断] outputDir 未设置；将输出到默认 dist 目录。');
+  }
+
+  return warnings;
+}