@infly/vue2-vite 1.0.0

package/src/factory/output-names.mjs

@@ -0,0 +1,62 @@
+/**
+ * 产物命名
+ *
+ * 定义 Vite build 输出文件命名规则：
+ *   static/js/app-[hash:8].js
+ *   static/js/chunk-[hash:8].js
+ *   static/css/style-[hash:8].css
+ *   static/images/asset-[hash:8].[ext]
+ *   static/fonts/font-[hash:8].[ext]
+ *   static/media/asset-[hash:8].[ext]
+ *
+ * 从 factory.js createBuildOutput 迁移。
+ */
+
+import path from 'node:path';
+
+const NAMED_VENDOR_CHUNKS = new Map([
+  ['chunk-vue', 'vendor-vue'],
+  ['chunk-element-ui', 'vendor-element-ui'],
+  ['chunk-echarts', 'vendor-echarts'],
+  ['chunk-utils', 'vendor-utils'],
+  ['chunk-infly-ui', 'vendor-infly-ui'],
+  ['chunk-infly-libs', 'vendor-infly-libs'],
+  ['chunk-commons', 'vendor-commons'],
+]);
+
+/**
+ * 创建 Rollup output 配置
+ *
+ * @param {object} [overrides] - { namedVendorChunks? }
+ * @returns {object} Rollup output options
+ */
+export function createBuildOutput(overrides = {}) {
+  const vendorChunks = overrides.namedVendorChunks || NAMED_VENDOR_CHUNKS;
+
+  return {
+    hashCharacters: 'hex',
+    entryFileNames() {
+      return 'static/js/app-[hash:8].js';
+    },
+    chunkFileNames(chunkInfo) {
+      const vendorName = vendorChunks.get(chunkInfo.name);
+      const prefix = vendorName || 'chunk';
+      return `static/js/${prefix}-[hash:8].js`;
+    },
+    assetFileNames(assetInfo) {
+      const originalName = assetInfo.names?.[0] || assetInfo.name || '';
+      const extension = path.extname(originalName).toLowerCase();
+      if (extension === '.css') return 'static/css/style-[hash:8][extname]';
+      if (/\.(png|jpe?g|gif|svg|webp|avif|ico)$/.test(extension)) {
+        return 'static/images/asset-[hash:8][extname]';
+      }
+      if (/\.(woff2?|eot|ttf|otf)$/.test(extension)) {
+        return 'static/fonts/font-[hash:8][extname]';
+      }
+      if (/\.(mp4|webm|ogg|mp3|wav|flac|aac)$/.test(extension)) {
+        return 'static/media/asset-[hash:8][extname]';
+      }
+      return 'static/assets/asset-[hash:8][extname]';
+    },
+  };
+}

package/src/index.mjs

@@ -0,0 +1,55 @@
+/**
+ * @infly/vue2-vite 公开 Node API
+ *
+ * 提供编程式访问 Vite 兼容构建能力。
+ */
+
+// CLI 信息
+export { EXIT_CODES, run } from './cli/run.mjs';
+
+// 配置
+export { discoverConfig } from './config/discover.mjs';
+export { buildDefine, parseEnvFile, loadEnvFiles, resolveTarget } from './config/env.mjs';
+export { createDefaultConfig } from './config/project-config.mjs';
+export {
+  extractAdditionalVueConfigInfo,
+  loadVueCliConfig,
+} from './config/vue-cli-reader.mjs';
+export {
+  createRegisteredConfig,
+  createRegisteredViteConfig,
+} from './config/registered.mjs';
+
+// 工厂
+export { createViteConfig } from './factory/create-vite-config.mjs';
+export { resolveBuildPolicy } from './factory/build-policy.mjs';
+
+// Runner
+export { serve } from './runner/serve.mjs';
+export { build, dryRun } from './runner/build.mjs';
+
+// 兼容插件（供高级用户扩展）
+export {
+  generateGlobReplacement,
+  requireContextPlugin,
+} from './compat/require-context.mjs';
+export { assetRequirePlugin, transformAssetRequires } from './compat/assets.mjs';
+export { commonJsPlugin, transformCommonJsModule } from './compat/commonjs.mjs';
+export { transformJsx, jsxPrePlugin } from './compat/jsx.mjs';
+export { createScssExportCompatPlugin, addAppRootSassLoadPath } from './compat/sass-export.mjs';
+export { vueRouterPromisePlugin } from './compat/router.mjs';
+export { createSvgIconPlugin } from './compat/svg-icons.mjs';
+export {
+  mockPlugin,
+  createMockMiddleware,
+  hasMockServer,
+} from './compat/mock.mjs';
+export {
+  generateViteHtml,
+  replaceEjsTokens,
+  injectViteEntry,
+  validateEjsTemplate,
+  KNOWN_EJS_TOKENS,
+} from './compat/html.mjs';
+export { emptyStubPlugin } from './compat/empty-stub.mjs';
+export { importInteropPlugin, transformImportInterop } from './compat/import-interop.mjs';

