@vlian/framework 1.0.0

package/dist/core/app/AppContext.cjs

@@ -0,0 +1,344 @@
+"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 _antd = require("antd");
+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 = /*#__PURE__*/ (0, _react.createContext)(undefined);
+/**
+ * 国际化上下文
+ */ const LocaleContext = /*#__PURE__*/ (0, _react.createContext)(undefined);
+/**
+ * 配置上下文
+ */ const ConfigContext = /*#__PURE__*/ (0, _react.createContext)(undefined);
+/**
+ * 状态管理器上下文
+ */ const StateManagerContext = /*#__PURE__*/ (0, _react.createContext)(undefined);
+/**
+ * 主题 Provider 组件
+ */ const ThemeProvider = /*#__PURE__*/ _react.default.memo(({ children, initialTheme })=>{
+    const [theme, setThemeState] = (0, _react.useState)(initialTheme || _AppConfig.appConfig.getTheme());
+    // 同步到单例
+    (0, _react.useEffect)(()=>{
+        _AppConfig.appConfig.setTheme(theme);
+    }, [
+        theme
+    ]);
+    // 更新主题，添加过渡动画支持
+    const setTheme = (0, _react.useCallback)((newTheme)=>{
+        setThemeState((prev)=>{
+            const updated = typeof newTheme === 'function' ? newTheme(prev) : newTheme;
+            // 如果主题模式改变，更新文档类名（添加过渡效果）
+            if (updated.mode !== prev.mode) {
+                // 使用 requestAnimationFrame 确保 DOM 更新在下一帧
+                requestAnimationFrame(()=>{
+                    const html = document.documentElement;
+                    html.classList.remove('light', 'dark');
+                    // 添加过渡类（如果支持）
+                    if (html.style.transition === undefined) {
+                        html.style.transition = 'background-color 0.3s ease, color 0.3s ease';
+                    }
+                    if (updated.mode && updated.mode !== 'auto') {
+                        html.classList.add(updated.mode);
+                    } else if (updated.mode === 'auto') {
+                        // 跟随系统设置
+                        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
+                        html.classList.add(prefersDark ? 'dark' : 'light');
+                    }
+                });
+            }
+            return updated;
+        });
+    }, []);
+    const value = (0, _react.useMemo)(()=>({
+            theme,
+            setTheme
+        }), [
+        theme,
+        setTheme
+    ]);
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)(ThemeContext.Provider, {
+        value: value,
+        children: children
+    });
+});
+ThemeProvider.displayName = 'ThemeProvider';
+/**
+ * 国际化 Provider 组件
+ */ const LocaleProvider = /*#__PURE__*/ _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 确保状态更新在下一帧
+        requestAnimationFrame(()=>{
+            setIsChanging(false);
+        });
+    }, [
+        locale
+    ]);
+    const value = (0, _react.useMemo)(()=>({
+            locale,
+            setLocale,
+            isChanging
+        }), [
+        locale,
+        setLocale,
+        isChanging
+    ]);
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)(LocaleContext.Provider, {
+        value: value,
+        children: children
+    });
+});
+LocaleProvider.displayName = 'LocaleProvider';
+/**
+ * 配置 Provider 组件
+ */ const AppConfigProvider = /*#__PURE__*/ _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
+    ]);
+    // 更新 Ant Design 配置
+    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 /*#__PURE__*/ (0, _jsxruntime.jsx)(ConfigContext.Provider, {
+        value: value,
+        children: children
+    });
+});
+AppConfigProvider.displayName = 'AppConfigProvider';
+/**
+ * 应用上下文 Provider 组件
+ * 
+ * 组合所有 Provider，提供统一的全局上下文
+ * 
+ * @example
+ * ```tsx
+ * <AppContextProvider
+ *   initialTheme={{ mode: 'light', primaryColor: '#1890ff' }}
+ *   initialLocale="zh-CN"
+ * >
+ *   <App />
+ * </AppContextProvider>
+ * ```
+ */ /**
+ * 状态管理器 Provider 组件
+ */ const StateManagerProvider = /*#__PURE__*/ _react.default.memo(({ children, stateManager })=>{
+    const value = (0, _react.useMemo)(()=>({
+            stateManager: stateManager ?? null
+        }), [
+        stateManager
+    ]);
+    return /*#__PURE__*/ (0, _jsxruntime.jsx)(StateManagerContext.Provider, {
+        value: value,
+        children: children
+    });
+});
+StateManagerProvider.displayName = 'StateManagerProvider';
+const AppContextProvider = ({ children, initialTheme, initialLocale, initialAntdConfig, initialInitializationContext, stateManager, antdApp })=>{
+    // 初始化单例配置（仅执行一次）
+    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 /*#__PURE__*/ (0, _jsxruntime.jsx)(ThemeProvider, {
+        initialTheme: initialTheme,
+        children: /*#__PURE__*/ (0, _jsxruntime.jsx)(LocaleProvider, {
+            initialLocale: initialLocale,
+            children: /*#__PURE__*/ (0, _jsxruntime.jsx)(AppConfigProvider, {
+                initialAntdConfig: initialAntdConfig,
+                initialInitializationContext: initialInitializationContext,
+                children: /*#__PURE__*/ (0, _jsxruntime.jsx)(_antd.App, {
+                    ...antdApp,
+                    children: /*#__PURE__*/ (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
+    ]);
+};
+
+//# sourceMappingURL=AppContext.js.map

package/dist/core/app/AppContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/core/app/AppContext.tsx"],"sourcesContent":["import React, { createContext, useContext, useState, useCallback, useMemo, useEffect } from 'react';\nimport type { PropsWithChildren } from 'react';\nimport { App } from 'antd';\nimport type { AppProps, ConfigProviderProps } from 'antd';\nimport { setLang } from '../../library';\nimport type { LangType } from '../../library/locale/types';\nimport type { InitializationContext } from '../initialization';\nimport type {\n    ThemeContextValue,\n    LocaleContextValue,\n    ConfigContextValue,\n    AppContextValue,\n    ThemeConfig,\n} from './AppContext.types';\nimport { appConfig } from '../config/AppConfig';\nimport type { StateManager } from '../../state';\n\n/**\n * 主题上下文\n */\nconst ThemeContext = createContext<ThemeContextValue | undefined>(undefined);\n\n/**\n * 国际化上下文\n */\nconst LocaleContext = createContext<LocaleContextValue | undefined>(undefined);\n\n/**\n * 配置上下文\n */\nconst ConfigContext = createContext<ConfigContextValue | undefined>(undefined);\n\n/**\n * 状态管理器上下文\n */\nconst StateManagerContext = createContext<import('./AppContext.types').StateManagerContextValue | undefined>(undefined);\n\n/**\n * 主题 Provider 属性\n */\ninterface ThemeProviderProps extends PropsWithChildren {\n    /**\n     * 初始主题配置\n     */\n    initialTheme?: ThemeConfig;\n}\n\n/**\n * 主题 Provider 组件\n */\nconst ThemeProvider: React.FC<ThemeProviderProps> = React.memo(({ children, initialTheme }) => {\n    const [theme, setThemeState] = useState<ThemeConfig>(initialTheme || appConfig.getTheme());\n\n    // 同步到单例\n    useEffect(() => {\n        appConfig.setTheme(theme);\n    }, [theme]);\n\n    // 更新主题，添加过渡动画支持\n    const setTheme = useCallback((newTheme: ThemeConfig | ((prev: ThemeConfig) => ThemeConfig)) => {\n        setThemeState((prev) => {\n            const updated = typeof newTheme === 'function' ? newTheme(prev) : newTheme;\n\n            // 如果主题模式改变，更新文档类名（添加过渡效果）\n            if (updated.mode !== prev.mode) {\n                // 使用 requestAnimationFrame 确保 DOM 更新在下一帧\n                requestAnimationFrame(() => {\n                    const html = document.documentElement;\n                    html.classList.remove('light', 'dark');\n                    \n                    // 添加过渡类（如果支持）\n                    if (html.style.transition === undefined) {\n                        html.style.transition = 'background-color 0.3s ease, color 0.3s ease';\n                    }\n                    \n                    if (updated.mode && updated.mode !== 'auto') {\n                        html.classList.add(updated.mode);\n                    } else if (updated.mode === 'auto') {\n                        // 跟随系统设置\n                        const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;\n                        html.classList.add(prefersDark ? 'dark' : 'light');\n                    }\n                });\n            }\n\n            return updated;\n        });\n    }, []);\n\n    const value: ThemeContextValue = useMemo(\n        () => ({\n            theme,\n            setTheme,\n        }),\n        [theme, setTheme]\n    );\n\n    return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>;\n});\n\nThemeProvider.displayName = 'ThemeProvider';\n\n/**\n * 国际化 Provider 属性\n */\ninterface LocaleProviderProps extends PropsWithChildren {\n    /**\n     * 初始语言\n     */\n    initialLocale?: LangType;\n}\n\n/**\n * 国际化 Provider 组件\n */\nconst LocaleProvider: React.FC<LocaleProviderProps> = React.memo(({ children, initialLocale }) => {\n    const [locale, setLocaleState] = useState<LangType>(initialLocale || appConfig.getLocale());\n    const [isChanging, setIsChanging] = useState(false);\n\n    // 同步到单例\n    useEffect(() => {\n        appConfig.setLocale(locale);\n    }, [locale]);\n\n    // 更新语言，添加加载状态\n    const setLocale = useCallback(\n        (newLocale: LangType) => {\n            if (newLocale === locale) {\n                return;\n            }\n            setIsChanging(true);\n            setLocaleState(newLocale);\n            setLang(newLocale);\n            // 使用 requestAnimationFrame 确保状态更新在下一帧\n            requestAnimationFrame(() => {\n                setIsChanging(false);\n            });\n        },\n        [locale]\n    );\n\n    const value: LocaleContextValue = useMemo(\n        () => ({\n            locale,\n            setLocale,\n            isChanging,\n        }),\n        [locale, setLocale, isChanging]\n    );\n\n    return <LocaleContext.Provider value={value}>{children}</LocaleContext.Provider>;\n});\n\nLocaleProvider.displayName = 'LocaleProvider';\n\n/**\n * 配置 Provider 属性\n */\ninterface AppConfigProviderProps extends PropsWithChildren {\n    /**\n     * 初始 Ant Design 配置\n     */\n    initialAntdConfig?: ConfigProviderProps;\n    /**\n     * 初始初始化上下文\n     */\n    initialInitializationContext?: InitializationContext;\n}\n\n/**\n * 配置 Provider 组件\n */\nconst AppConfigProvider: React.FC<AppConfigProviderProps> = React.memo(({\n    children,\n    initialAntdConfig,\n    initialInitializationContext,\n}) => {\n    const [antdConfig, setAntdConfigState] = useState<ConfigProviderProps | undefined>(\n        initialAntdConfig || appConfig.getAntdConfig()\n    );\n    const [initializationContext, setInitializationContextState] = useState<\n        InitializationContext | undefined\n    >(initialInitializationContext || appConfig.getInitializationContext());\n\n    // 同步到单例\n    useEffect(() => {\n        appConfig.setAntdConfig(antdConfig);\n    }, [antdConfig]);\n\n    useEffect(() => {\n        appConfig.setInitializationContext(initializationContext);\n    }, [initializationContext]);\n\n    // 更新 Ant Design 配置\n    const setAntdConfig = useCallback((config: ConfigProviderProps | undefined) => {\n        setAntdConfigState(config);\n    }, []);\n\n    // 更新初始化上下文\n    const setInitializationContext = useCallback((context: InitializationContext | undefined) => {\n        setInitializationContextState(context);\n    }, []);\n\n    const value: ConfigContextValue = useMemo(\n        () => ({\n            antdConfig,\n            initializationContext,\n            setAntdConfig,\n            setInitializationContext,\n        }),\n        [antdConfig, initializationContext, setAntdConfig, setInitializationContext]\n    );\n\n    return <ConfigContext.Provider value={value}>{children}</ConfigContext.Provider>;\n});\n\nAppConfigProvider.displayName = 'AppConfigProvider';\n\n/**\n * 应用上下文 Provider 属性\n */\nexport interface AppContextProviderProps extends PropsWithChildren {\n    /**\n     * 初始主题配置\n     */\n    initialTheme?: ThemeConfig;\n    /**\n     * 初始国际化语言\n     */\n    initialLocale?: LangType;\n    /**\n     * 初始 Ant Design 配置\n     */\n    initialAntdConfig?: ConfigProviderProps;\n    /**\n     * 初始初始化上下文\n     */\n    initialInitializationContext?: InitializationContext;\n    /**\n     * 状态管理器实例\n     */\n    stateManager?: StateManager | null;\n    /**\n     * antd App 组件配置\n     * \n     * 用于配置 antd 的 App 组件，使 message、modal、notification 等静态方法能够正确使用。\n     */\n    antdApp?: AppProps;\n}\n\n/**\n * 应用上下文 Provider 组件\n * \n * 组合所有 Provider，提供统一的全局上下文\n * \n * @example\n * ```tsx\n * <AppContextProvider\n *   initialTheme={{ mode: 'light', primaryColor: '#1890ff' }}\n *   initialLocale=\"zh-CN\"\n * >\n *   <App />\n * </AppContextProvider>\n * ```\n */\n/**\n * 状态管理器 Provider 组件\n */\nconst StateManagerProvider: React.FC<PropsWithChildren<{ stateManager?: StateManager | null }>> = React.memo(({ children, stateManager }) => {\n    const value = useMemo(\n        () => ({\n            stateManager: stateManager ?? null,\n        }),\n        [stateManager]\n    );\n\n    return <StateManagerContext.Provider value={value}>{children}</StateManagerContext.Provider>;\n});\n\nStateManagerProvider.displayName = 'StateManagerProvider';\n\nexport const AppContextProvider: React.FC<AppContextProviderProps> = ({\n    children,\n    initialTheme,\n    initialLocale,\n    initialAntdConfig,\n    initialInitializationContext,\n    stateManager,\n    antdApp,\n}) => {\n    // 初始化单例配置（仅执行一次）\n    const initializedRef = React.useRef(false);\n    React.useEffect(() => {\n        if (!initializedRef.current) {\n            appConfig.initialize({\n                theme: initialTheme,\n                locale: initialLocale,\n                antdConfig: initialAntdConfig,\n                initializationContext: initialInitializationContext,\n            });\n            initializedRef.current = true;\n        }\n    }, [initialTheme, initialLocale, initialAntdConfig, initialInitializationContext]);\n\n    return (\n        <ThemeProvider initialTheme={initialTheme}>\n            <LocaleProvider initialLocale={initialLocale}>\n                <AppConfigProvider\n                    initialAntdConfig={initialAntdConfig}\n                    initialInitializationContext={initialInitializationContext}\n                >\n                    <App {...antdApp}>\n                        <StateManagerProvider stateManager={stateManager}>\n                            {children}\n                        </StateManagerProvider>\n                    </App>\n                </AppConfigProvider>\n            </LocaleProvider>\n        </ThemeProvider>\n    );\n};\n\n/**\n * 使用主题上下文 Hook\n * \n * @returns 主题上下文值\n * @throws 如果不在 ThemeProvider 内使用会抛出错误\n * \n * @example\n * ```tsx\n * const { theme, setTheme } = useTheme();\n * \n * // 切换主题\n * setTheme({ mode: 'dark' });\n * ```\n */\nexport const useTheme = (): ThemeContextValue => {\n    const context = useContext(ThemeContext);\n    if (context === undefined) {\n        throw new Error('useTheme 必须在 AppContextProvider 内使用');\n    }\n    return context;\n};\n\n/**\n * 使用国际化上下文 Hook\n * \n * @returns 国际化上下文值\n * @throws 如果不在 LocaleProvider 内使用会抛出错误\n * \n * @example\n * ```tsx\n * const { locale, setLocale } = useLocale();\n * \n * // 切换语言\n * setLocale('en-US');\n * ```\n */\nexport const useLocale = (): LocaleContextValue => {\n    const context = useContext(LocaleContext);\n    if (context === undefined) {\n        throw new Error('useLocale 必须在 AppContextProvider 内使用');\n    }\n    return context;\n};\n\n/**\n * 使用配置上下文 Hook\n * \n * @returns 配置上下文值\n * @throws 如果不在 ConfigProvider 内使用会抛出错误\n */\nexport const useConfig = (): ConfigContextValue => {\n    const context = useContext(ConfigContext);\n    if (context === undefined) {\n        throw new Error('useConfig 必须在 AppContextProvider 内使用');\n    }\n    return context;\n};\n\n/**\n * 使用应用上下文 Hook（聚合所有上下文）\n * \n * @returns 应用上下文值\n * @throws 如果不在 AppContextProvider 内使用会抛出错误\n * \n * @example\n * ```tsx\n * const { theme, setTheme, locale, setLocale, antdConfig } = useAppContext();\n * \n * // 切换主题\n * setTheme({ mode: 'dark' });\n * \n * // 切换语言\n * setLocale('en-US');\n * ```\n */\n/**\n * 使用状态管理器 Hook\n * \n * @returns 状态管理器实例\n * @throws 如果不在 AppContextProvider 内使用会抛出错误\n * \n * @example\n * ```tsx\n * const stateManager = useStateManager();\n * \n * // 创建状态实例\n * const countState = stateManager?.createState(0);\n * ```\n */\nexport const useStateManager = (): StateManager | null => {\n    const context = useContext(StateManagerContext);\n    if (context === undefined) {\n        throw new Error('useStateManager 必须在 AppContextProvider 内使用');\n    }\n    return context.stateManager;\n};\n\nexport const useAppContext = (): AppContextValue => {\n    const themeContext = useTheme();\n    const localeContext = useLocale();\n    const configContext = useConfig();\n    const stateManagerContext = useStateManager();\n\n    // 优化：使用更细粒度的依赖项，避免不必要的重新计算\n    // 只依赖实际变化的值，函数引用是稳定的\n    return useMemo(\n        () => ({\n            theme: themeContext.theme,\n            locale: localeContext.locale,\n            antdConfig: configContext.antdConfig,\n            initializationContext: configContext.initializationContext,\n            stateManager: stateManagerContext,\n            setTheme: themeContext.setTheme,\n            setLocale: localeContext.setLocale,\n            setAntdConfig: configContext.setAntdConfig,\n            setInitializationContext: configContext.setInitializationContext,\n        }),\n        [\n            themeContext.theme,\n            localeContext.locale,\n            configContext.antdConfig,\n            configContext.initializationContext,\n            stateManagerContext,\n            // 函数引用是稳定的，不需要作为依赖\n            themeContext.setTheme,\n            localeContext.setLocale,\n            configContext.setAntdConfig,\n            configContext.setInitializationContext,\n        ]\n    );\n};\n"],"names":["AppContextProvider","useAppContext","useConfig","useLocale","useStateManager","useTheme","ThemeContext","createContext","undefined","LocaleContext","ConfigContext","StateManagerContext","ThemeProvider","React","memo","children","initialTheme","theme","setThemeState","useState","appConfig","getTheme","useEffect","setTheme","useCallback","newTheme","prev","updated","mode","requestAnimationFrame","html","document","documentElement","classList","remove","style","transition","add","prefersDark","window","matchMedia","matches","value","useMemo","Provider","displayName","LocaleProvider","initialLocale","locale","setLocaleState","getLocale","isChanging","setIsChanging","setLocale","newLocale","setLang","AppConfigProvider","initialAntdConfig","initialInitializationContext","antdConfig","setAntdConfigState","getAntdConfig","initializationContext","setInitializationContextState","getInitializationContext","setAntdConfig","setInitializationContext","config","context","StateManagerProvider","stateManager","antdApp","initializedRef","useRef","current","initialize","App","useContext","Error","themeContext","localeContext","configContext","stateManagerContext"],"mappings":"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"}

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

@@ -0,0 +1,110 @@
+import React from 'react';
+import type { PropsWithChildren } from 'react';
+import type { AppProps, ConfigProviderProps } from 'antd';
+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';
+/**
+ * 应用上下文 Provider 属性
+ */
+export interface AppContextProviderProps extends PropsWithChildren {
+    /**
+     * 初始主题配置
+     */
+    initialTheme?: ThemeConfig;
+    /**
+     * 初始国际化语言
+     */
+    initialLocale?: LangType;
+    /**
+     * 初始 Ant Design 配置
+     */
+    initialAntdConfig?: ConfigProviderProps;
+    /**
+     * 初始初始化上下文
+     */
+    initialInitializationContext?: InitializationContext;
+    /**
+     * 状态管理器实例
+     */
+    stateManager?: StateManager | null;
+    /**
+     * antd App 组件配置
+     *
+     * 用于配置 antd 的 App 组件，使 message、modal、notification 等静态方法能够正确使用。
+     */
+    antdApp?: AppProps;
+}
+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;
+//# sourceMappingURL=AppContext.d.ts.map

package/dist/core/app/AppContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppContext.d.ts","sourceRoot":"","sources":["../../../src/core/app/AppContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+E,MAAM,OAAO,CAAC;AACpG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EACR,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA2MhD;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAC9D;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;OAEG;IACH,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB;;OAEG;IACH,iBAAiB,CAAC,EAAE,mBAAmB,CAAC;IACxC;;OAEG;IACH,4BAA4B,CAAC,EAAE,qBAAqB,CAAC;IACrD;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;CACtB;AAiCD,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuChE,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,QAAO,iBAM3B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,QAAO,kBAM5B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,QAAO,kBAM5B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,QAAO,YAAY,GAAG,IAMjD,CAAC;AAEF,eAAO,MAAM,aAAa,QAAO,eAiChC,CAAC"}