@vlian/framework 1.2.61 → 1.2.63

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

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

package/dist/core/event/types.js

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

package/dist/core/event/useEventBus.cjs

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

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

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

package/dist/core/event/useEventBus.js

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

package/dist/core/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get AppContextProvider(){return _app.AppContextProvider},get DevTools(){return _DevTools.DevTools},get DevToolsTrigger(){return _DevTools.DevToolsTrigger},get ErrorBoundary(){return _error.ErrorBoundary},get MiddlewareManager(){return _middleware.MiddlewareManager},get PluginManager(){return _plugin.PluginManager},get appConfig(){return _AppConfig.appConfig},get getAppInstanceManager(){return _AppInstance.getAppInstanceManager},get getStateManager(){return getStateManager},get middlewareManager(){return _middleware.middlewareManager},get pluginManager(){return _plugin.pluginManager},get start(){return start},get startApp(){return _startApp.startApp},get storage(){return _library.storage},get useAppContext(){return _app.useAppContext},get useConfig(){return _app.useConfig},get useErrorHandler(){return _error.useErrorHandler},get useLocale(){return _app.useLocale},get useStateManager(){return _app.useStateManager},get useTheme(){return _app.useTheme},get withErrorBoundary(){return _error.withErrorBoundary}});const _library=require("../library");const _startApp=require("./startup/startApp");const _AppInstance=require("./startup/AppInstance");const _app=require("./app");const _error=require("./error");const _AppConfig=require("./config/AppConfig");const _middleware=require("./middleware");const _plugin=require("./plugin");_export_star(require("./startup"),exports);_export_star(require("./config"),exports);_export_star(require("./kernel"),exports);_export_star(require("./router"),exports);_export_star(require("./event"),exports);const _DevTools=require("./dev/DevTools");function _export_star(from,to){Object.keys(from).forEach(function(k){if(k!=="default"&&!Object.prototype.hasOwnProperty.call(to,k)){Object.defineProperty(to,k,{enumerable:true,get:function(){return from[k]}})}});return from}const start=async(options={})=>{await (0,_startApp.startApp)(options)};const getStateManager=()=>{const instanceManager=(0,_AppInstance.getAppInstanceManager)();const instance=instanceManager.getInstance();if(instance){return instance.getServices().stateManager}return null};

package/dist/core/index.d.ts

@@ -1,54 +0,0 @@
-import type { StartOptions } from "./types";
-import { storage } from '../library';
-import { StateManager } from '../state';
-/**
- * 启动框架
- *
- * @param options - 启动配置选项
- * @returns Promise<void>
- *
- * @example
- * ```typescript
- * import { start } from '@vlian/framework';
- *
- * start({
- *   loggerLevel: LogLevel.DEBUG,
- *   lifecycle: {
- *     beforeInitialization: async () => {
- *       console.log('初始化前执行');
- *     },
- *   },
- * });
- * ```
- */
-/**
- * 启动框架（向后兼容的API）
- *
- * @param options - 启动配置选项
- * @returns Promise<void>
- *
- * @deprecated 建议使用 startApp 函数，支持多实例
- */
-declare const start: (options?: StartOptions) => Promise<void>;
-export { startApp } from './startup/startApp';
-export { getAppInstanceManager } from './startup/AppInstance';
-export type { AppInstance } from './startup/AppInstance';
-export { start, storage, };
-export declare const getStateManager: () => StateManager | null;
-export { AppContextProvider, useAppContext, useTheme, useLocale, useConfig, useStateManager, } from './app';
-export { ErrorBoundary, withErrorBoundary, useErrorHandler } from './error';
-export type { ErrorBoundaryProps } from './error';
-export { appConfig } from './config/AppConfig';
-export type { InitializationContext, InitializationOptions, ProgressCallback, } from './initialization';
-export { MiddlewareManager, middlewareManager } from './middleware';
-export type { Middleware } from './middleware';
-export { PluginManager, pluginManager } from './plugin';
-export type { Plugin } from './plugin';
-export type { AppContextValue, ThemeContextValue, LocaleContextValue, ConfigContextValue, StateManagerContextValue, ThemeConfig, AppConfig, AppContextProviderProps, } from './app';
-export type { StartOptions, ManagerLifecycle, SplashScreenCustomProps } from './types';
-export * from './startup';
-export * from './config';
-export * from './kernel';
-export * from './router';
-export * from './event';
-export { DevTools, DevToolsTrigger } from './dev/DevTools';

package/dist/core/index.js

