@vlian/framework 1.2.61 → 1.2.63

package/dist/core/config/AppConfig.d.ts

@@ -1,88 +0,0 @@
-import type { LangType } from '../../library/locale/types';
-import type { InitializationContext } from '../initialization';
-import type { AppConfig, ThemeConfig } from '../app';
-import type { UIProviderConfig } from '../types';
-/**
- * 应用配置单例
- *
- * 用于在非 React 代码中访问全局配置
- */
-declare class AppConfigManager {
-    private static instance;
-    private _config;
-    /**
-     * 私有构造函数，防止外部直接实例化
-     */
-    private constructor();
-    /**
-     * 获取单例实例
-     *
-     * @returns 单例实例
-     */
-    static getInstance(): AppConfigManager;
-    /**
-     * 初始化配置
-     *
-     * @param config - 应用配置
-     */
-    initialize(config: Partial<AppConfig>): void;
-    /**
-     * 获取完整配置
-     *
-     * @returns 应用配置
-     */
-    getConfig(): AppConfig;
-    /**
-     * 获取主题配置
-     *
-     * @returns 主题配置
-     */
-    getTheme(): ThemeConfig;
-    /**
-     * 更新主题配置
-     *
-     * @param theme - 主题配置或更新函数
-     */
-    setTheme(theme: ThemeConfig | ((prev: ThemeConfig) => ThemeConfig)): void;
-    /**
-     * 获取当前语言
-     *
-     * @returns 当前语言
-     */
-    getLocale(): LangType;
-    /**
-     * 更新语言
-     *
-     * @param locale - 语言类型
-     */
-    setLocale(locale: LangType): void;
-    /**
-     * 获取 Ant Design 配置
-     *
-     * @returns Ant Design 配置
-     */
-    getAntdConfig(): UIProviderConfig | undefined;
-    /**
-     * 更新 Ant Design 配置
-     *
-     * @param config - Ant Design 配置
-     */
-    setAntdConfig(config: UIProviderConfig | undefined): void;
-    /**
-     * 获取初始化上下文
-     *
-     * @returns 初始化上下文
-     */
-    getInitializationContext(): InitializationContext | undefined;
-    /**
-     * 更新初始化上下文
-     *
-     * @param context - 初始化上下文
-     */
-    setInitializationContext(context: InitializationContext | undefined): void;
-}
-/**
- * 应用配置单例实例
- */
-export declare const appConfig: AppConfigManager;
-export {};

package/dist/core/config/AppConfig.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}let AppConfigManager=class AppConfigManager{static getInstance(){if(!AppConfigManager.instance){AppConfigManager.instance=new AppConfigManager}return AppConfigManager.instance}initialize(config){this._config={theme:config.theme||{mode:"light"},locale:config.locale||"zh-CN",antdConfig:config.antdConfig,initializationContext:config.initializationContext}}getConfig(){return{...this._config}}getTheme(){return{...this._config.theme}}setTheme(theme){if(typeof theme==="function"){this._config.theme=theme(this._config.theme)}else{this._config.theme={...theme}}}getLocale(){return this._config.locale}setLocale(locale){this._config.locale=locale}getAntdConfig(){return this._config.antdConfig}setAntdConfig(config){this._config.antdConfig=config}getInitializationContext(){return this._config.initializationContext}setInitializationContext(context){this._config.initializationContext=context}constructor(){_define_property(this,"_config",void 0);this._config={theme:{mode:"light"},locale:"zh-CN"}}};_define_property(AppConfigManager,"instance",null);export const appConfig=AppConfigManager.getInstance();

package/dist/core/config/ConfigLoader.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 ConfigFileFormat(){return ConfigFileFormat},get ConfigLoader(){return ConfigLoader}});const _logger=require("@vlian/logger");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}var ConfigFileFormat=/*#__PURE__*/function(ConfigFileFormat){ConfigFileFormat["JSON"]="json";ConfigFileFormat["YAML"]="yaml";return ConfigFileFormat}({});let ConfigChangeNotifier=class ConfigChangeNotifier{addListener(listener){this.listeners.add(listener);return()=>{this.listeners.delete(listener)}}removeListener(listener){this.listeners.delete(listener)}notify(newConfig,oldConfig){this.listeners.forEach(listener=>{try{listener(newConfig,oldConfig)}catch(error){_logger.logger.warn("配置变更监听器执行失败:",error)}})}clear(){this.listeners.clear()}constructor(){_define_property(this,"listeners",new Set)}};const configChangeNotifier=new ConfigChangeNotifier;let ConfigLoader=class ConfigLoader{static async loadFromJSON(path){try{if(typeof window!=="undefined"){const response=await fetch(path);if(!response.ok){throw new Error(`无法加载配置文件: ${path} (${response.status})`)}return await response.json()}if(typeof require!=="undefined"){const fs=require("fs");const content=fs.readFileSync(path,"utf-8");return JSON.parse(content)}throw new Error("不支持的环境：无法加载配置文件")}catch(error){_logger.logger.error(`加载JSON配置文件失败: ${path}`,error);throw error}}static async loadFromYAML(path){try{if(typeof window!=="undefined"){const response=await fetch(path);if(!response.ok){throw new Error(`无法加载配置文件: ${path} (${response.status})`)}const text=await response.text();if(typeof window.YAML!=="undefined"){return window.YAML.parse(text)}try{return JSON.parse(text)}catch{throw new Error("需要YAML解析库，请安装 yaml 包")}}if(typeof require!=="undefined"){const fs=require("fs");const yaml=require("yaml");const content=fs.readFileSync(path,"utf-8");return yaml.parse(content)}throw new Error("不支持的环境：无法加载配置文件")}catch(error){_logger.logger.error(`加载YAML配置文件失败: ${path}`,error);throw error}}static async loadFromFile(options){const{path,format="json",required=false,defaultConfig={}}=options;if(!path){if(required){throw new Error("配置文件路径未指定")}return defaultConfig}try{let config;switch(format){case"json":config=await this.loadFromJSON(path);break;case"yaml":config=await this.loadFromYAML(path);break;default:throw new Error(`不支持的配置文件格式: ${format}`)}_logger.logger.info(`成功加载配置文件: ${path}`);return config}catch(error){if(required){throw error}_logger.logger.warn(`配置文件加载失败，使用默认配置: ${path}`,error);return defaultConfig}}static mergeConfig(base,override){const merged={...base};for(const key in override){if(!Object.prototype.hasOwnProperty.call(override,key)){continue}const baseValue=merged[key];const overrideValue=override[key];if(baseValue&&overrideValue&&typeof baseValue==="object"&&typeof overrideValue==="object"&&!Array.isArray(baseValue)&&!Array.isArray(overrideValue)){merged[key]=this.mergeConfig(baseValue,overrideValue)}else{merged[key]=overrideValue}}return merged}static async loadFromMultipleSources(sources){let merged={};for(const source of sources){if("path"in source&&"format"in source){const fileConfig=await this.loadFromFile(source);merged=this.mergeConfig(merged,fileConfig)}else if(!("path"in source)&&!("format"in source)){merged=this.mergeConfig(merged,source)}}return merged}static loadFromEnv(prefix="FRAMEWORK_"){const config={};if(typeof process==="undefined"||!process.env){return config}for(const[key,value]of Object.entries(process.env)){if(!key.startsWith(prefix)){continue}const configKey=key.slice(prefix.length).toLowerCase().split("_").map((part,index)=>index===0?part:part.charAt(0).toUpperCase()+part.slice(1)).join("");let parsedValue=value;if(value==="true"||value==="false"){parsedValue=value==="true"}else if(!isNaN(Number(value))){parsedValue=Number(value)}else if(value?.startsWith("{")||value?.startsWith("[")){try{parsedValue=JSON.parse(value)}catch{}}config[configKey]=parsedValue}_logger.logger.debug("从环境变量加载配置:",config);return config}static async loadFromAllSources(sources=[],defaultConfig={},includeEnv=true,envPrefix="FRAMEWORK_"){const oldConfig={...defaultConfig};let merged={...defaultConfig};const fileConfigs=await this.loadFromMultipleSources(sources.filter(source=>typeof source==="object"&&"path"in source));merged=this.mergeConfig(merged,fileConfigs);if(includeEnv){const envConfig=this.loadFromEnv(envPrefix);merged=this.mergeConfig(merged,envConfig)}const codeConfigs=sources.filter(source=>typeof source==="object"&&!("path"in source));for(const codeConfig of codeConfigs){merged=this.mergeConfig(merged,codeConfig)}configChangeNotifier.notify(merged,oldConfig);return merged}static onConfigChange(listener){return configChangeNotifier.addListener(listener)}static removeConfigChangeListener(listener){configChangeNotifier.removeListener(listener)}};

