@vlian/framework 1.2.59 → 1.2.61

package/dist/core/startup/renderApp.cjs

@@ -1,314 +1 @@
-/**
- * 应用渲染模块
- * 负责渲染React应用
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "AppRenderer", {
-    enumerable: true,
-    get: function() {
-        return AppRenderer;
-    }
-});
-const _jsxruntime = require("react/jsx-runtime");
-const _client = require("react-dom/client");
-const _react = require("react");
-const _app = require("../app");
-const _error = require("../error");
-const _initialization = require("../initialization");
-const _splash = require("../splash");
-const _utils = require("@vlian/utils");
-const _RouterManager = require("../router/RouterManager");
-const _reactrouterdom = require("react-router-dom");
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-function _getRequireWildcardCache(nodeInterop) {
-    if (typeof WeakMap !== "function") return null;
-    var cacheBabelInterop = new WeakMap();
-    var cacheNodeInterop = new WeakMap();
-    return (_getRequireWildcardCache = function(nodeInterop) {
-        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
-    })(nodeInterop);
-}
-function _interop_require_wildcard(obj, nodeInterop) {
-    if (!nodeInterop && obj && obj.__esModule) {
-        return obj;
-    }
-    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
-        return {
-            default: obj
-        };
-    }
-    var cache = _getRequireWildcardCache(nodeInterop);
-    if (cache && cache.has(obj)) {
-        return cache.get(obj);
-    }
-    var newObj = {
-        __proto__: null
-    };
-    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
-    for(var key in obj){
-        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
-            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
-            if (desc && (desc.get || desc.set)) {
-                Object.defineProperty(newObj, key, desc);
-            } else {
-                newObj[key] = obj[key];
-            }
-        }
-    }
-    newObj.default = obj;
-    if (cache) {
-        cache.set(obj, newObj);
-    }
-    return newObj;
-}
-const OptimizedAppContent = /*#__PURE__*/ (0, _react.memo)(({ options, services, context, // securityConfig 用于未来扩展，当前暂不使用
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-securityConfig: _securityConfig })=>{
-    // 优化：使用 useMemo 缓存初始语言计算
-    const initialLocale = (0, _react.useMemo)(()=>{
-        return options.locale ? Object.keys(options.locale)[0] || 'zh-CN' : 'zh-CN';
-    }, [
-        options.locale
-    ]);
-    // 优化：使用 useMemo 缓存路由判断结果
-    const shouldUseRouter = (0, _react.useMemo)(()=>{
-        const routerEnabled = options.router ? options.router.enabled !== false && options.router.enabled !== 'disabled' : false;
-        if (!routerEnabled) {
-            return false;
-        }
-        const routerManager = (0, _RouterManager.getRouterManager)();
-        const router = routerManager.getRouter();
-        return router !== null;
-    }, [
-        options.router
-    ]);
-    // 优化：使用 useMemo 缓存路由实例
-    const router = (0, _react.useMemo)(()=>{
-        if (!shouldUseRouter) {
-            return null;
-        }
-        const routerManager = (0, _RouterManager.getRouterManager)();
-        return routerManager.getRouter();
-    }, [
-        shouldUseRouter
-    ]);
-    // 优化：使用 useCallback 缓存错误处理函数
-    const handleError = (0, _react.useCallback)((error)=>{
-        services.monitoring.captureError(error);
-    }, [
-        services.monitoring
-    ]);
-    // 优化：使用 useMemo 缓存应用内容
-    const appContent = (0, _react.useMemo)(()=>{
-        if (shouldUseRouter && router) {
-            return /*#__PURE__*/ (0, _jsxruntime.jsx)(_reactrouterdom.RouterProvider, {
-                router: router
-            });
-        }
-        return options.app || /*#__PURE__*/ (0, _jsxruntime.jsx)(_app.DefaultApp, {});
-    }, [
-        shouldUseRouter,
-        router,
-        options.app
-    ]);
-    return /*#__PURE__*/ (0, _jsxruntime.jsxs)(_error.ErrorBoundary, {
-        fallback: options.errorFallback,
-        onError: handleError,
-        children: [
-            /*#__PURE__*/ (0, _jsxruntime.jsx)(_initialization.InitializationErrorThrower, {}),
-            /*#__PURE__*/ (0, _jsxruntime.jsx)(_app.AppContextProvider, {
-                initialTheme: options.theme,
-                initialLocale: initialLocale,
-                initialAntdConfig: options.uiProvider || options.antd,
-                initialInitializationContext: context,
-                stateManager: services.stateManager,
-                antdApp: options.uiApp || options.antdApp,
-                children: /*#__PURE__*/ (0, _jsxruntime.jsx)(_app.BasicLayout, {
-                    globalProvider: options.globalProvider,
-                    children: appContent
-                })
-            })
-        ]
-    });
-});
-OptimizedAppContent.displayName = 'OptimizedAppContent';
-let AppRenderer = class AppRenderer {
-    /**
-   * 初始化渲染器
-   *
-   * @param container - React应用的挂载容器
-   * @param rootOptions - React根节点配置选项
-   */ initialize(container, rootOptions) {
-        this.container = container;
-        if (!this.root) {
-            this.root = (0, _client.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 = _utils.SecurityUtils.validateInput(configStr);
-                    if (!validation.safe) {
-                        services.monitoring.captureError(new Error('配置项包含不安全内容'), {
-                            reason: validation.reason
-                        });
-                    }
-                } catch (error) {
-                // 忽略序列化错误（某些配置项可能包含不可序列化的内容）
-                }
-            });
-        }
-        // 初始化 CSRF 防护（如果启用，异步执行，不阻塞渲染）
-        if (securityConfig.enableXSSProtection && securityConfig.csrf?.enabled !== false) {
-            Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("@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__*/ (0, _jsxruntime.jsx)(_react.StrictMode, {
-            children: /*#__PURE__*/ (0, _jsxruntime.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__*/ (0, _jsxruntime.jsx)(_react.StrictMode, {
-            children: /*#__PURE__*/ (0, _jsxruntime.jsxs)(_error.ErrorBoundary, {
-                fallback: options.errorFallback,
-                onError: (error)=>{
-                    services.monitoring.captureError(error);
-                },
-                children: [
-                    /*#__PURE__*/ (0, _jsxruntime.jsx)(_initialization.InitializationErrorThrower, {}),
-                    /*#__PURE__*/ (0, _jsxruntime.jsx)(_app.AppContextProvider, {
-                        initialTheme: options.theme,
-                        initialLocale: initialLocale,
-                        initialAntdConfig: options.uiProvider || options.antd,
-                        stateManager: services.stateManager,
-                        antdApp: options.uiApp || options.antdApp,
-                        children: /*#__PURE__*/ (0, _jsxruntime.jsx)(_app.BasicLayout, {
-                            globalProvider: options.globalProvider,
-                            children: /*#__PURE__*/ (0, _jsxruntime.jsx)(_splash.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__*/ (0, _jsxruntime.jsx)(_react.StrictMode, {
-            children: /*#__PURE__*/ (0, _jsxruntime.jsxs)(_error.ErrorBoundary, {
-                fallback: options.errorFallback,
-                onError: (err)=>{
-                    services.monitoring.captureError(err);
-                    if (options.errorMonitor?.onError) {
-                        options.errorMonitor.onError(err);
-                    }
-                },
-                children: [
-                    /*#__PURE__*/ (0, _jsxruntime.jsx)(_initialization.InitializationErrorThrower, {}),
-                    /*#__PURE__*/ (0, _jsxruntime.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);
-    }
-};
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"AppRenderer",{enumerable:true,get:function(){return AppRenderer}});const _jsxruntime=require("react/jsx-runtime");const _client=require("react-dom/client");const _react=require("react");const _app=require("../app");const _error=require("../error");const _initialization=require("../initialization");const _splash=require("../splash");const _utils=require("@vlian/utils");const _RouterManager=require("../router/RouterManager");const _reactrouterdom=require("react-router-dom");function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}function _getRequireWildcardCache(nodeInterop){if(typeof WeakMap!=="function")return null;var cacheBabelInterop=new WeakMap;var cacheNodeInterop=new WeakMap;return(_getRequireWildcardCache=function(nodeInterop){return nodeInterop?cacheNodeInterop:cacheBabelInterop})(nodeInterop)}function _interop_require_wildcard(obj,nodeInterop){if(!nodeInterop&&obj&&obj.__esModule){return obj}if(obj===null||typeof obj!=="object"&&typeof obj!=="function"){return{default:obj}}var cache=_getRequireWildcardCache(nodeInterop);if(cache&&cache.has(obj)){return cache.get(obj)}var newObj={__proto__:null};var hasPropertyDescriptor=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var key in obj){if(key!=="default"&&Object.prototype.hasOwnProperty.call(obj,key)){var desc=hasPropertyDescriptor?Object.getOwnPropertyDescriptor(obj,key):null;if(desc&&(desc.get||desc.set)){Object.defineProperty(newObj,key,desc)}else{newObj[key]=obj[key]}}}newObj.default=obj;if(cache){cache.set(obj,newObj)}return newObj}const OptimizedAppContent=(0,_react.memo)(({options,services,context,securityConfig:_securityConfig})=>{const initialLocale=(0,_react.useMemo)(()=>{return options.locale?Object.keys(options.locale)[0]||"zh-CN":"zh-CN"},[options.locale]);const shouldUseRouter=(0,_react.useMemo)(()=>{const routerEnabled=options.router?options.router.enabled!==false&&options.router.enabled!=="disabled":false;if(!routerEnabled){return false}const routerManager=(0,_RouterManager.getRouterManager)();const router=routerManager.getRouter();return router!==null},[options.router]);const router=(0,_react.useMemo)(()=>{if(!shouldUseRouter){return null}const routerManager=(0,_RouterManager.getRouterManager)();return routerManager.getRouter()},[shouldUseRouter]);const handleError=(0,_react.useCallback)(error=>{services.monitoring.captureError(error)},[services.monitoring]);const appContent=(0,_react.useMemo)(()=>{if(shouldUseRouter&&router){return(0,_jsxruntime.jsx)(_reactrouterdom.RouterProvider,{router:router})}return options.app||(0,_jsxruntime.jsx)(_app.DefaultApp,{})},[shouldUseRouter,router,options.app]);return(0,_jsxruntime.jsxs)(_error.ErrorBoundary,{fallback:options.errorFallback,onError:handleError,children:[(0,_jsxruntime.jsx)(_initialization.InitializationErrorThrower,{}),(0,_jsxruntime.jsx)(_app.AppContextProvider,{initialTheme:options.theme,initialLocale:initialLocale,initialAntdConfig:options.uiProvider||options.antd,initialInitializationContext:context,stateManager:services.stateManager,antdApp:options.uiApp||options.antdApp,children:(0,_jsxruntime.jsx)(_app.BasicLayout,{globalProvider:options.globalProvider,children:appContent})})]})});OptimizedAppContent.displayName="OptimizedAppContent";let AppRenderer=class AppRenderer{initialize(container,rootOptions){this.container=container;if(!this.root){this.root=(0,_client.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=_utils.SecurityUtils.validateInput(configStr);if(!validation.safe){services.monitoring.captureError(new Error("配置项包含不安全内容"),{reason:validation.reason})}}catch(error){}})}if(securityConfig.enableXSSProtection&&securityConfig.csrf?.enabled!==false){Promise.resolve().then(()=>/*#__PURE__*/_interop_require_wildcard(require("@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((0,_jsxruntime.jsx)(_react.StrictMode,{children:(0,_jsxruntime.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((0,_jsxruntime.jsx)(_react.StrictMode,{children:(0,_jsxruntime.jsxs)(_error.ErrorBoundary,{fallback:options.errorFallback,onError:error=>{services.monitoring.captureError(error)},children:[(0,_jsxruntime.jsx)(_initialization.InitializationErrorThrower,{}),(0,_jsxruntime.jsx)(_app.AppContextProvider,{initialTheme:options.theme,initialLocale:initialLocale,initialAntdConfig:options.uiProvider||options.antd,stateManager:services.stateManager,antdApp:options.uiApp||options.antdApp,children:(0,_jsxruntime.jsx)(_app.BasicLayout,{globalProvider:options.globalProvider,children:(0,_jsxruntime.jsx)(_splash.SplashScreen,{options:options,onComplete:onComplete})})})]})}))}renderError(options,services){if(!this.root){throw new Error("渲染器未初始化，请先调用 initialize()")}this.root.render((0,_jsxruntime.jsx)(_react.StrictMode,{children:(0,_jsxruntime.jsxs)(_error.ErrorBoundary,{fallback:options.errorFallback,onError:err=>{services.monitoring.captureError(err);if(options.errorMonitor?.onError){options.errorMonitor.onError(err)}},children:[(0,_jsxruntime.jsx)(_initialization.InitializationErrorThrower,{}),(0,_jsxruntime.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

@@ -1,317 +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;
-    }
-}
+"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/types.cjs

@@ -1,4 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});