@vlian/framework 1.2.61 → 1.2.62

package/dist/core-bak/plugin/PluginEventBus.d.ts

@@ -0,0 +1,169 @@
+/**
+ * 插件事件总线
+ * 用于插件间通信
+ */
+/**
+ * 事件监听器类型
+ */
+export type EventListener<T = unknown> = (data: T) => void | Promise<void>;
+/**
+ * 事件元数据
+ */
+export interface EventMetadata {
+    /**
+     * 事件来源（插件名称）
+     */
+    source?: string;
+    /**
+     * 事件时间戳
+     */
+    timestamp: number;
+    /**
+     * 事件ID（用于追踪）
+     */
+    eventId?: string;
+    /**
+     * 事件优先级
+     */
+    priority?: number;
+}
+/**
+ * 事件包装器
+ */
+export interface EventWrapper<T = unknown> {
+    /**
+     * 事件数据
+     */
+    data: T;
+    /**
+     * 事件元数据
+     */
+    metadata: EventMetadata;
+}
+/**
+ * 事件总线配置
+ */
+export interface PluginEventBusConfig {
+    /**
+     * 是否启用事件追踪
+     */
+    enableTracking?: boolean;
+    /**
+     * 最大事件历史记录数
+     */
+    maxHistorySize?: number;
+    /**
+     * 是否启用事件验证
+     */
+    enableValidation?: boolean;
+    /**
+     * 事件验证函数
+     */
+    validator?: (event: string, data: unknown) => boolean;
+}
+/**
+ * 事件总线
+ */
+export declare class PluginEventBus {
+    private listeners;
+    private eventHistory;
+    private config;
+    private eventCounter;
+    /**
+     * 订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器（可以接收 EventWrapper 或直接数据）
+     * @returns 取消订阅函数
+     */
+    on<T = unknown>(event: string, listener: EventListener<T | EventWrapper<T>>): () => void;
+    /**
+     * 取消订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器
+     */
+    off<T = unknown>(event: string, listener: EventListener<T>): void;
+    constructor(config?: PluginEventBusConfig);
+    /**
+     * 发布事件
+     *
+     * @param event - 事件名称
+     * @param data - 事件数据
+     * @param metadata - 事件元数据（可选）
+     */
+    emit<T = unknown>(event: string, data?: T, metadata?: Partial<EventMetadata>): Promise<void>;
+    /**
+     * 发布事件（仅数据，向后兼容）
+     *
+     * @param event - 事件名称
+     * @param data - 事件数据
+     */
+    emitData<T = unknown>(event: string, data?: T): Promise<void>;
+    /**
+     * 一次性订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器
+     */
+    once<T = unknown>(event: string, listener: EventListener<T>): void;
+    /**
+     * 清空所有事件监听器
+     */
+    clear(): void;
+    /**
+     * 获取事件监听器数量
+     *
+     * @param event - 事件名称，如果不提供则返回所有事件的监听器总数
+     */
+    listenerCount(event?: string): number;
+    /**
+     * 获取所有事件名称
+     */
+    eventNames(): string[];
+    /**
+     * 获取事件历史记录
+     *
+     * @param event - 事件名称（可选，如果提供则只返回该事件的历史）
+     * @param limit - 限制返回的记录数
+     * @returns 事件历史记录
+     */
+    getEventHistory(event?: string, limit?: number): Array<{
+        event: string;
+        data: unknown;
+        metadata: EventMetadata;
+    }>;
+    /**
+     * 清空事件历史记录
+     */
+    clearHistory(): void;
+    /**
+     * 请求-响应模式：发送请求并等待响应
+     *
+     * @param event - 事件名称
+     * @param data - 请求数据
+     * @param timeout - 超时时间（毫秒）
+     * @returns 响应数据
+     */
+    request<TRequest = unknown, TResponse = unknown>(event: string, data?: TRequest, timeout?: number): Promise<TResponse>;
+    /**
+     * 请求-响应模式：注册请求处理器
+     *
+     * @param event - 事件名称
+     * @param handler - 请求处理器
+     * @returns 取消注册函数
+     */
+    onRequest<TRequest = unknown, TResponse = unknown>(event: string, handler: (data: TRequest, metadata: EventMetadata) => Promise<TResponse> | TResponse): () => void;
+    /**
+     * 获取配置
+     */
+    getConfig(): PluginEventBusConfig;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<PluginEventBusConfig>): void;
+}
+/**
+ * 全局插件事件总线实例
+ */
+export declare const pluginEventBus: PluginEventBus;

