@vlian/framework 1.0.1 → 1.0.4

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

@@ -0,0 +1,70 @@
+/**
+ * 框架生命周期事件集成
+ * 自动在框架关键节点触发事件
+ */
+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;
+}
+//# sourceMappingURL=frameworkEvents.d.ts.map

package/dist/core/event/frameworkEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkEvents.d.ts","sourceRoot":"","sources":["../../../src/core/event/frameworkEvents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAc;gBAElB,QAAQ,EAAE,WAAW;IAIjC;;OAEG;IACH,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvC;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO1D;;OAEG;IACH,gBAAgB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,MAAM,GACf,IAAI;IAQP;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAOxD;;OAEG;IACH,kBAAkB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOjE;;OAEG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI;IAQP;;OAEG;IACH,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAO3D;;OAEG;IACH,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO7D;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAOxD;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI7C;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAM/C;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAG7D"}

package/dist/core/event/frameworkEvents.js

@@ -0,0 +1,135 @@
+/**
+ * 框架生命周期事件集成
+ * 自动在框架关键节点触发事件
+ */ 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;
+    }
+}
+
+//# sourceMappingURL=frameworkEvents.js.map

package/dist/core/event/frameworkEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/event/frameworkEvents.ts"],"sourcesContent":["/**\n * 框架生命周期事件集成\n * 自动在框架关键节点触发事件\n */\n\nimport type { AppEventBus } from './AppEventBus';\nimport { FrameworkEventType } from './types';\nimport type { InitializationContext } from '../initialization';\n\n/**\n * 框架事件管理器\n */\nexport class FrameworkEventManager {\n  private eventBus: AppEventBus;\n\n  constructor(eventBus: AppEventBus) {\n    this.eventBus = eventBus;\n  }\n\n  /**\n   * 触发应用启动事件\n   */\n  emitAppStart(instanceId?: string): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_START, { instanceId });\n  }\n\n  /**\n   * 触发应用启动完成事件\n   */\n  emitAppStarted(instanceId: string, duration: number): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_STARTED, {\n      instanceId,\n      duration,\n    });\n  }\n\n  /**\n   * 触发应用初始化开始事件\n   */\n  emitAppInitStart(instanceId?: string): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_INIT_START, { instanceId });\n  }\n\n  /**\n   * 触发应用初始化完成事件\n   */\n  emitAppInitComplete(\n    instanceId: string,\n    context: InitializationContext,\n    duration: number\n  ): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_INIT_COMPLETE, {\n      instanceId,\n      context,\n      duration,\n    });\n  }\n\n  /**\n   * 触发应用初始化错误事件\n   */\n  emitAppInitError(instanceId: string, error: Error): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_INIT_ERROR, {\n      instanceId,\n      error,\n    });\n  }\n\n  /**\n   * 触发应用渲染开始事件\n   */\n  emitAppRenderStart(instanceId?: string): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_RENDER_START, { instanceId });\n  }\n\n  /**\n   * 触发应用渲染完成事件\n   */\n  emitAppRenderComplete(instanceId: string, duration: number): void {\n    this.eventBus.emitSync(FrameworkEventType.APP_RENDER_COMPLETE, {\n      instanceId,\n      duration,\n    });\n  }\n\n  /**\n   * 触发路由变化事件\n   */\n  emitRouteChange(\n    from: string,\n    to: string,\n    params?: Record<string, unknown>\n  ): void {\n    this.eventBus.emitSync(FrameworkEventType.ROUTE_CHANGE, {\n      from,\n      to,\n      params,\n    });\n  }\n\n  /**\n   * 触发路由导航开始事件\n   */\n  emitRouteNavigateStart(to: string, options?: unknown): void {\n    this.eventBus.emitSync(FrameworkEventType.ROUTE_NAVIGATE_START, {\n      to,\n      options,\n    });\n  }\n\n  /**\n   * 触发路由导航完成事件\n   */\n  emitRouteNavigateComplete(to: string, duration: number): void {\n    this.eventBus.emitSync(FrameworkEventType.ROUTE_NAVIGATE_COMPLETE, {\n      to,\n      duration,\n    });\n  }\n\n  /**\n   * 触发错误发生事件\n   */\n  emitErrorOccurred(error: Error, context?: unknown): void {\n    this.eventBus.emitSync(FrameworkEventType.ERROR_OCCURRED, {\n      error,\n      context,\n    });\n  }\n\n  /**\n   * 触发实例创建事件\n   */\n  emitInstanceCreated(instanceId: string): void {\n    this.eventBus.emitSync(FrameworkEventType.INSTANCE_CREATED, { instanceId });\n  }\n\n  /**\n   * 触发实例销毁事件\n   */\n  emitInstanceDestroyed(instanceId: string): void {\n    this.eventBus.emitSync(FrameworkEventType.INSTANCE_DESTROYED, {\n      instanceId,\n    });\n  }\n\n  /**\n   * 触发性能指标更新事件\n   */\n  emitPerformanceUpdate(metrics: Record<string, number>): void {\n    this.eventBus.emitSync(FrameworkEventType.PERFORMANCE_UPDATE, { metrics });\n  }\n}\n"],"names":["FrameworkEventType","FrameworkEventManager","emitAppStart","instanceId","eventBus","emitSync","APP_START","emitAppStarted","duration","APP_STARTED","emitAppInitStart","APP_INIT_START","emitAppInitComplete","context","APP_INIT_COMPLETE","emitAppInitError","error","APP_INIT_ERROR","emitAppRenderStart","APP_RENDER_START","emitAppRenderComplete","APP_RENDER_COMPLETE","emitRouteChange","from","to","params","ROUTE_CHANGE","emitRouteNavigateStart","options","ROUTE_NAVIGATE_START","emitRouteNavigateComplete","ROUTE_NAVIGATE_COMPLETE","emitErrorOccurred","ERROR_OCCURRED","emitInstanceCreated","INSTANCE_CREATED","emitInstanceDestroyed","INSTANCE_DESTROYED","emitPerformanceUpdate","metrics","PERFORMANCE_UPDATE"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;;;AAGD,SAASA,kBAAkB,QAAQ,UAAU;AAG7C;;CAEC,GACD,OAAO,MAAMC;IAOX;;GAEC,GACDC,aAAaC,UAAmB,EAAQ;QACtC,IAAI,CAACC,QAAQ,CAACC,QAAQ,CAACL,mBAAmBM,SAAS,EAAE;YAAEH;QAAW;IACpE;IAEA;;GAEC,GACDI,eAAeJ,UAAkB,EAAEK,QAAgB,EAAQ;QACzD,IAAI,CAACJ,QAAQ,CAACC,QAAQ,CAACL,mBAAmBS,WAAW,EAAE;YACrDN;YACAK;QACF;IACF;IAEA;;GAEC,GACDE,iBAAiBP,UAAmB,EAAQ;QAC1C,IAAI,CAACC,QAAQ,CAACC,QAAQ,CAACL,mBAAmBW,cAAc,EAAE;YAAER;QAAW;IACzE;IAEA;;GAEC,GACDS,oBACET,UAAkB,EAClBU,OAA8B,EAC9BL,QAAgB,EACV;QACN,IAAI,CAACJ,QAAQ,CAACC,QAAQ,CAACL,mBAAmBc,iBAAiB,EAAE;YAC3DX;YACAU;YACAL;QACF;IACF;IAEA;;GAEC,GACDO,iBAAiBZ,UAAkB,EAAEa,KAAY,EAAQ;QACvD,IAAI,CAACZ,QAAQ,CAACC,QAAQ,CAACL,mBAAmBiB,cAAc,EAAE;YACxDd;YACAa;QACF;IACF;IAEA;;GAEC,GACDE,mBAAmBf,UAAmB,EAAQ;QAC5C,IAAI,CAACC,QAAQ,CAACC,QAAQ,CAACL,mBAAmBmB,gBAAgB,EAAE;YAAEhB;QAAW;IAC3E;IAEA;;GAEC,GACDiB,sBAAsBjB,UAAkB,EAAEK,QAAgB,EAAQ;QAChE,IAAI,CAACJ,QAAQ,CAACC,QAAQ,CAACL,mBAAmBqB,mBAAmB,EAAE;YAC7DlB;YACAK;QACF;IACF;IAEA;;GAEC,GACDc,gBACEC,IAAY,EACZC,EAAU,EACVC,MAAgC,EAC1B;QACN,IAAI,CAACrB,QAAQ,CAACC,QAAQ,CAACL,mBAAmB0B,YAAY,EAAE;YACtDH;YACAC;YACAC;QACF;IACF;IAEA;;GAEC,GACDE,uBAAuBH,EAAU,EAAEI,OAAiB,EAAQ;QAC1D,IAAI,CAACxB,QAAQ,CAACC,QAAQ,CAACL,mBAAmB6B,oBAAoB,EAAE;YAC9DL;YACAI;QACF;IACF;IAEA;;GAEC,GACDE,0BAA0BN,EAAU,EAAEhB,QAAgB,EAAQ;QAC5D,IAAI,CAACJ,QAAQ,CAACC,QAAQ,CAACL,mBAAmB+B,uBAAuB,EAAE;YACjEP;YACAhB;QACF;IACF;IAEA;;GAEC,GACDwB,kBAAkBhB,KAAY,EAAEH,OAAiB,EAAQ;QACvD,IAAI,CAACT,QAAQ,CAACC,QAAQ,CAACL,mBAAmBiC,cAAc,EAAE;YACxDjB;YACAH;QACF;IACF;IAEA;;GAEC,GACDqB,oBAAoB/B,UAAkB,EAAQ;QAC5C,IAAI,CAACC,QAAQ,CAACC,QAAQ,CAACL,mBAAmBmC,gBAAgB,EAAE;YAAEhC;QAAW;IAC3E;IAEA;;GAEC,GACDiC,sBAAsBjC,UAAkB,EAAQ;QAC9C,IAAI,CAACC,QAAQ,CAACC,QAAQ,CAACL,mBAAmBqC,kBAAkB,EAAE;YAC5DlC;QACF;IACF;IAEA;;GAEC,GACDmC,sBAAsBC,OAA+B,EAAQ;QAC3D,IAAI,CAACnC,QAAQ,CAACC,QAAQ,CAACL,mBAAmBwC,kBAAkB,EAAE;YAAED;QAAQ;IAC1E;IAxIA,YAAYnC,QAAqB,CAAE;QAFnC,uBAAQA,YAAR,KAAA;QAGE,IAAI,CAACA,QAAQ,GAAGA;IAClB;AAuIF"}

