configs 构建配置包说明 ​

configs/ 目录存放 Monorepo 共享的构建与工具配置，供 sample 宿主应用和所有 Rock / Cornerstone 包复用。

包总览 ​

@grow-admin-config/vite ​

统一 Vite 构建配置包，宿主应用通过 createViteConfig 函数获取完整配置。

使用方式 ​

// sample/vite.config.ts
import { createViteConfig } from '@grow-admin-config/vite';
import { defineConfig } from 'vite';

export default defineConfig(async ({ command, mode }) => {
  return await createViteConfig(command, mode, process.cwd(), { preset: 'ele' });
});

preset 参数 ​

preset 决定构建时使用的 UI 库自动导入策略，必须与 projectSetting.componentLibrary 一致：

内置插件 ​

预构建 ​

根目录 pnpm install 后自动执行 pnpm stub，预构建此包：

pnpm --filter @grow-admin-config/vite prepack

@grow-admin-config/tsconfig ​

共享 TypeScript 配置，提供多场景 tsconfig 基座：

各 Rock / Cornerstone 包的 tsconfig.json 通过 extends 引用：

{
  "extends": "@grow-admin-config/tsconfig/common-module.json"
}

@grow-admin-plugins/unplugin-auto-import ​

自动导入插件，根据 preset 自动导入 Vue API 和 UI 库 API。

自动导入范围：

• vue：ref、computed、watch 等
• vue-router：useRouter、useRoute 等
• pinia：defineStore、storeToRefs 等
• UI 库 API（根据 preset）

@grow-admin-config/css-preprocess ​

CSS 预处理配置（PostCSS），处理样式兼容性。

// postcss.js
module.exports = {
  plugins: {
    // autoprefixer 等
  }
};

目录结构 ​

configs/
├── vite/
│   ├── src/
│   │   ├── index.ts           # createViteConfig 入口
│   │   ├── presets/
│   │   │   ├── ele.ts         # Element Plus preset
│   │   │   ├── naive.ts       # Naive UI preset
│   │   │   └── antd.ts        # Ant Design Vue preset
│   │   └── plugins/           # Vite 插件集合
│   ├── build.config.ts        # unbuild 配置
│   └── package.json
├── tsconfig/
│   ├── base.json
│   ├── common-module.json
│   └── server.json
├── grow-admin-autoimport/
│   └── src/                   # 自动导入插件源码
└── grow-admin-css-preprocess/
    └── postcss.js

MonoRepo 路径别名（#/） ​

configs/vite/src/plugins/monorepo.ts 为 DesignRock / DesignCornerstone 包解析 #/ 到包内 src/ 目录。业务模块中常见写法：

import { RouteList } from '#/routes'
import { registerDynamicRoutes } from '#/routes/registerDynamicRoutes'

自定义配置 ​

如果需要在宿主应用中扩展 Vite 配置，可以在 createViteConfig 返回后合并：

export default defineConfig(async ({ command, mode }) => {
  const config = await createViteConfig(command, mode, process.cwd(), { preset: 'ele' });
  return {
    ...config,
    server: {
      ...config.server,
      port: 3001,
    },
  };
});