vite-plugin-preloader 1.0.0

package/README.md

@@ -0,0 +1,218 @@
+# 🚀 vite-plugin-preloader
+
+智能路由预加载 Vite 插件，一行配置，极致性能！
+
+## ✨ 特性
+
+- 🎯 **一行配置** - 在 `vite.config.js` 中配置即可
+- ⚡ **零运行时开销** - 构建时生成，运行时高效
+- 🎨 **自动注入** - 无需手动调用，全自动工作
+- 🛠️ **开发友好** - 提供调试工具和状态显示
+- 📦 **类型安全** - 完整的 TypeScript 支持
+- 🔥 **热更新支持** - 配置变更时自动更新
+
+## 📦 安装
+
+```bash
+npm install vite-plugin-preloader
+# 或
+yarn add vite-plugin-preloader
+# 或
+pnpm add vite-plugin-preloader
+# 或
+bun add vite-plugin-preloader
+```
+
+## 🚀 使用
+
+### 基础配置
+
+```js
+// vite.config.js
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import preloader from 'vite-plugin-preloader'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    preloader({
+      routes: [
+        { 
+          path: '/calendar', 
+          reason: '日历组件包含大型库',
+          priority: 1 
+        },
+        { 
+          path: '/charts', 
+          component: '@/views/charts/index.vue',
+          reason: '图表页面较重', 
+          priority: 1 
+        }
+      ]
+    })
+  ]
+})
+```
+
+就这样！无需其他任何代码，插件会自动：
+- 🎯 生成预加载逻辑
+- 📦 注入到应用中
+- 🎨 显示加载状态
+- 🛠️ 提供调试工具
+
+### 完整配置示例
+
+```js
+preloader({
+  routes: [
+    // 🔥 高优先级 - 核心页面
+    { 
+      path: '/dashboard', 
+      component: '@/views/dashboard/index.vue',
+      reason: '主仪表盘，用户访问频率最高',
+      priority: 1 
+    },
+    
+    // ⚡ 中优先级 - 常用页面
+    { 
+      path: '/calendar', 
+      reason: '日历组件包含 @fullcalendar 全家桶(~500KB)',
+      priority: 2 
+    },
+    
+    // 📊 低优先级 - 重型工具页面
+    { 
+      path: '/reports', 
+      component: '@/views/reports/index.vue',
+      reason: '报表页面包含 echarts + d3 图表库(~800KB)',
+      priority: 3 
+    }
+  ],
+  delay: 2000,                    // 延迟时间
+  showStatus: true,               // 显示状态
+  statusPosition: 'bottom-right', // 状态位置
+  debug: true                     // 开发调试
+})
+```
+
+## 🎯 配置选项
+
+| 选项 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `routes` | `PreloadRoute[]` | `[]` | 预加载路由配置 |
+| `delay` | `number` | `2000` | 延迟时间(ms) |
+| `showStatus` | `boolean` | `true` | 显示状态 |
+| `statusPosition` | `string` | `'bottom-right'` | 状态位置 |
+| `debug` | `boolean` | `false` | 开发调试 |
+
+### PreloadRoute 配置
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `path` | `string` | ✅ | 路由路径 |
+| `component` | `string` | ❌ | 组件路径（不填自动推断） |
+| `reason` | `string` | ❌ | 预加载原因说明 |
+| `priority` | `number` | ❌ | 优先级 1-5（数字越小越先加载） |
+
+## 🛠️ 开发调试
+
+开发环境下，浏览器控制台可用：
+
+```js
+// 查看预加载统计
+window.preloaderDebug.stats()
+
+// 检查指定路由状态  
+window.preloaderDebug.check('/calendar')
+
+// 重新开始预加载
+window.preloaderDebug.restart()
+
+// 显示帮助信息
+window.preloaderDebug.help()
+```
+
+## 📊 控制台输出示例
+
+```
+🚀 预加载插件已启用，配置了 3 个路由
+🚀 [预加载] 开始预加载 3 个页面
+✅ [预加载] /calendar (234ms) - 日历组件包含 @fullcalendar 全家桶
+✅ [预加载] /charts (456ms) - 图表页面包含 echarts、@antv/x6
+✅ [预加载] /reports (678ms) - 报表页面包含 echarts + d3 图表库
+🎉 [预加载] 完成! 耗时 1234ms
+```
+
+## 🎨 状态显示
+
+插件会在页面右下角显示预加载状态：
+
+```
+🔄 正在优化页面... 2/3
+```
+
+状态位置可通过 `statusPosition` 配置：
+- `'top-left'` - 左上角
+- `'top-right'` - 右上角  
+- `'bottom-left'` - 左下角
+- `'bottom-right'` - 右下角（默认）
+
+## 🔧 最佳实践
+
+### 1. 优先级设置建议
+
+```js
+// 优先级 1: 核心业务页面（高频访问 + 大体积）
+{ path: '/dashboard', priority: 1 }
+
+// 优先级 2: 常用功能页面（中频访问 + 中体积）
+{ path: '/calendar', priority: 2 }
+
+// 优先级 3: 专业工具页面（低频访问 + 大体积）
+{ path: '/reports', priority: 3 }
+```
+
+### 2. 组件路径自动推断
+
+如果不指定 `component`，插件会自动推断：
+
+```js
+{ path: '/user-profile' }
+// 自动推断为: @/views/user-profile/index.vue
+
+{ path: '/admin/users' }  
+// 自动推断为: @/views/admin-users/index.vue
+```
+
+### 3. 预加载原因说明
+
+建议在 `reason` 中说明预加载的具体原因：
+
+```js
+{
+  path: '/calendar',
+  reason: '日历组件包含 @fullcalendar 全家桶(~500KB)',
+  priority: 2
+}
+```
+
+## 🚀 工作原理
+
+1. **构建时分析** - 插件在构建时解析配置
+2. **代码生成** - 自动生成预加载逻辑代码
+3. **虚拟模块** - 创建 `virtual:preloader` 模块
+4. **自动注入** - 将预加载代码注入到应用中
+5. **智能调度** - 按优先级串行预加载，避免阻塞
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 📄 License
+
+MIT © ChenYu
+
+---
+
+**🎯 一行配置，极致性能！让你的 Vue 应用飞起来！** 🚀

package/dist/index.d.mts

