@infly/vue2-vite 1.0.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025 Infly
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,307 @@
+# @infly/vue2-vite
+
+当前稳定版本：`1.0.0`。1.0 稳定化保持公开入口、CLI 参数、`vue-cli-service` 兼容命令和运行行为不变。
+
+Vue 2.7 项目专用的 Vite 7 构建适配器。安装一个包，获得两种入口：
+
+- **独立 CLI**：`infly-vue2-vite serve` / `infly-vue2-vite build` / `infly-vue2-vite test`
+- **`vue-cli-service` 薄分发器**：`vue-cli-service serve --infly-vite`（兼容旧命令习惯），`vue-cli-service test:unit` 转交 vitest
+
+两种方式都只需安装 `@infly/vue2-vite`，无需额外依赖。
+包括 mock 服务器转译所需的 Babel 能力，也由本包直接声明和解析。
+
+## 安装
+
+```bash
+pnpm add -D @infly/vue2-vite
+```
+
+## 两种使用方式
+
+### 方式 1：独立 CLI（推荐）
+
+```bash
+# 开发服务器
+pnpm exec infly-vue2-vite serve
+pnpm exec infly-vue2-vite serve --port 9528
+pnpm exec infly-vue2-vite serve --host localhost  # 仅本机访问
+
+# 生产构建
+pnpm exec infly-vue2-vite build
+pnpm exec infly-vue2-vite build --mode staging
+pnpm exec infly-vue2-vite build --mode release --target MER
+
+# 单元测试（vitest，jest API 兼容）
+pnpm exec infly-vue2-vite test
+pnpm exec infly-vue2-vite test --watch
+```
+
+独立 CLI 的开发服务器默认监听 `0.0.0.0`，允许通过局域网地址访问；存在多个网卡时，
+启动日志只展示 Vite 返回的第一个 `Network` 地址，但服务仍监听所有网卡。
+从子项目目录启动时会向上查找最近的 `pnpm-workspace.yaml`，并将 workspace 根目录的
+`node_modules` 加入 Vite 文件访问范围，以支持 pnpm 根依赖中的字体等静态资源。
+
+所有 Vite 构建模式只输出面向 Vite 7 Baseline Widely Available 浏览器的现代 ESM，不生成 SystemJS、`nomodule` 或旧浏览器 polyfill；Webpack 兼容策略由原 Vue CLI 工具链独立维护。
+
+`package.json` 脚本：
+
+```json
+{
+  "scripts": {
+    "dev": "infly-vue2-vite serve",
+    "dev:vite": "infly-vue2-vite serve --open",
+    "build:stage": "infly-vue2-vite build --mode staging",
+    "build:prod": "infly-vue2-vite build --mode production",
+    "build:release": "infly-vue2-vite build --mode release"
+  }
+}
+```
+
+### 方式 2：vue-cli-service 薄分发器
+
+安装 `@infly/vue2-vite` 后自动获得 `vue-cli-service` 命令。根据 `@vue/cli-service` 是否可用自动选择模式：
+
+- **Vite 工具链模式**（`@vue/cli-service` 不可用）：`vue-cli-service` 默认走 Vite，`--infly-vite` 可选。
+- **Webpack 共存模式**（`@vue/cli-service` 可用）：不加 flag 走 Webpack，加 `--infly-vite` 走 Vite。
+
+```bash
+# Vite 工具链模式（默认即 Vite，--infly-vite 可选）
+vue-cli-service serve
+vue-cli-service build --mode staging
+
+# Webpack 共存模式（默认 Webpack，加 flag 切换）
+vue-cli-service serve                     # → Webpack
+vue-cli-service serve --infly-vite        # → Vite
+```
+
+`package.json` 脚本（Vite 工具链模式）：
+
+```json
+{
+  "scripts": {
+    "dev": "vue-cli-service serve",
+    "build:stage": "vue-cli-service build --mode staging",
+    "build:prod": "vue-cli-service build --mode production"
+  }
+}
+```
+
+> **注意**：Vite 工具链模式下 `.pnpmfile.cjs` 会裁剪 webpack 构建依赖（含 `@vue/cli-service`），薄分发器检测到缺失后自动默认 Vite，无需 `--infly-vite`。
+
+### 薄分发器行为矩阵
+
+**Vite 工具链模式（`@vue/cli-service` 不可用）：**
+
+| 命令 | 实际执行的构建器 |
+|------|-----------------|
+| `vue-cli-service serve` | `infly-vue2-vite` → Vite dev server |
+| `vue-cli-service build` | `infly-vue2-vite` → Vite production build |
+| `vue-cli-service serve --infly-vite` | `infly-vue2-vite` → Vite dev server（flag 可选） |
+| `vue-cli-service test:unit` | `infly-vue2-vite test` → vitest run（jest API 兼容） |
+
+**Webpack 共存模式（`@vue/cli-service` 可用）：**
+
+| 命令 | 实际执行的构建器 |
+|------|-----------------|
+| `vue-cli-service serve` | `@vue/cli-service` → Webpack dev server |
+| `vue-cli-service build` | `@vue/cli-service` → Webpack production build |
+| `vue-cli-service serve --infly-vite` | `infly-vue2-vite` → Vite dev server |
+| `vue-cli-service build --infly-vite` | `infly-vue2-vite` → Vite production build |
+| `vue-cli-service test:unit` | `@vue/cli-service` → Jest（Webpack） |
+| `vue-cli-service test:unit --infly-vite` | `infly-vue2-vite test` → vitest run |
+
+## 配置
+
+### 优先级（从低到高）
+
+1. `@infly/vue2-vite` 安全默认值
+2. 项目 `vue.config.js` 中可自动转换的标准字段
+3. `package.json` 的 `inflyVite` 字段
+4. `infly.vite.config.js` / `.cjs` / `.mjs`（三选一）
+5. CLI 参数
+
+### package.json 配置
+
+适合放稳定的默认值：
+
+```json
+{
+  "inflyVite": {
+    "defaultTarget": "DEFAULT",
+    "mainEntry": "src/main.js",
+    "htmlTemplate": "public/index.html",
+    "strictCompatibility": true
+  }
+}
+```
+
+### infly.vite.config.js 示例
+
+```js
+const path = require("node:path");
+
+module.exports = function createInflyViteConfig(context) {
+  // context: { command, mode, target, projectRoot, isBuild, isServe }
+
+  const targetConfigs = {
+    DEFAULT: { port: 9528, outputDir: "../dist/ea", title: "邮惠权益平台", theme: "default" },
+    MER:    { port: 9530, outputDir: "../dist/mer", title: "邮惠权益平台商家端", theme: "mer" },
+  };
+
+  const cfg = targetConfigs[context.target];
+  if (!cfg) throw new Error(`未知 target: ${context.target}`);
+
+  return {
+    outputDir: cfg.outputDir,
+    server: { port: cfg.port },
+    html: { title: cfg.title, favicon: "public/favicon.ico" },
+    css: {
+      additionalData: `@import "@/styles/mixin.scss";\n@import "@/styles/theme.${cfg.theme}.scss";`,
+    },
+    resolve: { alias: { "@": path.resolve(__dirname, "src") } },
+    mock: { entry: "mock/mock-server.js", enabled: context.command === "serve" },
+  };
+};
+```
+
+### vue.config.js 自动转换字段
+
+| Vue CLI 字段 | Vite 映射 | 条件 |
+|-------------|----------|------|
+| `publicPath` | `base` | 字符串 |
+| `outputDir` | `build.outDir` | 字符串 |
+| `assetsDir` | `build.assetsDir` | 字符串 |
+| `productionSourceMap` | `build.sourcemap` | 布尔值 |
+| `devServer.port` | `server.port` | 数字 |
+| `devServer.proxy` | `server.proxy` | 对象 |
+| `css.loaderOptions.scss.additionalData` | `css.preprocessorOptions.scss.additionalData` | 字符串 |
+| `configureWebpack.resolve.alias` | `resolve.alias` | 对象形式 |
+| `configureWebpack.name` | HTML title | 字符串 |
+
+对象形式 `configureWebpack.resolve.alias` 中的绝对源码目录也会进入兼容转换范围；
+因此单项目启动时，通过别名加载的跨应用源码若包含静态 `require.context`，仍会转换为
+`import.meta.glob`，无需在子模块中增加专用 Vite 配置。
+
+以下字段不能自动转换：
+- `chainWebpack`：严格兼容模式下会失败；其行为由内置默认能力覆盖（SVG sprite、whitespace、资源内联、分包、drop console 等），非严格模式不再产生诊断
+- 函数形式 `configureWebpack`：无法猜测转换
+- 任意 webpack plugin/loader：需通过显式配置提供等价 Vite 插件
+
+### 缺失具名导出兼容
+
+应用源码中的相对路径和 `@/` JavaScript 模块若缺少被导入的具名导出，兼容层会输出
+Vite warning，并将该导入降级为 namespace 解构；缺失值为 `undefined`，不会阻断开发服务器
+或生产构建。第三方依赖、TypeScript、Vue SFC 以及包含未知 `export *` 的桶文件不做降级，
+仍保留 Vite 原生错误，以免隐藏真实依赖契约问题。
+
+## Node 要求
+
+Vite 7 要求 Node `^20.19.0` 或 `>=22.12.0`。推荐 Node `22.23.1`。
+
+版本不满足时，CLI 在加载 Vite 之前退出并显示：
+
+```text
+@infly/vue2-vite 当前 Node 为 18.20.8；Vite 7 要求 Node ^20.19.0 或 >=22.12.0。
+请切换到 Node 22.23.1 后重试。默认 Webpack 命令未受影响。
+```
+
+## 退出码
+
+| 状态 | 退出码 |
+|------|--------|
+| 成功 | 0 |
+| 参数错误 | 2 |
+| Node 版本不满足 | 3 |
+| 配置错误 | 4 |
+| 兼容检查失败 | 5 |
+| Vite serve 启动失败 | 10 |
+| Vite build 失败 | 11 |
+
+## Node API
+
+```js
+import {
+  build,
+  createViteConfig,
+  discoverConfig,
+  extractAdditionalVueConfigInfo,
+  loadVueCliConfig,
+  serve,
+} from '@infly/vue2-vite';
+
+// 加载项目配置
+const { config } = await discoverConfig({
+  command: 'build',
+  mode: 'production',
+  projectRoot: process.cwd(),
+});
+
+// 单独检查旧 Vue CLI 配置；只返回可转换字段和诊断，不修改调用方配置
+const { vueConfig, warnings } = loadVueCliConfig(process.cwd(), 'production');
+const legacyInfo = extractAdditionalVueConfigInfo(process.cwd());
+
+// 生成 Vite UserConfig
+const viteConfig = createViteConfig(config);
+
+// 执行构建
+await build(viteConfig);
+```
+
+### Monorepo 注册式配置
+
+Monorepo 可以保留自己的应用清单和部署元数据，通过注册式 API 注入公共工厂：
+
+```js
+const {
+  createRegisteredViteConfig,
+} = require('@infly/vue2-vite/registered');
+
+module.exports = ({ command, mode }) => createRegisteredViteConfig(app, {
+  command: command === 'serve' ? 'serve' : 'build',
+  mode,
+  target: process.env.VUE_APP_PLATFORM,
+  rootDir: monorepoRoot,
+  appSourcePaths: registeredAppPaths,
+});
+```
+
+批量 workspace 入口使用 `@infly/vue2-vite/workspace` 的
+`createWorkspaceRunner(dependencies)`，显式注入 `registry`、`getTargetConfig`、
+`createConfigPath` 和 `defaultRootDir`。公共包不会读取调用方的 `configs/`、
+`scripts/` 或应用清单。runner 会为每个 dev/build 子进程注入
+`INFLY_VITE_APP_ID` 和从应用 `package.json` 读取的 `INFLY_VITE_APP_VERSION`，
+因此多个注册应用可以共用同一个调用方 Vite 配置入口，并在 HTML 中展示各自版本。
+模板已有 `window.BUILD_INFO` 时兼容层不会重复注入；模板没有时才创建该对象。
+
+公共工厂使用包含运行时编译器的 `vue/dist/vue.esm.js`，用于兼容 Vue 2 项目中的
+`Vue.extend({ template })`。默认分包会为 `@infly/ui` 与 `@infly/libs`（含其
+`@infly/ts-libs` 权威实现）生成独立的
+`vendor-infly-ui`、`vendor-infly-libs` 产物；其他依赖继续交给 Rollup 按模块图拆分。
+
+## 回滚
+
+从脚本删除 `--infly-vite`，立即恢复原 Webpack：
+
+```diff
+- "dev": "vue-cli-service serve --infly-vite"
++ "dev": "vue-cli-service serve"
+```
+
+或删除 `@infly/vue2-vite` 依赖：
+
+```bash
+pnpm remove @infly/vue2-vite
+```
+
+默认 Webpack 始终存在（`@vue/cli-service` 由项目自行管理），回滚不需要重新安装整个项目。
+
+## 与 @infly/libs 的关系
+
+- `@infly/vue2-vite` **不依赖** `@infly/libs`
+- `@infly/libs` 提供一个可选的薄分发器版本，供 admin-monorepo 内部使用
+- 独立项目直接安装 `@infly/vue2-vite` 即可获得完整能力（含 `vue-cli-service` 薄分发器）
+- Monorepo 注册式 API 只消费调用方注入的数据，不包含任何具体应用、客户或部署目标
+
+## 许可
+
+ISC

