@vlian/framework 1.2.61 → 1.2.63

package/dist/core/plugin.d.ts

@@ -1,224 +0,0 @@
-import type { StartOptions } from './types';
-import type { InitializationContext } from './initialization';
-import { PluginSandbox, type PluginSandboxConfig } from './plugin/PluginSandbox';
-import { type PluginEventBus } from './plugin/PluginEventBus';
-/**
- * 插件接口
- */
-export interface Plugin<TOption = unknown> {
-    /**
-     * 插件名称
-     */
-    name: string;
-    /**
-     * 插件版本
-     */
-    version?: string;
-    /**
-     * 插件依赖列表（插件名称数组）
-     * 优化：支持插件依赖管理
-     */
-    dependencies?: string[];
-    /**
-     * 插件优先级（数字越小优先级越高）
-     * 优化：支持插件加载顺序控制
-     */
-    priority?: number;
-    /**
-     * 插件沙箱配置（用于权限控制）
-     */
-    sandbox?: PluginSandboxConfig;
-    /**
-     * 初始化前钩子
-     */
-    beforeInit?: (options: Partial<StartOptions>, sandbox: PluginSandbox, eventBus: PluginEventBus) => Promise<void> | void;
-    /**
-     * 初始化钩子
-     */
-    init?: (options: Partial<StartOptions>, context: InitializationContext, sandbox: PluginSandbox, eventBus: PluginEventBus) => Promise<void> | void;
-    /**
-     * 初始化后钩子
-     */
-    afterInit?: (options: Partial<StartOptions>, context: InitializationContext, sandbox: PluginSandbox, eventBus: PluginEventBus) => Promise<void> | void;
-    /**
-     * 销毁钩子
-     */
-    destroy?: () => Promise<void> | void;
-    /**
-     * 自定义属性
-     */
-    readonly option?: Readonly<TOption>;
-}
-/**
- * 插件加载选项
- */
-export interface PluginLoadOptions {
-    /**
-     * 插件URL（用于动态加载）
-     */
-    url?: string;
-    /**
-     * 插件模块路径（用于动态导入）
-     */
-    modulePath?: string;
-    /**
-     * 是否立即初始化
-     */
-    initialize?: boolean;
-    /**
-     * 初始化上下文（如果立即初始化）
-     */
-    initContext?: InitializationContext;
-    /**
-     * 启动选项（如果立即初始化）
-     */
-    startOptions?: StartOptions;
-}
-/**
- * 插件管理器
- *
- * 优化：
- * 1. 支持插件依赖管理
- * 2. 支持插件优先级控制
- * 3. 支持插件生命周期管理
- * 4. 支持插件热插拔（动态加载/卸载）
- */
-export declare class PluginManager {
-    private plugins;
-    private sandboxes;
-    private pluginStatus;
-    private pluginLoaders;
-    /**
-     * 注册插件
-     *
-     * 优化：检查插件依赖是否已注册
-     */
-    register(plugin: Plugin): void;
-    /**
-     * 获取插件加载顺序（考虑依赖和优先级）
-     *
-     * @returns 插件名称数组，按加载顺序排列
-     */
-    private getLoadOrder;
-    /**
-     * 注销插件
-     */
-    unregister(name: string): void;
-    /**
-     * 动态加载插件（热插拔）
-     *
-     * @param options - 插件加载选项
-     * @returns 加载的插件
-     */
-    loadPlugin(options: PluginLoadOptions): Promise<Plugin>;
-    /**
-     * 初始化单个插件
-     *
-     * @param name - 插件名称
-     * @param options - 启动选项
-     * @param context - 初始化上下文
-     */
-    initializePlugin(name: string, options: StartOptions, context: InitializationContext): Promise<void>;
-    /**
-     * 卸载插件（热插拔）
-     *
-     * @param name - 插件名称
-     * @param force - 是否强制卸载（即使有依赖）
-     */
-    unloadPlugin(name: string, force?: boolean): Promise<void>;
-    /**
-     * 检查插件是否可以热加载
-     *
-     * @param plugin - 插件
-     * @returns 是否可以热加载
-     */
-    canHotLoad(plugin: Plugin): boolean;
-    /**
-     * 注册插件加载器（用于延迟加载）
-     *
-     * @param name - 插件名称
-     * @param loader - 加载器函数
-     */
-    registerLoader(name: string, loader: () => Promise<Plugin>): void;
-    /**
-     * 使用加载器加载插件
-     *
-     * @param name - 插件名称
-     * @param options - 加载选项
-     * @returns 加载的插件
-     */
-    loadPluginByLoader(name: string, options?: Omit<PluginLoadOptions, 'url' | 'modulePath'>): Promise<Plugin>;
-    /**
-     * 获取插件
-     */
-    get(name: string): Plugin | undefined;
-    /**
-     * 获取所有插件
-     */
-    getAll(): Plugin[];
-    /**
-     * 执行初始化前钩子
-     *
-     * 优化：按依赖顺序执行
-     */
-    executeBeforeInit(options: StartOptions): Promise<void>;
-    /**
-     * 执行初始化钩子
-     *
-     * 优化：按依赖顺序执行，并更新插件状态
-     */
-    executeInit(options: StartOptions, context: InitializationContext): Promise<void>;
-    /**
-     * 执行初始化后钩子
-     *
-     * 优化：按依赖顺序执行（逆序，确保依赖插件先执行）
-     */
-    executeAfterInit(options: StartOptions, context: InitializationContext): Promise<void>;
-    /**
-     * 获取插件状态
-     *
-     * @param name - 插件名称
-     * @returns 插件状态
-     */
-    getPluginStatus(name: string): 'registered' | 'initialized' | 'destroyed' | 'loading' | undefined;
-    /**
-     * 检查插件是否已加载
-     *
-     * @param name - 插件名称
-     * @returns 是否已加载
-     */
-    isLoaded(name: string): boolean;
-    /**
-     * 获取已加载的插件列表
-     *
-     * @returns 插件名称数组
-     */
-    getLoadedPlugins(): string[];
-    /**
-     * 获取所有插件状态
-     *
-     * @returns 插件状态映射
-     */
-    getAllPluginStatus(): Map<string, 'registered' | 'initialized' | 'destroyed' | 'loading'>;
-    /**
-     * 获取插件沙箱
-     *
-     * @param name - 插件名称
-     * @returns 插件沙箱或undefined
-     */
-    getSandbox(name: string): PluginSandbox | undefined;
-    /**
-     * 获取事件总线
-     */
-    getEventBus(): PluginEventBus;
-    /**
-     * 销毁所有插件
-     */
-    destroyAll(): Promise<void>;
-}
-/**
- * 默认插件管理器
- */
-export declare const pluginManager: PluginManager;
-export { PluginSandbox, PluginPermission, type PluginSandboxConfig } from './plugin/PluginSandbox';
-export { PluginEventBus, pluginEventBus, type EventListener, type EventMetadata, type EventWrapper, type PluginEventBusConfig, } from './plugin/PluginEventBus';