@@ -1 +0,0 @@
-import{storage}from"../library";import{startApp}from"./startup/startApp";import{getAppInstanceManager}from"./startup/AppInstance";const start=async(options={})=>{await startApp(options)};export{startApp}from"./startup/startApp";export{getAppInstanceManager}from"./startup/AppInstance";export{start,storage};export const getStateManager=()=>{const instanceManager=getAppInstanceManager();const instance=instanceManager.getInstance();if(instance){return instance.getServices().stateManager}return null};export{AppContextProvider,useAppContext,useTheme,useLocale,useConfig,useStateManager}from"./app";export{ErrorBoundary,withErrorBoundary,useErrorHandler}from"./error";export{appConfig}from"./config/AppConfig";export{MiddlewareManager,middlewareManager}from"./middleware";export{PluginManager,pluginManager}from"./plugin";export*from"./startup";export*from"./config";export*from"./kernel";export*from"./router";export*from"./event";export{DevTools,DevToolsTrigger}from"./dev/DevTools";

package/dist/core/initialization/InitializationErrorThrower.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"InitializationErrorThrower",{enumerable:true,get:function(){return InitializationErrorThrower}});const _react=/*#__PURE__*/_interop_require_wildcard(require("react"));const _initializationErrorState=require("./initializationErrorState");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 InitializationErrorThrower=()=>{const[error,setError]=(0,_react.useState)(null);(0,_react.useEffect)(()=>{const currentError=_initializationErrorState.initializationErrorState.getError();if(currentError){setError(currentError);return}const unsubscribe=_initializationErrorState.initializationErrorState.subscribe(()=>{const newError=_initializationErrorState.initializationErrorState.getError();setError(newError)});return unsubscribe},[]);if(error){throw error}return null};

package/dist/core/initialization/InitializationErrorThrower.d.ts

@@ -1,7 +0,0 @@
-import React from 'react';
-/**
- * 初始化错误抛出组件
- *
- * 当检测到初始化错误时，主动抛出错误给 ErrorBoundary 捕获
- */
-export declare const InitializationErrorThrower: React.FC;

package/dist/core/initialization/InitializationErrorThrower.js

@@ -1 +0,0 @@
-import React,{useEffect,useState}from"react";import{initializationErrorState}from"./initializationErrorState";export const InitializationErrorThrower=()=>{const[error,setError]=useState(null);useEffect(()=>{const currentError=initializationErrorState.getError();if(currentError){setError(currentError);return}const unsubscribe=initializationErrorState.subscribe(()=>{const newError=initializationErrorState.getError();setError(newError)});return unsubscribe},[]);if(error){throw error}return null};

package/dist/core/initialization/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get InitializationErrorThrower(){return _InitializationErrorThrower.InitializationErrorThrower},get initialization(){return _initialization.initialization},get initializationErrorState(){return _initializationErrorState.initializationErrorState}});const _initialization=require("./initialization");const _InitializationErrorThrower=require("./InitializationErrorThrower");const _initializationErrorState=require("./initializationErrorState");

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

@@ -1,7 +0,0 @@
-/**
- * 初始化模块统一导出
- */
-export { initialization } from './initialization';
-export type { InitializationContext, InitializationOptions, ProgressCallback, } from './initialization';
-export { InitializationErrorThrower } from './InitializationErrorThrower';
-export { initializationErrorState } from './initializationErrorState';

package/dist/core/initialization/index.js

@@ -1 +0,0 @@
-export{initialization}from"./initialization";export{InitializationErrorThrower}from"./InitializationErrorThrower";export{initializationErrorState}from"./initializationErrorState";

package/dist/core/initialization/initialization.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"initialization",{enumerable:true,get:function(){return initialization}});const _logger=require("@vlian/logger");const _library=require("../../library");const _plugin=require("../plugin");async function initialization(options,onProgress){const startTime=Date.now();let config={};try{await _plugin.pluginManager.executeBeforeInit(options);onProgress?.(5,"初始化日志系统...");_logger.logger.setLevel(options.loggerLevel??_logger.LogLevel.INFO);onProgress?.(30);if(options.lifecycle?.beforeInitialization){onProgress?.(35,"执行初始化前回调...");await options.lifecycle.beforeInitialization()}onProgress?.(40,"设置国际化...");(0,_library.setupI18n)(options.locale||undefined);if(options.lifecycle?.initialization){onProgress?.(50,"初始化核心功能...");await options.lifecycle.initialization();onProgress?.(70,"核心功能初始化完成")}else{onProgress?.(70)}onProgress?.(80,"准备完成...");const duration=Date.now()-startTime;const context={config,progress:100,isReady:true,duration};await _plugin.pluginManager.executeInit(options,context);await _plugin.pluginManager.executeAfterInit(options,context);if(options.lifecycle?.afterInitialization){onProgress?.(90,"执行初始化后回调...");await options.lifecycle.afterInitialization(context)}onProgress?.(100,"初始化完成");return context}catch(error){_logger.logger.error("初始化失败:",error);throw error}}

