vite-plugin-preloader/dist/index.mjs.map

🚀 Vite plugin for intelligent route preloading - 智能路由预加载插件

{"version":3,"sources":["../src/runtime.ts","../src/generator.ts","../src/index.ts"],"sourcesContent":["// ============================================================================\r\n// ⚡ src/runtime.ts - 运行时代码模板（字符串）\r\n// ============================================================================\r\nexport const runtimeTemplate = `// 🚀 Auto-generated by vite-plugin-preloader\r\n(function() {\r\n  'use strict';\r\n  \r\n  // 🎯 预加载配置（构建时注入）\r\n  const PRELOAD_ROUTES = __PRELOAD_ROUTES__\r\n  const PRELOAD_OPTIONS = __PRELOAD_OPTIONS__\r\n\r\n  class PreloaderManager {\r\n    constructor() {\r\n      this.preloadedRoutes = new Set()\r\n      this.isPreloading = false\r\n      this.stats = {\r\n        total: 0, completed: 0, failed: 0, startTime: 0, endTime: 0\r\n      }\r\n    }\r\n\r\n    async start() {\r\n      if (this.isPreloading) return\r\n\r\n      this.isPreloading = true\r\n      this.stats = {\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      if (PRELOAD_OPTIONS.debug) {\r\n        console.log(\\`🚀 [预加载] 开始预加载 \\${PRELOAD_ROUTES.length} 个页面\\`)\r\n      }\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.endTime = Date.now()\r\n      this.isPreloading = false\r\n      \r\n      if (PRELOAD_OPTIONS.debug) {\r\n        console.log(\\`🎉 [预加载] 完成! 耗时 \\${this.stats.endTime - this.stats.startTime}ms\\`)\r\n      }\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        let componentPath = route.component\r\n        \r\n        // 在开发环境中，Vite 会处理模块解析\r\n        // 我们需要使用正确的模块 ID\r\n        if (componentPath.startsWith('@/')) {\r\n          // 对于 Vite，@ 别名应该在构建时就被解析\r\n          // 但在运行时我们需要使用实际的路径\r\n          componentPath = componentPath.replace('@/', '/src/')\r\n        }\r\n        \r\n        // 确保路径以 / 开头（相对于项目根目录）\r\n        if (!componentPath.startsWith('/') && !componentPath.startsWith('./')) {\r\n          componentPath = '/' + componentPath\r\n        }\r\n        \r\n        if (PRELOAD_OPTIONS.debug) {\r\n          console.log(\\`🔍 [预加载] 尝试加载: \\${componentPath}\\`)\r\n        }\r\n        \r\n        const module = await import(/* @vite-ignore */ componentPath)\r\n        const loadTime = Date.now() - startTime\r\n        \r\n        this.preloadedRoutes.add(route.path)\r\n        this.stats.completed++\r\n        \r\n        if (PRELOAD_OPTIONS.debug) {\r\n          console.log(\\`✅ [预加载] \\${route.path} (\\${loadTime}ms) - \\${route.reason}\\`)\r\n        }\r\n      } catch (error) {\r\n        this.stats.failed++\r\n        if (PRELOAD_OPTIONS.debug) {\r\n          console.error(\\`❌ [预加载] \\${route.path} 失败:\\`, error)\r\n        }\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,\r\n        preloadedPaths: Array.from(this.preloadedRoutes),\r\n        isPreloading: this.isPreloading\r\n      }\r\n    }\r\n  }\r\n\r\n  // 🚀 全局实例\r\n  const preloader = new PreloaderManager()\r\n\r\n  // 🛠️ 开发环境调试工具\r\n  if (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  // 🚀 自动启动 - 等待 DOM 加载完成\r\n  function autoStart() {\r\n    if (document.readyState === 'loading') {\r\n      document.addEventListener('DOMContentLoaded', () => {\r\n        setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay)\r\n      })\r\n    } else {\r\n      setTimeout(() => preloader.start(), PRELOAD_OPTIONS.delay)\r\n    }\r\n  }\r\n\r\n  // 立即执行自动启动\r\n  autoStart()\r\n\r\n  // 导出到全局（可选使用）\r\n  window.usePreloader = () => ({\r\n    start: () => preloader.start(),\r\n    isPreloaded: (path) => preloader.isPreloaded(path),\r\n    getStats: () => preloader.getStats()\r\n  })\r\n\r\n})();`","// ============================================================================\r\n// 🛠️ src/generator.ts - 代码生成器\r\n// ============================================================================\r\nimport type { PreloaderOptions } 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      // 处理字符串输入\r\n      if (typeof route === \"string\") {\r\n        const componentPath = this.inferComponentPath(route);\r\n        return {\r\n          path: route,\r\n          component: componentPath,\r\n          reason: \"自动推断的预加载页面\",\r\n          priority: 2,\r\n        };\r\n      }\r\n\r\n      // 处理对象输入\r\n      const componentPath =\r\n        route.component || this.inferComponentPath(route.path);\r\n      return {\r\n        path: route.path,\r\n        component: 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    // 智能默认配置\r\n    const isDev = process.env.NODE_ENV !== \"production\";\r\n\r\n    return {\r\n      delay: this.options.delay ?? 2000, // 默认2秒\r\n      showStatus: this.options.showStatus ?? true, // 默认显示状态\r\n      statusPosition: this.options.statusPosition ?? \"bottom-right\", // 默认右下角\r\n      debug: this.options.debug ?? isDev, // 开发环境默认开启调试，生产环境默认关闭\r\n    };\r\n  }\r\n\r\n  /**\r\n   * 推断组件路径 - 使用 Vite 别名格式\r\n   */\r\n  private inferComponentPath(routePath: string): string {\r\n    const cleanPath = routePath.replace(/^\\//, \"\");\r\n\r\n    // 直接使用 @ 别名，这在 Vite 构建后会被正确解析\r\n    if (cleanPath.startsWith(\"demo/\")) {\r\n      // /demo/13-calendar -> @/views/demo/13-calendar/index.vue\r\n      return `@/views/${cleanPath}/index.vue`;\r\n    }\r\n\r\n    // 其他路径的处理\r\n    const pathSegments = cleanPath.split(\"/\");\r\n    return `@/views/${pathSegments.join(\"/\")}/index.vue`;\r\n  }\r\n\r\n  /**\r\n   * 生成注入到 HTML 头部的脚本\r\n   */\r\n  generateHtmlInject(): string {\r\n    return `<script type=\"module\">\r\n${this.generateRuntime()}\r\n</script>`;\r\n  }\r\n}","import type { Plugin } from 'vite'\r\nimport type { PreloaderOptions } from './types'\r\nimport { CodeGenerator } from './generator'\r\n\r\nexport default function preloaderPlugin(options: PreloaderOptions): Plugin {\r\n  let generator: CodeGenerator\r\n  const isDev = process.env.NODE_ENV !== 'production'\r\n  \r\n  // 智能默认配置\r\n  const finalOptions = {\r\n    debug: isDev, // 开发环境默认开启调试\r\n    delay: 2000,  // 默认2秒\r\n    showStatus: true, // 默认显示状态\r\n    statusPosition: 'bottom-right' as const, // 默认右下角\r\n    ...options // 用户配置覆盖默认配置\r\n  }\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(finalOptions)\r\n      \r\n      if (finalOptions.debug) {\r\n        console.log(`🚀 [预加载插件] 已启用，预加载 ${finalOptions.routes.length} 个页面，详情请查看浏览器控制台`)\r\n      }\r\n    },\r\n\r\n    // 🎨 HTML 转换 - 直接注入脚本到 HTML\r\n    transformIndexHtml(html) {\r\n      const inject = generator.generateHtmlInject()\r\n      \r\n      // 注入到 head 标签末尾\r\n      return html.replace('</head>', `${inject}\\n</head>`)\r\n    },\r\n\r\n    // 🔥 HMR 支持\r\n    handleHotUpdate(ctx) {\r\n      if (ctx.file.includes('vite.config')) {\r\n        if (finalOptions.debug) {\r\n          console.log('🔄 [预加载插件] 配置已更新')\r\n        }\r\n        ctx.server.ws.send({\r\n          type: 'full-reload'\r\n        })\r\n        return []\r\n      }\r\n      return 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":["componentPath"]}