package/src/runner/build.mjs

@@ -0,0 +1,43 @@
+/**
+ * Vite build runner
+ *
+ * 使用 Vite Node API 执行生产构建。
+ * 替代原 vite-runner.js 的子进程方式。
+ */
+
+import { build as viteBuild } from 'vite';
+
+const C_GREEN = '\x1b[32m';
+const C_RED = '\x1b[31m';
+const C_RESET = '\x1b[0m';
+
+/**
+ * 执行 Vite build
+ *
+ * @param {import('vite').UserConfig} viteConfig - Vite 配置
+ * @returns {Promise<void>}
+ */
+export async function build(viteConfig) {
+  try {
+    await viteBuild(viteConfig);
+    console.log(`${C_GREEN}@infly/vue2-vite 构建完成${C_RESET}`);
+  } catch (err) {
+    console.error(`${C_RED}@infly/vue2-vite 构建失败:\n${err.stack || err.message}${C_RESET}`);
+    throw err;
+  }
+}
+
+/**
+ * Dry-run 模式：仅打印构建信息，不实际构建
+ *
+ * @param {object} config - 归一化配置
+ */
+export function dryRun(config) {
+  const { command, mode, target, projectRoot } = config.context || {};
+  console.log('@infly/vue2-vite dry-run:');
+  console.log(`  命令:    ${command}`);
+  console.log(`  mode:    ${mode}`);
+  console.log(`  target:  ${target}`);
+  console.log(`  项目:    ${projectRoot}`);
+  console.log(`  输出:    ${config.outputDir}`);
+}

package/src/runner/serve.mjs

@@ -0,0 +1,44 @@
+/**
+ * Vite dev server runner
+ *
+ * 使用 Vite Node API 启动 dev server。
+ * 替代原 vite-runner.js 的子进程方式。
+ */
+
+import { createServer } from 'vite';
+import { registerSignalHandlers } from './signals.mjs';
+
+/**
+ * 启动 Vite dev server
+ *
+ * @param {import('vite').UserConfig} viteConfig - Vite 配置
+ * @returns {Promise<import('vite').ViteDevServer>}
+ */
+export async function serve(viteConfig) {
+  let server;
+
+  try {
+    server = await createServer(viteConfig);
+
+    // 注册信号处理（Ctrl+C 优雅退出）
+    registerSignalHandlers(async () => {
+      if (server) {
+        await server.close();
+      }
+    });
+
+    await server.listen();
+
+    server.printUrls();
+    server.bindCLIShortcuts({ print: true });
+
+    return server;
+  } catch (err) {
+    // 可能部分启动失败（如端口占用），但 mock/middleware 错误不阻止启动
+    console.error(`@infly/vue2-vite dev server 启动失败:\n${err.stack || err.message}`);
+    if (server) {
+      await server.close();
+    }
+    throw err;
+  }
+}

package/src/runner/signals.mjs