package/dist/core/initialization/initialization.d.ts

@@ -1,69 +0,0 @@
-import { LogLevel } from '@vlian/logger';
-import type { LangType } from '../../library/locale/types';
-import type { ManagerLifecycle, StartOptions } from '../types';
-/**
- * 初始化上下文
- */
-export interface InitializationContext {
-    /**
-     * 已加载的配置
-     */
-    config: Record<string, unknown>;
-    /**
-     * 初始化进度（0-100）
-     */
-    progress: number;
-    /**
-     * 是否准备就绪
-     */
-    isReady: boolean;
-    /**
-     * 初始化耗时（毫秒）
-     */
-    duration: number;
-}
-/**
- * 初始化选项
- */
-export interface InitializationOptions {
-    /**
-     * 日志级别
-     */
-    loggerLevel?: LogLevel;
-    /**
-     * 国际化配置
-     */
-    locale?: Record<LangType, Record<string, unknown>>;
-    /**
-     * 生命周期钩子
-     */
-    lifecycle?: ManagerLifecycle;
-}
-/**
- * 进度回调函数
- */
-export type ProgressCallback = (progress: number, step?: string) => void;
-/**
- * 初始化方法
- *
- * 这是核心的初始化逻辑，可被启动页或直接调用
- *
- * @param options - 初始化选项
- * @param onProgress - 进度回调函数（可选）
- * @returns Promise<InitializationContext>
- *
- * @example
- * ```typescript
- * const context = await initialization({
- *   loggerLevel: LogLevel.INFO,
- *   lifecycle: {
- *     initialization: async () => {
- *       // 初始化逻辑
- *     },
- *   },
- * }, (progress, step) => {
- *   console.log(`进度: ${progress}%, 步骤: ${step}`);
- * });
- * ```
- */
-export declare function initialization(options: StartOptions, onProgress?: ProgressCallback): Promise<InitializationContext>;

package/dist/core/initialization/initialization.js

@@ -1 +0,0 @@
-import{logger,LogLevel}from"@vlian/logger";import{setupI18n}from"../../library";import{pluginManager}from"../plugin";export async function initialization(options,onProgress){const startTime=Date.now();let config={};try{await pluginManager.executeBeforeInit(options);onProgress?.(5,"初始化日志系统...");logger.setLevel(options.loggerLevel??LogLevel.INFO);onProgress?.(30);if(options.lifecycle?.beforeInitialization){onProgress?.(35,"执行初始化前回调...");await options.lifecycle.beforeInitialization()}onProgress?.(40,"设置国际化...");setupI18n(options.locale||undefined);if(options.lifecycle?.initialization){onProgress?.(50,"初始化核心功能...");await options.lifecycle.initialization();onProgress?.(70,"核心功能初始化完成")}else{onProgress?.(70)}onProgress?.(80,"准备完成...");const duration=Date.now()-startTime;const context={config,progress:100,isReady:true,duration};await pluginManager.executeInit(options,context);await pluginManager.executeAfterInit(options,context);if(options.lifecycle?.afterInitialization){onProgress?.(90,"执行初始化后回调...");await options.lifecycle.afterInitialization(context)}onProgress?.(100,"初始化完成");return context}catch(error){logger.error("初始化失败:",error);throw error}}

package/dist/core/initialization/initializationErrorState.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"initializationErrorState",{enumerable:true,get:function(){return initializationErrorState}});const _utils=require("@vlian/utils");function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}let InitializationErrorState=class InitializationErrorState{setError(error){this.error=_utils.errorUtils.normalizeError(error);this.listeners.forEach(listener=>listener())}getError(){return this.error}clearError(){this.error=null;this.listeners.forEach(listener=>listener())}subscribe(listener){this.listeners.add(listener);return()=>{this.listeners.delete(listener)}}hasError(){return this.error!==null}constructor(){_define_property(this,"error",null);_define_property(this,"listeners",new Set)}};const initializationErrorState=new InitializationErrorState;

