befly-vite 1.40.0 → 1.42.0

package/README.md

@@ -82,17 +82,18 @@ export default createBeflyViteConfig();
 8. `build.assetsDir = "assets"`
 9. `build.cssMinify = "lightningcss"`
 10. `css.transformer = "lightningcss"`
-11. 默认 CSS 浏览器基线：Chrome 107 / Edge 107 / Firefox 104 / Safari 16.0
+11. 默认 CSS 浏览器基线：Chrome 107 / Edge 107 / Firefox 104 / Safari 16.010. 默认启用 `@vitejs/plugin-legacy` 对旧浏览器做 JS polyfill
 
 ### 参数说明
 
-| 参数           | 类型                 | 默认值          | 作用                                                 |
-| -------------- | -------------------- | --------------- | ---------------------------------------------------- |
-| `root`         | `string`             | `process.cwd()` | 项目根目录，用于解析 `src`、扫描 `views` 和生成别名  |
-| `analyzer`     | `boolean`            | `false`         | 是否启用打包分析，并输出到 `<root>/temp/analyzer`    |
-| `resolvers`    | `Object \| Object[]` | `undefined`     | 追加到组件自动注册中的自定义 resolver                |
-| `manualChunks` | `Function \| Object` | `undefined`     | 便捷写入 `build.rolldownOptions.output.manualChunks` |
-| `viteConfig`   | `Object`             | `{}`            | 最终合并到默认配置上的 Vite 原生配置                 |
+| 参数           | 类型                 | 默认值          | 作用                                                         |
+| -------------- | -------------------- | --------------- | ------------------------------------------------------------ |
+| `root`         | `string`             | `process.cwd()` | 项目根目录，用于解析 `src`、扫描 `views` 和生成别名          |
+| `analyzer`     | `boolean`            | `false`         | 是否启用打包分析，并输出到 `<root>/temp/analyzer`            |
+| `legacy`       | `boolean \| object`  | `true`          | 是否启用 `@vitejs/plugin-legacy`，默认自动 polyfill 旧浏览器 |
+| `resolvers`    | `Object \| Object[]` | `undefined`     | 追加到组件自动注册中的自定义 resolver                        |
+| `manualChunks` | `Function \| Object` | `undefined`     | 便捷写入 `build.rolldownOptions.output.manualChunks`         |
+| `viteConfig`   | `Object`             | `{}`            | 最终合并到默认配置上的 Vite 原生配置                         |
 
 ### 参数细节
 
@@ -129,6 +130,36 @@ export default createBeflyViteConfig({
 
 适合：分析打包体积、依赖拆分和大包来源。
 
+#### legacy
+
+默认启用 `@vitejs/plugin-legacy`，自动注入 `core-js` 等 polyfill，解决旧浏览器不支持 `Array.prototype.toSorted` 等现代 JS API 的问题。
+
+```javascript
+import { createBeflyViteConfig } from "befly-vite";
+
+// 使用默认配置
+export default createBeflyViteConfig();
+
+// 关闭 legacy
+export default createBeflyViteConfig({
+    legacy: false
+});
+
+// 自定义 legacy 配置
+export default createBeflyViteConfig({
+    legacy: {
+        targets: ["iOS >= 14", "Safari >= 14", "Chrome >= 109"],
+        modernPolyfills: true
+    }
+});
+```
+
+说明：
+
+1. 默认目标为 `["defaults", "not IE 11"]`，并开启 `modernPolyfills`。
+2. 传 `false` 可完全关闭 legacy 插件，减少构建产物体积。
+3. 传对象时，会与默认配置完全替换，而不是合并。
+
 #### resolvers
 
 `befly-vite` 默认内置：
@@ -527,7 +558,7 @@ const finalRoutes = Layouts(routes, "/dashboard", function (layoutName) {
 
 ### 最常见脚本写法
 
-页面项目自己的 `package.json` 在这里主要只保留运行脚本；在 Befly 仓库内，`lint` / `format` 的配置文件、根脚本和提交钩子统一跟随仓库根 `oxfmt.config.js` / `oxlint.config.ts` 与共享 Oxc 基线，不要在基于 `befly-vite` 的页面包里再复制第二套可执行 Oxc 配置。
+页面项目自己的 `package.json` 在这里主要只保留运行脚本；在 Befly 仓库内，`lint` / `format` 的配置文件、根脚本和提交钩子统一跟随仓库根 `oxfmt.config.js` / `oxlint.config.js` 与共享 Oxc 基线，不要在基于 `befly-vite` 的页面包里再复制第二套可执行 Oxc 配置。
 
 ```json
 {

package/index.js

@@ -2,6 +2,7 @@ import { existsSync, realpathSync } from "node:fs";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
+import legacyPlugin from "@vitejs/plugin-legacy";
 import vue from "@vitejs/plugin-vue";
 import { TDesignResolver } from "unplugin-vue-components/resolvers";
 import Components from "unplugin-vue-components/vite";
@@ -18,6 +19,10 @@ const DEFAULT_LIGHTNINGCSS_TARGETS = {
     ios_saf: 16 << 16,
     safari: 16 << 16
 };
+const DEFAULT_LEGACY_OPTIONS = {
+    targets: ["defaults", "not IE 11"],
+    modernPolyfills: true
+};
 
 function normalizeResolvers(resolvers) {
     if (resolvers === null || resolvers === undefined) {
@@ -71,6 +76,7 @@ export function createBeflyViteConfig(options = {}) {
         //
         root,
         analyzer = false,
+        legacy = true,
         resolvers,
         manualChunks,
         viteConfig = {}
@@ -102,6 +108,10 @@ export function createBeflyViteConfig(options = {}) {
         })
     );
     plugins.push(createComponentsPlugin({ resolvers: resolvers }));
+    if (legacy !== false) {
+        const legacyOptions = legacy === true ? DEFAULT_LEGACY_OPTIONS : legacy;
+        plugins.push(...legacyPlugin(legacyOptions));
+    }
     if (analyzer) {
         plugins.push(
             bundleAnalyzer({

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "befly-vite",
-    "version": "1.40.0",
+    "version": "1.42.0",
     "gitHead": "282f7accca9c8d55956a5490c0365cce4a1ad90d",
     "private": false,
     "description": "Befly Vite 配置预设和插件集合",
@@ -37,10 +37,11 @@
         "registry": "https://registry.npmjs.org"
     },
     "dependencies": {
+        "@vitejs/plugin-legacy": "^6.1.0",
         "@vitejs/plugin-vue": "^6.0.7",
         "sass-embedded": "^1.100.0",
         "unplugin-vue-components": "^32.1.0",
-        "vite": "^8.1.3",
+        "vite": "^8.1.4",
         "vite-bundle-analyzer": "^1.3.8",
         "vue-router": "^5.1.0"
     },