package/dist/core-bak/plugin/PluginEventBus.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}export class PluginEventBus{on(event,listener){if(!this.listeners.has(event)){this.listeners.set(event,new Set)}const listeners=this.listeners.get(event);listeners.add(listener);return()=>{listeners.delete(listener);if(listeners.size===0){this.listeners.delete(event)}}}off(event,listener){const listeners=this.listeners.get(event);if(listeners){listeners.delete(listener);if(listeners.size===0){this.listeners.delete(event)}}}async emit(event,data,metadata){if(this.config.enableValidation&&!this.config.validator(event,data)){console.warn(`事件 ${event} 验证失败，已忽略`);return}const eventMetadata={source:metadata?.source,timestamp:metadata?.timestamp??Date.now(),eventId:metadata?.eventId??`event_${++this.eventCounter}`,priority:metadata?.priority??0};if(this.config.enableTracking){this.eventHistory.push({event,data,metadata:eventMetadata});if(this.eventHistory.length>this.config.maxHistorySize){this.eventHistory.shift()}}const listeners=this.listeners.get(event);if(!listeners||listeners.size===0){return}const eventWrapper={data:data,metadata:eventMetadata};const sortedListeners=Array.from(listeners);const promises=sortedListeners.map(listener=>{try{return Promise.resolve(listener(eventWrapper))}catch(error){console.error(`事件 ${event} 的监听器执行失败:`,error);return Promise.resolve()}});await Promise.allSettled(promises)}async emitData(event,data){return this.emit(event,data)}once(event,listener){const wrappedListener=async data=>{const actualData=data.data!==undefined?data.data:data;await listener(actualData);this.off(event,wrappedListener)};this.on(event,wrappedListener)}clear(){this.listeners.clear()}listenerCount(event){if(event){return this.listeners.get(event)?.size||0}let count=0;for(const listeners of this.listeners.values()){count+=listeners.size}return count}eventNames(){return Array.from(this.listeners.keys())}getEventHistory(event,limit){if(!this.config.enableTracking){return[]}let history=this.eventHistory;if(event){history=history.filter(h=>h.event===event)}if(limit){history=history.slice(-limit)}return[...history]}clearHistory(){this.eventHistory=[]}async request(event,data,timeout=5e3){return new Promise((resolve,reject)=>{const responseEvent=`${event}:response`;const requestId=`req_${Date.now()}_${Math.random()}`;const timeoutId=setTimeout(()=>{this.off(responseEvent,responseHandler);reject(new Error(`请求 ${event} 超时`))},timeout);const responseHandler=response=>{const actualResponse=response.data!==undefined?response.data:response;if(actualResponse.requestId===requestId){clearTimeout(timeoutId);this.off(responseEvent,responseHandler);resolve(actualResponse.data)}};this.on(responseEvent,responseHandler);this.emit(`${event}:request`,{requestId,data})})}onRequest(event,handler){const requestEvent=`${event}:request`;const responseEvent=`${event}:response`;return this.on(requestEvent,async wrapper=>{try{const actualWrapper=wrapper.data!==undefined?wrapper:{data:wrapper,metadata:{timestamp:Date.now()}};const response=await handler(actualWrapper.data.data,actualWrapper.metadata);this.emit(responseEvent,{requestId:actualWrapper.data.requestId,data:response})}catch(error){const actualWrapper=wrapper.data!==undefined?wrapper:{data:wrapper};this.emit(`${responseEvent}:error`,{requestId:actualWrapper.data.requestId,error:error instanceof Error?error.message:String(error)})}})}getConfig(){return{...this.config}}updateConfig(config){this.config={...this.config,...config}}constructor(config={}){_define_property(this,"listeners",new Map);_define_property(this,"eventHistory",[]);_define_property(this,"config",void 0);_define_property(this,"eventCounter",0);this.config={enableTracking:config.enableTracking??false,maxHistorySize:config.maxHistorySize??100,enableValidation:config.enableValidation??false,validator:config.validator??(()=>true)}}}export const pluginEventBus=new PluginEventBus({enableTracking:process.env.NODE_ENV==="development",maxHistorySize:100,enableValidation:false});

