@hzab/vite-config 0.0.2-alpha.0

package/dist/vitest.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+var react = require('@vitejs/plugin-react');
+var vite = require('vite');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var react__default = /*#__PURE__*/_interopDefault(react);
+
+// src/create-package-vitest-config.ts
+
+// src/plugins/stub-less.ts
+var cssModuleStub = `
+const styles = new Proxy({}, {
+  get: (_target, property) => typeof property === "string" ? property : undefined,
+});
+export default styles;
+`;
+function stubLessPlugin() {
+  return {
+    name: "stub-less",
+    load(id) {
+      if (/\.module\.less(?:$|\?)/.test(id)) {
+        return cssModuleStub;
+      }
+      if (/\.less(?:$|\?)/.test(id)) {
+        return "";
+      }
+    }
+  };
+}
+
+// src/create-package-vitest-config.ts
+function createPackageVitestConfig(options) {
+  const {
+    packageRoot,
+    alias,
+    react: enableReact = false,
+    stubLess = false,
+    environment = "happy-dom",
+    include = ["test/**/*.test.ts"],
+    setupFiles,
+    plugins: extraPlugins = [],
+    vite: viteOverride,
+    configure
+  } = options;
+  const plugins = [
+    ...enableReact ? [react__default.default()] : [],
+    ...stubLess ? [stubLessPlugin()] : [],
+    ...extraPlugins
+  ];
+  const base = {
+    root: packageRoot,
+    plugins,
+    resolve: {
+      alias
+    },
+    test: {
+      environment,
+      include,
+      ...setupFiles ? { setupFiles } : {}
+    }
+  };
+  let merged = viteOverride ? vite.mergeConfig(base, viteOverride) : base;
+  if (configure) {
+    merged = configure(merged);
+  }
+  return merged;
+}
+
+exports.createPackageVitestConfig = createPackageVitestConfig;
+//# sourceMappingURL=vitest.cjs.map
+//# sourceMappingURL=vitest.cjs.map