package/dist/core/initialization/initializationErrorState.d.ts

@@ -1,35 +0,0 @@
-import type { FrameworkError } from '@vlian/utils';
-/**
- * 初始化错误状态管理器
- *
- * 用于在初始化过程中捕获和存储错误，以便 ErrorBoundary 能够捕获并显示
- */
-declare class InitializationErrorState {
-    private error;
-    private listeners;
-    /**
-     * 设置错误
-     */
-    setError(error: unknown): void;
-    /**
-     * 获取错误
-     */
-    getError(): FrameworkError | null;
-    /**
-     * 清除错误
-     */
-    clearError(): void;
-    /**
-     * 订阅错误变化
-     */
-    subscribe(listener: () => void): () => void;
-    /**
-     * 检查是否有错误
-     */
-    hasError(): boolean;
-}
-/**
- * 全局初始化错误状态管理器实例
- */
-export declare const initializationErrorState: InitializationErrorState;
-export {};

package/dist/core/initialization/initializationErrorState.js

@@ -1 +0,0 @@
-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{errorUtils}from"@vlian/utils";let InitializationErrorState=class InitializationErrorState{setError(error){this.error=errorUtils.normalizeError(error);this.listeners.forEach(listener=>listener())}getError(){return this.error}clearError(){this.error=null;this.listeners.forEach(listener=>listener())}subscribe(listener){this.listeners.add(listener);return()=>{this.listeners.delete(listener)}}hasError(){return this.error!==null}constructor(){_define_property(this,"error",null);_define_property(this,"listeners",new Set)}};export const initializationErrorState=new InitializationErrorState;