package/dist/core/plugin.js

@@ -1 +0,0 @@
-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{PluginSandbox}from"./plugin/PluginSandbox";import{pluginEventBus}from"./plugin/PluginEventBus";export class PluginManager{register(plugin){if(this.plugins.has(plugin.name)){console.warn(`插件 ${plugin.name} 已存在，将被覆盖`)}if(plugin.dependencies&&plugin.dependencies.length>0){const missingDeps=plugin.dependencies.filter(dep=>!this.plugins.has(dep));if(missingDeps.length>0){console.warn(`插件 ${plugin.name} 的依赖未注册: ${missingDeps.join(", ")}`)}}this.plugins.set(plugin.name,plugin);this.pluginStatus.set(plugin.name,"registered");if(plugin.sandbox){const sandbox=new PluginSandbox({...plugin.sandbox,name:plugin.name});this.sandboxes.set(plugin.name,sandbox)}else{const sandbox=new PluginSandbox({strictMode:false,name:plugin.name});this.sandboxes.set(plugin.name,sandbox)}}getLoadOrder(){const plugins=Array.from(this.plugins.values());const sortedPlugins=plugins.sort((a,b)=>{const priorityA=a.priority??100;const priorityB=b.priority??100;return priorityA-priorityB});const visited=new Set;const visiting=new Set;const result=[];const visit=pluginName=>{if(visiting.has(pluginName)){console.warn(`检测到循环依赖，涉及插件: ${pluginName}`);return}if(visited.has(pluginName)){return}visiting.add(pluginName);const plugin=this.plugins.get(pluginName);if(plugin?.dependencies){for(const dep of plugin.dependencies){visit(dep)}}visiting.delete(pluginName);visited.add(pluginName);result.push(pluginName)};for(const plugin of sortedPlugins){visit(plugin.name)}return result}unregister(name){const plugin=this.plugins.get(name);if(plugin&&plugin.destroy){plugin.destroy()}this.plugins.delete(name);this.sandboxes.delete(name);this.pluginStatus.delete(name);this.pluginLoaders.delete(name)}async loadPlugin(options){let plugin;if(options.url){const response=await fetch(options.url);if(!response.ok){throw new Error(`无法加载插件: ${options.url} (${response.status})`)}const pluginModule=await response.json();plugin=pluginModule.default||pluginModule}else if(options.modulePath){const pluginModule=await import(options.modulePath);plugin=pluginModule.default||pluginModule}else{throw new Error("必须提供 url 或 modulePath")}if(!plugin||!plugin.name){throw new Error("插件格式无效：必须包含 name 属性")}if(this.plugins.has(plugin.name)){throw new Error(`插件 ${plugin.name} 已加载`)}this.pluginStatus.set(plugin.name,"loading");try{this.register(plugin);if(options.initialize&&options.initContext&&options.startOptions){await this.initializePlugin(plugin.name,options.startOptions,options.initContext)}return plugin}catch(error){this.pluginStatus.delete(plugin.name);throw error}}async initializePlugin(name,options,context){const plugin=this.plugins.get(name);if(!plugin){throw new Error(`插件 ${name} 未注册`)}const status=this.pluginStatus.get(name);if(status==="initialized"){return}try{const sandbox=this.sandboxes.get(name);if(!sandbox){throw new Error(`插件 ${name} 的沙箱未找到`)}if(plugin.init){const filteredOptions=sandbox.filterConfig(options);await plugin.init(filteredOptions,context,sandbox,pluginEventBus)}this.pluginStatus.set(name,"initialized")}catch(error){console.error(`插件 ${name} 初始化失败:`,error);throw error}}async unloadPlugin(name,force=false){const plugin=this.plugins.get(name);if(!plugin){throw new Error(`插件 ${name} 未加载`)}if(!force){const dependents=Array.from(this.plugins.values()).filter(p=>p.dependencies&&p.dependencies.includes(name));if(dependents.length>0){throw new Error(`无法卸载插件 ${name}，以下插件依赖它: ${dependents.map(p=>p.name).join(", ")}`)}}if(plugin.destroy){try{await plugin.destroy()}catch(error){console.error(`插件 ${name} 的 destroy 钩子执行失败:`,error)}}this.unregister(name);this.pluginStatus.set(name,"destroyed")}canHotLoad(plugin){if(plugin.dependencies&&plugin.dependencies.length>0){const missingDeps=plugin.dependencies.filter(dep=>!this.plugins.has(dep));if(missingDeps.length>0){return false}}return true}registerLoader(name,loader){this.pluginLoaders.set(name,loader)}async loadPluginByLoader(name,options){const loader=this.pluginLoaders.get(name);if(!loader){throw new Error(`插件 ${name} 的加载器未注册`)}const plugin=await loader();if(!plugin||!plugin.name){throw new Error("插件格式无效：必须包含 name 属性")}if(plugin.name!==name){throw new Error(`插件名称不匹配: 期望 ${name}，实际 ${plugin.name}`)}if(this.plugins.has(plugin.name)){return this.plugins.get(plugin.name)}this.pluginStatus.set(plugin.name,"loading");try{this.register(plugin);if(options?.initialize&&options.initContext&&options.startOptions){await this.initializePlugin(plugin.name,options.startOptions,options.initContext)}return plugin}catch(error){this.pluginStatus.delete(plugin.name);throw error}}get(name){return this.plugins.get(name)}getAll(){return Array.from(this.plugins.values())}async executeBeforeInit(options){const loadOrder=this.getLoadOrder();for(const pluginName of loadOrder){const plugin=this.plugins.get(pluginName);if(!plugin||!plugin.beforeInit){continue}try{const sandbox=this.sandboxes.get(plugin.name);if(!sandbox){console.warn(`插件 ${plugin.name} 的沙箱未找到`);continue}const filteredOptions=sandbox.filterConfig(options);await plugin.beforeInit(filteredOptions,sandbox,pluginEventBus)}catch(error){console.error(`插件 ${plugin.name} 的 beforeInit 钩子执行失败:`,error)}}}async executeInit(options,context){const loadOrder=this.getLoadOrder();for(const pluginName of loadOrder){const plugin=this.plugins.get(pluginName);if(!plugin||!plugin.init){continue}try{const sandbox=this.sandboxes.get(plugin.name);if(!sandbox){console.warn(`插件 ${plugin.name} 的沙箱未找到`);continue}const filteredOptions=sandbox.filterConfig(options);await plugin.init(filteredOptions,context,sandbox,pluginEventBus);this.pluginStatus.set(plugin.name,"initialized")}catch(error){console.error(`插件 ${plugin.name} 的 init 钩子执行失败:`,error)}}}async executeAfterInit(options,context){const loadOrder=this.getLoadOrder();const reverseOrder=[...loadOrder].reverse();for(const pluginName of reverseOrder){const plugin=this.plugins.get(pluginName);if(!plugin||!plugin.afterInit){continue}try{const sandbox=this.sandboxes.get(plugin.name);if(!sandbox){console.warn(`插件 ${plugin.name} 的沙箱未找到`);continue}const filteredOptions=sandbox.filterConfig(options);await plugin.afterInit(filteredOptions,context,sandbox,pluginEventBus)}catch(error){console.error(`插件 ${plugin.name} 的 afterInit 钩子执行失败:`,error)}}}getPluginStatus(name){return this.pluginStatus.get(name)}isLoaded(name){return this.plugins.has(name)}getLoadedPlugins(){return Array.from(this.plugins.keys())}getAllPluginStatus(){return new Map(this.pluginStatus)}getSandbox(name){return this.sandboxes.get(name)}getEventBus(){return pluginEventBus}async destroyAll(){for(const plugin of this.plugins.values()){if(plugin.destroy){try{await plugin.destroy()}catch(error){console.error(`插件 ${plugin.name} 的 destroy 钩子执行失败:`,error)}}}this.plugins.clear()}constructor(){_define_property(this,"plugins",new Map);_define_property(this,"sandboxes",new Map);_define_property(this,"pluginStatus",new Map);_define_property(this,"pluginLoaders",new Map)}}export const pluginManager=new PluginManager;export{PluginSandbox,PluginPermission}from"./plugin/PluginSandbox";export{PluginEventBus,pluginEventBus}from"./plugin/PluginEventBus";