package/bin/infly-vue2-vite.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+/**
+ * @infly/vue2-vite CLI 入口
+ *
+ * 薄入口——仅导入并运行 run 函数。
+ * 所有逻辑位于 src/cli/run.mjs。
+ */
+
+import { run } from '../src/cli/run.mjs';
+
+run();

package/bin/vue-cli-service.mjs

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+/**
+ * vue-cli-service 薄分发器（@infly/vue2-vite 内建版本）
+ *
+ * 使已习惯 vue-cli-service 命令的项目只需加 --infly-vite 即可切换到 Vite。
+ * 与 @infly/libs 版本不同：此版本是纯项目本地实现，无 monorepo 根检测。
+ *
+ * 行为矩阵（Vite 工具链模式，@vue/cli-service 不可用）：
+ *   vue-cli-service serve                      → Vite dev server（默认）
+ *   vue-cli-service build                      → Vite build（默认）
+ *   vue-cli-service serve --infly-vite         → Vite dev server（标志可选）
+ *   vue-cli-service test:unit                  → vitest run（转交 infly-vue2-vite test）
+ *
+ * 行为矩阵（Webpack 共存模式，@vue/cli-service 可用）：
+ *   vue-cli-service serve                      → 原始 @vue/cli-service（Webpack）
+ *   vue-cli-service build                      → 原始 @vue/cli-service（Webpack）
+ *   vue-cli-service serve --infly-vite         → infly-vue2-vite serve（Vite）
+ *   vue-cli-service build --infly-vite         → infly-vue2-vite build（Vite）
+ *   vue-cli-service test:unit --infly-vite     → vitest run（转交 infly-vue2-vite test）
+ *   Vite 构建失败                               → 不回退 Webpack
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+
+/**
+ * 从参数中检测并消费 --infly-vite
+ */
+function parseFlags(argv) {
+  let hasInflyVite = false;
+  const remaining = [];
+
+  for (const arg of argv) {
+    if (arg === '--infly-vite') {
+      hasInflyVite = true;
+    } else {
+      remaining.push(arg);
+    }
+  }
+
+  return { hasInflyVite, remaining };
+}
+
+/**
+ * 生成子进程并转发信号
+ */
+function spawnForwarded(executable, args, options) {
+  const child = spawn(executable, args, { ...options, stdio: 'inherit' });
+
+  ['SIGINT', 'SIGTERM'].forEach((sig) => {
+    process.once(sig, () => child.kill(sig));
+  });
+
+  child.once('error', (err) => {
+    console.error(err.message);
+    process.exitCode = 1;
+  });
+
+  child.once('exit', (code, signal) => {
+    process.exitCode = typeof code === 'number' ? code : signal ? 1 : 0;
+  });
+
+  return child;
+}
+
+/**
+ * 启动 Vite（通过 infly-vue2-vite CLI）
+ */
+function spawnVite(args, cwd) {
+  const selfDir = path.dirname(fileURLToPath(import.meta.url));
+  const viteCli = path.resolve(selfDir, 'infly-vue2-vite.mjs');
+
+  if (!fs.existsSync(viteCli)) {
+    console.error(
+      '[vue-cli-service] 找不到 infly-vue2-vite CLI 入口。请确认 @infly/vue2-vite 安装完整。'
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  return spawnForwarded(process.execPath, [viteCli, ...args], {
+    cwd,
+    env: process.env,
+  });
+}
+
+/**
+ * 检测 @vue/cli-service 是否可用
+ * Vite 工具链模式下 .pnpmfile.cjs 会裁剪 webpack 依赖，导致解析失败 → 默认走 Vite
+ */
+function resolveVueCliService(cwd) {
+  try {
+    return createRequire(path.join(cwd, 'package.json'))
+      .resolve('@vue/cli-service/bin/vue-cli-service.js');
+  } catch (_) {
+    return null;
+  }
+}
+
+function run(argv = process.argv.slice(2), cwd = process.cwd()) {
+  const { hasInflyVite, remaining } = parseFlags(argv);
+  const vueCliBin = resolveVueCliService(cwd);
+
+  // Vite 工具链模式：@vue/cli-service 不可用，默认走 Vite（--infly-vite 可选）
+  if (!vueCliBin) {
+    if (remaining[0] === 'test:unit') {
+      // test:unit → vitest（jest API 由 vitest globals 兼容）
+      return spawnVite(['test', ...remaining.slice(1)], cwd);
+    }
+    return spawnVite(remaining, cwd);
+  }
+
+  // Webpack 共存模式：默认 Webpack，加 --infly-vite 切换 Vite
+  if (!hasInflyVite) {
+    return spawnForwarded(process.execPath, [vueCliBin, ...remaining], {
+      cwd,
+      env: process.env,
+    });
+  }
+
+  // 有 --infly-vite → 使用 Vite
+
+  // test:unit → vitest（jest API 由 vitest globals 兼容）
+  if (remaining[0] === 'test:unit') {
+    return spawnVite(['test', ...remaining.slice(1)], cwd);
+  }
+
+  return spawnVite(remaining, cwd);
+}
+
+run();

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@infly/vue2-vite",
+  "version": "1.0.0",
+  "description": "Explicit opt-in Vite 7 build adapter for Vue 2.7 projects",
+  "type": "module",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "bin": {
+    "infly-vue2-vite": "./bin/infly-vue2-vite.mjs",
+    "vue-cli-service": "./bin/vue-cli-service.mjs"
+  },
+  "exports": {
+    ".": "./src/index.mjs",
+    "./config": "./src/config/project-config.mjs",
+    "./registered": "./src/config/registered.mjs",
+    "./workspace": "./src/runner/workspace.cjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "eslint": "^9.0.0",
+    "globals": "^15.0.0"
+  },
+  "peerDependencies": {
+    "vue": "^2.7.16",
+    "@vue/test-utils": "^1.3.6"
+  },
+  "peerDependenciesMeta": {
+    "@vue/test-utils": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@babel/core": "^7.23.3",
+    "@babel/preset-env": "^7.23.3",
+    "@babel/register": "^7.22.15",
+    "@vitejs/plugin-vue2": "2.3.4",
+    "@vue/babel-preset-jsx": "1.4.0",
+    "autoprefixer": "10.4.16",
+    "body-parser": "^2.3.0",
+    "chalk": "4.1.2",
+    "chokidar": "3.6.0",
+    "express": "4.21.2",
+    "jsdom": "^28.0.0",
+    "path-browserify": "1.0.1",
+    "postcss": "8.4.31",
+    "sass": "^1.70.0",
+    "vite": "7.3.6",
+    "vite-plugin-svg-icons-ng": "1.9.2",
+    "vitest": "^4.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/gdinfly_1/admin-monorepo.git"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "lint": "eslint .",
+    "check:pack": "pnpm pack --dry-run",
+    "publishPkg": "pnpm publish --access=public --registry=https://registry.npmjs.org/ --no-git-checks"
+  }
+}