@vlian/framework 1.2.61 → 1.2.62

package/dist/core-bak/event/AppEventBus.d.ts

@@ -0,0 +1,178 @@
+/**
+ * 应用级事件总线
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */
+import type { EventListener, EventMetadata, EventMiddleware, EventListenerOptions, AppEventBusConfig, EventStats } from './types';
+/**
+ * 事件历史记录
+ */
+interface EventHistoryRecord {
+    event: string;
+    data: unknown;
+    metadata: EventMetadata;
+    executionTime?: number;
+}
+/**
+ * 应用事件总线
+ */
+export declare class AppEventBus {
+    /**
+     * 事件监听器映射表
+     * 使用 Map + Set 结构提高性能
+     */
+    private listeners;
+    /**
+     * 事件历史记录
+     */
+    private eventHistory;
+    /**
+     * 事件中间件列表
+     */
+    private middlewares;
+    /**
+     * 事件统计信息
+     */
+    private stats;
+    /**
+     * 配置
+     */
+    private config;
+    /**
+     * 事件计数器（用于生成唯一事件ID）
+     */
+    private eventCounter;
+    /**
+     * 监听器ID计数器
+     */
+    private listenerIdCounter;
+    constructor(config?: AppEventBusConfig);
+    /**
+     * 订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器
+     * @param options - 监听器选项
+     * @returns 取消订阅函数
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = eventBus.on('user:login', (data, metadata) => {
+     *   console.log('用户登录:', data);
+     * });
+     *
+     * // 取消订阅
+     * unsubscribe();
+     * ```
+     */
+    on<T = unknown>(event: string, listener: EventListener<T>, options?: EventListenerOptions): () => void;
+    /**
+     * 取消订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器（可选，不提供则取消该事件的所有监听器）
+     */
+    off<T = unknown>(event: string, listener?: EventListener<T>): void;
+    /**
+     * 一次性订阅事件
+     *
+     * @param event - 事件名称
+     * @param listener - 事件监听器
+     * @param options - 监听器选项
+     */
+    once<T = unknown>(event: string, listener: EventListener<T>, options?: Omit<EventListenerOptions, 'once'>): () => void;
+    /**
+     * 发布事件
+     *
+     * @param event - 事件名称
+     * @param data - 事件数据
+     * @param metadata - 事件元数据（可选）
+     *
+     * @example
+     * ```typescript
+     * await eventBus.emit('user:login', {
+     *   userId: '123',
+     *   username: 'john',
+     * });
+     * ```
+     */
+    emit<T = unknown>(event: string, data?: T, metadata?: Partial<EventMetadata>): Promise<void>;
+    /**
+     * 同步发布事件（不等待异步监听器完成）
+     *
+     * @param event - 事件名称
+     * @param data - 事件数据
+     * @param metadata - 事件元数据（可选）
+     */
+    emitSync<T = unknown>(event: string, data?: T, metadata?: Partial<EventMetadata>): void;
+    /**
+     * 注册事件中间件
+     *
+     * @param middleware - 中间件函数
+     * @returns 取消注册函数
+     *
+     * @example
+     * ```typescript
+     * const unsubscribe = eventBus.use((event, data, metadata, next) => {
+     *   console.log('事件触发:', event);
+     *   return next();
+     * });
+     * ```
+     */
+    use(middleware: EventMiddleware): () => void;
+    /**
+     * 清空所有事件监听器
+     */
+    clear(): void;
+    /**
+     * 清空事件历史记录
+     */
+    clearHistory(): void;
+    /**
+     * 获取事件监听器数量
+     *
+     * @param event - 事件名称（可选，不提供则返回所有事件的监听器总数）
+     */
+    listenerCount(event?: string): number;
+    /**
+     * 获取所有事件名称
+     */
+    eventNames(): string[];
+    /**
+     * 获取事件历史记录
+     *
+     * @param event - 事件名称（可选，如果提供则只返回该事件的历史）
+     * @param limit - 限制返回的记录数
+     */
+    getEventHistory(event?: string, limit?: number): EventHistoryRecord[];
+    /**
+     * 获取事件统计信息
+     *
+     * @param event - 事件名称（可选，不提供则返回所有事件的统计）
+     */
+    getStats(event?: string): EventStats | Map<string, EventStats>;
+    /**
+     * 获取配置
+     */
+    getConfig(): AppEventBusConfig;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<AppEventBusConfig>): void;
+    /**
+     * 销毁事件总线（清理所有资源）
+     */
+    destroy(): void;
+    /**
+     * 获取完整事件名称（包含命名空间前缀）
+     */
+    private getFullEventName;
+    /**
+     * 记录事件历史
+     */
+    private recordEventHistory;
+    /**
+     * 更新统计信息
+     */
+    private updateStats;
+}
+export {};