package/dist/core/router/RouterManager.cjs

@@ -1 +0,0 @@
-"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 RouterManager(){return RouterManager},get getRouterManager(){return getRouterManager}});const _logger=require("@vlian/logger");const _transform=require("./utils/transform");const _transform1=require("./utils/adapters/react-router/transform");const _reactrouterdom=require("react-router-dom");const _validation=require("./validation");const _lifecycle=require("./lifecycle");const _middleware=require("./middleware");const _errors=require("./errors");const _RouteCache=require("./performance/RouteCache");const _RoutePreloader=require("./performance/RoutePreloader");const _plugin=require("./plugin");const _monitoring=require("./monitoring");const _adapter=require("./adapter");const _reactrouter=require("./adapter/react-router");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 RouterManager=class RouterManager{static getInstance(){if(!RouterManager.instance){RouterManager.instance=new RouterManager}return RouterManager.instance}async initialize(config){if(config.enabled===false||config.enabled==="disabled"){_logger.logger.info("路由系统已禁用");return}if(config.enableValidation!==false){try{_validation.RouterConfigValidator.validate(config);_logger.logger.debug("路由配置验证通过")}catch(error){_logger.logger.error("路由配置验证失败",error);if(process.env.NODE_ENV==="development"){throw error}}}await this.pluginManager.executeHooks(_plugin.PluginLifecycleStage.BEFORE_INIT,{config});if(config.hooks){const lifecycleManager=(0,_lifecycle.getRouterLifecycleManager)();lifecycleManager.register(config.hooks);_logger.logger.debug("路由生命周期钩子已注册")}if(!config.routes){throw new _errors.RouterError("路由配置不能为空",_errors.RouterErrorCode.ROUTER_CONFIG_ERROR)}this.preloader.updateConfig(config.preload);this.preloader.clear();let result;const cacheKey=config.routes;const cachedResult=this.cache.get(cacheKey);if(cachedResult){_logger.logger.debug("使用缓存的路由转换结果");result=cachedResult}else{await this.pluginManager.executeHooks(_plugin.PluginLifecycleStage.BEFORE_TRANSFORM,{config});result=await (0,_transform.transformRoutes)(config.routes,config.transformOptions);await this.pluginManager.executeHooks(_plugin.PluginLifecycleStage.AFTER_TRANSFORM,{config,routes:result.routes});this.cache.set(cacheKey,result)}const enableHydrateFallback=config.enableHydrateFallback??Boolean(config.options?.hydrationData);const reactRoutes=await (0,_transform1.transformRoutesToReactRoutes)(result.routes,result,config.defaultRouteErrorComponent,config.defaultRouteLoadingComponent,enableHydrateFallback);if(result.routes){this.preloader.registerRoutes(result.routes,result);this.preloader.startPreload()}await this.resolveInitialLazyRoutes(reactRoutes,!enableHydrateFallback);let routerInstance=null;if(config.mode==="browser"){routerInstance=(0,_reactrouterdom.createBrowserRouter)(reactRoutes,config.options)}else if(config.mode==="hash"){routerInstance=(0,_reactrouterdom.createHashRouter)(reactRoutes,config.options)}else if(config.mode==="memory"){routerInstance=(0,_reactrouterdom.createMemoryRouter)(reactRoutes,config.options)}if(!routerInstance){throw new _errors.RouterError("路由模式不支持",_errors.RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,undefined,{mode:config.mode})}this.router=routerInstance;this.initialized=true;await this.pluginManager.executeHooks(_plugin.PluginLifecycleStage.AFTER_INIT,{config,routes:result.routes});const initialPath=typeof window!=="undefined"?`${window.location.pathname}${window.location.search}${window.location.hash}`:this.router?.state?.location?.pathname??"/";this.monitoring.trackRouteAccess({path:initialPath,meta:{name:"router-init"}},undefined,true);_logger.logger.info("路由管理器初始化完成")}async resolveInitialLazyRoutes(routes,resolveAll=false){if(typeof window==="undefined"){return}let targetRoutes=[];if(resolveAll){const stack=[...routes];while(stack.length>0){const current=stack.shift();if(!current){continue}targetRoutes.push(current);if(current.children&&current.children.length>0){stack.push(...current.children)}}}else{const matches=(0,_reactrouterdom.matchRoutes)(routes,window.location.pathname)??[];if(matches.length===0){return}targetRoutes=matches.map(match=>match.route)}await Promise.all(targetRoutes.map(async route=>{const lazy=route.lazy;if(typeof lazy!=="function"){return}try{const resolved=await lazy();Object.assign(route,resolved);delete route.lazy}catch(error){_logger.logger.warn("首屏路由懒加载预解析失败，回退到 Router 默认懒加载",error)}}))}getRouter(){return this.router}isInitialized(){return this.initialized}destroy(){this.pluginManager.executeHooks(_plugin.PluginLifecycleStage.DESTROY,{config:{}});this.preloader.stopPreload();this.router=null;this.initialized=false;const lifecycleManager=(0,_lifecycle.getRouterLifecycleManager)();lifecycleManager.clear();const middlewareManager=(0,_middleware.getRouterMiddlewareManager)();middlewareManager.clear();_logger.logger.info("路由管理器已销毁")}getCache(){return this.cache}getPreloader(){return this.preloader}getPluginManager(){return this.pluginManager}getMonitoring(){return this.monitoring}constructor(){_define_property(this,"router",null);_define_property(this,"initialized",false);_define_property(this,"cache",(0,_RouteCache.getRouteCache)());_define_property(this,"preloader",(0,_RoutePreloader.getRoutePreloader)());_define_property(this,"pluginManager",(0,_plugin.getRouterPluginManager)());_define_property(this,"monitoring",(0,_monitoring.getRouterMonitoring)());_define_property(this,"adapterManager",(0,_adapter.getAdapterManager)());this.adapterManager.register({name:"react-router",factory:(0,_reactrouter.createReactRouterAdapter)(),priority:10})}};_define_property(RouterManager,"instance",null);function getRouterManager(){return RouterManager.getInstance()}

