@vlian/framework 1.2.61 → 1.2.62

package/dist/core-bak/router/lifecycle/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./RouterLifecycleManager"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/core-bak/router/lifecycle/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 路由生命周期模块入口
+ */
+export * from './RouterLifecycleManager';

package/dist/core-bak/router/lifecycle/index.js

@@ -0,0 +1 @@
+export*from"./RouterLifecycleManager";

package/dist/core-bak/router/middleware/RouterMiddlewareManager.cjs

@@ -0,0 +1 @@
+"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 RouterMiddlewareManager(){return RouterMiddlewareManager},get getRouterMiddlewareManager(){return getRouterMiddlewareManager}});const _logger=require("@vlian/logger");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 RouterMiddlewareManager=class RouterMiddlewareManager{register(config){if(!config.middleware||typeof config.middleware!=="function"){throw new Error("中间件必须是一个函数")}const middlewareConfig={priority:100,enabled:true,...config};this.middlewares.push(middlewareConfig);this.middlewares.sort((a,b)=>(a.priority||100)-(b.priority||100));_logger.logger.debug(`路由中间件已注册: ${middlewareConfig.name||"anonymous"}`);return()=>{const index=this.middlewares.indexOf(middlewareConfig);if(index>-1){this.middlewares.splice(index,1);_logger.logger.debug(`路由中间件已取消注册: ${middlewareConfig.name||"anonymous"}`)}}}registerBatch(configs){configs.forEach(config=>this.register(config))}unregister(name){const index=this.middlewares.findIndex(m=>m.name===name);if(index>-1){this.middlewares.splice(index,1);_logger.logger.debug(`路由中间件已取消注册: ${name}`)}}clear(){this.middlewares=[];_logger.logger.debug("所有路由中间件已清空")}async execute(context){const enabledMiddlewares=this.middlewares.filter(m=>{if(!m.enabled){return false}if(m.condition&&!m.condition(context)){return false}return true});for(const middlewareConfig of enabledMiddlewares){try{const result=await middlewareConfig.middleware(context);if(result===false){_logger.logger.debug(`路由中间件阻止导航: ${middlewareConfig.name||"anonymous"} -> false`);return{allow:false,reason:"中间件返回 false"}}if(typeof result==="object"&&result!==null&&result.allow===false){_logger.logger.debug(`路由中间件阻止导航: ${middlewareConfig.name||"anonymous"}`,result);if(result.redirect&&!RouterMiddlewareManager.SAFE_REDIRECT_PATH_REGEX.test(result.redirect)){_logger.logger.warn(`路由中间件返回了不安全的重定向地址，已拦截: ${middlewareConfig.name||"anonymous"} -> ${result.redirect}`);return{allow:false,reason:"中间件返回了不安全的重定向地址"}}return result}if(typeof result==="string"){if(!RouterMiddlewareManager.SAFE_REDIRECT_PATH_REGEX.test(result)){_logger.logger.warn(`路由中间件返回了不安全的重定向地址，已拦截: ${middlewareConfig.name||"anonymous"} -> ${result}`);return{allow:false,reason:"中间件返回了不安全的重定向地址"}}_logger.logger.debug(`路由中间件重定向: ${middlewareConfig.name||"anonymous"} -> ${result}`);return{allow:false,redirect:result}}}catch(error){_logger.logger.error(`路由中间件执行失败: ${middlewareConfig.name||"anonymous"}`,error);continue}}return{allow:true}}getAll(){return[...this.middlewares]}getEnabled(){return this.middlewares.filter(m=>m.enabled)}getCount(){return this.middlewares.length}constructor(){_define_property(this,"middlewares",[])}};_define_property(RouterMiddlewareManager,"SAFE_REDIRECT_PATH_REGEX",/^(\/|\.\/|\.\.\/|#)/);let middlewareManagerInstance=null;function getRouterMiddlewareManager(){if(!middlewareManagerInstance){middlewareManagerInstance=new RouterMiddlewareManager}return middlewareManagerInstance}

package/dist/core-bak/router/middleware/RouterMiddlewareManager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 路由中间件管理器
+ * 负责管理路由中间件的注册、执行和生命周期
+ */
+import type { RouterMiddlewareConfig, RouterMiddlewareContext, RouterMiddlewareResult } from './types';
+/**
+ * 路由中间件管理器
+ */
+export declare class RouterMiddlewareManager {
+    private middlewares;
+    private static readonly SAFE_REDIRECT_PATH_REGEX;
+    /**
+     * 注册中间件
+     *
+     * @param config - 中间件配置
+     * @returns 取消注册函数
+     */
+    register(config: RouterMiddlewareConfig): () => void;
+    /**
+     * 批量注册中间件
+     *
+     * @param configs - 中间件配置数组
+     */
+    registerBatch(configs: RouterMiddlewareConfig[]): void;
+    /**
+     * 取消注册中间件
+     *
+     * @param name - 中间件名称
+     */
+    unregister(name: string): void;
+    /**
+     * 清空所有中间件
+     */
+    clear(): void;
+    /**
+     * 执行中间件链
+     *
+     * @param context - 中间件上下文
+     * @returns 中间件执行结果
+     */
+    execute(context: RouterMiddlewareContext): Promise<RouterMiddlewareResult>;
+    /**
+     * 获取所有中间件
+     *
+     * @returns 中间件配置数组
+     */
+    getAll(): RouterMiddlewareConfig[];
+    /**
+     * 获取启用的中间件
+     *
+     * @returns 启用的中间件配置数组
+     */
+    getEnabled(): RouterMiddlewareConfig[];
+    /**
+     * 获取中间件数量
+     *
+     * @returns 中间件数量
+     */
+    getCount(): number;
+}
+export declare function getRouterMiddlewareManager(): RouterMiddlewareManager;