package/dist/core-bak/plugin/PluginSandbox.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 PluginPermission(){return PluginPermission},get PluginSandbox(){return PluginSandbox}});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}var PluginPermission=/*#__PURE__*/function(PluginPermission){PluginPermission["ACCESS_CONFIG"]="access_config";PluginPermission["ACCESS_STATE_MANAGER"]="access_state_manager";PluginPermission["ACCESS_STORAGE"]="access_storage";PluginPermission["EMIT_EVENTS"]="emit_events";PluginPermission["SUBSCRIBE_EVENTS"]="subscribe_events";return PluginPermission}({});let PluginSandbox=class PluginSandbox{hasPermission(permission){if(!this.config.strictMode){return true}return this.permissions.has(permission)}canAccessConfig(key){if(!this.hasPermission("access_config")){return false}if(this.config.configWhitelist&&this.config.configWhitelist.length>0){return this.config.configWhitelist.includes(key)}return true}canAccessStateScope(scope){if(!this.hasPermission("access_state_manager")){return false}if(this.config.stateScopeWhitelist&&this.config.stateScopeWhitelist.length>0){return this.config.stateScopeWhitelist.includes(scope)}return true}filterConfig(config){if(!this.hasPermission("access_config")){return{}}if(!this.config.configWhitelist||this.config.configWhitelist.length===0){return config}const filtered={};for(const key of this.config.configWhitelist){if(key in config){filtered[key]=config[key]}}return filtered}getConfig(){return{...this.config}}updatePermissions(permissions){this.permissions=new Set(permissions);this.config.permissions=permissions}constructor(config){_define_property(this,"config",void 0);_define_property(this,"permissions",void 0);this.config={strictMode:true,...config};this.permissions=new Set(config.permissions||[])}};

package/dist/core-bak/plugin/PluginSandbox.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 插件沙箱
+ * 用于插件隔离和权限控制
+ */
+import type { StartOptions } from '../types';
+/**
+ * 插件权限
+ */
+export declare enum PluginPermission {
+    /**
+     * 访问配置
+     */
+    ACCESS_CONFIG = "access_config",
+    /**
+     * 访问状态管理器
+     */
+    ACCESS_STATE_MANAGER = "access_state_manager",
+    /**
+     * 访问存储
+     */
+    ACCESS_STORAGE = "access_storage",
+    /**
+     * 发布事件
+     */
+    EMIT_EVENTS = "emit_events",
+    /**
+     * 订阅事件
+     */
+    SUBSCRIBE_EVENTS = "subscribe_events"
+}
+/**
+ * 插件沙箱配置
+ */
+export interface PluginSandboxConfig {
+    /**
+     * 插件名称
+     */
+    name: string;
+    /**
+     * 允许的权限列表
+     */
+    permissions?: PluginPermission[];
+    /**
+     * 允许访问的配置键（白名单）
+     */
+    configWhitelist?: string[];
+    /**
+     * 允许访问的状态作用域（白名单）
+     */
+    stateScopeWhitelist?: (string | symbol)[];
+    /**
+     * 是否启用严格模式（默认true）
+     */
+    strictMode?: boolean;
+}
+/**
+ * 插件沙箱
+ */
+export declare class PluginSandbox {
+    private config;
+    private permissions;
+    constructor(config: PluginSandboxConfig);
+    /**
+     * 检查权限
+     *
+     * @param permission - 权限
+     * @returns 是否有权限
+     */
+    hasPermission(permission: PluginPermission): boolean;
+    /**
+     * 检查是否可以访问配置键
+     *
+     * @param key - 配置键
+     * @returns 是否可以访问
+     */
+    canAccessConfig(key: string): boolean;
+    /**
+     * 检查是否可以访问状态作用域
+     *
+     * @param scope - 状态作用域
+     * @returns 是否可以访问
+     */
+    canAccessStateScope(scope: string | symbol): boolean;
+    /**
+     * 过滤配置（根据白名单）
+     *
+     * @param config - 完整配置
+     * @returns 过滤后的配置
+     */
+    filterConfig(config: StartOptions): Partial<StartOptions>;
+    /**
+     * 获取沙箱配置
+     */
+    getConfig(): PluginSandboxConfig;
+    /**
+     * 更新权限
+     *
+     * @param permissions - 权限列表
+     */
+    updatePermissions(permissions: PluginPermission[]): void;
+}