package/dist/core-bak/event/AppEventBus.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 AppEventBus{on(event,listener,options={}){const fullEventName=this.getFullEventName(event);const listenerId=Symbol(`listener_${++this.listenerIdCounter}`);const listenerWithOptions={listener:listener,options:{priority:options.priority??100,once:options.once??false,namespace:options.namespace??this.config.namespacePrefix,async:options.async??true},id:listenerId};if(!this.listeners.has(fullEventName)){this.listeners.set(fullEventName,new Set)}const listeners=this.listeners.get(fullEventName);listeners.add(listenerWithOptions);const sortedListeners=Array.from(listeners).sort((a,b)=>a.options.priority-b.options.priority);this.listeners.set(fullEventName,new Set(sortedListeners));return()=>{const currentListeners=this.listeners.get(fullEventName);if(currentListeners){currentListeners.delete(listenerWithOptions);if(currentListeners.size===0){this.listeners.delete(fullEventName)}}}}off(event,listener){const fullEventName=this.getFullEventName(event);const listeners=this.listeners.get(fullEventName);if(!listeners){return}if(listener){for(const item of listeners){if(item.listener===listener){listeners.delete(item);break}}}else{listeners.clear()}if(listeners.size===0){this.listeners.delete(fullEventName)}}once(event,listener,options){return this.on(event,listener,{...options,once:true})}async emit(event,data,metadata){const fullEventName=this.getFullEventName(event);const startTime=this.config.enablePerformanceMonitoring?performance.now():0;if(this.config.enableValidation&&!this.config.validator(fullEventName,data)){logger.warn(`事件 ${fullEventName} 验证失败，已忽略`);return}if(this.config.enableSecurityMode&&metadata?.source){if(!this.config.allowedSources.includes(metadata.source)){logger.warn(`事件 ${fullEventName} 的来源 ${metadata.source} 不在白名单中，已忽略`);return}}const eventMetadata={source:metadata?.source,timestamp:metadata?.timestamp??Date.now(),eventId:metadata?.eventId??`event_${++this.eventCounter}`,priority:metadata?.priority??0,instanceId:metadata?.instanceId??this.config.instanceId,namespace:metadata?.namespace??this.config.namespacePrefix,...metadata};const eventWrapper={data:data,metadata:eventMetadata};if(this.middlewares.length>0){let middlewareIndex=0;let nextCalled=false;const executeMiddleware=async()=>{if(middlewareIndex<this.middlewares.length){nextCalled=false;const currentIndex=middlewareIndex;const middleware=this.middlewares[middlewareIndex++];const next=async()=>{nextCalled=true;if(currentIndex<this.middlewares.length-1){await executeMiddleware()}};await Promise.resolve(middleware(fullEventName,data,eventMetadata,next));if(!nextCalled){return}}};await executeMiddleware();if(!nextCalled&&this.middlewares.length>0){return}}const listeners=this.listeners.get(fullEventName);if(this.config.enableTracking){const executionTime=this.config.enablePerformanceMonitoring?performance.now()-startTime:undefined;this.recordEventHistory(fullEventName,data,eventMetadata,executionTime)}if(!listeners||listeners.size===0){this.updateStats(fullEventName,0);return}const executionPromises=[];const listenersToRemove=[];for(const listenerWithOptions of listeners){const executeListener=async()=>{try{if(listenerWithOptions.options.async){await Promise.resolve(listenerWithOptions.listener(eventWrapper.data,eventWrapper.metadata))}else{listenerWithOptions.listener(eventWrapper.data,eventWrapper.metadata)}if(listenerWithOptions.options.once){listenersToRemove.push(listenerWithOptions)}}catch(error){logger.error(`事件 ${fullEventName} 的监听器执行失败:`,error)}};executionPromises.push(executeListener())}await Promise.allSettled(executionPromises);for(const listenerToRemove of listenersToRemove){listeners.delete(listenerToRemove)}if(listeners.size===0){this.listeners.delete(fullEventName)}const executionTime=this.config.enablePerformanceMonitoring?performance.now()-startTime:0;this.updateStats(fullEventName,executionTime,listeners.size)}emitSync(event,data,metadata){this.emit(event,data,metadata).catch(error=>{logger.error(`同步发布事件 ${event} 失败:`,error)})}use(middleware){this.middlewares.push(middleware);return()=>{const index=this.middlewares.indexOf(middleware);if(index>-1){this.middlewares.splice(index,1)}}}clear(){this.listeners.clear()}clearHistory(){this.eventHistory=[]}listenerCount(event){if(event){const fullEventName=this.getFullEventName(event);return this.listeners.get(fullEventName)?.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){const fullEventName=this.getFullEventName(event);history=history.filter(h=>h.event===fullEventName)}if(limit){history=history.slice(-limit)}return[...history]}getStats(event){if(event){const fullEventName=this.getFullEventName(event);return this.stats.get(fullEventName)||{event:fullEventName,count:0,avgExecutionTime:0,listenerCount:0,lastTriggered:0}}return new Map(this.stats)}getConfig(){return{...this.config}}updateConfig(config){this.config={...this.config,...config}}destroy(){this.clear();this.clearHistory();this.middlewares=[];this.stats.clear()}getFullEventName(event){if(this.config.namespacePrefix){return`${this.config.namespacePrefix}${event}`}return event}recordEventHistory(event,data,metadata,executionTime){this.eventHistory.push({event,data,metadata,executionTime});if(this.eventHistory.length>this.config.maxHistorySize){this.eventHistory.shift()}}updateStats(event,executionTime,listenerCount=0){if(!this.config.enablePerformanceMonitoring){return}const existingStats=this.stats.get(event);if(existingStats){const totalTime=existingStats.avgExecutionTime*existingStats.count+executionTime;const newCount=existingStats.count+1;this.stats.set(event,{...existingStats,count:newCount,avgExecutionTime:totalTime/newCount,listenerCount,lastTriggered:Date.now()})}else{this.stats.set(event,{event,count:1,avgExecutionTime:executionTime,listenerCount,lastTriggered:Date.now()})}}constructor(config={}){_define_property(this,"listeners",new Map);_define_property(this,"eventHistory",[]);_define_property(this,"middlewares",[]);_define_property(this,"stats",new Map);_define_property(this,"config",void 0);_define_property(this,"eventCounter",0);_define_property(this,"listenerIdCounter",0);this.config={enableTracking:config.enableTracking??process.env.NODE_ENV==="development",maxHistorySize:config.maxHistorySize??100,enableValidation:config.enableValidation??false,validator:config.validator??(()=>true),enablePerformanceMonitoring:config.enablePerformanceMonitoring??process.env.NODE_ENV==="development",namespacePrefix:config.namespacePrefix??"",instanceId:config.instanceId,enableSecurityMode:config.enableSecurityMode??false,allowedSources:config.allowedSources??[]}}}