package/dist/core-bak/router/middleware/RouterMiddlewareManager.js

@@ -0,0 +1 @@
+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}import{logger}from"@vlian/logger";export class RouterMiddlewareManager{register(config){if(!config.middleware||typeof config.middleware!=="function"){throw new Error("中间件必须是一个函数")}const middlewareConfig={priority:100,enabled:true,...config};this.middlewares.push(middlewareConfig);this.middlewares.sort((a,b)=>(a.priority||100)-(b.priority||100));logger.debug(`路由中间件已注册: ${middlewareConfig.name||"anonymous"}`);return()=>{const index=this.middlewares.indexOf(middlewareConfig);if(index>-1){this.middlewares.splice(index,1);logger.debug(`路由中间件已取消注册: ${middlewareConfig.name||"anonymous"}`)}}}registerBatch(configs){configs.forEach(config=>this.register(config))}unregister(name){const index=this.middlewares.findIndex(m=>m.name===name);if(index>-1){this.middlewares.splice(index,1);logger.debug(`路由中间件已取消注册: ${name}`)}}clear(){this.middlewares=[];logger.debug("所有路由中间件已清空")}async execute(context){const enabledMiddlewares=this.middlewares.filter(m=>{if(!m.enabled){return false}if(m.condition&&!m.condition(context)){return false}return true});for(const middlewareConfig of enabledMiddlewares){try{const result=await middlewareConfig.middleware(context);if(result===false){logger.debug(`路由中间件阻止导航: ${middlewareConfig.name||"anonymous"} -> false`);return{allow:false,reason:"中间件返回 false"}}if(typeof result==="object"&&result!==null&&result.allow===false){logger.debug(`路由中间件阻止导航: ${middlewareConfig.name||"anonymous"}`,result);if(result.redirect&&!RouterMiddlewareManager.SAFE_REDIRECT_PATH_REGEX.test(result.redirect)){logger.warn(`路由中间件返回了不安全的重定向地址，已拦截: ${middlewareConfig.name||"anonymous"} -> ${result.redirect}`);return{allow:false,reason:"中间件返回了不安全的重定向地址"}}return result}if(typeof result==="string"){if(!RouterMiddlewareManager.SAFE_REDIRECT_PATH_REGEX.test(result)){logger.warn(`路由中间件返回了不安全的重定向地址，已拦截: ${middlewareConfig.name||"anonymous"} -> ${result}`);return{allow:false,reason:"中间件返回了不安全的重定向地址"}}logger.debug(`路由中间件重定向: ${middlewareConfig.name||"anonymous"} -> ${result}`);return{allow:false,redirect:result}}}catch(error){logger.error(`路由中间件执行失败: ${middlewareConfig.name||"anonymous"}`,error);continue}}return{allow:true}}getAll(){return[...this.middlewares]}getEnabled(){return this.middlewares.filter(m=>m.enabled)}getCount(){return this.middlewares.length}constructor(){_define_property(this,"middlewares",[])}}_define_property(RouterMiddlewareManager,"SAFE_REDIRECT_PATH_REGEX",/^(\/|\.\/|\.\.\/|#)/);let middlewareManagerInstance=null;export function getRouterMiddlewareManager(){if(!middlewareManagerInstance){middlewareManagerInstance=new RouterMiddlewareManager}return middlewareManagerInstance}

package/dist/core-bak/router/middleware/auth.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"createAuthMiddleware",{enumerable:true,get:function(){return createAuthMiddleware}});const _logger=require("@vlian/logger");function createAuthMiddleware(config){const{checkAuth,checkLogin,checkRole,loginRedirect="/login",forbiddenRedirect="/403"}=config;return async context=>{const{to}=context;const needLogin=to.meta?.needLogin||to.meta?.handle?.needLogin;if(needLogin){if(checkLogin){const isLoggedIn=await checkLogin();if(!isLoggedIn){_logger.logger.debug(`路由权限拦截: 未登录，重定向到 ${loginRedirect}`);return{allow:false,redirect:loginRedirect,reason:"需要登录"}}}}const roles=to.meta?.roles||to.meta?.handle?.roles;if(roles&&Array.isArray(roles)&&roles.length>0){if(checkRole){const hasRole=await checkRole(roles);if(!hasRole){_logger.logger.debug(`路由权限拦截: 无权限，重定向到 ${forbiddenRedirect}`);return{allow:false,redirect:forbiddenRedirect,reason:"无权限访问"}}}}if(checkAuth){const hasAuth=await checkAuth(context);if(!hasAuth){_logger.logger.debug(`路由权限拦截: 权限检查失败，重定向到 ${forbiddenRedirect}`);return{allow:false,redirect:forbiddenRedirect,reason:"权限检查失败"}}}return{allow:true}}}

package/dist/core-bak/router/middleware/auth.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 路由权限拦截中间件
+ */
+import type { RouterMiddleware, RouterMiddlewareContext } from './types';
+/**
+ * 权限检查函数类型
+ */
+export type AuthCheckFunction = (context: RouterMiddlewareContext) => boolean | Promise<boolean>;
+/**
+ * 权限拦截中间件配置
+ */
+export interface AuthMiddlewareConfig {
+    /**
+     * 权限检查函数
+     * 返回 true 表示有权限，false 表示无权限
+     */
+    checkAuth: AuthCheckFunction;
+    /**
+     * 登录状态检查函数
+     * 返回 true 表示已登录，false 表示未登录
+     */
+    checkLogin?: () => boolean | Promise<boolean>;
+    /**
+     * 角色检查函数
+     * 返回 true 表示有权限，false 表示无权限
+     */
+    checkRole?: (roles: string[]) => boolean | Promise<boolean>;
+    /**
+     * 未登录时重定向路径
+     * @default '/login'
+     */
+    loginRedirect?: string;
+    /**
+     * 无权限时重定向路径
+     * @default '/403'
+     */
+    forbiddenRedirect?: string;
+    /**
+     * 中间件名称
+     */
+    name?: string;
+    /**
+     * 优先级
+     * @default 10
+     */
+    priority?: number;
+}
+/**
+ * 创建权限拦截中间件
+ *
+ * @param config - 权限拦截中间件配置
+ * @returns 路由中间件函数
+ */
+export declare function createAuthMiddleware(config: AuthMiddlewareConfig): RouterMiddleware;

package/dist/core-bak/router/middleware/auth.js

@@ -0,0 +1 @@
+import{logger}from"@vlian/logger";export function createAuthMiddleware(config){const{checkAuth,checkLogin,checkRole,loginRedirect="/login",forbiddenRedirect="/403"}=config;return async context=>{const{to}=context;const needLogin=to.meta?.needLogin||to.meta?.handle?.needLogin;if(needLogin){if(checkLogin){const isLoggedIn=await checkLogin();if(!isLoggedIn){logger.debug(`路由权限拦截: 未登录，重定向到 ${loginRedirect}`);return{allow:false,redirect:loginRedirect,reason:"需要登录"}}}}const roles=to.meta?.roles||to.meta?.handle?.roles;if(roles&&Array.isArray(roles)&&roles.length>0){if(checkRole){const hasRole=await checkRole(roles);if(!hasRole){logger.debug(`路由权限拦截: 无权限，重定向到 ${forbiddenRedirect}`);return{allow:false,redirect:forbiddenRedirect,reason:"无权限访问"}}}}if(checkAuth){const hasAuth=await checkAuth(context);if(!hasAuth){logger.debug(`路由权限拦截: 权限检查失败，重定向到 ${forbiddenRedirect}`);return{allow:false,redirect:forbiddenRedirect,reason:"权限检查失败"}}}return{allow:true}}}

package/dist/core-bak/router/middleware/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./types"),exports);_export_star(require("./RouterMiddlewareManager"),exports);_export_star(require("./auth"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/core-bak/router/middleware/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 路由中间件模块入口
+ */
+export * from './types';
+export * from './RouterMiddlewareManager';
+export * from './auth';

package/dist/core-bak/router/middleware/index.js

@@ -0,0 +1 @@
+export*from"./types";export*from"./RouterMiddlewareManager";export*from"./auth";

package/dist/core-bak/router/middleware/types.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});