package/dist/core/event/hooks.cjs

@@ -0,0 +1,71 @@
+/**
+ * React Hooks 支持
+ * 提供便捷的 React 组件事件订阅能力
+ */ "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) {
+    // 使用 ref 保存最新的 listener，避免重复订阅
+    const listenerRef = (0, _react.useRef)(listener);
+    listenerRef.current = listener;
+    // 使用 ref 保存 options
+    const optionsRef = (0, _react.useRef)(options);
+    optionsRef.current = options;
+    (0, _react.useEffect)(()=>{
+        // 创建包装的监听器，使用最新的 listener
+        const wrappedListener = (data, metadata)=>{
+            return listenerRef.current(data, metadata);
+        };
+        // 订阅事件
+        const unsubscribe = eventBus.on(event, wrappedListener, optionsRef.current);
+        // 清理函数：取消订阅
+        return unsubscribe;
+    }, [
+        eventBus,
+        event
+    ]); // 只在 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
+    ]);
+}
+
+//# sourceMappingURL=hooks.js.map

package/dist/core/event/hooks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/event/hooks.ts"],"sourcesContent":["/**\n * React Hooks 支持\n * 提供便捷的 React 组件事件订阅能力\n */\n\nimport { useEffect, useRef, useCallback } from 'react';\nimport type { EventListener, EventListenerOptions } from './types';\nimport type { AppEventBus } from './AppEventBus';\n\n/**\n * 使用事件总线的 Hook\n * \n * @param eventBus - 事件总线实例\n * @param event - 事件名称\n * @param listener - 事件监听器\n * @param options - 监听器选项\n * \n * @example\n * ```tsx\n * import { useAppEventBus } from '@vlian/framework';\n * \n * function MyComponent() {\n *   useAppEvent('user:login', (data, metadata) => {\n *     console.log('用户登录:', data);\n *   });\n *   \n *   return <div>My Component</div>;\n * }\n * ```\n */\nexport function useAppEvent<T = unknown>(\n  eventBus: AppEventBus,\n  event: string,\n  listener: EventListener<T>,\n  options?: EventListenerOptions\n): void {\n  // 使用 ref 保存最新的 listener，避免重复订阅\n  const listenerRef = useRef<EventListener<T>>(listener);\n  listenerRef.current = listener;\n\n  // 使用 ref 保存 options\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  useEffect(() => {\n    // 创建包装的监听器，使用最新的 listener\n    const wrappedListener: EventListener<T> = (data, metadata) => {\n      return listenerRef.current(data, metadata);\n    };\n\n    // 订阅事件\n    const unsubscribe = eventBus.on(event, wrappedListener, optionsRef.current);\n\n    // 清理函数：取消订阅\n    return unsubscribe;\n  }, [eventBus, event]); // 只在 eventBus 或 event 变化时重新订阅\n}\n\n/**\n * 一次性事件订阅 Hook\n * \n * @param eventBus - 事件总线实例\n * @param event - 事件名称\n * @param listener - 事件监听器\n * @param options - 监听器选项\n */\nexport function useAppEventOnce<T = unknown>(\n  eventBus: AppEventBus,\n  event: string,\n  listener: EventListener<T>,\n  options?: Omit<EventListenerOptions, 'once'>\n): void {\n  const listenerRef = useRef<EventListener<T>>(listener);\n  listenerRef.current = listener;\n\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  useEffect(() => {\n    const wrappedListener: EventListener<T> = (data, metadata) => {\n      return listenerRef.current(data, metadata);\n    };\n\n    const unsubscribe = eventBus.once(event, wrappedListener, optionsRef.current);\n\n    return unsubscribe;\n  }, [eventBus, event]);\n}\n\n/**\n * 创建事件发射器 Hook\n * \n * @param eventBus - 事件总线实例\n * @returns 事件发射函数\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const emit = useAppEventEmitter(eventBus);\n *   \n *   const handleClick = () => {\n *     emit('button:click', { buttonId: 'submit' });\n *   };\n *   \n *   return <button onClick={handleClick}>Click</button>;\n * }\n * ```\n */\nexport function useAppEventEmitter(eventBus: AppEventBus) {\n  return useCallback(\n    <T = unknown>(\n      event: string,\n      data?: T,\n      metadata?: Partial<import('./types').EventMetadata>\n    ) => {\n      return eventBus.emit(event, data, metadata);\n    },\n    [eventBus]\n  );\n}\n"],"names":["useAppEvent","useAppEventEmitter","useAppEventOnce","eventBus","event","listener","options","listenerRef","useRef","current","optionsRef","useEffect","wrappedListener","data","metadata","unsubscribe","on","once","useCallback","emit"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;QA2BeA;eAAAA;;QA8EAC;eAAAA;;QA1CAC;eAAAA;;;uBA7D+B;AAyBxC,SAASF,YACdG,QAAqB,EACrBC,KAAa,EACbC,QAA0B,EAC1BC,OAA8B;IAE9B,+BAA+B;IAC/B,MAAMC,cAAcC,IAAAA,aAAM,EAAmBH;IAC7CE,YAAYE,OAAO,GAAGJ;IAEtB,oBAAoB;IACpB,MAAMK,aAAaF,IAAAA,aAAM,EAACF;IAC1BI,WAAWD,OAAO,GAAGH;IAErBK,IAAAA,gBAAS,EAAC;QACR,0BAA0B;QAC1B,MAAMC,kBAAoC,CAACC,MAAMC;YAC/C,OAAOP,YAAYE,OAAO,CAACI,MAAMC;QACnC;QAEA,OAAO;QACP,MAAMC,cAAcZ,SAASa,EAAE,CAACZ,OAAOQ,iBAAiBF,WAAWD,OAAO;QAE1E,YAAY;QACZ,OAAOM;IACT,GAAG;QAACZ;QAAUC;KAAM,GAAG,8BAA8B;AACvD;AAUO,SAASF,gBACdC,QAAqB,EACrBC,KAAa,EACbC,QAA0B,EAC1BC,OAA4C;IAE5C,MAAMC,cAAcC,IAAAA,aAAM,EAAmBH;IAC7CE,YAAYE,OAAO,GAAGJ;IAEtB,MAAMK,aAAaF,IAAAA,aAAM,EAACF;IAC1BI,WAAWD,OAAO,GAAGH;IAErBK,IAAAA,gBAAS,EAAC;QACR,MAAMC,kBAAoC,CAACC,MAAMC;YAC/C,OAAOP,YAAYE,OAAO,CAACI,MAAMC;QACnC;QAEA,MAAMC,cAAcZ,SAASc,IAAI,CAACb,OAAOQ,iBAAiBF,WAAWD,OAAO;QAE5E,OAAOM;IACT,GAAG;QAACZ;QAAUC;KAAM;AACtB;AAqBO,SAASH,mBAAmBE,QAAqB;IACtD,OAAOe,IAAAA,kBAAW,EAChB,CACEd,OACAS,MACAC;QAEA,OAAOX,SAASgB,IAAI,CAACf,OAAOS,MAAMC;IACpC,GACA;QAACX;KAAS;AAEd"}

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

@@ -0,0 +1,58 @@
+/**
+ * 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>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/core/event/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/core/event/hooks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,GAAG,OAAO,EACrC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,CAqBN;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,GAC3C,IAAI,CAgBN;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,IAEnD,CAAC,mBACO,MAAM,SACN,CAAC,aACG,OAAO,CAAC,OAAO,SAAS,EAAE,aAAa,CAAC,mBAMxD"}

package/dist/core/event/hooks.js

@@ -0,0 +1,95 @@
+/**
+ * React Hooks 支持
+ * 提供便捷的 React 组件事件订阅能力
+ */ import { useEffect, useRef, useCallback } from "react";
+/**
+ * 使用事件总线的 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 function useAppEvent(eventBus, event, listener, options) {
+    // 使用 ref 保存最新的 listener，避免重复订阅
+    const listenerRef = useRef(listener);
+    listenerRef.current = listener;
+    // 使用 ref 保存 options
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    useEffect(()=>{
+        // 创建包装的监听器，使用最新的 listener
+        const wrappedListener = (data, metadata)=>{
+            return listenerRef.current(data, metadata);
+        };
+        // 订阅事件
+        const unsubscribe = eventBus.on(event, wrappedListener, optionsRef.current);
+        // 清理函数：取消订阅
+        return unsubscribe;
+    }, [
+        eventBus,
+        event
+    ]); // 只在 eventBus 或 event 变化时重新订阅
+}
+/**
+ * 一次性事件订阅 Hook
+ * 
+ * @param eventBus - 事件总线实例
+ * @param event - 事件名称
+ * @param listener - 事件监听器
+ * @param options - 监听器选项
+ */ 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
+    ]);
+}
+/**
+ * 创建事件发射器 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 function useAppEventEmitter(eventBus) {
+    return useCallback((event, data, metadata)=>{
+        return eventBus.emit(event, data, metadata);
+    }, [
+        eventBus
+    ]);
+}
+
+//# sourceMappingURL=hooks.js.map

package/dist/core/event/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/event/hooks.ts"],"sourcesContent":["/**\n * React Hooks 支持\n * 提供便捷的 React 组件事件订阅能力\n */\n\nimport { useEffect, useRef, useCallback } from 'react';\nimport type { EventListener, EventListenerOptions } from './types';\nimport type { AppEventBus } from './AppEventBus';\n\n/**\n * 使用事件总线的 Hook\n * \n * @param eventBus - 事件总线实例\n * @param event - 事件名称\n * @param listener - 事件监听器\n * @param options - 监听器选项\n * \n * @example\n * ```tsx\n * import { useAppEventBus } from '@vlian/framework';\n * \n * function MyComponent() {\n *   useAppEvent('user:login', (data, metadata) => {\n *     console.log('用户登录:', data);\n *   });\n *   \n *   return <div>My Component</div>;\n * }\n * ```\n */\nexport function useAppEvent<T = unknown>(\n  eventBus: AppEventBus,\n  event: string,\n  listener: EventListener<T>,\n  options?: EventListenerOptions\n): void {\n  // 使用 ref 保存最新的 listener，避免重复订阅\n  const listenerRef = useRef<EventListener<T>>(listener);\n  listenerRef.current = listener;\n\n  // 使用 ref 保存 options\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  useEffect(() => {\n    // 创建包装的监听器，使用最新的 listener\n    const wrappedListener: EventListener<T> = (data, metadata) => {\n      return listenerRef.current(data, metadata);\n    };\n\n    // 订阅事件\n    const unsubscribe = eventBus.on(event, wrappedListener, optionsRef.current);\n\n    // 清理函数：取消订阅\n    return unsubscribe;\n  }, [eventBus, event]); // 只在 eventBus 或 event 变化时重新订阅\n}\n\n/**\n * 一次性事件订阅 Hook\n * \n * @param eventBus - 事件总线实例\n * @param event - 事件名称\n * @param listener - 事件监听器\n * @param options - 监听器选项\n */\nexport function useAppEventOnce<T = unknown>(\n  eventBus: AppEventBus,\n  event: string,\n  listener: EventListener<T>,\n  options?: Omit<EventListenerOptions, 'once'>\n): void {\n  const listenerRef = useRef<EventListener<T>>(listener);\n  listenerRef.current = listener;\n\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n\n  useEffect(() => {\n    const wrappedListener: EventListener<T> = (data, metadata) => {\n      return listenerRef.current(data, metadata);\n    };\n\n    const unsubscribe = eventBus.once(event, wrappedListener, optionsRef.current);\n\n    return unsubscribe;\n  }, [eventBus, event]);\n}\n\n/**\n * 创建事件发射器 Hook\n * \n * @param eventBus - 事件总线实例\n * @returns 事件发射函数\n * \n * @example\n * ```tsx\n * function MyComponent() {\n *   const emit = useAppEventEmitter(eventBus);\n *   \n *   const handleClick = () => {\n *     emit('button:click', { buttonId: 'submit' });\n *   };\n *   \n *   return <button onClick={handleClick}>Click</button>;\n * }\n * ```\n */\nexport function useAppEventEmitter(eventBus: AppEventBus) {\n  return useCallback(\n    <T = unknown>(\n      event: string,\n      data?: T,\n      metadata?: Partial<import('./types').EventMetadata>\n    ) => {\n      return eventBus.emit(event, data, metadata);\n    },\n    [eventBus]\n  );\n}\n"],"names":["useEffect","useRef","useCallback","useAppEvent","eventBus","event","listener","options","listenerRef","current","optionsRef","wrappedListener","data","metadata","unsubscribe","on","useAppEventOnce","once","useAppEventEmitter","emit"],"mappings":"AAAA;;;CAGC,GAED,SAASA,SAAS,EAAEC,MAAM,EAAEC,WAAW,QAAQ,QAAQ;AAIvD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASC,YACdC,QAAqB,EACrBC,KAAa,EACbC,QAA0B,EAC1BC,OAA8B;IAE9B,+BAA+B;IAC/B,MAAMC,cAAcP,OAAyBK;IAC7CE,YAAYC,OAAO,GAAGH;IAEtB,oBAAoB;IACpB,MAAMI,aAAaT,OAAOM;IAC1BG,WAAWD,OAAO,GAAGF;IAErBP,UAAU;QACR,0BAA0B;QAC1B,MAAMW,kBAAoC,CAACC,MAAMC;YAC/C,OAAOL,YAAYC,OAAO,CAACG,MAAMC;QACnC;QAEA,OAAO;QACP,MAAMC,cAAcV,SAASW,EAAE,CAACV,OAAOM,iBAAiBD,WAAWD,OAAO;QAE1E,YAAY;QACZ,OAAOK;IACT,GAAG;QAACV;QAAUC;KAAM,GAAG,8BAA8B;AACvD;AAEA;;;;;;;CAOC,GACD,OAAO,SAASW,gBACdZ,QAAqB,EACrBC,KAAa,EACbC,QAA0B,EAC1BC,OAA4C;IAE5C,MAAMC,cAAcP,OAAyBK;IAC7CE,YAAYC,OAAO,GAAGH;IAEtB,MAAMI,aAAaT,OAAOM;IAC1BG,WAAWD,OAAO,GAAGF;IAErBP,UAAU;QACR,MAAMW,kBAAoC,CAACC,MAAMC;YAC/C,OAAOL,YAAYC,OAAO,CAACG,MAAMC;QACnC;QAEA,MAAMC,cAAcV,SAASa,IAAI,CAACZ,OAAOM,iBAAiBD,WAAWD,OAAO;QAE5E,OAAOK;IACT,GAAG;QAACV;QAAUC;KAAM;AACtB;AAEA;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASa,mBAAmBd,QAAqB;IACtD,OAAOF,YACL,CACEG,OACAO,MACAC;QAEA,OAAOT,SAASe,IAAI,CAACd,OAAOO,MAAMC;IACpC,GACA;QAACT;KAAS;AAEd"}

package/dist/core/event/index.cjs

@@ -0,0 +1,43 @@
+/**
+ * 应用级事件系统
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */ "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");
+
+//# sourceMappingURL=index.js.map

