befly-vite 1.6.3 → 1.6.12

package/README.md

@@ -1,13 +1,20 @@
 # befly-vite
 
-Befly Vite 配置预设和插件集合，专为 Vue 3 项目优化。
+`befly-vite` 是 Befly 后台项目的 Vite 预设包，负责把项目约定、常用插件和 Vite 原生配置组合在一起。
 
-## 特性
+它目前提供 4 类能力：
 
-- ✅ 开箱即用的 Vite + Vue 3 配置
-- ✅ 集成常用插件（路由、自动导入、图标等）
-- ✅ 优化的构建配置（分包、压缩、分析）
-- ✅ 支持自定义扩展
+1. Vite 配置侧的 `createBeflyViteConfig()`
+2. Vite 配置侧的 `scanViews()`
+3. 浏览器运行时的 `Layouts()`
+4. CLI 入口 `befly-vite`
+
+## 适用场景
+
+- 想在后台管理项目里直接复用 Befly 约定的 Vite 默认配置
+- 想自动扫描 `src/views` 和 `befly-admin-ui/views`
+- 想复用 TDesign 相关的自动导入、组件自动注册和图标规则
+- 想保留 Vite 原生 `viteConfig` 作为统一扩展出口
 
 ## 安装
 
@@ -15,9 +22,44 @@ Befly Vite 配置预设和插件集合，专为 Vue 3 项目优化。
 bun add -d befly-vite vite
 ```
 
-## 使用
+如果项目本身还没安装运行时依赖，通常还需要自行安装 Vue 侧依赖，例如：
+
+```bash
+bun add vue vue-router pinia tdesign-vue-next tdesign-icons-vue-next
+```
+
+## 导出说明
+
+### Vite 配置侧
+
+在 `vite.config.js` 里使用：
+
+```javascript
+import { createBeflyViteConfig, scanViews } from "befly-vite";
+```
+
+可用导出：
+
+- `createBeflyViteConfig`
+- `scanViews`
+
+### 浏览器运行时
+
+在前端运行时代码里使用：
+
+```javascript
+import { Layouts } from "befly-vite";
+```
+
+可用导出：
+
+- `Layouts`
 
-### 基础用法
+## createBeflyViteConfig
+
+`createBeflyViteConfig(options)` 是主入口，用来生成 Befly 项目的 Vite 配置。
+
+### 最小用法
 
 ```javascript
 // vite.config.js