package/dist/core-bak/router/middleware/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 路由中间件类型定义
+ */
+import type { RouteLocation, NavigateOptions } from '../types';
+/**
+ * 路由中间件上下文
+ */
+export interface RouterMiddlewareContext {
+    /**
+     * 目标路由
+     */
+    to: RouteLocation;
+    /**
+     * 来源路由
+     */
+    from?: RouteLocation;
+    /**
+     * 导航选项
+     */
+    options?: NavigateOptions;
+    /**
+     * 中间件元数据
+     */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 路由中间件结果
+ */
+export type RouterMiddlewareResult = {
+    /**
+     * 允许继续导航
+     */
+    allow: true;
+} | {
+    /**
+     * 阻止导航
+     */
+    allow: false;
+    /**
+     * 重定向路径（可选）
+     */
+    redirect?: string;
+    /**
+     * 阻止原因
+     */
+    reason?: string;
+};
+/**
+ * 路由中间件函数
+ */
+export type RouterMiddleware = (context: RouterMiddlewareContext) => RouterMiddlewareResult | string | false | void | Promise<RouterMiddlewareResult | string | false | void>;
+/**
+ * 路由中间件配置
+ */
+export interface RouterMiddlewareConfig {
+    /**
+     * 中间件函数
+     */
+    middleware: RouterMiddleware;
+    /**
+     * 中间件名称
+     */
+    name?: string;
+    /**
+     * 优先级（数字越小优先级越高）
+     * @default 100
+     */
+    priority?: number;
+    /**
+     * 是否启用
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 条件函数（返回 true 时才执行中间件）
+     */
+    condition?: (context: RouterMiddlewareContext) => boolean;
+}
+/**
+ * 路由生命周期钩子结果
+ */
+export type RouteLifecycleResult = void | string | false | Promise<void | string | false>;

package/dist/core-bak/router/middleware/types.js

@@ -0,0 +1 @@
+export{};

package/dist/core-bak/router/monitoring/RouterMonitoring.cjs

@@ -0,0 +1 @@
+"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 RouterMonitoring(){return RouterMonitoring},get getRouterMonitoring(){return getRouterMonitoring}});const _monitoring=require("@vlian/monitoring");const _logger=require("@vlian/logger");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 RouterMonitoring=class RouterMonitoring{trackRouteAccess(to,from,success=true,error){if(!this.config.enabled||!this.config.trackAccess){return}if(Math.random()>this.config.sampleRate){return}const record={path:to.path,name:to.meta?.name,timestamp:Date.now(),from:from?.path,success,error:error?.message};if(this.currentRoute&&this.currentRouteStartTime>0){record.duration=Date.now()-this.currentRouteStartTime}this.accessRecords.push(record);if(this.accessRecords.length>this.config.maxRecords){this.accessRecords.shift()}this.monitoringService.trackEvent("route_access",{path:to.path,name:to.meta?.name,success,error:error?.message});this.currentRoute=to;this.currentRouteStartTime=Date.now();_logger.logger.debug("路由访问已记录",record)}trackRoutePerformance(routeName,metrics){if(!this.config.enabled||!this.config.trackPerformance){return}if(Math.random()>this.config.sampleRate){return}const routeMetrics=this.performanceMetrics.get(routeName)||[];routeMetrics.push(metrics);if(routeMetrics.length>100){routeMetrics.shift()}this.performanceMetrics.set(routeName,routeMetrics);this.monitoringService.reportPerformance({[`route_${routeName}_match`]:metrics.matchTime||0,[`route_${routeName}_load`]:metrics.loadTime||0,[`route_${routeName}_render`]:metrics.renderTime||0,[`route_${routeName}_total`]:metrics.totalTime||0});_logger.logger.debug(`路由性能指标已记录: ${routeName}`,metrics)}trackRouteError(error,context){if(!this.config.enabled||!this.config.trackErrors){return}if(Math.random()>this.config.sampleRate){return}this.monitoringService.captureError(error,{type:"router",...context});_logger.logger.error("路由错误已记录",error,context)}getAccessStats(){const stats={total:this.accessRecords.length,success:0,failed:0,byPath:{},byName:{},averageDuration:0};let totalDuration=0;let durationCount=0;for(const record of this.accessRecords){if(record.success){stats.success++}else{stats.failed++}stats.byPath[record.path]=(stats.byPath[record.path]||0)+1;if(record.name){stats.byName[record.name]=(stats.byName[record.name]||0)+1}if(record.duration){totalDuration+=record.duration;durationCount++}}stats.averageDuration=durationCount>0?totalDuration/durationCount:0;return stats}getPerformanceStats(){const stats={};for(const[routeName,metrics]of this.performanceMetrics.entries()){let totalMatchTime=0;let totalLoadTime=0;let totalRenderTime=0;let totalTotalTime=0;let count=0;for(const metric of metrics){if(metric.matchTime){totalMatchTime+=metric.matchTime}if(metric.loadTime){totalLoadTime+=metric.loadTime}if(metric.renderTime){totalRenderTime+=metric.renderTime}if(metric.totalTime){totalTotalTime+=metric.totalTime}count++}stats[routeName]={count,averageMatchTime:count>0?totalMatchTime/count:0,averageLoadTime:count>0?totalLoadTime/count:0,averageRenderTime:count>0?totalRenderTime/count:0,averageTotalTime:count>0?totalTotalTime/count:0}}return stats}clear(){this.accessRecords=[];this.performanceMetrics.clear();_logger.logger.debug("路由监控记录已清空")}getReport(){return{access:this.getAccessStats(),performance:this.getPerformanceStats(),timestamp:Date.now()}}constructor(config={}){_define_property(this,"accessRecords",[]);_define_property(this,"performanceMetrics",new Map);_define_property(this,"config",void 0);_define_property(this,"monitoringService",(0,_monitoring.getMonitoring)());_define_property(this,"currentRouteStartTime",0);_define_property(this,"currentRoute",void 0);this.config={enabled:config.enabled??true,trackAccess:config.trackAccess??true,trackPerformance:config.trackPerformance??true,trackErrors:config.trackErrors??true,maxRecords:config.maxRecords??1e3,sampleRate:config.sampleRate??1}}};let routerMonitoringInstance=null;function getRouterMonitoring(config){if(!routerMonitoringInstance){routerMonitoringInstance=new RouterMonitoring(config)}return routerMonitoringInstance}

package/dist/core-bak/router/monitoring/RouterMonitoring.d.ts

@@ -0,0 +1,134 @@
+/**
+ * 路由监控服务
+ * 提供路由访问统计、性能监控、错误监控等功能
+ */
+import type { RouteLocation } from '../types';
+import type { RouterError } from '../errors';
+/**
+ * 路由性能指标
+ */
+interface RoutePerformanceMetrics {
+    /**
+     * 路由匹配时间（毫秒）
+     */
+    matchTime?: number;
+    /**
+     * 组件加载时间（毫秒）
+     */
+    loadTime?: number;
+    /**
+     * 路由渲染时间（毫秒）
+     */
+    renderTime?: number;
+    /**
+     * 总时间（毫秒）
+     */
+    totalTime?: number;
+}
+/**
+ * 路由监控配置
+ */
+export interface RouterMonitoringConfig {
+    /**
+     * 是否启用路由监控
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * 是否记录路由访问
+     * @default true
+     */
+    trackAccess?: boolean;
+    /**
+     * 是否记录性能指标
+     * @default true
+     */
+    trackPerformance?: boolean;
+    /**
+     * 是否记录错误
+     * @default true
+     */
+    trackErrors?: boolean;
+    /**
+     * 最大记录数量
+     * @default 1000
+     */
+    maxRecords?: number;
+    /**
+     * 采样率 (0-1)
+     * @default 1.0
+     */
+    sampleRate?: number;
+}
+/**
+ * 路由监控服务
+ */
+export declare class RouterMonitoring {
+    private accessRecords;
+    private performanceMetrics;
+    private config;
+    private monitoringService;
+    private currentRouteStartTime;
+    private currentRoute?;
+    constructor(config?: RouterMonitoringConfig);
+    /**
+     * 记录路由访问
+     */
+    trackRouteAccess(to: RouteLocation, from?: RouteLocation, success?: boolean, error?: Error): void;
+    /**
+     * 记录路由性能指标
+     */
+    trackRoutePerformance(routeName: string, metrics: RoutePerformanceMetrics): void;
+    /**
+     * 记录路由错误
+     */
+    trackRouteError(error: RouterError | Error, context?: Record<string, unknown>): void;
+    /**
+     * 获取路由访问统计
+     */
+    getAccessStats(): {
+        total: number;
+        success: number;
+        failed: number;
+        byPath: Record<string, number>;
+        byName: Record<string, number>;
+        averageDuration: number;
+    };
+    /**
+     * 获取路由性能统计
+     */
+    getPerformanceStats(): Record<string, {
+        count: number;
+        averageMatchTime: number;
+        averageLoadTime: number;
+        averageRenderTime: number;
+        averageTotalTime: number;
+    }>;
+    /**
+     * 清空所有记录
+     */
+    clear(): void;
+    /**
+     * 获取监控报告
+     */
+    getReport(): {
+        access: {
+            total: number;
+            success: number;
+            failed: number;
+            byPath: Record<string, number>;
+            byName: Record<string, number>;
+            averageDuration: number;
+        };
+        performance: Record<string, {
+            count: number;
+            averageMatchTime: number;
+            averageLoadTime: number;
+            averageRenderTime: number;
+            averageTotalTime: number;
+        }>;
+        timestamp: number;
+    };
+}
+export declare function getRouterMonitoring(config?: RouterMonitoringConfig): RouterMonitoring;
+export {};

package/dist/core-bak/router/monitoring/RouterMonitoring.js

@@ -0,0 +1 @@
+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}import{getMonitoring}from"@vlian/monitoring";import{logger}from"@vlian/logger";export class RouterMonitoring{trackRouteAccess(to,from,success=true,error){if(!this.config.enabled||!this.config.trackAccess){return}if(Math.random()>this.config.sampleRate){return}const record={path:to.path,name:to.meta?.name,timestamp:Date.now(),from:from?.path,success,error:error?.message};if(this.currentRoute&&this.currentRouteStartTime>0){record.duration=Date.now()-this.currentRouteStartTime}this.accessRecords.push(record);if(this.accessRecords.length>this.config.maxRecords){this.accessRecords.shift()}this.monitoringService.trackEvent("route_access",{path:to.path,name:to.meta?.name,success,error:error?.message});this.currentRoute=to;this.currentRouteStartTime=Date.now();logger.debug("路由访问已记录",record)}trackRoutePerformance(routeName,metrics){if(!this.config.enabled||!this.config.trackPerformance){return}if(Math.random()>this.config.sampleRate){return}const routeMetrics=this.performanceMetrics.get(routeName)||[];routeMetrics.push(metrics);if(routeMetrics.length>100){routeMetrics.shift()}this.performanceMetrics.set(routeName,routeMetrics);this.monitoringService.reportPerformance({[`route_${routeName}_match`]:metrics.matchTime||0,[`route_${routeName}_load`]:metrics.loadTime||0,[`route_${routeName}_render`]:metrics.renderTime||0,[`route_${routeName}_total`]:metrics.totalTime||0});logger.debug(`路由性能指标已记录: ${routeName}`,metrics)}trackRouteError(error,context){if(!this.config.enabled||!this.config.trackErrors){return}if(Math.random()>this.config.sampleRate){return}this.monitoringService.captureError(error,{type:"router",...context});logger.error("路由错误已记录",error,context)}getAccessStats(){const stats={total:this.accessRecords.length,success:0,failed:0,byPath:{},byName:{},averageDuration:0};let totalDuration=0;let durationCount=0;for(const record of this.accessRecords){if(record.success){stats.success++}else{stats.failed++}stats.byPath[record.path]=(stats.byPath[record.path]||0)+1;if(record.name){stats.byName[record.name]=(stats.byName[record.name]||0)+1}if(record.duration){totalDuration+=record.duration;durationCount++}}stats.averageDuration=durationCount>0?totalDuration/durationCount:0;return stats}getPerformanceStats(){const stats={};for(const[routeName,metrics]of this.performanceMetrics.entries()){let totalMatchTime=0;let totalLoadTime=0;let totalRenderTime=0;let totalTotalTime=0;let count=0;for(const metric of metrics){if(metric.matchTime){totalMatchTime+=metric.matchTime}if(metric.loadTime){totalLoadTime+=metric.loadTime}if(metric.renderTime){totalRenderTime+=metric.renderTime}if(metric.totalTime){totalTotalTime+=metric.totalTime}count++}stats[routeName]={count,averageMatchTime:count>0?totalMatchTime/count:0,averageLoadTime:count>0?totalLoadTime/count:0,averageRenderTime:count>0?totalRenderTime/count:0,averageTotalTime:count>0?totalTotalTime/count:0}}return stats}clear(){this.accessRecords=[];this.performanceMetrics.clear();logger.debug("路由监控记录已清空")}getReport(){return{access:this.getAccessStats(),performance:this.getPerformanceStats(),timestamp:Date.now()}}constructor(config={}){_define_property(this,"accessRecords",[]);_define_property(this,"performanceMetrics",new Map);_define_property(this,"config",void 0);_define_property(this,"monitoringService",getMonitoring());_define_property(this,"currentRouteStartTime",0);_define_property(this,"currentRoute",void 0);this.config={enabled:config.enabled??true,trackAccess:config.trackAccess??true,trackPerformance:config.trackPerformance??true,trackErrors:config.trackErrors??true,maxRecords:config.maxRecords??1e3,sampleRate:config.sampleRate??1}}}let routerMonitoringInstance=null;export function getRouterMonitoring(config){if(!routerMonitoringInstance){routerMonitoringInstance=new RouterMonitoring(config)}return routerMonitoringInstance}