@@ -0,0 +1,35 @@
+import { Plugin } from 'vite';
+
+interface PreloadRoute {
+    /** 路由路径 */
+    path: string;
+    /** 组件导入路径，不填则自动推断 */
+    component?: string;
+    /** 预加载原因说明 */
+    reason?: string;
+    /** 优先级 1-5，数字越小优先级越高 */
+    priority?: number;
+}
+interface PreloaderOptions {
+    /** 预加载路由配置 */
+    routes: PreloadRoute[];
+    /** 延迟时间（毫秒），默认 2000 */
+    delay?: number;
+    /** 是否显示预加载状态，默认 true */
+    showStatus?: boolean;
+    /** 状态显示位置，默认 'bottom-right' */
+    statusPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /** 是否启用开发时调试，默认 false */
+    debug?: boolean;
+    /** 自动检测大文件并预加载（未来功能） */
+    autoDetect?: {
+        /** 最小文件大小阈值 */
+        minSize?: string;
+        /** 排除的路径模式 */
+        exclude?: string[];
+    };
+}
+
+declare function preloaderPlugin(options: PreloaderOptions): Plugin;
+
+export { type PreloadRoute, type PreloaderOptions, preloaderPlugin as default };

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+import { Plugin } from 'vite';
+
+interface PreloadRoute {
+    /** 路由路径 */
+    path: string;
+    /** 组件导入路径，不填则自动推断 */
+    component?: string;
+    /** 预加载原因说明 */
+    reason?: string;
+    /** 优先级 1-5，数字越小优先级越高 */
+    priority?: number;
+}
+interface PreloaderOptions {
+    /** 预加载路由配置 */
+    routes: PreloadRoute[];
+    /** 延迟时间（毫秒），默认 2000 */
+    delay?: number;
+    /** 是否显示预加载状态，默认 true */
+    showStatus?: boolean;
+    /** 状态显示位置，默认 'bottom-right' */
+    statusPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /** 是否启用开发时调试，默认 false */
+    debug?: boolean;
+    /** 自动检测大文件并预加载（未来功能） */
+    autoDetect?: {
+        /** 最小文件大小阈值 */
+        minSize?: string;
+        /** 排除的路径模式 */
+        exclude?: string[];
+    };
+}
+
+declare function preloaderPlugin(options: PreloaderOptions): Plugin;
+
+export { type PreloadRoute, type PreloaderOptions, preloaderPlugin as default };

package/dist/index.js