package/dist/vitest.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/stub-less.ts","../src/create-package-vitest-config.ts"],"names":["react","mergeConfig"],"mappings":";;;;;;;;;;;;AAEA,IAAM,aAAA,GAAgB;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAWf,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,WAAA;AAAA,IACN,KAAK,EAAA,EAAI;AACP,MAAA,IAAI,wBAAA,CAAyB,IAAA,CAAK,EAAE,CAAA,EAAG;AACrC,QAAA,OAAO,aAAA;AAAA,MACT;AACA,MAAA,IAAI,gBAAA,CAAiB,IAAA,CAAK,EAAE,CAAA,EAAG;AAC7B,QAAA,OAAO,EAAA;AAAA,MACT;AAAA,IACF;AAAA,GACF;AACF;;;ACZO,SAAS,0BACd,OAAA,EACkB;AAClB,EAAA,MAAM;AAAA,IACJ,WAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAO,WAAA,GAAc,KAAA;AAAA,IACrB,QAAA,GAAW,KAAA;AAAA,IACX,WAAA,GAAc,WAAA;AAAA,IACd,OAAA,GAAU,CAAC,mBAAmB,CAAA;AAAA,IAC9B,UAAA;AAAA,IACA,OAAA,EAAS,eAAe,EAAC;AAAA,IACzB,IAAA,EAAM,YAAA;AAAA,IACN;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,OAAA,GAA0B;AAAA,IAC9B,GAAI,WAAA,GAAc,CAACA,sBAAA,EAAO,IAAI,EAAC;AAAA,IAC/B,GAAI,QAAA,GAAW,CAAC,cAAA,EAAgB,IAAI,EAAC;AAAA,IACrC,GAAG;AAAA,GACL;AAEA,EAAA,MAAM,IAAA,GAAyB;AAAA,IAC7B,IAAA,EAAM,WAAA;AAAA,IACN,OAAA;AAAA,IACA,OAAA,EAAS;AAAA,MACP;AAAA,KACF;AAAA,IACA,IAAA,EAAM;AAAA,MACJ,WAAA;AAAA,MACA,OAAA;AAAA,MACA,GAAI,UAAA,GAAa,EAAE,UAAA,KAAe;AAAC;AACrC,GACF;AAEA,EAAA,IAAI,MAAA,GAAS,YAAA,GAAeC,gBAAA,CAAY,IAAA,EAAM,YAAY,CAAA,GAAI,IAAA;AAC9D,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,MAAA,GAAS,UAAU,MAAM,CAAA;AAAA,EAC3B;AACA,EAAA,OAAO,MAAA;AACT","file":"vitest.cjs","sourcesContent":["import type { Plugin } from \"vite\";\r\n\r\nconst cssModuleStub = `\r\nconst styles = new Proxy({}, {\r\n  get: (_target, property) => typeof property === \"string\" ? property : undefined,\r\n});\r\nexport default styles;\r\n`;\r\n\r\n/**\r\n * 单测不解析 less，并为 CSS Modules 提供 identity stub\r\n * @public\r\n */\r\nexport function stubLessPlugin(): Plugin {\r\n  return {\r\n    name: \"stub-less\",\r\n    load(id) {\r\n      if (/\\.module\\.less(?:$|\\?)/.test(id)) {\r\n        return cssModuleStub;\r\n      }\r\n      if (/\\.less(?:$|\\?)/.test(id)) {\r\n        return \"\";\r\n      }\r\n    },\r\n  };\r\n}\r\n","import react from \"@vitejs/plugin-react\";\r\nimport { mergeConfig, type PluginOption } from \"vite\";\r\n\r\nimport { stubLessPlugin } from \"./plugins/stub-less.ts\";\r\n\r\nimport type { CreatePackageVitestConfigOptions } from \"./vitest-types.ts\";\r\nimport type { ViteUserConfig as VitestUserConfig } from \"vitest/config\";\r\n\r\n/**\r\n * 组装包级 Vitest 配置。\r\n *\r\n * 合并顺序：`base(options) → mergeConfig(base, vite) → configure(final)`\r\n */\r\nexport function createPackageVitestConfig(\r\n  options: CreatePackageVitestConfigOptions,\r\n): VitestUserConfig {\r\n  const {\r\n    packageRoot,\r\n    alias,\r\n    react: enableReact = false,\r\n    stubLess = false,\r\n    environment = \"happy-dom\",\r\n    include = [\"test/**/*.test.ts\"],\r\n    setupFiles,\r\n    plugins: extraPlugins = [],\r\n    vite: viteOverride,\r\n    configure,\r\n  } = options;\r\n\r\n  const plugins: PluginOption[] = [\r\n    ...(enableReact ? [react()] : []),\r\n    ...(stubLess ? [stubLessPlugin()] : []),\r\n    ...extraPlugins,\r\n  ];\r\n\r\n  const base: VitestUserConfig = {\r\n    root: packageRoot,\r\n    plugins,\r\n    resolve: {\r\n      alias,\r\n    },\r\n    test: {\r\n      environment,\r\n      include,\r\n      ...(setupFiles ? { setupFiles } : {}),\r\n    },\r\n  };\r\n\r\n  let merged = viteOverride ? mergeConfig(base, viteOverride) : base;\r\n  if (configure) {\r\n    merged = configure(merged);\r\n  }\r\n  return merged;\r\n}\r\n"]}

package/dist/vitest.d.cts

@@ -0,0 +1,4 @@
+export { createPackageVitestConfig } from './create-package-vitest-config.cjs';
+export { CreatePackageVitestConfigOptions } from './vitest-types.cjs';
+import 'vitest/config';
+import 'vite';

package/dist/vitest.d.ts

@@ -0,0 +1,4 @@
+export { createPackageVitestConfig } from './create-package-vitest-config.js';
+export { CreatePackageVitestConfigOptions } from './vitest-types.js';
+import 'vitest/config';
+import 'vite';

package/dist/vitest.js