package/dist/core/kernel/defaultAdapters.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"resolveKernelAdapters",{enumerable:true,get:function(){return resolveKernelAdapters}});const _logger=require("@vlian/logger");const _monitoring=require("@vlian/monitoring");const _state=require("../../state");const _AppEventBus=require("../event/AppEventBus");const _library=require("../../library");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}const defaultLoggerAdapter={initialize(options){if(options.loggerLevel){_logger.logger.setLevel(options.loggerLevel)}},setLevel(level){_logger.logger.setLevel(level)},debug(message,...args){_logger.logger.debug(message,...args)},info(message,...args){_logger.logger.info(message,...args)},warn(message,...args){_logger.logger.warn(message,...args)},error(message,...args){_logger.logger.error(message,...args)}};const defaultMonitoringAdapter={initialize(){(0,_monitoring.initMonitoring)()},captureError(error,metadata){try{const service=(0,_monitoring.initMonitoring)();service.captureError(error,metadata)}catch{_logger.logger.error("监控适配器上报失败",error,metadata)}},reportMetric(name,value,tags){_logger.logger.debug(`metric:${name}`,{value,tags})},reportPhase(metric){_logger.logger.debug("kernel.phase.metric",metric)}};let DefaultStateAdapter=class DefaultStateAdapter{initialize(){this.instance=new _state.StateManager({enableRegistry:true,defaultScope:"app"})}getInstance(){if(!this.instance){this.initialize()}return this.instance}destroy(){if(this.instance){this.instance.destroy();this.instance=null}}constructor(){_define_property(this,"instance",null)}};let DefaultEventBusAdapter=class DefaultEventBusAdapter{initialize(options){this.bus=new _AppEventBus.AppEventBus({enableTracking:process.env.NODE_ENV==="development",maxHistorySize:100,enableValidation:false,enablePerformanceMonitoring:process.env.NODE_ENV==="development",instanceId:options.instanceId})}emit(event,payload){if(!this.bus){this.initialize({})}this.bus.emit(event,payload)}on(event,handler){if(!this.bus){this.initialize({})}return this.bus.on(event,handler)}destroy(){if(this.bus){this.bus.clear();this.bus=null}}constructor(){_define_property(this,"bus",null)}};const defaultI18nAdapter={initialize(snapshot){(0,_library.setupI18n)(snapshot.resources||{});(0,_library.setLang)(snapshot.locale)},setLocale(locale){(0,_library.setLang)(locale)}};const defaultThemeAdapter={initialize(snapshot){if(typeof document==="undefined"){return}applyThemeToDocument(snapshot)},apply(snapshot){if(typeof document==="undefined"){return}applyThemeToDocument(snapshot)}};function applyThemeToDocument(theme){const root=document.documentElement;root.classList.remove("light","dark");const resolvedMode=theme.mode==="system"?window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light":theme.mode;root.classList.add(resolvedMode);if(theme.primaryColor){root.style.setProperty("--app-primary-color",theme.primaryColor)}if(theme.compatibility?.shadcn){Object.entries(theme.compatibility.shadcn).forEach(([key,value])=>{root.style.setProperty(`--${key}`,String(value))})}}const defaultErrorHandler={async handle(error){_logger.logger.error("Kernel 启动失败",error);return{handled:true,shouldThrow:true}}};function resolveKernelAdapters(options){return{logger:options.adapters?.logger||defaultLoggerAdapter,monitoring:options.adapters?.monitoring||defaultMonitoringAdapter,state:options.adapters?.state||new DefaultStateAdapter,eventBus:options.adapters?.eventBus||new DefaultEventBusAdapter,i18n:options.adapters?.i18n||defaultI18nAdapter,theme:options.adapters?.theme||defaultThemeAdapter,errorHandler:options.adapters?.errorHandler||defaultErrorHandler}}

package/dist/core/kernel/defaultAdapters.d.ts

@@ -1,2 +0,0 @@
-import type { KernelAdapters, KernelStartOptions } from './types';
-export declare function resolveKernelAdapters(options: KernelStartOptions): Required<KernelAdapters>;

package/dist/core/kernel/defaultAdapters.js

@@ -1 +0,0 @@
-function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}import{logger}from"@vlian/logger";import{initMonitoring}from"@vlian/monitoring";import{StateManager}from"../../state";import{AppEventBus}from"../event/AppEventBus";import{setupI18n,setLang}from"../../library";const defaultLoggerAdapter={initialize(options){if(options.loggerLevel){logger.setLevel(options.loggerLevel)}},setLevel(level){logger.setLevel(level)},debug(message,...args){logger.debug(message,...args)},info(message,...args){logger.info(message,...args)},warn(message,...args){logger.warn(message,...args)},error(message,...args){logger.error(message,...args)}};const defaultMonitoringAdapter={initialize(){initMonitoring()},captureError(error,metadata){try{const service=initMonitoring();service.captureError(error,metadata)}catch{logger.error("监控适配器上报失败",error,metadata)}},reportMetric(name,value,tags){logger.debug(`metric:${name}`,{value,tags})},reportPhase(metric){logger.debug("kernel.phase.metric",metric)}};let DefaultStateAdapter=class DefaultStateAdapter{initialize(){this.instance=new StateManager({enableRegistry:true,defaultScope:"app"})}getInstance(){if(!this.instance){this.initialize()}return this.instance}destroy(){if(this.instance){this.instance.destroy();this.instance=null}}constructor(){_define_property(this,"instance",null)}};let DefaultEventBusAdapter=class DefaultEventBusAdapter{initialize(options){this.bus=new AppEventBus({enableTracking:process.env.NODE_ENV==="development",maxHistorySize:100,enableValidation:false,enablePerformanceMonitoring:process.env.NODE_ENV==="development",instanceId:options.instanceId})}emit(event,payload){if(!this.bus){this.initialize({})}this.bus.emit(event,payload)}on(event,handler){if(!this.bus){this.initialize({})}return this.bus.on(event,handler)}destroy(){if(this.bus){this.bus.clear();this.bus=null}}constructor(){_define_property(this,"bus",null)}};const defaultI18nAdapter={initialize(snapshot){setupI18n(snapshot.resources||{});setLang(snapshot.locale)},setLocale(locale){setLang(locale)}};const defaultThemeAdapter={initialize(snapshot){if(typeof document==="undefined"){return}applyThemeToDocument(snapshot)},apply(snapshot){if(typeof document==="undefined"){return}applyThemeToDocument(snapshot)}};function applyThemeToDocument(theme){const root=document.documentElement;root.classList.remove("light","dark");const resolvedMode=theme.mode==="system"?window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light":theme.mode;root.classList.add(resolvedMode);if(theme.primaryColor){root.style.setProperty("--app-primary-color",theme.primaryColor)}if(theme.compatibility?.shadcn){Object.entries(theme.compatibility.shadcn).forEach(([key,value])=>{root.style.setProperty(`--${key}`,String(value))})}}const defaultErrorHandler={async handle(error){logger.error("Kernel 启动失败",error);return{handled:true,shouldThrow:true}}};export function resolveKernelAdapters(options){return{logger:options.adapters?.logger||defaultLoggerAdapter,monitoring:options.adapters?.monitoring||defaultMonitoringAdapter,state:options.adapters?.state||new DefaultStateAdapter,eventBus:options.adapters?.eventBus||new DefaultEventBusAdapter,i18n:options.adapters?.i18n||defaultI18nAdapter,theme:options.adapters?.theme||defaultThemeAdapter,errorHandler:options.adapters?.errorHandler||defaultErrorHandler}}

package/dist/core/kernel/errors.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get KernelBootError(){return KernelBootError},get toKernelBootError(){return toKernelBootError}});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 inferRetryable(error){if(error instanceof Error){const message=error.message.toLowerCase();return message.includes("timeout")||message.includes("network")}return false}let KernelBootError=class KernelBootError extends Error{constructor(message,options){super(message),_define_property(this,"code",void 0),_define_property(this,"phase",void 0),_define_property(this,"severity",void 0),_define_property(this,"retryable",void 0),_define_property(this,"traceId",void 0),_define_property(this,"cause",void 0);this.name="KernelBootError";this.code=options.code;this.phase=options.phase;this.traceId=options.traceId;this.severity=options.severity??"high";this.retryable=options.retryable??inferRetryable(options.cause);this.cause=options.cause}};function toKernelBootError(error,phase,traceId){if(error instanceof KernelBootError){return error}if(error instanceof Error){return new KernelBootError(error.message,{code:"KERNEL_BOOT_FAILURE",phase,traceId,cause:error})}return new KernelBootError(String(error),{code:"KERNEL_BOOT_FAILURE",phase,traceId,cause:error})}

