@vlian/framework 1.2.62 → 2.0.1

package/dist/core/types.d.ts

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

package/dist/core/types.js

@@ -1 +0,0 @@
-export{};

package/dist/core-bak/Test.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"default",{enumerable:true,get:function(){return _default}});const _jsxruntime=require("react/jsx-runtime");const _react=/*#__PURE__*/_interop_require_wildcard(require("react"));const _logger=require("@vlian/logger");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}const App=({onComplete})=>{(0,_react.useEffect)(()=>{_logger.logger.info("App mounted");onComplete()},[]);return(0,_jsxruntime.jsx)("div",{children:"App"})};const _default=App;

package/dist/core-bak/Test.d.ts

@@ -1,5 +0,0 @@
-import React from "react";
-declare const App: React.FC<{
-    onComplete: () => void;
-}>;
-export default App;

package/dist/core-bak/Test.js

@@ -1 +0,0 @@
-import{jsx as _jsx}from"react/jsx-runtime";import React,{useEffect}from"react";import{logger}from"@vlian/logger";const App=({onComplete})=>{useEffect(()=>{logger.info("App mounted");onComplete()},[]);return _jsx("div",{children:"App"})};export default App;

package/dist/core-bak/app/AppContext.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});function _export(target,all){for(var name in all)Object.defineProperty(target,name,{enumerable:true,get:Object.getOwnPropertyDescriptor(all,name).get})}_export(exports,{get AppContextProvider(){return AppContextProvider},get useAppContext(){return useAppContext},get useConfig(){return useConfig},get useLocale(){return useLocale},get useStateManager(){return useStateManager},get useTheme(){return useTheme}});const _jsxruntime=require("react/jsx-runtime");const _react=/*#__PURE__*/_interop_require_wildcard(require("react"));const _library=require("../../library");const _AppConfig=require("../config/AppConfig");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}const ThemeContext=(0,_react.createContext)(undefined);const LocaleContext=(0,_react.createContext)(undefined);const ConfigContext=(0,_react.createContext)(undefined);const StateManagerContext=(0,_react.createContext)(undefined);const ThemeProvider=_react.default.memo(({children,initialTheme})=>{const[theme,setThemeState]=(0,_react.useState)(initialTheme||_AppConfig.appConfig.getTheme());const applyDocumentThemeClass=(0,_react.useCallback)(mode=>{if(typeof window==="undefined"){return}const html=document.documentElement;html.classList.remove("light","dark");const resolvedMode=mode==="system"?window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light":mode||"light";html.classList.add(resolvedMode)},[]);(0,_react.useEffect)(()=>{_AppConfig.appConfig.setTheme(theme)},[theme]);(0,_react.useEffect)(()=>{if(typeof window==="undefined"){return}applyDocumentThemeClass(theme.mode);if(theme.mode!=="system"){return}const mediaQuery=window.matchMedia("(prefers-color-scheme: dark)");const onSystemThemeChange=()=>applyDocumentThemeClass("system");if(typeof mediaQuery.addEventListener==="function"){mediaQuery.addEventListener("change",onSystemThemeChange);return()=>mediaQuery.removeEventListener("change",onSystemThemeChange)}mediaQuery.addListener(onSystemThemeChange);return()=>mediaQuery.removeListener(onSystemThemeChange)},[applyDocumentThemeClass,theme.mode]);const setTheme=(0,_react.useCallback)(newTheme=>{setThemeState(prev=>{return typeof newTheme==="function"?newTheme(prev):newTheme})},[]);const value=(0,_react.useMemo)(()=>({theme,setTheme}),[theme,setTheme]);return(0,_jsxruntime.jsx)(ThemeContext.Provider,{value:value,children:children})});ThemeProvider.displayName="ThemeProvider";const LocaleProvider=_react.default.memo(({children,initialLocale})=>{const[locale,setLocaleState]=(0,_react.useState)(initialLocale||_AppConfig.appConfig.getLocale());const[isChanging,setIsChanging]=(0,_react.useState)(false);(0,_react.useEffect)(()=>{_AppConfig.appConfig.setLocale(locale)},[locale]);const setLocale=(0,_react.useCallback)(newLocale=>{if(newLocale===locale){return}setIsChanging(true);setLocaleState(newLocale);(0,_library.setLang)(newLocale);requestAnimationFrame(()=>{setIsChanging(false)})},[locale]);const value=(0,_react.useMemo)(()=>({locale,setLocale,isChanging}),[locale,setLocale,isChanging]);return(0,_jsxruntime.jsx)(LocaleContext.Provider,{value:value,children:children})});LocaleProvider.displayName="LocaleProvider";const AppConfigProvider=_react.default.memo(({children,initialAntdConfig,initialInitializationContext})=>{const[antdConfig,setAntdConfigState]=(0,_react.useState)(initialAntdConfig||_AppConfig.appConfig.getAntdConfig());const[initializationContext,setInitializationContextState]=(0,_react.useState)(initialInitializationContext||_AppConfig.appConfig.getInitializationContext());(0,_react.useEffect)(()=>{_AppConfig.appConfig.setAntdConfig(antdConfig)},[antdConfig]);(0,_react.useEffect)(()=>{_AppConfig.appConfig.setInitializationContext(initializationContext)},[initializationContext]);const setAntdConfig=(0,_react.useCallback)(config=>{setAntdConfigState(config)},[]);const setInitializationContext=(0,_react.useCallback)(context=>{setInitializationContextState(context)},[]);const value=(0,_react.useMemo)(()=>({antdConfig,initializationContext,setAntdConfig,setInitializationContext}),[antdConfig,initializationContext,setAntdConfig,setInitializationContext]);return(0,_jsxruntime.jsx)(ConfigContext.Provider,{value:value,children:children})});AppConfigProvider.displayName="AppConfigProvider";const StateManagerProvider=_react.default.memo(({children,stateManager})=>{const value=(0,_react.useMemo)(()=>({stateManager:stateManager??null}),[stateManager]);return(0,_jsxruntime.jsx)(StateManagerContext.Provider,{value:value,children:children})});StateManagerProvider.displayName="StateManagerProvider";const AppContextProvider=({children,initialTheme,initialLocale,initialAntdConfig,initialInitializationContext,stateManager,antdApp:_antdApp,uiApp:_uiApp})=>{const initializedRef=_react.default.useRef(false);_react.default.useEffect(()=>{if(!initializedRef.current){_AppConfig.appConfig.initialize({theme:initialTheme,locale:initialLocale,antdConfig:initialAntdConfig,initializationContext:initialInitializationContext});initializedRef.current=true}},[initialTheme,initialLocale,initialAntdConfig,initialInitializationContext]);return(0,_jsxruntime.jsx)(ThemeProvider,{initialTheme:initialTheme,children:(0,_jsxruntime.jsx)(LocaleProvider,{initialLocale:initialLocale,children:(0,_jsxruntime.jsx)(AppConfigProvider,{initialAntdConfig:initialAntdConfig,initialInitializationContext:initialInitializationContext,children:(0,_jsxruntime.jsx)(StateManagerProvider,{stateManager:stateManager,children:children})})})})};const useTheme=()=>{const context=(0,_react.useContext)(ThemeContext);if(context===undefined){throw new Error("useTheme 必须在 AppContextProvider 内使用")}return context};const useLocale=()=>{const context=(0,_react.useContext)(LocaleContext);if(context===undefined){throw new Error("useLocale 必须在 AppContextProvider 内使用")}return context};const useConfig=()=>{const context=(0,_react.useContext)(ConfigContext);if(context===undefined){throw new Error("useConfig 必须在 AppContextProvider 内使用")}return context};const useStateManager=()=>{const context=(0,_react.useContext)(StateManagerContext);if(context===undefined){throw new Error("useStateManager 必须在 AppContextProvider 内使用")}return context.stateManager};const useAppContext=()=>{const themeContext=useTheme();const localeContext=useLocale();const configContext=useConfig();const stateManagerContext=useStateManager();return(0,_react.useMemo)(()=>({theme:themeContext.theme,locale:localeContext.locale,antdConfig:configContext.antdConfig,initializationContext:configContext.initializationContext,stateManager:stateManagerContext,setTheme:themeContext.setTheme,setLocale:localeContext.setLocale,setAntdConfig:configContext.setAntdConfig,setInitializationContext:configContext.setInitializationContext}),[themeContext.theme,localeContext.locale,configContext.antdConfig,configContext.initializationContext,stateManagerContext,themeContext.setTheme,localeContext.setLocale,configContext.setAntdConfig,configContext.setInitializationContext])};

package/dist/core-bak/app/AppContext.d.ts

@@ -1,113 +0,0 @@
-import React from 'react';
-import type { PropsWithChildren } from 'react';
-import type { LangType } from '../../library/locale/types';
-import type { InitializationContext } from '../initialization';
-import type { ThemeContextValue, LocaleContextValue, ConfigContextValue, AppContextValue, ThemeConfig } from './AppContext.types';
-import type { StateManager } from '../../state';
-import type { UIAppConfig, UIProviderConfig } from '../types';
-/**
- * 应用上下文 Provider 属性
- */
-export interface AppContextProviderProps extends PropsWithChildren {
-    /**
-     * 初始主题配置
-     */
-    initialTheme?: ThemeConfig;
-    /**
-     * 初始国际化语言
-     */
-    initialLocale?: LangType;
-    /**
-     * 初始 Ant Design 配置
-     */
-    initialAntdConfig?: UIProviderConfig;
-    /**
-     * 初始初始化上下文
-     */
-    initialInitializationContext?: InitializationContext;
-    /**
-     * 状态管理器实例
-     */
-    stateManager?: StateManager | null;
-    /**
-     * UI App 基础配置
-     *
-     * 用于传递 UI 适配层的应用级配置（如消息、通知、弹窗容器）。
-     */
-    antdApp?: UIAppConfig;
-    /**
-     * UI App 配置（无框架绑定）
-     */
-    uiApp?: UIAppConfig;
-}
-export declare const AppContextProvider: React.FC<AppContextProviderProps>;
-/**
- * 使用主题上下文 Hook
- *
- * @returns 主题上下文值
- * @throws 如果不在 ThemeProvider 内使用会抛出错误
- *
- * @example
- * ```tsx
- * const { theme, setTheme } = useTheme();
- *
- * // 切换主题
- * setTheme({ mode: 'dark' });
- * ```
- */
-export declare const useTheme: () => ThemeContextValue;
-/**
- * 使用国际化上下文 Hook
- *
- * @returns 国际化上下文值
- * @throws 如果不在 LocaleProvider 内使用会抛出错误
- *
- * @example
- * ```tsx
- * const { locale, setLocale } = useLocale();
- *
- * // 切换语言
- * setLocale('en-US');
- * ```
- */
-export declare const useLocale: () => LocaleContextValue;
-/**
- * 使用配置上下文 Hook
- *
- * @returns 配置上下文值
- * @throws 如果不在 ConfigProvider 内使用会抛出错误
- */
-export declare const useConfig: () => ConfigContextValue;
-/**
- * 使用应用上下文 Hook（聚合所有上下文）
- *
- * @returns 应用上下文值
- * @throws 如果不在 AppContextProvider 内使用会抛出错误
- *
- * @example
- * ```tsx
- * const { theme, setTheme, locale, setLocale, antdConfig } = useAppContext();
- *
- * // 切换主题
- * setTheme({ mode: 'dark' });
- *
- * // 切换语言
- * setLocale('en-US');
- * ```
- */
-/**
- * 使用状态管理器 Hook
- *
- * @returns 状态管理器实例
- * @throws 如果不在 AppContextProvider 内使用会抛出错误
- *
- * @example
- * ```tsx
- * const stateManager = useStateManager();
- *
- * // 创建状态实例
- * const countState = stateManager?.createState(0);
- * ```
- */
-export declare const useStateManager: () => StateManager | null;
-export declare const useAppContext: () => AppContextValue;

package/dist/core-bak/app/AppContext.js

@@ -1 +0,0 @@
-import{jsx as _jsx}from"react/jsx-runtime";import React,{createContext,useContext,useState,useCallback,useMemo,useEffect}from"react";import{setLang}from"../../library";import{appConfig}from"../config/AppConfig";const ThemeContext=createContext(undefined);const LocaleContext=createContext(undefined);const ConfigContext=createContext(undefined);const StateManagerContext=createContext(undefined);const ThemeProvider=React.memo(({children,initialTheme})=>{const[theme,setThemeState]=useState(initialTheme||appConfig.getTheme());const applyDocumentThemeClass=useCallback(mode=>{if(typeof window==="undefined"){return}const html=document.documentElement;html.classList.remove("light","dark");const resolvedMode=mode==="system"?window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light":mode||"light";html.classList.add(resolvedMode)},[]);useEffect(()=>{appConfig.setTheme(theme)},[theme]);useEffect(()=>{if(typeof window==="undefined"){return}applyDocumentThemeClass(theme.mode);if(theme.mode!=="system"){return}const mediaQuery=window.matchMedia("(prefers-color-scheme: dark)");const onSystemThemeChange=()=>applyDocumentThemeClass("system");if(typeof mediaQuery.addEventListener==="function"){mediaQuery.addEventListener("change",onSystemThemeChange);return()=>mediaQuery.removeEventListener("change",onSystemThemeChange)}mediaQuery.addListener(onSystemThemeChange);return()=>mediaQuery.removeListener(onSystemThemeChange)},[applyDocumentThemeClass,theme.mode]);const setTheme=useCallback(newTheme=>{setThemeState(prev=>{return typeof newTheme==="function"?newTheme(prev):newTheme})},[]);const value=useMemo(()=>({theme,setTheme}),[theme,setTheme]);return _jsx(ThemeContext.Provider,{value:value,children:children})});ThemeProvider.displayName="ThemeProvider";const LocaleProvider=React.memo(({children,initialLocale})=>{const[locale,setLocaleState]=useState(initialLocale||appConfig.getLocale());const[isChanging,setIsChanging]=useState(false);useEffect(()=>{appConfig.setLocale(locale)},[locale]);const setLocale=useCallback(newLocale=>{if(newLocale===locale){return}setIsChanging(true);setLocaleState(newLocale);setLang(newLocale);requestAnimationFrame(()=>{setIsChanging(false)})},[locale]);const value=useMemo(()=>({locale,setLocale,isChanging}),[locale,setLocale,isChanging]);return _jsx(LocaleContext.Provider,{value:value,children:children})});LocaleProvider.displayName="LocaleProvider";const AppConfigProvider=React.memo(({children,initialAntdConfig,initialInitializationContext})=>{const[antdConfig,setAntdConfigState]=useState(initialAntdConfig||appConfig.getAntdConfig());const[initializationContext,setInitializationContextState]=useState(initialInitializationContext||appConfig.getInitializationContext());useEffect(()=>{appConfig.setAntdConfig(antdConfig)},[antdConfig]);useEffect(()=>{appConfig.setInitializationContext(initializationContext)},[initializationContext]);const setAntdConfig=useCallback(config=>{setAntdConfigState(config)},[]);const setInitializationContext=useCallback(context=>{setInitializationContextState(context)},[]);const value=useMemo(()=>({antdConfig,initializationContext,setAntdConfig,setInitializationContext}),[antdConfig,initializationContext,setAntdConfig,setInitializationContext]);return _jsx(ConfigContext.Provider,{value:value,children:children})});AppConfigProvider.displayName="AppConfigProvider";const StateManagerProvider=React.memo(({children,stateManager})=>{const value=useMemo(()=>({stateManager:stateManager??null}),[stateManager]);return _jsx(StateManagerContext.Provider,{value:value,children:children})});StateManagerProvider.displayName="StateManagerProvider";export const AppContextProvider=({children,initialTheme,initialLocale,initialAntdConfig,initialInitializationContext,stateManager,antdApp:_antdApp,uiApp:_uiApp})=>{const initializedRef=React.useRef(false);React.useEffect(()=>{if(!initializedRef.current){appConfig.initialize({theme:initialTheme,locale:initialLocale,antdConfig:initialAntdConfig,initializationContext:initialInitializationContext});initializedRef.current=true}},[initialTheme,initialLocale,initialAntdConfig,initialInitializationContext]);return _jsx(ThemeProvider,{initialTheme:initialTheme,children:_jsx(LocaleProvider,{initialLocale:initialLocale,children:_jsx(AppConfigProvider,{initialAntdConfig:initialAntdConfig,initialInitializationContext:initialInitializationContext,children:_jsx(StateManagerProvider,{stateManager:stateManager,children:children})})})})};export const useTheme=()=>{const context=useContext(ThemeContext);if(context===undefined){throw new Error("useTheme 必须在 AppContextProvider 内使用")}return context};export const useLocale=()=>{const context=useContext(LocaleContext);if(context===undefined){throw new Error("useLocale 必须在 AppContextProvider 内使用")}return context};export const useConfig=()=>{const context=useContext(ConfigContext);if(context===undefined){throw new Error("useConfig 必须在 AppContextProvider 内使用")}return context};export const useStateManager=()=>{const context=useContext(StateManagerContext);if(context===undefined){throw new Error("useStateManager 必须在 AppContextProvider 内使用")}return context.stateManager};export const useAppContext=()=>{const themeContext=useTheme();const localeContext=useLocale();const configContext=useConfig();const stateManagerContext=useStateManager();return useMemo(()=>({theme:themeContext.theme,locale:localeContext.locale,antdConfig:configContext.antdConfig,initializationContext:configContext.initializationContext,stateManager:stateManagerContext,setTheme:themeContext.setTheme,setLocale:localeContext.setLocale,setAntdConfig:configContext.setAntdConfig,setInitializationContext:configContext.setInitializationContext}),[themeContext.theme,localeContext.locale,configContext.antdConfig,configContext.initializationContext,stateManagerContext,themeContext.setTheme,localeContext.setLocale,configContext.setAntdConfig,configContext.setInitializationContext])};

package/dist/core-bak/app/AppContext.types.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});