package/dist/core-bak/router/monitoring/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./RouterMonitoring"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/core-bak/router/monitoring/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 路由监控模块入口
+ */
+export * from './RouterMonitoring';

package/dist/core-bak/router/monitoring/index.js

@@ -0,0 +1 @@
+export*from"./RouterMonitoring";

package/dist/core-bak/router/navigation/RouterNavigation.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"RouterNavigation",{enumerable:true,get:function(){return RouterNavigation}});const _logger=require("@vlian/logger");const _lifecycle=require("../lifecycle");const _middleware=require("../middleware");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}function _getRequireWildcardCache(nodeInterop){if(typeof WeakMap!=="function")return null;var cacheBabelInterop=new WeakMap;var cacheNodeInterop=new WeakMap;return(_getRequireWildcardCache=function(nodeInterop){return nodeInterop?cacheNodeInterop:cacheBabelInterop})(nodeInterop)}function _interop_require_wildcard(obj,nodeInterop){if(!nodeInterop&&obj&&obj.__esModule){return obj}if(obj===null||typeof obj!=="object"&&typeof obj!=="function"){return{default:obj}}var cache=_getRequireWildcardCache(nodeInterop);if(cache&&cache.has(obj)){return cache.get(obj)}var newObj={__proto__:null};var hasPropertyDescriptor=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var key in obj){if(key!=="default"&&Object.prototype.hasOwnProperty.call(obj,key)){var desc=hasPropertyDescriptor?Object.getOwnPropertyDescriptor(obj,key):null;if(desc&&(desc.get||desc.set)){Object.defineProperty(newObj,key,desc)}else{newObj[key]=obj[key]}}}newObj.default=obj;if(cache){cache.set(obj,newObj)}return newObj}let RouterNavigation=class RouterNavigation{static buildTargetPath(to,query){const base=typeof window!=="undefined"&&window.location?.origin?window.location.origin:"http://localhost";const url=new URL(to,base);if(query&&Object.keys(query).length>0){const params=new URLSearchParams(url.search);Object.entries(query).forEach(([key,value])=>{if(value===undefined||value===null){params.delete(key);return}params.set(key,String(value))});url.search=params.toString()}return`${url.pathname}${url.search}${url.hash}`}static async navigateInternal(to,options,depth,visited){const startTime=performance.now();if(depth>this.MAX_REDIRECTS){throw new Error(`路由重定向次数超过上限(${this.MAX_REDIRECTS})，可能存在循环重定向`)}const targetPath=this.buildTargetPath(to,options?.query);if(visited.has(targetPath)){throw new Error(`检测到循环重定向: ${targetPath}`)}visited.add(targetPath);const routerManager=await Promise.resolve().then(()=>/*#__PURE__*/_interop_require_wildcard(require("../RouterManager"))).then(m=>m.getRouterManager());const router=routerManager.getRouter();if(!router){throw new Error("路由未初始化，无法导航")}const currentLocation=this.getCurrentRoute();const targetLocation={path:targetPath,query:options?.query};const lifecycleManager=(0,_lifecycle.getRouterLifecycleManager)();const beforeEachResult=await lifecycleManager.beforeEach(targetLocation,currentLocation);let finalPath=targetPath;if(beforeEachResult===false){_logger.logger.debug("路由导航被阻止: beforeEach 返回 false");return}if(typeof beforeEachResult==="string"){_logger.logger.debug(`路由导航重定向: ${beforeEachResult}`);finalPath=this.buildTargetPath(beforeEachResult)}const middlewareManager=(0,_middleware.getRouterMiddlewareManager)();const middlewareContext={to:{...targetLocation,path:finalPath},from:currentLocation,options};const middlewareResult=await middlewareManager.execute(middlewareContext);if(!middlewareResult.allow){if(middlewareResult.redirect){_logger.logger.debug(`路由导航被中间件重定向: ${middlewareResult.redirect}`);return this.navigateInternal(middlewareResult.redirect,{...options,query:undefined},depth+1,visited)}_logger.logger.debug(`路由导航被中间件阻止: ${middlewareResult.reason||"未知原因"}`);return}try{if(options?.replace){router.navigate(finalPath,{replace:true,state:options.state})}else{router.navigate(finalPath,{state:options?.state})}await lifecycleManager.afterEach({...targetLocation,path:finalPath},currentLocation);const duration=performance.now()-startTime;routerManager.getMonitoring().trackRoutePerformance(finalPath,{totalTime:duration})}catch(error){_logger.logger.error("路由导航失败",error);throw error}}static async navigate(to,options){return this.navigateInternal(to,options,0,new Set)}static getCurrentRoute(){if(typeof window==="undefined"){return{path:"/",query:{}}}const pathname=window.location.pathname;const search=window.location.search;const hash=window.location.hash;const query={};if(search){const params=new URLSearchParams(search);params.forEach((value,key)=>{query[key]=value})}return{path:pathname+hash,query}}static async goBack(fallback){if(window.history.length>1){window.history.back()}else if(fallback){await this.navigate(fallback)}else{_logger.logger.warn("没有历史记录，无法返回")}}static goForward(){window.history.forward()}static async replace(to,options){return this.navigate(to,{...options,replace:true})}};_define_property(RouterNavigation,"MAX_REDIRECTS",10);

