@vlian/framework 1.0.0

package/dist/core/router/performance/RouteCache.cjs

@@ -0,0 +1,286 @@
+/**
+ * 路由缓存管理器
+ * 提供路由转换结果、匹配结果的缓存功能
+ */ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get RouteCache () {
+        return RouteCache;
+    },
+    get getRouteCache () {
+        return getRouteCache;
+    }
+});
+const _utils = require("../../../utils");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let RouteCache = class RouteCache {
+    /**
+   * 初始化持久化缓存
+   */ async initPersistence() {
+        try {
+            // 检查 IndexedDB 是否可用
+            if (typeof window !== 'undefined' && 'indexedDB' in window) {
+                this.persistenceEnabled = true;
+                await this.loadFromPersistence();
+                _utils.logger.debug('路由缓存持久化已启用');
+            }
+        } catch (error) {
+            _utils.logger.warn('路由缓存持久化初始化失败', error);
+            this.persistenceEnabled = false;
+        }
+    }
+    /**
+   * 从持久化存储加载缓存
+   */ async loadFromPersistence() {
+        try {
+        // 这里可以实现从 IndexedDB 加载缓存的逻辑
+        // 由于 IndexedDB 操作较复杂，这里先留空
+        // 实际实现可以使用 idb 库或原生 IndexedDB API
+        } catch (error) {
+            _utils.logger.warn('从持久化存储加载缓存失败', error);
+        }
+    }
+    /**
+   * 保存到持久化存储
+   */ async saveToPersistence(_key, _value) {
+        if (!this.persistenceEnabled) {
+            return;
+        }
+        try {
+        // 这里可以实现保存到 IndexedDB 的逻辑
+        // 实际实现可以使用 idb 库或原生 IndexedDB API
+        } catch (error) {
+            _utils.logger.warn('保存到持久化存储失败', error);
+        }
+    }
+    /**
+   * 生成缓存键
+   */ generateKey(routes) {
+        if (typeof routes === 'function') {
+            // 对于函数，使用函数名或随机 ID
+            return `fn_${routes.name || Math.random().toString(36).substring(7)}`;
+        }
+        // 对于数组，使用 JSON.stringify 生成键（注意：这可能会很慢）
+        // 实际使用中可以考虑使用路由配置的哈希值
+        try {
+            const routesStr = JSON.stringify(routes, (_key, value)=>{
+                // 过滤掉函数，避免序列化问题
+                if (typeof value === 'function') {
+                    return '[Function]';
+                }
+                return value;
+            });
+            return `routes_${this.hashString(routesStr)}`;
+        } catch (error) {
+            // 如果序列化失败，使用随机键
+            return `routes_${Math.random().toString(36).substring(7)}`;
+        }
+    }
+    /**
+   * 字符串哈希函数（简单实现）
+   */ hashString(str) {
+        let hash = 0;
+        for(let i = 0; i < str.length; i++){
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash; // 转换为 32 位整数
+        }
+        return Math.abs(hash).toString(36);
+    }
+    /**
+   * 检查缓存项是否过期
+   */ isExpired(item) {
+        return Date.now() > item.expiresAt;
+    }
+    /**
+   * 清理过期缓存
+   */ cleanup() {
+        // 清理转换结果缓存
+        for (const [key, item] of this.cache.entries()){
+            if (this.isExpired(item)) {
+                this.cache.delete(key);
+            }
+        }
+        // 清理匹配结果缓存
+        for (const [key, item] of this.matchCache.entries()){
+            if (this.isExpired(item)) {
+                this.matchCache.delete(key);
+            }
+        }
+        // 如果缓存超过最大大小，删除最久未访问的项（LRU）
+        this.evictLRU();
+    }
+    /**
+   * LRU 淘汰策略
+   */ evictLRU() {
+        // 清理转换结果缓存
+        if (this.cache.size > this.config.maxSize) {
+            const sorted = Array.from(this.cache.entries()).sort((a, b)=>a[1].lastAccessedAt - b[1].lastAccessedAt);
+            const toDelete = sorted.slice(0, this.cache.size - this.config.maxSize);
+            toDelete.forEach(([key])=>this.cache.delete(key));
+        }
+        // 清理匹配结果缓存
+        if (this.matchCache.size > this.config.maxSize) {
+            const sorted = Array.from(this.matchCache.entries()).sort((a, b)=>a[1].lastAccessedAt - b[1].lastAccessedAt);
+            const toDelete = sorted.slice(0, this.matchCache.size - this.config.maxSize);
+            toDelete.forEach(([key])=>this.matchCache.delete(key));
+        }
+    }
+    /**
+   * 启动定期清理
+   */ startCleanupInterval() {
+        // 每 1 分钟清理一次过期缓存
+        setInterval(()=>{
+            this.cleanup();
+        }, 60 * 1000);
+    }
+    /**
+   * 获取转换结果缓存
+   */ get(routes) {
+        const key = this.generateKey(routes);
+        const item = this.cache.get(key);
+        if (!item) {
+            return null;
+        }
+        if (this.isExpired(item)) {
+            this.cache.delete(key);
+            return null;
+        }
+        // 更新访问信息
+        item.lastAccessedAt = Date.now();
+        item.accessCount++;
+        return item.value;
+    }
+    /**
+   * 设置转换结果缓存
+   */ set(routes, value) {
+        const key = this.generateKey(routes);
+        const now = Date.now();
+        const item = {
+            value,
+            expiresAt: now + this.config.ttl,
+            createdAt: now,
+            accessCount: 0,
+            lastAccessedAt: now
+        };
+        this.cache.set(key, item);
+        // 保存到持久化存储
+        if (this.persistenceEnabled) {
+            this.saveToPersistence(key, value).catch((error)=>{
+                _utils.logger.warn('保存缓存到持久化存储失败', error);
+            });
+        }
+        // 检查是否需要淘汰
+        this.evictLRU();
+    }
+    /**
+   * 获取路由匹配缓存
+   */ getMatch(path) {
+        const item = this.matchCache.get(path);
+        if (!item) {
+            return undefined;
+        }
+        if (this.isExpired(item)) {
+            this.matchCache.delete(path);
+            return undefined;
+        }
+        // 更新访问信息
+        item.lastAccessedAt = Date.now();
+        item.accessCount++;
+        return item.value;
+    }
+    /**
+   * 设置路由匹配缓存
+   */ setMatch(path, route) {
+        const now = Date.now();
+        const item = {
+            value: route,
+            expiresAt: now + this.config.ttl,
+            createdAt: now,
+            accessCount: 0,
+            lastAccessedAt: now
+        };
+        this.matchCache.set(path, item);
+        // 检查是否需要淘汰
+        this.evictLRU();
+    }
+    /**
+   * 清空所有缓存
+   */ clear() {
+        this.cache.clear();
+        this.matchCache.clear();
+        _utils.logger.debug('路由缓存已清空');
+    }
+    /**
+   * 获取缓存统计信息
+   */ getStats() {
+        let totalHits = 0;
+        let totalAccess = 0;
+        // 统计转换结果缓存
+        for (const item of this.cache.values()){
+            totalHits += item.accessCount;
+            totalAccess += item.accessCount;
+        }
+        // 统计匹配结果缓存
+        for (const item of this.matchCache.values()){
+            totalHits += item.accessCount;
+            totalAccess += item.accessCount;
+        }
+        const hitRate = totalAccess > 0 ? totalHits / totalAccess : 0;
+        return {
+            transformCacheSize: this.cache.size,
+            matchCacheSize: this.matchCache.size,
+            totalSize: this.cache.size + this.matchCache.size,
+            hitRate
+        };
+    }
+    constructor(config = {}){
+        _define_property(this, "cache", new Map());
+        _define_property(this, "matchCache", new Map());
+        _define_property(this, "config", void 0);
+        _define_property(this, "persistenceEnabled", false);
+        this.config = {
+            maxSize: config.maxSize ?? 50,
+            ttl: config.ttl ?? 5 * 60 * 1000,
+            enablePersistence: config.enablePersistence ?? false,
+            persistenceKeyPrefix: config.persistenceKeyPrefix ?? 'router_cache_'
+        };
+        // 初始化持久化缓存
+        if (this.config.enablePersistence && typeof window !== 'undefined' && 'indexedDB' in window) {
+            this.initPersistence();
+        }
+        // 定期清理过期缓存
+        this.startCleanupInterval();
+    }
+};
+/**
+ * 获取路由缓存管理器单例
+ */ let routeCacheInstance = null;
+function getRouteCache(config) {
+    if (!routeCacheInstance) {
+        routeCacheInstance = new RouteCache(config);
+    }
+    return routeCacheInstance;
+}
+
+//# sourceMappingURL=RouteCache.js.map

