@vlian/framework 1.2.57 → 1.2.59

package/dist/core/startup/renderApp.js

@@ -1,267 +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 { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * 应用渲染模块
- * 负责渲染React应用
- */ import { createRoot } from "react-dom/client";
-import { StrictMode, useMemo, useCallback, memo } from "react";
-import { BasicLayout, DefaultApp, AppContextProvider } from "../app";
-import { ErrorBoundary } from "../error";
-import { InitializationErrorThrower } from "../initialization";
-import { SplashScreen } from "../splash";
-import { SecurityUtils } from "@vlian/utils";
-import { getRouterManager } from "../router/RouterManager";
-import { RouterProvider } from "react-router-dom";
-const OptimizedAppContent = /*#__PURE__*/ memo(({ options, services, context, // securityConfig 用于未来扩展，当前暂不使用
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-securityConfig: _securityConfig })=>{
-    // 优化：使用 useMemo 缓存初始语言计算
-    const initialLocale = useMemo(()=>{
-        return options.locale ? Object.keys(options.locale)[0] || 'zh-CN' : 'zh-CN';
-    }, [
-        options.locale
-    ]);
-    // 优化：使用 useMemo 缓存路由判断结果
-    const shouldUseRouter = useMemo(()=>{
-        const routerEnabled = options.router ? options.router.enabled !== false && options.router.enabled !== 'disabled' : false;
-        if (!routerEnabled) {
-            return false;
-        }
-        const routerManager = getRouterManager();
-        const router = routerManager.getRouter();
-        return router !== null;
-    }, [
-        options.router
-    ]);
-    // 优化：使用 useMemo 缓存路由实例
-    const router = useMemo(()=>{
-        if (!shouldUseRouter) {
-            return null;
-        }
-        const routerManager = getRouterManager();
-        return routerManager.getRouter();
-    }, [
-        shouldUseRouter
-    ]);
-    // 优化：使用 useCallback 缓存错误处理函数
-    const handleError = useCallback((error)=>{
-        services.monitoring.captureError(error);
-    }, [
-        services.monitoring
-    ]);
-    // 优化：使用 useMemo 缓存应用内容
-    const appContent = useMemo(()=>{
-        if (shouldUseRouter && router) {
-            return /*#__PURE__*/ _jsx(RouterProvider, {
-                router: router
-            });
-        }
-        return options.app || /*#__PURE__*/ _jsx(DefaultApp, {});
-    }, [
-        shouldUseRouter,
-        router,
-        options.app
-    ]);
-    return /*#__PURE__*/ _jsxs(ErrorBoundary, {
-        fallback: options.errorFallback,
-        onError: handleError,
-        children: [
-            /*#__PURE__*/ _jsx(InitializationErrorThrower, {}),
-            /*#__PURE__*/ _jsx(AppContextProvider, {
-                initialTheme: options.theme,
-                initialLocale: initialLocale,
-                initialAntdConfig: options.uiProvider || options.antd,
-                initialInitializationContext: context,
-                stateManager: services.stateManager,
-                antdApp: options.uiApp || options.antdApp,
-                children: /*#__PURE__*/ _jsx(BasicLayout, {
-                    globalProvider: options.globalProvider,
-                    children: appContent
-                })
-            })
-        ]
-    });
-});
-OptimizedAppContent.displayName = 'OptimizedAppContent';
-/**
- * 应用渲染器
- */ export class AppRenderer {
-    /**
-   * 初始化渲染器
-   *
-   * @param container - React应用的挂载容器
-   * @param rootOptions - React根节点配置选项
-   */ initialize(container, rootOptions) {
-        this.container = container;
-        if (!this.root) {
-            this.root = createRoot(container, rootOptions);
-        }
-    }
-    /**
-   * 渲染应用
-   *
-   * 优化：
-   * 1. 默认启用安全防护（XSS防护）
-   * 2. 优化组件渲染性能，使用 useMemo 缓存计算结果
-   * 3. 将安全配置计算提取到初始化阶段
-   *
-   * @param options - 启动配置选项
-   * @param services - 服务实例
-   * @param context - 初始化上下文（可选）
-   */ async renderApp(options, services, context) {
-        if (!this.root) {
-            throw new Error('渲染器未初始化，请先调用 initialize()');
-        }
-        // 优化：安全配置在初始化阶段计算（在 startApp 中预计算）
-        // 这里只使用预计算的值，避免在渲染时重复计算
-        const securityConfig = {
-            enableXSSProtection: options.security?.enableXSSProtection ?? true,
-            validateConfig: options.security?.validateConfig ?? true,
-            sanitizeUserInput: options.security?.sanitizeUserInput ?? true,
-            csrf: options.security?.csrf
-        };
-        // 优化：安全验证在初始化阶段完成，这里只进行必要的运行时检查
-        // 如果启用了安全模式（默认启用），对配置进行验证
-        if (securityConfig.enableXSSProtection && securityConfig.validateConfig) {
-            // 异步验证配置，不阻塞渲染
-            Promise.resolve().then(()=>{
-                try {
-                    const configStr = JSON.stringify(options);
-                    const validation = SecurityUtils.validateInput(configStr);
-                    if (!validation.safe) {
-                        services.monitoring.captureError(new Error('配置项包含不安全内容'), {
-                            reason: validation.reason
-                        });
-                    }
-                } catch (error) {
-                // 忽略序列化错误（某些配置项可能包含不可序列化的内容）
-                }
-            });
-        }
-        // 初始化 CSRF 防护（如果启用，异步执行，不阻塞渲染）
-        if (securityConfig.enableXSSProtection && securityConfig.csrf?.enabled !== false) {
-            import("@vlian/csrf").then(({ initCSRFManager })=>{
-                initCSRFManager({
-                    headerName: securityConfig.csrf?.headerName,
-                    cookieName: securityConfig.csrf?.cookieName,
-                    getToken: securityConfig.csrf?.getToken,
-                    validateToken: securityConfig.csrf?.validateToken
-                });
-            }).catch((error)=>{
-                // CSRF 初始化失败不影响应用启动，但记录警告
-                if (process.env.NODE_ENV === 'development') {
-                    console.warn('CSRF 防护初始化失败:', error);
-                }
-            });
-        }
-        // 使用优化的应用内容组件，内部使用 useMemo 缓存计算结果
-        this.root.render(/*#__PURE__*/ _jsx(StrictMode, {
-            children: /*#__PURE__*/ _jsx(OptimizedAppContent, {
-                options: options,
-                services: services,
-                context: context,
-                securityConfig: securityConfig
-            })
-        }));
-    }
-    /**
-   * 渲染启动页
-   *
-   * 注意：启动页不使用 RouterWrapper，因为启动页应该在路由系统之前渲染
-   *
-   * @param options - 启动配置选项
-   * @param services - 服务实例
-   * @param onComplete - 启动页完成回调
-   */ renderSplashScreen(options, services, onComplete) {
-        if (!this.root) {
-            throw new Error('渲染器未初始化，请先调用 initialize()');
-        }
-        // 获取初始语言（从 locale 配置中推断，或使用默认值）
-        const initialLocale = options.locale ? Object.keys(options.locale)[0] || 'zh-CN' : 'zh-CN';
-        this.root.render(/*#__PURE__*/ _jsx(StrictMode, {
-            children: /*#__PURE__*/ _jsxs(ErrorBoundary, {
-                fallback: options.errorFallback,
-                onError: (error)=>{
-                    services.monitoring.captureError(error);
-                },
-                children: [
-                    /*#__PURE__*/ _jsx(InitializationErrorThrower, {}),
-                    /*#__PURE__*/ _jsx(AppContextProvider, {
-                        initialTheme: options.theme,
-                        initialLocale: initialLocale,
-                        initialAntdConfig: options.uiProvider || options.antd,
-                        stateManager: services.stateManager,
-                        antdApp: options.uiApp || options.antdApp,
-                        children: /*#__PURE__*/ _jsx(BasicLayout, {
-                            globalProvider: options.globalProvider,
-                            children: /*#__PURE__*/ _jsx(SplashScreen, {
-                                options: options,
-                                onComplete: onComplete
-                            })
-                        })
-                    })
-                ]
-            })
-        }));
-    }
-    /**
-   * 渲染错误页面
-   *
-   * @param options - 启动配置选项
-   * @param services - 服务实例
-   * @param error - 错误信息
-   */ renderError(options, services) {
-        if (!this.root) {
-            throw new Error('渲染器未初始化，请先调用 initialize()');
-        }
-        this.root.render(/*#__PURE__*/ _jsx(StrictMode, {
-            children: /*#__PURE__*/ _jsxs(ErrorBoundary, {
-                fallback: options.errorFallback,
-                onError: (err)=>{
-                    services.monitoring.captureError(err);
-                    if (options.errorMonitor?.onError) {
-                        options.errorMonitor.onError(err);
-                    }
-                },
-                children: [
-                    /*#__PURE__*/ _jsx(InitializationErrorThrower, {}),
-                    /*#__PURE__*/ _jsx("div", {
-                        children: "框架启动失败"
-                    })
-                ]
-            })
-        }));
-    }
-    /**
-   * 销毁渲染器
-   */ destroy() {
-        if (this.root) {
-            this.root.unmount();
-            this.root = null;
-        }
-        this.container = null;
-    }
-    /**
-   * 获取容器
-   */ getContainer() {
-        return this.container;
-    }
-    constructor(){
-        _define_property(this, "root", null);
-        _define_property(this, "container", null);
-    }
-}
-
-//# sourceMappingURL=renderApp.js.map
+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{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{createRoot}from"react-dom/client";import{StrictMode,useMemo,useCallback,memo}from"react";import{BasicLayout,DefaultApp,AppContextProvider}from"../app";import{ErrorBoundary}from"../error";import{InitializationErrorThrower}from"../initialization";import{SplashScreen}from"../splash";import{SecurityUtils}from"@vlian/utils";import{getRouterManager}from"../router/RouterManager";import{RouterProvider}from"react-router-dom";const OptimizedAppContent=memo(({options,services,context,securityConfig:_securityConfig})=>{const initialLocale=useMemo(()=>{return options.locale?Object.keys(options.locale)[0]||"zh-CN":"zh-CN"},[options.locale]);const shouldUseRouter=useMemo(()=>{const routerEnabled=options.router?options.router.enabled!==false&&options.router.enabled!=="disabled":false;if(!routerEnabled){return false}const routerManager=getRouterManager();const router=routerManager.getRouter();return router!==null},[options.router]);const router=useMemo(()=>{if(!shouldUseRouter){return null}const routerManager=getRouterManager();return routerManager.getRouter()},[shouldUseRouter]);const handleError=useCallback(error=>{services.monitoring.captureError(error)},[services.monitoring]);const appContent=useMemo(()=>{if(shouldUseRouter&&router){return _jsx(RouterProvider,{router:router})}return options.app||_jsx(DefaultApp,{})},[shouldUseRouter,router,options.app]);return _jsxs(ErrorBoundary,{fallback:options.errorFallback,onError:handleError,children:[_jsx(InitializationErrorThrower,{}),_jsx(AppContextProvider,{initialTheme:options.theme,initialLocale:initialLocale,initialAntdConfig:options.uiProvider||options.antd,initialInitializationContext:context,stateManager:services.stateManager,antdApp:options.uiApp||options.antdApp,children:_jsx(BasicLayout,{globalProvider:options.globalProvider,children:appContent})})]})});OptimizedAppContent.displayName="OptimizedAppContent";export class AppRenderer{initialize(container,rootOptions){this.container=container;if(!this.root){this.root=createRoot(container,rootOptions)}}async renderApp(options,services,context){if(!this.root){throw new Error("渲染器未初始化，请先调用 initialize()")}const securityConfig={enableXSSProtection:options.security?.enableXSSProtection??true,validateConfig:options.security?.validateConfig??true,sanitizeUserInput:options.security?.sanitizeUserInput??true,csrf:options.security?.csrf};if(securityConfig.enableXSSProtection&&securityConfig.validateConfig){Promise.resolve().then(()=>{try{const configStr=JSON.stringify(options);const validation=SecurityUtils.validateInput(configStr);if(!validation.safe){services.monitoring.captureError(new Error("配置项包含不安全内容"),{reason:validation.reason})}}catch(error){}})}if(securityConfig.enableXSSProtection&&securityConfig.csrf?.enabled!==false){import("@vlian/csrf").then(({initCSRFManager})=>{initCSRFManager({headerName:securityConfig.csrf?.headerName,cookieName:securityConfig.csrf?.cookieName,getToken:securityConfig.csrf?.getToken,validateToken:securityConfig.csrf?.validateToken})}).catch(error=>{if(process.env.NODE_ENV==="development"){console.warn("CSRF 防护初始化失败:",error)}})}this.root.render(_jsx(StrictMode,{children:_jsx(OptimizedAppContent,{options:options,services:services,context:context,securityConfig:securityConfig})}))}renderSplashScreen(options,services,onComplete){if(!this.root){throw new Error("渲染器未初始化，请先调用 initialize()")}const initialLocale=options.locale?Object.keys(options.locale)[0]||"zh-CN":"zh-CN";this.root.render(_jsx(StrictMode,{children:_jsxs(ErrorBoundary,{fallback:options.errorFallback,onError:error=>{services.monitoring.captureError(error)},children:[_jsx(InitializationErrorThrower,{}),_jsx(AppContextProvider,{initialTheme:options.theme,initialLocale:initialLocale,initialAntdConfig:options.uiProvider||options.antd,stateManager:services.stateManager,antdApp:options.uiApp||options.antdApp,children:_jsx(BasicLayout,{globalProvider:options.globalProvider,children:_jsx(SplashScreen,{options:options,onComplete:onComplete})})})]})}))}renderError(options,services){if(!this.root){throw new Error("渲染器未初始化，请先调用 initialize()")}this.root.render(_jsx(StrictMode,{children:_jsxs(ErrorBoundary,{fallback:options.errorFallback,onError:err=>{services.monitoring.captureError(err);if(options.errorMonitor?.onError){options.errorMonitor.onError(err)}},children:[_jsx(InitializationErrorThrower,{}),_jsx("div",{children:"框架启动失败"})]})}))}destroy(){if(this.root){this.root.unmount();this.root=null}this.container=null}getContainer(){return this.container}constructor(){_define_property(this,"root",null);_define_property(this,"container",null)}}

package/dist/core/startup/startApp.cjs

@@ -315,5 +315,3 @@ async function startApp(options = {}, instanceId) {
         throw error;
     }
 }
-
-//# sourceMappingURL=startApp.js.map

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

@@ -2,5 +2,3 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
-
-//# sourceMappingURL=types.js.map

package/dist/core/types.js

@@ -1,5 +1 @@
-/**
- * 自定义启动屏组件的 Props
- */ export { };
-
-//# sourceMappingURL=types.js.map
+export{};

package/dist/index.cjs

@@ -50,5 +50,3 @@ function _export_star(from, to) {
     });
     return from;
 }
-
-//# sourceMappingURL=index.js.map

package/dist/index.js

@@ -1,11 +1 @@
-import { setupI18n, setLang, $t } from "./library";
-export * from "./core";
-export * from "./utils";
-export * from "./state";
-export * from "./components";
-/**
- * 国际化
- **/ export { setupI18n, setLang, $t };
-export { Kernel, startup, getKernel, kernelStartApp } from "./kernel";
-
-//# sourceMappingURL=index.js.map
+import{setupI18n,setLang,$t}from"./library";export*from"./core";export*from"./utils";export*from"./state";export*from"./components";export{setupI18n,setLang,$t};export{Kernel,startup,getKernel,kernelStartApp}from"./kernel";

package/dist/index.umd.cjs

@@ -25,5 +25,3 @@ function _export_star(from, to) {
  // 在浏览器环境中，Rollup 会将 UMD 格式的导出自动赋值给全局变量
  // 全局变量名称在 rollup.config.js 中配置为 'vlianFramework'
  // 因此最终会通过 window.vlianFramework 访问
-
-//# sourceMappingURL=index.umd.js.map