package/dist/core-bak/router/navigation/RouterNavigation.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 路由导航 API
+ * 提供框架级别的路由导航能力，封装 react-router-dom 的导航功能
+ */
+import type { RouteLocation, NavigateOptions } from '../types';
+/**
+ * 路由导航器
+ */
+export declare class RouterNavigation {
+    private static readonly MAX_REDIRECTS;
+    private static buildTargetPath;
+    private static navigateInternal;
+    /**
+     * 导航到指定路径
+     *
+     * @param to - 目标路径或路由名称
+     * @param options - 导航选项
+     */
+    static navigate(to: string, options?: NavigateOptions): Promise<void>;
+    /**
+     * 获取当前路由信息
+     *
+     * @returns 当前路由位置信息
+     */
+    static getCurrentRoute(): RouteLocation;
+    /**
+     * 返回上一页
+     *
+     * @param fallback - 如果没有历史记录，跳转到该路径
+     */
+    static goBack(fallback?: string): Promise<void>;
+    /**
+     * 前进到下一页
+     */
+    static goForward(): void;
+    /**
+     * 替换当前路由
+     *
+     * @param to - 目标路径
+     * @param options - 导航选项
+     */
+    static replace(to: string, options?: Omit<NavigateOptions, 'replace'>): Promise<void>;
+}