package/dist/core/config/ConfigLoader.d.ts

@@ -1,118 +0,0 @@
-/**
- * 配置文件加载模块
- * 支持从JSON/YAML文件加载配置
- * 优化：支持环境变量配置、配置热更新
- */
-import type { StartOptions } from '../types';
-/**
- * 配置文件格式
- */
-export declare enum ConfigFileFormat {
-    JSON = "json",
-    YAML = "yaml"
-}
-/**
- * 配置文件加载选项
- */
-export interface ConfigFileLoadOptions {
-    /**
-     * 配置文件路径
-     */
-    path?: string;
-    /**
-     * 配置文件格式
-     */
-    format?: ConfigFileFormat;
-    /**
-     * 是否必需（如果为false，文件不存在时不报错）
-     */
-    required?: boolean;
-    /**
-     * 默认配置（文件不存在时使用）
-     */
-    defaultConfig?: Partial<StartOptions>;
-}
-/**
- * 配置变更监听器
- */
-export type ConfigChangeListener = (newConfig: Partial<StartOptions>, oldConfig: Partial<StartOptions>) => void;
-/**
- * 配置加载器
- */
-export declare class ConfigLoader {
-    /**
-     * 从JSON文件加载配置
-     *
-     * @param path - 文件路径
-     * @returns 配置对象
-     */
-    static loadFromJSON(path: string): Promise<Partial<StartOptions>>;
-    /**
-     * 从YAML文件加载配置
-     *
-     * @param path - 文件路径
-     * @returns 配置对象
-     */
-    static loadFromYAML(path: string): Promise<Partial<StartOptions>>;
-    /**
-     * 从文件加载配置
-     *
-     * @param options - 加载选项
-     * @returns 配置对象
-     */
-    static loadFromFile(options: ConfigFileLoadOptions): Promise<Partial<StartOptions>>;
-    /**
-     * 合并配置（深度合并）
-     *
-     * @param base - 基础配置
-     * @param override - 覆盖配置
-     * @returns 合并后的配置
-     */
-    static mergeConfig(base: Partial<StartOptions>, override: Partial<StartOptions>): Partial<StartOptions>;
-    /**
-     * 从多个源加载并合并配置
-     *
-     * @param sources - 配置源列表（按优先级从低到高）
-     * @returns 合并后的配置
-     */
-    static loadFromMultipleSources(sources: Array<Partial<StartOptions> | ConfigFileLoadOptions>): Promise<Partial<StartOptions>>;
-    /**
-     * 从环境变量加载配置
-     *
-     * 支持以下环境变量格式：
-     * - FRAMEWORK_LOGGER_LEVEL=DEBUG
-     * - FRAMEWORK_SHOW_SPLASH_SCREEN=always
-     * - FRAMEWORK_MIN_SPLASH_SCREEN_TIME=1000
-     *
-     * @param prefix - 环境变量前缀，默认为 'FRAMEWORK_'
-     * @returns 配置对象
-     */
-    static loadFromEnv(prefix?: string): Partial<StartOptions>;
-    /**
-     * 从多个源加载配置（包括环境变量）
-     *
-     * 优化：明确优先级，从低到高：
-     * 1. 默认配置
-     * 2. 配置文件
-     * 3. 环境变量
-     * 4. 代码配置（通过 sources 参数传入）
-     *
-     * @param sources - 配置源列表（代码配置，优先级最高）
-     * @param defaultConfig - 默认配置（优先级最低）
-     * @param includeEnv - 是否包含环境变量，默认为 true
-     * @param envPrefix - 环境变量前缀，默认为 'FRAMEWORK_'
-     * @returns 合并后的配置
-     */
-    static loadFromAllSources(sources?: Array<Partial<StartOptions> | ConfigFileLoadOptions>, defaultConfig?: Partial<StartOptions>, includeEnv?: boolean, envPrefix?: string): Promise<Partial<StartOptions>>;
-    /**
-     * 添加配置变更监听器
-     *
-     * @param listener - 配置变更监听器
-     * @returns 取消监听的函数
-     */
-    static onConfigChange(listener: ConfigChangeListener): () => void;
-    /**
-     * 移除配置变更监听器
-     */
-    static removeConfigChangeListener(listener: ConfigChangeListener): void;
-}

