vite-plugin-ops 0.1.1 → 0.1.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) suileyan
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) suileyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,409 +1,409 @@
-# vite-plugin-ops
-
-**O**ptimized **P**ackaging **S**trategy - 一个智能的 Vite 分包优化插件
-
-[![npm version](https://img.shields.io/npm/v/vite-plugin-ops.svg)](https://www.npmjs.com/package/vite-plugin-ops)
-[![License](https://img.shields.io/npm/l/vite-plugin-ops.svg)](https://github.com/suileyan/vite-plugin-ops/blob/main/LICENSE)
-
-## 特性
-
-- **智能分包策略** - 三种预设策略适配不同场景
-- **自动识别依赖** - 无需手动配置，自动读取 package.json
-- **框架预设** - 内置主流框架和库的最佳分包方案
-- **高度可配置** - 支持自定义分包规则
-- **优先级系统** - 灵活的匹配优先级机制
-- **资源分类** - 自动将 CSS、图片、字体分类存放
-- **零配置可用** - 开箱即用，合理的默认配置
-
-## 安装
-
-```bash
-npm install vite-plugin-ops -D
-# 或
-pnpm add vite-plugin-ops -D
-# 或
-yarn add vite-plugin-ops -D
-```
-
-## 快速开始
-
-### 基础使用
-
-```typescript
-// vite.config.ts
-import { defineConfig } from 'vite'
-import vue from '@vitejs/plugin-vue'
-import OPS from 'vite-plugin-ops'
-
-export default defineConfig({
-  plugins: [
-    vue(),
-    OPS() // 使用默认配置
-  ]
-})
-```
-
-插件会自动：
-- 将 node_modules 中的依赖智能分包
-- 将 CSS 文件放入 `css/` 目录
-- 将图片放入 `img/` 目录
-- 将字体放入 `fonts/` 目录
-- 将其他资源放入 `assets/` 目录
-
-## 分包策略
-
-插件提供三种分包策略，适用于不同场景：
-
-### 1. Balanced（平衡 - 默认推荐）
-
-适合大多数生产环境，平衡构建速度和加载性能。
-
-```typescript
-OPS({
-  strategy: 'balanced' // 默认值，可省略
-})
-```
-
-**特点：**
-- 大型库独立分包（React、Vue、Antd、Echarts 等）
-- 中型库按类型分组（工具库、图标库、表单库等）
-- 小型库合并到 vendor
-- 典型输出：5-15 个 chunk
-
-**适用场景：** 生产环境、中大型项目
-
-### 2. Aggressive（激进）
-
-每个依赖都独立分包，适合开发调试。
-
-```typescript
-OPS({
-  strategy: 'aggressive'
-})
-```
-
-**特点：**
-- 每个依赖独立成一个 chunk
-- 便于查看单个依赖的体积
-- 可能产生大量小文件
-- 典型输出：20-50+ 个 chunk
-
-**适用场景：** 开发环境、依赖分析
-
-### 3. Conservative（保守）
-
-最小化分包，减少 HTTP 请求。
-
-```typescript
-OPS({
-  strategy: 'conservative'
-})
-```
-
-**特点：**
-- 只分离超大型库（React、Vue、Antd、Echarts 等）
-- 其他库合并到 vendor
-- 减少 HTTP 请求数量
-- 典型输出：3-8 个 chunk
-
-**适用场景：** 小型项目、HTTP/1.x 环境
-
-## 配置选项
-
-### 完整配置示例
-
-```typescript
-OPS({
-  // 分包策略
-  strategy: 'balanced', // 'aggressive' | 'balanced' | 'conservative'
-  
-  // 是否覆盖用户已有的 rollupOptions.output 配置
-  override: false,
-  
-  // 最小分包大小（KB），仅在 balanced 和 conservative 策略下生效
-  minSize: 50,
-  
-  // 自定义分组规则
-  groups: {
-    // 将 lodash 相关库独立分包
-    'lodash': ['lodash', 'lodash-es'],
-    
-    // 使用正则匹配
-    'my-ui': [/my-ui-library/],
-    
-    // 将多个相关库分到一组
-    'charts': ['echarts', 'chart.js', 'd3']
-  }
-})
-```
-
-### 配置项说明
-
-| 参数 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `strategy` | `'aggressive' \| 'balanced' \| 'conservative'` | `'balanced'` | 分包策略 |
-| `override` | `boolean` | `false` | 是否覆盖已有配置 |
-| `minSize` | `number` | `50` | 最小分包大小（KB） |
-| `groups` | `Record<string, (string \| RegExp)[]>` | - | 自定义分组规则 |
-
-## 内置预设
-
-插件内置了主流框架和库的分包预设：
-
-### UI 框架
-- **React**: react, react-dom
-- **Vue**: vue, @vue/*
-- **Angular**: @angular/*
-- **Svelte**: svelte
-
-### UI 组件库
-- **Ant Design**: antd, @ant-design/*
-- **Element Plus**: element-plus
-- **Element UI**: element-ui
-- **Naive UI**: naive-ui
-- **Arco Design**: @arco-design/*
-- **Material-UI**: @mui/*, @material-ui/*
-- **Chakra UI**: @chakra-ui/*
-
-### 工具库
-- **Lodash**: lodash, lodash-es
-- **Axios**: axios
-- **Moment**: moment
-- **Day.js**: dayjs
-
-### 可视化库
-- **Echarts**: echarts
-- **D3**: d3
-- **Chart.js**: chart.js
-
-### 3D/游戏引擎
-- **Three.js**: three
-- **Babylon.js**: @babylonjs/*
-
-### 其他分组
-- **工具组**: @vueuse/*, ahooks, react-use
-- **图标组**: @iconify/*, @ant-design/icons, lucide-react
-- **表单组**: react-hook-form, formik, async-validator
-- **国际化**: i18next, react-i18next, vue-i18n
-
-## 输出结构
-
-构建后的文件结构：
-
-```
-dist/
-├── js/
-│   ├── index-[hash].js          # 入口文件
-│   ├── vendor-[hash].js         # 通用依赖
-│   ├── vue-[hash].js            # Vue 相关
-│   ├── antd-[hash].js           # Ant Design
-│   └── echarts-[hash].js        # Echarts
-├── css/
-│   └── index-[hash].css         # 样式文件
-├── img/
-│   └── logo-[hash].png          # 图片资源
-├── fonts/
-│   └── roboto-[hash].woff2      # 字体文件
-└── assets/
-    └── data-[hash].json         # 其他资源
-```
-
-## 使用场景
-
-### 场景 1: React + Ant Design 项目
-
-```typescript
-import OPS from 'vite-plugin-ops'
-
-export default {
-  plugins: [
-    react(),
-    OPS({
-      strategy: 'balanced',
-      groups: {
-        // 将 Ant Design 图标单独分包
-        'antd-icons': ['@ant-design/icons']
-      }
-    })
-  ]
-}
-```
-
-### 场景 2: Vue 3 + Element Plus 项目
-
-```typescript
-import OPS from 'vite-plugin-ops'
-
-export default {
-  plugins: [
-    vue(),
-    OPS({
-      strategy: 'balanced'
-      // 插件会自动检测 Vue 并创建 vue 分组
-    })
-  ]
-}
-```
-
-### 场景 3: 数据可视化项目
-
-```typescript
-import OPS from 'vite-plugin-ops'
-
-export default {
-  plugins: [
-    OPS({
-      strategy: 'balanced',
-      groups: {
-        // 将所有图表库分到一组
-        'charts': ['echarts', 'd3', 'chart.js', '@antv/g2']
-      }
-    })
-  ]
-}
-```
-
-### 场景 4: 多页面应用
-
-```typescript
-import OPS from 'vite-plugin-ops'
-
-export default {
-  build: {
-    rollupOptions: {
-      input: {
-        main: 'index.html',
-        admin: 'admin.html'
-      }
-    }
-  },
-  plugins: [
-    OPS({
-      strategy: 'conservative', // 减少公共依赖重复
-      override: false // 不覆盖多入口配置
-    })
-  ]
-}
-```
-
-## 高级用法
-
-### 自定义分组优先级
-
-插件使用优先级系统来处理分组匹配：
-
-1. **优先级 100**: 自定义 `groups` 配置
-2. **优先级 90**: 插件自动检测（如 Vue）
-3. **优先级 80**: 大型库预设
-4. **优先级 70**: 中型库分组
-5. **优先级 50**: aggressive 策略的单独依赖
-6. **默认**: vendor 组
-
-### 与现有配置合并
-
-```typescript
-export default {
-  build: {
-    rollupOptions: {
-      output: {
-        // 你的自定义配置
-        entryFileNames: 'my-entry-[hash].js'
-      }
-    }
-  },
-  plugins: [
-    OPS({
-      override: false // 保留你的 entryFileNames 配置
-    })
-  ]
-}
-```
-
-### 正则表达式匹配
-
-```typescript
-OPS({
-  groups: {
-    // 匹配所有 @babel 开头的包
-    'babel': [/\/@babel\//],
-    
-    // 匹配 lodash 但不包括 lodash-es
-    'lodash': [/\/lodash(?!-es)/],
-    
-    // 组合字符串和正则
-    'ui-libs': ['antd', /element-/]
-  }
-})
-```
-
-## 最佳实践
-
-### 1. 开发环境使用 aggressive
-
-```typescript
-export default defineConfig(({ mode }) => ({
-  plugins: [
-    OPS({
-      strategy: mode === 'development' ? 'aggressive' : 'balanced'
-    })
-  ]
-}))
-```
-
-### 2. 分析构建产物
-
-使用 `rollup-plugin-visualizer` 查看分包效果：
-
-```typescript
-import { visualizer } from 'rollup-plugin-visualizer'
-import OPS from 'vite-plugin-ops'
-
-export default {
-  plugins: [
-    OPS({ strategy: 'balanced' }),
-    visualizer({ open: true })
-  ]
-}
-```
-
-### 3. 监控构建信息
-
-插件会在构建时输出分包信息：
-
-```bash
-📦 OPS Chunking Strategy: Balanced (split large libraries)
-📊 Detected 12 chunk groups
-```
-
-### 4. 针对性能优化
-
-根据实际加载性能调整策略：
-
-- **首屏加载慢** → 使用 `conservative` 减少请求数
-- **大依赖更新频繁** → 使用 `balanced` 独立缓存
-- **需要精细控制** → 使用 `aggressive` + 自定义 `groups`
-
-## 注意事项
-
-1. **仅适用于 Vite 项目** - 此插件基于 Vite 插件系统
-2. **不支持 Webpack** - 需要 Webpack 版本请使用其他工具
-3. **Type 类型包** - 自动忽略 `@types/*` 包
-4. **Monorepo** - 确保在正确的 package.json 位置读取依赖
-
-## 贡献
-
-欢迎提交 Issue 和 Pull Request！
-
-## 许可
-
-MIT License
-
-## 相关链接
-
-- [Vite 官方文档](https://vitejs.dev/)
-- [Rollup 文档](https://rollupjs.org/)
-- [问题反馈](https://github.com/suileyan/vite-plugin-ops/issues)
-
----
-
-Made with by suileyan
+# vite-plugin-ops [![zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff)](https://zread.ai/suileyan/vite-plugin-ops)
+
+**O**ptimized **P**ackaging **S**trategy - 一个智能的 Vite 分包优化插件
+
+[![npm version](https://img.shields.io/npm/v/vite-plugin-ops.svg)](https://www.npmjs.com/package/vite-plugin-ops)
+[![License](https://img.shields.io/npm/l/vite-plugin-ops.svg)](https://github.com/suileyan/vite-plugin-ops/blob/main/LICENSE)
+
+## 特性
+
+- **智能分包策略** - 三种预设策略适配不同场景
+- **自动识别依赖** - 无需手动配置，自动读取 package.json
+- **框架预设** - 内置主流框架和库的最佳分包方案
+- **高度可配置** - 支持自定义分包规则
+- **优先级系统** - 灵活的匹配优先级机制
+- **资源分类** - 自动将 CSS、图片、字体分类存放
+- **零配置可用** - 开箱即用，合理的默认配置
+
+## 安装
+
+```bash
+npm install vite-plugin-ops -D
+# 或
+pnpm add vite-plugin-ops -D
+# 或
+yarn add vite-plugin-ops -D
+```
+
+## 快速开始
+
+### 基础使用
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import OPS from 'vite-plugin-ops'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    OPS() // 使用默认配置
+  ]
+})
+```
+
+插件会自动：
+- 将 node_modules 中的依赖智能分包
+- 将 CSS 文件放入 `css/` 目录
+- 将图片放入 `img/` 目录
+- 将字体放入 `fonts/` 目录
+- 将其他资源放入 `assets/` 目录
+
+## 分包策略
+
+插件提供三种分包策略，适用于不同场景：
+
+### 1. Balanced（平衡 - 默认推荐）
+
+适合大多数生产环境，平衡构建速度和加载性能。
+
+```typescript
+OPS({
+  strategy: 'balanced' // 默认值，可省略
+})
+```
+
+**特点：**
+- 大型库独立分包（React、Vue、Antd、Echarts 等）
+- 中型库按类型分组（工具库、图标库、表单库等）
+- 小型库合并到 vendor
+- 典型输出：5-15 个 chunk
+
+**适用场景：** 生产环境、中大型项目
+
+### 2. Aggressive（激进）
+
+每个依赖都独立分包，适合开发调试。
+
+```typescript
+OPS({
+  strategy: 'aggressive'
+})
+```
+
+**特点：**
+- 每个依赖独立成一个 chunk
+- 便于查看单个依赖的体积
+- 可能产生大量小文件
+- 典型输出：20-50+ 个 chunk
+
+**适用场景：** 开发环境、依赖分析
+
+### 3. Conservative（保守）
+
+最小化分包，减少 HTTP 请求。
+
+```typescript
+OPS({
+  strategy: 'conservative'
+})
+```
+
+**特点：**
+- 只分离超大型库（React、Vue、Antd、Echarts 等）
+- 其他库合并到 vendor
+- 减少 HTTP 请求数量
+- 典型输出：3-8 个 chunk
+
+**适用场景：** 小型项目、HTTP/1.x 环境
+
+## 配置选项
+
+### 完整配置示例
+
+```typescript
+OPS({
+  // 分包策略
+  strategy: 'balanced', // 'aggressive' | 'balanced' | 'conservative'
+  
+  // 是否覆盖用户已有的 rollupOptions.output 配置
+  override: false,
+  
+  // 最小分包大小（KB），仅在 balanced 和 conservative 策略下生效
+  minSize: 50,
+  
+  // 自定义分组规则
+  groups: {
+    // 将 lodash 相关库独立分包
+    'lodash': ['lodash', 'lodash-es'],
+    
+    // 使用正则匹配
+    'my-ui': [/my-ui-library/],
+    
+    // 将多个相关库分到一组
+    'charts': ['echarts', 'chart.js', 'd3']
+  }
+})
+```
+
+### 配置项说明
+
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `strategy` | `'aggressive' \| 'balanced' \| 'conservative'` | `'balanced'` | 分包策略 |
+| `override` | `boolean` | `false` | 是否覆盖已有配置 |
+| `minSize` | `number` | `50` | 最小分包大小（KB） |
+| `groups` | `Record<string, (string \| RegExp)[]>` | - | 自定义分组规则 |
+
+## 内置预设
+
+插件内置了主流框架和库的分包预设：
+
+### UI 框架
+- **React**: react, react-dom
+- **Vue**: vue, @vue/*
+- **Angular**: @angular/*
+- **Svelte**: svelte
+
+### UI 组件库
+- **Ant Design**: antd, @ant-design/*
+- **Element Plus**: element-plus
+- **Element UI**: element-ui
+- **Naive UI**: naive-ui
+- **Arco Design**: @arco-design/*
+- **Material-UI**: @mui/*, @material-ui/*
+- **Chakra UI**: @chakra-ui/*
+
+### 工具库
+- **Lodash**: lodash, lodash-es
+- **Axios**: axios
+- **Moment**: moment
+- **Day.js**: dayjs
+
+### 可视化库
+- **Echarts**: echarts
+- **D3**: d3
+- **Chart.js**: chart.js
+
+### 3D/游戏引擎
+- **Three.js**: three
+- **Babylon.js**: @babylonjs/*
+
+### 其他分组
+- **工具组**: @vueuse/*, ahooks, react-use
+- **图标组**: @iconify/*, @ant-design/icons, lucide-react
+- **表单组**: react-hook-form, formik, async-validator
+- **国际化**: i18next, react-i18next, vue-i18n
+
+## 输出结构
+
+构建后的文件结构：
+
+```
+dist/
+├── js/
+│   ├── index-[hash].js          # 入口文件
+│   ├── vendor-[hash].js         # 通用依赖
+│   ├── vue-[hash].js            # Vue 相关
+│   ├── antd-[hash].js           # Ant Design
+│   └── echarts-[hash].js        # Echarts
+├── css/
+│   └── index-[hash].css         # 样式文件
+├── img/
+│   └── logo-[hash].png          # 图片资源
+├── fonts/
+│   └── roboto-[hash].woff2      # 字体文件
+└── assets/
+    └── data-[hash].json         # 其他资源
+```
+
+## 使用场景
+
+### 场景 1: React + Ant Design 项目
+
+```typescript
+import OPS from 'vite-plugin-ops'
+
+export default {
+  plugins: [
+    react(),
+    OPS({
+      strategy: 'balanced',
+      groups: {
+        // 将 Ant Design 图标单独分包
+        'antd-icons': ['@ant-design/icons']
+      }
+    })
+  ]
+}
+```
+
+### 场景 2: Vue 3 + Element Plus 项目
+
+```typescript
+import OPS from 'vite-plugin-ops'
+
+export default {
+  plugins: [
+    vue(),
+    OPS({
+      strategy: 'balanced'
+      // 插件会自动检测 Vue 并创建 vue 分组
+    })
+  ]
+}
+```
+
+### 场景 3: 数据可视化项目
+
+```typescript
+import OPS from 'vite-plugin-ops'
+
+export default {
+  plugins: [
+    OPS({
+      strategy: 'balanced',
+      groups: {
+        // 将所有图表库分到一组
+        'charts': ['echarts', 'd3', 'chart.js', '@antv/g2']
+      }
+    })
+  ]
+}
+```
+
+### 场景 4: 多页面应用
+
+```typescript
+import OPS from 'vite-plugin-ops'
+
+export default {
+  build: {
+    rollupOptions: {
+      input: {
+        main: 'index.html',
+        admin: 'admin.html'
+      }
+    }
+  },
+  plugins: [
+    OPS({
+      strategy: 'conservative', // 减少公共依赖重复
+      override: false // 不覆盖多入口配置
+    })
+  ]
+}
+```
+
+## 高级用法
+
+### 自定义分组优先级
+
+插件使用优先级系统来处理分组匹配：
+
+1. **优先级 100**: 自定义 `groups` 配置
+2. **优先级 90**: 插件自动检测（如 Vue）
+3. **优先级 80**: 大型库预设
+4. **优先级 70**: 中型库分组
+5. **优先级 50**: aggressive 策略的单独依赖
+6. **默认**: vendor 组
+
+### 与现有配置合并
+
+```typescript
+export default {
+  build: {
+    rollupOptions: {
+      output: {
+        // 你的自定义配置
+        entryFileNames: 'my-entry-[hash].js'
+      }
+    }
+  },
+  plugins: [
+    OPS({
+      override: false // 保留你的 entryFileNames 配置
+    })
+  ]
+}
+```
+
+### 正则表达式匹配
+
+```typescript
+OPS({
+  groups: {
+    // 匹配所有 @babel 开头的包
+    'babel': [/\/@babel\//],
+    
+    // 匹配 lodash 但不包括 lodash-es
+    'lodash': [/\/lodash(?!-es)/],
+    
+    // 组合字符串和正则
+    'ui-libs': ['antd', /element-/]
+  }
+})
+```
+
+## 最佳实践
+
+### 1. 开发环境使用 aggressive
+
+```typescript
+export default defineConfig(({ mode }) => ({
+  plugins: [
+    OPS({
+      strategy: mode === 'development' ? 'aggressive' : 'balanced'
+    })
+  ]
+}))
+```
+
+### 2. 分析构建产物
+
+使用 `rollup-plugin-visualizer` 查看分包效果：
+
+```typescript
+import { visualizer } from 'rollup-plugin-visualizer'
+import OPS from 'vite-plugin-ops'
+
+export default {
+  plugins: [
+    OPS({ strategy: 'balanced' }),
+    visualizer({ open: true })
+  ]
+}
+```
+
+### 3. 监控构建信息
+
+插件会在构建时输出分包信息：
+
+```bash
+📦 OPS Chunking Strategy: Balanced (split large libraries)
+📊 Detected 12 chunk groups
+```
+
+### 4. 针对性能优化
+
+根据实际加载性能调整策略：
+
+- **首屏加载慢** → 使用 `conservative` 减少请求数
+- **大依赖更新频繁** → 使用 `balanced` 独立缓存
+- **需要精细控制** → 使用 `aggressive` + 自定义 `groups`
+
+## 注意事项
+
+1. **仅适用于 Vite 项目** - 此插件基于 Vite 插件系统
+2. **不支持 Webpack** - 需要 Webpack 版本请使用其他工具
+3. **Type 类型包** - 自动忽略 `@types/*` 包
+4. **Monorepo** - 确保在正确的 package.json 位置读取依赖
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 许可
+
+MIT License
+
+## 相关链接
+
+- [Vite 官方文档](https://vitejs.dev/)
+- [Rollup 文档](https://rollupjs.org/)
+- [问题反馈](https://github.com/suileyan/vite-plugin-ops/issues)
+
+---
+
+Made with by suileyan

package/dist/index.cjs

@@ -51,25 +51,66 @@ var MEDIUM_LIB_GROUPS = {
   "form": ["react-hook-form", "formik", "async-validator"],
   "i18n": ["i18next", "react-i18next", "vue-i18n"]
 };
+var patternCache = /* @__PURE__ */ new Map();
+var MAX_PATH_LENGTH = 2e3;
 function normalizeId(id) {
   return id.replace(/\\/g, "/").replace(/%5C/g, "/");
 }
 function makeNodeModulesPattern(pkg) {
   if (pkg instanceof RegExp) {
-    return (id) => pkg.test(id);
+    return (id) => {
+      if (id.length > MAX_PATH_LENGTH) {
+        console.warn(`[vite-plugin-ops] Path too long (${id.length} chars), skipping: ${id.slice(0, 50)}...`);
+        return false;
+      }
+      return pkg.test(id);
+    };
+  }
+  let re = patternCache.get(pkg);
+  if (!re) {
+    const scoped = pkg.startsWith("@");
+    const escaped = pkg.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&");
+    const base = scoped ? escaped : `(?:@[^/]+/)?${escaped}`;
+    re = new RegExp(`/node_modules/(?:[.]pnpm/)?(?:${base})(?:/|@|$)`, "i");
+    patternCache.set(pkg, re);
   }
-  const scoped = pkg.startsWith("@");
-  const escaped = pkg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const base = scoped ? escaped : `(?:@[^/]+/)?${escaped}`;
-  const re = new RegExp(`/node_modules/(?:[.]pnpm/)?(?:${base})(?:/|@|$)`, "i");
-  return (id) => re.test(id);
+  return (id) => {
+    if (id.length > MAX_PATH_LENGTH) {
+      console.warn(`[vite-plugin-ops] Path too long (${id.length} chars), skipping: ${id.slice(0, 50)}...`);
+      return false;
+    }
+    return re.test(id);
+  };
+}
+function isValidPackageJson(obj) {
+  if (typeof obj !== "object" || obj === null) return false;
+  const json = obj;
+  if (json.dependencies !== void 0) {
+    if (typeof json.dependencies !== "object" || json.dependencies === null) return false;
+    for (const val of Object.values(json.dependencies)) {
+      if (typeof val !== "string") return false;
+    }
+  }
+  return true;
 }
 function readProjectDependencies(cwd) {
   try {
     const pkgPath = path__default.default.join(cwd, "package.json");
-    const json = JSON.parse(fs__default.default.readFileSync(pkgPath, "utf8"));
+    const content = fs__default.default.readFileSync(pkgPath, "utf8");
+    const json = JSON.parse(content);
+    if (!isValidPackageJson(json)) {
+      console.warn("[vite-plugin-ops] Invalid package.json format: dependencies field is malformed");
+      return /* @__PURE__ */ new Set();
+    }
     return new Set(Object.keys(json.dependencies || {}));
-  } catch {
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      console.warn("[vite-plugin-ops] Failed to parse package.json: Invalid JSON format");
+    } else if (error.code === "ENOENT") {
+      console.warn("[vite-plugin-ops] package.json not found in:", cwd);
+    } else if (process.env.DEBUG) {
+      console.warn("[vite-plugin-ops] Failed to read package.json:", error);
+    }
     return /* @__PURE__ */ new Set();
   }
 }

package/dist/index.d.cts

@@ -1,6 +1,8 @@
 import { Plugin } from 'vite';
+export { Plugin as OPSPlugin } from 'vite';
 
 type SplitStrategy = 'aggressive' | 'balanced' | 'conservative';
+
 type OPSOptions = {
     /**
      * If true, overwrite existing `build.rollupOptions.output.*` fields.

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { Plugin } from 'vite';
+export { Plugin as OPSPlugin } from 'vite';
 
 type SplitStrategy = 'aggressive' | 'balanced' | 'conservative';
+
 type OPSOptions = {
     /**
      * If true, overwrite existing `build.rollupOptions.output.*` fields.

package/dist/index.js

@@ -44,25 +44,66 @@ var MEDIUM_LIB_GROUPS = {
   "form": ["react-hook-form", "formik", "async-validator"],
   "i18n": ["i18next", "react-i18next", "vue-i18n"]
 };
+var patternCache = /* @__PURE__ */ new Map();
+var MAX_PATH_LENGTH = 2e3;
 function normalizeId(id) {
   return id.replace(/\\/g, "/").replace(/%5C/g, "/");
 }
 function makeNodeModulesPattern(pkg) {
   if (pkg instanceof RegExp) {
-    return (id) => pkg.test(id);
+    return (id) => {
+      if (id.length > MAX_PATH_LENGTH) {
+        console.warn(`[vite-plugin-ops] Path too long (${id.length} chars), skipping: ${id.slice(0, 50)}...`);
+        return false;
+      }
+      return pkg.test(id);
+    };
+  }
+  let re = patternCache.get(pkg);
+  if (!re) {
+    const scoped = pkg.startsWith("@");
+    const escaped = pkg.replace(/[.*+?^${}()|[\]\\/]/g, "\\$&");
+    const base = scoped ? escaped : `(?:@[^/]+/)?${escaped}`;
+    re = new RegExp(`/node_modules/(?:[.]pnpm/)?(?:${base})(?:/|@|$)`, "i");
+    patternCache.set(pkg, re);
   }
-  const scoped = pkg.startsWith("@");
-  const escaped = pkg.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const base = scoped ? escaped : `(?:@[^/]+/)?${escaped}`;
-  const re = new RegExp(`/node_modules/(?:[.]pnpm/)?(?:${base})(?:/|@|$)`, "i");
-  return (id) => re.test(id);
+  return (id) => {
+    if (id.length > MAX_PATH_LENGTH) {
+      console.warn(`[vite-plugin-ops] Path too long (${id.length} chars), skipping: ${id.slice(0, 50)}...`);
+      return false;
+    }
+    return re.test(id);
+  };
+}
+function isValidPackageJson(obj) {
+  if (typeof obj !== "object" || obj === null) return false;
+  const json = obj;
+  if (json.dependencies !== void 0) {
+    if (typeof json.dependencies !== "object" || json.dependencies === null) return false;
+    for (const val of Object.values(json.dependencies)) {
+      if (typeof val !== "string") return false;
+    }
+  }
+  return true;
 }
 function readProjectDependencies(cwd) {
   try {
     const pkgPath = path.join(cwd, "package.json");
-    const json = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    const content = fs.readFileSync(pkgPath, "utf8");
+    const json = JSON.parse(content);
+    if (!isValidPackageJson(json)) {
+      console.warn("[vite-plugin-ops] Invalid package.json format: dependencies field is malformed");
+      return /* @__PURE__ */ new Set();
+    }
     return new Set(Object.keys(json.dependencies || {}));
-  } catch {
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      console.warn("[vite-plugin-ops] Failed to parse package.json: Invalid JSON format");
+    } else if (error.code === "ENOENT") {
+      console.warn("[vite-plugin-ops] package.json not found in:", cwd);
+    } else if (process.env.DEBUG) {
+      console.warn("[vite-plugin-ops] Failed to read package.json:", error);
+    }
     return /* @__PURE__ */ new Set();
   }
 }

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "vite-plugin-ops",
-  "version": "0.1.1",
-  "description": "Vite plugin to organize build outputs and vendor chunking.",
-  "type": "module",
-  "license": "MIT",
-  "author": "suileyan",
-
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./package.json": "./package.json"
-  },
-  "main": "dist/index.cjs",
-  "types": "dist/index.d.ts",
-
-  "files": ["dist", "README.md", "LICENSE"],
-
-  "sideEffects": false,
-  "engines": {
-    "node": ">=20.19"
-  },
-
-  "keywords": ["vite", "vite-plugin", "rollup", "chunks", "vendor", "build"],
-
-  "repository": { "type": "git", "url": "git+https://github.com/suileyan/vite-plugin-ops.git" },
-  "bugs": { "url": "https://github.com/suileyan/vite-plugin-ops/issues" },
-  "homepage": "https://github.com/suileyan/vite-plugin-ops#readme",
-
-  "peerDependencies": {
-    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.6.0",
-    "rimraf": "^6.0.1",
-    "tsup": "^8.5.0",
-    "typescript": "^5.9.2",
-    "vite": "^7.1.7",
-    "rollup": "^4.0.0"
-  },
-
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch --sourcemap",
-    "clean": "rimraf dist || rmdir /s /q dist",
-    "prepublishOnly": "npm run clean && npm run build"
-  },
-
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  }
-}
+{
+  "name": "vite-plugin-ops",
+  "version": "0.1.2",
+  "description": "Vite plugin to organize build outputs and vendor chunking.",
+  "type": "module",
+  "license": "MIT",
+  "author": "suileyan",
+
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/index.cjs",
+  "types": "dist/index.d.ts",
+
+  "files": ["dist", "README.md", "LICENSE"],
+
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.19"
+  },
+
+  "keywords": ["vite", "vite-plugin", "rollup", "chunks", "vendor", "build"],
+
+  "repository": { "type": "git", "url": "git+https://github.com/suileyan/vite-plugin-ops.git" },
+  "bugs": { "url": "https://github.com/suileyan/vite-plugin-ops/issues" },
+  "homepage": "https://github.com/suileyan/vite-plugin-ops#readme",
+
+  "peerDependencies": {
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vite": "^7.3.1",
+    "rollup": "^4.0.0"
+  },
+
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch --sourcemap",
+    "clean": "rimraf dist || rmdir /s /q dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}