@vlian/framework 1.2.57 → 1.2.60

package/dist/core/startup/startApp.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/core/startup/startApp.ts"],"sourcesContent":["/**\n * 应用启动主函数\n * 重构后的启动逻辑，集成所有新功能\n */\n\nimport { logger } from '@vlian/logger';\nimport { ErrorCode, InitializationError } from '@vlian/utils';\nimport { initTraceIdGenerator, generateTraceId, setCurrentTraceId } from '../../utils/traceId';\nimport type { StartOptions } from '../types';\nimport { shouldShowSplashScreen } from '../splash';\nimport { initialization, initializationErrorState } from '../initialization/index';\nimport { middlewareManager } from '../middleware';\nimport { initializeServices } from './initializeServices';\nimport type { ServicesInitResult } from './initializeServices';\nimport { AppInstanceManager, getAppInstanceManager } from './AppInstance';\nimport { getEnvironmentDetector } from './environment';\nimport { getRouterManager } from '../router/RouterManager';\nimport { FrameworkEventManager } from '../event/frameworkEvents';\nimport { startKernel } from '../kernel';\n\n/**\n * 启动应用\n *\n * @param options - 启动配置选项\n * @param instanceId - 应用实例ID（可选，用于多实例场景）\n * @returns 应用实例\n */\nexport async function startApp(\n  options: StartOptions = {},\n  instanceId?: string\n): Promise<AppInstanceManager> {\n  const startTime = performance.now();\n  const envDetector = getEnvironmentDetector();\n  const instanceManager = getAppInstanceManager();\n\n  // 初始化追踪 ID 生成器\n  initTraceIdGenerator('app');\n  const traceId = generateTraceId();\n  setCurrentTraceId(traceId);\n\n  // 框架事件管理器（在服务初始化后创建）\n  let frameworkEventManager: FrameworkEventManager | null = null;\n  let kernelTraceId: string | null = null;\n\n  try {\n    // 1. 环境检测和容器获取\n    const container = options.container || envDetector.safeGetElement('#root');\n    if (!container) {\n      throw new InitializationError(\n        '未找到挂载容器',\n        undefined,\n        { container: options.container },\n        ErrorCode.CONTAINER_NOT_FOUND\n      );\n    }\n\n    logger.info('框架启动中...');\n\n    if (options.antd && !options.uiProvider) {\n      logger.warn('[deprecated] StartOptions.antd 即将废弃，请迁移到 StartOptions.uiProvider');\n    }\n    if (options.antdApp && !options.uiApp) {\n      logger.warn('[deprecated] StartOptions.antdApp 即将废弃，请迁移到 StartOptions.uiApp');\n    }\n\n    // 2. 创建应用实例\n    const appInstance = instanceManager.createInstance(instanceId, options);\n    const finalInstanceId = appInstance.id;\n    let services: ServicesInitResult | null = null;\n\n    // 使用单次 Promise 防止重复初始化，提升加载速度并保证可观测数据一致。\n    let servicesInitPromise: Promise<ServicesInitResult> | null = null;\n    const ensureServicesInitialized = async (): Promise<ServicesInitResult> => {\n      if (services) {\n        return services;\n      }\n      if (!servicesInitPromise) {\n        servicesInitPromise = initializeServices({\n          ...options,\n          eventBus: {\n            ...options.eventBus,\n            instanceId: finalInstanceId,\n          },\n        });\n      }\n      services = await servicesInitPromise;\n      return services;\n    };\n\n    // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）\n    const kernelRuntime = await startKernel({\n      loggerLevel: options.loggerLevel,\n      locale: {\n        locale: (options.locale ? (Object.keys(options.locale)[0] as any) : 'zh-CN') || 'zh-CN',\n        resources: options.locale as any,\n      },\n      theme: {\n        mode: options.theme?.mode || 'light',\n        primaryColor: options.theme?.primaryColor,\n        compatibility: {\n          antd: (options.uiProvider || options.antd) as unknown as Record<string, unknown> | undefined,\n        },\n      },\n      adapters: {\n        monitoring: {\n          initialize: async () => {\n            await ensureServicesInitialized();\n          },\n          captureError: (error, metadata) => {\n            if (services) {\n              services.monitoring.captureError(error, metadata);\n            } else {\n              logger.error('Kernel 监控上报失败（服务尚未初始化）:', error, metadata);\n            }\n          },\n          reportMetric: (name, value, tags) => {\n            logger.debug(`[kernel.metric] ${name}`, { value, tags, instanceId: finalInstanceId });\n          },\n        },\n        state: {\n          initialize: async () => {\n            await ensureServicesInitialized();\n          },\n          getInstance: () => services?.stateManager ?? null,\n        },\n        eventBus: {\n          initialize: async () => {\n            await ensureServicesInitialized();\n          },\n          emit: (event, payload) => {\n            if (services) {\n              services.eventBus.emit(event as any, payload as any);\n            }\n          },\n          on: (event, handler) => {\n            if (!services) {\n              return () => {};\n            }\n            return services.eventBus.on(event as any, handler as any);\n          },\n        },\n        errorHandler: {\n          async handle(error) {\n            logger.error('Kernel 启动阶段失败:', error);\n            return { handled: true, shouldThrow: true };\n          },\n        },\n      },\n      enabledPhases: {\n        init: false,\n      },\n      enablePostReady: false,\n    });\n    kernelTraceId = kernelRuntime.traceId;\n\n    const servicesInitStart = performance.now();\n    const resolvedServices = await ensureServicesInitialized();\n    const servicesInitDuration = performance.now() - servicesInitStart;\n\n    // 创建框架事件管理器\n    frameworkEventManager = new FrameworkEventManager(resolvedServices.eventBus);\n\n    // 触发应用启动事件（使用真实的事件总线）\n    frameworkEventManager.emitAppStart(finalInstanceId);\n\n    // 触发实例创建事件\n    frameworkEventManager.emitInstanceCreated(finalInstanceId);\n\n    // 4. 初始化应用实例\n    appInstance.initialize(container, resolvedServices);\n\n    // 5. 初始化路由管理器\n    const routerManager = getRouterManager();\n    if (options.router) {\n      await routerManager.initialize(options.router);\n    }\n\n    // 6. 性能追踪\n    const performanceTracker = appInstance.getPerformanceTracker();\n    if (performanceTracker) {\n      performanceTracker.recordServiceInit(servicesInitDuration);\n    }\n\n    // 6. 是否显示启动页\n    const shouldShowSplash = shouldShowSplashScreen(options.showSplashScreen);\n\n    const renderer = appInstance.getRenderer();\n\n    // 8. 渲染应用函数\n    const renderApp = async (context?: Awaited<ReturnType<typeof initialization>>) => {\n      const renderStart = performance.now();\n\n      // 触发渲染开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppRenderStart(finalInstanceId);\n      }\n\n      await renderer.renderApp(options, resolvedServices, context);\n      const renderDuration = performance.now() - renderStart;\n\n      // 触发渲染完成事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppRenderComplete(finalInstanceId, renderDuration);\n      }\n\n      // 优化：在应用渲染完成后，延迟初始化非关键服务\n      // 使用 requestIdleCallback 在浏览器空闲时初始化，不影响用户体验\n      if (resolvedServices.initializeNonCriticalServices) {\n        resolvedServices.initializeNonCriticalServices().catch((error) => {\n          logger.warn('非关键服务初始化失败（不影响应用运行）:', error);\n        });\n      }\n\n      if (performanceTracker) {\n        performanceTracker.recordFirstRender(renderDuration);\n        const totalDuration = performance.now() - startTime;\n        performanceTracker.recordTotalStartup(totalDuration);\n        performanceTracker.report();\n      }\n\n      // 触发应用启动完成事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppStarted(finalInstanceId, performance.now() - startTime);\n      }\n\n      // 统一发出 Kernel post-ready 事件，供可观测系统消费。\n      kernelRuntime.getEventBus().emit('kernel.postReady', {\n        traceId: kernelRuntime.traceId,\n        instanceId: finalInstanceId,\n        startupDuration: performance.now() - startTime,\n      });\n\n      // 开发模式下显示开发工具\n      if (process.env.NODE_ENV === 'development' && typeof window !== 'undefined') {\n        // 延迟显示开发工具，避免影响首次渲染\n        setTimeout(() => {\n          const devToolsContainer = document.createElement('div');\n          devToolsContainer.id = '__framework_dev_tools__';\n          document.body.appendChild(devToolsContainer);\n\n          // 这里需要动态导入React来渲染开发工具\n          // 为了简化，暂时注释掉，后续可以完善\n          // import('react-dom/client').then(({ createRoot }) => {\n          //   const root = createRoot(devToolsContainer);\n          //   root.render(<DevToolsTrigger appInstance={appInstance} />);\n          // });\n        }, 1000);\n      }\n    };\n\n    if (shouldShowSplash) {\n      // 场景1: 显示启动页，初始化在启动页中完成\n      const onSplashComplete = (context: Awaited<ReturnType<typeof initialization>>) => {\n        logger.info('启动页初始化完成');\n\n        // 触发初始化完成事件\n        if (frameworkEventManager) {\n          const initDuration = context.duration || 0;\n          frameworkEventManager.emitAppInitComplete(finalInstanceId, context, initDuration);\n        }\n\n        if (options.onSplashComplete) {\n          Promise.resolve(\n            options.onSplashComplete(() => {\n              logger.info('框架加载完成');\n              renderApp(context);\n            }, context)\n          ).catch((error) => {\n            logger.error('onSplashComplete 回调执行失败:', error);\n            initializationErrorState.setError(error);\n            renderApp(context);\n          });\n        } else {\n          logger.info('框架加载完成');\n          renderApp(context);\n        }\n      };\n\n      // 触发初始化开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppInitStart(finalInstanceId);\n      }\n\n      // 渲染启动页\n      renderer.renderSplashScreen(options, resolvedServices, onSplashComplete);\n    } else {\n      // 场景2: 不显示启动页，直接执行初始化\n      logger.info('开始执行初始化（无启动页）');\n\n      // 触发初始化开始事件\n      if (frameworkEventManager) {\n        frameworkEventManager.emitAppInitStart(finalInstanceId);\n      }\n\n      try {\n        const initStart = performance.now();\n\n        // 使用中间件包装初始化函数\n        const initContext = await middlewareManager.execute(\n          options,\n          async () => {\n            return await initialization(options, (progress, step) => {\n              logger.debug(`初始化进度: ${progress}%${step ? ` - ${step}` : ''}`);\n            });\n          }\n        );\n\n        const initDuration = performance.now() - initStart;\n\n        // 触发初始化完成事件\n        if (frameworkEventManager) {\n          frameworkEventManager.emitAppInitComplete(finalInstanceId, initContext, initDuration);\n        }\n\n        if (performanceTracker) {\n          performanceTracker.recordInitialization(initDuration);\n        }\n\n        logger.info('初始化完成（无启动页）', initContext);\n        logger.info('框架加载完成');\n        void renderApp(initContext);\n      } catch (error) {\n        logger.error('初始化失败:', error);\n\n        // 触发初始化错误事件\n        if (frameworkEventManager) {\n          frameworkEventManager.emitAppInitError(\n            finalInstanceId,\n            error instanceof Error ? error : new Error(String(error))\n          );\n        }\n\n        initializationErrorState.setError(error);\n        void renderApp();\n      }\n    }\n\n    return instanceManager;\n  } catch (error) {\n    logger.error('框架启动失败:', error);\n\n    // 触发错误事件\n    if (frameworkEventManager) {\n      const errorInstanceId = instanceId || instanceManager.getInstance()?.id;\n      if (errorInstanceId) {\n        frameworkEventManager.emitErrorOccurred(\n          error instanceof Error ? error : new Error(String(error)),\n          { phase: 'startup' }\n        );\n      }\n    }\n\n    if (kernelTraceId) {\n      logger.error('Kernel Trace 失败上下文', { traceId: kernelTraceId });\n    }\n\n    // 如果容器存在，尝试渲染错误页面\n    const container = options.container || envDetector.safeGetElement('#root');\n    if (container) {\n      const errorInstance = instanceManager.getInstance();\n      if (errorInstance && errorInstance.isInitialized()) {\n        const renderer = errorInstance.getRenderer();\n        const services = errorInstance.getServices();\n        initializationErrorState.setError(error);\n        renderer.renderError(options, services);\n      }\n    }\n\n    throw error;\n  }\n}\n"],"names":["logger","ErrorCode","InitializationError","initTraceIdGenerator","generateTraceId","setCurrentTraceId","shouldShowSplashScreen","initialization","initializationErrorState","middlewareManager","initializeServices","getAppInstanceManager","getEnvironmentDetector","getRouterManager","FrameworkEventManager","startKernel","startApp","options","instanceId","startTime","performance","now","envDetector","instanceManager","traceId","frameworkEventManager","kernelTraceId","container","safeGetElement","undefined","CONTAINER_NOT_FOUND","info","antd","uiProvider","warn","antdApp","uiApp","appInstance","createInstance","finalInstanceId","id","services","servicesInitPromise","ensureServicesInitialized","eventBus","kernelRuntime","loggerLevel","locale","Object","keys","resources","theme","mode","primaryColor","compatibility","adapters","monitoring","initialize","captureError","error","metadata","reportMetric","name","value","tags","debug","state","getInstance","stateManager","emit","event","payload","on","handler","errorHandler","handle","handled","shouldThrow","enabledPhases","init","enablePostReady","servicesInitStart","resolvedServices","servicesInitDuration","emitAppStart","emitInstanceCreated","routerManager","router","performanceTracker","getPerformanceTracker","recordServiceInit","shouldShowSplash","showSplashScreen","renderer","getRenderer","renderApp","context","renderStart","emitAppRenderStart","renderDuration","emitAppRenderComplete","initializeNonCriticalServices","catch","recordFirstRender","totalDuration","recordTotalStartup","report","emitAppStarted","getEventBus","startupDuration","process","env","NODE_ENV","window","setTimeout","devToolsContainer","document","createElement","body","appendChild","onSplashComplete","initDuration","duration","emitAppInitComplete","Promise","resolve","setError","emitAppInitStart","renderSplashScreen","initStart","initContext","execute","progress","step","recordInitialization","emitAppInitError","Error","String","errorInstanceId","emitErrorOccurred","phase","errorInstance","isInitialized","getServices","renderError"],"mappings":"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"}

package/dist/core/types.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/types.js.map

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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  KernelRenderContext\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.js.map

@@ -1 +0,0 @@
-{"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  KernelRenderContext\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"}

package/dist/index.umd.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.umd.ts"],"sourcesContent":["/**\n * UMD 入口文件\n * \n * 此文件用于构建 UMD 格式的包，在浏览器环境中会将框架暴露为 window.vlianFramework\n * Rollup 会自动处理 UMD 格式的导出，此文件只需要重新导出所有内容\n */\n\n// 重新导出所有内容\nexport * from './index';\n\n// 在浏览器环境中，Rollup 会将 UMD 格式的导出自动赋值给全局变量\n// 全局变量名称在 rollup.config.js 中配置为 'vlianFramework'\n// 因此最终会通过 window.vlianFramework 访问\n"],"names":[],"mappings":"AAAA;;;;;CAKC,GAED,WAAW;;;;;qBACG;;;;;;;;;;;;;;CAEd,uCAAuC;CACvC,iDAAiD;CACjD,mCAAmC"}