package/dist/core/router/RouterManager.d.ts

@@ -1,87 +0,0 @@
-import type { RouterConfig } from './types';
-import { createBrowserRouter } from 'react-router-dom';
-export declare class RouterManager {
-    private static instance;
-    /**
-     * 路由实例
-     * 只能在 initialize 方法中赋值
-     */
-    private router;
-    /**
-     * 是否已初始化
-     */
-    private initialized;
-    /**
-     * 路由缓存实例
-     */
-    private cache;
-    /**
-     * 路由预加载器实例
-     */
-    private preloader;
-    /**
-     * 路由插件管理器实例
-     */
-    private pluginManager;
-    /**
-     * 路由监控服务实例
-     */
-    private monitoring;
-    /**
-     * 路由适配器管理器实例
-     */
-    private adapterManager;
-    private constructor();
-    /**
-     * 获取单例实例
-     */
-    static getInstance(): RouterManager;
-    /**
-     * 初始化路由管理器
-     *
-     * @param config - 路由配置
-     * @param _appInstance - 应用实例（保留用于兼容性，当前未使用）
-     */
-    initialize(config: RouterConfig): Promise<void>;
-    /**
-     * 预解析 lazy 路由，避免首屏或重定向链路长时间停留在 hydrate fallback。
-     * resolveAll=true 时会在初始化阶段解析全部 lazy 路由。
-     */
-    private resolveInitialLazyRoutes;
-    /**
-     * 获取路由实例
-     *
-     * @returns 路由实例，如果未初始化则返回 null
-     */
-    getRouter(): ReturnType<typeof createBrowserRouter> | null;
-    /**
-     * 检查是否已初始化
-     *
-     * @returns 如果已初始化返回 true，否则返回 false
-     */
-    isInitialized(): boolean;
-    /**
-     * 销毁路由管理器
-     */
-    destroy(): void;
-    /**
-     * 获取路由缓存实例
-     */
-    getCache(): import("./performance").RouteCache;
-    /**
-     * 获取路由预加载器实例
-     */
-    getPreloader(): import("./performance").RoutePreloader;
-    /**
-     * 获取路由插件管理器实例
-     */
-    getPluginManager(): import("./plugin").RouterPluginManager;
-    /**
-     * 获取路由监控服务实例
-     */
-    getMonitoring(): import("./monitoring").RouterMonitoring;
-}
-/**
- * 获取路由管理器
- */
-export declare function getRouterManager(): RouterManager;

