feat: 构建lib瘦身

Author: wkylin

docs/BUILD_BASELINE.md

@@ -0,0 +1,25 @@
+## 构建瘦身与体积分布基线
+
+### 目标
+- 通过 Vite 构建产出组件库，并按需生成体积分布报告，作为后续瘦身的基线。
+- 保持默认构建轻量，只有显式开启分析时才生成报告文件。
+
+### 使用方式
+- 常规库构建：
+```bash
+npm run build:lib
+```
+- 生成 bundle 体积分布报告（treemap，含 gzip/brotli）：
+```bash
+npm run build:lib:analyze
+# 等价命令：npm run analyze:lib
+```
+输出：`dist-lib/bundle-report.html`。
+
+### 实现要点
+- `vite.config.lib.ts` 中集成 `rollup-plugin-visualizer`，用 `USE_ANALYZE=1` 控制是否启用，避免常规构建额外开销。
+- 报告文件随构建生成，可用于 PR 附件或本地对比。
+
+### 后续可选
+- 在 CI 中为 release 或特定分支自动生成报告并上传为构建工件。
+- 配置 size budget（如限制单 bundle 体积）并在超限时失败。

package.json

@@ -102,6 +102,8 @@
     "build-storybook": "storybook build -o storybook-static",
     "postbuild-storybook": "node ./scripts/add-storybook-base.js",
     "build:lib": "vite build -c vite.config.lib.ts",
+    "build:lib:analyze": "cross-env USE_ANALYZE=1 vite build -c vite.config.lib.ts",
+    "analyze:lib": "cross-env USE_ANALYZE=1 vite build -c vite.config.lib.ts",
     "prepublishOnly": "npm run build:lib",
     "pub": "npm publish --access public",
     "pub:beta": "npm publish --tag beta --access public"

vite.config.lib.ts

@@ -3,18 +3,33 @@ import react from '@vitejs/plugin-react'
 import dts from 'vite-plugin-dts'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { visualizer } from 'rollup-plugin-visualizer'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const useAnalyze = Boolean(process.env.USE_ANALYZE)
+
+const analyzePlugin =
+  useAnalyze &&
+  visualizer({
+    filename: 'dist-lib/bundle-report.html',
+    title: 'pro-react-admin library bundle',
+    gzipSize: true,
+    brotliSize: true,
+    template: 'treemap',
+  })
 
 export default defineConfig({
   plugins: [
     react(),
     dts({
       insertTypesEntry: true,
       tsconfigPath: './tsconfig.json',
-      include: ['src/components'],
+      // 需要覆盖 .module.less 声明（位于 src/vite-env.d.ts），因此包含整个 src
+      include: ['src'],
     }),
-  ],
+    // 仅在 USE_ANALYZE=1 时生成体积分布报告
+    analyzePlugin,
+  ].filter(Boolean),
   resolve: {
     alias: {
       '@': path.resolve(__dirname, 'src'),