package/dist/core/kernel/errors.d.ts

@@ -1,18 +0,0 @@
-import type { KernelBootErrorLike, KernelBootPhase } from './types';
-export declare class KernelBootError extends Error implements KernelBootErrorLike {
-    readonly code: string;
-    readonly phase: KernelBootPhase;
-    readonly severity: 'low' | 'medium' | 'high' | 'critical';
-    readonly retryable: boolean;
-    readonly traceId: string;
-    readonly cause?: unknown;
-    constructor(message: string, options: {
-        code: string;
-        phase: KernelBootPhase;
-        traceId: string;
-        severity?: 'low' | 'medium' | 'high' | 'critical';
-        retryable?: boolean;
-        cause?: unknown;
-    });
-}
-export declare function toKernelBootError(error: unknown, phase: KernelBootPhase, traceId: string): KernelBootError;

package/dist/core/kernel/errors.js

@@ -1 +0,0 @@
-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 inferRetryable(error){if(error instanceof Error){const message=error.message.toLowerCase();return message.includes("timeout")||message.includes("network")}return false}export class KernelBootError extends Error{constructor(message,options){super(message),_define_property(this,"code",void 0),_define_property(this,"phase",void 0),_define_property(this,"severity",void 0),_define_property(this,"retryable",void 0),_define_property(this,"traceId",void 0),_define_property(this,"cause",void 0);this.name="KernelBootError";this.code=options.code;this.phase=options.phase;this.traceId=options.traceId;this.severity=options.severity??"high";this.retryable=options.retryable??inferRetryable(options.cause);this.cause=options.cause}}export function toKernelBootError(error,phase,traceId){if(error instanceof KernelBootError){return error}if(error instanceof Error){return new KernelBootError(error.message,{code:"KERNEL_BOOT_FAILURE",phase,traceId,cause:error})}return new KernelBootError(String(error),{code:"KERNEL_BOOT_FAILURE",phase,traceId,cause:error})}

package/dist/core/kernel/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get KernelBootError(){return _errors.KernelBootError},get startKernel(){return _startKernel.startKernel}});const _startKernel=require("./startKernel");const _errors=require("./errors");

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

@@ -1,3 +0,0 @@
-export { startKernel } from './startKernel';
-export { KernelBootError } from './errors';
-export type { ThemeMode, ThemeSnapshot, I18nSnapshot, KernelBootPhase, KernelPhaseMetric, KernelBootErrorLike, KernelLoggerAdapter, KernelMonitoringAdapter, KernelStateAdapter, KernelEventBusAdapter, KernelI18nAdapter, KernelThemeAdapter, KernelErrorHandler, KernelErrorHandlerResult, KernelAdapters, KernelPerformanceOptions, KernelLifecycle, KernelStartOptions, KernelRuntime, } from './types';

package/dist/core/kernel/index.js

@@ -1 +0,0 @@
-export{startKernel}from"./startKernel";export{KernelBootError}from"./errors";

