@vlian/framework 1.2.19 → 1.2.25

package/dist/core/types.d.ts

@@ -2,7 +2,7 @@ import { LogLevel } from '../utils';
 import type { LangType } from '../library/locale/types';
 import { Container, RootOptions } from 'react-dom/client';
 import { type ComponentType, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';
-import { type InitializationContext, type ConfigStrategy } from './initialization';
+import { type InitializationContext } from './initialization';
 import type { StorageOptions } from '../types';
 import type { ThemeConfig } from './app';
 import type { FrameworkError } from '../utils/errors';
@@ -176,10 +176,6 @@ export interface StartOptions {
      * 国际化
      */
     locale?: Record<LangType, Record<string, unknown>>;
-    /**
-     * 配置加载策略
-     */
-    configStrategy?: ConfigStrategy;
     /**
      * 启动页完成回调
      * 仅在显示启动页时，启动页完成初始化后调用

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["import { LogLevel } from '../utils';\nimport type { LangType } from '../library/locale/types';\nimport { Container, RootOptions } from 'react-dom/client';\nimport { type ComponentType, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';\nimport { type InitializationContext, type ConfigStrategy } from './initialization';\nimport type { StorageOptions } from '../types';\nimport type { ThemeConfig } from './app';\nimport type { FrameworkError } from '../utils/errors';\nimport type { RouterConfig } from './router/types';\n\nexport type UIProviderConfig = Record<string, unknown>;\nexport type UIAppConfig = Record<string, unknown>;\nexport type GlobalProviderComponent = ComponentType<PropsWithChildren>;\nexport type GlobalProviderLoader = () => Promise<{ default: GlobalProviderComponent }>;\n\n/**\n * 生命周期钩子函数类型\n */\nexport type ManagerLifecycle = {\n    /**\n     * 在初始化之前执行\n     */\n    beforeInitialization?: () => Promise<void> | void;\n\n    /**\n     * 初始化\n     */\n    initialization?: () => Promise<void> | void;\n\n    /**\n     * 在初始化之后执行\n     * \n     * @param context - 初始化上下文，包含配置、进度、耗时等信息\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   lifecycle: {\n     *     afterInitialization: (context) => {\n     *       console.log('初始化完成', context);\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    afterInitialization?: (context: InitializationContext) => Promise<void> | void;\n};\n\n\n/**\n * 启动配置选项\n */\nexport interface StartOptions {\n    /**\n     * React 应用的挂载容器\n     * \n     * 用于指定 React 应用渲染的目标 DOM 元素。如果不提供，框架将自动查找页面中\n     * 的根元素（通常为 id=\"root\" 的元素）作为默认容器。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * // 使用默认容器（自动查找 id=\"root\" 的元素）\n     * start({});\n     * \n     * // 指定自定义容器\n     * const container = document.getElementById('app');\n     * start({ container });\n     * ```\n     */\n    container?: Container;\n    /**\n     * React 根节点的配置选项\n     * \n     * 用于配置 React 18+ 的 createRoot 方法的选项，包括：\n     * - `onRecoverableError`: 错误恢复回调函数\n     * - `identifierPrefix`: 用于标识符前缀，用于服务端渲染的 hydration\n     * \n     * 这些选项将传递给 `react-dom/client` 的 `createRoot` 方法。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * start({\n     *   rootOptions: {\n     *     onRecoverableError: (error) => {\n     *       console.error('React 错误恢复:', error);\n     *     },\n     *     identifierPrefix: 'my-app-',\n     *   },\n     * });\n     * ```\n     */\n    rootOptions?: RootOptions;\n    /**\n     * 应用根组件\n     * \n     * 用于指定要渲染的 React 应用根组件。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * import App from './App';\n     * \n     * start({\n     *   app: <App />,\n     * });\n     * ```\n     */\n    app?: ReactElement;\n    /**\n     * 是否显示启动页\n     * - 'auto': 自动判断（推荐）\n     * - 'always': 总是显示\n     * - 'never': 从不显示\n     * - 'first-time-only': 仅首次加载显示\n     * \n     * @default 'auto'\n     */\n    showSplashScreen?: 'auto' | 'always' | 'never' | 'first-time-only';\n\n    /**\n     * 启动页最小显示时间（毫秒）\n     * \n     * 用于避免启动页闪烁，确保用户能看到启动过程。\n     * 如果初始化完成时间小于此值，将等待至最小时间后再隐藏启动页。\n     * \n     * @default 500\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   minSplashScreenTime: 1000, // 至少显示 1 秒\n     * });\n     * ```\n     */\n    minSplashScreenTime?: number;\n\n    /**\n     * 路由配置\n     * \n     * 配置应用的路由系统，支持内置路由、自定义路由和禁用路由三种模式。\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   router: {\n     *     enabled: true,\n     *     routes: [\n     *       {\n     *         path: '/login',\n     *         page: LoginPage,\n     *       },\n     *       {\n     *         path: '/',\n     *         layout: MainLayout,\n     *         children: [\n     *           {\n     *             path: 'dashboard',\n     *             page: DashboardPage,\n     *             meta: { title: '仪表盘' },\n     *           },\n     *         ],\n     *       },\n     *     ],\n     *   },\n     * });\n     * ```\n     */\n    router?: RouterConfig;\n    /**\n     * 日志级别\n     */\n    loggerLevel?: LogLevel;\n    /**\n     * 生命周期钩子\n     */\n    lifecycle?: ManagerLifecycle;\n    /**\n     * 国际化\n     */\n    locale?: Record<LangType, Record<string, unknown>>;\n    /**\n     * 配置加载策略\n     */\n    configStrategy?: ConfigStrategy;\n    /**\n     * 启动页完成回调\n     * 仅在显示启动页时，启动页完成初始化后调用\n     * 可以在这里执行额外的操作，然后调用 complete() 继续\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   onSplashComplete: (complete, context) => {\n     *     // 执行额外操作\n     *     await doSomething();\n     *     // 完成后继续\n     *     complete();\n     *   },\n     * });\n     * ```\n     */\n    onSplashComplete?: (\n        complete: () => void,\n        context: InitializationContext\n    ) => Promise<void> | void;\n\n    /**\n     * 存储配置\n     */\n    storageOptions?: StorageOptions;\n\n    /**\n     * IndexedDB 表名\n     */\n    indexedDBTableName?: string;\n\n    /**\n     * UI Provider 配置（框架无关）\n     * 可由 UI 适配器消费，适配到 antd/shadcn 等实现。\n     */\n    uiProvider?: UIProviderConfig;\n\n    /**\n     * UI App 基础配置（框架无关）\n     * 可用于通知、弹窗、消息容器等能力的统一注入。\n     */\n    uiApp?: UIAppConfig;\n\n    /**\n     * 全局 UI 包裹组件懒加载器\n     * \n     * 组件会在 BasicLayout 中统一包裹 children。\n     * 需返回带 default 导出的 React 组件模块。\n     *\n     * @example\n     * ```typescript\n     * start({\n     *   globalProvider: () => import('./components/AntdGlobalProvider'),\n     * });\n     * ```\n     */\n    globalProvider?: GlobalProviderLoader;\n\n    /**\n     * @deprecated 使用 uiProvider 替代\n     */\n    antd?: Record<string, unknown>;\n\n    /**\n     * @deprecated 使用 uiApp 替代\n     */\n    antdApp?: Record<string, unknown>;\n\n    /**\n     * 主题配置\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   theme: {\n     *     mode: 'dark',\n     *     primaryColor: '#1890ff',\n     *   },\n     * });\n     * ```\n     */\n    theme?: ThemeConfig;\n\n    /**\n     * 运行时安全配置\n     */\n    runtimeSecurity?: import('../utils/runtimeSecurity').RuntimeSecurityOptions;\n\n    /**\n     * 配置安全选项\n     */\n    configSecurity?: import('../utils/configSecurity').ConfigSecurityOptions;\n\n    /**\n     * 性能监控配置\n     */\n    performanceMonitor?: import('../utils/performance').PerformanceMonitorConfig;\n\n    /**\n     * 错误监控配置\n     */\n    errorMonitor?: import('../utils/monitoring').ErrorMonitorConfig;\n\n    /**\n     * 分析服务配置\n     */\n    analytics?: import('../utils/analytics').AnalyticsConfig;\n\n    /**\n     * 状态管理器配置\n     * \n     * 配置框架的状态管理器，支持自定义适配器和作用域设置。\n     * 如果不提供，将使用默认配置创建状态管理器。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * start({\n     *   stateManager: {\n     *     enableRegistry: true,\n     *     defaultScope: 'app',\n     *     devMode: true,\n     *   },\n     * });\n     * ```\n     */\n    stateManager?: import('../state').StateManagerOptions;\n\n    /**\n     * 事件总线配置\n     * \n     * 配置应用级事件系统，支持事件追踪、性能监控、安全模式等。\n     * 如果不提供，将使用默认配置创建事件总线。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * start({\n     *   eventBus: {\n     *     enableTracking: true,\n     *     maxHistorySize: 200,\n     *     enablePerformanceMonitoring: true,\n     *     namespacePrefix: 'my-app:',\n     *   },\n     * });\n     * ```\n     */\n    eventBus?: {\n      enableTracking?: boolean;\n      maxHistorySize?: number;\n      enableValidation?: boolean;\n      validator?: (event: string, data: unknown) => boolean;\n      enablePerformanceMonitoring?: boolean;\n      namespacePrefix?: string;\n      instanceId?: string;\n      enableSecurityMode?: boolean;\n      allowedSources?: string[];\n    };\n\n    /**\n     * 自定义启动屏组件\n     * \n     * 如果提供，将使用自定义组件替代默认的启动屏 UI。\n     * 自定义组件将接收初始化进度、当前步骤和初始化状态作为 props。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * const CustomSplashScreen = ({ progress, currentStep, isInitializing }) => {\n     *   return (\n     *     <div>\n     *       <h1>加载中...</h1>\n     *       <div>进度: {progress}%</div>\n     *       <div>步骤: {currentStep}</div>\n     *     </div>\n     *   );\n     * };\n     * \n     * start({\n     *   splashScreen: CustomSplashScreen,\n     * });\n     * ```\n     */\n    splashScreen?: React.ComponentType<SplashScreenCustomProps>;\n\n    /**\n     * 自定义错误反馈组件\n     * \n     * 如果提供，将使用自定义的错误 UI 替代默认错误 UI。\n     * 自定义组件将接收错误对象和重置函数作为参数。\n     * \n     * @param error - 标准化后的框架错误对象\n     * @param resetError - 重置错误边界的函数，调用后可以尝试重新渲染子组件\n     * @returns 错误 UI 的 React 节点\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * start({\n     *   errorFallback: (error, reset) => (\n     *     <div>\n     *       <h2>自定义错误标题</h2>\n     *       <p>{error.message}</p>\n     *       <button onClick={reset}>重试</button>\n     *     </div>\n     *   ),\n     * });\n     * ```\n     */\n    errorFallback?: (error: FrameworkError, resetError: () => void) => ReactNode;\n\n    /**\n     * 安全配置选项\n     * \n     * 用于配置框架的安全策略，包括 XSS 防护、配置验证等。\n     * 框架默认启用所有安全策略，确保应用安全。\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   security: {\n     *     enableXSSProtection: true, // 默认启用\n     *     validateConfig: true, // 默认启用\n     *     sanitizeUserInput: true, // 默认启用\n     *   },\n     * });\n     * ```\n     */\n    security?: {\n        /**\n         * 是否启用 XSS 防护\n         * @default true\n         */\n        enableXSSProtection?: boolean;\n        /**\n         * 是否验证配置项安全性\n         * @default true\n         */\n        validateConfig?: boolean;\n        /**\n         * 是否清理用户输入\n         * @default true\n         */\n        sanitizeUserInput?: boolean;\n        /**\n         * CSP（内容安全策略）配置\n         */\n        csp?: {\n            defaultSrc?: string[];\n            scriptSrc?: string[];\n            styleSrc?: string[];\n            imgSrc?: string[];\n            connectSrc?: string[];\n            fontSrc?: string[];\n            frameSrc?: string[];\n            allowUnsafeInline?: boolean;\n            allowUnsafeEval?: boolean;\n        };\n        /**\n         * CSRF 防护配置\n         */\n        csrf?: {\n            /**\n             * 是否启用 CSRF 防护\n             * @default true\n             */\n            enabled?: boolean;\n            /**\n             * CSRF Token 获取函数\n             * 如果不提供，框架会自动从 cookie 或 header 中获取\n             */\n            getToken?: () => string | Promise<string>;\n            /**\n             * CSRF Token 验证函数\n             * 如果不提供，框架会使用默认验证逻辑\n             */\n            validateToken?: (token: string) => boolean | Promise<boolean>;\n            /**\n             * CSRF Token 请求头名称\n             * @default 'X-CSRF-Token'\n             */\n            headerName?: string;\n            /**\n             * CSRF Token Cookie 名称\n             * @default 'csrf-token'\n             */\n            cookieName?: string;\n        };\n    };\n    \n    /**\n     * 服务初始化重试配置\n     * \n     * 用于配置服务初始化失败时的重试策略。\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   serviceRetry: {\n     *     maxRetries: 3,\n     *     retryDelay: 1000,\n     *     exponentialBackoff: true,\n     *   },\n     * });\n     * ```\n     */\n    serviceRetry?: {\n        /**\n         * 最大重试次数\n         * @default 3\n         */\n        maxRetries?: number;\n        /**\n         * 重试延迟（毫秒）\n         * @default 1000\n         */\n        retryDelay?: number;\n        /**\n         * 是否启用指数退避\n         * @default true\n         */\n        exponentialBackoff?: boolean;\n    };\n}\n\n/**\n * 自定义启动屏组件的 Props\n */\nexport interface SplashScreenCustomProps {\n    /**\n     * 初始化进度（0-100）\n     */\n    progress: number;\n\n    /**\n     * 当前步骤描述\n     */\n    currentStep: string;\n\n    /**\n     * 是否正在初始化\n     */\n    isInitializing: boolean;\n}\n"],"names":[],"mappings":"AAqgBA;;CAEC,GACD,WAeC"}
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["import { LogLevel } from '../utils';\nimport type { LangType } from '../library/locale/types';\nimport { Container, RootOptions } from 'react-dom/client';\nimport { type ComponentType, type PropsWithChildren, type ReactElement, type ReactNode } from 'react';\nimport { type InitializationContext } from './initialization';\nimport type { StorageOptions } from '../types';\nimport type { ThemeConfig } from './app';\nimport type { FrameworkError } from '../utils/errors';\nimport type { RouterConfig } from './router/types';\n\nexport type UIProviderConfig = Record<string, unknown>;\nexport type UIAppConfig = Record<string, unknown>;\nexport type GlobalProviderComponent = ComponentType<PropsWithChildren>;\nexport type GlobalProviderLoader = () => Promise<{ default: GlobalProviderComponent }>;\n\n/**\n * 生命周期钩子函数类型\n */\nexport type ManagerLifecycle = {\n    /**\n     * 在初始化之前执行\n     */\n    beforeInitialization?: () => Promise<void> | void;\n\n    /**\n     * 初始化\n     */\n    initialization?: () => Promise<void> | void;\n\n    /**\n     * 在初始化之后执行\n     * \n     * @param context - 初始化上下文，包含配置、进度、耗时等信息\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   lifecycle: {\n     *     afterInitialization: (context) => {\n     *       console.log('初始化完成', context);\n     *     },\n     *   },\n     * });\n     * ```\n     */\n    afterInitialization?: (context: InitializationContext) => Promise<void> | void;\n};\n\n\n/**\n * 启动配置选项\n */\nexport interface StartOptions {\n    /**\n     * React 应用的挂载容器\n     * \n     * 用于指定 React 应用渲染的目标 DOM 元素。如果不提供，框架将自动查找页面中\n     * 的根元素（通常为 id=\"root\" 的元素）作为默认容器。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * // 使用默认容器（自动查找 id=\"root\" 的元素）\n     * start({});\n     * \n     * // 指定自定义容器\n     * const container = document.getElementById('app');\n     * start({ container });\n     * ```\n     */\n    container?: Container;\n    /**\n     * React 根节点的配置选项\n     * \n     * 用于配置 React 18+ 的 createRoot 方法的选项，包括：\n     * - `onRecoverableError`: 错误恢复回调函数\n     * - `identifierPrefix`: 用于标识符前缀，用于服务端渲染的 hydration\n     * \n     * 这些选项将传递给 `react-dom/client` 的 `createRoot` 方法。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * start({\n     *   rootOptions: {\n     *     onRecoverableError: (error) => {\n     *       console.error('React 错误恢复:', error);\n     *     },\n     *     identifierPrefix: 'my-app-',\n     *   },\n     * });\n     * ```\n     */\n    rootOptions?: RootOptions;\n    /**\n     * 应用根组件\n     * \n     * 用于指定要渲染的 React 应用根组件。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * import App from './App';\n     * \n     * start({\n     *   app: <App />,\n     * });\n     * ```\n     */\n    app?: ReactElement;\n    /**\n     * 是否显示启动页\n     * - 'auto': 自动判断（推荐）\n     * - 'always': 总是显示\n     * - 'never': 从不显示\n     * - 'first-time-only': 仅首次加载显示\n     * \n     * @default 'auto'\n     */\n    showSplashScreen?: 'auto' | 'always' | 'never' | 'first-time-only';\n\n    /**\n     * 启动页最小显示时间（毫秒）\n     * \n     * 用于避免启动页闪烁，确保用户能看到启动过程。\n     * 如果初始化完成时间小于此值，将等待至最小时间后再隐藏启动页。\n     * \n     * @default 500\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   minSplashScreenTime: 1000, // 至少显示 1 秒\n     * });\n     * ```\n     */\n    minSplashScreenTime?: number;\n\n    /**\n     * 路由配置\n     * \n     * 配置应用的路由系统，支持内置路由、自定义路由和禁用路由三种模式。\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   router: {\n     *     enabled: true,\n     *     routes: [\n     *       {\n     *         path: '/login',\n     *         page: LoginPage,\n     *       },\n     *       {\n     *         path: '/',\n     *         layout: MainLayout,\n     *         children: [\n     *           {\n     *             path: 'dashboard',\n     *             page: DashboardPage,\n     *             meta: { title: '仪表盘' },\n     *           },\n     *         ],\n     *       },\n     *     ],\n     *   },\n     * });\n     * ```\n     */\n    router?: RouterConfig;\n    /**\n     * 日志级别\n     */\n    loggerLevel?: LogLevel;\n    /**\n     * 生命周期钩子\n     */\n    lifecycle?: ManagerLifecycle;\n    /**\n     * 国际化\n     */\n    locale?: Record<LangType, Record<string, unknown>>;\n    /**\n     * 启动页完成回调\n     * 仅在显示启动页时，启动页完成初始化后调用\n     * 可以在这里执行额外的操作，然后调用 complete() 继续\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   onSplashComplete: (complete, context) => {\n     *     // 执行额外操作\n     *     await doSomething();\n     *     // 完成后继续\n     *     complete();\n     *   },\n     * });\n     * ```\n     */\n    onSplashComplete?: (\n        complete: () => void,\n        context: InitializationContext\n    ) => Promise<void> | void;\n\n    /**\n     * 存储配置\n     */\n    storageOptions?: StorageOptions;\n\n    /**\n     * IndexedDB 表名\n     */\n    indexedDBTableName?: string;\n\n    /**\n     * UI Provider 配置（框架无关）\n     * 可由 UI 适配器消费，适配到 antd/shadcn 等实现。\n     */\n    uiProvider?: UIProviderConfig;\n\n    /**\n     * UI App 基础配置（框架无关）\n     * 可用于通知、弹窗、消息容器等能力的统一注入。\n     */\n    uiApp?: UIAppConfig;\n\n    /**\n     * 全局 UI 包裹组件懒加载器\n     * \n     * 组件会在 BasicLayout 中统一包裹 children。\n     * 需返回带 default 导出的 React 组件模块。\n     *\n     * @example\n     * ```typescript\n     * start({\n     *   globalProvider: () => import('./components/AntdGlobalProvider'),\n     * });\n     * ```\n     */\n    globalProvider?: GlobalProviderLoader;\n\n    /**\n     * @deprecated 使用 uiProvider 替代\n     */\n    antd?: Record<string, unknown>;\n\n    /**\n     * @deprecated 使用 uiApp 替代\n     */\n    antdApp?: Record<string, unknown>;\n\n    /**\n     * 主题配置\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   theme: {\n     *     mode: 'dark',\n     *     primaryColor: '#1890ff',\n     *   },\n     * });\n     * ```\n     */\n    theme?: ThemeConfig;\n\n    /**\n     * 运行时安全配置\n     */\n    runtimeSecurity?: import('../utils/runtimeSecurity').RuntimeSecurityOptions;\n\n    /**\n     * 配置安全选项\n     */\n    configSecurity?: import('../utils/configSecurity').ConfigSecurityOptions;\n\n    /**\n     * 性能监控配置\n     */\n    performanceMonitor?: import('../utils/performance').PerformanceMonitorConfig;\n\n    /**\n     * 错误监控配置\n     */\n    errorMonitor?: import('../utils/monitoring').ErrorMonitorConfig;\n\n    /**\n     * 分析服务配置\n     */\n    analytics?: import('../utils/analytics').AnalyticsConfig;\n\n    /**\n     * 状态管理器配置\n     * \n     * 配置框架的状态管理器，支持自定义适配器和作用域设置。\n     * 如果不提供，将使用默认配置创建状态管理器。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * start({\n     *   stateManager: {\n     *     enableRegistry: true,\n     *     defaultScope: 'app',\n     *     devMode: true,\n     *   },\n     * });\n     * ```\n     */\n    stateManager?: import('../state').StateManagerOptions;\n\n    /**\n     * 事件总线配置\n     * \n     * 配置应用级事件系统，支持事件追踪、性能监控、安全模式等。\n     * 如果不提供，将使用默认配置创建事件总线。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * start({\n     *   eventBus: {\n     *     enableTracking: true,\n     *     maxHistorySize: 200,\n     *     enablePerformanceMonitoring: true,\n     *     namespacePrefix: 'my-app:',\n     *   },\n     * });\n     * ```\n     */\n    eventBus?: {\n      enableTracking?: boolean;\n      maxHistorySize?: number;\n      enableValidation?: boolean;\n      validator?: (event: string, data: unknown) => boolean;\n      enablePerformanceMonitoring?: boolean;\n      namespacePrefix?: string;\n      instanceId?: string;\n      enableSecurityMode?: boolean;\n      allowedSources?: string[];\n    };\n\n    /**\n     * 自定义启动屏组件\n     * \n     * 如果提供，将使用自定义组件替代默认的启动屏 UI。\n     * 自定义组件将接收初始化进度、当前步骤和初始化状态作为 props。\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * \n     * const CustomSplashScreen = ({ progress, currentStep, isInitializing }) => {\n     *   return (\n     *     <div>\n     *       <h1>加载中...</h1>\n     *       <div>进度: {progress}%</div>\n     *       <div>步骤: {currentStep}</div>\n     *     </div>\n     *   );\n     * };\n     * \n     * start({\n     *   splashScreen: CustomSplashScreen,\n     * });\n     * ```\n     */\n    splashScreen?: React.ComponentType<SplashScreenCustomProps>;\n\n    /**\n     * 自定义错误反馈组件\n     * \n     * 如果提供，将使用自定义的错误 UI 替代默认错误 UI。\n     * 自定义组件将接收错误对象和重置函数作为参数。\n     * \n     * @param error - 标准化后的框架错误对象\n     * @param resetError - 重置错误边界的函数，调用后可以尝试重新渲染子组件\n     * @returns 错误 UI 的 React 节点\n     * \n     * @example\n     * ```typescript\n     * import { start } from '@vlian/framework';\n     * start({\n     *   errorFallback: (error, reset) => (\n     *     <div>\n     *       <h2>自定义错误标题</h2>\n     *       <p>{error.message}</p>\n     *       <button onClick={reset}>重试</button>\n     *     </div>\n     *   ),\n     * });\n     * ```\n     */\n    errorFallback?: (error: FrameworkError, resetError: () => void) => ReactNode;\n\n    /**\n     * 安全配置选项\n     * \n     * 用于配置框架的安全策略，包括 XSS 防护、配置验证等。\n     * 框架默认启用所有安全策略，确保应用安全。\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   security: {\n     *     enableXSSProtection: true, // 默认启用\n     *     validateConfig: true, // 默认启用\n     *     sanitizeUserInput: true, // 默认启用\n     *   },\n     * });\n     * ```\n     */\n    security?: {\n        /**\n         * 是否启用 XSS 防护\n         * @default true\n         */\n        enableXSSProtection?: boolean;\n        /**\n         * 是否验证配置项安全性\n         * @default true\n         */\n        validateConfig?: boolean;\n        /**\n         * 是否清理用户输入\n         * @default true\n         */\n        sanitizeUserInput?: boolean;\n        /**\n         * CSP（内容安全策略）配置\n         */\n        csp?: {\n            defaultSrc?: string[];\n            scriptSrc?: string[];\n            styleSrc?: string[];\n            imgSrc?: string[];\n            connectSrc?: string[];\n            fontSrc?: string[];\n            frameSrc?: string[];\n            allowUnsafeInline?: boolean;\n            allowUnsafeEval?: boolean;\n        };\n        /**\n         * CSRF 防护配置\n         */\n        csrf?: {\n            /**\n             * 是否启用 CSRF 防护\n             * @default true\n             */\n            enabled?: boolean;\n            /**\n             * CSRF Token 获取函数\n             * 如果不提供，框架会自动从 cookie 或 header 中获取\n             */\n            getToken?: () => string | Promise<string>;\n            /**\n             * CSRF Token 验证函数\n             * 如果不提供，框架会使用默认验证逻辑\n             */\n            validateToken?: (token: string) => boolean | Promise<boolean>;\n            /**\n             * CSRF Token 请求头名称\n             * @default 'X-CSRF-Token'\n             */\n            headerName?: string;\n            /**\n             * CSRF Token Cookie 名称\n             * @default 'csrf-token'\n             */\n            cookieName?: string;\n        };\n    };\n    \n    /**\n     * 服务初始化重试配置\n     * \n     * 用于配置服务初始化失败时的重试策略。\n     * \n     * @example\n     * ```typescript\n     * start({\n     *   serviceRetry: {\n     *     maxRetries: 3,\n     *     retryDelay: 1000,\n     *     exponentialBackoff: true,\n     *   },\n     * });\n     * ```\n     */\n    serviceRetry?: {\n        /**\n         * 最大重试次数\n         * @default 3\n         */\n        maxRetries?: number;\n        /**\n         * 重试延迟（毫秒）\n         * @default 1000\n         */\n        retryDelay?: number;\n        /**\n         * 是否启用指数退避\n         * @default true\n         */\n        exponentialBackoff?: boolean;\n    };\n}\n\n/**\n * 自定义启动屏组件的 Props\n */\nexport interface SplashScreenCustomProps {\n    /**\n     * 初始化进度（0-100）\n     */\n    progress: number;\n\n    /**\n     * 当前步骤描述\n     */\n    currentStep: string;\n\n    /**\n     * 是否正在初始化\n     */\n    isInitializing: boolean;\n}\n"],"names":[],"mappings":"AAigBA;;CAEC,GACD,WAeC"}

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * @vlian/framework v1.2.19
+ * @vlian/framework v1.2.25
  * Secra Framework - 一个现代化的低代码框架
  * (c) 2026 Secra Framework Contributors
  * Licensed under Apache-2.0
@@ -17676,7 +17676,7 @@
         }
         /**
        * 获取单例实例
-       * 
+       *
        * @returns Singleton 实例
        */ static getInstance() {
             if (!Storage.instance) {
@@ -20446,7 +20446,7 @@
     }
     /**
      * 插件管理器
-     * 
+     *
      * 优化：
      * 1. 支持插件依赖管理
      * 2. 支持插件优先级控制
@@ -20455,7 +20455,7 @@
      */ let PluginManager$1 = class PluginManager {
         /**
        * 注册插件
-       * 
+       *
        * 优化：检查插件依赖是否已注册
        */ register(plugin) {
             if (this.plugins.has(plugin.name)) {
@@ -20488,7 +20488,7 @@
         }
         /**
        * 获取插件加载顺序（考虑依赖和优先级）
-       * 
+       *
        * @returns 插件名称数组，按加载顺序排列
        */ getLoadOrder() {
             const plugins = Array.from(this.plugins.values());
@@ -20540,7 +20540,7 @@
         }
         /**
        * 动态加载插件（热插拔）
-       * 
+       *
        * @param options - 插件加载选项
        * @returns 加载的插件
        */ async loadPlugin(options) {
@@ -20584,7 +20584,7 @@
         }
         /**
        * 初始化单个插件
-       * 
+       *
        * @param name - 插件名称
        * @param options - 启动选项
        * @param context - 初始化上下文
@@ -20615,7 +20615,7 @@
         }
         /**
        * 卸载插件（热插拔）
-       * 
+       *
        * @param name - 插件名称
        * @param force - 是否强制卸载（即使有依赖）
        */ async unloadPlugin(name, force = false) {
@@ -20647,7 +20647,7 @@
         }
         /**
        * 检查插件是否可以热加载
-       * 
+       *
        * @param plugin - 插件
        * @returns 是否可以热加载
        */ canHotLoad(plugin) {
@@ -20662,7 +20662,7 @@
         }
         /**
        * 注册插件加载器（用于延迟加载）
-       * 
+       *
        * @param name - 插件名称
        * @param loader - 加载器函数
        */ registerLoader(name, loader) {
@@ -20670,7 +20670,7 @@
         }
         /**
        * 使用加载器加载插件
-       * 
+       *
        * @param name - 插件名称
        * @param options - 加载选项
        * @returns 加载的插件
@@ -20717,7 +20717,7 @@
         }
         /**
        * 执行初始化前钩子
-       * 
+       *
        * 优化：按依赖顺序执行
        */ async executeBeforeInit(options) {
             const loadOrder = this.getLoadOrder();
@@ -20742,7 +20742,7 @@
         }
         /**
        * 执行初始化钩子
-       * 
+       *
        * 优化：按依赖顺序执行，并更新插件状态
        */ async executeInit(options, context) {
             const loadOrder = this.getLoadOrder();
@@ -20768,7 +20768,7 @@
         }
         /**
        * 执行初始化后钩子
-       * 
+       *
        * 优化：按依赖顺序执行（逆序，确保依赖插件先执行）
        */ async executeAfterInit(options, context) {
             const loadOrder = this.getLoadOrder();
@@ -20797,7 +20797,7 @@
         }
         /**
        * 获取插件状态
-       * 
+       *
        * @param name - 插件名称
        * @returns 插件状态
        */ getPluginStatus(name) {
@@ -20805,7 +20805,7 @@
         }
         /**
        * 检查插件是否已加载
-       * 
+       *
        * @param name - 插件名称
        * @returns 是否已加载
        */ isLoaded(name) {
@@ -20813,21 +20813,21 @@
         }
         /**
        * 获取已加载的插件列表
-       * 
+       *
        * @returns 插件名称数组
        */ getLoadedPlugins() {
             return Array.from(this.plugins.keys());
         }
         /**
        * 获取所有插件状态
-       * 
+       *
        * @returns 插件状态映射
        */ getAllPluginStatus() {
             return new Map(this.pluginStatus);
         }
         /**
        * 获取插件沙箱
-       * 
+       *
        * @param name - 插件名称
        * @returns 插件沙箱或undefined
        */ getSandbox(name) {
@@ -20863,68 +20863,6 @@
      * 默认插件管理器
      */ const pluginManager = new PluginManager$1();
 
-    /**
-     * 配置缓存键
-     */ const CONFIG_CACHE_KEY = '__framework_config_cache__';
-    /**
-     * 加载配置（带超时、重试和缓存）
-     */ async function loadConfigWithRetry(loadConfig, strategy, fallbackConfig) {
-        const timeout = strategy.configTimeout ?? 5000;
-        const retryCount = strategy.retryCount ?? 3;
-        const retryDelay = strategy.retryDelay ?? 1000;
-        const enableCache = strategy.enableCache ?? true;
-        const cacheTTL = strategy.cacheTTL ?? 5 * 60 * 1000; // 5分钟
-        const configVersion = strategy.configVersion;
-        // 检查缓存
-        if (enableCache && storage.localCache) {
-            try {
-                const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;
-                const cached = await storage.localCache.get(cacheKey);
-                if (cached && (!configVersion || cached.version === configVersion)) {
-                    logger.debug('使用缓存的配置');
-                    return cached.data;
-                }
-            } catch (error) {
-                logger.warn('读取配置缓存失败:', error);
-            }
-        }
-        // 重试加载配置
-        let lastError = null;
-        for(let attempt = 0; attempt <= retryCount; attempt++){
-            try {
-                if (attempt > 0) {
-                    logger.debug(`配置加载重试 ${attempt}/${retryCount}`);
-                    // 指数退避
-                    await new Promise((resolve)=>setTimeout(resolve, retryDelay * Math.pow(2, attempt - 1)));
-                }
-                const configPromise = loadConfig();
-                const timeoutPromise = new Promise((_, reject)=>setTimeout(()=>reject(new NetworkError('配置加载超时')), timeout));
-                const config = await Promise.race([
-                    configPromise,
-                    timeoutPromise
-                ]);
-                // 保存到缓存
-                if (enableCache && storage.localCache) {
-                    try {
-                        const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;
-                        await storage.localCache.set(cacheKey, {
-                            data: config,
-                            version: configVersion
-                        }, cacheTTL);
-                    } catch (error) {
-                        logger.warn('保存配置缓存失败:', error);
-                    }
-                }
-                return config;
-            } catch (error) {
-                lastError = error instanceof Error ? error : new Error(String(error));
-                logger.warn(`配置加载失败 (尝试 ${attempt + 1}/${retryCount + 1}):`, lastError);
-            }
-        }
-        // 所有重试都失败，使用降级配置
-        logger.warn('配置加载失败，使用降级配置:', lastError);
-        return fallbackConfig || {};
-    }
     /**
      * 初始化方法
      * 
@@ -20956,89 +20894,8 @@
             // 1. 设置日志级别
             onProgress?.(5, '初始化日志系统...');
             logger.setLevel(options.loggerLevel ?? LogLevel.INFO);
-            // 2. 加载关键配置
-            if (options.configStrategy?.loadCriticalConfig) {
-                onProgress?.(10, '加载关键配置...');
-                try {
-                    config = await loadConfigWithRetry(options.configStrategy.loadCriticalConfig, options.configStrategy, options.configStrategy.fallbackConfig);
-                    // 验证配置安全性
-                    if (options.configSecurity) {
-                        const securityResult = await ConfigSecurity.validateConfigSecurity(config, options.configSecurity);
-                        if (!securityResult.valid) {
-                            logger.warn('配置安全验证失败:', securityResult.errors);
-                        // 根据安全策略决定是否继续
-                        }
-                    }
-                    options.configStrategy.onConfigLoaded?.(config);
-                    onProgress?.(30, '关键配置加载完成');
-                } catch (error) {
-                    logger.warn('关键配置加载失败，使用默认配置:', error);
-                    config = options.configStrategy.fallbackConfig || {};
-                    options.configStrategy.onConfigLoaded?.(config);
-                    onProgress?.(30, '使用默认配置');
-                }
-            } else {
-                onProgress?.(30);
-            }
-            // 2.5. 渐进式加载非关键配置（在应用渲染后异步加载）
-            if (options.configStrategy?.loadNonCriticalConfig) {
-                // 智能延迟加载：根据网络状况动态调整延迟时间
-                const getDelayTime = ()=>{
-                    if (typeof navigator === 'undefined' || !('connection' in navigator)) {
-                        return 1000; // 默认延迟
-                    }
-                    const connection = navigator.connection;
-                    if (!connection) {
-                        return 1000;
-                    }
-                    // 根据网络类型调整延迟
-                    const effectiveType = connection.effectiveType;
-                    switch(effectiveType){
-                        case 'slow-2g':
-                        case '2g':
-                            return 3000; // 慢网络延迟更久
-                        case '3g':
-                            return 2000;
-                        case '4g':
-                        default:
-                            return 500; // 快网络可以更快加载
-                    }
-                };
-                // 使用 requestIdleCallback 在空闲时加载
-                if (typeof requestIdleCallback !== 'undefined') {
-                    requestIdleCallback(async ()=>{
-                        try {
-                            const nonCriticalConfig = await loadConfigWithRetry(options.configStrategy.loadNonCriticalConfig, options.configStrategy, {});
-                            // 合并到主配置
-                            config = {
-                                ...config,
-                                ...nonCriticalConfig
-                            };
-                            options.configStrategy?.onConfigLoaded?.(config);
-                            logger.debug('非关键配置加载完成');
-                        } catch (error) {
-                            logger.warn('非关键配置加载失败:', error);
-                        }
-                    }, {
-                        timeout: getDelayTime()
-                    });
-                } else {
-                    // 降级方案：智能延迟加载
-                    setTimeout(async ()=>{
-                        try {
-                            const nonCriticalConfig = await loadConfigWithRetry(options.configStrategy.loadNonCriticalConfig, options.configStrategy, {});
-                            config = {
-                                ...config,
-                                ...nonCriticalConfig
-                            };
-                            options.configStrategy?.onConfigLoaded?.(config);
-                            logger.debug('非关键配置加载完成');
-                        } catch (error) {
-                            logger.warn('非关键配置加载失败:', error);
-                        }
-                    }, getDelayTime());
-                }
-            }
+            // 2. 预留配置阶段
+            onProgress?.(30);
             // 3. 初始化之前回调
             if (options.lifecycle?.beforeInitialization) {
                 onProgress?.(35, '执行初始化前回调...');
@@ -25683,8 +25540,13 @@
     const isDevelopment = process.env.NODE_ENV === 'development';
     const RouteErrorBoundary = ({ error, resetErrorBoundary })=>{
         const [showDetails, setShowDetails] = React.useState(false);
-        const errorWithCause = error;
-        const hasCause = 'cause' in error && errorWithCause.cause !== undefined;
+        const errorObject = error !== null && typeof error === 'object' ? error : null;
+        const errorMessage = typeof errorObject?.message === 'string' && errorObject.message !== '' ? errorObject.message : '未知错误';
+        const hasCause = errorObject?.cause !== undefined;
+        const isNotFoundError = errorObject?.status === 404 || typeof errorObject?.statusText === 'string' && /not\s*found/i.test(errorObject.statusText) || /no routes matched location|not found|404/i.test(errorMessage);
+        const title = isNotFoundError ? '页面不存在（404）' : '出错了，请稍后再试';
+        const friendlyMessage = isNotFoundError ? '访问的路由未注册或不存在，请检查访问地址。' : '请稍后再试或联系技术支持';
+        const displayMessage = isDevelopment ? errorMessage : friendlyMessage;
         return /*#__PURE__*/ jsxRuntime.jsx("div", {
             role: "alert",
             style: {
@@ -25707,10 +25569,10 @@
                         style: {
                             marginTop: 0
                         },
-                        children: "出错了，请稍后再试"
+                        children: title
                     }),
                     /*#__PURE__*/ jsxRuntime.jsx("p", {
-                        children: isDevelopment ? error.message : '请稍后再试或联系技术支持'
+                        children: displayMessage
                     }),
                     /*#__PURE__*/ jsxRuntime.jsxs("div", {
                         style: {
@@ -25761,10 +25623,10 @@
                                     /*#__PURE__*/ jsxRuntime.jsx("strong", {
                                         children: "错误信息："
                                     }),
-                                    error.message
+                                    errorMessage
                                 ]
                             }),
-                            error.stack && /*#__PURE__*/ jsxRuntime.jsxs("div", {
+                            errorObject?.stack && /*#__PURE__*/ jsxRuntime.jsxs("div", {
                                 style: {
                                     marginBottom: 10,
                                     whiteSpace: 'pre-wrap',
@@ -25775,7 +25637,7 @@
                                         children: "堆栈："
                                     }),
                                     /*#__PURE__*/ jsxRuntime.jsx("br", {}),
-                                    error.stack
+                                    errorObject.stack
                                 ]
                             }),
                             hasCause && /*#__PURE__*/ jsxRuntime.jsxs("div", {
@@ -25783,7 +25645,7 @@
                                     /*#__PURE__*/ jsxRuntime.jsx("strong", {
                                         children: "原因："
                                     }),
-                                    errorWithCause.cause instanceof Error ? errorWithCause.cause.message : String(errorWithCause.cause)
+                                    errorObject?.cause instanceof Error ? errorObject.cause.message : String(errorObject?.cause)
                                 ]
                             })
                         ]
@@ -29688,8 +29550,7 @@
             const initContext = await initialization({
                 loggerLevel: options.loggerLevel,
                 locale: i18n.resources,
-                lifecycle: options.lifecycle,
-                configStrategy: undefined
+                lifecycle: options.lifecycle
             });
             await options.lifecycle?.afterInitialization?.(initContext);
         });
@@ -29821,8 +29682,6 @@
             // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）
             const kernelRuntime = await startKernel({
                 loggerLevel: options.loggerLevel,
-                configLoader: options.configStrategy?.loadCriticalConfig,
-                configFallback: options.configStrategy?.fallbackConfig,
                 locale: {
                     locale: (options.locale ? Object.keys(options.locale)[0] : 'zh-CN') || 'zh-CN',
                     resources: options.locale
@@ -30370,32 +30229,6 @@
         }
     }
 
-    function buildAntdCompatTheme(theme) {
-        const token = {
-            ...theme.tokens || {}
-        };
-        if (theme.primaryColor) {
-            token.colorPrimary = theme.primaryColor;
-        }
-        return {
-            ...theme.compatibility?.antd || {},
-            token
-        };
-    }
-    function buildShadcnCompatTheme(theme) {
-        const cssVariables = {
-            ...theme.compatibility?.shadcn || {},
-            ...theme.tokens || {}
-        };
-        if (theme.primaryColor) {
-            cssVariables['app-primary-color'] = theme.primaryColor;
-        }
-        return {
-            cssVariables,
-            className: theme.mode === 'dark' ? 'dark' : theme.mode === 'light' ? 'light' : 'system'
-        };
-    }
-
     function _define_property$8(obj, key, value) {
         if (key in obj) {
             Object.defineProperty(obj, key, {
@@ -34173,8 +34006,6 @@
     exports.adapterRegistry = adapterRegistry;
     exports.appConfig = appConfig;
     exports.axiosAdapter = axiosAdapter;
-    exports.buildAntdCompatTheme = buildAntdCompatTheme;
-    exports.buildShadcnCompatTheme = buildShadcnCompatTheme;
     exports.cancelRequestContext = cancelRequestContext;
     exports.clearCurrentTraceId = clearCurrentTraceId;
     exports.commonSchemas = commonSchemas;