package/dist/core/router/RouterManager.js

@@ -1 +0,0 @@
-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{transformRoutes}from"./utils/transform";import{transformRoutesToReactRoutes}from"./utils/adapters/react-router/transform";import{createBrowserRouter,createHashRouter,createMemoryRouter,matchRoutes}from"react-router-dom";import{RouterConfigValidator}from"./validation";import{getRouterLifecycleManager}from"./lifecycle";import{getRouterMiddlewareManager}from"./middleware";import{RouterError,RouterErrorCode}from"./errors";import{getRouteCache}from"./performance/RouteCache";import{getRoutePreloader}from"./performance/RoutePreloader";import{getRouterPluginManager,PluginLifecycleStage}from"./plugin";import{getRouterMonitoring}from"./monitoring";import{getAdapterManager}from"./adapter";import{createReactRouterAdapter}from"./adapter/react-router";export class RouterManager{static getInstance(){if(!RouterManager.instance){RouterManager.instance=new RouterManager}return RouterManager.instance}async initialize(config){if(config.enabled===false||config.enabled==="disabled"){logger.info("路由系统已禁用");return}if(config.enableValidation!==false){try{RouterConfigValidator.validate(config);logger.debug("路由配置验证通过")}catch(error){logger.error("路由配置验证失败",error);if(process.env.NODE_ENV==="development"){throw error}}}await this.pluginManager.executeHooks(PluginLifecycleStage.BEFORE_INIT,{config});if(config.hooks){const lifecycleManager=getRouterLifecycleManager();lifecycleManager.register(config.hooks);logger.debug("路由生命周期钩子已注册")}if(!config.routes){throw new RouterError("路由配置不能为空",RouterErrorCode.ROUTER_CONFIG_ERROR)}this.preloader.updateConfig(config.preload);this.preloader.clear();let result;const cacheKey=config.routes;const cachedResult=this.cache.get(cacheKey);if(cachedResult){logger.debug("使用缓存的路由转换结果");result=cachedResult}else{await this.pluginManager.executeHooks(PluginLifecycleStage.BEFORE_TRANSFORM,{config});result=await transformRoutes(config.routes,config.transformOptions);await this.pluginManager.executeHooks(PluginLifecycleStage.AFTER_TRANSFORM,{config,routes:result.routes});this.cache.set(cacheKey,result)}const enableHydrateFallback=config.enableHydrateFallback??Boolean(config.options?.hydrationData);const reactRoutes=await transformRoutesToReactRoutes(result.routes,result,config.defaultRouteErrorComponent,config.defaultRouteLoadingComponent,enableHydrateFallback);if(result.routes){this.preloader.registerRoutes(result.routes,result);this.preloader.startPreload()}await this.resolveInitialLazyRoutes(reactRoutes,!enableHydrateFallback);let routerInstance=null;if(config.mode==="browser"){routerInstance=createBrowserRouter(reactRoutes,config.options)}else if(config.mode==="hash"){routerInstance=createHashRouter(reactRoutes,config.options)}else if(config.mode==="memory"){routerInstance=createMemoryRouter(reactRoutes,config.options)}if(!routerInstance){throw new RouterError("路由模式不支持",RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,undefined,{mode:config.mode})}this.router=routerInstance;this.initialized=true;await this.pluginManager.executeHooks(PluginLifecycleStage.AFTER_INIT,{config,routes:result.routes});const initialPath=typeof window!=="undefined"?`${window.location.pathname}${window.location.search}${window.location.hash}`:this.router?.state?.location?.pathname??"/";this.monitoring.trackRouteAccess({path:initialPath,meta:{name:"router-init"}},undefined,true);logger.info("路由管理器初始化完成")}async resolveInitialLazyRoutes(routes,resolveAll=false){if(typeof window==="undefined"){return}let targetRoutes=[];if(resolveAll){const stack=[...routes];while(stack.length>0){const current=stack.shift();if(!current){continue}targetRoutes.push(current);if(current.children&&current.children.length>0){stack.push(...current.children)}}}else{const matches=matchRoutes(routes,window.location.pathname)??[];if(matches.length===0){return}targetRoutes=matches.map(match=>match.route)}await Promise.all(targetRoutes.map(async route=>{const lazy=route.lazy;if(typeof lazy!=="function"){return}try{const resolved=await lazy();Object.assign(route,resolved);delete route.lazy}catch(error){logger.warn("首屏路由懒加载预解析失败，回退到 Router 默认懒加载",error)}}))}getRouter(){return this.router}isInitialized(){return this.initialized}destroy(){this.pluginManager.executeHooks(PluginLifecycleStage.DESTROY,{config:{}});this.preloader.stopPreload();this.router=null;this.initialized=false;const lifecycleManager=getRouterLifecycleManager();lifecycleManager.clear();const middlewareManager=getRouterMiddlewareManager();middlewareManager.clear();logger.info("路由管理器已销毁")}getCache(){return this.cache}getPreloader(){return this.preloader}getPluginManager(){return this.pluginManager}getMonitoring(){return this.monitoring}constructor(){_define_property(this,"router",null);_define_property(this,"initialized",false);_define_property(this,"cache",getRouteCache());_define_property(this,"preloader",getRoutePreloader());_define_property(this,"pluginManager",getRouterPluginManager());_define_property(this,"monitoring",getRouterMonitoring());_define_property(this,"adapterManager",getAdapterManager());this.adapterManager.register({name:"react-router",factory:createReactRouterAdapter(),priority:10})}}_define_property(RouterManager,"instance",null);export function getRouterManager(){return RouterManager.getInstance()}