@@ -26,9 +68,164 @@ import { createBeflyViteConfig } from "befly-vite";
 export default createBeflyViteConfig();
 ```
 
-> 提示：befly-admin-ui 的 `views` 路由会自动排除 `**/components/**`。
+### 默认内置内容
+
+调用后默认会包含以下能力：
+
+1. `vue-router/vite` 路由扫描插件
+2. `@vitejs/plugin-vue`
+3. `unplugin-auto-import`
+4. `unplugin-vue-components`
+5. `@` 指向项目 `src`
+6. `server.open = false`
+7. `server.hmr = true`
+8. `build.outDir = "dist"`
+9. `build.assetsDir = "assets"`
+10. `build.cssMinify = "lightningcss"`
+11. `css.transformer = "lightningcss"`
+12. 默认 CSS 浏览器基线：Chrome 107 / Edge 107 / Firefox 104 / Safari 16.0
+
+### 参数说明
+
+| 参数           | 类型                 | 默认值          | 作用                                                 |
+| -------------- | -------------------- | --------------- | ---------------------------------------------------- |
+| `root`         | `string`             | `process.cwd()` | 项目根目录，用于解析 `src`、扫描 `views` 和生成别名  |
+| `devtool`      | `boolean`            | `false`         | 是否启用 `vite-plugin-vue-devtools`                  |
+| `analyzer`     | `boolean`            | `false`         | 是否启用打包分析，并输出到 `<root>/temp/analyzer`    |
+| `resolvers`    | `Object \| Object[]` | `undefined`     | 追加到自动导入和组件自动注册中的自定义 resolver      |
+| `manualChunks` | `Function \| Object` | `undefined`     | 便捷写入 `build.rolldownOptions.output.manualChunks` |
+| `viteConfig`   | `Object`             | `{}`            | 最终合并到默认配置上的 Vite 原生配置                 |
+
+### 参数细节
+
+#### root
+
+`root` 决定这些行为的基准目录：
+
+1. `@` 别名指向哪个 `src`
+2. `scanViews()` 扫哪个项目目录
+3. 打包分析文件输出到哪个 `temp`
+
+最常见写法：
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url))
+});
+```
+
+#### devtool
+
+开启后会额外注入 `vite-plugin-vue-devtools`。
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    devtool: true
+});
+```
+
+适合：本地调试组件树、路由和状态。
+
+#### analyzer
+
+开启后会额外注入 `vite-bundle-analyzer`，并把报告输出到项目的 `temp/analyzer`。
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    analyzer: true
+});
+```
+
+适合：分析打包体积、依赖拆分和大包来源。
+
+#### resolvers
+
+`befly-vite` 默认内置：
+
+1. TDesign Vue Next resolver
+2. TDesign 图标 resolver
+
+如果项目还想增加额外 resolver，可以通过 `resolvers` 追加。它会同时追加到：
+
+1. `unplugin-auto-import`
+2. `unplugin-vue-components`
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+import { ElementPlusResolver } from "unplugin-vue-components/resolvers";
+
+export default createBeflyViteConfig({
+    resolvers: [ElementPlusResolver()]
+});
+```
+
+说明：
+
+1. 默认的 TDesign resolver 不会被替换，只会追加新的 resolver
+2. 如果你传单个对象，也会自动转成数组处理
+
+#### manualChunks
+
+`manualChunks` 是一个便捷入口，会写入 `build.rolldownOptions.output.manualChunks`。
+
+适合：
+
+1. 只想快速传一个 `manualChunks`
+2. 不想为了简单分包额外展开完整的 `build` 配置
+
+如果还要同时配置 `output.entryFileNames`、`chunkFileNames`、`assetFileNames` 等其他构建输出项，推荐直接走 `viteConfig.build.rolldownOptions`。
+
+如果旧项目还在传 `viteConfig.build.rollupOptions`，在 Vite 8 下也还能继续工作；只是新配置更建议直接写 `build.rolldownOptions`。
+
+函数写法：
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    manualChunks: function (id) {
+        if (id.includes("tdesign-vue-next")) {
+            return "tdesign";
+        }
+
+        if (id.includes("node_modules")) {
+            return "vendor";
+        }
+    }
+});
+```
+
+对象写法：
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    manualChunks: {
+        vue: ["vue", "vue-router", "pinia"],
+        tdesign: ["tdesign-vue-next", "tdesign-icons-vue-next"]
+    }
+});
+```
+
+适合：
+
+1. 把大依赖稳定拆分出去
+2. 减少首屏主包体积
+3. 提升缓存命中率
+
+#### viteConfig
+
+`viteConfig` 是扩展出口，所有不值得再额外封装一层的配置，都建议直接从这里传入。
 
-### 自定义配置
+简单示例：
 
 ```javascript
 import { createBeflyViteConfig } from "befly-vite";
@@ -36,8 +233,6 @@ import { fileURLToPath } from "node:url";
 
 export default createBeflyViteConfig({
     root: fileURLToPath(new URL(".", import.meta.url)),
-
-    // 自定义配置
     viteConfig: {
         server: {
             port: 5600
@@ -46,6 +241,472 @@ export default createBeflyViteConfig({
 });
 ```
 
+适合放在这里的配置包括：
+
+1. `server.port`
+2. `server.proxy`
+3. `define`
+4. `build.sourcemap`
+5. `build.cssTarget`
+6. `css.lightningcss`
+7. `build.rolldownOptions`
+8. 其他任意 Vite 原生配置
+
+chunks 的推荐方式：
+
+1. 简单场景用顶层 `manualChunks`
+2. 需要完整控制输出结构时，用 `viteConfig.build.rolldownOptions`
+
+示例：
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+import { fileURLToPath } from "node:url";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url)),
+    viteConfig: {
+        build: {
+            rolldownOptions: {
+                output: {
+                    manualChunks: function (id) {
+                        if (id.includes("tdesign-vue-next") || id.includes("tdesign-icons-vue-next")) {
+                            return "tdesign";
+                        }
+
+                        if (id.includes("node_modules/vue") || id.includes("node_modules/vue-router") || id.includes("node_modules/pinia")) {
+                            return "framework";
+                        }
+                    },
+                    entryFileNames: "assets/[name]-[hash].js",
+                    chunkFileNames: "assets/[name]-[hash].js"
+                }
+            }
+        }
+    }
+});
+```
+
+## CSS 兼容配置
+
+`befly-vite` 不再提供单独的 `compat` 配置，CSS 兼容统一走 Vite 8 原生配置。
+
+### 默认行为
+
+默认内置：
+
+```javascript
+{
+    build: {
+        cssTarget: ["chrome107", "edge107", "firefox104", "safari16"],
+        cssMinify: "lightningcss"
+    },
+    css: {
+        transformer: "lightningcss",
+        lightningcss: {
+            targets: {
+                chrome: 107 << 16,
+                edge: 107 << 16,
+                firefox: 104 << 16,
+                ios_saf: 16 << 16,
+                safari: 16 << 16
+            }
+        }
+    }
+}
+```
+
+### 为什么同时有 `build.cssTarget` 和 `css.lightningcss.targets`
+
+1. `build.cssTarget` 控制 CSS 压缩输出目标
+2. `css.lightningcss.targets` 控制 Lightning CSS 的语法降级和前缀处理目标
+
+这两者默认保持一致。
+
+### 项目侧覆盖写法
+
+如果项目需要更高或更低的兼容基线，可以直接通过 `viteConfig` 覆盖。
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    viteConfig: {
+        build: {
+            cssTarget: ["chrome120", "edge120", "firefox120", "safari17"]
+        },
+        css: {
+            lightningcss: {
+                targets: {
+                    chrome: 120 << 16,
+                    edge: 120 << 16,
+                    firefox: 120 << 16,
+                    ios_saf: 17 << 16,
+                    safari: 17 << 16
+                },
+                drafts: {
+                    nesting: true
+                }
+            }
+        }
+    }
+});
+```
+
+说明：
+
+1. `viteConfig.build.cssTarget` 一旦传入，会直接覆盖默认值
+2. `viteConfig.css.lightningcss.targets` 一旦传入，也会直接覆盖默认值
+3. 其他 `css.lightningcss` 选项仍会与默认配置合并
+
+### 常见 CSS 配置案例
+
+#### 只改压缩目标
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    viteConfig: {
+        build: {
+            cssTarget: "safari16"
+        }
+    }
+});
+```
+
+#### 调整 Lightning CSS draft 能力
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    viteConfig: {
+        css: {
+            lightningcss: {
+                drafts: {
+                    nesting: true,
+                    customMedia: true
+                }
+            }
+        }
+    }
+});
+```
+
+#### 关闭 CSS 压缩
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    viteConfig: {
+        build: {
+            cssMinify: false
+        }
+    }
+});
+```
+
+## 路由扫描规则
+
+`befly-vite` 内部通过 `scanViews(appRoot)` 扫描视图目录，并交给 `vue-router/vite`。
+
+### 默认扫描来源
+
+1. `<root>/src/views`
+2. `<root>/node_modules/befly-admin-ui/views`
+
+其中 `befly-admin-ui/views` 会被挂到 `core/` 前缀下。
+
+### 默认排除规则
+
+两个目录都会排除：
+
+```text
+**/components/**
+```
+
+### 单独使用 scanViews
+
+如果项目要直接复用这套扫描规则，也可以单独调用：
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { scanViews } from "befly-vite";
+
+const appRoot = fileURLToPath(new URL(".", import.meta.url));
+const routesFolders = scanViews(appRoot);
+
+console.log(routesFolders);
+```
+
+返回值结构示例：
+
+```javascript
+[
+    {
+        src: "/absolute/path/to/src/views",
+        path: "",
+        exclude: ["**/components/**"]
+    },
+    {
+        src: "/absolute/path/to/node_modules/befly-admin-ui/views",
+        path: "core/",
+        exclude: ["**/components/**"]
+    }
+];
+```
+
+## 自动导入与组件自动注册规则
+
+### Auto Import
+
+默认会对以下文件启用自动导入：
+
+```text
+src/**/*.vue
+src/**/*.js
+```
+
+默认自动导入内容：
+
+1. `vue`
+2. `pinia`
+3. `vue-router` 的 auto imports
+4. 默认 TDesign resolver
+5. 你额外传入的 `resolvers`
+
+默认扫描目录：
+
+1. `src/utils`
+2. `src/plugins`
+3. `src/config`
+4. `src/hooks`
+
+### Components
+
+默认会对以下目录启用组件自动注册：
+
+1. `src/**/*.vue`
+2. `node_modules/befly-admin-ui/**/*.vue`
+
+默认内置 resolver：
+
+1. TDesign Vue Next resolver
+2. `tdesign-icons-vue-next` 图标 resolver
+3. 你额外传入的 `resolvers`
+
+说明：
+
+1. `src/components` 会被作为本地组件目录扫描
+2. addon 视图不在当前自动导入的 include 范围内，需要按项目规范手动导入
+
+## Layouts
+
+`Layouts(routes, rootRedirectPath, resolveLayoutComponent)` 用于浏览器运行时把 auto-routes 结果转换成带布局的最终路由。
+
+### 作用
+
+它会根据页面文件名里的 `_数字` 后缀决定使用哪个布局，并把普通路径段统一转换成短横线小写。
+
+例如：
+
+1. `userCenter/account_1.vue` -> `/user-center/account`，布局 `1`
+2. `newsDetail_2.vue` -> `/news-detail`，布局 `2`
+3. `guide/index_1.vue` -> `/guide`，布局 `1`
+
+### 基础示例
+
+```javascript
+import { Layouts } from "befly-vite";
+
+const routes = [
+    {
+        path: "userCenter",
+        children: [
+            {
+                path: "account_1",
+                component: () => import("./views/userCenter/account.vue")
+            },
+            {
+                path: "my_news",
+                component: () => import("./views/userCenter/my_news.vue")
+            }
+        ]
+    }
+];
+
+const finalRoutes = Layouts(routes, "/dashboard", function (layoutName) {
+    return layoutName ? `layout:${layoutName}` : "layout:default";
+});
+```
+
+### 参数说明
+
+| 参数                     | 类型       | 作用                                          |
+| ------------------------ | ---------- | --------------------------------------------- |
+| `routes`                 | `Array`    | auto-routes 产出的原始路由数组                |
+| `rootRedirectPath`       | `string`   | 根路径 `/` 的重定向目标；传空值则不注入重定向 |
+| `resolveLayoutComponent` | `Function` | 根据布局名返回布局组件                        |
+
+### Layouts 规则说明
+
+1. 动态参数段如 `:userId` 会保留原样
+2. 普通路径段会统一转成短横线小写
+3. 下划线 `_` 会转成 `-`
+4. 驼峰会转成短横线小写
+5. `_数字` 后缀只用于布局名，不会出现在最终路径里
+6. `index` 子页会折叠成父路径下的空子路径
+
+## CLI
+
+包内自带 `befly-vite` 命令，本质上是一个 Bun 环境下的 Vite 启动包装器，用来帮项目找到 `vite/bin/vite.js` 并转发参数。
+
+### 最常见脚本写法
+
+```json
+{
+    "scripts": {
+        "dev": "bunx --bun befly-vite",
+        "build": "bunx --bun befly-vite build",
+        "preview": "bunx --bun befly-vite preview"
+    }
+}
+```
+
+### 作用
+
+1. 自动定位 `vite` 可执行文件
+2. 用 Bun 转发执行 `vite`
+3. 保持项目脚本写法统一
+
+## 完整案例
+
+### 案例 1：最小后台项目
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url))
+});
+```
+
+### 案例 2：本地开发端口 + 调试工具
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url)),
+    devtool: true,
+    viteConfig: {
+        server: {
+            port: 5206
+        }
+    }
+});
+```
+
+### 案例 3：打包分析 + Vite 原生分包
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url)),
+    analyzer: true,
+    viteConfig: {
+        build: {
+            rolldownOptions: {
+                output: {
+                    manualChunks: function (id) {
+                        if (id.includes("tdesign-vue-next") || id.includes("tdesign-icons-vue-next")) {
+                            return "tdesign";
+                        }
+
+                        if (id.includes("node_modules")) {
+                            return "vendor";
+                        }
+                    }
+                }
+            }
+        }
+    }
+});
+```
+
+### 案例 4：自定义 CSS 浏览器兼容目标
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url)),
+    viteConfig: {
+        build: {
+            cssTarget: ["chrome120", "edge120", "firefox120", "safari17"]
+        },
+        css: {
+            lightningcss: {
+                targets: {
+                    chrome: 120 << 16,
+                    edge: 120 << 16,
+                    firefox: 120 << 16,
+                    ios_saf: 17 << 16,
+                    safari: 17 << 16
+                }
+            }
+        }
+    }
+});
+```
+
+### 案例 5：Vite 原生能力扩展
+
+```javascript
+import { fileURLToPath } from "node:url";
+import { createBeflyViteConfig } from "befly-vite";
+
+export default createBeflyViteConfig({
+    root: fileURLToPath(new URL(".", import.meta.url)),
+    viteConfig: {
+        define: {
+            __APP_NAME__: JSON.stringify("befly-admin")
+        },
+        build: {
+            sourcemap: true
+        },
+        server: {
+            proxy: {
+                "/api": {
+                    target: "http://127.0.0.1:3000",
+                    changeOrigin: true
+                }
+            }
+        }
+    }
+});
+```
+
+## 什么时候应该直接用 viteConfig
+
+如果某个能力本身已经是稳定的 Vite 原生配置，而且 `befly-vite` 没必要再包装一层，优先直接用 `viteConfig`。例如：
+
+1. `server.port`
+2. `server.proxy`
+3. `define`
+4. `build.sourcemap`
+5. `build.cssTarget`
+6. `build.cssMinify`
+7. `css.lightningcss`
+8. `resolve.alias`
+
 ## License
 
 Apache-2.0

package/index.js

@@ -39,20 +39,36 @@ function createVuePlugin() {
     });
 }
 
+function createTDesignResolver() {
+    return TDesignResolver({
+        library: "vue-next",
+        importStyle: "css"
+    });
+}
+
+function normalizeResolvers(resolvers) {
+    if (resolvers === null || resolvers === undefined) {
+        return [];
+    }
+
+    if (Array.isArray(resolvers)) {
+        return resolvers;
+    }
+
+    return [resolvers];
+}
+
 /**
  * 创建自动导入插件配置
  */
-function createAutoImportPlugin() {
+function createAutoImportPlugin(options = {}) {
+    const { resolvers } = options;
+
     return AutoImport({
         // 只给 admin 自身源码做自动导入；addon 视图强制手动导入
         include: [/[\\/]src[\\/].*\.(vue|js)$/],
         imports: ["vue", "pinia", VueRouterAutoImports],
-        resolvers: [
-            TDesignResolver({
-                library: "vue-next",
-                importStyle: "css"
-            })
-        ],
+        resolvers: [createTDesignResolver(), ...normalizeResolvers(resolvers)],
         dts: false,
         dirs: ["src/utils", "src/plugins", "src/config", "src/hooks"],
         vueTemplate: true
@@ -71,17 +87,13 @@ function resolveTDesignIcon(componentName) {
 /**
  * 创建组件自动导入插件配置
  */
-function createComponentsPlugin() {
+function createComponentsPlugin(options = {}) {
+    const { resolvers } = options;
+
     return Components({
         // 给 admin 自身源码和 befly-admin-ui 视图做组件自动注册；addon 视图强制手动导入
         include: [/[\\/]src[\\/].*\.vue$/, /[\\/]node_modules[\\/]befly-admin-ui[\\/].*\.vue$/],
-        resolvers: [
-            TDesignResolver({
-                library: "vue-next",
-                importStyle: "css"
-            }),
-            resolveTDesignIcon
-        ],
+        resolvers: [createTDesignResolver(), resolveTDesignIcon, ...normalizeResolvers(resolvers)],
         dirs: ["src/components"],
         deep: true,
         dts: false
@@ -99,8 +111,22 @@ function createAnalyzerPlugin(appRoot) {
     });
 }
 
-function createDevToolsPlugin() {
-    return VueDevTools();
+function createCssCompatConfig(viteConfig) {
+    const defaultCssTarget = ["chrome107", "edge107", "firefox104", "safari16"];
+    const defaultLightningCssTargets = {
+        chrome: 107 << 16,
+        edge: 107 << 16,
+        firefox: 104 << 16,
+        ios_saf: 16 << 16,
+        safari: 16 << 16
+    };
+
+    return {
+        cssTarget: viteConfig.build && Object.hasOwn(viteConfig.build, "cssTarget") ? viteConfig.build.cssTarget : defaultCssTarget,
+        lightningcss: {
+            targets: viteConfig.css && viteConfig.css.lightningcss && Object.hasOwn(viteConfig.css.lightningcss, "targets") ? viteConfig.css.lightningcss.targets : defaultLightningCssTargets
+        }
+    };
 }
 
 /**
@@ -109,8 +135,8 @@ function createDevToolsPlugin() {
  * @param {string} options.root - 项目根目录（可选）
  * @param {boolean} options.devtool - 是否启用 vite-plugin-vue-devtools（可选，默认 false）
  * @param {boolean} options.analyzer - 是否启用 vite-bundle-analyzer（可选，默认 false）
- * @param {Object} options.resolvers - 自定义 resolvers（可选）
- * @param {Function} options.manualChunks - 自定义分包配置（可选）
+ * @param {Object|Object[]} options.resolvers - 自定义 resolvers（可选）
+ * @param {Function|Object} options.manualChunks - 便捷分包配置，会写入 build.rolldownOptions.output.manualChunks（可选）
  * @param {Object} options.viteConfig - 用户自定义配置（可选）
  * @returns {Object} Vite 配置对象
  */
@@ -120,7 +146,8 @@ export function createBeflyViteConfig(options = {}) {
         root,
         devtool = false,
         analyzer = false,
-        resolvers = {},
+        resolvers,
+        manualChunks,
         viteConfig = {}
     } = options;
 
@@ -134,7 +161,7 @@ export function createBeflyViteConfig(options = {}) {
     plugins.push(createRouterPlugin({ routesFolders: routesFolders }));
     plugins.push(createVuePlugin());
     if (devtool) {
-        plugins.push(createDevToolsPlugin());
+        plugins.push(VueDevTools());
     }
     plugins.push(createAutoImportPlugin({ resolvers: resolvers }));
     plugins.push(createComponentsPlugin({ resolvers: resolvers }));
@@ -142,6 +169,8 @@ export function createBeflyViteConfig(options = {}) {
         plugins.push(createAnalyzerPlugin(appRoot));
     }
 
+    const cssCompatConfig = createCssCompatConfig(viteConfig);
+
     const baseConfig = defineConfig({
         base: "./",
 
@@ -160,7 +189,22 @@ export function createBeflyViteConfig(options = {}) {
 
         build: {
             outDir: "dist",
-            assetsDir: "assets"
+            assetsDir: "assets",
+            cssTarget: cssCompatConfig.cssTarget,
+            rolldownOptions:
+                manualChunks === undefined
+                    ? undefined
+                    : {
+                          output: {
+                              manualChunks: manualChunks
+                          }
+                      },
+            cssMinify: "lightningcss"
+        },
+
+        css: {
+            transformer: "lightningcss",
+            lightningcss: cssCompatConfig.lightningcss
         },
 
         optimizeDeps: {
@@ -168,7 +212,13 @@ export function createBeflyViteConfig(options = {}) {
         }
     });
 
-    return mergeConfig(baseConfig, viteConfig);
+    const finalConfig = mergeConfig(baseConfig, viteConfig);
+
+    if (viteConfig.build && Object.hasOwn(viteConfig.build, "cssTarget")) {
+        finalConfig.build.cssTarget = viteConfig.build.cssTarget;
+    }
+
+    return finalConfig;
 }
 
 /**
@@ -192,7 +242,7 @@ export function scanViews(appRoot = process.cwd()) {
         });
     }
 
-    // 2. 扫描 befly-admin-ui/views（框架内置视图）
+    // 2. 扫描 befly-admin-ui/views（框架内置视图）2
     if (existsSync(adminUiPath)) {
         const adminUiViewsPath = join(adminUiPath, "views");
         if (existsSync(adminUiViewsPath)) {

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "befly-vite",
-    "version": "1.6.3",
-    "gitHead": "169c7fddf0cd2d21c6910454e0f116d6cdcbdbc5",
+    "version": "1.6.12",
+    "gitHead": "b02b83ced3735d167d79254ba907eda8b02c5dc3",
     "private": false,
     "description": "Befly Vite 配置预设和插件集合",
     "keywords": [
@@ -41,9 +41,10 @@
         "sass": "^1.99.0",
         "unplugin-auto-import": "^21.0.0",
         "unplugin-vue-components": "^32.0.0",
-        "vite": "^8.0.12",
+        "vite": "^8.0.13",
         "vite-bundle-analyzer": "^1.3.8",
-        "vite-plugin-vue-devtools": "^8.1.2"
+        "vite-plugin-vue-devtools": "^8.1.2",
+        "vue-router": "^5.0.7"
     },
     "engines": {
         "bun": ">=1.3.0"