package/dist/core-bak/event/frameworkEvents.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"FrameworkEventManager",{enumerable:true,get:function(){return FrameworkEventManager}});const _types=require("./types");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 FrameworkEventManager=class FrameworkEventManager{emitAppStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_START,{instanceId})}emitAppStarted(instanceId,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_STARTED,{instanceId,duration})}emitAppInitStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_START,{instanceId})}emitAppInitComplete(instanceId,context,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_COMPLETE,{instanceId,context,duration})}emitAppInitError(instanceId,error){this.eventBus.emitSync(_types.FrameworkEventType.APP_INIT_ERROR,{instanceId,error})}emitAppRenderStart(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_START,{instanceId})}emitAppRenderComplete(instanceId,duration){this.eventBus.emitSync(_types.FrameworkEventType.APP_RENDER_COMPLETE,{instanceId,duration})}emitRouteChange(from,to,params){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_CHANGE,{from,to,params})}emitRouteNavigateStart(to,options){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_START,{to,options})}emitRouteNavigateComplete(to,duration){this.eventBus.emitSync(_types.FrameworkEventType.ROUTE_NAVIGATE_COMPLETE,{to,duration})}emitErrorOccurred(error,context){this.eventBus.emitSync(_types.FrameworkEventType.ERROR_OCCURRED,{error,context})}emitInstanceCreated(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_CREATED,{instanceId})}emitInstanceDestroyed(instanceId){this.eventBus.emitSync(_types.FrameworkEventType.INSTANCE_DESTROYED,{instanceId})}emitPerformanceUpdate(metrics){this.eventBus.emitSync(_types.FrameworkEventType.PERFORMANCE_UPDATE,{metrics})}constructor(eventBus){_define_property(this,"eventBus",void 0);this.eventBus=eventBus}};