package/dist/core/config/ConfigLoader.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";export var ConfigFileFormat=/*#__PURE__*/function(ConfigFileFormat){ConfigFileFormat["JSON"]="json";ConfigFileFormat["YAML"]="yaml";return ConfigFileFormat}({});let ConfigChangeNotifier=class ConfigChangeNotifier{addListener(listener){this.listeners.add(listener);return()=>{this.listeners.delete(listener)}}removeListener(listener){this.listeners.delete(listener)}notify(newConfig,oldConfig){this.listeners.forEach(listener=>{try{listener(newConfig,oldConfig)}catch(error){logger.warn("配置变更监听器执行失败:",error)}})}clear(){this.listeners.clear()}constructor(){_define_property(this,"listeners",new Set)}};const configChangeNotifier=new ConfigChangeNotifier;export class ConfigLoader{static async loadFromJSON(path){try{if(typeof window!=="undefined"){const response=await fetch(path);if(!response.ok){throw new Error(`无法加载配置文件: ${path} (${response.status})`)}return await response.json()}if(typeof require!=="undefined"){const fs=require("fs");const content=fs.readFileSync(path,"utf-8");return JSON.parse(content)}throw new Error("不支持的环境：无法加载配置文件")}catch(error){logger.error(`加载JSON配置文件失败: ${path}`,error);throw error}}static async loadFromYAML(path){try{if(typeof window!=="undefined"){const response=await fetch(path);if(!response.ok){throw new Error(`无法加载配置文件: ${path} (${response.status})`)}const text=await response.text();if(typeof window.YAML!=="undefined"){return window.YAML.parse(text)}try{return JSON.parse(text)}catch{throw new Error("需要YAML解析库，请安装 yaml 包")}}if(typeof require!=="undefined"){const fs=require("fs");const yaml=require("yaml");const content=fs.readFileSync(path,"utf-8");return yaml.parse(content)}throw new Error("不支持的环境：无法加载配置文件")}catch(error){logger.error(`加载YAML配置文件失败: ${path}`,error);throw error}}static async loadFromFile(options){const{path,format="json",required=false,defaultConfig={}}=options;if(!path){if(required){throw new Error("配置文件路径未指定")}return defaultConfig}try{let config;switch(format){case"json":config=await this.loadFromJSON(path);break;case"yaml":config=await this.loadFromYAML(path);break;default:throw new Error(`不支持的配置文件格式: ${format}`)}logger.info(`成功加载配置文件: ${path}`);return config}catch(error){if(required){throw error}logger.warn(`配置文件加载失败，使用默认配置: ${path}`,error);return defaultConfig}}static mergeConfig(base,override){const merged={...base};for(const key in override){if(!Object.prototype.hasOwnProperty.call(override,key)){continue}const baseValue=merged[key];const overrideValue=override[key];if(baseValue&&overrideValue&&typeof baseValue==="object"&&typeof overrideValue==="object"&&!Array.isArray(baseValue)&&!Array.isArray(overrideValue)){merged[key]=this.mergeConfig(baseValue,overrideValue)}else{merged[key]=overrideValue}}return merged}static async loadFromMultipleSources(sources){let merged={};for(const source of sources){if("path"in source&&"format"in source){const fileConfig=await this.loadFromFile(source);merged=this.mergeConfig(merged,fileConfig)}else if(!("path"in source)&&!("format"in source)){merged=this.mergeConfig(merged,source)}}return merged}static loadFromEnv(prefix="FRAMEWORK_"){const config={};if(typeof process==="undefined"||!process.env){return config}for(const[key,value]of Object.entries(process.env)){if(!key.startsWith(prefix)){continue}const configKey=key.slice(prefix.length).toLowerCase().split("_").map((part,index)=>index===0?part:part.charAt(0).toUpperCase()+part.slice(1)).join("");let parsedValue=value;if(value==="true"||value==="false"){parsedValue=value==="true"}else if(!isNaN(Number(value))){parsedValue=Number(value)}else if(value?.startsWith("{")||value?.startsWith("[")){try{parsedValue=JSON.parse(value)}catch{}}config[configKey]=parsedValue}logger.debug("从环境变量加载配置:",config);return config}static async loadFromAllSources(sources=[],defaultConfig={},includeEnv=true,envPrefix="FRAMEWORK_"){const oldConfig={...defaultConfig};let merged={...defaultConfig};const fileConfigs=await this.loadFromMultipleSources(sources.filter(source=>typeof source==="object"&&"path"in source));merged=this.mergeConfig(merged,fileConfigs);if(includeEnv){const envConfig=this.loadFromEnv(envPrefix);merged=this.mergeConfig(merged,envConfig)}const codeConfigs=sources.filter(source=>typeof source==="object"&&!("path"in source));for(const codeConfig of codeConfigs){merged=this.mergeConfig(merged,codeConfig)}configChangeNotifier.notify(merged,oldConfig);return merged}static onConfigChange(listener){return configChangeNotifier.addListener(listener)}static removeConfigChangeListener(listener){configChangeNotifier.removeListener(listener)}}

package/dist/core/config/ConfigValidator.cjs

@@ -1,2 +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 ConfigValidationError(){return ConfigValidationError},get ConfigValidator(){return ConfigValidator}});const _zod=require("zod");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 ConfigValidationError=class ConfigValidationError extends Error{constructor(message,errors){super(message),_define_property(this,"errors",void 0),this.errors=errors;this.name="ConfigValidationError"}};let ConfigValidator=class ConfigValidator{static validate(config,schema){const result=schema.safeParse(config);if(!result.success){throw new ConfigValidationError("配置验证失败",result.error)}return result.data}static safeValidate(config,schema){const result=schema.safeParse(config);if(result.success){return{success:true,data:result.data}}return{success:false,error:result.error}}static createStartOptionsSchema(){return _zod.z.object({loggerLevel:_zod.z.enum(["DEBUG","INFO","WARN","ERROR"]).optional(),showSplashScreen:_zod.z.enum(["auto","always","never","first-time-only"]).optional(),minSplashScreenTime:_zod.z.number().positive().optional(),security:_zod.z.object({enableXSSProtection:_zod.z.boolean().optional(),validateConfig:_zod.z.boolean().optional(),sanitizeUserInput:_zod.z.boolean().optional(),csp:_zod.z.object({defaultSrc:_zod.z.array(_zod.z.string()).optional(),scriptSrc:_zod.z.array(_zod.z.string()).optional(),styleSrc:_zod.z.array(_zod.z.string()).optional(),imgSrc:_zod.z.array(_zod.z.string()).optional(),connectSrc:_zod.z.array(_zod.z.string()).optional(),fontSrc:_zod.z.array(_zod.z.string()).optional(),frameSrc:_zod.z.array(_zod.z.string()).optional(),allowUnsafeInline:_zod.z.boolean().optional(),allowUnsafeEval:_zod.z.boolean().optional()}).optional()}).optional()}).passthrough()}static validateWithFriendlyErrors(config,schema){const result=schema.safeParse(config);if(!result.success){const errorMessages=result.error.issues.map(issue=>{const path=issue.path.length>0?issue.path.join("."):"root";return`配置项 "${path}": ${issue.message}`});const friendlyMessage=`配置验证失败:
-${errorMessages.join("\n")}`;throw new ConfigValidationError(friendlyMessage,result.error)}return result.data}};

package/dist/core/config/ConfigValidator.d.ts