@@ -0,0 +1,67 @@
+import react from '@vitejs/plugin-react';
+import { mergeConfig } from 'vite';
+
+// src/create-package-vitest-config.ts
+
+// src/plugins/stub-less.ts
+var cssModuleStub = `
+const styles = new Proxy({}, {
+  get: (_target, property) => typeof property === "string" ? property : undefined,
+});
+export default styles;
+`;
+function stubLessPlugin() {
+  return {
+    name: "stub-less",
+    load(id) {
+      if (/\.module\.less(?:$|\?)/.test(id)) {
+        return cssModuleStub;
+      }
+      if (/\.less(?:$|\?)/.test(id)) {
+        return "";
+      }
+    }
+  };
+}
+
+// src/create-package-vitest-config.ts
+function createPackageVitestConfig(options) {
+  const {
+    packageRoot,
+    alias,
+    react: enableReact = false,
+    stubLess = false,
+    environment = "happy-dom",
+    include = ["test/**/*.test.ts"],
+    setupFiles,
+    plugins: extraPlugins = [],
+    vite: viteOverride,
+    configure
+  } = options;
+  const plugins = [
+    ...enableReact ? [react()] : [],
+    ...stubLess ? [stubLessPlugin()] : [],
+    ...extraPlugins
+  ];
+  const base = {
+    root: packageRoot,
+    plugins,
+    resolve: {
+      alias
+    },
+    test: {
+      environment,
+      include,
+      ...setupFiles ? { setupFiles } : {}
+    }
+  };
+  let merged = viteOverride ? mergeConfig(base, viteOverride) : base;
+  if (configure) {
+    merged = configure(merged);
+  }
+  return merged;
+}
+
+export { createPackageVitestConfig };
+//# sourceMappingURL=vitest.js.map
+//# sourceMappingURL=vitest.js.map

package/dist/vitest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugins/stub-less.ts","../src/create-package-vitest-config.ts"],"names":[],"mappings":";;;;;;AAEA,IAAM,aAAA,GAAgB;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAWf,SAAS,cAAA,GAAyB;AACvC,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,WAAA;AAAA,IACN,KAAK,EAAA,EAAI;AACP,MAAA,IAAI,wBAAA,CAAyB,IAAA,CAAK,EAAE,CAAA,EAAG;AACrC,QAAA,OAAO,aAAA;AAAA,MACT;AACA,MAAA,IAAI,gBAAA,CAAiB,IAAA,CAAK,EAAE,CAAA,EAAG;AAC7B,QAAA,OAAO,EAAA;AAAA,MACT;AAAA,IACF;AAAA,GACF;AACF;;;ACZO,SAAS,0BACd,OAAA,EACkB;AAClB,EAAA,MAAM;AAAA,IACJ,WAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAO,WAAA,GAAc,KAAA;AAAA,IACrB,QAAA,GAAW,KAAA;AAAA,IACX,WAAA,GAAc,WAAA;AAAA,IACd,OAAA,GAAU,CAAC,mBAAmB,CAAA;AAAA,IAC9B,UAAA;AAAA,IACA,OAAA,EAAS,eAAe,EAAC;AAAA,IACzB,IAAA,EAAM,YAAA;AAAA,IACN;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,OAAA,GAA0B;AAAA,IAC9B,GAAI,WAAA,GAAc,CAAC,KAAA,EAAO,IAAI,EAAC;AAAA,IAC/B,GAAI,QAAA,GAAW,CAAC,cAAA,EAAgB,IAAI,EAAC;AAAA,IACrC,GAAG;AAAA,GACL;AAEA,EAAA,MAAM,IAAA,GAAyB;AAAA,IAC7B,IAAA,EAAM,WAAA;AAAA,IACN,OAAA;AAAA,IACA,OAAA,EAAS;AAAA,MACP;AAAA,KACF;AAAA,IACA,IAAA,EAAM;AAAA,MACJ,WAAA;AAAA,MACA,OAAA;AAAA,MACA,GAAI,UAAA,GAAa,EAAE,UAAA,KAAe;AAAC;AACrC,GACF;AAEA,EAAA,IAAI,MAAA,GAAS,YAAA,GAAe,WAAA,CAAY,IAAA,EAAM,YAAY,CAAA,GAAI,IAAA;AAC9D,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,MAAA,GAAS,UAAU,MAAM,CAAA;AAAA,EAC3B;AACA,EAAA,OAAO,MAAA;AACT","file":"vitest.js","sourcesContent":["import type { Plugin } from \"vite\";\r\n\r\nconst cssModuleStub = `\r\nconst styles = new Proxy({}, {\r\n  get: (_target, property) => typeof property === \"string\" ? property : undefined,\r\n});\r\nexport default styles;\r\n`;\r\n\r\n/**\r\n * 单测不解析 less，并为 CSS Modules 提供 identity stub\r\n * @public\r\n */\r\nexport function stubLessPlugin(): Plugin {\r\n  return {\r\n    name: \"stub-less\",\r\n    load(id) {\r\n      if (/\\.module\\.less(?:$|\\?)/.test(id)) {\r\n        return cssModuleStub;\r\n      }\r\n      if (/\\.less(?:$|\\?)/.test(id)) {\r\n        return \"\";\r\n      }\r\n    },\r\n  };\r\n}\r\n","import react from \"@vitejs/plugin-react\";\r\nimport { mergeConfig, type PluginOption } from \"vite\";\r\n\r\nimport { stubLessPlugin } from \"./plugins/stub-less.ts\";\r\n\r\nimport type { CreatePackageVitestConfigOptions } from \"./vitest-types.ts\";\r\nimport type { ViteUserConfig as VitestUserConfig } from \"vitest/config\";\r\n\r\n/**\r\n * 组装包级 Vitest 配置。\r\n *\r\n * 合并顺序：`base(options) → mergeConfig(base, vite) → configure(final)`\r\n */\r\nexport function createPackageVitestConfig(\r\n  options: CreatePackageVitestConfigOptions,\r\n): VitestUserConfig {\r\n  const {\r\n    packageRoot,\r\n    alias,\r\n    react: enableReact = false,\r\n    stubLess = false,\r\n    environment = \"happy-dom\",\r\n    include = [\"test/**/*.test.ts\"],\r\n    setupFiles,\r\n    plugins: extraPlugins = [],\r\n    vite: viteOverride,\r\n    configure,\r\n  } = options;\r\n\r\n  const plugins: PluginOption[] = [\r\n    ...(enableReact ? [react()] : []),\r\n    ...(stubLess ? [stubLessPlugin()] : []),\r\n    ...extraPlugins,\r\n  ];\r\n\r\n  const base: VitestUserConfig = {\r\n    root: packageRoot,\r\n    plugins,\r\n    resolve: {\r\n      alias,\r\n    },\r\n    test: {\r\n      environment,\r\n      include,\r\n      ...(setupFiles ? { setupFiles } : {}),\r\n    },\r\n  };\r\n\r\n  let merged = viteOverride ? mergeConfig(base, viteOverride) : base;\r\n  if (configure) {\r\n    merged = configure(merged);\r\n  }\r\n  return merged;\r\n}\r\n"]}