@@ -0,0 +1,282 @@
+// vite-plugin-preloader - 智能路由预加载插件
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => preloaderPlugin
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/runtime.ts
+var runtimeTemplate = `// \u{1F680} Auto-generated by vite-plugin-preloader
+import { ref, defineComponent, h, onMounted } from 'vue'
+
+interface PreloadRoute {
+  path: string
+  component: () => Promise<any>
+  reason: string
+  priority: number
+}
+
+interface PreloadStats {
+  total: number
+  completed: number
+  failed: number
+  startTime: number
+  endTime: number
+}
+
+// \u{1F3AF} \u9884\u52A0\u8F7D\u914D\u7F6E\uFF08\u6784\u5EFA\u65F6\u6CE8\u5165\uFF09
+const PRELOAD_ROUTES = __PRELOAD_ROUTES__
+const PRELOAD_OPTIONS = __PRELOAD_OPTIONS__
+
+class PreloaderManager {
+  private preloadedRoutes = new Set()
+  private isPreloading = ref(false)
+  private stats = ref({
+    total: 0, completed: 0, failed: 0, startTime: 0, endTime: 0
+  })
+
+  async start() {
+    if (this.isPreloading.value) return
+
+    this.isPreloading.value = true
+    this.stats.value = {
+      total: PRELOAD_ROUTES.length,
+      completed: 0, failed: 0,
+      startTime: Date.now(), endTime: 0
+    }
+
+    console.log(\`\u{1F680} [\u9884\u52A0\u8F7D] \u5F00\u59CB\u9884\u52A0\u8F7D \${PRELOAD_ROUTES.length} \u4E2A\u9875\u9762\`)
+
+    const sortedRoutes = [...PRELOAD_ROUTES].sort((a, b) => a.priority - b.priority)
+    
+    for (const route of sortedRoutes) {
+      await this.preloadSingle(route)
+      await this.sleep(100)
+    }
+
+    this.stats.value.endTime = Date.now()
+    this.isPreloading.value = false
+    
+    console.log(\`\u{1F389} [\u9884\u52A0\u8F7D] \u5B8C\u6210! \u8017\u65F6 \${this.stats.value.endTime - this.stats.value.startTime}ms\`)
+  }
+
+  async preloadSingle(route) {
+    if (this.preloadedRoutes.has(route.path)) return
+
+    try {
+      const startTime = Date.now()
+      await route.component()
+      const loadTime = Date.now() - startTime
+      
+      this.preloadedRoutes.add(route.path)
+      this.stats.value.completed++
+      console.log(\`\u2705 [\u9884\u52A0\u8F7D] \${route.path} (\${loadTime}ms) - \${route.reason}\`)
+    } catch (error) {
+      this.stats.value.failed++
+      console.error(\`\u274C [\u9884\u52A0\u8F7D] \${route.path} \u5931\u8D25:\`, error)
+    }
+  }
+
+  sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms))
+  }
+
+  isPreloaded(path) {
+    return this.preloadedRoutes.has(path)
+  }
+
+  getStats() {
+    return {
+      ...this.stats.value,
+      preloadedPaths: Array.from(this.preloadedRoutes),
+      isPreloading: this.isPreloading.value
+    }
+  }
+
+  createStatusComponent() {
+    const self = this
+    return defineComponent({
+      name: 'PreloadStatus',
+      setup() {
+        onMounted(() => {
+          if (!document.getElementById('preloader-styles')) {
+            const style = document.createElement('style')
+            style.id = 'preloader-styles'
+            const position = PRELOAD_OPTIONS.statusPosition.replace('-', ': 20px; ') + ': 20px;'
+            style.textContent = \`
+              .preloader-status {
+                position: fixed; \${position}
+                background: rgba(0,0,0,0.8); color: white; padding: 8px 16px;
+                border-radius: 6px; font-size: 12px; z-index: 9999;
+                pointer-events: none; font-family: system-ui;
+              }
+            \`
+            document.head.appendChild(style)
+          }
+        })
+
+        return () => {
+          if (!self.isPreloading.value || !import.meta.env.DEV || !PRELOAD_OPTIONS.showStatus) {
+            return null
+          }
+          return h('div', { class: 'preloader-status' }, [
+            '\u{1F504} \u6B63\u5728\u4F18\u5316\u9875\u9762... ',
+            \`\${self.stats.value.completed}/\${self.stats.value.total}\`
+          ])
+        }
+      }
+    })
+  }
+}
+
+// \u{1F680} \u5168\u5C40\u5B9E\u4F8B
+const preloader = new PreloaderManager()
+
+// \u{1F6E0}\uFE0F \u5F00\u53D1\u73AF\u5883\u8C03\u8BD5\u5DE5\u5177
+if (import.meta.env.DEV && PRELOAD_OPTIONS.debug) {
+  window.preloaderDebug = {
+    stats: () => preloader.getStats(),
+    restart: () => preloader.start(),
+    check: (path) => preloader.isPreloaded(path),
+    help: () => console.log('\u{1F6E0}\uFE0F \u9884\u52A0\u8F7D\u8C03\u8BD5: stats() | restart() | check(path)')
+  }
+  console.log('\u{1F6E0}\uFE0F \u9884\u52A0\u8F7D\u8C03\u8BD5\u5DE5\u5177: window.preloaderDebug')
+}
+
+// \u{1F3AF} \u5BFC\u51FA
+export const usePreloader = () => ({
+  start: () => preloader.start(),
+  isPreloaded: (path) => preloader.isPreloaded(path),
+  StatusComponent: preloader.createStatusComponent()
+})
+
+// \u{1F680} \u81EA\u52A8\u542F\u52A8
+if (typeof window !== 'undefined') {
+  setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay || 2000)
+}`;
+
+// src/generator.ts
+var CodeGenerator = class {
+  constructor(options) {
+    this.options = options;
+  }
+  /**
+   * 生成运行时代码
+   */
+  generateRuntime() {
+    const routes = this.processRoutes();
+    const options = this.processOptions();
+    return runtimeTemplate.replace("__PRELOAD_ROUTES__", JSON.stringify(routes, null, 2)).replace("__PRELOAD_OPTIONS__", JSON.stringify(options, null, 2));
+  }
+  /**
+   * 处理路由配置
+   */
+  processRoutes() {
+    return this.options.routes.map((route) => {
+      const componentPath = route.component || this.inferComponentPath(route.path);
+      return {
+        path: route.path,
+        component: `() => import('${componentPath}')`,
+        reason: route.reason || "\u7528\u6237\u914D\u7F6E\u7684\u9884\u52A0\u8F7D\u9875\u9762",
+        priority: route.priority || 2
+      };
+    });
+  }
+  /**
+   * 处理选项配置
+   */
+  processOptions() {
+    return {
+      delay: this.options.delay || 2e3,
+      showStatus: this.options.showStatus !== false,
+      statusPosition: this.options.statusPosition || "bottom-right",
+      debug: this.options.debug || false
+    };
+  }
+  /**
+   * 推断组件路径
+   */
+  inferComponentPath(routePath) {
+    const cleanPath = routePath.replace(/^\//, "").replace(/\//g, "-");
+    return `@/views/${cleanPath}/index.vue`;
+  }
+  /**
+   * 生成HTML注入代码
+   */
+  generateHtmlInject() {
+    if (this.options.showStatus === false) return "";
+    return "<preloader-status></preloader-status>";
+  }
+};
+
+// src/index.ts
+var VIRTUAL_MODULE_ID = "virtual:preloader";
+var RESOLVED_VIRTUAL_MODULE_ID = "\0" + VIRTUAL_MODULE_ID;
+function preloaderPlugin(options) {
+  let generator;
+  return {
+    name: "vite-plugin-preloader",
+    // 🎯 设置插件执行顺序
+    enforce: "post",
+    configResolved() {
+      generator = new CodeGenerator(options);
+      console.log(`\u{1F680} \u9884\u52A0\u8F7D\u63D2\u4EF6\u5DF2\u542F\u7528\uFF0C\u914D\u7F6E\u4E86 ${options.routes.length} \u4E2A\u8DEF\u7531`);
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_MODULE_ID) {
+        return RESOLVED_VIRTUAL_MODULE_ID;
+      }
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+        return generator.generateRuntime();
+      }
+      return null;
+    },
+    // 🎨 HTML 转换（修复类型错误）
+    transformIndexHtml(html) {
+      const inject = generator.generateHtmlInject();
+      if (inject) {
+        return html.replace(
+          '<div id="app">',
+          `<div id="app">
+    ${inject}`
+        );
+      }
+      return html;
+    },
+    // 🔥 HMR 支持
+    handleHotUpdate(ctx) {
+      if (ctx.file.includes("vite.config")) {
+        console.log("\u{1F504} \u9884\u52A0\u8F7D\u914D\u7F6E\u5DF2\u66F4\u65B0");
+        ctx.server.ws.send({
+          type: "full-reload"
+        });
+        return [];
+      }
+      return void 0;
+    }
+  };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/runtime.ts","../src/generator.ts"],"sourcesContent":["// ============================================================================\r\n// 🚀 src/index.ts - 主插件文件\r\n// ============================================================================\r\n\r\nimport type { Plugin } from 'vite'\r\nimport type { PreloaderOptions } from './types'\r\nimport { CodeGenerator } from './generator'\r\n\r\nconst VIRTUAL_MODULE_ID = 'virtual:preloader'\r\nconst RESOLVED_VIRTUAL_MODULE_ID = '\\0' + VIRTUAL_MODULE_ID\r\n\r\nexport default function preloaderPlugin(options: PreloaderOptions): Plugin {\r\n  let generator: CodeGenerator\r\n\r\n  return {\r\n    name: 'vite-plugin-preloader',\r\n    \r\n    // 🎯 设置插件执行顺序\r\n    enforce: 'post',\r\n    \r\n    configResolved() {\r\n      generator = new CodeGenerator(options)\r\n      console.log(`🚀 预加载插件已启用，配置了 ${options.routes.length} 个路由`)\r\n    },\r\n\r\n    resolveId(id) {\r\n      if (id === VIRTUAL_MODULE_ID) {\r\n        return RESOLVED_VIRTUAL_MODULE_ID\r\n      }\r\n      return null // 🔧 修复：明确返回 null\r\n    },\r\n\r\n    load(id) {\r\n      if (id === RESOLVED_VIRTUAL_MODULE_ID) {\r\n        return generator.generateRuntime()\r\n      }\r\n      return null // 🔧 修复：明确返回 null\r\n    },\r\n\r\n    // 🎨 HTML 转换（修复类型错误）\r\n    transformIndexHtml(html) {\r\n      const inject = generator.generateHtmlInject()\r\n      if (inject) {\r\n        return html.replace(\r\n          '<div id=\"app\">',\r\n          `<div id=\"app\">\\n    ${inject}`\r\n        )\r\n      }\r\n      return html // 🔧 修复：确保总是返回 html\r\n    },\r\n\r\n    // 🔥 HMR 支持\r\n    handleHotUpdate(ctx) {\r\n      if (ctx.file.includes('vite.config')) {\r\n        console.log('🔄 预加载配置已更新')\r\n        ctx.server.ws.send({\r\n          type: 'full-reload'\r\n        })\r\n        return []\r\n      }\r\n      return undefined // 🔧 修复：明确返回 undefined\r\n    }\r\n  }\r\n}\r\n\r\n// 命名导出，支持多种导入方式\r\nexport { type PreloaderOptions, type PreloadRoute } from './types'","// ============================================================================\r\n// ⚡ src/runtime.ts - 运行时代码模板（字符串）\r\n// ============================================================================\r\n\r\nexport const runtimeTemplate = `// 🚀 Auto-generated by vite-plugin-preloader\r\nimport { ref, defineComponent, h, onMounted } from 'vue'\r\n\r\ninterface PreloadRoute {\r\n  path: string\r\n  component: () => Promise<any>\r\n  reason: string\r\n  priority: number\r\n}\r\n\r\ninterface PreloadStats {\r\n  total: number\r\n  completed: number\r\n  failed: number\r\n  startTime: number\r\n  endTime: number\r\n}\r\n\r\n// 🎯 预加载配置（构建时注入）\r\nconst PRELOAD_ROUTES = __PRELOAD_ROUTES__\r\nconst PRELOAD_OPTIONS = __PRELOAD_OPTIONS__\r\n\r\nclass PreloaderManager {\r\n  private preloadedRoutes = new Set()\r\n  private isPreloading = ref(false)\r\n  private stats = ref({\r\n    total: 0, completed: 0, failed: 0, startTime: 0, endTime: 0\r\n  })\r\n\r\n  async start() {\r\n    if (this.isPreloading.value) return\r\n\r\n    this.isPreloading.value = true\r\n    this.stats.value = {\r\n      total: PRELOAD_ROUTES.length,\r\n      completed: 0, failed: 0,\r\n      startTime: Date.now(), endTime: 0\r\n    }\r\n\r\n    console.log(\\`🚀 [预加载] 开始预加载 \\${PRELOAD_ROUTES.length} 个页面\\`)\r\n\r\n    const sortedRoutes = [...PRELOAD_ROUTES].sort((a, b) => a.priority - b.priority)\r\n    \r\n    for (const route of sortedRoutes) {\r\n      await this.preloadSingle(route)\r\n      await this.sleep(100)\r\n    }\r\n\r\n    this.stats.value.endTime = Date.now()\r\n    this.isPreloading.value = false\r\n    \r\n    console.log(\\`🎉 [预加载] 完成! 耗时 \\${this.stats.value.endTime - this.stats.value.startTime}ms\\`)\r\n  }\r\n\r\n  async preloadSingle(route) {\r\n    if (this.preloadedRoutes.has(route.path)) return\r\n\r\n    try {\r\n      const startTime = Date.now()\r\n      await route.component()\r\n      const loadTime = Date.now() - startTime\r\n      \r\n      this.preloadedRoutes.add(route.path)\r\n      this.stats.value.completed++\r\n      console.log(\\`✅ [预加载] \\${route.path} (\\${loadTime}ms) - \\${route.reason}\\`)\r\n    } catch (error) {\r\n      this.stats.value.failed++\r\n      console.error(\\`❌ [预加载] \\${route.path} 失败:\\`, error)\r\n    }\r\n  }\r\n\r\n  sleep(ms) {\r\n    return new Promise(resolve => setTimeout(resolve, ms))\r\n  }\r\n\r\n  isPreloaded(path) {\r\n    return this.preloadedRoutes.has(path)\r\n  }\r\n\r\n  getStats() {\r\n    return {\r\n      ...this.stats.value,\r\n      preloadedPaths: Array.from(this.preloadedRoutes),\r\n      isPreloading: this.isPreloading.value\r\n    }\r\n  }\r\n\r\n  createStatusComponent() {\r\n    const self = this\r\n    return defineComponent({\r\n      name: 'PreloadStatus',\r\n      setup() {\r\n        onMounted(() => {\r\n          if (!document.getElementById('preloader-styles')) {\r\n            const style = document.createElement('style')\r\n            style.id = 'preloader-styles'\r\n            const position = PRELOAD_OPTIONS.statusPosition.replace('-', ': 20px; ') + ': 20px;'\r\n            style.textContent = \\`\r\n              .preloader-status {\r\n                position: fixed; \\${position}\r\n                background: rgba(0,0,0,0.8); color: white; padding: 8px 16px;\r\n                border-radius: 6px; font-size: 12px; z-index: 9999;\r\n                pointer-events: none; font-family: system-ui;\r\n              }\r\n            \\`\r\n            document.head.appendChild(style)\r\n          }\r\n        })\r\n\r\n        return () => {\r\n          if (!self.isPreloading.value || !import.meta.env.DEV || !PRELOAD_OPTIONS.showStatus) {\r\n            return null\r\n          }\r\n          return h('div', { class: 'preloader-status' }, [\r\n            '🔄 正在优化页面... ',\r\n            \\`\\${self.stats.value.completed}/\\${self.stats.value.total}\\`\r\n          ])\r\n        }\r\n      }\r\n    })\r\n  }\r\n}\r\n\r\n// 🚀 全局实例\r\nconst preloader = new PreloaderManager()\r\n\r\n// 🛠️ 开发环境调试工具\r\nif (import.meta.env.DEV && PRELOAD_OPTIONS.debug) {\r\n  window.preloaderDebug = {\r\n    stats: () => preloader.getStats(),\r\n    restart: () => preloader.start(),\r\n    check: (path) => preloader.isPreloaded(path),\r\n    help: () => console.log('🛠️ 预加载调试: stats() | restart() | check(path)')\r\n  }\r\n  console.log('🛠️ 预加载调试工具: window.preloaderDebug')\r\n}\r\n\r\n// 🎯 导出\r\nexport const usePreloader = () => ({\r\n  start: () => preloader.start(),\r\n  isPreloaded: (path) => preloader.isPreloaded(path),\r\n  StatusComponent: preloader.createStatusComponent()\r\n})\r\n\r\n// 🚀 自动启动\r\nif (typeof window !== 'undefined') {\r\n  setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay || 2000)\r\n}`","// ============================================================================\r\n// 🛠️ src/generator.ts - 代码生成器\r\n// ============================================================================\r\n\r\nimport type { PreloaderOptions, PreloadRoute } from './types'\r\nimport { runtimeTemplate } from './runtime'\r\n\r\nexport class CodeGenerator {\r\n  constructor(private options: PreloaderOptions) {}\r\n\r\n  /**\r\n   * 生成运行时代码\r\n   */\r\n  generateRuntime(): string {\r\n    const routes = this.processRoutes()\r\n    const options = this.processOptions()\r\n\r\n    return runtimeTemplate\r\n      .replace('__PRELOAD_ROUTES__', JSON.stringify(routes, null, 2))\r\n      .replace('__PRELOAD_OPTIONS__', JSON.stringify(options, null, 2))\r\n  }\r\n\r\n  /**\r\n   * 处理路由配置\r\n   */\r\n  private processRoutes(): any[] {\r\n    return this.options.routes.map(route => {\r\n      const componentPath = route.component || this.inferComponentPath(route.path)\r\n      return {\r\n        path: route.path,\r\n        component: `() => import('${componentPath}')`,\r\n        reason: route.reason || '用户配置的预加载页面',\r\n        priority: route.priority || 2\r\n      }\r\n    })\r\n  }\r\n\r\n  /**\r\n   * 处理选项配置\r\n   */\r\n  private processOptions() {\r\n    return {\r\n      delay: this.options.delay || 2000,\r\n      showStatus: this.options.showStatus !== false,\r\n      statusPosition: this.options.statusPosition || 'bottom-right',\r\n      debug: this.options.debug || false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 推断组件路径\r\n   */\r\n  private inferComponentPath(routePath: string): string {\r\n    const cleanPath = routePath.replace(/^\\//, '').replace(/\\//g, '-')\r\n    return `@/views/${cleanPath}/index.vue`\r\n  }\r\n\r\n  /**\r\n   * 生成HTML注入代码\r\n   */\r\n  generateHtmlInject(): string {\r\n    if (this.options.showStatus === false) return ''\r\n    \r\n    return '<preloader-status></preloader-status>'\r\n  }\r\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIO,IAAM,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGxB,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,SAA2B;AAA3B;AAAA,EAA4B;AAAA;AAAA;AAAA;AAAA,EAKhD,kBAA0B;AACxB,UAAM,SAAS,KAAK,cAAc;AAClC,UAAM,UAAU,KAAK,eAAe;AAEpC,WAAO,gBACJ,QAAQ,sBAAsB,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC,EAC7D,QAAQ,uBAAuB,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA,EAKQ,gBAAuB;AAC7B,WAAO,KAAK,QAAQ,OAAO,IAAI,WAAS;AACtC,YAAM,gBAAgB,MAAM,aAAa,KAAK,mBAAmB,MAAM,IAAI;AAC3E,aAAO;AAAA,QACL,MAAM,MAAM;AAAA,QACZ,WAAW,iBAAiB,aAAa;AAAA,QACzC,QAAQ,MAAM,UAAU;AAAA,QACxB,UAAU,MAAM,YAAY;AAAA,MAC9B;AAAA,IACF,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKQ,iBAAiB;AACvB,WAAO;AAAA,MACL,OAAO,KAAK,QAAQ,SAAS;AAAA,MAC7B,YAAY,KAAK,QAAQ,eAAe;AAAA,MACxC,gBAAgB,KAAK,QAAQ,kBAAkB;AAAA,MAC/C,OAAO,KAAK,QAAQ,SAAS;AAAA,IAC/B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,mBAAmB,WAA2B;AACpD,UAAM,YAAY,UAAU,QAAQ,OAAO,EAAE,EAAE,QAAQ,OAAO,GAAG;AACjE,WAAO,WAAW,SAAS;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,qBAA6B;AAC3B,QAAI,KAAK,QAAQ,eAAe,MAAO,QAAO;AAE9C,WAAO;AAAA,EACT;AACF;;;AFzDA,IAAM,oBAAoB;AAC1B,IAAM,6BAA6B,OAAO;AAE3B,SAAR,gBAAiC,SAAmC;AACzE,MAAI;AAEJ,SAAO;AAAA,IACL,MAAM;AAAA;AAAA,IAGN,SAAS;AAAA,IAET,iBAAiB;AACf,kBAAY,IAAI,cAAc,OAAO;AACrC,cAAQ,IAAI,sFAAmB,QAAQ,OAAO,MAAM,qBAAM;AAAA,IAC5D;AAAA,IAEA,UAAU,IAAI;AACZ,UAAI,OAAO,mBAAmB;AAC5B,eAAO;AAAA,MACT;AACA,aAAO;AAAA,IACT;AAAA,IAEA,KAAK,IAAI;AACP,UAAI,OAAO,4BAA4B;AACrC,eAAO,UAAU,gBAAgB;AAAA,MACnC;AACA,aAAO;AAAA,IACT;AAAA;AAAA,IAGA,mBAAmB,MAAM;AACvB,YAAM,SAAS,UAAU,mBAAmB;AAC5C,UAAI,QAAQ;AACV,eAAO,KAAK;AAAA,UACV;AAAA,UACA;AAAA,MAAuB,MAAM;AAAA,QAC/B;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA;AAAA,IAGA,gBAAgB,KAAK;AACnB,UAAI,IAAI,KAAK,SAAS,aAAa,GAAG;AACpC,gBAAQ,IAAI,4DAAa;AACzB,YAAI,OAAO,GAAG,KAAK;AAAA,UACjB,MAAM;AAAA,QACR,CAAC;AACD,eAAO,CAAC;AAAA,MACV;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,260 @@
+// vite-plugin-preloader - 智能路由预加载插件
+
+// src/runtime.ts
+var runtimeTemplate = `// \u{1F680} Auto-generated by vite-plugin-preloader
+import { ref, defineComponent, h, onMounted } from 'vue'
+
+interface PreloadRoute {
+  path: string
+  component: () => Promise<any>
+  reason: string
+  priority: number
+}
+
+interface PreloadStats {
+  total: number
+  completed: number
+  failed: number
+  startTime: number
+  endTime: number
+}
+
+// \u{1F3AF} \u9884\u52A0\u8F7D\u914D\u7F6E\uFF08\u6784\u5EFA\u65F6\u6CE8\u5165\uFF09
+const PRELOAD_ROUTES = __PRELOAD_ROUTES__
+const PRELOAD_OPTIONS = __PRELOAD_OPTIONS__
+
+class PreloaderManager {
+  private preloadedRoutes = new Set()
+  private isPreloading = ref(false)
+  private stats = ref({
+    total: 0, completed: 0, failed: 0, startTime: 0, endTime: 0
+  })
+
+  async start() {
+    if (this.isPreloading.value) return
+
+    this.isPreloading.value = true
+    this.stats.value = {
+      total: PRELOAD_ROUTES.length,
+      completed: 0, failed: 0,
+      startTime: Date.now(), endTime: 0
+    }
+
+    console.log(\`\u{1F680} [\u9884\u52A0\u8F7D] \u5F00\u59CB\u9884\u52A0\u8F7D \${PRELOAD_ROUTES.length} \u4E2A\u9875\u9762\`)
+
+    const sortedRoutes = [...PRELOAD_ROUTES].sort((a, b) => a.priority - b.priority)
+    
+    for (const route of sortedRoutes) {
+      await this.preloadSingle(route)
+      await this.sleep(100)
+    }
+
+    this.stats.value.endTime = Date.now()
+    this.isPreloading.value = false
+    
+    console.log(\`\u{1F389} [\u9884\u52A0\u8F7D] \u5B8C\u6210! \u8017\u65F6 \${this.stats.value.endTime - this.stats.value.startTime}ms\`)
+  }
+
+  async preloadSingle(route) {
+    if (this.preloadedRoutes.has(route.path)) return
+
+    try {
+      const startTime = Date.now()
+      await route.component()
+      const loadTime = Date.now() - startTime
+      
+      this.preloadedRoutes.add(route.path)
+      this.stats.value.completed++
+      console.log(\`\u2705 [\u9884\u52A0\u8F7D] \${route.path} (\${loadTime}ms) - \${route.reason}\`)
+    } catch (error) {
+      this.stats.value.failed++
+      console.error(\`\u274C [\u9884\u52A0\u8F7D] \${route.path} \u5931\u8D25:\`, error)
+    }
+  }
+
+  sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms))
+  }
+
+  isPreloaded(path) {
+    return this.preloadedRoutes.has(path)
+  }
+
+  getStats() {
+    return {
+      ...this.stats.value,
+      preloadedPaths: Array.from(this.preloadedRoutes),
+      isPreloading: this.isPreloading.value
+    }
+  }
+
+  createStatusComponent() {
+    const self = this
+    return defineComponent({
+      name: 'PreloadStatus',
+      setup() {
+        onMounted(() => {
+          if (!document.getElementById('preloader-styles')) {
+            const style = document.createElement('style')
+            style.id = 'preloader-styles'
+            const position = PRELOAD_OPTIONS.statusPosition.replace('-', ': 20px; ') + ': 20px;'
+            style.textContent = \`
+              .preloader-status {
+                position: fixed; \${position}
+                background: rgba(0,0,0,0.8); color: white; padding: 8px 16px;
+                border-radius: 6px; font-size: 12px; z-index: 9999;
+                pointer-events: none; font-family: system-ui;
+              }
+            \`
+            document.head.appendChild(style)
+          }
+        })
+
+        return () => {
+          if (!self.isPreloading.value || !import.meta.env.DEV || !PRELOAD_OPTIONS.showStatus) {
+            return null
+          }
+          return h('div', { class: 'preloader-status' }, [
+            '\u{1F504} \u6B63\u5728\u4F18\u5316\u9875\u9762... ',
+            \`\${self.stats.value.completed}/\${self.stats.value.total}\`
+          ])
+        }
+      }
+    })
+  }
+}
+
+// \u{1F680} \u5168\u5C40\u5B9E\u4F8B
+const preloader = new PreloaderManager()
+
+// \u{1F6E0}\uFE0F \u5F00\u53D1\u73AF\u5883\u8C03\u8BD5\u5DE5\u5177
+if (import.meta.env.DEV && PRELOAD_OPTIONS.debug) {
+  window.preloaderDebug = {
+    stats: () => preloader.getStats(),
+    restart: () => preloader.start(),
+    check: (path) => preloader.isPreloaded(path),
+    help: () => console.log('\u{1F6E0}\uFE0F \u9884\u52A0\u8F7D\u8C03\u8BD5: stats() | restart() | check(path)')
+  }
+  console.log('\u{1F6E0}\uFE0F \u9884\u52A0\u8F7D\u8C03\u8BD5\u5DE5\u5177: window.preloaderDebug')
+}
+
+// \u{1F3AF} \u5BFC\u51FA
+export const usePreloader = () => ({
+  start: () => preloader.start(),
+  isPreloaded: (path) => preloader.isPreloaded(path),
+  StatusComponent: preloader.createStatusComponent()
+})
+
+// \u{1F680} \u81EA\u52A8\u542F\u52A8
+if (typeof window !== 'undefined') {
+  setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay || 2000)
+}`;
+
+// src/generator.ts
+var CodeGenerator = class {
+  constructor(options) {
+    this.options = options;
+  }
+  /**
+   * 生成运行时代码
+   */
+  generateRuntime() {
+    const routes = this.processRoutes();
+    const options = this.processOptions();
+    return runtimeTemplate.replace("__PRELOAD_ROUTES__", JSON.stringify(routes, null, 2)).replace("__PRELOAD_OPTIONS__", JSON.stringify(options, null, 2));
+  }
+  /**
+   * 处理路由配置
+   */
+  processRoutes() {
+    return this.options.routes.map((route) => {
+      const componentPath = route.component || this.inferComponentPath(route.path);
+      return {
+        path: route.path,
+        component: `() => import('${componentPath}')`,
+        reason: route.reason || "\u7528\u6237\u914D\u7F6E\u7684\u9884\u52A0\u8F7D\u9875\u9762",
+        priority: route.priority || 2
+      };
+    });
+  }
+  /**
+   * 处理选项配置
+   */
+  processOptions() {
+    return {
+      delay: this.options.delay || 2e3,
+      showStatus: this.options.showStatus !== false,
+      statusPosition: this.options.statusPosition || "bottom-right",
+      debug: this.options.debug || false
+    };
+  }
+  /**
+   * 推断组件路径
+   */
+  inferComponentPath(routePath) {
+    const cleanPath = routePath.replace(/^\//, "").replace(/\//g, "-");
+    return `@/views/${cleanPath}/index.vue`;
+  }
+  /**
+   * 生成HTML注入代码
+   */
+  generateHtmlInject() {
+    if (this.options.showStatus === false) return "";
+    return "<preloader-status></preloader-status>";
+  }
+};
+
+// src/index.ts
+var VIRTUAL_MODULE_ID = "virtual:preloader";
+var RESOLVED_VIRTUAL_MODULE_ID = "\0" + VIRTUAL_MODULE_ID;
+function preloaderPlugin(options) {
+  let generator;
+  return {
+    name: "vite-plugin-preloader",
+    // 🎯 设置插件执行顺序
+    enforce: "post",
+    configResolved() {
+      generator = new CodeGenerator(options);
+      console.log(`\u{1F680} \u9884\u52A0\u8F7D\u63D2\u4EF6\u5DF2\u542F\u7528\uFF0C\u914D\u7F6E\u4E86 ${options.routes.length} \u4E2A\u8DEF\u7531`);
+    },
+    resolveId(id) {
+      if (id === VIRTUAL_MODULE_ID) {
+        return RESOLVED_VIRTUAL_MODULE_ID;
+      }
+      return null;
+    },
+    load(id) {
+      if (id === RESOLVED_VIRTUAL_MODULE_ID) {
+        return generator.generateRuntime();
+      }
+      return null;
+    },
+    // 🎨 HTML 转换（修复类型错误）
+    transformIndexHtml(html) {
+      const inject = generator.generateHtmlInject();
+      if (inject) {
+        return html.replace(
+          '<div id="app">',
+          `<div id="app">
+    ${inject}`
+        );
+      }
+      return html;
+    },
+    // 🔥 HMR 支持
+    handleHotUpdate(ctx) {
+      if (ctx.file.includes("vite.config")) {
+        console.log("\u{1F504} \u9884\u52A0\u8F7D\u914D\u7F6E\u5DF2\u66F4\u65B0");
+        ctx.server.ws.send({
+          type: "full-reload"
+        });
+        return [];
+      }
+      return void 0;
+    }
+  };
+}
+export {
+  preloaderPlugin as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime.ts","../src/generator.ts","../src/index.ts"],"sourcesContent":["// ============================================================================\r\n// ⚡ src/runtime.ts - 运行时代码模板（字符串）\r\n// ============================================================================\r\n\r\nexport const runtimeTemplate = `// 🚀 Auto-generated by vite-plugin-preloader\r\nimport { ref, defineComponent, h, onMounted } from 'vue'\r\n\r\ninterface PreloadRoute {\r\n  path: string\r\n  component: () => Promise<any>\r\n  reason: string\r\n  priority: number\r\n}\r\n\r\ninterface PreloadStats {\r\n  total: number\r\n  completed: number\r\n  failed: number\r\n  startTime: number\r\n  endTime: number\r\n}\r\n\r\n// 🎯 预加载配置（构建时注入）\r\nconst PRELOAD_ROUTES = __PRELOAD_ROUTES__\r\nconst PRELOAD_OPTIONS = __PRELOAD_OPTIONS__\r\n\r\nclass PreloaderManager {\r\n  private preloadedRoutes = new Set()\r\n  private isPreloading = ref(false)\r\n  private stats = ref({\r\n    total: 0, completed: 0, failed: 0, startTime: 0, endTime: 0\r\n  })\r\n\r\n  async start() {\r\n    if (this.isPreloading.value) return\r\n\r\n    this.isPreloading.value = true\r\n    this.stats.value = {\r\n      total: PRELOAD_ROUTES.length,\r\n      completed: 0, failed: 0,\r\n      startTime: Date.now(), endTime: 0\r\n    }\r\n\r\n    console.log(\\`🚀 [预加载] 开始预加载 \\${PRELOAD_ROUTES.length} 个页面\\`)\r\n\r\n    const sortedRoutes = [...PRELOAD_ROUTES].sort((a, b) => a.priority - b.priority)\r\n    \r\n    for (const route of sortedRoutes) {\r\n      await this.preloadSingle(route)\r\n      await this.sleep(100)\r\n    }\r\n\r\n    this.stats.value.endTime = Date.now()\r\n    this.isPreloading.value = false\r\n    \r\n    console.log(\\`🎉 [预加载] 完成! 耗时 \\${this.stats.value.endTime - this.stats.value.startTime}ms\\`)\r\n  }\r\n\r\n  async preloadSingle(route) {\r\n    if (this.preloadedRoutes.has(route.path)) return\r\n\r\n    try {\r\n      const startTime = Date.now()\r\n      await route.component()\r\n      const loadTime = Date.now() - startTime\r\n      \r\n      this.preloadedRoutes.add(route.path)\r\n      this.stats.value.completed++\r\n      console.log(\\`✅ [预加载] \\${route.path} (\\${loadTime}ms) - \\${route.reason}\\`)\r\n    } catch (error) {\r\n      this.stats.value.failed++\r\n      console.error(\\`❌ [预加载] \\${route.path} 失败:\\`, error)\r\n    }\r\n  }\r\n\r\n  sleep(ms) {\r\n    return new Promise(resolve => setTimeout(resolve, ms))\r\n  }\r\n\r\n  isPreloaded(path) {\r\n    return this.preloadedRoutes.has(path)\r\n  }\r\n\r\n  getStats() {\r\n    return {\r\n      ...this.stats.value,\r\n      preloadedPaths: Array.from(this.preloadedRoutes),\r\n      isPreloading: this.isPreloading.value\r\n    }\r\n  }\r\n\r\n  createStatusComponent() {\r\n    const self = this\r\n    return defineComponent({\r\n      name: 'PreloadStatus',\r\n      setup() {\r\n        onMounted(() => {\r\n          if (!document.getElementById('preloader-styles')) {\r\n            const style = document.createElement('style')\r\n            style.id = 'preloader-styles'\r\n            const position = PRELOAD_OPTIONS.statusPosition.replace('-', ': 20px; ') + ': 20px;'\r\n            style.textContent = \\`\r\n              .preloader-status {\r\n                position: fixed; \\${position}\r\n                background: rgba(0,0,0,0.8); color: white; padding: 8px 16px;\r\n                border-radius: 6px; font-size: 12px; z-index: 9999;\r\n                pointer-events: none; font-family: system-ui;\r\n              }\r\n            \\`\r\n            document.head.appendChild(style)\r\n          }\r\n        })\r\n\r\n        return () => {\r\n          if (!self.isPreloading.value || !import.meta.env.DEV || !PRELOAD_OPTIONS.showStatus) {\r\n            return null\r\n          }\r\n          return h('div', { class: 'preloader-status' }, [\r\n            '🔄 正在优化页面... ',\r\n            \\`\\${self.stats.value.completed}/\\${self.stats.value.total}\\`\r\n          ])\r\n        }\r\n      }\r\n    })\r\n  }\r\n}\r\n\r\n// 🚀 全局实例\r\nconst preloader = new PreloaderManager()\r\n\r\n// 🛠️ 开发环境调试工具\r\nif (import.meta.env.DEV && PRELOAD_OPTIONS.debug) {\r\n  window.preloaderDebug = {\r\n    stats: () => preloader.getStats(),\r\n    restart: () => preloader.start(),\r\n    check: (path) => preloader.isPreloaded(path),\r\n    help: () => console.log('🛠️ 预加载调试: stats() | restart() | check(path)')\r\n  }\r\n  console.log('🛠️ 预加载调试工具: window.preloaderDebug')\r\n}\r\n\r\n// 🎯 导出\r\nexport const usePreloader = () => ({\r\n  start: () => preloader.start(),\r\n  isPreloaded: (path) => preloader.isPreloaded(path),\r\n  StatusComponent: preloader.createStatusComponent()\r\n})\r\n\r\n// 🚀 自动启动\r\nif (typeof window !== 'undefined') {\r\n  setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay || 2000)\r\n}`","// ============================================================================\r\n// 🛠️ src/generator.ts - 代码生成器\r\n// ============================================================================\r\n\r\nimport type { PreloaderOptions, PreloadRoute } from './types'\r\nimport { runtimeTemplate } from './runtime'\r\n\r\nexport class CodeGenerator {\r\n  constructor(private options: PreloaderOptions) {}\r\n\r\n  /**\r\n   * 生成运行时代码\r\n   */\r\n  generateRuntime(): string {\r\n    const routes = this.processRoutes()\r\n    const options = this.processOptions()\r\n\r\n    return runtimeTemplate\r\n      .replace('__PRELOAD_ROUTES__', JSON.stringify(routes, null, 2))\r\n      .replace('__PRELOAD_OPTIONS__', JSON.stringify(options, null, 2))\r\n  }\r\n\r\n  /**\r\n   * 处理路由配置\r\n   */\r\n  private processRoutes(): any[] {\r\n    return this.options.routes.map(route => {\r\n      const componentPath = route.component || this.inferComponentPath(route.path)\r\n      return {\r\n        path: route.path,\r\n        component: `() => import('${componentPath}')`,\r\n        reason: route.reason || '用户配置的预加载页面',\r\n        priority: route.priority || 2\r\n      }\r\n    })\r\n  }\r\n\r\n  /**\r\n   * 处理选项配置\r\n   */\r\n  private processOptions() {\r\n    return {\r\n      delay: this.options.delay || 2000,\r\n      showStatus: this.options.showStatus !== false,\r\n      statusPosition: this.options.statusPosition || 'bottom-right',\r\n      debug: this.options.debug || false\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 推断组件路径\r\n   */\r\n  private inferComponentPath(routePath: string): string {\r\n    const cleanPath = routePath.replace(/^\\//, '').replace(/\\//g, '-')\r\n    return `@/views/${cleanPath}/index.vue`\r\n  }\r\n\r\n  /**\r\n   * 生成HTML注入代码\r\n   */\r\n  generateHtmlInject(): string {\r\n    if (this.options.showStatus === false) return ''\r\n    \r\n    return '<preloader-status></preloader-status>'\r\n  }\r\n}","// ============================================================================\r\n// 🚀 src/index.ts - 主插件文件\r\n// ============================================================================\r\n\r\nimport type { Plugin } from 'vite'\r\nimport type { PreloaderOptions } from './types'\r\nimport { CodeGenerator } from './generator'\r\n\r\nconst VIRTUAL_MODULE_ID = 'virtual:preloader'\r\nconst RESOLVED_VIRTUAL_MODULE_ID = '\\0' + VIRTUAL_MODULE_ID\r\n\r\nexport default function preloaderPlugin(options: PreloaderOptions): Plugin {\r\n  let generator: CodeGenerator\r\n\r\n  return {\r\n    name: 'vite-plugin-preloader',\r\n    \r\n    // 🎯 设置插件执行顺序\r\n    enforce: 'post',\r\n    \r\n    configResolved() {\r\n      generator = new CodeGenerator(options)\r\n      console.log(`🚀 预加载插件已启用，配置了 ${options.routes.length} 个路由`)\r\n    },\r\n\r\n    resolveId(id) {\r\n      if (id === VIRTUAL_MODULE_ID) {\r\n        return RESOLVED_VIRTUAL_MODULE_ID\r\n      }\r\n      return null // 🔧 修复：明确返回 null\r\n    },\r\n\r\n    load(id) {\r\n      if (id === RESOLVED_VIRTUAL_MODULE_ID) {\r\n        return generator.generateRuntime()\r\n      }\r\n      return null // 🔧 修复：明确返回 null\r\n    },\r\n\r\n    // 🎨 HTML 转换（修复类型错误）\r\n    transformIndexHtml(html) {\r\n      const inject = generator.generateHtmlInject()\r\n      if (inject) {\r\n        return html.replace(\r\n          '<div id=\"app\">',\r\n          `<div id=\"app\">\\n    ${inject}`\r\n        )\r\n      }\r\n      return html // 🔧 修复：确保总是返回 html\r\n    },\r\n\r\n    // 🔥 HMR 支持\r\n    handleHotUpdate(ctx) {\r\n      if (ctx.file.includes('vite.config')) {\r\n        console.log('🔄 预加载配置已更新')\r\n        ctx.server.ws.send({\r\n          type: 'full-reload'\r\n        })\r\n        return []\r\n      }\r\n      return undefined // 🔧 修复：明确返回 undefined\r\n    }\r\n  }\r\n}\r\n\r\n// 命名导出，支持多种导入方式\r\nexport { type PreloaderOptions, type PreloadRoute } from './types'"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "vite-plugin-preloader",
+  "version": "1.0.0",
+  "description": "🚀 Vite plugin for intelligent route preloading - 智能路由预加载插件",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "preload",
+    "vue",
+    "vue3",
+    "performance",
+    "route",
+    "lazy-loading",
+    "optimization",
+    "build-tool",
+    "intelligent",
+    "preloading"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "lint": "eslint src --fix",
+    "format": "prettier --write src/",
+    "type-check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "vite": "^7.0.0 || ^6.0.0 || ^5.0.0",
+    "vue": "^3.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.9",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.21.0",
+    "prettier": "^3.5.3",
+    "tsup": "^8.3.5",
+    "typescript": "~5.8.0",
+    "vite": "^7.0.0",
+    "vitest": "^3.0.8",
+    "vue": "^3.5.13"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "author": {
+    "name": "ChenYu",
+    "email": "ycyplus@gmail.com",
+    "url": "https://github.com/ChenyCHENYU"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/ChenyCHENYU/vite-plugin-preloader#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChenyCHENYU/vite-plugin-preloader.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ChenyCHENYU/vite-plugin-preloader/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}