@@ -1,84 +0,0 @@
-/**
- * 配置验证模块
- * 使用Zod进行配置验证
- */
-import { z } from 'zod';
-/**
- * 配置验证错误
- */
-export declare class ConfigValidationError extends Error {
-    readonly errors: z.ZodError;
-    constructor(message: string, errors: z.ZodError);
-}
-/**
- * 配置验证器
- */
-export declare class ConfigValidator {
-    /**
-     * 验证配置
-     *
-     * @param config - 要验证的配置
-     * @param schema - Zod模式
-     * @returns 验证后的配置
-     * @throws ConfigValidationError 如果配置验证失败
-     */
-    static validate<T>(config: unknown, schema: z.ZodSchema<T>): T;
-    /**
-     * 安全验证配置（不抛出异常）
-     *
-     * @param config - 要验证的配置
-     * @param schema - Zod模式
-     * @returns 验证结果
-     */
-    static safeValidate<T>(config: unknown, schema: z.ZodSchema<T>): {
-        success: true;
-        data: T;
-    } | {
-        success: false;
-        error: z.ZodError;
-    };
-    /**
-     * 创建StartOptions的部分验证模式
-     * 注意：这是一个基础模式，可以根据需要扩展
-     */
-    static createStartOptionsSchema(): z.ZodObject<{
-        loggerLevel: z.ZodOptional<z.ZodEnum<{
-            DEBUG: "DEBUG";
-            INFO: "INFO";
-            WARN: "WARN";
-            ERROR: "ERROR";
-        }>>;
-        showSplashScreen: z.ZodOptional<z.ZodEnum<{
-            auto: "auto";
-            always: "always";
-            never: "never";
-            "first-time-only": "first-time-only";
-        }>>;
-        minSplashScreenTime: z.ZodOptional<z.ZodNumber>;
-        security: z.ZodOptional<z.ZodObject<{
-            enableXSSProtection: z.ZodOptional<z.ZodBoolean>;
-            validateConfig: z.ZodOptional<z.ZodBoolean>;
-            sanitizeUserInput: z.ZodOptional<z.ZodBoolean>;
-            csp: z.ZodOptional<z.ZodObject<{
-                defaultSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                scriptSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                styleSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                imgSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                connectSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                fontSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                frameSrc: z.ZodOptional<z.ZodArray<z.ZodString>>;
-                allowUnsafeInline: z.ZodOptional<z.ZodBoolean>;
-                allowUnsafeEval: z.ZodOptional<z.ZodBoolean>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
-    }, z.core.$loose>;
-    /**
-     * 验证配置并提供友好的错误信息
-     *
-     * @param config - 要验证的配置
-     * @param schema - Zod模式
-     * @returns 验证后的配置
-     * @throws ConfigValidationError 如果配置验证失败，包含详细的错误信息
-     */
-    static validateWithFriendlyErrors<T>(config: unknown, schema: z.ZodSchema<T>): T;
-}

package/dist/core/config/ConfigValidator.js

@@ -1,2 +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{z}from"zod";export class ConfigValidationError extends Error{constructor(message,errors){super(message),_define_property(this,"errors",void 0),this.errors=errors;this.name="ConfigValidationError"}}export class ConfigValidator{static validate(config,schema){const result=schema.safeParse(config);if(!result.success){throw new ConfigValidationError("配置验证失败",result.error)}return result.data}static safeValidate(config,schema){const result=schema.safeParse(config);if(result.success){return{success:true,data:result.data}}return{success:false,error:result.error}}static createStartOptionsSchema(){return z.object({loggerLevel:z.enum(["DEBUG","INFO","WARN","ERROR"]).optional(),showSplashScreen:z.enum(["auto","always","never","first-time-only"]).optional(),minSplashScreenTime:z.number().positive().optional(),security:z.object({enableXSSProtection:z.boolean().optional(),validateConfig:z.boolean().optional(),sanitizeUserInput:z.boolean().optional(),csp:z.object({defaultSrc:z.array(z.string()).optional(),scriptSrc:z.array(z.string()).optional(),styleSrc:z.array(z.string()).optional(),imgSrc:z.array(z.string()).optional(),connectSrc:z.array(z.string()).optional(),fontSrc:z.array(z.string()).optional(),frameSrc:z.array(z.string()).optional(),allowUnsafeInline:z.boolean().optional(),allowUnsafeEval:z.boolean().optional()}).optional()}).optional()}).passthrough()}static validateWithFriendlyErrors(config,schema){const result=schema.safeParse(config);if(!result.success){const errorMessages=result.error.issues.map(issue=>{const path=issue.path.length>0?issue.path.join("."):"root";return`配置项 "${path}": ${issue.message}`});const friendlyMessage=`配置验证失败:
-${errorMessages.join("\n")}`;throw new ConfigValidationError(friendlyMessage,result.error)}return result.data}}

package/dist/core/config/index.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"appConfig",{enumerable:true,get:function(){return _AppConfig.appConfig}});_export_star(require("./ConfigValidator"),exports);_export_star(require("./ConfigLoader"),exports);const _AppConfig=require("./AppConfig");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}

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

@@ -1,6 +0,0 @@
-/**
- * 配置模块统一导出
- */
-export * from './ConfigValidator';
-export * from './ConfigLoader';
-export { appConfig } from './AppConfig';

package/dist/core/config/index.js

@@ -1 +0,0 @@
-export*from"./ConfigValidator";export*from"./ConfigLoader";export{appConfig}from"./AppConfig";

package/dist/core/dev/DevTools.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 DevTools(){return DevTools},get DevToolsTrigger(){return DevToolsTrigger}});const _jsxruntime=require("react/jsx-runtime");const _react=require("react");const _app=require("../app");function toPrettyJson(value){try{return JSON.stringify(value,null,2)}catch{return String(value)}}function DevTools({appInstance,visible,onClose}){const[performanceMetrics,setPerformanceMetrics]=(0,_react.useState)({});const stateManager=(0,_app.useStateManager)();(0,_react.useEffect)(()=>{if(!visible){return}const tracker=appInstance.getPerformanceTracker();if(!tracker){return}const metrics=tracker.getMetrics();setPerformanceMetrics({serviceInitDuration:metrics.serviceInitDuration||0,initializationDuration:metrics.initializationDuration||0,firstRenderDuration:metrics.firstRenderDuration||0,totalStartupDuration:metrics.totalStartupDuration||0,fcp:metrics.fcp||0,lcp:metrics.lcp||0,fid:metrics.fid||0,cls:metrics.cls||0})},[visible,appInstance]);if(!visible){return null}const options=appInstance.getOptions();const allStates=stateManager?.getAllStates?.()||[];return(0,_jsxruntime.jsxs)("div",{style:{position:"fixed",top:0,right:0,width:"min(680px, 95vw)",height:"100vh",zIndex:9999,background:"#fff",borderLeft:"1px solid #d9e2ec",padding:16,overflowY:"auto",boxShadow:"-8px 0 20px rgba(0, 0, 0, 0.08)"},children:[(0,_jsxruntime.jsxs)("div",{style:{display:"flex",justifyContent:"space-between",alignItems:"center"},children:[(0,_jsxruntime.jsx)("h3",{style:{margin:0},children:"DevTools"}),(0,_jsxruntime.jsx)("button",{onClick:onClose,style:{border:"none",background:"transparent",cursor:"pointer"},children:"关闭"})]}),(0,_jsxruntime.jsxs)("section",{style:{marginTop:12},children:[(0,_jsxruntime.jsx)("h4",{children:"实例"}),(0,_jsxruntime.jsxs)("div",{children:["id: ",appInstance.id]}),(0,_jsxruntime.jsxs)("div",{children:["initialized: ",String(appInstance.isInitialized())]})]}),(0,_jsxruntime.jsxs)("section",{style:{marginTop:12},children:[(0,_jsxruntime.jsx)("h4",{children:"性能"}),(0,_jsxruntime.jsx)("pre",{style:{background:"#f7fafc",padding:10,borderRadius:8},children:toPrettyJson(performanceMetrics)})]}),(0,_jsxruntime.jsxs)("section",{style:{marginTop:12},children:[(0,_jsxruntime.jsx)("h4",{children:"状态管理"}),(0,_jsxruntime.jsxs)("div",{children:["stateCount: ",allStates.length]}),(0,_jsxruntime.jsx)("pre",{style:{background:"#f7fafc",padding:10,borderRadius:8},children:toPrettyJson(allStates.slice(0,10))})]}),(0,_jsxruntime.jsxs)("section",{style:{marginTop:12},children:[(0,_jsxruntime.jsx)("h4",{children:"配置"}),(0,_jsxruntime.jsx)("pre",{style:{background:"#f7fafc",padding:10,borderRadius:8,whiteSpace:"pre-wrap"},children:toPrettyJson(options)})]})]})}function resolvePosition(position){const style={position:"fixed",zIndex:9998};const pos=position||"bottom-right";if(pos.includes("bottom"))style.bottom=16;if(pos.includes("top"))style.top=16;if(pos.includes("right"))style.right=16;if(pos.includes("left"))style.left=16;return style}function DevToolsTrigger({appInstance,position="bottom-right"}){const[visible,setVisible]=(0,_react.useState)(false);if(process.env.NODE_ENV!=="development"){return null}return(0,_jsxruntime.jsxs)(_jsxruntime.Fragment,{children:[(0,_jsxruntime.jsx)("button",{onClick:()=>setVisible(true),style:{...resolvePosition(position),border:"none",background:"#2f80ed",color:"#fff",borderRadius:999,padding:"8px 14px",cursor:"pointer"},children:"DevTools"}),(0,_jsxruntime.jsx)(DevTools,{appInstance:appInstance,visible:visible,onClose:()=>setVisible(false)})]})}