package/dist/core/event/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/event/index.ts"],"sourcesContent":["/**\n * 应用级事件系统\n * 提供高性能、类型安全、可观测的事件通信能力\n */\n\nexport { AppEventBus } from './AppEventBus';\nexport { FrameworkEventManager } from './frameworkEvents';\nexport {\n  useAppEvent,\n  useAppEventOnce,\n  useAppEventEmitter,\n} from './hooks';\n\nexport { useEventBus } from './useEventBus';\n\nexport type {\n  EventListener,\n  EventMetadata,\n  EventWrapper,\n  EventMiddleware,\n  EventListenerOptions,\n  AppEventBusConfig,\n  EventStats,\n  FrameworkEventData,\n} from './types';\n\nexport { FrameworkEventType } from './types';\n"],"names":["AppEventBus","FrameworkEventManager","FrameworkEventType","useAppEvent","useAppEventEmitter","useAppEventOnce","useEventBus"],"mappings":"AAAA;;;CAGC;;;;;;;;;;;QAEQA;eAAAA,wBAAW;;QACXC;eAAAA,sCAAqB;;QAoBrBC;eAAAA,yBAAkB;;QAlBzBC;eAAAA,kBAAW;;QAEXC;eAAAA,yBAAkB;;QADlBC;eAAAA,sBAAe;;QAIRC;eAAAA,wBAAW;;;6BARQ;iCACU;uBAK/B;6BAEqB;uBAaO"}

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