package/dist/core-bak/router/navigation/RouterNavigation.js

@@ -0,0 +1 @@
+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}import{logger}from"@vlian/logger";import{getRouterLifecycleManager}from"../lifecycle";import{getRouterMiddlewareManager}from"../middleware";export class RouterNavigation{static buildTargetPath(to,query){const base=typeof window!=="undefined"&&window.location?.origin?window.location.origin:"http://localhost";const url=new URL(to,base);if(query&&Object.keys(query).length>0){const params=new URLSearchParams(url.search);Object.entries(query).forEach(([key,value])=>{if(value===undefined||value===null){params.delete(key);return}params.set(key,String(value))});url.search=params.toString()}return`${url.pathname}${url.search}${url.hash}`}static async navigateInternal(to,options,depth,visited){const startTime=performance.now();if(depth>this.MAX_REDIRECTS){throw new Error(`路由重定向次数超过上限(${this.MAX_REDIRECTS})，可能存在循环重定向`)}const targetPath=this.buildTargetPath(to,options?.query);if(visited.has(targetPath)){throw new Error(`检测到循环重定向: ${targetPath}`)}visited.add(targetPath);const routerManager=await import("../RouterManager").then(m=>m.getRouterManager());const router=routerManager.getRouter();if(!router){throw new Error("路由未初始化，无法导航")}const currentLocation=this.getCurrentRoute();const targetLocation={path:targetPath,query:options?.query};const lifecycleManager=getRouterLifecycleManager();const beforeEachResult=await lifecycleManager.beforeEach(targetLocation,currentLocation);let finalPath=targetPath;if(beforeEachResult===false){logger.debug("路由导航被阻止: beforeEach 返回 false");return}if(typeof beforeEachResult==="string"){logger.debug(`路由导航重定向: ${beforeEachResult}`);finalPath=this.buildTargetPath(beforeEachResult)}const middlewareManager=getRouterMiddlewareManager();const middlewareContext={to:{...targetLocation,path:finalPath},from:currentLocation,options};const middlewareResult=await middlewareManager.execute(middlewareContext);if(!middlewareResult.allow){if(middlewareResult.redirect){logger.debug(`路由导航被中间件重定向: ${middlewareResult.redirect}`);return this.navigateInternal(middlewareResult.redirect,{...options,query:undefined},depth+1,visited)}logger.debug(`路由导航被中间件阻止: ${middlewareResult.reason||"未知原因"}`);return}try{if(options?.replace){router.navigate(finalPath,{replace:true,state:options.state})}else{router.navigate(finalPath,{state:options?.state})}await lifecycleManager.afterEach({...targetLocation,path:finalPath},currentLocation);const duration=performance.now()-startTime;routerManager.getMonitoring().trackRoutePerformance(finalPath,{totalTime:duration})}catch(error){logger.error("路由导航失败",error);throw error}}static async navigate(to,options){return this.navigateInternal(to,options,0,new Set)}static getCurrentRoute(){if(typeof window==="undefined"){return{path:"/",query:{}}}const pathname=window.location.pathname;const search=window.location.search;const hash=window.location.hash;const query={};if(search){const params=new URLSearchParams(search);params.forEach((value,key)=>{query[key]=value})}return{path:pathname+hash,query}}static async goBack(fallback){if(window.history.length>1){window.history.back()}else if(fallback){await this.navigate(fallback)}else{logger.warn("没有历史记录，无法返回")}}static goForward(){window.history.forward()}static async replace(to,options){return this.navigate(to,{...options,replace:true})}}_define_property(RouterNavigation,"MAX_REDIRECTS",10);