package/dist/core-bak/event/frameworkEvents.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 框架生命周期事件集成
+ * 自动在框架关键节点触发事件
+ */
+import type { AppEventBus } from './AppEventBus';
+import type { InitializationContext } from '../initialization';
+/**
+ * 框架事件管理器
+ */
+export declare class FrameworkEventManager {
+    private eventBus;
+    constructor(eventBus: AppEventBus);
+    /**
+     * 触发应用启动事件
+     */
+    emitAppStart(instanceId?: string): void;
+    /**
+     * 触发应用启动完成事件
+     */
+    emitAppStarted(instanceId: string, duration: number): void;
+    /**
+     * 触发应用初始化开始事件
+     */
+    emitAppInitStart(instanceId?: string): void;
+    /**
+     * 触发应用初始化完成事件
+     */
+    emitAppInitComplete(instanceId: string, context: InitializationContext, duration: number): void;
+    /**
+     * 触发应用初始化错误事件
+     */
+    emitAppInitError(instanceId: string, error: Error): void;
+    /**
+     * 触发应用渲染开始事件
+     */
+    emitAppRenderStart(instanceId?: string): void;
+    /**
+     * 触发应用渲染完成事件
+     */
+    emitAppRenderComplete(instanceId: string, duration: number): void;
+    /**
+     * 触发路由变化事件
+     */
+    emitRouteChange(from: string, to: string, params?: Record<string, unknown>): void;
+    /**
+     * 触发路由导航开始事件
+     */
+    emitRouteNavigateStart(to: string, options?: unknown): void;
+    /**
+     * 触发路由导航完成事件
+     */
+    emitRouteNavigateComplete(to: string, duration: number): void;
+    /**
+     * 触发错误发生事件
+     */
+    emitErrorOccurred(error: Error, context?: unknown): void;
+    /**
+     * 触发实例创建事件
+     */
+    emitInstanceCreated(instanceId: string): void;
+    /**
+     * 触发实例销毁事件
+     */
+    emitInstanceDestroyed(instanceId: string): void;
+    /**
+     * 触发性能指标更新事件
+     */
+    emitPerformanceUpdate(metrics: Record<string, number>): void;
+}

package/dist/core-bak/event/frameworkEvents.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{FrameworkEventType}from"./types";export class FrameworkEventManager{emitAppStart(instanceId){this.eventBus.emitSync(FrameworkEventType.APP_START,{instanceId})}emitAppStarted(instanceId,duration){this.eventBus.emitSync(FrameworkEventType.APP_STARTED,{instanceId,duration})}emitAppInitStart(instanceId){this.eventBus.emitSync(FrameworkEventType.APP_INIT_START,{instanceId})}emitAppInitComplete(instanceId,context,duration){this.eventBus.emitSync(FrameworkEventType.APP_INIT_COMPLETE,{instanceId,context,duration})}emitAppInitError(instanceId,error){this.eventBus.emitSync(FrameworkEventType.APP_INIT_ERROR,{instanceId,error})}emitAppRenderStart(instanceId){this.eventBus.emitSync(FrameworkEventType.APP_RENDER_START,{instanceId})}emitAppRenderComplete(instanceId,duration){this.eventBus.emitSync(FrameworkEventType.APP_RENDER_COMPLETE,{instanceId,duration})}emitRouteChange(from,to,params){this.eventBus.emitSync(FrameworkEventType.ROUTE_CHANGE,{from,to,params})}emitRouteNavigateStart(to,options){this.eventBus.emitSync(FrameworkEventType.ROUTE_NAVIGATE_START,{to,options})}emitRouteNavigateComplete(to,duration){this.eventBus.emitSync(FrameworkEventType.ROUTE_NAVIGATE_COMPLETE,{to,duration})}emitErrorOccurred(error,context){this.eventBus.emitSync(FrameworkEventType.ERROR_OCCURRED,{error,context})}emitInstanceCreated(instanceId){this.eventBus.emitSync(FrameworkEventType.INSTANCE_CREATED,{instanceId})}emitInstanceDestroyed(instanceId){this.eventBus.emitSync(FrameworkEventType.INSTANCE_DESTROYED,{instanceId})}emitPerformanceUpdate(metrics){this.eventBus.emitSync(FrameworkEventType.PERFORMANCE_UPDATE,{metrics})}constructor(eventBus){_define_property(this,"eventBus",void 0);this.eventBus=eventBus}}