package/dist/core/kernel/startKernel.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"startKernel",{enumerable:true,get:function(){return startKernel}});const _initialization=require("../initialization");const _traceId=require("../../utils/traceId");const _errors=require("./errors");const _defaultAdapters=require("./defaultAdapters");const DEFAULT_THEME={mode:"light"};const DEFAULT_I18N={locale:"zh-CN"};async function withOptionalTimeout(task,timeoutMs,timeoutMessage="Kernel phase timeout"){if(!timeoutMs||timeoutMs<=0){return task()}return Promise.race([task(),new Promise((_,reject)=>{setTimeout(()=>reject(new Error(timeoutMessage)),timeoutMs)})])}async function startKernel(options={}){(0,_traceId.initTraceIdGenerator)("kernel");const traceId=(0,_traceId.generateTraceId)();(0,_traceId.setCurrentTraceId)(traceId);const adapters=(0,_defaultAdapters.resolveKernelAdapters)(options);const metrics=[];let config={};let theme={...DEFAULT_THEME,...options.theme||{}};let i18n={...DEFAULT_I18N,...options.locale||{}};const emitPhaseMetric=metric=>{metrics.push(metric);adapters.monitoring.reportPhase?.(metric);adapters.monitoring.reportMetric?.("kernel.phase.duration",metric.duration,{phase:metric.phase});adapters.eventBus.emit("kernel.phase.end",metric)};const runPhase=async(phase,fn)=>{const enabled=options.enabledPhases?.[phase];if(enabled===false){adapters.eventBus.emit("kernel.phase.skipped",{phase,traceId});return}const startTime=performance.now();adapters.eventBus.emit("kernel.phase.start",{phase,traceId,startTime});try{await withOptionalTimeout(fn,options.performance?.phaseTimeoutMs?.[phase],`Kernel phase "${phase}" timeout`);emitPhaseMetric({phase,startTime,endTime:performance.now(),duration:performance.now()-startTime})}catch(error){const bootError=(0,_errors.toKernelBootError)(error,phase,traceId);adapters.monitoring.captureError(bootError,{phase,traceId});adapters.eventBus.emit("kernel.phase.error",bootError);const result=await adapters.errorHandler.handle(bootError);if(result.shouldThrow){throw bootError}}};await runPhase("prepare",async()=>{adapters.logger.initialize?.(options);adapters.logger.info("Kernel 启动准备完成",{traceId})});await runPhase("services",async()=>{await Promise.all([Promise.resolve(adapters.monitoring.initialize?.(options)),Promise.resolve(adapters.state.initialize?.(options)),Promise.resolve(adapters.eventBus.initialize?.(options))])});await runPhase("config",async()=>{if(options.configLoader){try{config=await options.configLoader()}catch(error){config=options.configFallback||{}}}else{config=options.configFallback||{}}});await runPhase("i18n",async()=>{await adapters.i18n.initialize(i18n)});await runPhase("theme",async()=>{await Promise.resolve(adapters.theme.initialize?.(theme));await adapters.theme.apply(theme)});await runPhase("init",async()=>{await options.lifecycle?.beforeInitialization?.();const initContext=await (0,_initialization.initialization)({loggerLevel:options.loggerLevel,locale:i18n.resources,lifecycle:options.lifecycle});await options.lifecycle?.afterInitialization?.(initContext)});await runPhase("ready",async()=>{adapters.eventBus.emit("kernel.ready",{traceId,theme,locale:i18n.locale,config})});if(options.enablePostReady!==false){await runPhase("postReady",async()=>{adapters.eventBus.emit("kernel.postReady",{traceId})})}const setTheme=async partial=>{theme={...theme,...partial};await adapters.theme.apply(theme);adapters.eventBus.emit("kernel.theme.changed",{traceId,theme})};const setThemeMode=async mode=>{await setTheme({mode})};const setLocale=async locale=>{i18n={...i18n,locale};await adapters.i18n.setLocale(locale);adapters.eventBus.emit("kernel.i18n.changed",{traceId,locale})};return{traceId,getTheme:()=>({...theme}),setTheme,setThemeMode,getI18n:()=>({...i18n}),setLocale,getConfig:()=>({...config}),getStateManager:()=>adapters.state.getInstance(),getEventBus:()=>adapters.eventBus,getMetrics:()=>[...metrics],destroy:()=>{adapters.state.destroy?.();adapters.eventBus.destroy?.();adapters.eventBus.emit("kernel.destroyed",{traceId})}}}

package/dist/core/kernel/startKernel.d.ts

@@ -1,2 +0,0 @@
-import type { KernelRuntime, KernelStartOptions } from './types';
-export declare function startKernel(options?: KernelStartOptions): Promise<KernelRuntime>;

