@vlian/framework 1.2.57 → 1.2.60

package/dist/core/startup/startApp.cjs

@@ -1,319 +1 @@
-/**
- * 应用启动主函数
- * 重构后的启动逻辑，集成所有新功能
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "startApp", {
-    enumerable: true,
-    get: function() {
-        return startApp;
-    }
-});
-const _logger = require("@vlian/logger");
-const _utils = require("@vlian/utils");
-const _traceId = require("../../utils/traceId");
-const _splash = require("../splash");
-const _index = require("../initialization/index");
-const _middleware = require("../middleware");
-const _initializeServices = require("./initializeServices");
-const _AppInstance = require("./AppInstance");
-const _environment = require("./environment");
-const _RouterManager = require("../router/RouterManager");
-const _frameworkEvents = require("../event/frameworkEvents");
-const _kernel = require("../kernel");
-async function startApp(options = {}, instanceId) {
-    const startTime = performance.now();
-    const envDetector = (0, _environment.getEnvironmentDetector)();
-    const instanceManager = (0, _AppInstance.getAppInstanceManager)();
-    // 初始化追踪 ID 生成器
-    (0, _traceId.initTraceIdGenerator)('app');
-    const traceId = (0, _traceId.generateTraceId)();
-    (0, _traceId.setCurrentTraceId)(traceId);
-    // 框架事件管理器（在服务初始化后创建）
-    let frameworkEventManager = null;
-    let kernelTraceId = null;
-    try {
-        // 1. 环境检测和容器获取
-        const container = options.container || envDetector.safeGetElement('#root');
-        if (!container) {
-            throw new _utils.InitializationError('未找到挂载容器', undefined, {
-                container: options.container
-            }, _utils.ErrorCode.CONTAINER_NOT_FOUND);
-        }
-        _logger.logger.info('框架启动中...');
-        if (options.antd && !options.uiProvider) {
-            _logger.logger.warn('[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider');
-        }
-        if (options.antdApp && !options.uiApp) {
-            _logger.logger.warn('[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp');
-        }
-        // 2. 创建应用实例
-        const appInstance = instanceManager.createInstance(instanceId, options);
-        const finalInstanceId = appInstance.id;
-        let services = null;
-        // 使用单次 Promise 防止重复初始化，提升加载速度并保证可观测数据一致。
-        let servicesInitPromise = null;
-        const ensureServicesInitialized = async ()=>{
-            if (services) {
-                return services;
-            }
-            if (!servicesInitPromise) {
-                servicesInitPromise = (0, _initializeServices.initializeServices)({
-                    ...options,
-                    eventBus: {
-                        ...options.eventBus,
-                        instanceId: finalInstanceId
-                    }
-                });
-            }
-            services = await servicesInitPromise;
-            return services;
-        };
-        // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）
-        const kernelRuntime = await (0, _kernel.startKernel)({
-            loggerLevel: options.loggerLevel,
-            locale: {
-                locale: (options.locale ? Object.keys(options.locale)[0] : 'zh-CN') || 'zh-CN',
-                resources: options.locale
-            },
-            theme: {
-                mode: options.theme?.mode || 'light',
-                primaryColor: options.theme?.primaryColor,
-                compatibility: {
-                    antd: options.uiProvider || options.antd
-                }
-            },
-            adapters: {
-                monitoring: {
-                    initialize: async ()=>{
-                        await ensureServicesInitialized();
-                    },
-                    captureError: (error, metadata)=>{
-                        if (services) {
-                            services.monitoring.captureError(error, metadata);
-                        } else {
-                            _logger.logger.error('Kernel 监控上报失败（服务尚未初始化）:', error, metadata);
-                        }
-                    },
-                    reportMetric: (name, value, tags)=>{
-                        _logger.logger.debug(`[kernel.metric] ${name}`, {
-                            value,
-                            tags,
-                            instanceId: finalInstanceId
-                        });
-                    }
-                },
-                state: {
-                    initialize: async ()=>{
-                        await ensureServicesInitialized();
-                    },
-                    getInstance: ()=>services?.stateManager ?? null
-                },
-                eventBus: {
-                    initialize: async ()=>{
-                        await ensureServicesInitialized();
-                    },
-                    emit: (event, payload)=>{
-                        if (services) {
-                            services.eventBus.emit(event, payload);
-                        }
-                    },
-                    on: (event, handler)=>{
-                        if (!services) {
-                            return ()=>{};
-                        }
-                        return services.eventBus.on(event, handler);
-                    }
-                },
-                errorHandler: {
-                    async handle (error) {
-                        _logger.logger.error('Kernel 启动阶段失败:', error);
-                        return {
-                            handled: true,
-                            shouldThrow: true
-                        };
-                    }
-                }
-            },
-            enabledPhases: {
-                init: false
-            },
-            enablePostReady: false
-        });
-        kernelTraceId = kernelRuntime.traceId;
-        const servicesInitStart = performance.now();
-        const resolvedServices = await ensureServicesInitialized();
-        const servicesInitDuration = performance.now() - servicesInitStart;
-        // 创建框架事件管理器
-        frameworkEventManager = new _frameworkEvents.FrameworkEventManager(resolvedServices.eventBus);
-        // 触发应用启动事件（使用真实的事件总线）
-        frameworkEventManager.emitAppStart(finalInstanceId);
-        // 触发实例创建事件
-        frameworkEventManager.emitInstanceCreated(finalInstanceId);
-        // 4. 初始化应用实例
-        appInstance.initialize(container, resolvedServices);
-        // 5. 初始化路由管理器
-        const routerManager = (0, _RouterManager.getRouterManager)();
-        if (options.router) {
-            await routerManager.initialize(options.router);
-        }
-        // 6. 性能追踪
-        const performanceTracker = appInstance.getPerformanceTracker();
-        if (performanceTracker) {
-            performanceTracker.recordServiceInit(servicesInitDuration);
-        }
-        // 6. 是否显示启动页
-        const shouldShowSplash = (0, _splash.shouldShowSplashScreen)(options.showSplashScreen);
-        const renderer = appInstance.getRenderer();
-        // 8. 渲染应用函数
-        const renderApp = async (context)=>{
-            const renderStart = performance.now();
-            // 触发渲染开始事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppRenderStart(finalInstanceId);
-            }
-            await renderer.renderApp(options, resolvedServices, context);
-            const renderDuration = performance.now() - renderStart;
-            // 触发渲染完成事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);
-            }
-            // 优化：在应用渲染完成后，延迟初始化非关键服务
-            // 使用 requestIdleCallback 在浏览器空闲时初始化，不影响用户体验
-            if (resolvedServices.initializeNonCriticalServices) {
-                resolvedServices.initializeNonCriticalServices().catch((error)=>{
-                    _logger.logger.warn('非关键服务初始化失败（不影响应用运行）:', error);
-                });
-            }
-            if (performanceTracker) {
-                performanceTracker.recordFirstRender(renderDuration);
-                const totalDuration = performance.now() - startTime;
-                performanceTracker.recordTotalStartup(totalDuration);
-                performanceTracker.report();
-            }
-            // 触发应用启动完成事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);
-            }
-            // 统一发出 Kernel post-ready 事件，供可观测系统消费。
-            kernelRuntime.getEventBus().emit('kernel.postReady', {
-                traceId: kernelRuntime.traceId,
-                instanceId: finalInstanceId,
-                startupDuration: performance.now() - startTime
-            });
-            // 开发模式下显示开发工具
-            if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {
-                // 延迟显示开发工具，避免影响首次渲染
-                setTimeout(()=>{
-                    const devToolsContainer = document.createElement('div');
-                    devToolsContainer.id = '__framework_dev_tools__';
-                    document.body.appendChild(devToolsContainer);
-                // 这里需要动态导入React来渲染开发工具
-                // 为了简化，暂时注释掉，后续可以完善
-                // import('react-dom/client').then(({ createRoot }) => {
-                //   const root = createRoot(devToolsContainer);
-                //   root.render(<DevToolsTrigger appInstance={appInstance} />);
-                // });
-                }, 1000);
-            }
-        };
-        if (shouldShowSplash) {
-            // 场景1: 显示启动页，初始化在启动页中完成
-            const onSplashComplete = (context)=>{
-                _logger.logger.info('启动页初始化完成');
-                // 触发初始化完成事件
-                if (frameworkEventManager) {
-                    const initDuration = context.duration || 0;
-                    frameworkEventManager.emitAppInitComplete(finalInstanceId, context, initDuration);
-                }
-                if (options.onSplashComplete) {
-                    Promise.resolve(options.onSplashComplete(()=>{
-                        _logger.logger.info('框架加载完成');
-                        renderApp(context);
-                    }, context)).catch((error)=>{
-                        _logger.logger.error('onSplashComplete 回调执行失败:', error);
-                        _index.initializationErrorState.setError(error);
-                        renderApp(context);
-                    });
-                } else {
-                    _logger.logger.info('框架加载完成');
-                    renderApp(context);
-                }
-            };
-            // 触发初始化开始事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppInitStart(finalInstanceId);
-            }
-            // 渲染启动页
-            renderer.renderSplashScreen(options, resolvedServices, onSplashComplete);
-        } else {
-            // 场景2: 不显示启动页，直接执行初始化
-            _logger.logger.info('开始执行初始化（无启动页）');
-            // 触发初始化开始事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppInitStart(finalInstanceId);
-            }
-            try {
-                const initStart = performance.now();
-                // 使用中间件包装初始化函数
-                const initContext = await _middleware.middlewareManager.execute(options, async ()=>{
-                    return await (0, _index.initialization)(options, (progress, step)=>{
-                        _logger.logger.debug(`初始化进度: ${progress}%${step ? ` - ${step}` : ''}`);
-                    });
-                });
-                const initDuration = performance.now() - initStart;
-                // 触发初始化完成事件
-                if (frameworkEventManager) {
-                    frameworkEventManager.emitAppInitComplete(finalInstanceId, initContext, initDuration);
-                }
-                if (performanceTracker) {
-                    performanceTracker.recordInitialization(initDuration);
-                }
-                _logger.logger.info('初始化完成（无启动页）', initContext);
-                _logger.logger.info('框架加载完成');
-                void renderApp(initContext);
-            } catch (error) {
-                _logger.logger.error('初始化失败:', error);
-                // 触发初始化错误事件
-                if (frameworkEventManager) {
-                    frameworkEventManager.emitAppInitError(finalInstanceId, error instanceof Error ? error : new Error(String(error)));
-                }
-                _index.initializationErrorState.setError(error);
-                void renderApp();
-            }
-        }
-        return instanceManager;
-    } catch (error) {
-        _logger.logger.error('框架启动失败:', error);
-        // 触发错误事件
-        if (frameworkEventManager) {
-            const errorInstanceId = instanceId || instanceManager.getInstance()?.id;
-            if (errorInstanceId) {
-                frameworkEventManager.emitErrorOccurred(error instanceof Error ? error : new Error(String(error)), {
-                    phase: 'startup'
-                });
-            }
-        }
-        if (kernelTraceId) {
-            _logger.logger.error('Kernel Trace 失败上下文', {
-                traceId: kernelTraceId
-            });
-        }
-        // 如果容器存在，尝试渲染错误页面
-        const container = options.container || envDetector.safeGetElement('#root');
-        if (container) {
-            const errorInstance = instanceManager.getInstance();
-            if (errorInstance && errorInstance.isInitialized()) {
-                const renderer = errorInstance.getRenderer();
-                const services = errorInstance.getServices();
-                _index.initializationErrorState.setError(error);
-                renderer.renderError(options, services);
-            }
-        }
-        throw error;
-    }
-}
-
-//# sourceMappingURL=startApp.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"startApp",{enumerable:true,get:function(){return startApp}});const _logger=require("@vlian/logger");const _utils=require("@vlian/utils");const _traceId=require("../../utils/traceId");const _splash=require("../splash");const _index=require("../initialization/index");const _middleware=require("../middleware");const _initializeServices=require("./initializeServices");const _AppInstance=require("./AppInstance");const _environment=require("./environment");const _RouterManager=require("../router/RouterManager");const _frameworkEvents=require("../event/frameworkEvents");const _kernel=require("../kernel");async function startApp(options={},instanceId){const startTime=performance.now();const envDetector=(0,_environment.getEnvironmentDetector)();const instanceManager=(0,_AppInstance.getAppInstanceManager)();(0,_traceId.initTraceIdGenerator)("app");const traceId=(0,_traceId.generateTraceId)();(0,_traceId.setCurrentTraceId)(traceId);let frameworkEventManager=null;let kernelTraceId=null;try{const container=options.container||envDetector.safeGetElement("#root");if(!container){throw new _utils.InitializationError("未找到挂载容器",undefined,{container:options.container},_utils.ErrorCode.CONTAINER_NOT_FOUND)}_logger.logger.info("框架启动中...");if(options.antd&&!options.uiProvider){_logger.logger.warn("[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider")}if(options.antdApp&&!options.uiApp){_logger.logger.warn("[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp")}const appInstance=instanceManager.createInstance(instanceId,options);const finalInstanceId=appInstance.id;let services=null;let servicesInitPromise=null;const ensureServicesInitialized=async()=>{if(services){return services}if(!servicesInitPromise){servicesInitPromise=(0,_initializeServices.initializeServices)({...options,eventBus:{...options.eventBus,instanceId:finalInstanceId}})}services=await servicesInitPromise;return services};const kernelRuntime=await (0,_kernel.startKernel)({loggerLevel:options.loggerLevel,locale:{locale:(options.locale?Object.keys(options.locale)[0]:"zh-CN")||"zh-CN",resources:options.locale},theme:{mode:options.theme?.mode||"light",primaryColor:options.theme?.primaryColor,compatibility:{antd:options.uiProvider||options.antd}},adapters:{monitoring:{initialize:async()=>{await ensureServicesInitialized()},captureError:(error,metadata)=>{if(services){services.monitoring.captureError(error,metadata)}else{_logger.logger.error("Kernel 监控上报失败（服务尚未初始化）:",error,metadata)}},reportMetric:(name,value,tags)=>{_logger.logger.debug(`[kernel.metric] ${name}`,{value,tags,instanceId:finalInstanceId})}},state:{initialize:async()=>{await ensureServicesInitialized()},getInstance:()=>services?.stateManager??null},eventBus:{initialize:async()=>{await ensureServicesInitialized()},emit:(event,payload)=>{if(services){services.eventBus.emit(event,payload)}},on:(event,handler)=>{if(!services){return()=>{}}return services.eventBus.on(event,handler)}},errorHandler:{async handle(error){_logger.logger.error("Kernel 启动阶段失败:",error);return{handled:true,shouldThrow:true}}}},enabledPhases:{init:false},enablePostReady:false});kernelTraceId=kernelRuntime.traceId;const servicesInitStart=performance.now();const resolvedServices=await ensureServicesInitialized();const servicesInitDuration=performance.now()-servicesInitStart;frameworkEventManager=new _frameworkEvents.FrameworkEventManager(resolvedServices.eventBus);frameworkEventManager.emitAppStart(finalInstanceId);frameworkEventManager.emitInstanceCreated(finalInstanceId);appInstance.initialize(container,resolvedServices);const routerManager=(0,_RouterManager.getRouterManager)();if(options.router){await routerManager.initialize(options.router)}const performanceTracker=appInstance.getPerformanceTracker();if(performanceTracker){performanceTracker.recordServiceInit(servicesInitDuration)}const shouldShowSplash=(0,_splash.shouldShowSplashScreen)(options.showSplashScreen);const renderer=appInstance.getRenderer();const renderApp=async context=>{const renderStart=performance.now();if(frameworkEventManager){frameworkEventManager.emitAppRenderStart(finalInstanceId)}await renderer.renderApp(options,resolvedServices,context);const renderDuration=performance.now()-renderStart;if(frameworkEventManager){frameworkEventManager.emitAppRenderComplete(finalInstanceId,renderDuration)}if(resolvedServices.initializeNonCriticalServices){resolvedServices.initializeNonCriticalServices().catch(error=>{_logger.logger.warn("非关键服务初始化失败（不影响应用运行）:",error)})}if(performanceTracker){performanceTracker.recordFirstRender(renderDuration);const totalDuration=performance.now()-startTime;performanceTracker.recordTotalStartup(totalDuration);performanceTracker.report()}if(frameworkEventManager){frameworkEventManager.emitAppStarted(finalInstanceId,performance.now()-startTime)}kernelRuntime.getEventBus().emit("kernel.postReady",{traceId:kernelRuntime.traceId,instanceId:finalInstanceId,startupDuration:performance.now()-startTime});if(process.env.NODE_ENV==="development"&&typeof window!=="undefined"){setTimeout(()=>{const devToolsContainer=document.createElement("div");devToolsContainer.id="__framework_dev_tools__";document.body.appendChild(devToolsContainer)},1e3)}};if(shouldShowSplash){const onSplashComplete=context=>{_logger.logger.info("启动页初始化完成");if(frameworkEventManager){const initDuration=context.duration||0;frameworkEventManager.emitAppInitComplete(finalInstanceId,context,initDuration)}if(options.onSplashComplete){Promise.resolve(options.onSplashComplete(()=>{_logger.logger.info("框架加载完成");renderApp(context)},context)).catch(error=>{_logger.logger.error("onSplashComplete 回调执行失败:",error);_index.initializationErrorState.setError(error);renderApp(context)})}else{_logger.logger.info("框架加载完成");renderApp(context)}};if(frameworkEventManager){frameworkEventManager.emitAppInitStart(finalInstanceId)}renderer.renderSplashScreen(options,resolvedServices,onSplashComplete)}else{_logger.logger.info("开始执行初始化（无启动页）");if(frameworkEventManager){frameworkEventManager.emitAppInitStart(finalInstanceId)}try{const initStart=performance.now();const initContext=await _middleware.middlewareManager.execute(options,async()=>{return await (0,_index.initialization)(options,(progress,step)=>{_logger.logger.debug(`初始化进度: ${progress}%${step?` - ${step}`:""}`)})});const initDuration=performance.now()-initStart;if(frameworkEventManager){frameworkEventManager.emitAppInitComplete(finalInstanceId,initContext,initDuration)}if(performanceTracker){performanceTracker.recordInitialization(initDuration)}_logger.logger.info("初始化完成（无启动页）",initContext);_logger.logger.info("框架加载完成");void renderApp(initContext)}catch(error){_logger.logger.error("初始化失败:",error);if(frameworkEventManager){frameworkEventManager.emitAppInitError(finalInstanceId,error instanceof Error?error:new Error(String(error)))}_index.initializationErrorState.setError(error);void renderApp()}}return instanceManager}catch(error){_logger.logger.error("框架启动失败:",error);if(frameworkEventManager){const errorInstanceId=instanceId||instanceManager.getInstance()?.id;if(errorInstanceId){frameworkEventManager.emitErrorOccurred(error instanceof Error?error:new Error(String(error)),{phase:"startup"})}}if(kernelTraceId){_logger.logger.error("Kernel Trace 失败上下文",{traceId:kernelTraceId})}const container=options.container||envDetector.safeGetElement("#root");if(container){const errorInstance=instanceManager.getInstance();if(errorInstance&&errorInstance.isInitialized()){const renderer=errorInstance.getRenderer();const services=errorInstance.getServices();_index.initializationErrorState.setError(error);renderer.renderError(options,services)}}throw error}}

package/dist/core/startup/startApp.js

@@ -1,315 +1 @@
-/**
- * 应用启动主函数
- * 重构后的启动逻辑，集成所有新功能
- */ import { logger } from "@vlian/logger";
-import { ErrorCode, InitializationError } from "@vlian/utils";
-import { initTraceIdGenerator, generateTraceId, setCurrentTraceId } from "../../utils/traceId";
-import { shouldShowSplashScreen } from "../splash";
-import { initialization, initializationErrorState } from "../initialization/index";
-import { middlewareManager } from "../middleware";
-import { initializeServices } from "./initializeServices";
-import { getAppInstanceManager } from "./AppInstance";
-import { getEnvironmentDetector } from "./environment";
-import { getRouterManager } from "../router/RouterManager";
-import { FrameworkEventManager } from "../event/frameworkEvents";
-import { startKernel } from "../kernel";
-/**
- * 启动应用
- *
- * @param options - 启动配置选项
- * @param instanceId - 应用实例ID（可选，用于多实例场景）
- * @returns 应用实例
- */ export async function startApp(options = {}, instanceId) {
-    const startTime = performance.now();
-    const envDetector = getEnvironmentDetector();
-    const instanceManager = getAppInstanceManager();
-    // 初始化追踪 ID 生成器
-    initTraceIdGenerator('app');
-    const traceId = generateTraceId();
-    setCurrentTraceId(traceId);
-    // 框架事件管理器（在服务初始化后创建）
-    let frameworkEventManager = null;
-    let kernelTraceId = null;
-    try {
-        // 1. 环境检测和容器获取
-        const container = options.container || envDetector.safeGetElement('#root');
-        if (!container) {
-            throw new InitializationError('未找到挂载容器', undefined, {
-                container: options.container
-            }, ErrorCode.CONTAINER_NOT_FOUND);
-        }
-        logger.info('框架启动中...');
-        if (options.antd && !options.uiProvider) {
-            logger.warn('[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider');
-        }
-        if (options.antdApp && !options.uiApp) {
-            logger.warn('[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp');
-        }
-        // 2. 创建应用实例
-        const appInstance = instanceManager.createInstance(instanceId, options);
-        const finalInstanceId = appInstance.id;
-        let services = null;
-        // 使用单次 Promise 防止重复初始化，提升加载速度并保证可观测数据一致。
-        let servicesInitPromise = null;
-        const ensureServicesInitialized = async ()=>{
-            if (services) {
-                return services;
-            }
-            if (!servicesInitPromise) {
-                servicesInitPromise = initializeServices({
-                    ...options,
-                    eventBus: {
-                        ...options.eventBus,
-                        instanceId: finalInstanceId
-                    }
-                });
-            }
-            services = await servicesInitPromise;
-            return services;
-        };
-        // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）
-        const kernelRuntime = await startKernel({
-            loggerLevel: options.loggerLevel,
-            locale: {
-                locale: (options.locale ? Object.keys(options.locale)[0] : 'zh-CN') || 'zh-CN',
-                resources: options.locale
-            },
-            theme: {
-                mode: options.theme?.mode || 'light',
-                primaryColor: options.theme?.primaryColor,
-                compatibility: {
-                    antd: options.uiProvider || options.antd
-                }
-            },
-            adapters: {
-                monitoring: {
-                    initialize: async ()=>{
-                        await ensureServicesInitialized();
-                    },
-                    captureError: (error, metadata)=>{
-                        if (services) {
-                            services.monitoring.captureError(error, metadata);
-                        } else {
-                            logger.error('Kernel 监控上报失败（服务尚未初始化）:', error, metadata);
-                        }
-                    },
-                    reportMetric: (name, value, tags)=>{
-                        logger.debug(`[kernel.metric] ${name}`, {
-                            value,
-                            tags,
-                            instanceId: finalInstanceId
-                        });
-                    }
-                },
-                state: {
-                    initialize: async ()=>{
-                        await ensureServicesInitialized();
-                    },
-                    getInstance: ()=>services?.stateManager ?? null
-                },
-                eventBus: {
-                    initialize: async ()=>{
-                        await ensureServicesInitialized();
-                    },
-                    emit: (event, payload)=>{
-                        if (services) {
-                            services.eventBus.emit(event, payload);
-                        }
-                    },
-                    on: (event, handler)=>{
-                        if (!services) {
-                            return ()=>{};
-                        }
-                        return services.eventBus.on(event, handler);
-                    }
-                },
-                errorHandler: {
-                    async handle (error) {
-                        logger.error('Kernel 启动阶段失败:', error);
-                        return {
-                            handled: true,
-                            shouldThrow: true
-                        };
-                    }
-                }
-            },
-            enabledPhases: {
-                init: false
-            },
-            enablePostReady: false
-        });
-        kernelTraceId = kernelRuntime.traceId;
-        const servicesInitStart = performance.now();
-        const resolvedServices = await ensureServicesInitialized();
-        const servicesInitDuration = performance.now() - servicesInitStart;
-        // 创建框架事件管理器
-        frameworkEventManager = new FrameworkEventManager(resolvedServices.eventBus);
-        // 触发应用启动事件（使用真实的事件总线）
-        frameworkEventManager.emitAppStart(finalInstanceId);
-        // 触发实例创建事件
-        frameworkEventManager.emitInstanceCreated(finalInstanceId);
-        // 4. 初始化应用实例
-        appInstance.initialize(container, resolvedServices);
-        // 5. 初始化路由管理器
-        const routerManager = getRouterManager();
-        if (options.router) {
-            await routerManager.initialize(options.router);
-        }
-        // 6. 性能追踪
-        const performanceTracker = appInstance.getPerformanceTracker();
-        if (performanceTracker) {
-            performanceTracker.recordServiceInit(servicesInitDuration);
-        }
-        // 6. 是否显示启动页
-        const shouldShowSplash = shouldShowSplashScreen(options.showSplashScreen);
-        const renderer = appInstance.getRenderer();
-        // 8. 渲染应用函数
-        const renderApp = async (context)=>{
-            const renderStart = performance.now();
-            // 触发渲染开始事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppRenderStart(finalInstanceId);
-            }
-            await renderer.renderApp(options, resolvedServices, context);
-            const renderDuration = performance.now() - renderStart;
-            // 触发渲染完成事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);
-            }
-            // 优化：在应用渲染完成后，延迟初始化非关键服务
-            // 使用 requestIdleCallback 在浏览器空闲时初始化，不影响用户体验
-            if (resolvedServices.initializeNonCriticalServices) {
-                resolvedServices.initializeNonCriticalServices().catch((error)=>{
-                    logger.warn('非关键服务初始化失败（不影响应用运行）:', error);
-                });
-            }
-            if (performanceTracker) {
-                performanceTracker.recordFirstRender(renderDuration);
-                const totalDuration = performance.now() - startTime;
-                performanceTracker.recordTotalStartup(totalDuration);
-                performanceTracker.report();
-            }
-            // 触发应用启动完成事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);
-            }
-            // 统一发出 Kernel post-ready 事件，供可观测系统消费。
-            kernelRuntime.getEventBus().emit('kernel.postReady', {
-                traceId: kernelRuntime.traceId,
-                instanceId: finalInstanceId,
-                startupDuration: performance.now() - startTime
-            });
-            // 开发模式下显示开发工具
-            if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {
-                // 延迟显示开发工具，避免影响首次渲染
-                setTimeout(()=>{
-                    const devToolsContainer = document.createElement('div');
-                    devToolsContainer.id = '__framework_dev_tools__';
-                    document.body.appendChild(devToolsContainer);
-                // 这里需要动态导入React来渲染开发工具
-                // 为了简化，暂时注释掉，后续可以完善
-                // import('react-dom/client').then(({ createRoot }) => {
-                //   const root = createRoot(devToolsContainer);
-                //   root.render(<DevToolsTrigger appInstance={appInstance} />);
-                // });
-                }, 1000);
-            }
-        };
-        if (shouldShowSplash) {
-            // 场景1: 显示启动页，初始化在启动页中完成
-            const onSplashComplete = (context)=>{
-                logger.info('启动页初始化完成');
-                // 触发初始化完成事件
-                if (frameworkEventManager) {
-                    const initDuration = context.duration || 0;
-                    frameworkEventManager.emitAppInitComplete(finalInstanceId, context, initDuration);
-                }
-                if (options.onSplashComplete) {
-                    Promise.resolve(options.onSplashComplete(()=>{
-                        logger.info('框架加载完成');
-                        renderApp(context);
-                    }, context)).catch((error)=>{
-                        logger.error('onSplashComplete 回调执行失败:', error);
-                        initializationErrorState.setError(error);
-                        renderApp(context);
-                    });
-                } else {
-                    logger.info('框架加载完成');
-                    renderApp(context);
-                }
-            };
-            // 触发初始化开始事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppInitStart(finalInstanceId);
-            }
-            // 渲染启动页
-            renderer.renderSplashScreen(options, resolvedServices, onSplashComplete);
-        } else {
-            // 场景2: 不显示启动页，直接执行初始化
-            logger.info('开始执行初始化（无启动页）');
-            // 触发初始化开始事件
-            if (frameworkEventManager) {
-                frameworkEventManager.emitAppInitStart(finalInstanceId);
-            }
-            try {
-                const initStart = performance.now();
-                // 使用中间件包装初始化函数
-                const initContext = await middlewareManager.execute(options, async ()=>{
-                    return await initialization(options, (progress, step)=>{
-                        logger.debug(`初始化进度: ${progress}%${step ? ` - ${step}` : ''}`);
-                    });
-                });
-                const initDuration = performance.now() - initStart;
-                // 触发初始化完成事件
-                if (frameworkEventManager) {
-                    frameworkEventManager.emitAppInitComplete(finalInstanceId, initContext, initDuration);
-                }
-                if (performanceTracker) {
-                    performanceTracker.recordInitialization(initDuration);
-                }
-                logger.info('初始化完成（无启动页）', initContext);
-                logger.info('框架加载完成');
-                void renderApp(initContext);
-            } catch (error) {
-                logger.error('初始化失败:', error);
-                // 触发初始化错误事件
-                if (frameworkEventManager) {
-                    frameworkEventManager.emitAppInitError(finalInstanceId, error instanceof Error ? error : new Error(String(error)));
-                }
-                initializationErrorState.setError(error);
-                void renderApp();
-            }
-        }
-        return instanceManager;
-    } catch (error) {
-        logger.error('框架启动失败:', error);
-        // 触发错误事件
-        if (frameworkEventManager) {
-            const errorInstanceId = instanceId || instanceManager.getInstance()?.id;
-            if (errorInstanceId) {
-                frameworkEventManager.emitErrorOccurred(error instanceof Error ? error : new Error(String(error)), {
-                    phase: 'startup'
-                });
-            }
-        }
-        if (kernelTraceId) {
-            logger.error('Kernel Trace 失败上下文', {
-                traceId: kernelTraceId
-            });
-        }
-        // 如果容器存在，尝试渲染错误页面
-        const container = options.container || envDetector.safeGetElement('#root');
-        if (container) {
-            const errorInstance = instanceManager.getInstance();
-            if (errorInstance && errorInstance.isInitialized()) {
-                const renderer = errorInstance.getRenderer();
-                const services = errorInstance.getServices();
-                initializationErrorState.setError(error);
-                renderer.renderError(options, services);
-            }
-        }
-        throw error;
-    }
-}
-
-//# sourceMappingURL=startApp.js.map
+import{logger}from"@vlian/logger";import{ErrorCode,InitializationError}from"@vlian/utils";import{initTraceIdGenerator,generateTraceId,setCurrentTraceId}from"../../utils/traceId";import{shouldShowSplashScreen}from"../splash";import{initialization,initializationErrorState}from"../initialization/index";import{middlewareManager}from"../middleware";import{initializeServices}from"./initializeServices";import{getAppInstanceManager}from"./AppInstance";import{getEnvironmentDetector}from"./environment";import{getRouterManager}from"../router/RouterManager";import{FrameworkEventManager}from"../event/frameworkEvents";import{startKernel}from"../kernel";export async function startApp(options={},instanceId){const startTime=performance.now();const envDetector=getEnvironmentDetector();const instanceManager=getAppInstanceManager();initTraceIdGenerator("app");const traceId=generateTraceId();setCurrentTraceId(traceId);let frameworkEventManager=null;let kernelTraceId=null;try{const container=options.container||envDetector.safeGetElement("#root");if(!container){throw new InitializationError("未找到挂载容器",undefined,{container:options.container},ErrorCode.CONTAINER_NOT_FOUND)}logger.info("框架启动中...");if(options.antd&&!options.uiProvider){logger.warn("[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider")}if(options.antdApp&&!options.uiApp){logger.warn("[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp")}const appInstance=instanceManager.createInstance(instanceId,options);const finalInstanceId=appInstance.id;let services=null;let servicesInitPromise=null;const ensureServicesInitialized=async()=>{if(services){return services}if(!servicesInitPromise){servicesInitPromise=initializeServices({...options,eventBus:{...options.eventBus,instanceId:finalInstanceId}})}services=await servicesInitPromise;return services};const kernelRuntime=await startKernel({loggerLevel:options.loggerLevel,locale:{locale:(options.locale?Object.keys(options.locale)[0]:"zh-CN")||"zh-CN",resources:options.locale},theme:{mode:options.theme?.mode||"light",primaryColor:options.theme?.primaryColor,compatibility:{antd:options.uiProvider||options.antd}},adapters:{monitoring:{initialize:async()=>{await ensureServicesInitialized()},captureError:(error,metadata)=>{if(services){services.monitoring.captureError(error,metadata)}else{logger.error("Kernel 监控上报失败（服务尚未初始化）:",error,metadata)}},reportMetric:(name,value,tags)=>{logger.debug(`[kernel.metric] ${name}`,{value,tags,instanceId:finalInstanceId})}},state:{initialize:async()=>{await ensureServicesInitialized()},getInstance:()=>services?.stateManager??null},eventBus:{initialize:async()=>{await ensureServicesInitialized()},emit:(event,payload)=>{if(services){services.eventBus.emit(event,payload)}},on:(event,handler)=>{if(!services){return()=>{}}return services.eventBus.on(event,handler)}},errorHandler:{async handle(error){logger.error("Kernel 启动阶段失败:",error);return{handled:true,shouldThrow:true}}}},enabledPhases:{init:false},enablePostReady:false});kernelTraceId=kernelRuntime.traceId;const servicesInitStart=performance.now();const resolvedServices=await ensureServicesInitialized();const servicesInitDuration=performance.now()-servicesInitStart;frameworkEventManager=new FrameworkEventManager(resolvedServices.eventBus);frameworkEventManager.emitAppStart(finalInstanceId);frameworkEventManager.emitInstanceCreated(finalInstanceId);appInstance.initialize(container,resolvedServices);const routerManager=getRouterManager();if(options.router){await routerManager.initialize(options.router)}const performanceTracker=appInstance.getPerformanceTracker();if(performanceTracker){performanceTracker.recordServiceInit(servicesInitDuration)}const shouldShowSplash=shouldShowSplashScreen(options.showSplashScreen);const renderer=appInstance.getRenderer();const renderApp=async context=>{const renderStart=performance.now();if(frameworkEventManager){frameworkEventManager.emitAppRenderStart(finalInstanceId)}await renderer.renderApp(options,resolvedServices,context);const renderDuration=performance.now()-renderStart;if(frameworkEventManager){frameworkEventManager.emitAppRenderComplete(finalInstanceId,renderDuration)}if(resolvedServices.initializeNonCriticalServices){resolvedServices.initializeNonCriticalServices().catch(error=>{logger.warn("非关键服务初始化失败（不影响应用运行）:",error)})}if(performanceTracker){performanceTracker.recordFirstRender(renderDuration);const totalDuration=performance.now()-startTime;performanceTracker.recordTotalStartup(totalDuration);performanceTracker.report()}if(frameworkEventManager){frameworkEventManager.emitAppStarted(finalInstanceId,performance.now()-startTime)}kernelRuntime.getEventBus().emit("kernel.postReady",{traceId:kernelRuntime.traceId,instanceId:finalInstanceId,startupDuration:performance.now()-startTime});if(process.env.NODE_ENV==="development"&&typeof window!=="undefined"){setTimeout(()=>{const devToolsContainer=document.createElement("div");devToolsContainer.id="__framework_dev_tools__";document.body.appendChild(devToolsContainer)},1e3)}};if(shouldShowSplash){const onSplashComplete=context=>{logger.info("启动页初始化完成");if(frameworkEventManager){const initDuration=context.duration||0;frameworkEventManager.emitAppInitComplete(finalInstanceId,context,initDuration)}if(options.onSplashComplete){Promise.resolve(options.onSplashComplete(()=>{logger.info("框架加载完成");renderApp(context)},context)).catch(error=>{logger.error("onSplashComplete 回调执行失败:",error);initializationErrorState.setError(error);renderApp(context)})}else{logger.info("框架加载完成");renderApp(context)}};if(frameworkEventManager){frameworkEventManager.emitAppInitStart(finalInstanceId)}renderer.renderSplashScreen(options,resolvedServices,onSplashComplete)}else{logger.info("开始执行初始化（无启动页）");if(frameworkEventManager){frameworkEventManager.emitAppInitStart(finalInstanceId)}try{const initStart=performance.now();const initContext=await middlewareManager.execute(options,async()=>{return await initialization(options,(progress,step)=>{logger.debug(`初始化进度: ${progress}%${step?` - ${step}`:""}`)})});const initDuration=performance.now()-initStart;if(frameworkEventManager){frameworkEventManager.emitAppInitComplete(finalInstanceId,initContext,initDuration)}if(performanceTracker){performanceTracker.recordInitialization(initDuration)}logger.info("初始化完成（无启动页）",initContext);logger.info("框架加载完成");void renderApp(initContext)}catch(error){logger.error("初始化失败:",error);if(frameworkEventManager){frameworkEventManager.emitAppInitError(finalInstanceId,error instanceof Error?error:new Error(String(error)))}initializationErrorState.setError(error);void renderApp()}}return instanceManager}catch(error){logger.error("框架启动失败:",error);if(frameworkEventManager){const errorInstanceId=instanceId||instanceManager.getInstance()?.id;if(errorInstanceId){frameworkEventManager.emitErrorOccurred(error instanceof Error?error:new Error(String(error)),{phase:"startup"})}}if(kernelTraceId){logger.error("Kernel Trace 失败上下文",{traceId:kernelTraceId})}const container=options.container||envDetector.safeGetElement("#root");if(container){const errorInstance=instanceManager.getInstance();if(errorInstance&&errorInstance.isInitialized()){const renderer=errorInstance.getRenderer();const services=errorInstance.getServices();initializationErrorState.setError(error);renderer.renderError(options,services)}}throw error}}

package/dist/core/types.cjs

@@ -1,6 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-
-//# sourceMappingURL=types.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});