package/dist/core-bak/plugin/PluginSandbox.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}export var PluginPermission=/*#__PURE__*/function(PluginPermission){PluginPermission["ACCESS_CONFIG"]="access_config";PluginPermission["ACCESS_STATE_MANAGER"]="access_state_manager";PluginPermission["ACCESS_STORAGE"]="access_storage";PluginPermission["EMIT_EVENTS"]="emit_events";PluginPermission["SUBSCRIBE_EVENTS"]="subscribe_events";return PluginPermission}({});export class PluginSandbox{hasPermission(permission){if(!this.config.strictMode){return true}return this.permissions.has(permission)}canAccessConfig(key){if(!this.hasPermission("access_config")){return false}if(this.config.configWhitelist&&this.config.configWhitelist.length>0){return this.config.configWhitelist.includes(key)}return true}canAccessStateScope(scope){if(!this.hasPermission("access_state_manager")){return false}if(this.config.stateScopeWhitelist&&this.config.stateScopeWhitelist.length>0){return this.config.stateScopeWhitelist.includes(scope)}return true}filterConfig(config){if(!this.hasPermission("access_config")){return{}}if(!this.config.configWhitelist||this.config.configWhitelist.length===0){return config}const filtered={};for(const key of this.config.configWhitelist){if(key in config){filtered[key]=config[key]}}return filtered}getConfig(){return{...this.config}}updatePermissions(permissions){this.permissions=new Set(permissions);this.config.permissions=permissions}constructor(config){_define_property(this,"config",void 0);_define_property(this,"permissions",void 0);this.config={strictMode:true,...config};this.permissions=new Set(config.permissions||[])}}

package/dist/core-bak/plugin.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 PluginEventBus(){return _PluginEventBus.PluginEventBus},get PluginManager(){return PluginManager},get PluginPermission(){return _PluginSandbox.PluginPermission},get PluginSandbox(){return _PluginSandbox.PluginSandbox},get pluginEventBus(){return _PluginEventBus.pluginEventBus},get pluginManager(){return pluginManager}});const _PluginSandbox=require("./plugin/PluginSandbox");const _PluginEventBus=require("./plugin/PluginEventBus");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 PluginManager=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.PluginSandbox({...plugin.sandbox,name:plugin.name});this.sandboxes.set(plugin.name,sandbox)}else{const sandbox=new _PluginSandbox.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 Promise.resolve(options.modulePath).then(p=>/*#__PURE__*/_interop_require_wildcard(require(p)));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.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.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.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.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.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)}};const pluginManager=new PluginManager;

package/dist/core-bak/plugin.d.ts

@@ -0,0 +1,224 @@
+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-bak/plugin.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{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-bak/router/RouterManager.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 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-bak/router/RouterManager.d.ts

@@ -0,0 +1,87 @@
+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-bak/router/RouterManager.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{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()}