@@ -0,0 +1,29 @@
+/**
+ * 进程信号处理
+ *
+ * SIGINT/SIGTERM 转发，确保子进程正常退出。
+ */
+
+/**
+ * 为异步操作注册信号处理
+ *
+ * @param {() => Promise<void>} cleanup - 清理回调
+ * @returns {() => void} 移除监听器的函数
+ */
+export function registerSignalHandlers(cleanup) {
+  const handler = (signal) => {
+    console.log(`\n@infly/vue2-vite 收到 ${signal}，正在退出...`);
+    Promise.resolve()
+      .then(() => cleanup())
+      .then(() => process.exit(0))
+      .catch(() => process.exit(1));
+  };
+
+  process.on('SIGINT', handler);
+  process.on('SIGTERM', handler);
+
+  return () => {
+    process.off('SIGINT', handler);
+    process.off('SIGTERM', handler);
+  };
+}

package/src/runner/test.mjs

@@ -0,0 +1,190 @@
+/**
+ * vitest 测试 runner
+ *
+ * 从已生成的 Vite UserConfig 提取对测试有意义的子集（alias、define、css
+ * preprocessorOptions），配合 @vitejs/plugin-vue2 生成临时 vitest 配置并转交
+ * vitest CLI 运行。临时配置写入系统临时目录，不污染项目（维持"子仓零改动"）。
+ *
+ * jest API 兼容：启用 globals（describe/it/expect/vi/mock 等全局可用），
+ * 使既有 jest 测试文件无需逐文件改写即可运行。
+ */
+
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+
+const require = createRequire(import.meta.url);
+
+function cloneConfigValue(value) {
+  if (value instanceof RegExp) return value;
+  if (Array.isArray(value)) {
+    return value
+      .map((entry) => cloneConfigValue(entry))
+      .filter((entry) => entry !== undefined);
+  }
+  if (value && typeof value === 'object') {
+    return Object.fromEntries(
+      Object.entries(value)
+        .map(([key, entry]) => [key, cloneConfigValue(entry)])
+        .filter(([, entry]) => entry !== undefined),
+    );
+  }
+  if (typeof value === 'function' || value === undefined) return undefined;
+  return value;
+}
+
+function serializeJavaScript(value) {
+  if (value instanceof RegExp) return value.toString();
+  if (Array.isArray(value)) return `[${value.map(serializeJavaScript).join(', ')}]`;
+  if (value && typeof value === 'object') {
+    return `{${Object.entries(value)
+      .map(([key, entry]) => `${JSON.stringify(key)}: ${serializeJavaScript(entry)}`)
+      .join(', ')}}`;
+  }
+  return JSON.stringify(value);
+}
+
+/**
+ * 解析 vitest CLI 入口（vitest 4 的 exports 不暴露 vitest.mjs，需读 bin 字段）
+ */
+function resolveVitestCli() {
+  try {
+    const packageJsonPath = require.resolve('vitest/package.json');
+    const binField = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')).bin;
+    const binPath = typeof binField === 'string' ? binField : binField?.vitest;
+    if (!binPath) return null;
+    return path.resolve(path.dirname(packageJsonPath), binPath);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 生成 vitest 配置对象（可序列化的纯数据）
+ *
+ * @param {object} viteConfig - createViteConfig 的产物
+ * @param {object} config - 归一化项目配置
+ * @param {string} projectRoot
+ * @returns {object} 可 JSON 序列化的 vitest inline 配置数据
+ */
+export function createVitestConfigData(viteConfig, config, projectRoot) {
+  const include = [
+    'tests/**/*.{test,spec}.{js,mjs,ts}',
+    'tests/unit/**/*.{test,spec}.{js,mjs,ts}',
+    'src/**/*.{test,spec}.{js,mjs,ts}',
+  ];
+
+  const css = cloneConfigValue(viteConfig?.css);
+  const sassOptions = css?.preprocessorOptions?.scss;
+  const hasSassImporter = Boolean(
+    viteConfig?.css?.preprocessorOptions?.scss?.importers?.length,
+  );
+  if (sassOptions) delete sassOptions.importers;
+
+  return {
+    root: projectRoot,
+    resolve: {
+      // alias 数组（find/replacement，绝对路径）已在 Vite UserConfig 中解析好
+      ...(viteConfig?.resolve?.alias ? { alias: viteConfig.resolve.alias } : {}),
+    },
+    ...(viteConfig?.define ? { define: viteConfig.define } : {}),
+    ...(css ? { css } : {}),
+    ...(hasSassImporter ? { __inflySassTildeImporterRoot: projectRoot } : {}),
+    test: {
+      environment: 'jsdom',
+      globals: true,
+      include,
+    },
+  };
+}
+
+/**
+ * 把配置数据写成临时 vitest 配置文件，返回 { file, cleanup }
+ *
+ * 临时文件位于系统临时目录，vitest 与 vue2 插件均以绝对路径导入（vitest 4
+ * 移除了 'vitest/config' 子路径且临时目录不在包解析链上），配置完全自包含。
+ */
+export function writeTempVitestConfig(data, vue2PluginPath) {
+  const vitestPackageRoot = path.dirname(require.resolve('vitest/package.json'));
+  // vitest 4：defineConfig 在 dist/config.js（dist/index.js 不导出；无 'vitest/config' 子路径）
+  const vitestConfigImport = pathToFileURL(
+    path.join(vitestPackageRoot, 'dist', 'config.js'),
+  ).href;
+  const pluginImport = pathToFileURL(vue2PluginPath).href;
+  const sassImporterImport = new URL('../compat/sass-importer.mjs', import.meta.url).href;
+  const source = [
+    `import { defineConfig } from ${JSON.stringify(vitestConfigImport)};`,
+    `import vue2 from ${JSON.stringify(pluginImport)};`,
+    `import { createSassTildeImporter } from ${JSON.stringify(sassImporterImport)};`,
+    `const config = ${serializeJavaScript(data)};`,
+    'config.plugins = [vue2()];',
+    'config.test.onConsoleLog = () => undefined;',
+    'if (config.__inflySassTildeImporterRoot) {',
+    '  const importerRoot = config.__inflySassTildeImporterRoot;',
+    '  delete config.__inflySassTildeImporterRoot;',
+    '  config.css.preprocessorOptions.scss.importers = [createSassTildeImporter(importerRoot)];',
+    '}',
+    'export default defineConfig(config);',
+    '',
+  ].join('\n');
+
+  const file = path.join(
+    os.tmpdir(),
+    `infly-vue2-vite-vitest-${process.pid}-${Date.now()}.mjs`,
+  );
+  fs.writeFileSync(file, source, 'utf8');
+  return {
+    file,
+    cleanup: () => fs.rmSync(file, { force: true }),
+  };
+}
+
+/**
+ * 运行 vitest（一次性；--watch 时进入监听模式）
+ *
+ * @param {object} viteConfig - Vite UserConfig 产物
+ * @param {object} config - 归一化项目配置
+ * @param {object} options - { projectRoot, watch, passthrough }
+ * @returns {Promise<number>} vitest 退出码
+ */
+export async function runTest(viteConfig, config, options = {}) {
+  const projectRoot = options.projectRoot || process.cwd();
+  const vitestCli = resolveVitestCli();
+  if (!vitestCli) {
+    throw new Error('找不到 vitest CLI。请确认 @infly/vue2-vite 安装了 vitest 依赖。');
+  }
+  const vue2PluginPath = require.resolve('@vitejs/plugin-vue2');
+
+  const data = createVitestConfigData(viteConfig, config, projectRoot);
+  const { file, cleanup } = writeTempVitestConfig(data, vue2PluginPath);
+
+  const finalArgs = options.watch
+    ? ['--config', file, ...(options.passthrough || [])]
+    : ['run', '--config', file, ...(options.passthrough || [])];
+
+  return await new Promise((resolve) => {
+    const child = spawn(process.execPath, [vitestCli, ...finalArgs], {
+      cwd: projectRoot,
+      env: process.env,
+      stdio: 'inherit',
+    });
+
+    ['SIGINT', 'SIGTERM'].forEach((sig) => {
+      process.once(sig, () => child.kill(sig));
+    });
+
+    child.once('error', (err) => {
+      cleanup();
+      console.error(`@infly/vue2-vite vitest 启动失败: ${err.message}`);
+      resolve(1);
+    });
+
+    child.once('exit', (code) => {
+      cleanup();
+      resolve(typeof code === 'number' ? code : 1);
+    });
+  });
+}