@vlian/framework 1.2.37 → 1.2.39

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 } 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('@vlian/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"}
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["import { LogLevel } from '@vlian/logger';\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 '@vlian/utils';\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('@vlian/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.cjs

@@ -15,72 +15,12 @@ _export(exports, {
     get Kernel () {
         return _kernel.Kernel;
     },
-    get MonitoringEventType () {
-        return _request.MonitoringEventType;
-    },
-    get PluginLifecycleStage () {
-        return _request.PluginLifecycleStage;
-    },
-    get PluginPriority () {
-        return _request.PluginPriority;
-    },
-    get RequestClient () {
-        return _request.RequestClient;
-    },
-    get RequestErrorCode () {
-        return _request.RequestErrorCode;
-    },
-    get RequestErrorType () {
-        return _request.RequestErrorType;
-    },
-    get RequestPluginManager () {
-        return _request.PluginManager;
-    },
-    get adapterRegistry () {
-        return _request.adapterRegistry;
-    },
-    get axiosAdapter () {
-        return _request.axiosAdapter;
-    },
-    get cancelRequestContext () {
-        return _request.cancelRequestContext;
-    },
-    get completeRequestContext () {
-        return _request.completeRequestContext;
-    },
-    get createCachePlugin () {
-        return _request.createCachePlugin;
-    },
-    get createMonitoringPlugin () {
-        return _request.createMonitoringPlugin;
-    },
-    get createRequestClient () {
-        return _request.createRequestClient;
-    },
-    get createRequestContext () {
-        return _request.createRequestContext;
-    },
-    get createRetryPlugin () {
-        return _request.createRetryPlugin;
-    },
-    get createValidationPlugin () {
-        return _request.createValidationPlugin;
-    },
-    get failRequestContext () {
-        return _request.failRequestContext;
-    },
-    get fetchAdapter () {
-        return _request.fetchAdapter;
-    },
     get getKernel () {
         return _kernel.getKernel;
     },
     get kernelStartApp () {
         return _kernel.kernelStartApp;
     },
-    get kyAdapter () {
-        return _request.kyAdapter;
-    },
     get setLang () {
         return _library.setLang;
     },
@@ -89,12 +29,6 @@ _export(exports, {
     },
     get startup () {
         return _kernel.startup;
-    },
-    get undiciAdapter () {
-        return undiciAdapter;
-    },
-    get updateRequestContext () {
-        return _request.updateRequestContext;
     }
 });
 const _library = require("./library");
@@ -102,7 +36,6 @@ _export_star(require("./core"), exports);
 _export_star(require("./utils"), exports);
 _export_star(require("./state"), exports);
 _export_star(require("./components"), exports);
-const _request = require("@vlian/request");
 const _kernel = require("./kernel");
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
@@ -117,50 +50,5 @@ function _export_star(from, to) {
     });
     return from;
 }
-function _getRequireWildcardCache(nodeInterop) {
-    if (typeof WeakMap !== "function") return null;
-    var cacheBabelInterop = new WeakMap();
-    var cacheNodeInterop = new WeakMap();
-    return (_getRequireWildcardCache = function(nodeInterop) {
-        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
-    })(nodeInterop);
-}
-function _interop_require_wildcard(obj, nodeInterop) {
-    if (!nodeInterop && obj && obj.__esModule) {
-        return obj;
-    }
-    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
-        return {
-            default: obj
-        };
-    }
-    var cache = _getRequireWildcardCache(nodeInterop);
-    if (cache && cache.has(obj)) {
-        return cache.get(obj);
-    }
-    var newObj = {
-        __proto__: null
-    };
-    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
-    for(var key in obj){
-        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
-            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
-            if (desc && (desc.get || desc.set)) {
-                Object.defineProperty(newObj, key, desc);
-            } else {
-                newObj[key] = obj[key];
-            }
-        }
-    }
-    newObj.default = obj;
-    if (cache) {
-        cache.set(obj, newObj);
-    }
-    return newObj;
-}
-async function undiciAdapter() {
-    const { undiciAdapter: adapter } = await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("@vlian/request")));
-    return adapter();
-}
 
 //# sourceMappingURL=index.js.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { setupI18n, setLang, $t } from './library';\n\nexport * from './core';\nexport * from './utils';\nexport * from './state';\nexport * from './components';\n\n// 导出请求库（使用命名空间避免冲突）\nexport {\n  RequestClient,\n  createRequestClient,\n  adapterRegistry,\n  fetchAdapter,\n  kyAdapter,\n  axiosAdapter,\n  PluginManager as RequestPluginManager,\n  PluginLifecycleStage,\n  PluginPriority,\n  createCachePlugin,\n  createRetryPlugin,\n  createValidationPlugin,\n  createMonitoringPlugin,\n  createRequestContext,\n  updateRequestContext,\n  completeRequestContext,\n  failRequestContext,\n  cancelRequestContext,\n  RequestErrorType,\n  RequestErrorCode,\n} from '@vlian/request';\n\n// undiciAdapter 使用懒加载，避免在未使用时触发依赖检查\nexport async function undiciAdapter() {\n  const { undiciAdapter: adapter } = await import('@vlian/request');\n  return adapter();\n}\n\nexport type {\n  RequestOptions,\n  Response,\n  RequestContext,\n  RequestError,\n  RequestClientConfig,\n  RequestHeaders,\n  RequestQuery,\n  RequestBody,\n  HttpMethod,\n  RetryConfig,\n  CacheConfig,\n  ValidationConfig,\n  AdapterCapabilities,\n  RequestAdapter,\n  AdapterFactory as RequestAdapterFactory,\n  RequestPlugin,\n  CachePluginConfig,\n  RetryPluginConfig,\n  ValidationPluginConfig,\n  MonitoringPluginConfig,\n  MonitoringEvent,\n  MonitoringReporter,\n} from '@vlian/request';\n\nexport { MonitoringEventType } from '@vlian/request';\n\n/**\n * 国际化\n **/\nexport { setupI18n, setLang, $t };\n\n\nexport { Kernel, startup, getKernel, kernelStartApp } from './kernel';\nexport type {\n  KernelStartOptions as KernelStartupOptions,\n  KernelConfig as KernelRuntimeConfig,\n  KernelTimingMetric as KernelRuntimeTimingMetric,\n  KernelManager as RuntimeKernelManager,\n} from './kernel';\n"],"names":["$t","Kernel","MonitoringEventType","PluginLifecycleStage","PluginPriority","RequestClient","RequestErrorCode","RequestErrorType","RequestPluginManager","PluginManager","adapterRegistry","axiosAdapter","cancelRequestContext","completeRequestContext","createCachePlugin","createMonitoringPlugin","createRequestClient","createRequestContext","createRetryPlugin","createValidationPlugin","failRequestContext","fetchAdapter","getKernel","kernelStartApp","kyAdapter","setLang","setupI18n","startup","undiciAdapter","updateRequestContext","adapter"],"mappings":";;;;;;;;;;;QAmE6BA;eAAAA,WAAE;;QAGtBC;eAAAA,cAAM;;QARNC;eAAAA,4BAAmB;;QA9C1BC;eAAAA,6BAAoB;;QACpBC;eAAAA,uBAAc;;QARdC;eAAAA,sBAAa;;QAmBbC;eAAAA,yBAAgB;;QADhBC;eAAAA,yBAAgB;;QAZCC;eAAjBC,sBAAa;;QAJbC;eAAAA,wBAAe;;QAGfC;eAAAA,qBAAY;;QAYZC;eAAAA,6BAAoB;;QAFpBC;eAAAA,+BAAsB;;QANtBC;eAAAA,0BAAiB;;QAGjBC;eAAAA,+BAAsB;;QAXtBC;eAAAA,4BAAmB;;QAYnBC;eAAAA,6BAAoB;;QAHpBC;eAAAA,0BAAiB;;QACjBC;eAAAA,+BAAsB;;QAKtBC;eAAAA,2BAAkB;;QAblBC;eAAAA,qBAAY;;QA0DYC;eAAAA,iBAAS;;QAAEC;eAAAA,sBAAc;;QAzDjDC;eAAAA,kBAAS;;QAsDSC;eAAAA,gBAAO;;QAAlBC;eAAAA,kBAAS;;QAGDC;eAAAA,eAAO;;QAtCFC;eAAAA;;QATpBC;eAAAA,6BAAoB;;;yBAvBiB;qBAEzB;qBACA;qBACA;qBACA;yBAwBP;wBAyCoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAtCpD,eAAeD;IACpB,MAAM,EAAEA,eAAeE,OAAO,EAAE,GAAG,MAAM,mEAAA,QAAO;IAChD,OAAOA;AACT"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { setupI18n, setLang, $t } from './library';\n\nexport * from './core';\nexport * from './utils';\nexport * from './state';\nexport * from './components';\n\n/**\n * 国际化\n **/\nexport { setupI18n, setLang, $t };\n\n\nexport { Kernel, startup, getKernel, kernelStartApp } from './kernel';\nexport type {\n  KernelStartOptions as KernelStartupOptions,\n  KernelConfig as KernelRuntimeConfig,\n  KernelTimingMetric as KernelRuntimeTimingMetric,\n  KernelManager as RuntimeKernelManager,\n} from './kernel';\n"],"names":["$t","Kernel","getKernel","kernelStartApp","setLang","setupI18n","startup"],"mappings":";;;;;;;;;;;QAU6BA;eAAAA,WAAE;;QAGtBC;eAAAA,cAAM;;QAAWC;eAAAA,iBAAS;;QAAEC;eAAAA,sBAAc;;QAH/BC;eAAAA,gBAAO;;QAAlBC;eAAAA,kBAAS;;QAGDC;eAAAA,eAAO;;;yBAbe;qBAEzB;qBACA;qBACA;qBACA;wBAQ6C"}