package/dist/core-bak/router/navigation/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./RouterNavigation"),exports);function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}

package/dist/core-bak/router/navigation/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 路由导航模块入口
+ */
+export * from './RouterNavigation';

package/dist/core-bak/router/navigation/index.js

@@ -0,0 +1 @@
+export*from"./RouterNavigation";

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

@@ -0,0 +1 @@
+"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 _logger=require("@vlian/logger");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{if(typeof window!=="undefined"&&"indexedDB"in window){this.persistenceEnabled=true;await this.loadFromPersistence();_logger.logger.debug("路由缓存持久化已启用")}}catch(error){_logger.logger.warn("路由缓存持久化初始化失败",error);this.persistenceEnabled=false}}async loadFromPersistence(){try{}catch(error){_logger.logger.warn("从持久化存储加载缓存失败",error)}}async saveToPersistence(_key,_value){if(!this.persistenceEnabled){return}try{}catch(error){_logger.logger.warn("保存到持久化存储失败",error)}}generateKey(routes){if(typeof routes==="function"){return`fn_${routes.name||Math.random().toString(36).substring(7)}`}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}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)}}this.evictLRU()}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(){if(this.cleanupTimer){clearInterval(this.cleanupTimer)}this.cleanupTimer=setInterval(()=>{this.cleanup()},60*1e3)}get(routes){const key=this.generateKey(routes);const item=this.cache.get(key);if(!item){this.stats.transformMisses++;return null}if(this.isExpired(item)){this.cache.delete(key);this.stats.transformMisses++;return null}item.lastAccessedAt=Date.now();item.accessCount++;this.stats.transformHits++;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=>{_logger.logger.warn("保存缓存到持久化存储失败",error)})}this.evictLRU()}getMatch(path){const item=this.matchCache.get(path);if(!item){this.stats.matchMisses++;return undefined}if(this.isExpired(item)){this.matchCache.delete(path);this.stats.matchMisses++;return undefined}item.lastAccessedAt=Date.now();item.accessCount++;this.stats.matchHits++;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();this.stats={transformHits:0,transformMisses:0,matchHits:0,matchMisses:0};_logger.logger.debug("路由缓存已清空")}destroy(){this.clear();if(this.cleanupTimer){clearInterval(this.cleanupTimer);this.cleanupTimer=null}}getStats(){const totalHits=this.stats.transformHits+this.stats.matchHits;const totalAccess=totalHits+this.stats.transformMisses+this.stats.matchMisses;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);_define_property(this,"cleanupTimer",null);_define_property(this,"stats",{transformHits:0,transformMisses:0,matchHits:0,matchMisses:0});this.config={maxSize:config.maxSize??50,ttl:config.ttl??5*60*1e3,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}

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