package/dist/core/dev/DevTools.d.ts

@@ -1,16 +0,0 @@
-/**
- * 开发工具模块（无 UI 框架依赖）
- */
-import type { ReactNode } from 'react';
-import type { AppInstance } from '../startup/AppInstance';
-export interface DevToolsProps {
-    appInstance: AppInstance;
-    visible?: boolean;
-    onClose?: () => void;
-}
-export declare function DevTools({ appInstance, visible, onClose }: DevToolsProps): ReactNode;
-export interface DevToolsTriggerProps {
-    appInstance: AppInstance;
-    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-}
-export declare function DevToolsTrigger({ appInstance, position }: DevToolsTriggerProps): ReactNode;

package/dist/core/dev/DevTools.js

@@ -1 +0,0 @@
-import{jsx as _jsx,jsxs as _jsxs,Fragment as _Fragment}from"react/jsx-runtime";import{useState,useEffect}from"react";import{useStateManager}from"../app";function toPrettyJson(value){try{return JSON.stringify(value,null,2)}catch{return String(value)}}export function DevTools({appInstance,visible,onClose}){const[performanceMetrics,setPerformanceMetrics]=useState({});const stateManager=useStateManager();useEffect(()=>{if(!visible){return}const tracker=appInstance.getPerformanceTracker();if(!tracker){return}const metrics=tracker.getMetrics();setPerformanceMetrics({serviceInitDuration:metrics.serviceInitDuration||0,initializationDuration:metrics.initializationDuration||0,firstRenderDuration:metrics.firstRenderDuration||0,totalStartupDuration:metrics.totalStartupDuration||0,fcp:metrics.fcp||0,lcp:metrics.lcp||0,fid:metrics.fid||0,cls:metrics.cls||0})},[visible,appInstance]);if(!visible){return null}const options=appInstance.getOptions();const allStates=stateManager?.getAllStates?.()||[];return _jsxs("div",{style:{position:"fixed",top:0,right:0,width:"min(680px, 95vw)",height:"100vh",zIndex:9999,background:"#fff",borderLeft:"1px solid #d9e2ec",padding:16,overflowY:"auto",boxShadow:"-8px 0 20px rgba(0, 0, 0, 0.08)"},children:[_jsxs("div",{style:{display:"flex",justifyContent:"space-between",alignItems:"center"},children:[_jsx("h3",{style:{margin:0},children:"DevTools"}),_jsx("button",{onClick:onClose,style:{border:"none",background:"transparent",cursor:"pointer"},children:"关闭"})]}),_jsxs("section",{style:{marginTop:12},children:[_jsx("h4",{children:"实例"}),_jsxs("div",{children:["id: ",appInstance.id]}),_jsxs("div",{children:["initialized: ",String(appInstance.isInitialized())]})]}),_jsxs("section",{style:{marginTop:12},children:[_jsx("h4",{children:"性能"}),_jsx("pre",{style:{background:"#f7fafc",padding:10,borderRadius:8},children:toPrettyJson(performanceMetrics)})]}),_jsxs("section",{style:{marginTop:12},children:[_jsx("h4",{children:"状态管理"}),_jsxs("div",{children:["stateCount: ",allStates.length]}),_jsx("pre",{style:{background:"#f7fafc",padding:10,borderRadius:8},children:toPrettyJson(allStates.slice(0,10))})]}),_jsxs("section",{style:{marginTop:12},children:[_jsx("h4",{children:"配置"}),_jsx("pre",{style:{background:"#f7fafc",padding:10,borderRadius:8,whiteSpace:"pre-wrap"},children:toPrettyJson(options)})]})]})}function resolvePosition(position){const style={position:"fixed",zIndex:9998};const pos=position||"bottom-right";if(pos.includes("bottom"))style.bottom=16;if(pos.includes("top"))style.top=16;if(pos.includes("right"))style.right=16;if(pos.includes("left"))style.left=16;return style}export function DevToolsTrigger({appInstance,position="bottom-right"}){const[visible,setVisible]=useState(false);if(process.env.NODE_ENV!=="development"){return null}return _jsxs(_Fragment,{children:[_jsx("button",{onClick:()=>setVisible(true),style:{...resolvePosition(position),border:"none",background:"#2f80ed",color:"#fff",borderRadius:999,padding:"8px 14px",cursor:"pointer"},children:"DevTools"}),_jsx(DevTools,{appInstance:appInstance,visible:visible,onClose:()=>setVisible(false)})]})}

