@lytjs/core 6.9.2 → 6.9.3

package/dist/index.d.cts

@@ -0,0 +1,1556 @@
+import { VNode, Fragment, Text, Comment, VNodeChildren } from '@lytjs/vdom';
+export { Comment, Fragment, Text, VNode, VNodeChildren, cloneVNode, createVNode, mergeProps } from '@lytjs/vdom';
+import { BaseAppConfig, Directive, DebuggerEvent, DirectiveArguments } from '@lytjs/shared-types';
+export { DebuggerEvent, Directive, DirectiveArguments, DirectiveBinding, Renderer } from '@lytjs/shared-types';
+import { ComponentPublicInstance, ComponentOptions, InternalSlots } from '@lytjs/component';
+export { ComponentOptions, ComponentPublicInstance, onActivated, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactivated, onErrorCaptured, onMounted, onRenderTracked, onRenderTriggered, onUnmounted, onUpdated } from '@lytjs/component';
+export { nextTick } from '@lytjs/common-scheduler';
+import { WritableComputedRef, Ref } from '@lytjs/reactivity';
+export { computed, effect, reactive, ref, watch, watchEffect } from '@lytjs/reactivity';
+export { compile } from '@lytjs/compiler';
+
+/**
+ * 配置 Schema 类型
+ * @description JSON Schema 风格的结构化配置验证
+ */
+/** Schema 类型枚举 */
+type SchemaType = 'string' | 'number' | 'boolean' | 'object' | 'array' | 'enum' | 'union';
+/** JSON Schema 风格的配置 Schema */
+interface ConfigSchema<T = unknown> {
+    /** Schema 类型 */
+    type: SchemaType;
+    /** 字段描述（用于文档生成） */
+    description?: string;
+    /** 默认值 */
+    default?: T;
+    /** 是否必填 */
+    required?: boolean;
+    /** 是否可为空 */
+    nullable?: boolean;
+    /** 字符串验证 */
+    string?: StringSchema;
+    /** 数字验证 */
+    number?: NumberSchema;
+    /** 布尔验证 */
+    boolean?: BooleanSchema;
+    /** 对象验证 */
+    object?: ObjectSchema<T>;
+    /** 数组验证 */
+    array?: ArraySchema;
+    /** 枚举验证 */
+    enum?: EnumSchema<T>;
+    /** 联合类型验证 */
+    union?: UnionSchema;
+    /** 自定义验证函数 */
+    validate?: (value: T, context: ValidationContext$1) => ValidationResult;
+    /** 转换函数（用于预处理用户输入） */
+    transform?: (value: unknown) => T;
+}
+/** 字符串 Schema */
+interface StringSchema {
+    /** 最小长度 */
+    minLength?: number;
+    /** 最大长度 */
+    maxLength?: number;
+    /** 正则表达式模式 */
+    pattern?: string | RegExp;
+    /** 格式校验 */
+    format?: StringFormat;
+    /** 枚举值 */
+    enum?: string[];
+}
+/** 字符串格式 */
+type StringFormat = 'date' | 'time' | 'date-time' | 'email' | 'url' | 'uri' | 'uuid' | 'semver';
+/** 数字 Schema */
+interface NumberSchema {
+    /** 最小值 */
+    minimum?: number;
+    /** 最大值 */
+    maximum?: number;
+    /** 排除最小值 */
+    exclusiveMinimum?: number;
+    /** 排除最大值 */
+    exclusiveMaximum?: number;
+    /** 必须为整数 */
+    integer?: boolean;
+    /** 枚举值 */
+    enum?: number[];
+}
+/** 布尔 Schema */
+interface BooleanSchema {
+    /** 默认值时的说明 */
+    defaultDescription?: string;
+}
+/** 对象 Schema */
+interface ObjectSchema<T = unknown> {
+    /** 属性定义 */
+    properties: Record<string, ConfigSchema>;
+    /** 必需属性 */
+    required?: string[];
+    /** 额外属性是否允许 */
+    additionalProperties?: boolean;
+    /** 属性名模式 */
+    patternProperties?: Record<string, ConfigSchema>;
+    /** 最大属性数 */
+    maxProperties?: number;
+    /** 最小属性数 */
+    minProperties?: number;
+    /** 对象级别验证 */
+    validate?: (obj: T, context: ValidationContext$1) => ValidationResult;
+}
+/** 数组 Schema */
+interface ArraySchema {
+    /** 元素类型 */
+    items?: ConfigSchema;
+    /** 元组类型（固定长度） */
+    tuple?: ConfigSchema[];
+    /** 最少元素数 */
+    minItems?: number;
+    /** 最多元素数 */
+    maxItems?: number;
+    /** 是否允许重复 */
+    uniqueItems?: boolean;
+}
+/** 枚举 Schema */
+interface EnumSchema<T = unknown> {
+    /** 允许的值 */
+    values: T[];
+    /** 默认值 */
+    default?: T;
+}
+/** 联合类型 Schema */
+interface UnionSchema {
+    /** 可选的类型 */
+    anyOf: ConfigSchema[];
+    /** 精确匹配类型 */
+    oneOf?: ConfigSchema[];
+    /** 不允许的类型 */
+    not?: ConfigSchema;
+}
+/** 验证上下文 */
+interface ValidationContext$1 {
+    /** 当前路径（用于错误报告） */
+    path: string;
+    /** 根对象 */
+    root: unknown;
+    /** 自定义数据 */
+    data?: Record<string, unknown>;
+}
+/** 验证结果 */
+interface ValidationResult {
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误信息 */
+    message?: string;
+    /** 错误路径 */
+    path?: string;
+}
+/** 验证错误 */
+interface ConfigValidationError {
+    /** 错误路径 */
+    path: string;
+    /** 错误消息 */
+    message: string;
+    /** 期望的值类型 */
+    expected?: string;
+    /** 实际的值 */
+    actual?: unknown;
+    /** 错误代码 */
+    code: ValidationErrorCode;
+}
+/** 验证错误代码 */
+type ValidationErrorCode = 'type_error' | 'required' | 'enum_mismatch' | 'pattern_mismatch' | 'format_error' | 'min_length' | 'max_length' | 'minimum' | 'maximum' | 'min_items' | 'max_items' | 'unique_items' | 'additional_properties' | 'custom_error';
+/** 配置验证报告 */
+interface ConfigValidationReport {
+    /** 是否有效 */
+    valid: boolean;
+    /** 错误列表 */
+    errors: ConfigValidationError[];
+    /** 错误数量 */
+    errorCount: number;
+    /** 警告数量 */
+    warningCount: number;
+}
+/** 配置转换报告 */
+interface ConfigTransformReport<T = unknown> {
+    /** 转换后的配置 */
+    config: T;
+    /** 是否成功 */
+    success: boolean;
+    /** 错误列表 */
+    errors: ConfigValidationError[];
+    /** 警告列表 */
+    warnings: string[];
+    /** 应用的转换 */
+    transforms: string[];
+}
+
+/**
+ * 插件注册表
+ * @description 管理插件的注册、注销、查询和依赖关系
+ *
+ * @example
+ * ```typescript
+ * const registry = new PluginRegistry();
+ *
+ * // 注册插件
+ * registry.register(myPlugin, { theme: 'dark' });
+ *
+ * // 查询插件
+ * const plugin = registry.get('my-plugin');
+ *
+ * // 检查依赖
+ * const result = registry.checkDependencies(anotherPlugin);
+ *
+ * // 监听事件
+ * registry.on('after:install', (event, data) => {
+ *   console.log(`Plugin ${data.name} installed`);
+ * });
+ * ```
+ */
+declare class PluginRegistry {
+    /** 已注册插件映射（name → RegisteredPlugin） */
+    private plugins;
+    /** 事件监听器映射 */
+    private listeners;
+    constructor();
+    /**
+     * 注册插件
+     * @param plugin - 插件实例（EnhancedPlugin 或基础 Plugin）
+     * @param options - 安装选项
+     * @returns 注册结果
+     */
+    register(plugin: EnhancedPlugin | Plugin, options?: unknown): RegistrationResult;
+    /**
+     * 注销插件
+     * @param name - 插件名称
+     * @returns 是否成功注销
+     */
+    unregister(name: string): boolean;
+    /**
+     * 获取已注册插件信息
+     * @param name - 插件名称
+     * @returns 插件注册信息，如果未找到则返回 undefined
+     */
+    get(name: string): RegisteredPlugin | undefined;
+    /**
+     * 获取已注册的插件实例
+     * @param name - 插件名称
+     * @returns 插件实例，如果未找到则返回 undefined
+     */
+    getPlugin(name: string): EnhancedPlugin | undefined;
+    /**
+     * 检查插件是否已注册
+     * @param name - 插件名称
+     */
+    has(name: string): boolean;
+    /**
+     * 获取所有已注册插件名称
+     */
+    getNames(): string[];
+    /**
+     * 获取所有已注册插件信息
+     */
+    getAll(): RegisteredPlugin[];
+    /**
+     * 获取已安装插件列表
+     */
+    getInstalled(): RegisteredPlugin[];
+    /**
+     * 标记插件为已安装
+     * @param name - 插件名称
+     */
+    markInstalled(name: string): void;
+    /**
+     * 标记插件为未安装
+     * @param name - 插件名称
+     */
+    markUninstalled(name: string): void;
+    /**
+     * 检查插件依赖是否满足
+     * @param plugin - 要检查的插件
+     * @returns 依赖检查结果
+     */
+    checkDependencies(plugin: EnhancedPlugin | Plugin): DependencyResult;
+    /**
+     * 解析插件加载顺序（拓扑排序）
+     * @description 根据依赖关系计算正确的安装顺序
+     * @returns 排序后的插件列表
+     * @throws 如果存在循环依赖则抛出错误
+     */
+    resolveLoadOrder(): EnhancedPlugin[];
+    /**
+     * 获取插件数量
+     */
+    get size(): number;
+    /**
+     * 清空所有已注册插件
+     */
+    clear(): void;
+    /**
+     * 注册事件监听器
+     * @param event - 事件类型
+     * @param handler - 事件处理函数
+     * @returns 取消监听的函数
+     */
+    on(event: PluginLifecycleEvent, handler: PluginEventListener): () => void;
+    /**
+     * 触发事件
+     * @param event - 事件类型
+     * @param data - 事件数据
+     */
+    emit(event: PluginLifecycleEvent, data: unknown): void;
+    /**
+     * 移除事件监听器
+     * @param event - 事件类型
+     * @param handler - 事件处理函数
+     */
+    off(event: PluginLifecycleEvent, handler: PluginEventListener): void;
+    /**
+     * 获取插件名称
+     */
+    private getPluginName;
+    /**
+     * 检查是否为 EnhancedPlugin
+     */
+    private isEnhancedPlugin;
+    /**
+     * 将基础 Plugin 标准化为 EnhancedPlugin
+     */
+    private normalizePlugin;
+    /**
+     * 检查插件冲突
+     */
+    private checkConflicts;
+    /**
+     * 简单的 semver 版本比较
+     * @description 支持 ^, ~, >=, >, <, <=, = 前缀
+     */
+    private satisfiesVersion;
+    /**
+     * 解析版本号字符串
+     */
+    private parseVersion;
+    /**
+     * 比较两个版本号
+     * @returns 正数表示 a > b，负数表示 a < b，0 表示相等
+     */
+    private compareVersions;
+}
+
+/**
+ * 验证报告中的单个问题
+ */
+interface ValidationIssue {
+    /** 问题级别 */
+    level: 'error' | 'warning' | 'info';
+    /** 问题规则名称 */
+    rule: string;
+    /** 问题描述 */
+    message: string;
+}
+/**
+ * 插件验证报告
+ * @description 包含验证结果和所有发现的问题
+ */
+interface ValidationReport {
+    /** 是否通过验证（无 error 级别问题） */
+    valid: boolean;
+    /** 插件名称 */
+    pluginName: string;
+    /** 所有验证问题 */
+    issues: ValidationIssue[];
+    /** 错误数量 */
+    errorCount: number;
+    /** 警告数量 */
+    warningCount: number;
+    /** 信息数量 */
+    infoCount: number;
+}
+/**
+ * 验证规则函数类型
+ */
+type ValidationRule = (plugin: EnhancedPlugin | Plugin, context: ValidationContext) => ValidationIssue[];
+/**
+ * 验证上下文
+ */
+interface ValidationContext {
+    /** 已知插件名称列表（用于循环依赖检测） */
+    knownPlugins: Set<string>;
+}
+/**
+ * 插件验证器
+ * @description 对插件进行结构和配置验证，确保插件符合规范
+ *
+ * @example
+ * ```typescript
+ * const validator = new PluginValidator();
+ *
+ * // 验证单个插件
+ * const report = validator.validate(myPlugin);
+ * if (!report.valid) {
+ *   console.error('Plugin validation failed:', report.issues);
+ * }
+ *
+ * // 批量验证
+ * const reports = validator.validateAll([plugin1, plugin2, plugin3]);
+ * ```
+ */
+declare class PluginValidator {
+    /** 内置验证规则列表 */
+    private rules;
+    /** 已知插件名称集合（用于跨插件验证） */
+    private knownPlugins;
+    constructor();
+    /**
+     * 验证插件
+     * @param plugin - 要验证的插件
+     * @returns 验证报告
+     */
+    validate(plugin: EnhancedPlugin | Plugin): ValidationReport;
+    /**
+     * 批量验证多个插件
+     * @param plugins - 要验证的插件列表
+     * @returns 验证报告列表
+     */
+    validateAll(plugins: (EnhancedPlugin | Plugin)[]): ValidationReport[];
+    /**
+     * 注册已知插件名称（用于跨插件验证）
+     * @param names - 插件名称列表
+     */
+    registerKnownPlugins(names: string[]): void;
+    /**
+     * 添加自定义验证规则
+     * @param rule - 验证规则函数
+     */
+    addRule(rule: ValidationRule): void;
+    /**
+     * 移除验证规则
+     * @param rule - 要移除的验证规则函数
+     */
+    removeRule(rule: ValidationRule): void;
+    /**
+     * 规则：验证插件基本结构
+     * @description 确保插件有 install 方法
+     */
+    private validateStructure;
+    /**
+     * 规则：验证插件名称
+     * @description 确保名称有效且不冲突
+     */
+    private validateName;
+    /**
+     * 规则：验证版本号格式
+     * @description 确保版本号符合 semver 格式
+     */
+    private validateVersion;
+    /**
+     * 规则：验证依赖声明
+     * @description 检查依赖格式和已知性
+     */
+    private validateDependencies;
+    /**
+     * 验证依赖数组
+     */
+    private validateDependencyArray;
+    /**
+     * 规则：验证冲突声明
+     * @description 检查冲突列表格式
+     */
+    private validateConflicts;
+    /**
+     * 规则：验证 peerRequirements
+     * @description 检查宿主框架版本要求格式
+     */
+    private validatePeerRequirements;
+    /**
+     * 规则：验证生命周期钩子
+     * @description 确保生命周期钩子是函数
+     */
+    private validateLifecycleHooks;
+    /**
+     * 获取插件名称
+     */
+    private getPluginName;
+    /**
+     * 检查是否为 EnhancedPlugin
+     */
+    private isEnhancedPlugin;
+}
+
+interface App<HostElement = Element> {
+    config: AppConfig;
+    use(plugin: Plugin | PluginInstallFunction, ...options: unknown[]): App;
+    mount(rootContainer: HostElement | string): Promise<ComponentPublicInstance | null>;
+    unmount(): void;
+    provide<T = unknown>(key: string | symbol, value: T): App;
+    inject<T = unknown>(key: string | symbol): T | undefined;
+    component(name: string, component: Component): App;
+    directive(name: string, directive: Directive): App;
+    mixin(mixin: ComponentOptions): App;
+    /** 注册全局事件监听器，将在卸载时自动清理。 */
+    on(target: EventTarget, event: string, handler: EventListener, options?: AddEventListenerOptions): App;
+    /** 移除之前注册的全局事件监听器。 */
+    off(target: EventTarget, event: string, handler: EventListener, options?: AddEventListenerOptions): App;
+    /** 获取插件注册表实例（内部 API，用于高级插件管理） */
+    readonly _pluginRegistry: PluginRegistry;
+    /** 获取插件验证器实例（内部 API，用于自定义验证） */
+    readonly _pluginValidator: PluginValidator;
+    errorHandler?: (err: unknown, instance: ComponentPublicInstance | null, info: string) => void;
+    warnHandler?: (msg: string, instance: ComponentPublicInstance | null, trace: string) => void;
+}
+interface AppConfig extends BaseAppConfig {
+    performance: boolean;
+    globalProperties: Record<string, unknown>;
+    isCustomElement?: (tag: string) => boolean;
+    compilerOptions?: Record<string, unknown>;
+}
+/** createApp 的配置选项 */
+interface AppOptions {
+    /** 渲染模式：'vnode' 使用 VNode diff（默认），'signal' 使用 Signal + 直接 DOM 操作，'vapor' 是 'signal' 的别名 */
+    rendererMode?: 'vnode' | 'signal' | 'vapor';
+}
+/** 插件安装函数签名（支持泛型选项） */
+type PluginInstallFunction<T = unknown> = (app: App, ...options: T[]) => void | Promise<void>;
+/**
+ * 基础插件接口
+ * @description 所有 LytJS 插件必须实现此接口
+ */
+interface Plugin<TOptions = unknown> {
+    /** 插件安装函数 */
+    install: PluginInstallFunction<TOptions>;
+}
+/**
+ * 插件元数据信息
+ * @description 描述插件的附加信息，用于文档生成和插件市场展示
+ */
+interface PluginMeta {
+    /** 插件描述 */
+    description?: string;
+    /** 插件作者 */
+    author?: string;
+    /** 关键词标签 */
+    keywords?: string[];
+    /** 插件主页 */
+    homepage?: string;
+    /** 许可证 */
+    license?: string;
+    /** 仓库地址 */
+    repository?: string;
+}
+/**
+ * 插件依赖声明
+ * @description 声明插件对其他插件或框架版本的依赖关系
+ */
+interface PluginDependency {
+    /** 依赖的插件名称 */
+    name: string;
+    /** 版本范围要求（semver 格式） */
+    version?: string;
+    /** 是否为可选依赖 */
+    optional?: boolean;
+}
+/**
+ * 增强版插件接口（v6.0 Plugin System Enhancement）
+ * @description 包含名称、版本、元数据、生命周期钩子和依赖管理
+ */
+interface EnhancedPlugin<TOptions = unknown> extends Plugin<TOptions> {
+    /** 插件唯一标识名称（必填） */
+    name: string;
+    /** 插件版本号（semver 格式） */
+    version?: string;
+    /** 插件元数据 */
+    meta?: PluginMeta;
+    /** 依赖的其他插件 */
+    dependencies?: PluginDependency[];
+    /** 可选依赖的插件 */
+    optionalDependencies?: PluginDependency[];
+    /** 冲突的插件名称列表 */
+    conflicts?: string[];
+    /** 对宿主框架的版本要求 */
+    peerRequirements?: {
+        lytjs?: string;
+        node?: string;
+    };
+    /** 插件选项的 Schema 定义，用于验证和文档生成 */
+    configSchema?: ConfigSchema<TOptions>;
+    /** 安装前钩子，返回 false 可取消安装 */
+    beforeInstall?: (app: App) => boolean | Promise<boolean>;
+    /** 安装后钩子 */
+    afterInstall?: (app: App) => void | Promise<void>;
+    /** 应用挂载前钩子 */
+    beforeMount?: (app: App) => void | Promise<void>;
+    /** 应用挂载后钩子 */
+    afterMount?: (app: App) => void | Promise<void>;
+    /** 清理函数，在 app 卸载时调用 */
+    cleanup?: () => void | Promise<void>;
+}
+/**
+ * 支持 cleanup 的插件接口（向后兼容）
+ * FIX: P2-40 定义 PluginWithCleanup 接口，替代类型断言链
+ * @deprecated 推荐使用 EnhancedPlugin 替代
+ */
+interface PluginWithCleanup extends Plugin {
+    /** 插件清理函数，在 app 卸载时调用 */
+    cleanup?: () => void;
+    /** 插件名称，用于错误报告 */
+    name?: string;
+}
+/** 插件函数类型（支持 cleanup） */
+type PluginFunctionWithCleanup = PluginInstallFunction & {
+    cleanup?: () => void;
+    name?: string;
+};
+/** 已注册插件的信息 */
+interface RegisteredPlugin {
+    /** 插件实例 */
+    plugin: EnhancedPlugin;
+    /** 安装时传入的选项 */
+    options: unknown;
+    /** 是否已安装 */
+    installed: boolean;
+    /** 注册时间戳 */
+    registeredAt: number;
+    /** 安装时间戳 */
+    installedAt?: number;
+}
+/** 插件注册结果 */
+interface RegistrationResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 插件名称 */
+    name: string;
+    /** 错误信息（如果失败） */
+    error?: string;
+}
+/** 依赖检查结果 */
+interface DependencyResult {
+    /** 是否满足所有依赖 */
+    satisfied: boolean;
+    /** 缺少的必需依赖 */
+    missing: Array<{
+        name: string;
+        version?: string;
+    }>;
+    /** 缺少的可选依赖 */
+    missingOptional: Array<{
+        name: string;
+        version?: string;
+    }>;
+    /** 版本不兼容的依赖 */
+    versionMismatch: Array<{
+        name: string;
+        expected: string;
+        actual?: string;
+    }>;
+}
+/** 插件生命周期事件类型 */
+type PluginLifecycleEvent = 'before:register' | 'after:register' | 'before:install' | 'after:install' | 'before:unregister' | 'after:unregister' | 'error';
+/** 插件事件监听器 */
+type PluginEventListener = (event: PluginLifecycleEvent, data: unknown) => void;
+type Component = ComponentOptions | (() => VNode);
+
+type AsyncComponentLoader = () => Promise<Component>;
+interface AsyncComponentOptions {
+    loader: AsyncComponentLoader;
+    loadingComponent?: Component;
+    errorComponent?: Component;
+    delay?: number;
+    timeout?: number;
+    suspensible?: boolean;
+    onError?: (error: Error, retry: () => void, fail: () => void, attempts: number) => void;
+}
+
+type ErrorCapturedHook = (err: Error, instance: ComponentPublicInstance | null, info: string) => boolean | void;
+type DebuggerHook = (event: DebuggerEvent) => void;
+
+declare function createApp(rootComponent: Component, rootProps?: Record<string, unknown> | null, options?: AppOptions): App;
+
+declare function h(type: string): VNode;
+declare function h(type: Component): VNode;
+declare function h(type: typeof Fragment): VNode;
+declare function h(type: typeof Text): VNode;
+declare function h(type: typeof Comment): VNode;
+declare function h<P = Record<string, unknown>>(type: string, props: P | null): VNode;
+declare function h<P = Record<string, unknown>>(type: Component, props: P | null): VNode;
+declare function h(type: typeof Fragment, props: Record<string, unknown> | null): VNode;
+declare function h(type: typeof Text, props: Record<string, unknown> | null): VNode;
+declare function h(type: typeof Comment, props: Record<string, unknown> | null): VNode;
+declare function h<P = Record<string, unknown>>(type: string, props: P | null, ...children: VNodeChildren[]): VNode;
+declare function h<P = Record<string, unknown>>(type: Component, props: P | null, ...children: VNodeChildren[]): VNode;
+declare function h(type: typeof Fragment, props: Record<string, unknown> | null, ...children: VNodeChildren[]): VNode;
+declare function h(type: typeof Text, props: Record<string, unknown> | null, ...children: VNodeChildren[]): VNode;
+declare function h(type: typeof Comment, props: Record<string, unknown> | null, ...children: VNodeChildren[]): VNode;
+
+/**
+ * 定义组件（re-export from @lytjs/component）
+ *
+ * 权威实现在 @lytjs/component 中，此处统一返回类型为 ComponentOptions。
+ * 由于 Component = ComponentOptions | (() => any)，
+ * 返回 ComponentOptions 是 Component 的子集，完全兼容。
+ */
+declare const defineComponent: (options: ComponentOptions) => ComponentOptions;
+/**
+ * 定义异步组件
+ */
+declare function defineAsyncComponent(source: AsyncComponentLoader | AsyncComponentOptions): Component;
+
+/**
+ * 解析组件：从当前组件实例的 components 选项和全局注册中查找
+ */
+declare function resolveComponent(name: string): Component | undefined;
+/**
+ * 解析指令：从当前组件实例的 directives 选项和全局注册中查找
+ */
+declare function resolveDirective(name: string): Directive | undefined;
+/**
+ * 解析动态组件：
+ * - 如果 tag 是字符串，尝试从 appContext.components 中解析已注册组件，
+ *   如果找不到则返回原始字符串（可能是原生 HTML 元素）
+ * - 如果 tag 已经是组件对象，直接返回
+ */
+declare function resolveDynamicComponent(tag: string | Component): Component | string;
+
+declare function withDirectives(vnode: VNode, directives: DirectiveArguments): VNode;
+/** Memo 缓存条目 */
+interface MemoEntry {
+    memo: unknown[];
+    result: VNode;
+}
+/**
+ * 带缓存的渲染辅助
+ */
+declare function withMemo(memo: unknown[], render: () => VNode, cache: MemoEntry[], index: number): VNode;
+
+/**
+ * 获取当前组件的 slots
+ * FIX: P2-37 useSlots 类型安全增强：
+ * 返回的 InternalSlots 类型确保 slot 函数的参数和返回值类型正确
+ */
+declare function useSlots(): InternalSlots;
+/**
+ * 获取当前组件的 attrs
+ */
+declare function useAttrs(): Record<string, unknown>;
+/**
+ * 双向绑定辅助（v-model 的 composition API 版本）
+ */
+declare function useModel<T>(props: Record<string, T | undefined>, key: string): WritableComputedRef<T>;
+/**
+ * defineModel 运行时实现。
+ * Vue 3.4+ 新增的编译器宏，在 lytjs 中以运行时函数形式提供。
+ *
+ * 用法：
+ *   const modelValue = defineModel()                    // 默认 'modelValue'
+ *   const title = defineModel('title')                  // 命名 model
+ *   const count = defineModel('count', { default: 0 })  // 带默认值
+ *
+ * 返回一个 WritableComputedRef，读取时返回 prop 值，写入时触发 update 事件。
+ */
+declare function defineModel<T = unknown>(name?: string, options?: {
+    default?: T;
+    required?: boolean;
+    type?: unknown;
+    transform?: (value: T) => T;
+}): WritableComputedRef<T>;
+/**
+ * 获取模板引用的 ref。
+ * 通过 key 从组件实例的 refs 中获取对应的 DOM 元素或组件实例。
+ * 使用 watch 持续追踪 refs 变化，确保响应式同步。
+ * Vue 3.5+ 新增组合式 API。
+ */
+declare function useTemplateRef<T = unknown>(key: string): Ref<T | null>;
+/**
+ * 生成应用范围内唯一的 ID。
+ * Vue 3.5 新增的组合式 API，用于生成可预测的唯一标识符，
+ * 特别适用于无障碍属性（aria-*)和表单元素关联。
+ *
+ * 每个组件实例会获得一个基于组件 uid 的 ID 前缀，
+ * 确保同一组件在不同位置渲染时产生不同的 ID。
+ *
+ * FIX: P2-38 使用高熵随机数替代全局计数器，防止多实例/多窗口场景下的 ID 冲突
+ */
+declare function useId(): Readonly<Ref<string>>;
+/**
+ * 获取单文件组件中 CSS Modules 的类名映射。
+ * 在 SFC 中，`<style module>` 块会被编译为 CSS Modules，
+ * useCssModule 返回一个包含局部类名到全局类名映射的对象。
+ *
+ * @param name - CSS Modules 的名称，默认为 '$style'
+ */
+declare function useCssModule(name?: string): Record<string, string>;
+/**
+ * 在组件实例上设置 CSS 自定义属性（CSS Variables）。
+ * 提供响应式的方式来管理 CSS 变量。
+ *
+ * @param vars - 一个函数，返回包含 CSS 变量键值对的对象
+ *
+ * 用法：
+ *   useCssVars(() => ({
+ *     color: themeColor.value,
+ *     fontSize: size.value + 'px',
+ *   }))
+ */
+declare function useCssVars(vars: () => Record<string, string>): void;
+
+/**
+ * defineCustomElement 的配置选项
+ */
+interface DefineCustomElementOptions {
+    /** 是否使用 Shadow DOM（默认 true） */
+    shadowRoot?: boolean;
+    /** Custom Element 标签名（默认使用组件 name） */
+    name?: string;
+    /** CSS 样式（注入到 Shadow DOM） */
+    css?: string;
+}
+/**
+ * 将 LytJS 组件包装为 Custom Element
+ */
+declare function defineCustomElement(componentOptions: ComponentOptions, options?: DefineCustomElementOptions): CustomElementConstructor;
+/**
+ * 在 setup 中获取当前 Custom Element 的 Shadow Root
+ */
+declare function useShadowRoot(): ShadowRoot | null;
+/**
+ * 在 setup 中获取当前 Custom Element 的宿主元素
+ */
+declare function useHost(): HTMLElement | null;
+/**
+ * 在 setup 中获取 slot 变化通知（MutationObserver）
+ * 返回一个注册回调的函数
+ */
+declare function useWebComponentSlots(onChange: () => void): void;
+/**
+ * 向 Shadow DOM 注入样式
+ */
+declare function injectChildStyles(styles: string): void;
+
+/**
+ * 配置验证器
+ * @description 根据 ConfigSchema 验证配置值
+ */
+declare class ConfigValidator {
+    /** 自定义验证规则 */
+    private rules;
+    /**
+     * 验证配置值
+     * @param value - 要验证的值
+     * @param schema - 配置 Schema
+     * @param path - 当前路径（用于错误报告）
+     * @returns 验证报告
+     */
+    validate(value: unknown, schema: ConfigSchema, path?: string): ConfigValidationReport;
+    /**
+     * 验证字符串值
+     */
+    private validateString;
+    /**
+     * 验证数字值
+     */
+    private validateNumber;
+    /**
+     * 验证布尔值
+     */
+    private validateBoolean;
+    /**
+     * 验证对象值
+     */
+    private validateObject;
+    /**
+     * 验证数组值
+     */
+    private validateArray;
+    /**
+     * 验证枚举值
+     */
+    private validateEnum;
+    /**
+     * 验证联合类型
+     */
+    private validateUnion;
+    /**
+     * 验证字符串格式
+     */
+    private validateFormat;
+    /**
+     * 创建验证错误
+     */
+    private createError;
+    /**
+     * 添加自定义验证规则
+     */
+    addRule(rule: (value: unknown, schema: ConfigSchema, context: ValidationContext$1) => ConfigValidationError | null): void;
+    /**
+     * 移除自定义验证规则
+     */
+    removeRule(rule: (value: unknown, schema: ConfigSchema, context: ValidationContext$1) => ConfigValidationError | null): void;
+    private isStringType;
+}
+/**
+ * 快速验证配置
+ */
+declare function validateConfig<T>(value: unknown, schema: ConfigSchema<T>): ConfigValidationReport;
+
+/**
+ * 配置转换器
+ * @description 负责应用默认值、类型转换和预处理
+ */
+declare class ConfigTransformer {
+    private validator;
+    constructor();
+    /**
+     * 转换并验证配置
+     * @param value - 原始配置值
+     * @param schema - 配置 Schema
+     * @param path - 当前路径
+     * @returns 转换报告
+     */
+    transform<T>(value: unknown, schema: ConfigSchema<T>, path?: string): ConfigTransformReport<T>;
+    /**
+     * 转换对象配置
+     */
+    private transformObject;
+    /**
+     * 转换数组配置
+     */
+    private transformArray;
+    /**
+     * 合并多个配置（用户配置覆盖默认配置）
+     * @param defaults - 默认配置
+     * @param overrides - 用户配置
+     * @param schema - 配置 Schema
+     * @returns 合并后的配置
+     */
+    merge<T>(defaults: Partial<T>, overrides: Partial<T>, schema: ConfigSchema<T>): ConfigTransformReport<T>;
+    /**
+     * 深度合并两个对象
+     */
+    private deepMerge;
+    /**
+     * 从配置中提取指定字段
+     * @param config - 完整配置
+     * @param schema - 配置 Schema
+     * @param keys - 要提取的键
+     * @returns 提取的配置子集
+     */
+    extract<T, K extends keyof T>(config: T, schema: ConfigSchema<T>, keys: K[]): Partial<T>;
+}
+/**
+ * 快速转换配置
+ */
+declare function transformConfig<T>(value: unknown, schema: ConfigSchema<T>): ConfigTransformReport<T>;
+/**
+ * 快速合并配置
+ */
+declare function mergeConfig<T>(defaults: Partial<T>, overrides: Partial<T>, schema: ConfigSchema<T>): ConfigTransformReport<T>;
+
+/**
+ * 插件配置选项
+ */
+interface PluginConfig<TOptions = unknown> {
+    /** 插件名称 */
+    name: string;
+    /** 插件版本 */
+    version?: string;
+    /** 插件描述 */
+    description?: string;
+    /** 插件作者 */
+    author?: string;
+    /** 关键词 */
+    keywords?: string[];
+    /** 插件选项 Schema */
+    schema?: ConfigSchema<TOptions>;
+    /** 安装函数 */
+    install: (app: App, options: TOptions) => void | Promise<void>;
+}
+/**
+ * 插件定义结果
+ */
+interface PluginDefinition<TOptions = unknown> extends EnhancedPlugin<TOptions> {
+    /** 配置验证报告 */
+    configReport?: ConfigValidationReport;
+}
+/**
+ * 创建插件定义
+ * @description 提供类型安全的插件定义方式
+ *
+ * @example
+ * ```typescript
+ * const myPlugin = definePlugin({
+ *   name: 'my-plugin',
+ *   version: '1.0.0',
+ *   description: 'My awesome plugin',
+ *   schema: {
+ *     type: 'object',
+ *     properties: {
+ *       theme: { type: 'string', string: { enum: ['light', 'dark'] }, default: 'light' },
+ *       debug: { type: 'boolean', default: false },
+ *     },
+ *   },
+ *   install: (app, options) => {
+ *     console.log('Plugin installed with options:', options);
+ *   },
+ * });
+ * ```
+ */
+declare function definePlugin<TOptions = unknown>(config: PluginConfig<TOptions>): PluginDefinition<TOptions>;
+/**
+ * 验证插件配置
+ * @description 验证用户提供的配置是否符合 Schema
+ *
+ * @example
+ * ```typescript
+ * const result = validatePluginConfig(myPlugin, { theme: 'dark', debug: true });
+ * if (!result.valid) {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+declare function validatePluginConfig<TOptions>(plugin: EnhancedPlugin<TOptions>, userConfig: unknown): ConfigValidationReport;
+/**
+ * 转换插件配置
+ * @description 验证并转换用户配置，应用默认值
+ *
+ * @example
+ * ```typescript
+ * const result = transformPluginConfig(myPlugin, { debug: true });
+ * // result.config = { theme: 'light', debug: true } (theme 从 default 填充)
+ * ```
+ */
+declare function transformPluginConfig<TOptions>(plugin: EnhancedPlugin<TOptions>, userConfig: unknown): ConfigTransformReport<TOptions>;
+/**
+ * 合并插件默认配置
+ * @description 将用户配置与插件默认配置合并
+ *
+ * @example
+ * ```typescript
+ * const result = mergePluginConfig(myPlugin, { theme: 'dark' }, userConfig);
+ * ```
+ */
+declare function mergePluginConfig<TOptions>(plugin: EnhancedPlugin<TOptions>, defaults: Partial<TOptions>, overrides: Partial<TOptions>): ConfigTransformReport<TOptions>;
+/**
+ * 创建插件测试器
+ * @description 用于在隔离环境中测试插件
+ */
+interface PluginTesterOptions {
+    /** 测试用的 App 配置 */
+    appConfig?: {
+        performance?: boolean;
+        globalProperties?: Record<string, unknown>;
+    };
+    /** 是否启用调试日志 */
+    debug?: boolean;
+    /** 配置验证回调 */
+    onValidationError?: (errors: ConfigValidationReport) => void;
+    /** 安装前回调 */
+    onBeforeInstall?: (app: App) => void;
+    /** 安装后回调 */
+    onAfterInstall?: (app: App) => void;
+    /** 清理回调 */
+    onCleanup?: () => void;
+}
+/**
+ * 插件测试器
+ * @description 提供插件测试的辅助功能
+ */
+declare class PluginTester {
+    private options;
+    private app;
+    private installedPlugins;
+    constructor(options?: PluginTesterOptions);
+    /**
+     * 创建测试 App
+     */
+    createApp(): Promise<App>;
+    /**
+     * 安装插件进行测试
+     */
+    installPlugin(plugin: EnhancedPlugin, options?: unknown): Promise<void>;
+    /**
+     * 卸载插件进行测试
+     */
+    uninstallPlugin(name: string): void;
+    /**
+     * 运行清理
+     */
+    cleanup(): void;
+    /**
+     * 获取已安装插件列表
+     */
+    getInstalledPlugins(): string[];
+    /**
+     * 获取 App 实例
+     */
+    getApp(): App | null;
+}
+/**
+ * 快速创建插件测试器
+ */
+declare function createPluginTester(options?: PluginTesterOptions): PluginTester;
+/**
+ * 测试插件安装
+ * @description 在隔离环境中测试插件安装
+ */
+declare function testPluginInstall(plugin: EnhancedPlugin, options?: unknown, testerOptions?: PluginTesterOptions): Promise<{
+    success: boolean;
+    error?: Error;
+    app?: App;
+}>;
+
+/**
+ * @lytjs/core - 全局配置系统
+ *
+ * 提供运行时配置管理和合并功能
+ *
+ * @module @lytjs/core/config
+ * @version 6.0.0
+ */
+/**
+ * 配置变更监听器
+ */
+type ConfigChangeCallback<T = unknown> = (newValue: T, oldValue: T, path: string) => void;
+/**
+ * 配置选项
+ */
+interface ConfigOptions {
+    /** 是否允许在运行时修改配置 */
+    mutable?: boolean;
+    /** 是否深度合并配置 */
+    deepMerge?: boolean;
+    /** 变更时的回调函数 */
+    onChange?: ConfigChangeCallback;
+}
+/**
+ * 配置对象类型
+ */
+type ConfigValue = string | number | boolean | null | undefined | ConfigObject | ConfigArray;
+/**
+ * 配置对象
+ */
+interface ConfigObject {
+    [key: string]: ConfigValue;
+}
+/**
+ * 配置数组
+ */
+type ConfigArray = ConfigValue[];
+/**
+ * 全局配置管理器
+ *
+ * 提供配置存储、合并、变更监听等功能
+ *
+ * @example
+ * ```ts
+ * // 创建配置管理器
+ * const config = new ConfigManager({
+ *   api: { baseURL: '/api', timeout: 5000 },
+ *   theme: { primary: '#007bff' }
+ * })
+ *
+ * // 获取配置
+ * const baseURL = config.get('api.baseURL')
+ *
+ * // 设置配置
+ * config.set('api.timeout', 10000)
+ *
+ * // 监听变更
+ * config.watch('theme.primary', (newVal, oldVal) => {
+ *   console.log(`主题色从 ${oldVal} 变为 ${newVal}`)
+ * })
+ * ```
+ */
+declare class ConfigManager {
+    private config;
+    private options;
+    private listeners;
+    private globalListeners;
+    constructor(initialConfig?: ConfigObject, options?: ConfigOptions);
+    /**
+     * 获取配置值
+     *
+     * @param path - 配置路径（支持点号分隔，如 'api.baseURL'）
+     * @param defaultValue - 默认值
+     * @returns 配置值或默认值
+     *
+     * @example
+     * ```ts
+     * config.get('api.baseURL') // '/api'
+     * config.get('api.timeout', 5000) // 5000 (如果不存在)
+     * config.get('theme.colors.primary') // 嵌套值
+     * ```
+     */
+    get<T = ConfigValue>(path: string, defaultValue?: T): T | undefined;
+    /**
+     * 设置配置值
+     *
+     * @param path - 配置路径
+     * @param value - 新值
+     * @returns 是否设置成功
+     *
+     * @example
+     * ```ts
+     * config.set('api.timeout', 10000)
+     * config.set('theme.colors.primary', '#ff0000')
+     * ```
+     */
+    set<T = ConfigValue>(path: string, value: T): boolean;
+    /**
+     * 批量设置配置
+     *
+     * @param config - 配置对象
+     * @param merge - 是否合并（true）或替换（false）
+     *
+     * @example
+     * ```ts
+     * config.setMultiple({
+     *   'api.timeout': 10000,
+     *   'theme.primary': '#ff0000'
+     * })
+     * ```
+     */
+    setMultiple(config: Record<string, ConfigValue>, merge?: boolean): void;
+    /**
+     * 检查配置是否存在
+     *
+     * @param path - 配置路径
+     * @returns 是否存在
+     */
+    has(path: string): boolean;
+    /**
+     * 删除配置
+     *
+     * @param path - 配置路径
+     * @returns 是否删除成功
+     */
+    delete(path: string): boolean;
+    /**
+     * 合并配置
+     *
+     * @param config - 要合并的配置
+     * @param deep - 是否深度合并
+     *
+     * @example
+     * ```ts
+     * config.merge({
+     *   api: { timeout: 10000 },
+     *   newKey: 'value'
+     * })
+     * ```
+     */
+    merge(config: ConfigObject, deep?: boolean): void;
+    /**
+     * 深度合并对象，并在值变更时通知监听器
+     * FIX: P2-v11-08 替代原 deepMerge，在合并过程中收集变更的键并通知监听器
+     */
+    private deepMergeNotify;
+    /**
+     * 获取所有配置
+     *
+     * @returns 配置对象的深拷贝
+     */
+    getAll(): ConfigObject;
+    /**
+     * 重置配置
+     *
+     * @param newConfig - 新的配置对象
+     */
+    reset(newConfig?: ConfigObject): void;
+    /**
+     * 清空配置
+     */
+    clear(): void;
+    /**
+     * 监听配置变更
+     *
+     * @param path - 配置路径（空字符串表示监听所有变更）
+     * @param callback - 变更回调
+     * @returns 取消监听函数
+     *
+     * @example
+     * ```ts
+     * // 监听特定路径
+     * const unwatch = config.watch('api.timeout', (newVal, oldVal) => {
+     *   console.log(`timeout 从 ${oldVal} 变为 ${newVal}`)
+     * })
+     *
+     * // 监听所有变更
+     * config.watch('', (newConfig) => {
+     *   console.log('配置已更新:', newConfig)
+     * })
+     * ```
+     */
+    watch<T = ConfigValue>(path: string, callback: ConfigChangeCallback<T>): () => void;
+    /**
+     * 通知监听器
+     */
+    private notify;
+    /**
+     * 设置可变性
+     *
+     * @param mutable - 是否可变
+     */
+    setMutable(mutable: boolean): void;
+    /**
+     * 检查是否可变
+     * FIX: P2-v11-09 简化 isMutable()：mutable 在构造函数中已设置默认值为 true，
+     * 不可能为 undefined，因此 ?? true 是冗余的
+     */
+    isMutable(): boolean;
+}
+/**
+ * 获取全局配置管理器
+ *
+ * @returns 全局配置管理器实例
+ */
+declare function getGlobalConfig(): ConfigManager;
+/**
+ * 设置全局配置
+ *
+ * @param config - 配置对象
+ * @param merge - 是否合并
+ */
+declare function setGlobalConfig(config: ConfigObject, merge?: boolean): void;
+/**
+ * 获取全局配置值
+ *
+ * @param path - 配置路径
+ * @param defaultValue - 默认值
+ */
+declare function getConfig<T = ConfigValue>(path: string, defaultValue?: T): T | undefined;
+/**
+ * 设置全局配置值
+ *
+ * @param path - 配置路径
+ * @param value - 配置值
+ */
+declare function setConfig<T = ConfigValue>(path: string, value: T): boolean;
+/**
+ * 监听全局配置变更
+ *
+ * @param path - 配置路径
+ * @param callback - 变更回调
+ */
+declare function watchConfig<T = ConfigValue>(path: string, callback: ConfigChangeCallback<T>): () => void;
+/**
+ * 配置预设
+ */
+declare const configPresets: {
+    /**
+     * 开发环境预设
+     */
+    development: () => ConfigObject;
+    /**
+     * 生产环境预设
+     */
+    production: () => ConfigObject;
+    /**
+     * 测试环境预设
+     */
+    test: () => ConfigObject;
+};
+/**
+ * 应用配置预设
+ *
+ * @param preset - 预设名称
+ */
+declare function applyConfigPreset(preset: keyof typeof configPresets): void;
+
+/**
+ * HTTP 客户端类型（来自 @lytjs/common-http）
+ *
+ * 用途：
+ * - SSR 数据预取
+ * - API 请求封装
+ * - 请求拦截和错误处理
+ */
+interface HttpClientLike {
+    get<T = unknown>(url: string, options?: unknown): Promise<T>;
+    post<T = unknown>(url: string, data?: unknown, options?: unknown): Promise<T>;
+    put<T = unknown>(url: string, data?: unknown, options?: unknown): Promise<T>;
+    delete<T = unknown>(url: string, options?: unknown): Promise<T>;
+    interceptors: {
+        request: {
+            use: (fn: unknown) => number;
+        };
+        response: {
+            use: (fn: unknown) => number;
+        };
+    };
+}
+/**
+ * URL 查询工具类型（来自 @lytjs/common-query）
+ *
+ * 用途：
+ * - 路由参数解析
+ * - URL 构建
+ * - 查询字符串处理
+ */
+interface QueryUtilsLike {
+    parseQueryString(str: string): Record<string, string>;
+    stringifyQueryString(obj: Record<string, unknown>): string;
+    parseURL(url: string): {
+        protocol: string;
+        host: string;
+        pathname: string;
+        search: string;
+        hash: string;
+    };
+    buildURL(base: string, params?: Record<string, unknown>): string;
+}
+/**
+ * 安全工具类型（来自 @lytjs/common-security）
+ *
+ * 用途：
+ * - XSS 防护
+ * - HTML 转义
+ * - 安全的动态内容处理
+ */
+interface SecurityUtilsLike {
+    escapeHtml(str: string): string;
+    escapeAttr(str: string): string;
+    sanitizeHtml(html: string, options?: unknown): string;
+}
+/**
+ * 缓存工具类型（来自 @lytjs/common-cache）
+ *
+ * 用途：
+ * - 组件实例缓存
+ * - 计算结果缓存
+ * - Keep-alive 实现
+ */
+interface CacheUtilsLike {
+    createLRUCache<K, V>(maxSize: number): {
+        get(key: K): V | undefined;
+        set(key: K, value: V): void;
+        has(key: K): boolean;
+        delete(key: K): boolean;
+        clear(): void;
+        size: number;
+    };
+}
+/**
+ * 框架核心集成点
+ *
+ * 允许外部模块（如路由、状态管理）注册其工具实现，
+ * 使框架核心可以使用这些功能而无需直接依赖。
+ */
+interface CoreIntegrations {
+    http?: HttpClientLike;
+    query?: QueryUtilsLike;
+    security?: SecurityUtilsLike;
+    cache?: CacheUtilsLike;
+}
+/**
+ * 注册集成点（全局，向后兼容）
+ */
+declare function registerIntegrations(integrations: CoreIntegrations): void;
+/**
+ * 获取 HTTP 客户端
+ */
+declare function getHttpClient(): HttpClientLike | undefined;
+/**
+ * 获取查询工具
+ */
+declare function getQueryUtils(): QueryUtilsLike | undefined;
+/**
+ * 获取安全工具
+ */
+declare function getSecurityUtils(): SecurityUtilsLike | undefined;
+/**
+ * 获取缓存工具
+ */
+declare function getCacheUtils(): CacheUtilsLike | undefined;
+/**
+ * 安全转义 HTML（如果有安全工具则使用，否则使用基础实现）
+ */
+declare function safeEscapeHtml(str: string): string;
+/**
+ * 解析查询字符串（如果有查询工具则使用，否则使用基础实现）
+ */
+declare function safeParseQueryString(str: string): Record<string, string>;
+
+/**
+ * @lytjs/core - 错误边界组件
+ *
+ * 提供强大的错误处理和恢复机制
+ */
+
+/** 错误信息 */
+interface ErrorInfo {
+    componentStack?: string;
+    timestamp: Date;
+}
+/** 降级组件属性 */
+interface FallbackProps {
+    error: Error;
+    errorInfo: ErrorInfo;
+    reset: () => void;
+    retry: () => void;
+    retryCount: number;
+    maxRetries: number;
+    hasRetries: boolean;
+}
+/** 错误边界属性 */
+interface ErrorBoundaryProps {
+    fallback?: unknown;
+    fallbackRender?: (error: Error, errorInfo: ErrorInfo, reset: () => void) => VNode;
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    maxRetries?: number;
+    retryDelay?: number;
+    onRetry?: (retryCount: number) => void;
+    onMaxRetriesReached?: (error: Error) => void;
+}
+/** 错误报告上下文 */
+interface ErrorContext {
+    componentName?: string;
+    props?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    url?: string;
+    userAgent?: string;
+    timestamp: Date;
+}
+/** 错误报告器接口 */
+interface ErrorReporter {
+    report(error: Error, context: ErrorContext): void;
+}
+/** 错误日志 */
+interface ErrorLog {
+    id: string;
+    timestamp: Date;
+    error: Error;
+    errorInfo: ErrorInfo;
+    context: ErrorContext;
+    retryCount: number;
+}
+/** 设置全局错误报告器 */
+declare function setGlobalErrorReporter(reporter: ErrorReporter): void;
+/** 获取全局错误报告器 */
+declare function getGlobalErrorReporter(): ErrorReporter;
+/** 错误日志管理器 */
+declare class ErrorLogManager {
+    private logs;
+    private maxLogs;
+    addLog(log: ErrorLog): void;
+    getLogs(): ErrorLog[];
+    clearLogs(): void;
+    exportLogs(): string;
+    getLogById(id: string): ErrorLog | undefined;
+    getLogsByErrorType(errorType: string): ErrorLog[];
+    getLogsByDateRange(start: Date, end: Date): ErrorLog[];
+    getErrorStats(): {
+        totalErrors: number;
+        errorTypes: Record<string, number>;
+        recentErrors: ErrorLog[];
+    };
+}
+/** 全局错误日志管理器实例 */
+declare const errorLogManager: ErrorLogManager;
+/** 错误边界组件实现 */
+declare function ErrorBoundary(props: ErrorBoundaryProps): VNode;
+/** 错误边界钩子 - 用于手动触发错误 */
+declare function useErrorHandler(): (error: Error) => void;
+/** 错误边界重置钩子 */
+declare function useErrorBoundaryReset(): () => void;
+
+export { type App, type AppConfig, type AppOptions, type ArraySchema, type AsyncComponentLoader, type AsyncComponentOptions, type BooleanSchema, type CacheUtilsLike, type Component, type ConfigArray, type ConfigChangeCallback, ConfigManager, type ConfigObject, type ConfigOptions, type ConfigSchema, type ConfigTransformReport, ConfigTransformer, type ConfigValidationError, type ConfigValidationReport, ConfigValidator, type ConfigValue, type CoreIntegrations, type DebuggerHook, type DefineCustomElementOptions, type DependencyResult, type EnhancedPlugin, type EnumSchema, ErrorBoundary, type ErrorBoundaryProps, type ErrorCapturedHook, type ErrorContext, type ErrorInfo, type ErrorLog, type ErrorReporter, type FallbackProps, type HttpClientLike, type NumberSchema, type ObjectSchema, type Plugin, type PluginConfig, type PluginDefinition, type PluginDependency, type PluginEventListener, type PluginFunctionWithCleanup, type PluginInstallFunction, type PluginLifecycleEvent, type PluginMeta, PluginRegistry, PluginTester, type PluginTesterOptions, PluginValidator, type PluginWithCleanup, type QueryUtilsLike, type RegisteredPlugin, type RegistrationResult, type SchemaType, type SecurityUtilsLike, type StringFormat, type StringSchema, type UnionSchema, type ValidationContext$1 as ValidationContext, type ValidationErrorCode, type ValidationIssue, type ValidationReport, type ValidationResult, applyConfigPreset, configPresets, createApp, h as createElement, createPluginTester, defineAsyncComponent, defineComponent, defineCustomElement, defineModel, definePlugin, errorLogManager, getCacheUtils, getConfig, getGlobalConfig, getGlobalErrorReporter, getHttpClient, getQueryUtils, getSecurityUtils, h, injectChildStyles, mergeConfig, mergePluginConfig, registerIntegrations, resolveComponent, resolveDirective, resolveDynamicComponent, safeEscapeHtml, safeParseQueryString, setConfig, setGlobalConfig, setGlobalErrorReporter, testPluginInstall, transformConfig, transformPluginConfig, useAttrs, useCssModule, useCssVars, useErrorBoundaryReset, useErrorHandler, useHost, useId, useModel, useShadowRoot, useSlots, useTemplateRef, useWebComponentSlots, validateConfig, validatePluginConfig, watchConfig, withDirectives, withMemo };