@lytjs/core 6.0.0 → 6.5.0

package/dist/index.d.cts

@@ -1470,4 +1470,87 @@ declare function safeEscapeHtml(str: string): string;
  */
 declare function safeParseQueryString(str: string): Record<string, string>;
 
-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, type ErrorCapturedHook, 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, getCacheUtils, getConfig, getGlobalConfig, getHttpClient, getQueryUtils, getSecurityUtils, h, injectChildStyles, mergeConfig, mergePluginConfig, registerIntegrations, resolveComponent, resolveDirective, resolveDynamicComponent, safeEscapeHtml, safeParseQueryString, setConfig, setGlobalConfig, testPluginInstall, transformConfig, transformPluginConfig, useAttrs, useCssModule, useCssVars, useHost, useId, useModel, useShadowRoot, useSlots, useTemplateRef, useWebComponentSlots, validateConfig, validatePluginConfig, watchConfig, withDirectives, withMemo };
+/**
+ * @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?: any;
+    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 };

package/dist/index.d.ts

@@ -1470,4 +1470,87 @@ declare function safeEscapeHtml(str: string): string;
  */
 declare function safeParseQueryString(str: string): Record<string, string>;
 
-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, type ErrorCapturedHook, 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, getCacheUtils, getConfig, getGlobalConfig, getHttpClient, getQueryUtils, getSecurityUtils, h, injectChildStyles, mergeConfig, mergePluginConfig, registerIntegrations, resolveComponent, resolveDirective, resolveDynamicComponent, safeEscapeHtml, safeParseQueryString, setConfig, setGlobalConfig, testPluginInstall, transformConfig, transformPluginConfig, useAttrs, useCssModule, useCssVars, useHost, useId, useModel, useShadowRoot, useSlots, useTemplateRef, useWebComponentSlots, validateConfig, validatePluginConfig, watchConfig, withDirectives, withMemo };
+/**
+ * @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?: any;
+    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 };

package/dist/index.mjs

@@ -3,12 +3,11 @@ export { onActivated, onBeforeMount, onBeforeUnmount, onBeforeUpdate, onDeactiva
 import { error } from '@lytjs/common-error';
 import { createVNode, cloneVNode, mergeProps, Text, Fragment, Comment, EMPTY_OBJ } from '@lytjs/vdom';
 export { Comment, Fragment, Text, cloneVNode, createVNode, mergeProps } from '@lytjs/vdom';
-import { shallowRef, ref, computed, watch, readonly, watchEffect, reactive, effect } from '@lytjs/reactivity';
+import { shallowRef, ref, computed, watch, onScopeDispose, readonly, watchEffect, reactive, effect } from '@lytjs/reactivity';
 export { computed, effect, reactive, ref, watch, watchEffect } from '@lytjs/reactivity';
 import { nextTick } from '@lytjs/common-scheduler';
 export { nextTick } from '@lytjs/common-scheduler';
 import { isArray, isObject, hasChanged } from '@lytjs/common-is';
-import { onScopeDispose } from '@lytjs/reactivity/scope';
 import { createDOMRenderer as createDOMRenderer$1 } from '@lytjs/renderer';
 import { deepClone } from '@lytjs/common-object';
 import { compile } from '@lytjs/compiler';
@@ -923,6 +922,9 @@ function createApp(rootComponent, rootProps = null, options) {
   const app = {
     config: createContextConfig(context),
     use(plugin, ...options2) {
+      if (plugin == null) {
+        return app;
+      }
       if (installedPlugins.has(plugin)) return app;
       try {
         if (typeof plugin !== "function" && "name" in plugin && typeof plugin.name === "string") {
@@ -955,7 +957,9 @@ function createApp(rootComponent, rootProps = null, options) {
               return app;
             }
           }
-          plugin.install(app, ...options2);
+          if (typeof plugin.install === "function") {
+            plugin.install(app, ...options2);
+          }
           pluginRegistry.markInstalled(enhancedPlugin.name);
           if (enhancedPlugin.afterInstall) {
             enhancedPlugin.afterInstall(app);
@@ -963,7 +967,7 @@ function createApp(rootComponent, rootProps = null, options) {
         } else {
           if (typeof plugin === "function") {
             plugin(app, ...options2);
-          } else {
+          } else if (plugin && typeof plugin.install === "function") {
             plugin.install(app, ...options2);
           }
         }
@@ -3234,6 +3238,93 @@ var init_common_integration = __esm({
     _integrations = {};
   }
 });
+function setGlobalErrorReporter(reporter) {
+  globalReporter = reporter;
+}
+function getGlobalErrorReporter() {
+  return globalReporter;
+}
+function createElement(type, props, ...children) {
+  return createVNode(type, props, children);
+}
+function ErrorBoundary(props) {
+  props.maxRetries ?? 3;
+  props.retryDelay ?? 1e3;
+  const state = {
+    resetKey: 0};
+  return createElement("error-boundary-wrapper", {
+    "data-error": "false",
+    key: `reset-${state.resetKey}`
+  }, null);
+}
+function useErrorHandler() {
+  return (error3) => {
+    throw error3;
+  };
+}
+function useErrorBoundaryReset() {
+  return () => {
+    console.warn("useErrorBoundaryReset should be used within ErrorBoundary");
+  };
+}
+var ConsoleErrorReporter, globalReporter, ErrorLogManager, errorLogManager;
+var init_error_boundary = __esm({
+  "src/error-boundary.ts"() {
+    ConsoleErrorReporter = class {
+      report(error3, context) {
+        console.error("[LytJS ErrorBoundary]", {
+          message: error3.message,
+          stack: error3.stack,
+          context
+        });
+      }
+    };
+    globalReporter = new ConsoleErrorReporter();
+    ErrorLogManager = class {
+      constructor() {
+        this.logs = [];
+        this.maxLogs = 100;
+      }
+      addLog(log) {
+        this.logs.unshift(log);
+        if (this.logs.length > this.maxLogs) {
+          this.logs = this.logs.slice(0, this.maxLogs);
+        }
+      }
+      getLogs() {
+        return [...this.logs];
+      }
+      clearLogs() {
+        this.logs = [];
+      }
+      exportLogs() {
+        return JSON.stringify(this.logs, null, 2);
+      }
+      getLogById(id) {
+        return this.logs.find((log) => log.id === id);
+      }
+      getLogsByErrorType(errorType) {
+        return this.logs.filter((log) => log.error.name === errorType);
+      }
+      getLogsByDateRange(start, end) {
+        return this.logs.filter((log) => log.timestamp >= start && log.timestamp <= end);
+      }
+      getErrorStats() {
+        const errorTypes = {};
+        this.logs.forEach((log) => {
+          const type = log.error.name || "Unknown";
+          errorTypes[type] = (errorTypes[type] || 0) + 1;
+        });
+        return {
+          totalErrors: this.logs.length,
+          errorTypes,
+          recentErrors: this.logs.slice(0, 10)
+        };
+      }
+    };
+    errorLogManager = new ErrorLogManager();
+  }
+});
 
 // src/index.ts
 var src_exports = {};
@@ -3242,6 +3333,7 @@ __export(src_exports, {
   ConfigManager: () => ConfigManager,
   ConfigTransformer: () => ConfigTransformer,
   ConfigValidator: () => ConfigValidator,
+  ErrorBoundary: () => ErrorBoundary,
   Fragment: () => Fragment,
   PluginRegistry: () => PluginRegistry,
   PluginValidator: () => PluginValidator,
@@ -3261,9 +3353,11 @@ __export(src_exports, {
   defineModel: () => defineModel,
   definePlugin: () => definePlugin,
   effect: () => effect,
+  errorLogManager: () => errorLogManager,
   getCacheUtils: () => getCacheUtils,
   getConfig: () => getConfig,
   getGlobalConfig: () => getGlobalConfig,
+  getGlobalErrorReporter: () => getGlobalErrorReporter,
   getHttpClient: () => getHttpClient,
   getQueryUtils: () => getQueryUtils,
   getSecurityUtils: () => getSecurityUtils,
@@ -3294,12 +3388,15 @@ __export(src_exports, {
   safeParseQueryString: () => safeParseQueryString,
   setConfig: () => setConfig,
   setGlobalConfig: () => setGlobalConfig,
+  setGlobalErrorReporter: () => setGlobalErrorReporter,
   testPluginInstall: () => testPluginInstall,
   transformConfig: () => transformConfig,
   transformPluginConfig: () => transformPluginConfig,
   useAttrs: () => useAttrs,
   useCssModule: () => useCssModule,
   useCssVars: () => useCssVars,
+  useErrorBoundaryReset: () => useErrorBoundaryReset,
+  useErrorHandler: () => useErrorHandler,
   useHost: () => useHost,
   useId: () => useId,
   useModel: () => useModel,
@@ -3333,10 +3430,11 @@ var init_src = __esm({
     init_plugin_sdk();
     init_config();
     init_common_integration();
+    init_error_boundary();
   }
 });
 init_src();
 
-export { ConfigManager, ConfigTransformer, ConfigValidator, PluginRegistry, PluginValidator, applyConfigPreset, configPresets, createApp, h as createElement, createPluginTester, defineAsyncComponent, defineComponent, defineCustomElement, defineModel, definePlugin, getCacheUtils, getConfig, getGlobalConfig, getHttpClient, getQueryUtils, getSecurityUtils, h, injectChildStyles, mergeConfig, mergePluginConfig, registerIntegrations, resolveComponent, resolveDirective, resolveDynamicComponent, safeEscapeHtml, safeParseQueryString, setConfig, setGlobalConfig, testPluginInstall, transformConfig, transformPluginConfig, useAttrs, useCssModule, useCssVars, useHost, useId, useModel, useShadowRoot, useSlots, useTemplateRef, useWebComponentSlots, validateConfig, validatePluginConfig, watchConfig, withDirectives, withMemo };
+export { ConfigManager, ConfigTransformer, ConfigValidator, ErrorBoundary, PluginRegistry, PluginValidator, 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 };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map