@@ -0,0 +1,11 @@
+/**
+ * 应用级事件系统
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/event/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/event/index.js

@@ -0,0 +1,10 @@
+/**
+ * 应用级事件系统
+ * 提供高性能、类型安全、可观测的事件通信能力
+ */ export { AppEventBus } from "./AppEventBus";
+export { FrameworkEventManager } from "./frameworkEvents";
+export { useAppEvent, useAppEventOnce, useAppEventEmitter } from "./hooks";
+export { useEventBus } from "./useEventBus";
+export { FrameworkEventType } from "./types";
+
+//# sourceMappingURL=index.js.map

package/dist/core/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/event/index.ts"],"sourcesContent":["/**\n * 应用级事件系统\n * 提供高性能、类型安全、可观测的事件通信能力\n */\n\nexport { AppEventBus } from './AppEventBus';\nexport { FrameworkEventManager } from './frameworkEvents';\nexport {\n  useAppEvent,\n  useAppEventOnce,\n  useAppEventEmitter,\n} from './hooks';\n\nexport { useEventBus } from './useEventBus';\n\nexport type {\n  EventListener,\n  EventMetadata,\n  EventWrapper,\n  EventMiddleware,\n  EventListenerOptions,\n  AppEventBusConfig,\n  EventStats,\n  FrameworkEventData,\n} from './types';\n\nexport { FrameworkEventType } from './types';\n"],"names":["AppEventBus","FrameworkEventManager","useAppEvent","useAppEventOnce","useAppEventEmitter","useEventBus","FrameworkEventType"],"mappings":"AAAA;;;CAGC,GAED,SAASA,WAAW,QAAQ,gBAAgB;AAC5C,SAASC,qBAAqB,QAAQ,oBAAoB;AAC1D,SACEC,WAAW,EACXC,eAAe,EACfC,kBAAkB,QACb,UAAU;AAEjB,SAASC,WAAW,QAAQ,gBAAgB;AAa5C,SAASC,kBAAkB,QAAQ,UAAU"}

package/dist/core/event/types.cjs

@@ -0,0 +1,64 @@
+/**
+ * 应用级事件系统类型定义
+ * 提供类型安全的事件通信能力
+ */ /**
+ * 事件监听器类型
+ * 
+ * @template T - 事件数据类型
+ */ "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;
+}({});
+
+//# sourceMappingURL=types.js.map

package/dist/core/event/types.cjs.map

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