package/dist/core/router/performance/RouteCache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/core/router/performance/RouteCache.ts"],"sourcesContent":["/**\n * 路由缓存管理器\n * 提供路由转换结果、匹配结果的缓存功能\n */\n\nimport { logger } from '../../../utils';\nimport type { RouteConfig } from '../types';\nimport type { TransformRoutesResult } from '../utils/transform';\n\n/**\n * 缓存项接口\n */\ninterface CacheItem<T> {\n  /**\n   * 缓存值\n   */\n  value: T;\n  /**\n   * 过期时间戳\n   */\n  expiresAt: number;\n  /**\n   * 创建时间戳\n   */\n  createdAt: number;\n  /**\n   * 访问次数\n   */\n  accessCount: number;\n  /**\n   * 最后访问时间\n   */\n  lastAccessedAt: number;\n}\n\n/**\n * LRU 缓存配置\n */\nexport interface RouteCacheConfig {\n  /**\n   * 最大缓存数量\n   * @default 50\n   */\n  maxSize?: number;\n\n  /**\n   * 缓存过期时间（毫秒）\n   * @default 5 * 60 * 1000 (5分钟)\n   */\n  ttl?: number;\n\n  /**\n   * 是否启用持久化缓存（使用 IndexedDB）\n   * @default false\n   */\n  enablePersistence?: boolean;\n\n  /**\n   * 持久化缓存键前缀\n   * @default 'router_cache_'\n   */\n  persistenceKeyPrefix?: string;\n}\n\n/**\n * 路由缓存管理器\n */\nexport class RouteCache {\n  private cache: Map<string, CacheItem<TransformRoutesResult>> = new Map();\n  private matchCache: Map<string, CacheItem<RouteConfig | null>> = new Map();\n  private config: Required<RouteCacheConfig>;\n  private persistenceEnabled: boolean = false;\n\n  constructor(config: RouteCacheConfig = {}) {\n    this.config = {\n      maxSize: config.maxSize ?? 50,\n      ttl: config.ttl ?? 5 * 60 * 1000,\n      enablePersistence: config.enablePersistence ?? false,\n      persistenceKeyPrefix: config.persistenceKeyPrefix ?? 'router_cache_',\n    };\n\n    // 初始化持久化缓存\n    if (this.config.enablePersistence && typeof window !== 'undefined' && 'indexedDB' in window) {\n      this.initPersistence();\n    }\n\n    // 定期清理过期缓存\n    this.startCleanupInterval();\n  }\n\n  /**\n   * 初始化持久化缓存\n   */\n  private async initPersistence(): Promise<void> {\n    try {\n      // 检查 IndexedDB 是否可用\n      if (typeof window !== 'undefined' && 'indexedDB' in window) {\n        this.persistenceEnabled = true;\n        await this.loadFromPersistence();\n        logger.debug('路由缓存持久化已启用');\n      }\n    } catch (error) {\n      logger.warn('路由缓存持久化初始化失败', error);\n      this.persistenceEnabled = false;\n    }\n  }\n\n  /**\n   * 从持久化存储加载缓存\n   */\n  private async loadFromPersistence(): Promise<void> {\n    try {\n      // 这里可以实现从 IndexedDB 加载缓存的逻辑\n      // 由于 IndexedDB 操作较复杂，这里先留空\n      // 实际实现可以使用 idb 库或原生 IndexedDB API\n    } catch (error) {\n      logger.warn('从持久化存储加载缓存失败', error);\n    }\n  }\n\n  /**\n   * 保存到持久化存储\n   */\n  private async saveToPersistence(_key: string, _value: TransformRoutesResult): Promise<void> {\n    if (!this.persistenceEnabled) {\n      return;\n    }\n\n    try {\n      // 这里可以实现保存到 IndexedDB 的逻辑\n      // 实际实现可以使用 idb 库或原生 IndexedDB API\n    } catch (error) {\n      logger.warn('保存到持久化存储失败', error);\n    }\n  }\n\n  /**\n   * 生成缓存键\n   */\n  private generateKey(routes: RouteConfig[] | (() => Promise<RouteConfig[]>)): string {\n    if (typeof routes === 'function') {\n      // 对于函数，使用函数名或随机 ID\n      return `fn_${routes.name || Math.random().toString(36).substring(7)}`;\n    }\n\n    // 对于数组，使用 JSON.stringify 生成键（注意：这可能会很慢）\n    // 实际使用中可以考虑使用路由配置的哈希值\n    try {\n      const routesStr = JSON.stringify(routes, (_key, value) => {\n        // 过滤掉函数，避免序列化问题\n        if (typeof value === 'function') {\n          return '[Function]';\n        }\n        return value;\n      });\n      return `routes_${this.hashString(routesStr)}`;\n    } catch (error) {\n      // 如果序列化失败，使用随机键\n      return `routes_${Math.random().toString(36).substring(7)}`;\n    }\n  }\n\n  /**\n   * 字符串哈希函数（简单实现）\n   */\n  private hashString(str: string): string {\n    let hash = 0;\n    for (let i = 0; i < str.length; i++) {\n      const char = str.charCodeAt(i);\n      hash = (hash << 5) - hash + char;\n      hash = hash & hash; // 转换为 32 位整数\n    }\n    return Math.abs(hash).toString(36);\n  }\n\n  /**\n   * 检查缓存项是否过期\n   */\n  private isExpired(item: CacheItem<unknown>): boolean {\n    return Date.now() > item.expiresAt;\n  }\n\n  /**\n   * 清理过期缓存\n   */\n  private cleanup(): void {\n\n    // 清理转换结果缓存\n    for (const [key, item] of this.cache.entries()) {\n      if (this.isExpired(item)) {\n        this.cache.delete(key);\n      }\n    }\n\n    // 清理匹配结果缓存\n    for (const [key, item] of this.matchCache.entries()) {\n      if (this.isExpired(item)) {\n        this.matchCache.delete(key);\n      }\n    }\n\n    // 如果缓存超过最大大小，删除最久未访问的项（LRU）\n    this.evictLRU();\n  }\n\n  /**\n   * LRU 淘汰策略\n   */\n  private evictLRU(): void {\n    // 清理转换结果缓存\n    if (this.cache.size > this.config.maxSize) {\n      const sorted = Array.from(this.cache.entries()).sort(\n        (a, b) => a[1].lastAccessedAt - b[1].lastAccessedAt\n      );\n      const toDelete = sorted.slice(0, this.cache.size - this.config.maxSize);\n      toDelete.forEach(([key]) => this.cache.delete(key));\n    }\n\n    // 清理匹配结果缓存\n    if (this.matchCache.size > this.config.maxSize) {\n      const sorted = Array.from(this.matchCache.entries()).sort(\n        (a, b) => a[1].lastAccessedAt - b[1].lastAccessedAt\n      );\n      const toDelete = sorted.slice(0, this.matchCache.size - this.config.maxSize);\n      toDelete.forEach(([key]) => this.matchCache.delete(key));\n    }\n  }\n\n  /**\n   * 启动定期清理\n   */\n  private startCleanupInterval(): void {\n    // 每 1 分钟清理一次过期缓存\n    setInterval(() => {\n      this.cleanup();\n    }, 60 * 1000);\n  }\n\n  /**\n   * 获取转换结果缓存\n   */\n  get(routes: RouteConfig[] | (() => Promise<RouteConfig[]>)): TransformRoutesResult | null {\n    const key = this.generateKey(routes);\n    const item = this.cache.get(key);\n\n    if (!item) {\n      return null;\n    }\n\n    if (this.isExpired(item)) {\n      this.cache.delete(key);\n      return null;\n    }\n\n    // 更新访问信息\n    item.lastAccessedAt = Date.now();\n    item.accessCount++;\n\n    return item.value;\n  }\n\n  /**\n   * 设置转换结果缓存\n   */\n  set(\n    routes: RouteConfig[] | (() => Promise<RouteConfig[]>),\n    value: TransformRoutesResult\n  ): void {\n    const key = this.generateKey(routes);\n    const now = Date.now();\n\n    const item: CacheItem<TransformRoutesResult> = {\n      value,\n      expiresAt: now + this.config.ttl,\n      createdAt: now,\n      accessCount: 0,\n      lastAccessedAt: now,\n    };\n\n    this.cache.set(key, item);\n\n    // 保存到持久化存储\n    if (this.persistenceEnabled) {\n      this.saveToPersistence(key, value).catch((error) => {\n        logger.warn('保存缓存到持久化存储失败', error);\n      });\n    }\n\n    // 检查是否需要淘汰\n    this.evictLRU();\n  }\n\n  /**\n   * 获取路由匹配缓存\n   */\n  getMatch(path: string): RouteConfig | null | undefined {\n    const item = this.matchCache.get(path);\n\n    if (!item) {\n      return undefined;\n    }\n\n    if (this.isExpired(item)) {\n      this.matchCache.delete(path);\n      return undefined;\n    }\n\n    // 更新访问信息\n    item.lastAccessedAt = Date.now();\n    item.accessCount++;\n\n    return item.value;\n  }\n\n  /**\n   * 设置路由匹配缓存\n   */\n  setMatch(path: string, route: RouteConfig | null): void {\n    const now = Date.now();\n\n    const item: CacheItem<RouteConfig | null> = {\n      value: route,\n      expiresAt: now + this.config.ttl,\n      createdAt: now,\n      accessCount: 0,\n      lastAccessedAt: now,\n    };\n\n    this.matchCache.set(path, item);\n\n    // 检查是否需要淘汰\n    this.evictLRU();\n  }\n\n  /**\n   * 清空所有缓存\n   */\n  clear(): void {\n    this.cache.clear();\n    this.matchCache.clear();\n    logger.debug('路由缓存已清空');\n  }\n\n  /**\n   * 获取缓存统计信息\n   */\n  getStats(): {\n    transformCacheSize: number;\n    matchCacheSize: number;\n    totalSize: number;\n    hitRate: number;\n  } {\n    let totalHits = 0;\n    let totalAccess = 0;\n\n    // 统计转换结果缓存\n    for (const item of this.cache.values()) {\n      totalHits += item.accessCount;\n      totalAccess += item.accessCount;\n    }\n\n    // 统计匹配结果缓存\n    for (const item of this.matchCache.values()) {\n      totalHits += item.accessCount;\n      totalAccess += item.accessCount;\n    }\n\n    const hitRate = totalAccess > 0 ? totalHits / totalAccess : 0;\n\n    return {\n      transformCacheSize: this.cache.size,\n      matchCacheSize: this.matchCache.size,\n      totalSize: this.cache.size + this.matchCache.size,\n      hitRate,\n    };\n  }\n}\n\n/**\n * 获取路由缓存管理器单例\n */\nlet routeCacheInstance: RouteCache | null = null;\n\nexport function getRouteCache(config?: RouteCacheConfig): RouteCache {\n  if (!routeCacheInstance) {\n    routeCacheInstance = new RouteCache(config);\n  }\n  return routeCacheInstance;\n}\n"],"names":["RouteCache","getRouteCache","initPersistence","window","persistenceEnabled","loadFromPersistence","logger","debug","error","warn","saveToPersistence","_key","_value","generateKey","routes","name","Math","random","toString","substring","routesStr","JSON","stringify","value","hashString","str","hash","i","length","char","charCodeAt","abs","isExpired","item","Date","now","expiresAt","cleanup","key","cache","entries","delete","matchCache","evictLRU","size","config","maxSize","sorted","Array","from","sort","a","b","lastAccessedAt","toDelete","slice","forEach","startCleanupInterval","setInterval","get","accessCount","set","ttl","createdAt","catch","getMatch","path","undefined","setMatch","route","clear","getStats","totalHits","totalAccess","values","hitRate","transformCacheSize","matchCacheSize","totalSize","Map","enablePersistence","persistenceKeyPrefix","routeCacheInstance"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;QAgEYA;eAAAA;;QA4TGC;eAAAA;;;uBA1XO;;;;;;;;;;;;;;AA8DhB,IAAA,AAAMD,aAAN,MAAMA;IAuBX;;GAEC,GACD,MAAcE,kBAAiC;QAC7C,IAAI;YACF,oBAAoB;YACpB,IAAI,OAAOC,WAAW,eAAe,eAAeA,QAAQ;gBAC1D,IAAI,CAACC,kBAAkB,GAAG;gBAC1B,MAAM,IAAI,CAACC,mBAAmB;gBAC9BC,aAAM,CAACC,KAAK,CAAC;YACf;QACF,EAAE,OAAOC,OAAO;YACdF,aAAM,CAACG,IAAI,CAAC,gBAAgBD;YAC5B,IAAI,CAACJ,kBAAkB,GAAG;QAC5B;IACF;IAEA;;GAEC,GACD,MAAcC,sBAAqC;QACjD,IAAI;QACF,4BAA4B;QAC5B,2BAA2B;QAC3B,kCAAkC;QACpC,EAAE,OAAOG,OAAO;YACdF,aAAM,CAACG,IAAI,CAAC,gBAAgBD;QAC9B;IACF;IAEA;;GAEC,GACD,MAAcE,kBAAkBC,IAAY,EAAEC,MAA6B,EAAiB;QAC1F,IAAI,CAAC,IAAI,CAACR,kBAAkB,EAAE;YAC5B;QACF;QAEA,IAAI;QACF,0BAA0B;QAC1B,kCAAkC;QACpC,EAAE,OAAOI,OAAO;YACdF,aAAM,CAACG,IAAI,CAAC,cAAcD;QAC5B;IACF;IAEA;;GAEC,GACD,AAAQK,YAAYC,MAAsD,EAAU;QAClF,IAAI,OAAOA,WAAW,YAAY;YAChC,mBAAmB;YACnB,OAAO,CAAC,GAAG,EAAEA,OAAOC,IAAI,IAAIC,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,SAAS,CAAC,IAAI;QACvE;QAEA,wCAAwC;QACxC,sBAAsB;QACtB,IAAI;YACF,MAAMC,YAAYC,KAAKC,SAAS,CAACR,QAAQ,CAACH,MAAMY;gBAC9C,gBAAgB;gBAChB,IAAI,OAAOA,UAAU,YAAY;oBAC/B,OAAO;gBACT;gBACA,OAAOA;YACT;YACA,OAAO,CAAC,OAAO,EAAE,IAAI,CAACC,UAAU,CAACJ,YAAY;QAC/C,EAAE,OAAOZ,OAAO;YACd,gBAAgB;YAChB,OAAO,CAAC,OAAO,EAAEQ,KAAKC,MAAM,GAAGC,QAAQ,CAAC,IAAIC,SAAS,CAAC,IAAI;QAC5D;IACF;IAEA;;GAEC,GACD,AAAQK,WAAWC,GAAW,EAAU;QACtC,IAAIC,OAAO;QACX,IAAK,IAAIC,IAAI,GAAGA,IAAIF,IAAIG,MAAM,EAAED,IAAK;YACnC,MAAME,OAAOJ,IAAIK,UAAU,CAACH;YAC5BD,OAAO,AAACA,CAAAA,QAAQ,CAAA,IAAKA,OAAOG;YAC5BH,OAAOA,OAAOA,MAAM,aAAa;QACnC;QACA,OAAOV,KAAKe,GAAG,CAACL,MAAMR,QAAQ,CAAC;IACjC;IAEA;;GAEC,GACD,AAAQc,UAAUC,IAAwB,EAAW;QACnD,OAAOC,KAAKC,GAAG,KAAKF,KAAKG,SAAS;IACpC;IAEA;;GAEC,GACD,AAAQC,UAAgB;QAEtB,WAAW;QACX,KAAK,MAAM,CAACC,KAAKL,KAAK,IAAI,IAAI,CAACM,KAAK,CAACC,OAAO,GAAI;YAC9C,IAAI,IAAI,CAACR,SAAS,CAACC,OAAO;gBACxB,IAAI,CAACM,KAAK,CAACE,MAAM,CAACH;YACpB;QACF;QAEA,WAAW;QACX,KAAK,MAAM,CAACA,KAAKL,KAAK,IAAI,IAAI,CAACS,UAAU,CAACF,OAAO,GAAI;YACnD,IAAI,IAAI,CAACR,SAAS,CAACC,OAAO;gBACxB,IAAI,CAACS,UAAU,CAACD,MAAM,CAACH;YACzB;QACF;QAEA,4BAA4B;QAC5B,IAAI,CAACK,QAAQ;IACf;IAEA;;GAEC,GACD,AAAQA,WAAiB;QACvB,WAAW;QACX,IAAI,IAAI,CAACJ,KAAK,CAACK,IAAI,GAAG,IAAI,CAACC,MAAM,CAACC,OAAO,EAAE;YACzC,MAAMC,SAASC,MAAMC,IAAI,CAAC,IAAI,CAACV,KAAK,CAACC,OAAO,IAAIU,IAAI,CAClD,CAACC,GAAGC,IAAMD,CAAC,CAAC,EAAE,CAACE,cAAc,GAAGD,CAAC,CAAC,EAAE,CAACC,cAAc;YAErD,MAAMC,WAAWP,OAAOQ,KAAK,CAAC,GAAG,IAAI,CAAChB,KAAK,CAACK,IAAI,GAAG,IAAI,CAACC,MAAM,CAACC,OAAO;YACtEQ,SAASE,OAAO,CAAC,CAAC,CAAClB,IAAI,GAAK,IAAI,CAACC,KAAK,CAACE,MAAM,CAACH;QAChD;QAEA,WAAW;QACX,IAAI,IAAI,CAACI,UAAU,CAACE,IAAI,GAAG,IAAI,CAACC,MAAM,CAACC,OAAO,EAAE;YAC9C,MAAMC,SAASC,MAAMC,IAAI,CAAC,IAAI,CAACP,UAAU,CAACF,OAAO,IAAIU,IAAI,CACvD,CAACC,GAAGC,IAAMD,CAAC,CAAC,EAAE,CAACE,cAAc,GAAGD,CAAC,CAAC,EAAE,CAACC,cAAc;YAErD,MAAMC,WAAWP,OAAOQ,KAAK,CAAC,GAAG,IAAI,CAACb,UAAU,CAACE,IAAI,GAAG,IAAI,CAACC,MAAM,CAACC,OAAO;YAC3EQ,SAASE,OAAO,CAAC,CAAC,CAAClB,IAAI,GAAK,IAAI,CAACI,UAAU,CAACD,MAAM,CAACH;QACrD;IACF;IAEA;;GAEC,GACD,AAAQmB,uBAA6B;QACnC,iBAAiB;QACjBC,YAAY;YACV,IAAI,CAACrB,OAAO;QACd,GAAG,KAAK;IACV;IAEA;;GAEC,GACDsB,IAAI7C,MAAsD,EAAgC;QACxF,MAAMwB,MAAM,IAAI,CAACzB,WAAW,CAACC;QAC7B,MAAMmB,OAAO,IAAI,CAACM,KAAK,CAACoB,GAAG,CAACrB;QAE5B,IAAI,CAACL,MAAM;YACT,OAAO;QACT;QAEA,IAAI,IAAI,CAACD,SAAS,CAACC,OAAO;YACxB,IAAI,CAACM,KAAK,CAACE,MAAM,CAACH;YAClB,OAAO;QACT;QAEA,SAAS;QACTL,KAAKoB,cAAc,GAAGnB,KAAKC,GAAG;QAC9BF,KAAK2B,WAAW;QAEhB,OAAO3B,KAAKV,KAAK;IACnB;IAEA;;GAEC,GACDsC,IACE/C,MAAsD,EACtDS,KAA4B,EACtB;QACN,MAAMe,MAAM,IAAI,CAACzB,WAAW,CAACC;QAC7B,MAAMqB,MAAMD,KAAKC,GAAG;QAEpB,MAAMF,OAAyC;YAC7CV;YACAa,WAAWD,MAAM,IAAI,CAACU,MAAM,CAACiB,GAAG;YAChCC,WAAW5B;YACXyB,aAAa;YACbP,gBAAgBlB;QAClB;QAEA,IAAI,CAACI,KAAK,CAACsB,GAAG,CAACvB,KAAKL;QAEpB,WAAW;QACX,IAAI,IAAI,CAAC7B,kBAAkB,EAAE;YAC3B,IAAI,CAACM,iBAAiB,CAAC4B,KAAKf,OAAOyC,KAAK,CAAC,CAACxD;gBACxCF,aAAM,CAACG,IAAI,CAAC,gBAAgBD;YAC9B;QACF;QAEA,WAAW;QACX,IAAI,CAACmC,QAAQ;IACf;IAEA;;GAEC,GACDsB,SAASC,IAAY,EAAkC;QACrD,MAAMjC,OAAO,IAAI,CAACS,UAAU,CAACiB,GAAG,CAACO;QAEjC,IAAI,CAACjC,MAAM;YACT,OAAOkC;QACT;QAEA,IAAI,IAAI,CAACnC,SAAS,CAACC,OAAO;YACxB,IAAI,CAACS,UAAU,CAACD,MAAM,CAACyB;YACvB,OAAOC;QACT;QAEA,SAAS;QACTlC,KAAKoB,cAAc,GAAGnB,KAAKC,GAAG;QAC9BF,KAAK2B,WAAW;QAEhB,OAAO3B,KAAKV,KAAK;IACnB;IAEA;;GAEC,GACD6C,SAASF,IAAY,EAAEG,KAAyB,EAAQ;QACtD,MAAMlC,MAAMD,KAAKC,GAAG;QAEpB,MAAMF,OAAsC;YAC1CV,OAAO8C;YACPjC,WAAWD,MAAM,IAAI,CAACU,MAAM,CAACiB,GAAG;YAChCC,WAAW5B;YACXyB,aAAa;YACbP,gBAAgBlB;QAClB;QAEA,IAAI,CAACO,UAAU,CAACmB,GAAG,CAACK,MAAMjC;QAE1B,WAAW;QACX,IAAI,CAACU,QAAQ;IACf;IAEA;;GAEC,GACD2B,QAAc;QACZ,IAAI,CAAC/B,KAAK,CAAC+B,KAAK;QAChB,IAAI,CAAC5B,UAAU,CAAC4B,KAAK;QACrBhE,aAAM,CAACC,KAAK,CAAC;IACf;IAEA;;GAEC,GACDgE,WAKE;QACA,IAAIC,YAAY;QAChB,IAAIC,cAAc;QAElB,WAAW;QACX,KAAK,MAAMxC,QAAQ,IAAI,CAACM,KAAK,CAACmC,MAAM,GAAI;YACtCF,aAAavC,KAAK2B,WAAW;YAC7Ba,eAAexC,KAAK2B,WAAW;QACjC;QAEA,WAAW;QACX,KAAK,MAAM3B,QAAQ,IAAI,CAACS,UAAU,CAACgC,MAAM,GAAI;YAC3CF,aAAavC,KAAK2B,WAAW;YAC7Ba,eAAexC,KAAK2B,WAAW;QACjC;QAEA,MAAMe,UAAUF,cAAc,IAAID,YAAYC,cAAc;QAE5D,OAAO;YACLG,oBAAoB,IAAI,CAACrC,KAAK,CAACK,IAAI;YACnCiC,gBAAgB,IAAI,CAACnC,UAAU,CAACE,IAAI;YACpCkC,WAAW,IAAI,CAACvC,KAAK,CAACK,IAAI,GAAG,IAAI,CAACF,UAAU,CAACE,IAAI;YACjD+B;QACF;IACF;IA9SA,YAAY9B,SAA2B,CAAC,CAAC,CAAE;QAL3C,uBAAQN,SAAuD,IAAIwC;QACnE,uBAAQrC,cAAyD,IAAIqC;QACrE,uBAAQlC,UAAR,KAAA;QACA,uBAAQzC,sBAA8B;QAGpC,IAAI,CAACyC,MAAM,GAAG;YACZC,SAASD,OAAOC,OAAO,IAAI;YAC3BgB,KAAKjB,OAAOiB,GAAG,IAAI,IAAI,KAAK;YAC5BkB,mBAAmBnC,OAAOmC,iBAAiB,IAAI;YAC/CC,sBAAsBpC,OAAOoC,oBAAoB,IAAI;QACvD;QAEA,WAAW;QACX,IAAI,IAAI,CAACpC,MAAM,CAACmC,iBAAiB,IAAI,OAAO7E,WAAW,eAAe,eAAeA,QAAQ;YAC3F,IAAI,CAACD,eAAe;QACtB;QAEA,WAAW;QACX,IAAI,CAACuD,oBAAoB;IAC3B;AAgSF;AAEA;;CAEC,GACD,IAAIyB,qBAAwC;AAErC,SAASjF,cAAc4C,MAAyB;IACrD,IAAI,CAACqC,oBAAoB;QACvBA,qBAAqB,IAAIlF,WAAW6C;IACtC;IACA,OAAOqC;AACT"}

package/dist/core/router/performance/RouteCache.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 路由缓存管理器
+ * 提供路由转换结果、匹配结果的缓存功能
+ */
+import type { RouteConfig } from '../types';
+import type { TransformRoutesResult } from '../utils/transform';
+/**
+ * LRU 缓存配置
+ */
+export interface RouteCacheConfig {
+    /**
+     * 最大缓存数量
+     * @default 50
+     */
+    maxSize?: number;
+    /**
+     * 缓存过期时间（毫秒）
+     * @default 5 * 60 * 1000 (5分钟)
+     */
+    ttl?: number;
+    /**
+     * 是否启用持久化缓存（使用 IndexedDB）
+     * @default false
+     */
+    enablePersistence?: boolean;
+    /**
+     * 持久化缓存键前缀
+     * @default 'router_cache_'
+     */
+    persistenceKeyPrefix?: string;
+}
+/**
+ * 路由缓存管理器
+ */
+export declare class RouteCache {
+    private cache;
+    private matchCache;
+    private config;
+    private persistenceEnabled;
+    constructor(config?: RouteCacheConfig);
+    /**
+     * 初始化持久化缓存
+     */
+    private initPersistence;
+    /**
+     * 从持久化存储加载缓存
+     */
+    private loadFromPersistence;
+    /**
+     * 保存到持久化存储
+     */
+    private saveToPersistence;
+    /**
+     * 生成缓存键
+     */
+    private generateKey;
+    /**
+     * 字符串哈希函数（简单实现）
+     */
+    private hashString;
+    /**
+     * 检查缓存项是否过期
+     */
+    private isExpired;
+    /**
+     * 清理过期缓存
+     */
+    private cleanup;
+    /**
+     * LRU 淘汰策略
+     */
+    private evictLRU;
+    /**
+     * 启动定期清理
+     */
+    private startCleanupInterval;
+    /**
+     * 获取转换结果缓存
+     */
+    get(routes: RouteConfig[] | (() => Promise<RouteConfig[]>)): TransformRoutesResult | null;
+    /**
+     * 设置转换结果缓存
+     */
+    set(routes: RouteConfig[] | (() => Promise<RouteConfig[]>), value: TransformRoutesResult): void;
+    /**
+     * 获取路由匹配缓存
+     */
+    getMatch(path: string): RouteConfig | null | undefined;
+    /**
+     * 设置路由匹配缓存
+     */
+    setMatch(path: string, route: RouteConfig | null): void;
+    /**
+     * 清空所有缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): {
+        transformCacheSize: number;
+        matchCacheSize: number;
+        totalSize: number;
+        hitRate: number;
+    };
+}
+export declare function getRouteCache(config?: RouteCacheConfig): RouteCache;
+//# sourceMappingURL=RouteCache.d.ts.map

package/dist/core/router/performance/RouteCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteCache.d.ts","sourceRoot":"","sources":["../../../../src/core/router/performance/RouteCache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AA4BhE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA4D;IACzE,OAAO,CAAC,UAAU,CAAyD;IAC3E,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,kBAAkB,CAAkB;gBAEhC,MAAM,GAAE,gBAAqB;IAiBzC;;OAEG;YACW,eAAe;IAc7B;;OAEG;YACW,mBAAmB;IAUjC;;OAEG;YACW,iBAAiB;IAa/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,OAAO;IAoBf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAO5B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,qBAAqB,GAAG,IAAI;IAoBzF;;OAEG;IACH,GAAG,CACD,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EACtD,KAAK,EAAE,qBAAqB,GAC3B,IAAI;IAyBP;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS;IAmBtD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAiBvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI;QACV,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;KACjB;CAyBF;AAOD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAKnE"}