package/dist/index.d.ts

@@ -3,10 +3,6 @@ export * from './core';
 export * from './utils';
 export * from './state';
 export * from './components';
-export { RequestClient, createRequestClient, adapterRegistry, fetchAdapter, kyAdapter, axiosAdapter, PluginManager as RequestPluginManager, PluginLifecycleStage, PluginPriority, createCachePlugin, createRetryPlugin, createValidationPlugin, createMonitoringPlugin, createRequestContext, updateRequestContext, completeRequestContext, failRequestContext, cancelRequestContext, RequestErrorType, RequestErrorCode, } from '@vlian/request';
-export declare function undiciAdapter(): Promise<import("@vlian/request").RequestAdapter>;
-export type { RequestOptions, Response, RequestContext, RequestError, RequestClientConfig, RequestHeaders, RequestQuery, RequestBody, HttpMethod, RetryConfig, CacheConfig, ValidationConfig, AdapterCapabilities, RequestAdapter, AdapterFactory as RequestAdapterFactory, RequestPlugin, CachePluginConfig, RetryPluginConfig, ValidationPluginConfig, MonitoringPluginConfig, MonitoringEvent, MonitoringReporter, } from '@vlian/request';
-export { MonitoringEventType } from '@vlian/request';
 /**
  * 国际化
  **/