@@ -0,0 +1,113 @@
+/**
+ * 路由缓存管理器
+ * 提供路由转换结果、匹配结果的缓存功能
+ */
+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;
+    private cleanupTimer;
+    private stats;
+    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[] | (() => RouteConfig[] | Promise<RouteConfig[]>)): TransformRoutesResult | null;
+    /**
+     * 设置转换结果缓存
+     */
+    set(routes: RouteConfig[] | (() => RouteConfig[] | Promise<RouteConfig[]>), value: TransformRoutesResult): void;
+    /**
+     * 获取路由匹配缓存
+     */
+    getMatch(path: string): RouteConfig | null | undefined;
+    /**
+     * 设置路由匹配缓存
+     */
+    setMatch(path: string, route: RouteConfig | null): void;
+    /**
+     * 清空所有缓存
+     */
+    clear(): void;
+    /**
+     * 销毁缓存实例并释放资源
+     */
+    destroy(): void;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): {
+        transformCacheSize: number;
+        matchCacheSize: number;
+        totalSize: number;
+        hitRate: number;
+    };
+}
+export declare function getRouteCache(config?: RouteCacheConfig): RouteCache;

package/dist/core-bak/router/performance/RouteCache.js

@@ -0,0 +1 @@
+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}import{logger}from"@vlian/logger";export class RouteCache{async initPersistence(){try{if(typeof window!=="undefined"&&"indexedDB"in window){this.persistenceEnabled=true;await this.loadFromPersistence();logger.debug("路由缓存持久化已启用")}}catch(error){logger.warn("路由缓存持久化初始化失败",error);this.persistenceEnabled=false}}async loadFromPersistence(){try{}catch(error){logger.warn("从持久化存储加载缓存失败",error)}}async saveToPersistence(_key,_value){if(!this.persistenceEnabled){return}try{}catch(error){logger.warn("保存到持久化存储失败",error)}}generateKey(routes){if(typeof routes==="function"){return`fn_${routes.name||Math.random().toString(36).substring(7)}`}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}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)}}this.evictLRU()}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(){if(this.cleanupTimer){clearInterval(this.cleanupTimer)}this.cleanupTimer=setInterval(()=>{this.cleanup()},60*1e3)}get(routes){const key=this.generateKey(routes);const item=this.cache.get(key);if(!item){this.stats.transformMisses++;return null}if(this.isExpired(item)){this.cache.delete(key);this.stats.transformMisses++;return null}item.lastAccessedAt=Date.now();item.accessCount++;this.stats.transformHits++;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=>{logger.warn("保存缓存到持久化存储失败",error)})}this.evictLRU()}getMatch(path){const item=this.matchCache.get(path);if(!item){this.stats.matchMisses++;return undefined}if(this.isExpired(item)){this.matchCache.delete(path);this.stats.matchMisses++;return undefined}item.lastAccessedAt=Date.now();item.accessCount++;this.stats.matchHits++;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();this.stats={transformHits:0,transformMisses:0,matchHits:0,matchMisses:0};logger.debug("路由缓存已清空")}destroy(){this.clear();if(this.cleanupTimer){clearInterval(this.cleanupTimer);this.cleanupTimer=null}}getStats(){const totalHits=this.stats.transformHits+this.stats.matchHits;const totalAccess=totalHits+this.stats.transformMisses+this.stats.matchMisses;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);_define_property(this,"cleanupTimer",null);_define_property(this,"stats",{transformHits:0,transformMisses:0,matchHits:0,matchMisses:0});this.config={maxSize:config.maxSize??50,ttl:config.ttl??5*60*1e3,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;export function getRouteCache(config){if(!routeCacheInstance){routeCacheInstance=new RouteCache(config)}return routeCacheInstance}