package/docs/README.md

@@ -0,0 +1,15 @@
+# 文档目录
+
+Vite / Vitest 配置工厂与插件
+
+| 模块                                                       | 说明                                                                                                                      |
+| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| [API](./api.md)                                            | 工厂（应用 / 组件库 / Vitest）、`alias`（Vite 原生）、插件与自定义合并                                                    |
+| [相对 webpack-config](./webpack-gap.md)                    | 已对齐项、真实缺口、Vite 原生覆盖与刻意不搬的耦合                                                                         |
+| [从 webpack-config 迁移](./migration-from-webpack.md)      | 页面应用（`createPageConfig` → `createAppViteConfig`）与组件库（`createLibConfig` → `createLibraryViteConfig`）的落地步骤 |
+| [相对 Vite 仓 `@ccc/vite-config`](./vs-ccc-vite-config.md) | 2026-08-28 现状：能力已对齐；剩余为包名 / catalog / 覆盖率门槛                                                            |
+| [`PUBLIC_PATH` 回灌记录](./sync-public-path.md)            | 从 Vite 仓移植 JS `import.meta.env.PUBLIC_PATH` 与 `./client`（已实施）                                                   |
+| [发布](../README.md#发布)                                  | 构建产物、打包检查与 npm 发布命令                                                                                         |
+| [审查报告](../REVIEW.md)                                   | 当前仍开问题、测试缺口与建议处理顺序                                                                                      |
+
+返回 [包说明](../README.md)。

package/docs/abt-management-ui/vite.config.mts

@@ -0,0 +1,226 @@
+// abt-management-ui
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { defineConfig, transformWithOxc } from "vite";
+import { viteCommonjs } from "@originjs/vite-plugin-commonjs";
+
+import { createAppViteConfig } from "@hzab/vite-config";
+
+const rootDir = path.dirname(fileURLToPath(import.meta.url));
+
+// 读取 package.json 版本号，用于注入 process.env.PACKAGE_VERSION / process.env.APP_VERSION，
+// 对齐 @hzab/webpack-config 的 DefinePlugin 默认注入（webpack 侧会暴露 PACKAGE_VERSION）。
+const pkgJson = JSON.parse(fs.readFileSync(path.resolve(rootDir, "package.json"), "utf8"));
+const PACKAGE_VERSION = pkgJson.version || "";
+
+// 项目与 @hzab/* 源码包中大量存在「扩展名为 .js 却写了 JSX」的文件。webpack 由 babel-loader
+// 转译；Vite 8 (rolldown) 的 transform 由 oxc 接管，OxcOptions 已 Omit lang（按扩展名推断），
+// 默认对 .js 不解析 JSX，会报 "Unexpected JSX expression"（含 node_modules 里的来源包，不可改文件）。
+// 这里用 vite 的 transformWithOxc 把 .js 以 jsx lang 预转换，覆盖 src 与 node_modules。
+const jsxInJsPlugin = {
+  name: "jsx-in-js",
+  enforce: "pre" as const,
+  async transform(code: string, id: string) {
+    if (!id.endsWith(".js")) return;
+    if (id.includes("/node_modules/.vite/")) return; // 预构建产物不重复处理
+    try {
+      return await transformWithOxc(code, id, {
+        lang: "jsx",
+        sourceType: "module",
+        jsxRuntime: "automatic",
+        jsxImportSource: "react",
+      } as any);
+    } catch {
+      return; // 转换失败交回后续管线（可能是已无 JSX 的正常 .js）
+    }
+  },
+};
+
+// turf-jsts 是传递依赖（经 @turf/buffer），pnpm 不会把它软链到顶层 node_modules，
+// 因此无法用 optimizeDeps.include 预构建；这里直接指向其原生 ESM 产物 jsts.mjs，
+// 使 @turf/buffer 的 `import { BufferOp } from 'turf-jsts'` 能拿到具名导出。
+function resolveTurfJstsEsm() {
+  const pnpmRoot = path.resolve(rootDir, "node_modules/.pnpm");
+  const entry = fs.readdirSync(pnpmRoot).find((name) => name.startsWith("turf-jsts@"));
+  if (!entry) {
+    throw new Error("[vite-config] turf-jsts not found in node_modules/.pnpm");
+  }
+  return path.resolve(pnpmRoot, entry, "node_modules/turf-jsts/jsts.mjs");
+}
+
+// c-formily-antd 存在仅含 lib(CJS) 的实例（如 2.3.1）：其 `__exportStar` 重导出在 Vite
+// 预构建时无法被静态识别，导致 `import { useFormLayout } from 'c-formily-antd'` 等具名导入
+// 报 "does not provide an export named '...'"。统一改写到一个带 esm/ 的实例（如 2.3.5），
+// 走原生 ESM 的 `export *` 重导出，具名导出即可被正确解析。
+function resolveCFormilyAntdEsm() {
+  const pnpmRoot = path.resolve(rootDir, "node_modules/.pnpm");
+  const entries = fs.readdirSync(pnpmRoot).filter((name) => name.startsWith("c-formily-antd@"));
+  for (const entry of entries) {
+    const esmDir = path.resolve(pnpmRoot, entry, "node_modules/c-formily-antd/esm");
+    if (fs.existsSync(esmDir)) return esmDir;
+  }
+  throw new Error(
+    "[vite-config] no c-formily-antd instance with an esm build found in node_modules/.pnpm",
+  );
+}
+const cFormilyAntdEsmDir = resolveCFormilyAntdEsm();
+
+// quickselect 是传递依赖（经 rbush / geojson-rbush / ol / @cesium/engine 等），pnpm 不会把它
+// 软链到顶层 node_modules，因此无法用 optimizeDeps.include 预构建（同 turf-jsts）。其 1.x/2.x
+// 是 UMD 包裹器：`(function (global, factory) { ... }(this, ...))`，顶层 `this` 在被 Vite 当作 ESM
+// 服务时是 undefined，浏览器执行抛 `Cannot set properties of undefined (setting 'quickselect')`。
+// 统一改写到一个带 `"type": "module"` 的原生 ESM 实例（如 3.0.0），走 `export default`。
+// 各版本签名一致（quickselect(arr, k, left, right, compare)），跨版本混用安全。
+function resolveQuickselectEsm() {
+  const pnpmRoot = path.resolve(rootDir, "node_modules/.pnpm");
+  const entries = fs.readdirSync(pnpmRoot).filter((name) => name.startsWith("quickselect@"));
+  for (const entry of entries) {
+    const pkgRoot = path.resolve(pnpmRoot, entry, "node_modules/quickselect");
+    const pkgJson = path.join(pkgRoot, "package.json");
+    if (!fs.existsSync(pkgJson)) continue;
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgJson, "utf8"));
+      // 仅认 `"type": "module"` 的实例：仅带 module/index.js 而缺 type 的（如 2.x），
+      // 其 index.js 会被 Vite 按最近 package.json 的 type 判定为 CJS，`export default` 会被误解析。
+      if (pkg.type !== "module") continue;
+      const entryFile = path.resolve(pkgRoot, pkg.module || pkg.main || "index.js");
+      if (fs.existsSync(entryFile)) return entryFile;
+    } catch {
+      /* 单个实例解析失败则跳过，继续找下一个 */
+    }
+  }
+  throw new Error(
+    '[vite-config] no quickselect instance with "type": "module" found in node_modules/.pnpm',
+  );
+}
+const quickselectEsm = resolveQuickselectEsm();
+
+// 使用最新包解决
+// @hzab/classnames-utils 只有 webpack 打的 UMD CJS 构建（lib/index.js，module.exports = t()，
+// 用 e.d getter 定义具名导出）。Vite dev 裸供该 CJS 时无法静态识别 NO_PREFIX_TYPE / PREFIX_TYPE /
+// STYLES_TYPE / ClassNameUtils 等具名导出，报 "does not provide an export named 'NO_PREFIX_TYPE'"。
+// 其 src/ 是干净的原生 TS ESM（export const NO_PREFIX_TYPE / export class ClassNameUtils /
+// export default），直接 alias 到 src/index.ts 走原生 ESM，具名导出即可被正确解析。
+// function resolveClassnamesUtilsSrc() {
+//   const pnpmRoot = path.resolve(rootDir, "node_modules/.pnpm");
+//   const entries = fs
+//     .readdirSync(pnpmRoot)
+//     .filter((name) => name.startsWith("@hzab+classnames-utils@"));
+//   for (const entry of entries) {
+//     const srcEntry = path.resolve(
+//       pnpmRoot,
+//       entry,
+//       "node_modules/@hzab/classnames-utils/src/index.ts",
+//     );
+//     if (fs.existsSync(srcEntry)) return srcEntry;
+//   }
+//   throw new Error(
+//     "[vite-config] no @hzab/classnames-utils src/index.ts found in node_modules/.pnpm",
+//   );
+// }
+// const classnamesUtilsSrc = resolveClassnamesUtilsSrc();
+
+export default defineConfig(({ command, mode }) =>
+  createAppViteConfig({
+    rootDir,
+    command,
+    mode,
+    alias: {
+      "@": path.resolve(rootDir, "./src"),
+      "@assets": path.resolve(rootDir, "./src/assets"),
+      "@packages": path.resolve(rootDir, "./packages"),
+      // 对齐旧 webpack alias（config/webpack.config.js）：代码里仍以该名称引用本地 packages
+      "hzab-schema-form-render": path.resolve(rootDir, "packages/pc/form-render"),
+      "hzab-schema-list-render": path.resolve(rootDir, "packages/pc/list-render"),
+      // '@packages': ..., '@assets': ..., '@service': ..., // 原 resolve.alias
+      // 把 c-formily-antd 改写到一个带 esm/ 的实例（见 resolveCFormilyAntdEsm）：
+      //   - `c-formily-antd`       -> esm/index.js
+      //   - `c-formily-antd/lib/*` -> esm/*   （__builtins__、各模块等）
+      "c-formily-antd/lib": cFormilyAntdEsmDir,
+      "c-formily-antd": path.join(cFormilyAntdEsmDir, "index.js"),
+      // 指向原生 ESM 源，解决 "does not provide an export named 'NO_PREFIX_TYPE'"
+      // "@hzab/classnames-utils": classnamesUtilsSrc,
+      // 指向原生 ESM 产物，解决 "does not provide an export named 'BufferOp'"
+      "turf-jsts": resolveTurfJstsEsm(),
+      // 指向原生 ESM 产物，解决 rbush 依赖的 1.x/2.x UMD 包裹器顶层 `this` 在 ESM 下为 undefined 的报错
+      quickselect: quickselectEsm,
+    },
+    // 原 devServer.proxy
+    devProxy: { "/api": "http://localhost:13000" },
+    // 原 lessLoaderOptions
+    less: {
+      // additionalData: `@import url(@/size.less);`,
+      // modifyVars: { '@primary-color': '#1890ff' },
+      javascriptEnabled: true, // formily 内联 JS 才需要（Vite 侧默认 false，见第 8 节）
+      resolveTilde: true, // 开启 `~` 解析（默认关闭，项目含 `~antd` 时开）
+    },
+    // 原 isHash + hashPublicPath
+    hashDeploy: mode !== "development",
+    // hash 子目录名的时间戳格式：默认 epoch（毫秒时间戳）；datetime 为 YYYY-MM-DD-HH-mm-ss（年月日时分秒）
+    hashTimestamp: "datetime",
+    hashCleanup: { keep: 3 }, // 可选；默认永久保留旧版本
+    // base: 'https://test.com/aaa/', // 若 hashPublicPath 是固定 CDN 前缀
+    // 原 public-config 多环境复制；glob 键优先 PUBLIC_CONF_DIR（对齐 webpack 多环境目录名），未设置时回退 Vite mode
+    publicConfig: { mode: process.env.PUBLIC_CONF_DIR || mode, dest: "public/config" }, // 对齐 webpack 产物路径；默认产物 config/
+    // 注入 HTML 模板的 EJS 数据；仅 PUBLIC_PATH 由工厂始终注入，其余键（如 APP_TITLE）必须在此声明
+    htmlData: { APP_TITLE: "My App" },
+    svgr: true, // 启用 svg 组件通道，import 需从 ?svgEle 改为 ?react
+    // 关闭 React Compiler：babel-plugin-react-compiler 未安装，build 时默认的
+    // "build-only" 会因找不到该包而失败；如需启用，先安装依赖再改回 "build-only"。
+    reactCompiler: false,
+    plugins: [
+      jsxInJsPlugin,
+      viteCommonjs({
+        // 可选：显式指定需要转换的包名
+        include: [
+          "classnames",
+          "dayjs",
+          "rbush",
+          "earcut",
+          "skmeans",
+          "turf-jsts", // 保留
+          "polygon-clipping",
+          "density-clustering",
+          "point-in-polygon",
+          "object-assign",
+          "hoist-non-react-statics",
+          "prop-types",
+        ],
+      }),
+    ],
+    vite: {
+      server: { port: 3000 }, // 原 devServer.port
+      // 老 IE 星号属性 hack（如 *zoom）会被 lightningcss 当语法错误中断生产构建；
+      // errorRecovery 会剥离这些早已失效的 hack，使构建继续。
+      css: {
+        lightningcss: {
+          errorRecovery: true,
+        },
+      },
+      // react-is / deep-equal / geojson-equality 都是 CJS-only 的共享传递依赖。把它们提升为顶层依赖
+      // （见 package.json）后，这里显式 include，强制被 Vite 预构建为 ESM，避免被当作外部依赖裸供
+      // （浏览器报 "module is not defined" / "require is not defined"）。
+      // deep-equal / geojson-equality 的整个 es-shims CJS 闭包（object-keys、regexp.prototype.flags、
+      // define-properties 等）会随之一并内联，不再逐个裸供。
+      optimizeDeps: {
+        include: ["react-is", "deep-equal", "geojson-equality"],
+      },
+      // 原 DefinePlugin / processEnv：webpack 由 DefinePlugin 全局注入 process.env.*，
+      // 而 Vite 默认仅替换 process.env.NODE_ENV（浏览器端没有全局 process），其余
+      // process.env.* 会残留并抛 "ReferenceError: process is not defined"（如 src/utils/axios.js）。
+      // 此处对齐 @hzab/webpack-config 的默认注入集合（WEBPACK_ENV / WEBPACK_PUBLIC_PATH /
+      // PACKAGE_VERSION）与用户自定义 processEnv（BUSINESS_PLATFORM）。
+      define: {
+        "process.env.BUSINESS_PLATFORM": JSON.stringify(process.env.BUSINESS_PLATFORM || "unknown"),
+        "process.env.WEBPACK_ENV": JSON.stringify(mode),
+        // Vite 无 publicPath 概念；置空使 axios 里 public 资源请求走「不加 baseURL」分支，
+        // 即 process.env.WEBPACK_PUBLIC_PATH 为 falsy 时落到 /^(\.?\/)*public\// 判断。
+        "process.env.WEBPACK_PUBLIC_PATH": JSON.stringify(""),
+        "process.env.PACKAGE_VERSION": JSON.stringify(PACKAGE_VERSION),
+        // webpack 默认不注入 APP_VERSION（原为 undefined）；补 version 使水印呈现版本号
+        "process.env.APP_VERSION": JSON.stringify(PACKAGE_VERSION),
+      },
+    },
+  }),
+);