package/dist/core-bak/event/hooks.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 useAppEvent(){return useAppEvent},get useAppEventEmitter(){return useAppEventEmitter},get useAppEventOnce(){return useAppEventOnce}});const _react=require("react");function useAppEvent(eventBus,event,listener,options){const listenerRef=(0,_react.useRef)(listener);listenerRef.current=listener;const optionsRef=(0,_react.useRef)(options);optionsRef.current=options;(0,_react.useEffect)(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.on(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}function useAppEventOnce(eventBus,event,listener,options){const listenerRef=(0,_react.useRef)(listener);listenerRef.current=listener;const optionsRef=(0,_react.useRef)(options);optionsRef.current=options;(0,_react.useEffect)(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.once(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}function useAppEventEmitter(eventBus){return(0,_react.useCallback)((event,data,metadata)=>{return eventBus.emit(event,data,metadata)},[eventBus])}

package/dist/core-bak/event/hooks.d.ts

@@ -0,0 +1,57 @@
+/**
+ * React Hooks 支持
+ * 提供便捷的 React 组件事件订阅能力
+ */
+import type { EventListener, EventListenerOptions } from './types';
+import type { AppEventBus } from './AppEventBus';
+/**
+ * 使用事件总线的 Hook
+ *
+ * @param eventBus - 事件总线实例
+ * @param event - 事件名称
+ * @param listener - 事件监听器
+ * @param options - 监听器选项
+ *
+ * @example
+ * ```tsx
+ * import { useAppEventBus } from '@vlian/framework';
+ *
+ * function MyComponent() {
+ *   useAppEvent('user:login', (data, metadata) => {
+ *     console.log('用户登录:', data);
+ *   });
+ *
+ *   return <div>My Component</div>;
+ * }
+ * ```
+ */
+export declare function useAppEvent<T = unknown>(eventBus: AppEventBus, event: string, listener: EventListener<T>, options?: EventListenerOptions): void;
+/**
+ * 一次性事件订阅 Hook
+ *
+ * @param eventBus - 事件总线实例
+ * @param event - 事件名称
+ * @param listener - 事件监听器
+ * @param options - 监听器选项
+ */
+export declare function useAppEventOnce<T = unknown>(eventBus: AppEventBus, event: string, listener: EventListener<T>, options?: Omit<EventListenerOptions, 'once'>): void;
+/**
+ * 创建事件发射器 Hook
+ *
+ * @param eventBus - 事件总线实例
+ * @returns 事件发射函数
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const emit = useAppEventEmitter(eventBus);
+ *
+ *   const handleClick = () => {
+ *     emit('button:click', { buttonId: 'submit' });
+ *   };
+ *
+ *   return <button onClick={handleClick}>Click</button>;
+ * }
+ * ```
+ */
+export declare function useAppEventEmitter(eventBus: AppEventBus): <T = unknown>(event: string, data?: T, metadata?: Partial<import("./types").EventMetadata>) => Promise<void>;

package/dist/core-bak/event/hooks.js

@@ -0,0 +1 @@
+import{useEffect,useRef,useCallback}from"react";export function useAppEvent(eventBus,event,listener,options){const listenerRef=useRef(listener);listenerRef.current=listener;const optionsRef=useRef(options);optionsRef.current=options;useEffect(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.on(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}export function useAppEventOnce(eventBus,event,listener,options){const listenerRef=useRef(listener);listenerRef.current=listener;const optionsRef=useRef(options);optionsRef.current=options;useEffect(()=>{const wrappedListener=(data,metadata)=>{return listenerRef.current(data,metadata)};const unsubscribe=eventBus.once(event,wrappedListener,optionsRef.current);return unsubscribe},[eventBus,event])}export function useAppEventEmitter(eventBus){return useCallback((event,data,metadata)=>{return eventBus.emit(event,data,metadata)},[eventBus])}

package/dist/core-bak/event/index.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 AppEventBus(){return _AppEventBus.AppEventBus},get FrameworkEventManager(){return _frameworkEvents.FrameworkEventManager},get FrameworkEventType(){return _types.FrameworkEventType},get useAppEvent(){return _hooks.useAppEvent},get useAppEventEmitter(){return _hooks.useAppEventEmitter},get useAppEventOnce(){return _hooks.useAppEventOnce},get useEventBus(){return _useEventBus.useEventBus}});const _AppEventBus=require("./AppEventBus");const _frameworkEvents=require("./frameworkEvents");const _hooks=require("./hooks");const _useEventBus=require("./useEventBus");const _types=require("./types");

package/dist/core-bak/event/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 应用级事件系统
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */
+export { AppEventBus } from './AppEventBus';
+export { FrameworkEventManager } from './frameworkEvents';
+export { useAppEvent, useAppEventOnce, useAppEventEmitter, } from './hooks';
+export { useEventBus } from './useEventBus';
+export type { EventListener, EventMetadata, EventWrapper, EventMiddleware, EventListenerOptions, AppEventBusConfig, EventStats, FrameworkEventData, } from './types';
+export { FrameworkEventType } from './types';

package/dist/core-bak/event/index.js

@@ -0,0 +1 @@
+export{AppEventBus}from"./AppEventBus";export{FrameworkEventManager}from"./frameworkEvents";export{useAppEvent,useAppEventOnce,useAppEventEmitter}from"./hooks";export{useEventBus}from"./useEventBus";export{FrameworkEventType}from"./types";

package/dist/core-bak/event/types.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"FrameworkEventType",{enumerable:true,get:function(){return FrameworkEventType}});var FrameworkEventType=/*#__PURE__*/function(FrameworkEventType){FrameworkEventType["APP_START"]="framework:app:start";FrameworkEventType["APP_STARTED"]="framework:app:started";FrameworkEventType["APP_INIT_START"]="framework:app:init:start";FrameworkEventType["APP_INIT_COMPLETE"]="framework:app:init:complete";FrameworkEventType["APP_INIT_ERROR"]="framework:app:init:error";FrameworkEventType["APP_RENDER_START"]="framework:app:render:start";FrameworkEventType["APP_RENDER_COMPLETE"]="framework:app:render:complete";FrameworkEventType["ROUTE_CHANGE"]="framework:route:change";FrameworkEventType["ROUTE_NAVIGATE_START"]="framework:route:navigate:start";FrameworkEventType["ROUTE_NAVIGATE_COMPLETE"]="framework:route:navigate:complete";FrameworkEventType["ERROR_OCCURRED"]="framework:error:occurred";FrameworkEventType["INSTANCE_CREATED"]="framework:instance:created";FrameworkEventType["INSTANCE_DESTROYED"]="framework:instance:destroyed";FrameworkEventType["PERFORMANCE_UPDATE"]="framework:performance:update";return FrameworkEventType}({});

package/dist/core-bak/event/types.d.ts

@@ -0,0 +1,269 @@
+/**
+ * 应用级事件系统类型定义
+ * 提供类型安全的事件通信能力
+ */
+/**
+ * 事件监听器类型
+ *
+ * @template T - 事件数据类型
+ */
+export type EventListener<T = unknown> = (data: T, metadata: EventMetadata) => void | Promise<void>;
+/**
+ * 事件元数据
+ */
+export interface EventMetadata {
+    /**
+     * 事件来源（模块/组件名称）
+     */
+    source?: string;
+    /**
+     * 事件时间戳
+     */
+    timestamp: number;
+    /**
+     * 事件ID（用于追踪）
+     */
+    eventId: string;
+    /**
+     * 事件优先级（数字越小优先级越高）
+     */
+    priority?: number;
+    /**
+     * 应用实例ID（多实例场景）
+     */
+    instanceId?: string;
+    /**
+     * 事件命名空间（用于作用域隔离）
+     */
+    namespace?: string;
+    /**
+     * 自定义元数据
+     */
+    [key: string]: unknown;
+}
+/**
+ * 事件包装器
+ *
+ * @template T - 事件数据类型
+ */
+export interface EventWrapper<T = unknown> {
+    /**
+     * 事件数据
+     */
+    data: T;
+    /**
+     * 事件元数据
+     */
+    metadata: EventMetadata;
+}
+/**
+ * 事件中间件函数类型
+ *
+ * @template T - 事件数据类型
+ */
+export type EventMiddleware<T = unknown> = (event: string, data: T, metadata: EventMetadata, next: () => Promise<void>) => Promise<void> | void;
+/**
+ * 事件监听器选项
+ */
+export interface EventListenerOptions {
+    /**
+     * 监听器优先级（数字越小优先级越高）
+     */
+    priority?: number;
+    /**
+     * 是否只执行一次
+     */
+    once?: boolean;
+    /**
+     * 事件命名空间（用于作用域隔离）
+     */
+    namespace?: string;
+    /**
+     * 是否异步执行
+     */
+    async?: boolean;
+}
+/**
+ * 事件总线配置
+ */
+export interface AppEventBusConfig {
+    /**
+     * 是否启用事件追踪
+     */
+    enableTracking?: boolean;
+    /**
+     * 最大事件历史记录数
+     */
+    maxHistorySize?: number;
+    /**
+     * 是否启用事件验证
+     */
+    enableValidation?: boolean;
+    /**
+     * 事件验证函数
+     */
+    validator?: (event: string, data: unknown) => boolean;
+    /**
+     * 是否启用性能监控
+     */
+    enablePerformanceMonitoring?: boolean;
+    /**
+     * 事件命名空间前缀（用于多实例隔离）
+     */
+    namespacePrefix?: string;
+    /**
+     * 应用实例ID（多实例场景）
+     */
+    instanceId?: string;
+    /**
+     * 是否启用安全模式（限制事件来源）
+     */
+    enableSecurityMode?: boolean;
+    /**
+     * 允许的事件来源白名单（安全模式）
+     */
+    allowedSources?: string[];
+}
+/**
+ * 事件统计信息
+ */
+export interface EventStats {
+    /**
+     * 事件名称
+     */
+    event: string;
+    /**
+     * 触发次数
+     */
+    count: number;
+    /**
+     * 平均执行时间（毫秒）
+     */
+    avgExecutionTime: number;
+    /**
+     * 监听器数量
+     */
+    listenerCount: number;
+    /**
+     * 最后触发时间
+     */
+    lastTriggered: number;
+}
+/**
+ * 框架内置事件类型
+ */
+export declare enum FrameworkEventType {
+    /**
+     * 应用启动开始
+     */
+    APP_START = "framework:app:start",
+    /**
+     * 应用启动完成
+     */
+    APP_STARTED = "framework:app:started",
+    /**
+     * 应用初始化开始
+     */
+    APP_INIT_START = "framework:app:init:start",
+    /**
+     * 应用初始化完成
+     */
+    APP_INIT_COMPLETE = "framework:app:init:complete",
+    /**
+     * 应用初始化失败
+     */
+    APP_INIT_ERROR = "framework:app:init:error",
+    /**
+     * 应用渲染开始
+     */
+    APP_RENDER_START = "framework:app:render:start",
+    /**
+     * 应用渲染完成
+     */
+    APP_RENDER_COMPLETE = "framework:app:render:complete",
+    /**
+     * 路由变化
+     */
+    ROUTE_CHANGE = "framework:route:change",
+    /**
+     * 路由导航开始
+     */
+    ROUTE_NAVIGATE_START = "framework:route:navigate:start",
+    /**
+     * 路由导航完成
+     */
+    ROUTE_NAVIGATE_COMPLETE = "framework:route:navigate:complete",
+    /**
+     * 错误发生
+     */
+    ERROR_OCCURRED = "framework:error:occurred",
+    /**
+     * 实例创建
+     */
+    INSTANCE_CREATED = "framework:instance:created",
+    /**
+     * 实例销毁
+     */
+    INSTANCE_DESTROYED = "framework:instance:destroyed",
+    /**
+     * 性能指标更新
+     */
+    PERFORMANCE_UPDATE = "framework:performance:update"
+}
+/**
+ * 框架事件数据类型定义
+ */
+export interface FrameworkEventData {
+    [FrameworkEventType.APP_START]: {
+        instanceId?: string;
+    };
+    [FrameworkEventType.APP_STARTED]: {
+        instanceId?: string;
+        duration: number;
+    };
+    [FrameworkEventType.APP_INIT_START]: {
+        instanceId?: string;
+    };
+    [FrameworkEventType.APP_INIT_COMPLETE]: {
+        instanceId?: string;
+        context: unknown;
+        duration: number;
+    };
+    [FrameworkEventType.APP_INIT_ERROR]: {
+        instanceId?: string;
+        error: Error;
+    };
+    [FrameworkEventType.APP_RENDER_START]: {
+        instanceId?: string;
+    };
+    [FrameworkEventType.APP_RENDER_COMPLETE]: {
+        instanceId?: string;
+        duration: number;
+    };
+    [FrameworkEventType.ROUTE_CHANGE]: {
+        from: string;
+        to: string;
+        params?: Record<string, unknown>;
+    };
+    [FrameworkEventType.ROUTE_NAVIGATE_START]: {
+        to: string;
+        options?: unknown;
+    };
+    [FrameworkEventType.ROUTE_NAVIGATE_COMPLETE]: {
+        to: string;
+        duration: number;
+    };
+    [FrameworkEventType.ERROR_OCCURRED]: {
+        error: Error;
+        context?: unknown;
+    };
+    [FrameworkEventType.INSTANCE_CREATED]: {
+        instanceId: string;
+    };
+    [FrameworkEventType.INSTANCE_DESTROYED]: {
+        instanceId: string;
+    };
+    [FrameworkEventType.PERFORMANCE_UPDATE]: {
+        metrics: Record<string, number>;
+    };
+}

package/dist/core-bak/event/types.js

@@ -0,0 +1 @@
+export var FrameworkEventType=/*#__PURE__*/function(FrameworkEventType){FrameworkEventType["APP_START"]="framework:app:start";FrameworkEventType["APP_STARTED"]="framework:app:started";FrameworkEventType["APP_INIT_START"]="framework:app:init:start";FrameworkEventType["APP_INIT_COMPLETE"]="framework:app:init:complete";FrameworkEventType["APP_INIT_ERROR"]="framework:app:init:error";FrameworkEventType["APP_RENDER_START"]="framework:app:render:start";FrameworkEventType["APP_RENDER_COMPLETE"]="framework:app:render:complete";FrameworkEventType["ROUTE_CHANGE"]="framework:route:change";FrameworkEventType["ROUTE_NAVIGATE_START"]="framework:route:navigate:start";FrameworkEventType["ROUTE_NAVIGATE_COMPLETE"]="framework:route:navigate:complete";FrameworkEventType["ERROR_OCCURRED"]="framework:error:occurred";FrameworkEventType["INSTANCE_CREATED"]="framework:instance:created";FrameworkEventType["INSTANCE_DESTROYED"]="framework:instance:destroyed";FrameworkEventType["PERFORMANCE_UPDATE"]="framework:performance:update";return FrameworkEventType}({});

package/dist/core-bak/event/useEventBus.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"useEventBus",{enumerable:true,get:function(){return useEventBus}});const _AppInstance=require("../startup/AppInstance");function useEventBus(){const instanceManager=(0,_AppInstance.getAppInstanceManager)();const instance=instanceManager.getInstance();if(!instance){throw new Error("应用实例未找到")}const eventBus=instance.getEventBus();if(!eventBus){throw new Error("事件总线未初始化")}return eventBus}

package/dist/core-bak/event/useEventBus.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 便捷的 Hook：获取当前应用实例的事件总线
+ */
+import type { AppEventBus } from './AppEventBus';
+/**
+ * 获取当前应用实例的事件总线
+ *
+ * @returns 事件总线实例
+ *
+ * @example
+ * ```tsx
+ * import { useEventBus } from '@vlian/framework';
+ *
+ * function MyComponent() {
+ *   const eventBus = useEventBus();
+ *
+ *   useEffect(() => {
+ *     const unsubscribe = eventBus.on('user:login', (data) => {
+ *       console.log('用户登录:', data);
+ *     });
+ *     return unsubscribe;
+ *   }, [eventBus]);
+ *
+ *   return <div>My Component</div>;
+ * }
+ * ```
+ */
+export declare function useEventBus(): AppEventBus;

package/dist/core-bak/event/useEventBus.js

@@ -0,0 +1 @@
+import{getAppInstanceManager}from"../startup/AppInstance";export function useEventBus(){const instanceManager=getAppInstanceManager();const instance=instanceManager.getInstance();if(!instance){throw new Error("应用实例未找到")}const eventBus=instance.getEventBus();if(!eventBus){throw new Error("事件总线未初始化")}return eventBus}