package/dist/core/error/ErrorBoundary.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 ErrorBoundary(){return ErrorBoundary},get useErrorHandler(){return useErrorHandler},get withErrorBoundary(){return withErrorBoundary}});const _jsxruntime=require("react/jsx-runtime");const _react=/*#__PURE__*/_interop_require_wildcard(require("react"));const _reacterrorboundary=require("react-error-boundary");const _logger=require("@vlian/logger");const _utils=require("@vlian/utils");const _initialization=require("../initialization");const _ErrorHandler=require("./ErrorHandler");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}function ErrorBoundary({children,fallback,onError,showInConsole=true,resetKeys,onReset,onResetKeysChange}){const retryCountRef=(0,_react.useRef)(0);const errorHandler=(0,_react.useMemo)(()=>(0,_ErrorHandler.getDefaultErrorHandler)(),[]);const handleError=(0,_react.useCallback)(async(error,errorInfo)=>{const normalizedError=_utils.errorUtils.normalizeError(error);const reactErrorInfo={componentStack:errorInfo.componentStack||""};const handleResult=await errorHandler.handleError(normalizedError,{componentStack:reactErrorInfo.componentStack,source:"ErrorBoundary"});if(!handleResult.handled){_logger.logger.error("错误边界捕获到错误:",{error:normalizedError.toJSON(),errorInfo:{componentStack:reactErrorInfo.componentStack}})}if(onError){onError(normalizedError,reactErrorInfo)}if(showInConsole){console.error("错误边界捕获到错误:",normalizedError);console.error("错误信息:",reactErrorInfo)}},[errorHandler,onError,showInConsole]);const handleReset=()=>{_initialization.initializationErrorState.clearError();if(onReset){onReset()}};const DefaultFallbackComponent=_react.default.memo(({error,resetErrorBoundary})=>{const normalizedError=_utils.errorUtils.normalizeError(error);const[retryCount,setRetryCount]=(0,_react.useState)(retryCountRef.current);const[showDetails,setShowDetails]=(0,_react.useState)(false);(0,_react.useEffect)(()=>{setRetryCount(retryCountRef.current)},[]);const handleRetry=(0,_react.useCallback)(()=>{const newCount=retryCount+1;retryCountRef.current=newCount;setRetryCount(newCount);handleReset();resetErrorBoundary()},[retryCount,resetErrorBoundary]);const handleReload=(0,_react.useCallback)(()=>{window.location.reload()},[]);const userFriendlyMessage=(0,_react.useMemo)(()=>{if(normalizedError.code==="NETWORK_ERROR"){return"网络连接失败，请检查您的网络设置后再尝试"}if(normalizedError.code==="TIMEOUT_ERROR"){return"请求超时，请稍后再尝试"}if(normalizedError.code==="VALIDATION_ERROR"){return"数据验证失败，请检查输入内容"}return"应用运行时发生了错误，请稍后再尝试"},[normalizedError.code]);const extraButtons=(0,_react.useMemo)(()=>{const buttons=[(0,_jsxruntime.jsx)("button",{onClick:handleRetry,"aria-label":"重试加载应用",style:{border:"none",background:"var(--app-primary-color, #2f80ed)",color:"#fff",borderRadius:6,padding:"8px 14px",cursor:"pointer"},children:"重试"},"retry"),(0,_jsxruntime.jsx)("button",{onClick:()=>setShowDetails(!showDetails),"aria-label":showDetails?"隐藏错误详情":"显示错误详情",style:{border:"1px solid #cfd7df",background:"#fff",color:"#1f2933",borderRadius:6,padding:"8px 14px",cursor:"pointer"},children:showDetails?"隐藏详情":"查看详情"},"details")];if(retryCount>=1){buttons.push((0,_jsxruntime.jsx)("button",{onClick:handleReload,"aria-label":"刷新页面",style:{border:"1px solid #cfd7df",background:"#fff",color:"#1f2933",borderRadius:6,padding:"8px 14px",cursor:"pointer"},children:"刷新页面"},"reload"))}return buttons},[retryCount,handleRetry,handleReload,showDetails]);return(0,_jsxruntime.jsxs)("div",{role:"alert","aria-live":"assertive","aria-atomic":"true",style:{display:"flex",flexDirection:"column",alignItems:"center",justifyContent:"center",minHeight:"100vh",padding:"24px"},children:[(0,_jsxruntime.jsxs)("div",{style:{maxWidth:580,width:"100%",textAlign:"center",border:"1px solid #dde5ec",borderRadius:10,padding:24,background:"#fff"},children:[(0,_jsxruntime.jsx)("div",{style:{fontSize:40,lineHeight:"44px"},children:"⚠️"}),(0,_jsxruntime.jsx)("h2",{style:{margin:"8px 0 4px"},children:"出错了"}),(0,_jsxruntime.jsx)("p",{style:{marginTop:0,color:"#52606d"},children:userFriendlyMessage}),(0,_jsxruntime.jsx)("div",{style:{display:"flex",gap:8,justifyContent:"center",flexWrap:"wrap"},children:extraButtons})]}),showDetails&&(0,_jsxruntime.jsxs)("div",{style:{marginTop:24,padding:16,backgroundColor:"#f5f5f5",borderRadius:4,maxWidth:800,width:"100%",maxHeight:400,overflow:"auto"},children:[(0,_jsxruntime.jsx)("div",{style:{marginBottom:8,fontWeight:"bold"},children:"错误详情："}),(0,_jsxruntime.jsxs)("div",{style:{fontFamily:"monospace",fontSize:12},children:[(0,_jsxruntime.jsxs)("div",{children:[(0,_jsxruntime.jsx)("strong",{children:"错误类型："}),normalizedError.name]}),(0,_jsxruntime.jsxs)("div",{children:[(0,_jsxruntime.jsx)("strong",{children:"错误代码："}),normalizedError.code]}),(0,_jsxruntime.jsxs)("div",{children:[(0,_jsxruntime.jsx)("strong",{children:"错误信息："}),normalizedError.message]}),normalizedError.stack&&(0,_jsxruntime.jsxs)("div",{style:{marginTop:8},children:[(0,_jsxruntime.jsx)("strong",{children:"堆栈信息："}),(0,_jsxruntime.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-word"},children:normalizedError.stack})]})]})]})]})});DefaultFallbackComponent.displayName="DefaultFallbackComponent";const defaultFallback=({error,resetErrorBoundary})=>{return(0,_jsxruntime.jsx)(DefaultFallbackComponent,{error:error,resetErrorBoundary:resetErrorBoundary})};const fallbackRender=fallback?({error,resetErrorBoundary})=>{const normalizedError=_utils.errorUtils.normalizeError(error);return fallback(normalizedError,()=>{handleReset();resetErrorBoundary()})}:defaultFallback;const handleResetWithCount=()=>{retryCountRef.current=0;handleReset()};const handleResetKeysChange=(prevKeys,nextKeys)=>{retryCountRef.current=0;if(onResetKeysChange){onResetKeysChange(prevKeys,nextKeys)}};const errorBoundaryProps={fallbackRender,onError:handleError,onReset:handleResetWithCount,resetKeys,onResetKeysChange:handleResetKeysChange};return(0,_jsxruntime.jsx)(_reacterrorboundary.ErrorBoundary,{...errorBoundaryProps,children:children})}function withErrorBoundary(Component,errorBoundaryProps){const WrappedComponent=props=>{return(0,_jsxruntime.jsx)(ErrorBoundary,{...errorBoundaryProps,children:(0,_jsxruntime.jsx)(Component,{...props})})};WrappedComponent.displayName=`withErrorBoundary(${Component.displayName||Component.name||"Component"})`;return WrappedComponent}function useErrorHandler(){return error=>{_initialization.initializationErrorState.setError(error)}}

package/dist/core/error/ErrorBoundary.d.ts

@@ -1,121 +0,0 @@
-import React, { type ReactNode, type ErrorInfo } from 'react';
-import type { FrameworkError } from '@vlian/utils';
-/**
- * 错误边界组件属性
- */
-export interface ErrorBoundaryProps {
-    /**
-     * 子组件
-     */
-    children: ReactNode;
-    /**
-     * 错误回退 UI（函数形式）
-     *
-     * 如果不提供，将使用默认错误 UI（框架内置实现，居中显示）。
-     * 如果提供，将使用自定义的错误 UI。
-     *
-     * @param error - 标准化后的框架错误对象
-     * @param resetError - 重置错误边界的函数，调用后可以尝试重新渲染子组件
-     * @returns 错误 UI 的 React 节点
-     *
-     * @example
-     * ```tsx
-     * <ErrorBoundary
-     *   fallback={(error, reset) => (
-     *     <div>
-     *       <h2>自定义错误标题</h2>
-     *       <p>{error.message}</p>
-     *       <button onClick={reset}>重试</button>
-     *     </div>
-     *   )}
-     * >
-     *   <App />
-     * </ErrorBoundary>
-     * ```
-     */
-    fallback?: (error: FrameworkError, resetError: () => void) => ReactNode;
-    /**
-     * 错误回调
-     */
-    onError?: (error: FrameworkError, errorInfo: ErrorInfo) => void;
-    /**
-     * 是否在控制台显示错误
-     */
-    showInConsole?: boolean;
-    /**
-     * 重置键数组，当这些值变化时自动重置错误边界
-     */
-    resetKeys?: Array<string | number>;
-    /**
-     * 重置错误时的回调
-     */
-    onReset?: () => void;
-    /**
-     * 重置键变化时的回调
-     */
-    onResetKeysChange?: (prevKeys: Array<string | number> | undefined, nextKeys: Array<string | number> | undefined) => void;
-}
-/**
- * 错误边界组件
- *
- * 基于 react-error-boundary 实现，集成了框架的错误处理系统
- * 用于捕获 React 组件树中的错误，防止整个应用崩溃
- *
- * 默认使用框架内置错误 UI，居中显示。
- * 可以通过 fallback 属性自定义错误 UI。
- *
- * @example
- * ```tsx
- * // 使用默认错误 UI（推荐）
- * <ErrorBoundary>
- *   <App />
- * </ErrorBoundary>
- *
- * // 自定义错误 UI
- * <ErrorBoundary
- *   fallback={(error, reset) => (
- *     <div>
- *       <h1>出错了</h1>
- *       <p>{error.message}</p>
- *       <button onClick={reset}>重试</button>
- *     </div>
- *   )}
- * >
- *   <App />
- * </ErrorBoundary>
- * ```
- */
-export declare function ErrorBoundary({ children, fallback, onError, showInConsole, resetKeys, onReset, onResetKeysChange, }: ErrorBoundaryProps): ReactNode;
-/**
- * 带错误边界的 HOC
- */
-export declare function withErrorBoundary<P extends object>(Component: React.ComponentType<P>, errorBoundaryProps?: Omit<ErrorBoundaryProps, 'children'>): React.ComponentType<P>;
-/**
- * 使用错误处理器的 Hook
- *
- * 用于在函数组件中处理异步错误
- *
- * 注意：这个 Hook 需要配合 ErrorBoundary 使用。当调用返回的错误处理函数时，
- * 错误会被设置到初始化错误状态，然后通过 InitializationErrorThrower 组件抛出。
- *
- * @example
- * ```tsx
- * import { useErrorHandler } from '@vlian/framework';
- *
- * function MyComponent() {
- *   const handleError = useErrorHandler();
- *
- *   useEffect(() => {
- *     async function fetchData() {
- *       try {
- *         await someAsyncOperation();
- *       } catch (error) {
- *         handleError(error);
- *       }
- *     }
- *     fetchData();
- *   }, [handleError]);
- * }
- * ```
- */
-export declare function useErrorHandler(): (error: unknown) => void;

package/dist/core/error/ErrorBoundary.js

@@ -1 +0,0 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import React,{useState,useRef,useEffect,useCallback,useMemo}from"react";import{ErrorBoundary as ReactErrorBoundary}from"react-error-boundary";import{logger}from"@vlian/logger";import{errorUtils}from"@vlian/utils";import{initializationErrorState}from"../initialization";import{getDefaultErrorHandler}from"./ErrorHandler";export function ErrorBoundary({children,fallback,onError,showInConsole=true,resetKeys,onReset,onResetKeysChange}){const retryCountRef=useRef(0);const errorHandler=useMemo(()=>getDefaultErrorHandler(),[]);const handleError=useCallback(async(error,errorInfo)=>{const normalizedError=errorUtils.normalizeError(error);const reactErrorInfo={componentStack:errorInfo.componentStack||""};const handleResult=await errorHandler.handleError(normalizedError,{componentStack:reactErrorInfo.componentStack,source:"ErrorBoundary"});if(!handleResult.handled){logger.error("错误边界捕获到错误:",{error:normalizedError.toJSON(),errorInfo:{componentStack:reactErrorInfo.componentStack}})}if(onError){onError(normalizedError,reactErrorInfo)}if(showInConsole){console.error("错误边界捕获到错误:",normalizedError);console.error("错误信息:",reactErrorInfo)}},[errorHandler,onError,showInConsole]);const handleReset=()=>{initializationErrorState.clearError();if(onReset){onReset()}};const DefaultFallbackComponent=React.memo(({error,resetErrorBoundary})=>{const normalizedError=errorUtils.normalizeError(error);const[retryCount,setRetryCount]=useState(retryCountRef.current);const[showDetails,setShowDetails]=useState(false);useEffect(()=>{setRetryCount(retryCountRef.current)},[]);const handleRetry=useCallback(()=>{const newCount=retryCount+1;retryCountRef.current=newCount;setRetryCount(newCount);handleReset();resetErrorBoundary()},[retryCount,resetErrorBoundary]);const handleReload=useCallback(()=>{window.location.reload()},[]);const userFriendlyMessage=useMemo(()=>{if(normalizedError.code==="NETWORK_ERROR"){return"网络连接失败，请检查您的网络设置后再尝试"}if(normalizedError.code==="TIMEOUT_ERROR"){return"请求超时，请稍后再尝试"}if(normalizedError.code==="VALIDATION_ERROR"){return"数据验证失败，请检查输入内容"}return"应用运行时发生了错误，请稍后再尝试"},[normalizedError.code]);const extraButtons=useMemo(()=>{const buttons=[_jsx("button",{onClick:handleRetry,"aria-label":"重试加载应用",style:{border:"none",background:"var(--app-primary-color, #2f80ed)",color:"#fff",borderRadius:6,padding:"8px 14px",cursor:"pointer"},children:"重试"},"retry"),_jsx("button",{onClick:()=>setShowDetails(!showDetails),"aria-label":showDetails?"隐藏错误详情":"显示错误详情",style:{border:"1px solid #cfd7df",background:"#fff",color:"#1f2933",borderRadius:6,padding:"8px 14px",cursor:"pointer"},children:showDetails?"隐藏详情":"查看详情"},"details")];if(retryCount>=1){buttons.push(_jsx("button",{onClick:handleReload,"aria-label":"刷新页面",style:{border:"1px solid #cfd7df",background:"#fff",color:"#1f2933",borderRadius:6,padding:"8px 14px",cursor:"pointer"},children:"刷新页面"},"reload"))}return buttons},[retryCount,handleRetry,handleReload,showDetails]);return _jsxs("div",{role:"alert","aria-live":"assertive","aria-atomic":"true",style:{display:"flex",flexDirection:"column",alignItems:"center",justifyContent:"center",minHeight:"100vh",padding:"24px"},children:[_jsxs("div",{style:{maxWidth:580,width:"100%",textAlign:"center",border:"1px solid #dde5ec",borderRadius:10,padding:24,background:"#fff"},children:[_jsx("div",{style:{fontSize:40,lineHeight:"44px"},children:"⚠️"}),_jsx("h2",{style:{margin:"8px 0 4px"},children:"出错了"}),_jsx("p",{style:{marginTop:0,color:"#52606d"},children:userFriendlyMessage}),_jsx("div",{style:{display:"flex",gap:8,justifyContent:"center",flexWrap:"wrap"},children:extraButtons})]}),showDetails&&_jsxs("div",{style:{marginTop:24,padding:16,backgroundColor:"#f5f5f5",borderRadius:4,maxWidth:800,width:"100%",maxHeight:400,overflow:"auto"},children:[_jsx("div",{style:{marginBottom:8,fontWeight:"bold"},children:"错误详情："}),_jsxs("div",{style:{fontFamily:"monospace",fontSize:12},children:[_jsxs("div",{children:[_jsx("strong",{children:"错误类型："}),normalizedError.name]}),_jsxs("div",{children:[_jsx("strong",{children:"错误代码："}),normalizedError.code]}),_jsxs("div",{children:[_jsx("strong",{children:"错误信息："}),normalizedError.message]}),normalizedError.stack&&_jsxs("div",{style:{marginTop:8},children:[_jsx("strong",{children:"堆栈信息："}),_jsx("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-word"},children:normalizedError.stack})]})]})]})]})});DefaultFallbackComponent.displayName="DefaultFallbackComponent";const defaultFallback=({error,resetErrorBoundary})=>{return _jsx(DefaultFallbackComponent,{error:error,resetErrorBoundary:resetErrorBoundary})};const fallbackRender=fallback?({error,resetErrorBoundary})=>{const normalizedError=errorUtils.normalizeError(error);return fallback(normalizedError,()=>{handleReset();resetErrorBoundary()})}:defaultFallback;const handleResetWithCount=()=>{retryCountRef.current=0;handleReset()};const handleResetKeysChange=(prevKeys,nextKeys)=>{retryCountRef.current=0;if(onResetKeysChange){onResetKeysChange(prevKeys,nextKeys)}};const errorBoundaryProps={fallbackRender,onError:handleError,onReset:handleResetWithCount,resetKeys,onResetKeysChange:handleResetKeysChange};return _jsx(ReactErrorBoundary,{...errorBoundaryProps,children:children})}export function withErrorBoundary(Component,errorBoundaryProps){const WrappedComponent=props=>{return _jsx(ErrorBoundary,{...errorBoundaryProps,children:_jsx(Component,{...props})})};WrappedComponent.displayName=`withErrorBoundary(${Component.displayName||Component.name||"Component"})`;return WrappedComponent}export function useErrorHandler(){return error=>{initializationErrorState.setError(error)}}

package/dist/core/error/ErrorHandler.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 ErrorHandler(){return ErrorHandler},get ErrorHandlingStrategy(){return ErrorHandlingStrategy},get getDefaultErrorHandler(){return getDefaultErrorHandler},get setDefaultErrorHandler(){return setDefaultErrorHandler}});const _logger=require("@vlian/logger");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}var ErrorHandlingStrategy=/*#__PURE__*/function(ErrorHandlingStrategy){ErrorHandlingStrategy["LOG"]="LOG";ErrorHandlingStrategy["REPORT"]="REPORT";ErrorHandlingStrategy["RECOVER"]="RECOVER";ErrorHandlingStrategy["FALLBACK"]="FALLBACK";ErrorHandlingStrategy["IGNORE"]="IGNORE";return ErrorHandlingStrategy}({});let ErrorHandler=class ErrorHandler{setMonitoring(monitoring){this.monitoring=monitoring}async handleError(error,context){const normalizedError=_utils.errorUtils.normalizeError(error);const errorWithContext=context?new _utils.FrameworkError(normalizedError.message,normalizedError.type,normalizedError.severity,{code:normalizedError.code,originalError:normalizedError.originalError,context:{...normalizedError.context,...context},recoverable:normalizedError.recoverable}):normalizedError;const strategies=this.determineStrategies(errorWithContext);const handled=await this.executeStrategies(errorWithContext,strategies);let recoveredValue;let recoverable=false;if(handled&&errorWithContext.recoverable&&this.config.recoveryOptions){const recoveryResult=await this.attemptRecovery(errorWithContext);recoverable=recoveryResult.recoverable;recoveredValue=recoveryResult.value}return{handled,recoverable,recoveredValue,strategies,error:errorWithContext}}determineStrategies(error){if(this.config.typeStrategies[error.type]){return this.config.typeStrategies[error.type]}if(this.config.severityStrategies[error.severity]){return this.config.severityStrategies[error.severity]}return this.config.defaultStrategies}async executeStrategies(error,strategies){let handled=false;for(const strategy of strategies){try{switch(strategy){case"LOG":this.logError(error);handled=true;break;case"REPORT":await this.reportError(error);handled=true;break;case"RECOVER":handled=true;break;case"FALLBACK":handled=true;break;case"IGNORE":handled=true;break}}catch(strategyError){_logger.logger.warn(`错误处理策略 ${strategy} 执行失败:`,strategyError)}}return handled}logError(error){const errorInfo=_utils.errorUtils.extractErrorInfo(error);switch(error.severity){case _utils.ErrorSeverity.CRITICAL:case _utils.ErrorSeverity.HIGH:_logger.logger.error("错误:",errorInfo);break;case _utils.ErrorSeverity.MEDIUM:_logger.logger.warn("警告:",errorInfo);break;case _utils.ErrorSeverity.LOW:_logger.logger.info("信息:",errorInfo);break}if(this.config.showDetailedErrorsInDev&&process.env.NODE_ENV==="development"){const detailedError=_utils.errorUtils.formatErrorForDev(error);console.error(detailedError)}}async reportError(error){if(!this.monitoring){_logger.logger.debug("监控服务未配置，跳过错误上报");return}try{this.monitoring.captureError(error,{severity:error.severity,type:error.type,code:error.code,context:error.context})}catch(reportError){_logger.logger.warn("错误上报失败:",reportError)}}async attemptRecovery(error){const options=this.config.recoveryOptions;if(!options){return{recoverable:false}}const maxRetries=options.maxRetries??3;const retryDelay=options.retryDelay??1e3;const exponentialBackoff=options.exponentialBackoff??true;const shouldRetry=options.shouldRetry??(()=>true);if(options.fallback){try{const fallbackValue=await Promise.resolve(options.fallback());_logger.logger.info("错误已通过降级方案恢复");return{recoverable:true,value:fallbackValue}}catch(fallbackError){_logger.logger.warn("降级方案执行失败:",fallbackError)}}if(error.recoverable&&shouldRetry(error,0)){for(let attempt=0;attempt<maxRetries;attempt++){if(!shouldRetry(error,attempt)){break}const delay=exponentialBackoff?retryDelay*Math.pow(2,attempt):retryDelay;_logger.logger.debug(`错误恢复重试 ${attempt+1}/${maxRetries}，${delay}ms 后重试...`);await new Promise(resolve=>setTimeout(resolve,delay))}}return{recoverable:error.recoverable}}static create(config){return new ErrorHandler(config)}constructor(config={}){_define_property(this,"config",void 0);_define_property(this,"monitoring",void 0);this.monitoring=config.monitoring;this.config={defaultStrategies:config.defaultStrategies??["LOG","REPORT"],severityStrategies:config.severityStrategies??{},typeStrategies:config.typeStrategies??{},recoveryOptions:config.recoveryOptions??{},showDetailedErrorsInDev:config.showDetailedErrorsInDev??true}}};let defaultErrorHandler=null;function getDefaultErrorHandler(){if(!defaultErrorHandler){defaultErrorHandler=new ErrorHandler}return defaultErrorHandler}function setDefaultErrorHandler(handler){defaultErrorHandler=handler}