package/dist/core/router/adapter/AdapterManager.cjs

@@ -1 +0,0 @@
-"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 AdapterManager(){return AdapterManager},get getAdapterManager(){return getAdapterManager}});const _logger=require("@vlian/logger");const _errors=require("../errors");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 AdapterManager=class AdapterManager{register(registration){if(!registration.name){throw new Error("适配器必须提供名称")}if(!registration.factory||typeof registration.factory!=="function"){throw new Error("适配器必须提供工厂函数")}const adapterRegistration={priority:100,enabled:true,...registration};this.adapters.set(registration.name,adapterRegistration);_logger.logger.debug(`路由适配器已注册: ${registration.name}`);if(!this.defaultAdapterName){this.defaultAdapterName=registration.name}return()=>{this.unregister(registration.name)}}registerBatch(registrations){registrations.forEach(registration=>this.register(registration))}unregister(name){if(this.adapters.has(name)){this.adapters.delete(name);_logger.logger.debug(`路由适配器已取消注册: ${name}`);if(this.defaultAdapterName===name){const firstAdapter=Array.from(this.adapters.keys())[0];this.defaultAdapterName=firstAdapter||null}}}async createAdapter(config,name){const adapterName=name||this.defaultAdapterName;if(!adapterName){throw new _errors.RouterError("没有可用的路由适配器",_errors.RouterErrorCode.ROUTER_NOT_INITIALIZED)}const registration=this.adapters.get(adapterName);if(!registration){throw new _errors.RouterError(`路由适配器不存在: ${adapterName}`,_errors.RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,undefined,{adapterName})}if(!registration.enabled){throw new _errors.RouterError(`路由适配器已禁用: ${adapterName}`,_errors.RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,undefined,{adapterName})}try{const adapter=await registration.factory(config);if(!adapter||typeof adapter.initialize!=="function"){throw new Error("适配器实例无效")}await adapter.initialize(config);_logger.logger.info(`路由适配器已创建并初始化: ${adapterName}`);return adapter}catch(error){_logger.logger.error(`创建路由适配器失败: ${adapterName}`,error);const errorContext={adapterName};if(error instanceof Error){errorContext.originalError=error}throw new _errors.RouterError(`创建路由适配器失败: ${adapterName}`,_errors.RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,error instanceof Error?error:undefined,errorContext)}}setCurrentAdapter(adapter){if(this.currentAdapter&&this.currentAdapter.destroy){try{this.currentAdapter.destroy()}catch(error){_logger.logger.warn("销毁旧适配器失败",error)}}this.currentAdapter=adapter;_logger.logger.debug(`当前路由适配器已设置: ${adapter.name}`)}getCurrentAdapter(){return this.currentAdapter}setDefaultAdapter(name){if(!this.adapters.has(name)){throw new Error(`适配器不存在: ${name}`)}this.defaultAdapterName=name;_logger.logger.debug(`默认路由适配器已设置: ${name}`)}getDefaultAdapterName(){return this.defaultAdapterName}getAllAdapters(){return Array.from(this.adapters.values())}getEnabledAdapters(){return Array.from(this.adapters.values()).filter(a=>a.enabled!==false)}getAdapter(name){return this.adapters.get(name)}clear(){if(this.currentAdapter&&this.currentAdapter.destroy){try{this.currentAdapter.destroy()}catch(error){_logger.logger.warn("销毁适配器失败",error)}}this.adapters.clear();this.currentAdapter=null;this.defaultAdapterName=null;_logger.logger.debug("所有路由适配器已清空")}getCount(){return this.adapters.size}constructor(){_define_property(this,"adapters",new Map);_define_property(this,"currentAdapter",null);_define_property(this,"defaultAdapterName",null)}};let adapterManagerInstance=null;function getAdapterManager(){if(!adapterManagerInstance){adapterManagerInstance=new AdapterManager}return adapterManagerInstance}

package/dist/core/router/adapter/AdapterManager.d.ts

