@infly/vue2-vite 1.0.0

package/src/compat/require-context.mjs

@@ -0,0 +1,157 @@
+/**
+ * require.context → import.meta.glob 转换
+ *
+ * 将 Webpack 的静态 require.context() 调用转换为 Vite 的 import.meta.glob。
+ * 动态调用（变量路径/正则）直接报错。
+ *
+ * 从 compat/glob.js 迁移（80% 可复用）。
+ */
+
+import path from 'node:path';
+
+/**
+ * require.context 匹配正则
+ */
+const REQUIRE_CONTEXT_PATTERN =
+  /const\s+(\w+)\s*=\s*require\.context\(\s*(['"])([^'"]+)\2\s*,\s*(true|false)\s*,\s*(\/.+?\/[gimsuy]*)\s*\)/g;
+
+/**
+ * 生成 import.meta.glob 的等价代码
+ */
+export function generateGlobReplacement(varName, dir, recursive, regexStr) {
+  const globPattern = regexToGlob(regexStr, recursive);
+  const actualPattern = recursive ? globPattern : globPattern.replace('**/', '');
+
+  const hasExcludeIndex = regexStr.includes('?!index');
+  const contextPrefix = `${dir.replace(/\/$/, '')}/`;
+  const quotedContextPrefix = JSON.stringify(contextPrefix);
+
+  const lines = [
+    `const __${varName}RawModules = import.meta.glob('${dir}/${actualPattern}', { eager: true });`,
+    `const __${varName}Modules = {};`,
+    `for (const [key, value] of Object.entries(__${varName}RawModules)) {`,
+    `  const normalizedKey = key.startsWith(${quotedContextPrefix}) ? './' + key.slice(${quotedContextPrefix}.length) : key;`,
+    `  __${varName}Modules[normalizedKey] = value;`,
+    '}',
+  ];
+
+  if (hasExcludeIndex) {
+    lines.push(
+      `const __${varName}Filtered = {};`,
+      `for (const [k, v] of Object.entries(__${varName}Modules)) {`,
+      `  if (!k.endsWith('/index.js') && !k.endsWith('\\\\index.js')) {`,
+      `    __${varName}Filtered[k] = v;`,
+      '  }',
+      '}',
+      `function ${varName}(key) { return __${varName}Filtered[key]; }`,
+      `${varName}.keys = () => Object.keys(__${varName}Filtered);`,
+    );
+  } else {
+    lines.push(
+      `function ${varName}(key) { return __${varName}Modules[key]; }`,
+      `${varName}.keys = () => Object.keys(__${varName}Modules);`,
+    );
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * 将 JS 正则转换为 glob 模式
+ */
+function regexToGlob(regexStr, recursive) {
+  const inner = regexStr.replace(/^\/(.*)\/[gimsuy]*$/, '$1');
+
+  const simpleExt = inner.match(/^\\\.(\w+)\$/);
+  if (simpleExt) return `*.${simpleExt[1]}`;
+
+  let glob = inner.replace(/\\\.\\\//g, '');
+  glob = glob.replace(/\.\+/g, '*').replace(/\.\*/g, '*');
+  glob = glob.replace(/\^/g, '').replace(/\$/g, '');
+  glob = glob.replace(/[()\[\]{}]/g, '');
+
+  const extMatch = glob.match(/\*\\\.(\w+)/);
+  if (extMatch) return `*.${extMatch[1]}`;
+
+  glob = glob.replace(/\\\\/g, '\\');
+  return recursive ? `**/*${glob}` : `*${glob}`;
+}
+
+/**
+ * 创建 require.context → import.meta.glob 兼容插件
+ *
+ * @param {string} projectRoot - 项目根目录
+ * @param {string[]} [appSourcePaths] - 工作区内所有应用的源码路径，用于跨应用源码转换
+ * @param {string[]} [aliasedSourcePaths] - 显式源码别名指向的目录
+ * @returns {import('vite').Plugin}
+ */
+export function requireContextPlugin(projectRoot, appSourcePaths = [], aliasedSourcePaths = []) {
+  const srcDir = path.resolve(projectRoot, 'src').replace(/\\/g, '/');
+  const allowedDirs = [...new Set([
+    srcDir,
+    ...appSourcePaths.map((p) => path.resolve(p, 'src').replace(/\\/g, '/')),
+    ...aliasedSourcePaths.map((p) => path.resolve(p).replace(/\\/g, '/')),
+  ])];
+
+  return {
+    name: 'infly-vue2:require-context',
+    enforce: 'pre',
+
+    transform(code, id) {
+      const cleanId = id.replace(/[?#].*$/, '');
+      const nid = cleanId.replace(/\\/g, '/');
+
+      if (!cleanId.endsWith('.js')) return null;
+      if (!allowedDirs.some((dir) => nid.startsWith(dir))) return null;
+
+      const codeWithoutComments = code
+        .replace(/\/\*[\s\S]*?\*\//g, (comment) => comment.replace(/[^\r\n]/g, ' '))
+        .replace(/(^|[^:])\/\/.*$/gm, '$1');
+
+      if (!codeWithoutComments.includes('require.context')) {
+        return null;
+      }
+
+      const errors = [];
+      let transformed = code;
+      let hasMatch = false;
+
+      REQUIRE_CONTEXT_PATTERN.lastIndex = 0;
+
+      transformed = transformed.replace(
+        REQUIRE_CONTEXT_PATTERN,
+        (match, varName, quote, dir, recursive, regexStr) => {
+          hasMatch = true;
+          return generateGlobReplacement(varName, dir, recursive === 'true', regexStr);
+        }
+      );
+
+      if (!hasMatch && codeWithoutComments.includes('require.context')) {
+        const lines = codeWithoutComments.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+          if (lines[i].includes('require.context')) {
+            const testPattern =
+              /require\.context\(\s*(['"])([^'"]+)\2\s*,\s*(true|false)\s*,\s*(\/.+?\/[gimsuy]*)\s*\)/;
+            if (!testPattern.test(lines[i])) {
+              errors.push(
+                `动态或无法识别的 require.context 调用在第 ${i + 1} 行：\n` +
+                `  ${lines[i].trim()}\n` +
+                '  Vite 兼容层仅支持静态 require.context(dir, recursive, regex) 模式。'
+              );
+            }
+          }
+        }
+      }
+
+      if (errors.length > 0) {
+        this.error(errors.join('\n\n'));
+      }
+
+      if (hasMatch) {
+        return { code: transformed, map: null };
+      }
+
+      return null;
+    },
+  };
+}

package/src/compat/router.mjs

@@ -0,0 +1,62 @@
+/**
+ * Vue Router 3.x Promise 兼容
+ *
+ * Vite 提供的 vue-router 3.0.x 中 push/replace 方法只支持回调、不返回 Promise。
+ * 此插件在 transpile 阶段为目标文件注入 Promise 包装。
+ *
+ * 从 compat/router.js 迁移（95% 可复用）。
+ */
+
+const NAVIGATION_METHODS = ['push', 'replace'];
+
+/**
+ * 为 VueRouter.prototype.push 和 replace 注入 Promise 支持
+ *
+ * @param {string} source - 源文件内容
+ * @returns {{ code: string, map: null } | null}
+ */
+function transformVueRouterPromiseNavigation(source) {
+  let code = source;
+  let converted = 0;
+
+  for (const method of NAVIGATION_METHODS) {
+    const pattern = new RegExp(
+      `VueRouter\\.prototype\\.${method} = function ${method} \\(location, onComplete, onAbort\\) \\{\\s*` +
+      `this\\.history\\.${method}\\(location, onComplete, onAbort\\);?\\s*\\};`
+    );
+    code = code.replace(pattern, () => {
+      converted++;
+      return [
+        `VueRouter.prototype.${method} = function ${method} (location, onComplete, onAbort) {`,
+        `  if (!onComplete && !onAbort && typeof Promise !== 'undefined') {`,
+        `    return new Promise((resolve, reject) => {`,
+        `      this.history.${method}(location, resolve, reject);`,
+        '    });',
+        '  }',
+        `  this.history.${method}(location, onComplete, onAbort);`,
+        '};',
+      ].join('\n');
+    });
+  }
+
+  return converted > 0 ? { code, map: null } : null;
+}
+
+/**
+ * 创建 Vue Router Promise 兼容 Vite 插件
+ *
+ * @returns {import('vite').Plugin}
+ */
+export function vueRouterPromisePlugin() {
+  return {
+    name: 'infly-vue2:vue-router-promise',
+    enforce: 'pre',
+    transform(code, id) {
+      const normalizedId = id.replace(/\\/g, '/').replace(/[?#].*$/, '');
+      if (!normalizedId.endsWith('/node_modules/vue-router/dist/vue-router.esm.js')) {
+        return null;
+      }
+      return transformVueRouterPromiseNavigation(code);
+    },
+  };
+}

package/src/compat/sass-export.mjs

@@ -0,0 +1,112 @@
+/**
+ * Sass :export 兼容插件
+ *
+ * 将 `import styles from "./file.scss"` 转换为 SCSS 导入 + 导出变量的 JS 对象。
+ * 从 @infly/libs/adapters/vue2/vite/index.js 迁移（95% 可复用）。
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * 解析应用内的 SCSS 导入路径
+ */
+function resolveAppScssImport(importPath, importer, projectRoot) {
+  const cleanImporter = importer.replace(/[?#].*$/, '');
+  if (importPath.startsWith('@/')) {
+    return path.resolve(projectRoot, 'src', importPath.slice(2));
+  }
+  if (importPath.startsWith('./') || importPath.startsWith('../')) {
+    return path.resolve(path.dirname(cleanImporter), importPath);
+  }
+  if (path.isAbsolute(importPath)) return path.resolve(importPath);
+  return null;
+}
+
+/**
+ * 转换 import varName from "./file.scss" → import "./file.scss"; const varName = {...}
+ *
+ * @param {string} code - 源文件内容
+ * @param {string} importer - 导入方文件路径
+ * @param {object} options - { projectRoot, readFile? }
+ * @returns {string} 转换后的代码
+ */
+export function transformScssExportImports(code, importer, options) {
+  const { projectRoot, readFile = (file) => fs.readFileSync(file, 'utf8') } = options;
+
+  return code.replace(
+    /import\s+([\w$]+)\s+from\s+(["'])([^"'?]+\.scss)\2\s*;?/g,
+    (statement, binding, quote, importPath) => {
+      const resolved = resolveAppScssImport(importPath, importer, projectRoot);
+      if (!resolved) return statement;
+
+      let scss;
+      try {
+        scss = readFile(resolved);
+      } catch (_) {
+        return statement;
+      }
+      if (typeof scss !== 'string') return statement;
+
+      const exportBlock = scss.match(/:export\s*\{([\s\S]*?)\}/);
+      if (!exportBlock) return statement;
+
+      const variables = new Map();
+      for (const match of scss.matchAll(/^\s*\$([\w-]+)\s*:\s*([^;]+);/gm)) {
+        variables.set(match[1], match[2].trim());
+      }
+
+      const exported = {};
+      for (const match of exportBlock[1].matchAll(/([\w-]+)\s*:\s*([^;]+);/g)) {
+        const rawValue = match[2].trim();
+        const variableName = rawValue.match(/^\$([\w-]+)$/);
+        exported[match[1]] = variableName && variables.has(variableName[1])
+          ? variables.get(variableName[1])
+          : rawValue;
+      }
+
+      return `import ${quote}${importPath}${quote};\nconst ${binding} = ${JSON.stringify(exported)};`;
+    },
+  );
+}
+
+/**
+ * 创建 SCSS :export 兼容 Vite 插件
+ *
+ * @param {string} projectRoot - 项目根目录
+ * @returns {import('vite').Plugin}
+ */
+export function createScssExportCompatPlugin(projectRoot) {
+  return {
+    name: 'infly-vue2:scss-export-compat',
+    enforce: 'pre',
+    transform(code, id) {
+      if (
+        id.includes('node_modules')
+        || (!id.includes('.vue') && !/\.[cm]?[jt]sx?(?:[?#].*)?$/.test(id))
+        || !/import\s+[\w$]+\s+from\s+["'][^"']+\.scss["']/.test(code)
+      ) return null;
+
+      const transformed = transformScssExportImports(code, id, { projectRoot });
+      return transformed === code ? null : { code: transformed, map: null };
+    },
+  };
+}
+
+/**
+ * 将项目根目录添加到 Sass loadPaths
+ *
+ * @param {object} css - Vite CSS 配置对象
+ * @param {string} projectRoot
+ * @returns {object}
+ */
+export function addAppRootSassLoadPath(css, projectRoot) {
+  if (!css.preprocessorOptions) css.preprocessorOptions = {};
+  if (!css.preprocessorOptions.scss) css.preprocessorOptions.scss = {};
+  const loadPaths = css.preprocessorOptions.scss.loadPaths || [];
+  const resolvedProjectRoot = path.resolve(projectRoot);
+  css.preprocessorOptions.scss.loadPaths = loadPaths.includes(resolvedProjectRoot)
+    ? loadPaths
+    : [...loadPaths, resolvedProjectRoot];
+  return css;
+}

package/src/compat/sass-importer.mjs

@@ -0,0 +1,30 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+/**
+ * 创建旧项目 Sass `~package/path` 导入兼容器。
+ *
+ * 工厂和临时 Vitest 配置共用同一实现，避免函数经过 JSON 序列化后丢失。
+ */
+export function createSassTildeImporter(projectRoot) {
+  const nodeModulesDir = path.resolve(projectRoot, 'node_modules');
+
+  return {
+    findFileUrl(url) {
+      if (!url.startsWith('~')) return null;
+      const base = url.substring(1);
+      for (const candidate of [
+        path.resolve(nodeModulesDir, base),
+        path.resolve(nodeModulesDir, base + '.scss'),
+        path.resolve(nodeModulesDir, base + '.css'),
+        path.resolve(nodeModulesDir, base, '_index.scss'),
+        path.resolve(nodeModulesDir, base, 'index.scss'),
+        path.resolve(nodeModulesDir, base, 'index.css'),
+      ]) {
+        if (fs.existsSync(candidate)) return pathToFileURL(candidate);
+      }
+      return null;
+    },
+  };
+}

package/src/compat/svg-icons.mjs

@@ -0,0 +1,35 @@
+/**
+ * SVG Sprite 图标兼容
+ *
+ * vite-plugin-svg-icons-ng 包装器。
+ * 基于 registries 中的配置自动创建 SVG 图标插件。
+ */
+
+import path from 'node:path';
+import { createSvgIconsPlugin } from 'vite-plugin-svg-icons-ng';
+
+/**
+ * 为项目创建 SVG icons Vite 插件
+ *
+ * @param {object} options
+ * @param {string} options.projectRoot - 项目根目录
+ * @param {string} [options.iconDir] - SVG 图标目录（默认 src/icons/svg）
+ * @param {string} [options.symbolId] - SVG symbol ID 格式（默认 icon-[name]）
+ * @returns {import('vite').Plugin}
+ */
+export function createSvgIconPlugin(options = {}) {
+  const {
+    projectRoot,
+    iconDir = 'src/icons/svg',
+    symbolId = 'icon-[name]',
+  } = options;
+
+  const iconDirs = [path.resolve(projectRoot, iconDir)];
+
+  return createSvgIconsPlugin({
+    iconDirs,
+    symbolId,
+    inject: 'body-last',
+    customDomId: '__svg__icons__dom__',
+  });
+}

package/src/config/discover.mjs

@@ -0,0 +1,261 @@
+/**
+ * 配置发现编排器
+ *
+ * 按优先级（从低到高）加载所有配置源并合并：
+ * 1. 包安全默认值
+ * 2. 项目 vue.config.js 标准字段
+ * 3. package.json 的 inflyVite 字段
+ * 4. infly.vite.config.js / .cjs / .mjs
+ * 5. CLI 参数
+ *
+ * 规范 §9.1
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { createDefaultConfig } from './project-config.mjs';
+import { loadVueCliConfig, extractAdditionalVueConfigInfo } from './vue-cli-reader.mjs';
+import { loadEnvFiles, resolveTarget, buildDefine } from './env.mjs';
+import { deepMerge } from './merge.mjs';
+import { validateStrictCompatibility, diagnoseCompatIssues } from './validation.mjs';
+
+/**
+ * 可选的 infly.vite.config 文件名（按优先级）
+ */
+const CONFIG_FILES = [
+  'infly.vite.config.mjs',
+  'infly.vite.config.js',
+  'infly.vite.config.cjs',
+];
+
+/**
+ * @param {object} options
+ * @param {string} options.command - 'serve' | 'build'
+ * @param {string} options.mode - 模式
+ * @param {string} [options.target] - CLI target
+ * @param {string} options.projectRoot - 项目根目录
+ * @param {object} [options.cliOptions] - CLI 额外选项
+ * @returns {Promise<object>} 归一化配置 + 元信息
+ */
+export async function discoverConfig(options = {}) {
+  const {
+    command = 'build',
+    mode = 'production',
+    target: cliTarget,
+    projectRoot = process.cwd(),
+    cliOptions = {},
+  } = options;
+
+  // test 命令复用 build 的配置语义（mode=test，读取 .env.test 等）
+  const isBuild = command === 'build' || command === 'test';
+  const isServe = command === 'serve';
+
+  // 1. 包默认值
+  const defaults = createDefaultConfig({ command, mode, target: cliTarget, projectRoot, isBuild, isServe });
+
+  // 2. 环境变量（解析 target）
+  const { target: envTarget, define } = buildDefine({
+    projectRoot,
+    mode,
+    target: cliTarget,
+    defaultTarget: defaults.context.target || 'DEFAULT',
+  });
+  const resolvedTarget = cliTarget || envTarget || 'DEFAULT';
+
+  // 3. vue.config.js 标准字段
+  const { vueConfig: vueCli, warnings: vueCliWarnings } = loadVueCliConfig(projectRoot, mode);
+  const extraInfo = extractAdditionalVueConfigInfo(projectRoot);
+
+  // 4. package.json inflyVite 字段
+  const pkgConfig = loadPackageJsonConfig(projectRoot);
+
+  // 5. infly.vite.config.js / .cjs / .mjs
+  const { config: fileConfig, errors: fileErrors } = await loadInflyViteConfig(projectRoot, {
+    command, mode, target: resolvedTarget, projectRoot, isBuild, isServe,
+  });
+
+  // 开始合并
+  const merged = deepMerge(
+    defaults,
+    // vue.config.js → 标准字段映射
+    {
+      base: vueCli.base,
+      outputDir: vueCli.outputDir,
+      assetsDir: vueCli.assetsDir,
+      productionSourceMap: vueCli.productionSourceMap,
+      server: {
+        port: vueCli.server?.port,
+        proxy: vueCli.server?.proxy,
+      },
+      css: {
+        additionalData: vueCli.css?.additionalData,
+      },
+      resolve: {
+        alias: vueCli.resolve?.alias,
+      },
+      html: {
+        title: vueCli.html?.title,
+      },
+      mock: extraInfo.mockEntry ? {
+        enabled: true,
+        entry: extraInfo.mockEntry,
+      } : undefined,
+    },
+    // package.json inflyVite
+    pkgConfig,
+    // infly.vite.config.js
+    fileConfig || {},
+    // CLI 参数
+    {
+      context: { target: resolvedTarget },
+      server: {
+        port: cliOptions.port,
+        host: cliOptions.host,
+        open: cliOptions.open,
+        strictPort: cliOptions.strictPort,
+      },
+    }
+  );
+
+  // Mock 默认值：serve 且存在 mock 入口时启用
+  if (merged.mock.entry) {
+    const mockFullPath = path.resolve(projectRoot, merged.mock.entry);
+    if (fs.existsSync(mockFullPath)) {
+      merged.mock.enabled = merged.mock.enabled !== false && isServe;
+    } else if (merged.mock.enabled) {
+      // mock 明确启用但文件不存在 → 记录但由 runner 决定
+    }
+  }
+
+  // 严格兼容性验证
+  let validation = { valid: true, errors: [] };
+  let diagnoses = [];
+
+  if (merged.strictCompatibility) {
+    validation = validateStrictCompatibility(merged, {
+      hasChainWebpack: vueCli.hasChainWebpack,
+      hasFunctionConfigureWebpack: vueCli.hasFunctionConfigureWebpack,
+      projectRoot,
+      targets: Object.keys(fileConfig?.targets || {}),
+    });
+  } else {
+    diagnoses = diagnoseCompatIssues(merged, {
+      hasChainWebpack: vueCli.hasChainWebpack,
+      hasFunctionConfigureWebpack: vueCli.hasFunctionConfigureWebpack,
+    });
+  }
+
+  // 路径规范化
+  if (merged.outputDir && !path.isAbsolute(merged.outputDir)) {
+    merged.outputDir = path.resolve(projectRoot, merged.outputDir);
+  }
+
+  return {
+    config: merged,
+    env: { define, target: resolvedTarget, envVars: {} },
+    meta: {
+      vueCliWarnings,
+      fileErrors,
+      validation,
+      diagnoses,
+      resolvedTarget,
+    },
+  };
+}
+
+/**
+ * 从 package.json 读取 inflyVite 字段
+ */
+function loadPackageJsonConfig(projectRoot) {
+  const pkgPath = path.join(projectRoot, 'package.json');
+  if (!fs.existsSync(pkgPath)) return {};
+
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return pkg.inflyVite || {};
+  } catch (_) {
+    return {};
+  }
+}
+
+/**
+ * 加载 infly.vite.config.{mjs,js,cjs}
+ *
+ * @param {string} projectRoot
+ * @param {object} context - { command, mode, target, projectRoot, isBuild, isServe }
+ * @returns {Promise<{ config: object|null, errors: string[] }>}
+ */
+async function loadInflyViteConfig(projectRoot, context) {
+  // 检测多文件冲突
+  const found = CONFIG_FILES.filter((name) =>
+    fs.existsSync(path.join(projectRoot, name))
+  );
+
+  if (found.length > 1) {
+    return {
+      config: null,
+      errors: [
+        `检测到多个 infly.vite.config 文件: ${found.join(', ')}。请只保留一个。`
+      ],
+    };
+  }
+
+  if (found.length === 0) {
+    return { config: null, errors: [] };
+  }
+
+  const configPath = path.join(projectRoot, found[0]);
+  const ext = path.extname(found[0]);
+
+  try {
+    let rawConfig;
+
+    if (ext === '.mjs') {
+      // ESM 动态导入
+      const imported = await import(`file://${configPath}`);
+      rawConfig = imported.default || imported;
+    } else if (ext === '.js' || ext === '.cjs') {
+      // CJS require
+      const projectRequire = createRequire(path.join(projectRoot, 'package.json'));
+      rawConfig = projectRequire(configPath);
+    } else {
+      return { config: null, errors: [`不支持的配置文件扩展名: ${ext}`] };
+    }
+
+    // 函数形式
+    if (typeof rawConfig === 'function') {
+      rawConfig = rawConfig(context);
+    }
+
+    if (!rawConfig || typeof rawConfig !== 'object') {
+      return { config: null, errors: [`${found[0]} 必须导出配置对象或函数`] };
+    }
+
+    return { config: rawConfig, errors: [] };
+  } catch (err) {
+    return {
+      config: null,
+      errors: [`无法加载 ${found[0]}: ${err.message}`],
+    };
+  }
+}
+
+/**
+ * 读取 package.json 信息（用于获取项目名称等元数据）
+ */
+export function readProjectMeta(projectRoot) {
+  const pkgPath = path.join(projectRoot, 'package.json');
+  if (!fs.existsSync(pkgPath)) return { name: 'unknown', version: '0.0.0' };
+
+  try {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return {
+      name: pkg.name || path.basename(projectRoot),
+      version: pkg.version || '0.0.0',
+      description: pkg.description || '',
+    };
+  } catch (_) {
+    return { name: path.basename(projectRoot), version: '0.0.0' };
+  }
+}