package/dist/core/kernel/startKernel.js

@@ -1 +0,0 @@
-import{initialization}from"../initialization";import{generateTraceId,initTraceIdGenerator,setCurrentTraceId}from"../../utils/traceId";import{toKernelBootError}from"./errors";import{resolveKernelAdapters}from"./defaultAdapters";const DEFAULT_THEME={mode:"light"};const DEFAULT_I18N={locale:"zh-CN"};async function withOptionalTimeout(task,timeoutMs,timeoutMessage="Kernel phase timeout"){if(!timeoutMs||timeoutMs<=0){return task()}return Promise.race([task(),new Promise((_,reject)=>{setTimeout(()=>reject(new Error(timeoutMessage)),timeoutMs)})])}export async function startKernel(options={}){initTraceIdGenerator("kernel");const traceId=generateTraceId();setCurrentTraceId(traceId);const adapters=resolveKernelAdapters(options);const metrics=[];let config={};let theme={...DEFAULT_THEME,...options.theme||{}};let i18n={...DEFAULT_I18N,...options.locale||{}};const emitPhaseMetric=metric=>{metrics.push(metric);adapters.monitoring.reportPhase?.(metric);adapters.monitoring.reportMetric?.("kernel.phase.duration",metric.duration,{phase:metric.phase});adapters.eventBus.emit("kernel.phase.end",metric)};const runPhase=async(phase,fn)=>{const enabled=options.enabledPhases?.[phase];if(enabled===false){adapters.eventBus.emit("kernel.phase.skipped",{phase,traceId});return}const startTime=performance.now();adapters.eventBus.emit("kernel.phase.start",{phase,traceId,startTime});try{await withOptionalTimeout(fn,options.performance?.phaseTimeoutMs?.[phase],`Kernel phase "${phase}" timeout`);emitPhaseMetric({phase,startTime,endTime:performance.now(),duration:performance.now()-startTime})}catch(error){const bootError=toKernelBootError(error,phase,traceId);adapters.monitoring.captureError(bootError,{phase,traceId});adapters.eventBus.emit("kernel.phase.error",bootError);const result=await adapters.errorHandler.handle(bootError);if(result.shouldThrow){throw bootError}}};await runPhase("prepare",async()=>{adapters.logger.initialize?.(options);adapters.logger.info("Kernel 启动准备完成",{traceId})});await runPhase("services",async()=>{await Promise.all([Promise.resolve(adapters.monitoring.initialize?.(options)),Promise.resolve(adapters.state.initialize?.(options)),Promise.resolve(adapters.eventBus.initialize?.(options))])});await runPhase("config",async()=>{if(options.configLoader){try{config=await options.configLoader()}catch(error){config=options.configFallback||{}}}else{config=options.configFallback||{}}});await runPhase("i18n",async()=>{await adapters.i18n.initialize(i18n)});await runPhase("theme",async()=>{await Promise.resolve(adapters.theme.initialize?.(theme));await adapters.theme.apply(theme)});await runPhase("init",async()=>{await options.lifecycle?.beforeInitialization?.();const initContext=await initialization({loggerLevel:options.loggerLevel,locale:i18n.resources,lifecycle:options.lifecycle});await options.lifecycle?.afterInitialization?.(initContext)});await runPhase("ready",async()=>{adapters.eventBus.emit("kernel.ready",{traceId,theme,locale:i18n.locale,config})});if(options.enablePostReady!==false){await runPhase("postReady",async()=>{adapters.eventBus.emit("kernel.postReady",{traceId})})}const setTheme=async partial=>{theme={...theme,...partial};await adapters.theme.apply(theme);adapters.eventBus.emit("kernel.theme.changed",{traceId,theme})};const setThemeMode=async mode=>{await setTheme({mode})};const setLocale=async locale=>{i18n={...i18n,locale};await adapters.i18n.setLocale(locale);adapters.eventBus.emit("kernel.i18n.changed",{traceId,locale})};return{traceId,getTheme:()=>({...theme}),setTheme,setThemeMode,getI18n:()=>({...i18n}),setLocale,getConfig:()=>({...config}),getStateManager:()=>adapters.state.getInstance(),getEventBus:()=>adapters.eventBus,getMetrics:()=>[...metrics],destroy:()=>{adapters.state.destroy?.();adapters.eventBus.destroy?.();adapters.eventBus.emit("kernel.destroyed",{traceId})}}}

package/dist/core/kernel/types.cjs

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