@@ -1,94 +0,0 @@
-/**
- * 路由适配器管理器
- * 负责管理路由适配器的注册、创建和切换
- */
-import type { IRouterAdapter, AdapterRegistration, RouterAdapterConfig } from './types';
-/**
- * 路由适配器管理器
- */
-export declare class AdapterManager {
-    private adapters;
-    private currentAdapter;
-    private defaultAdapterName;
-    /**
-     * 注册适配器
-     *
-     * @param registration - 适配器注册信息
-     * @returns 取消注册函数
-     */
-    register(registration: AdapterRegistration): () => void;
-    /**
-     * 批量注册适配器
-     *
-     * @param registrations - 适配器注册信息数组
-     */
-    registerBatch(registrations: AdapterRegistration[]): void;
-    /**
-     * 取消注册适配器
-     *
-     * @param name - 适配器名称
-     */
-    unregister(name: string): void;
-    /**
-     * 创建适配器实例
-     *
-     * @param name - 适配器名称（可选，使用默认适配器）
-     * @param config - 适配器配置
-     * @returns 适配器实例
-     */
-    createAdapter(config: RouterAdapterConfig, name?: string): Promise<IRouterAdapter>;
-    /**
-     * 设置当前适配器
-     *
-     * @param adapter - 适配器实例
-     */
-    setCurrentAdapter(adapter: IRouterAdapter): void;
-    /**
-     * 获取当前适配器
-     *
-     * @returns 当前适配器实例，如果不存在返回 null
-     */
-    getCurrentAdapter(): IRouterAdapter | null;
-    /**
-     * 设置默认适配器
-     *
-     * @param name - 适配器名称
-     */
-    setDefaultAdapter(name: string): void;
-    /**
-     * 获取默认适配器名称
-     *
-     * @returns 默认适配器名称
-     */
-    getDefaultAdapterName(): string | null;
-    /**
-     * 获取所有适配器
-     *
-     * @returns 适配器注册信息数组
-     */
-    getAllAdapters(): AdapterRegistration[];
-    /**
-     * 获取启用的适配器
-     *
-     * @returns 启用的适配器注册信息数组
-     */
-    getEnabledAdapters(): AdapterRegistration[];
-    /**
-     * 获取适配器
-     *
-     * @param name - 适配器名称
-     * @returns 适配器注册信息，如果不存在返回 undefined
-     */
-    getAdapter(name: string): AdapterRegistration | undefined;
-    /**
-     * 清空所有适配器
-     */
-    clear(): void;
-    /**
-     * 获取适配器数量
-     *
-     * @returns 适配器数量
-     */
-    getCount(): number;
-}
-export declare function getAdapterManager(): AdapterManager;

package/dist/core/router/adapter/AdapterManager.js

@@ -1 +0,0 @@
-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{RouterError,RouterErrorCode}from"../errors";export class AdapterManager{register(registration){if(!registration.name){throw new Error("适配器必须提供名称")}if(!registration.factory||typeof registration.factory!=="function"){throw new Error("适配器必须提供工厂函数")}const adapterRegistration={priority:100,enabled:true,...registration};this.adapters.set(registration.name,adapterRegistration);logger.debug(`路由适配器已注册: ${registration.name}`);if(!this.defaultAdapterName){this.defaultAdapterName=registration.name}return()=>{this.unregister(registration.name)}}registerBatch(registrations){registrations.forEach(registration=>this.register(registration))}unregister(name){if(this.adapters.has(name)){this.adapters.delete(name);logger.debug(`路由适配器已取消注册: ${name}`);if(this.defaultAdapterName===name){const firstAdapter=Array.from(this.adapters.keys())[0];this.defaultAdapterName=firstAdapter||null}}}async createAdapter(config,name){const adapterName=name||this.defaultAdapterName;if(!adapterName){throw new RouterError("没有可用的路由适配器",RouterErrorCode.ROUTER_NOT_INITIALIZED)}const registration=this.adapters.get(adapterName);if(!registration){throw new RouterError(`路由适配器不存在: ${adapterName}`,RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,undefined,{adapterName})}if(!registration.enabled){throw new RouterError(`路由适配器已禁用: ${adapterName}`,RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,undefined,{adapterName})}try{const adapter=await registration.factory(config);if(!adapter||typeof adapter.initialize!=="function"){throw new Error("适配器实例无效")}await adapter.initialize(config);logger.info(`路由适配器已创建并初始化: ${adapterName}`);return adapter}catch(error){logger.error(`创建路由适配器失败: ${adapterName}`,error);const errorContext={adapterName};if(error instanceof Error){errorContext.originalError=error}throw new RouterError(`创建路由适配器失败: ${adapterName}`,RouterErrorCode.ROUTER_CONFIG_ERROR,undefined,error instanceof Error?error:undefined,errorContext)}}setCurrentAdapter(adapter){if(this.currentAdapter&&this.currentAdapter.destroy){try{this.currentAdapter.destroy()}catch(error){logger.warn("销毁旧适配器失败",error)}}this.currentAdapter=adapter;logger.debug(`当前路由适配器已设置: ${adapter.name}`)}getCurrentAdapter(){return this.currentAdapter}setDefaultAdapter(name){if(!this.adapters.has(name)){throw new Error(`适配器不存在: ${name}`)}this.defaultAdapterName=name;logger.debug(`默认路由适配器已设置: ${name}`)}getDefaultAdapterName(){return this.defaultAdapterName}getAllAdapters(){return Array.from(this.adapters.values())}getEnabledAdapters(){return Array.from(this.adapters.values()).filter(a=>a.enabled!==false)}getAdapter(name){return this.adapters.get(name)}clear(){if(this.currentAdapter&&this.currentAdapter.destroy){try{this.currentAdapter.destroy()}catch(error){logger.warn("销毁适配器失败",error)}}this.adapters.clear();this.currentAdapter=null;this.defaultAdapterName=null;logger.debug("所有路由适配器已清空")}getCount(){return this.adapters.size}constructor(){_define_property(this,"adapters",new Map);_define_property(this,"currentAdapter",null);_define_property(this,"defaultAdapterName",null)}}let adapterManagerInstance=null;export function getAdapterManager(){if(!adapterManagerInstance){adapterManagerInstance=new AdapterManager}return adapterManagerInstance}

package/dist/core/router/adapter/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./types"),exports);_export_star(require("./AdapterManager"),exports);_export_star(require("./react-router"),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/router/adapter/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * 路由适配器模块入口
- */
-export * from './types';
-export * from './AdapterManager';
-export * from './react-router';

package/dist/core/router/adapter/index.js

@@ -1 +0,0 @@
-export*from"./types";export*from"./AdapterManager";export*from"./react-router";

package/dist/core/router/adapter/react-router/ReactRouterAdapter.cjs

