/** * 编辑器错误类型 * 用于分类不同场景下的错误 */ export declare enum EditorErrorType { /** 内容加载错误 */ CONTENT_LOAD = "CONTENT_LOAD", /** 内容保存错误 */ CONTENT_SAVE = "CONTENT_SAVE", /** 导出错误 */ EXPORT = "EXPORT", /** 导入错误 */ IMPORT = "IMPORT", /** 插件错误 */ PLUGIN = "PLUGIN", /** 渲染错误 */ RENDER = "RENDER", /** 网络错误 */ NETWORK = "NETWORK", /** 验证错误 */ VALIDATION = "VALIDATION", /** 权限错误 */ PERMISSION = "PERMISSION", /** 配置错误 */ CONFIG = "CONFIG", /** 存储错误 */ STORAGE = "STORAGE", /** AI 功能错误 */ AI = "AI", /** 未知错误 */ UNKNOWN = "UNKNOWN" } /** * 编辑器错误类 */ export declare class EditorError extends Error { type: EditorErrorType; originalError?: Error; context?: Record; constructor(message: string, type?: EditorErrorType, originalError?: Error, context?: Record); } /** * 错误处理器配置 */ export interface ErrorHandlerConfig { /** 是否在控制台输出错误 */ logToConsole?: boolean; /** 自定义错误处理函数 */ onError?: (error: EditorError) => void; } /** * 配置全局错误处理器 */ export declare function configureErrorHandler(config: ErrorHandlerConfig): void; /** * 处理编辑器错误 */ export declare function handleEditorError(error: Error | EditorError, type?: EditorErrorType, context?: Record): void; /** * 安全执行函数,捕获并处理错误 */ export declare function safeExecute(fn: () => T | Promise, errorType: EditorErrorType, errorMessage: string, context?: Record): Promise; /** * 创建错误边界包装函数 */ export declare function withErrorBoundary any>(fn: T, errorType: EditorErrorType, errorMessage: string): T; /** * 获取友好的错误消息 * @param error 编辑器错误 * @param includeDetails 是否包含详细信息 */ export declare function getFriendlyErrorMessage(error: EditorError, includeDetails?: boolean): string; /** * 获取错误详情对象 * @param error 编辑器错误 */ export declare function getErrorDetails(error: EditorError): { title: string; description: string; suggestion?: string; originalMessage?: string; }; /** * 创建带上下文的错误 * @param type 错误类型 * @param context 上下文信息 * @param originalError 原始错误 */ export declare function createEditorError(type: EditorErrorType, context?: Record, originalError?: Error): EditorError;