package/dist/index.js

@@ -3,14 +3,6 @@ export * from "./core";
 export * from "./utils";
 export * from "./state";
 export * from "./components";
-// 导出请求库（使用命名空间避免冲突）
-export { RequestClient, createRequestClient, adapterRegistry, fetchAdapter, kyAdapter, axiosAdapter, PluginManager as RequestPluginManager, PluginLifecycleStage, PluginPriority, createCachePlugin, createRetryPlugin, createValidationPlugin, createMonitoringPlugin, createRequestContext, updateRequestContext, completeRequestContext, failRequestContext, cancelRequestContext, RequestErrorType, RequestErrorCode } from "@vlian/request";
-// undiciAdapter 使用懒加载，避免在未使用时触发依赖检查
-export async function undiciAdapter() {
-    const { undiciAdapter: adapter } = await import("@vlian/request");
-    return adapter();
-}
-export { MonitoringEventType } from "@vlian/request";
 /**
  * 国际化
  **/ export { setupI18n, setLang, $t };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { setupI18n, setLang, $t } from './library';\n\nexport * from './core';\nexport * from './utils';\nexport * from './state';\nexport * from './components';\n\n// 导出请求库（使用命名空间避免冲突）\nexport {\n  RequestClient,\n  createRequestClient,\n  adapterRegistry,\n  fetchAdapter,\n  kyAdapter,\n  axiosAdapter,\n  PluginManager as RequestPluginManager,\n  PluginLifecycleStage,\n  PluginPriority,\n  createCachePlugin,\n  createRetryPlugin,\n  createValidationPlugin,\n  createMonitoringPlugin,\n  createRequestContext,\n  updateRequestContext,\n  completeRequestContext,\n  failRequestContext,\n  cancelRequestContext,\n  RequestErrorType,\n  RequestErrorCode,\n} from '@vlian/request';\n\n// undiciAdapter 使用懒加载，避免在未使用时触发依赖检查\nexport async function undiciAdapter() {\n  const { undiciAdapter: adapter } = await import('@vlian/request');\n  return adapter();\n}\n\nexport type {\n  RequestOptions,\n  Response,\n  RequestContext,\n  RequestError,\n  RequestClientConfig,\n  RequestHeaders,\n  RequestQuery,\n  RequestBody,\n  HttpMethod,\n  RetryConfig,\n  CacheConfig,\n  ValidationConfig,\n  AdapterCapabilities,\n  RequestAdapter,\n  AdapterFactory as RequestAdapterFactory,\n  RequestPlugin,\n  CachePluginConfig,\n  RetryPluginConfig,\n  ValidationPluginConfig,\n  MonitoringPluginConfig,\n  MonitoringEvent,\n  MonitoringReporter,\n} from '@vlian/request';\n\nexport { MonitoringEventType } from '@vlian/request';\n\n/**\n * 国际化\n **/\nexport { setupI18n, setLang, $t };\n\n\nexport { Kernel, startup, getKernel, kernelStartApp } from './kernel';\nexport type {\n  KernelStartOptions as KernelStartupOptions,\n  KernelConfig as KernelRuntimeConfig,\n  KernelTimingMetric as KernelRuntimeTimingMetric,\n  KernelManager as RuntimeKernelManager,\n} from './kernel';\n"],"names":["setupI18n","setLang","$t","RequestClient","createRequestClient","adapterRegistry","fetchAdapter","kyAdapter","axiosAdapter","PluginManager","RequestPluginManager","PluginLifecycleStage","PluginPriority","createCachePlugin","createRetryPlugin","createValidationPlugin","createMonitoringPlugin","createRequestContext","updateRequestContext","completeRequestContext","failRequestContext","cancelRequestContext","RequestErrorType","RequestErrorCode","undiciAdapter","adapter","MonitoringEventType","Kernel","startup","getKernel","kernelStartApp"],"mappings":"AAAA,SAASA,SAAS,EAAEC,OAAO,EAAEC,EAAE,QAAQ,YAAY;AAEnD,cAAc,SAAS;AACvB,cAAc,UAAU;AACxB,cAAc,UAAU;AACxB,cAAc,eAAe;AAE7B,oBAAoB;AACpB,SACEC,aAAa,EACbC,mBAAmB,EACnBC,eAAe,EACfC,YAAY,EACZC,SAAS,EACTC,YAAY,EACZC,iBAAiBC,oBAAoB,EACrCC,oBAAoB,EACpBC,cAAc,EACdC,iBAAiB,EACjBC,iBAAiB,EACjBC,sBAAsB,EACtBC,sBAAsB,EACtBC,oBAAoB,EACpBC,oBAAoB,EACpBC,sBAAsB,EACtBC,kBAAkB,EAClBC,oBAAoB,EACpBC,gBAAgB,EAChBC,gBAAgB,QACX,iBAAiB;AAExB,oCAAoC;AACpC,OAAO,eAAeC;IACpB,MAAM,EAAEA,eAAeC,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC;IAChD,OAAOA;AACT;AA2BA,SAASC,mBAAmB,QAAQ,iBAAiB;AAErD;;EAEE,GACF,SAAS1B,SAAS,EAAEC,OAAO,EAAEC,EAAE,GAAG;AAGlC,SAASyB,MAAM,EAAEC,OAAO,EAAEC,SAAS,EAAEC,cAAc,QAAQ,WAAW"}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { setupI18n, setLang, $t } from './library';\n\nexport * from './core';\nexport * from './utils';\nexport * from './state';\nexport * from './components';\n\n/**\n * 国际化\n **/\nexport { setupI18n, setLang, $t };\n\n\nexport { Kernel, startup, getKernel, kernelStartApp } from './kernel';\nexport type {\n  KernelStartOptions as KernelStartupOptions,\n  KernelConfig as KernelRuntimeConfig,\n  KernelTimingMetric as KernelRuntimeTimingMetric,\n  KernelManager as RuntimeKernelManager,\n} from './kernel';\n"],"names":["setupI18n","setLang","$t","Kernel","startup","getKernel","kernelStartApp"],"mappings":"AAAA,SAASA,SAAS,EAAEC,OAAO,EAAEC,EAAE,QAAQ,YAAY;AAEnD,cAAc,SAAS;AACvB,cAAc,UAAU;AACxB,cAAc,UAAU;AACxB,cAAc,eAAe;AAE7B;;EAEE,GACF,SAASF,SAAS,EAAEC,OAAO,EAAEC,EAAE,GAAG;AAGlC,SAASC,MAAM,EAAEC,OAAO,EAAEC,SAAS,EAAEC,cAAc,QAAQ,WAAW"}