@@ -1 +0,0 @@
-"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 ReactRouterAdapter(){return ReactRouterAdapter},get createReactRouterAdapter(){return createReactRouterAdapter}});const _reactrouterdom=require("react-router-dom");const _transform=require("../../utils/adapters/react-router/transform");const _transform1=require("../../utils/transform");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 ReactRouterAdapter=class ReactRouterAdapter{async initialize(config){const transformResult=await (0,_transform1.transformRoutes)(config.routes);const reactRoutes=await (0,_transform.transformRoutesToReactRoutes)(transformResult.routes,transformResult,config.defaultRouteErrorComponent,config.defaultRouteLoadingComponent,Boolean(config.options?.hydrationData));const mode=config.mode||"browser";if(mode==="browser"){this.router=(0,_reactrouterdom.createBrowserRouter)(reactRoutes,config.options)}else if(mode==="hash"){this.router=(0,_reactrouterdom.createHashRouter)(reactRoutes,config.options)}else if(mode==="memory"){this.router=(0,_reactrouterdom.createMemoryRouter)(reactRoutes,config.options)}else{throw new Error(`不支持的路由模式: ${mode}`)}_logger.logger.debug("React Router 适配器初始化完成")}mount(_app){if(!this.router){throw new Error("适配器未初始化")}_logger.logger.debug("React Router 适配器已挂载")}navigate(to,options){if(!this.router){throw new Error("适配器未初始化")}if(options?.replace){this.router.navigate(to,{replace:true,state:options.state})}else{this.router.navigate(to,{state:options?.state})}}getCurrentRoute(){if(!this.router){throw new Error("适配器未初始化")}const state=this.router.state;const location=state.location;const query={};if(location.search){const params=new URLSearchParams(location.search);params.forEach((value,key)=>{query[key]=value})}return{path:location.pathname+location.hash,query,params:location.state}}getRouter(){return this.router}destroy(){this.router=null;_logger.logger.debug("React Router 适配器已销毁")}constructor(){_define_property(this,"name","react-router");_define_property(this,"version","6.0.0");_define_property(this,"router",null)}};function createReactRouterAdapter(){return _config=>{return new ReactRouterAdapter}}

package/dist/core/router/adapter/react-router/ReactRouterAdapter.d.ts

@@ -1,43 +0,0 @@
-/**
- * React Router 适配器实现
- */
-import type { IRouterAdapter, RouterAdapterConfig } from '../types';
-import type { RouteLocation, NavigateOptions } from '../../types';
-import type { AppInstance } from '../../../startup/AppInstance';
-import { createBrowserRouter } from 'react-router-dom';
-/**
- * React Router 适配器
- */
-export declare class ReactRouterAdapter implements IRouterAdapter {
-    readonly name = "react-router";
-    readonly version = "6.0.0";
-    private router;
-    /**
-     * 初始化适配器
-     */
-    initialize(config: RouterAdapterConfig): Promise<void>;
-    /**
-     * 挂载到应用实例
-     */
-    mount(_app: AppInstance): void;
-    /**
-     * 导航到指定路径
-     */
-    navigate(to: string, options?: NavigateOptions): void;
-    /**
-     * 获取当前路由信息
-     */
-    getCurrentRoute(): RouteLocation;
-    /**
-     * 获取路由实例（用于 RouterProvider）
-     */
-    getRouter(): ReturnType<typeof createBrowserRouter> | null;
-    /**
-     * 销毁适配器
-     */
-    destroy(): void;
-}
-/**
- * 创建 React Router 适配器工厂函数
- */
-export declare function createReactRouterAdapter(): (_config: RouterAdapterConfig) => IRouterAdapter;

package/dist/core/router/adapter/react-router/ReactRouterAdapter.js

@@ -1 +0,0 @@
-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{createBrowserRouter,createHashRouter,createMemoryRouter}from"react-router-dom";import{transformRoutesToReactRoutes}from"../../utils/adapters/react-router/transform";import{transformRoutes}from"../../utils/transform";import{logger}from"@vlian/logger";export class ReactRouterAdapter{async initialize(config){const transformResult=await transformRoutes(config.routes);const reactRoutes=await transformRoutesToReactRoutes(transformResult.routes,transformResult,config.defaultRouteErrorComponent,config.defaultRouteLoadingComponent,Boolean(config.options?.hydrationData));const mode=config.mode||"browser";if(mode==="browser"){this.router=createBrowserRouter(reactRoutes,config.options)}else if(mode==="hash"){this.router=createHashRouter(reactRoutes,config.options)}else if(mode==="memory"){this.router=createMemoryRouter(reactRoutes,config.options)}else{throw new Error(`不支持的路由模式: ${mode}`)}logger.debug("React Router 适配器初始化完成")}mount(_app){if(!this.router){throw new Error("适配器未初始化")}logger.debug("React Router 适配器已挂载")}navigate(to,options){if(!this.router){throw new Error("适配器未初始化")}if(options?.replace){this.router.navigate(to,{replace:true,state:options.state})}else{this.router.navigate(to,{state:options?.state})}}getCurrentRoute(){if(!this.router){throw new Error("适配器未初始化")}const state=this.router.state;const location=state.location;const query={};if(location.search){const params=new URLSearchParams(location.search);params.forEach((value,key)=>{query[key]=value})}return{path:location.pathname+location.hash,query,params:location.state}}getRouter(){return this.router}destroy(){this.router=null;logger.debug("React Router 适配器已销毁")}constructor(){_define_property(this,"name","react-router");_define_property(this,"version","6.0.0");_define_property(this,"router",null)}}export function createReactRouterAdapter(){return _config=>{return new ReactRouterAdapter}}

package/dist/core/router/adapter/react-router/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});_export_star(require("./ReactRouterAdapter"),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/router/adapter/react-router/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * React Router 适配器模块入口
- */
-export * from './ReactRouterAdapter';

package/dist/core/router/adapter/react-router/index.js

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

package/dist/core/router/adapter/types.cjs

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