@vlian/framework 1.2.60 → 1.2.62

package/dist/analytics.umd.js

@@ -1,5 +1,5 @@
 /*!
- * @vlian/framework v1.2.59
+ * @vlian/framework v1.2.61
  * Secra Framework - 一个现代化的低代码框架
  * (c) 2026 Secra Framework Contributors
  * Licensed under Apache-2.0

package/dist/components/index.cjs

@@ -1 +1 @@
-"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 LocaleSwitch(){return _LocaleSwitch.LocaleSwitch},get ThemeSwitch(){return _ThemeSwitch.ThemeSwitch}});const _ThemeSwitch=require("./ThemeSwitch");const _LocaleSwitch=require("./LocaleSwitch");
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});

package/dist/components/index.d.ts

@@ -1,5 +1 @@
-export { ThemeSwitch } from './ThemeSwitch';
-export type { ThemeSwitchProps, ThemeSwitchRenderContext } from './ThemeSwitch';
-export { LocaleSwitch } from './LocaleSwitch';
-export type { LocaleSwitchProps, LocaleSwitchRenderContext } from './LocaleSwitch';
 export type { PersistenceOptions, StorageLike } from './persistence';

package/dist/components/index.js

@@ -1 +1 @@
-export{ThemeSwitch}from"./ThemeSwitch";export{LocaleSwitch}from"./LocaleSwitch";
+export{};

package/dist/core-bak/Test.cjs

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

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

package/dist/core-bak/Test.js

@@ -0,0 +1 @@
+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

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

@@ -0,0 +1,113 @@
+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

@@ -0,0 +1 @@
+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

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

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

@@ -0,0 +1,146 @@
+import type { LangType } from '../../library/locale/types';
+import type { InitializationContext } from '../initialization';
+import type { StateManager } from '../../state';
+import type { UIProviderConfig } from '../types';
+/**
+ * 主题配置
+ */
+export interface ThemeConfig {
+    /**
+     * 主题模式：'light' | 'dark' | 'system'
+     * - 'light': 浅色主题
+     * - 'dark': 深色主题
+     * - 'system': 跟随系统设置
+     */
+    mode?: 'light' | 'dark' | 'system';
+    /**
+     * 主题色（主色调）
+     */
+    primaryColor?: string;
+    /**
+     * 自定义主题配置
+     */
+    custom?: Record<string, unknown>;
+}
+/**
+ * 应用配置接口
+ */
+export interface AppConfig {
+    /**
+     * 主题配置
+     */
+    theme: ThemeConfig;
+    /**
+     * 国际化语言
+     */
+    locale: LangType;
+    /**
+     * Ant Design 配置
+     */
+    antdConfig?: UIProviderConfig;
+    /**
+     * 初始化上下文
+     */
+    initializationContext?: InitializationContext;
+}
+/**
+ * 主题上下文值
+ */
+export interface ThemeContextValue {
+    /**
+     * 主题配置
+     */
+    theme: ThemeConfig;
+    /**
+     * 更新主题
+     */
+    setTheme: (theme: ThemeConfig | ((prev: ThemeConfig) => ThemeConfig)) => void;
+}
+/**
+ * 国际化上下文值
+ */
+export interface LocaleContextValue {
+    /**
+     * 当前语言
+     */
+    locale: LangType;
+    /**
+     * 更新语言
+     */
+    setLocale: (locale: LangType) => void;
+    /**
+     * 是否正在切换语言
+     */
+    isChanging?: boolean;
+}
+/**
+ * 配置上下文值
+ */
+export interface ConfigContextValue {
+    /**
+     * Ant Design 配置
+     */
+    antdConfig?: UIProviderConfig;
+    /**
+     * 初始化上下文
+     */
+    initializationContext?: InitializationContext;
+    /**
+     * 更新 Ant Design 配置
+     */
+    setAntdConfig: (config: UIProviderConfig | undefined) => void;
+    /**
+     * 更新初始化上下文
+     */
+    setInitializationContext: (context: InitializationContext | undefined) => void;
+}
+/**
+ * 状态管理器上下文值
+ */
+export interface StateManagerContextValue {
+    /**
+     * 状态管理器实例
+     */
+    stateManager: StateManager | null;
+}
+/**
+ * 应用全局上下文值（聚合所有上下文）
+ */
+export interface AppContextValue {
+    /**
+     * 主题配置
+     */
+    theme: ThemeConfig;
+    /**
+     * 国际化语言
+     */
+    locale: LangType;
+    /**
+     * Ant Design 配置
+     */
+    antdConfig?: UIProviderConfig;
+    /**
+     * 初始化上下文
+     */
+    initializationContext?: InitializationContext;
+    /**
+     * 状态管理器实例
+     */
+    stateManager: StateManager | null;
+    /**
+     * 更新主题
+     */
+    setTheme: (theme: ThemeConfig | ((prev: ThemeConfig) => ThemeConfig)) => void;
+    /**
+     * 更新国际化语言
+     */
+    setLocale: (locale: LangType) => void;
+    /**
+     * 更新 Ant Design 配置
+     */
+    setAntdConfig: (config: UIProviderConfig | undefined) => void;
+    /**
+     * 更新初始化上下文
+     */
+    setInitializationContext: (context: InitializationContext | undefined) => void;
+}

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

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

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"BasicLayout",{enumerable:true,get:function(){return BasicLayout}});const _jsxruntime=require("react/jsx-runtime");const _react=/*#__PURE__*/_interop_require_wildcard(require("react"));const _AppContext=require("./AppContext");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 BasicLayout=(0,_react.memo)(({children,configProps:externalConfigProps,globalProvider})=>{const{antdConfig,theme}=(0,_AppContext.useAppContext)();const[isSystemDark,setIsSystemDark]=_react.default.useState(()=>{if(typeof window==="undefined"){return false}return window.matchMedia("(prefers-color-scheme: dark)").matches});const finalConfigProps=antdConfig||externalConfigProps;_react.default.useEffect(()=>{if(typeof window==="undefined"){return}const mediaQuery=window.matchMedia("(prefers-color-scheme: dark)");const updateSystemTheme=event=>{setIsSystemDark(event.matches)};setIsSystemDark(mediaQuery.matches);if(typeof mediaQuery.addEventListener==="function"){mediaQuery.addEventListener("change",updateSystemTheme);return()=>mediaQuery.removeEventListener("change",updateSystemTheme)}mediaQuery.addListener(updateSystemTheme);return()=>mediaQuery.removeListener(updateSystemTheme)},[]);const resolvedMode=theme.mode==="system"?isSystemDark?"dark":"light":theme.mode;const cssVars=_react.default.useMemo(()=>{const vars={};if(theme.primaryColor){vars["--app-primary-color"]=theme.primaryColor}if(finalConfigProps&&typeof finalConfigProps==="object"){const cssVariables=finalConfigProps.cssVariables;if(cssVariables&&typeof cssVariables==="object"){Object.entries(cssVariables).forEach(([key,value])=>{vars[`--${key}`]=String(value)})}}return vars},[finalConfigProps,theme.primaryColor]);const GlobalProvider=_react.default.useMemo(()=>globalProvider?_react.default.lazy(globalProvider):null,[globalProvider]);const renderedContent=_react.default.useMemo(()=>{if(!GlobalProvider){return children}return(0,_jsxruntime.jsx)(_react.default.Suspense,{fallback:null,children:(0,_jsxruntime.jsx)(GlobalProvider,{children:children})})},[GlobalProvider,children]);return(0,_jsxruntime.jsx)("div",{"data-theme-mode":resolvedMode,style:cssVars,children:renderedContent})});BasicLayout.displayName="BasicLayout";

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

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PropsWithChildren } from 'react';
+import type { GlobalProviderLoader, UIProviderConfig } from '../types';
+interface BasicLayoutProps {
+    /**
+     * 外部传入 UI provider 配置（向后兼容沿用 configProps 命名）
+     */
+    configProps?: UIProviderConfig;
+    /**
+     * 全局 UI 包裹组件懒加载器
+     */
+    globalProvider?: GlobalProviderLoader;
+}
+declare const BasicLayout: React.FC<PropsWithChildren<BasicLayoutProps>>;
+export { BasicLayout };

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

@@ -0,0 +1 @@
+import{jsx as _jsx}from"react/jsx-runtime";import React,{memo}from"react";import{useAppContext}from"./AppContext";const BasicLayout=memo(({children,configProps:externalConfigProps,globalProvider})=>{const{antdConfig,theme}=useAppContext();const[isSystemDark,setIsSystemDark]=React.useState(()=>{if(typeof window==="undefined"){return false}return window.matchMedia("(prefers-color-scheme: dark)").matches});const finalConfigProps=antdConfig||externalConfigProps;React.useEffect(()=>{if(typeof window==="undefined"){return}const mediaQuery=window.matchMedia("(prefers-color-scheme: dark)");const updateSystemTheme=event=>{setIsSystemDark(event.matches)};setIsSystemDark(mediaQuery.matches);if(typeof mediaQuery.addEventListener==="function"){mediaQuery.addEventListener("change",updateSystemTheme);return()=>mediaQuery.removeEventListener("change",updateSystemTheme)}mediaQuery.addListener(updateSystemTheme);return()=>mediaQuery.removeListener(updateSystemTheme)},[]);const resolvedMode=theme.mode==="system"?isSystemDark?"dark":"light":theme.mode;const cssVars=React.useMemo(()=>{const vars={};if(theme.primaryColor){vars["--app-primary-color"]=theme.primaryColor}if(finalConfigProps&&typeof finalConfigProps==="object"){const cssVariables=finalConfigProps.cssVariables;if(cssVariables&&typeof cssVariables==="object"){Object.entries(cssVariables).forEach(([key,value])=>{vars[`--${key}`]=String(value)})}}return vars},[finalConfigProps,theme.primaryColor]);const GlobalProvider=React.useMemo(()=>globalProvider?React.lazy(globalProvider):null,[globalProvider]);const renderedContent=React.useMemo(()=>{if(!GlobalProvider){return children}return _jsx(React.Suspense,{fallback:null,children:_jsx(GlobalProvider,{children:children})})},[GlobalProvider,children]);return _jsx("div",{"data-theme-mode":resolvedMode,style:cssVars,children:renderedContent})});BasicLayout.displayName="BasicLayout";export{BasicLayout};

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"DefaultApp",{enumerable:true,get:function(){return DefaultApp}});const _jsxruntime=require("react/jsx-runtime");const _react=require("react");const _library=require("../../library");const cardStyle={background:"rgba(255, 255, 255, 0.96)",borderRadius:10,boxShadow:"0 6px 20px rgba(0, 0, 0, 0.14)",padding:20};const DefaultApp=(0,_react.memo)(({title,description})=>{const displayTitle=title||(0,_library.$t)("defaultApp.title");const displayDescription=description||(0,_library.$t)("defaultApp.description");return(0,_jsxruntime.jsx)("div",{style:{minHeight:"100vh",display:"flex",alignItems:"center",justifyContent:"center",padding:24,background:"linear-gradient(130deg, #274c77 0%, #2c7da0 42%, #61a5c2 100%)"},children:(0,_jsxruntime.jsxs)("div",{style:{maxWidth:860,width:"100%"},children:[(0,_jsxruntime.jsxs)("div",{style:{textAlign:"center",marginBottom:28,color:"#fff"},children:[(0,_jsxruntime.jsx)("div",{style:{fontSize:56,lineHeight:"60px",marginBottom:12},children:"🚀"}),(0,_jsxruntime.jsx)("h1",{style:{margin:0,fontSize:34},children:displayTitle}),(0,_jsxruntime.jsx)("p",{style:{marginTop:12,opacity:.9},children:displayDescription})]}),(0,_jsxruntime.jsxs)("div",{style:{display:"grid",gap:16},children:[(0,_jsxruntime.jsxs)("section",{style:cardStyle,children:[(0,_jsxruntime.jsxs)("h2",{style:{marginTop:0},children:["💻 ",(0,_library.$t)("defaultApp.quickStart.title")]}),(0,_jsxruntime.jsx)("p",{children:(0,_library.$t)("defaultApp.quickStart.description")}),(0,_jsxruntime.jsx)("pre",{style:{margin:0,background:"#f4f6f8",borderRadius:8,padding:12,overflowX:"auto"},children:(0,_library.$t)("defaultApp.quickStart.code")})]}),(0,_jsxruntime.jsxs)("section",{style:cardStyle,children:[(0,_jsxruntime.jsxs)("h2",{style:{marginTop:0},children:["📚 ",(0,_library.$t)("defaultApp.nextSteps.title")]}),(0,_jsxruntime.jsxs)("ul",{style:{paddingLeft:20,marginBottom:0},children:[(0,_jsxruntime.jsx)("li",{children:(0,_library.$t)("defaultApp.nextSteps.step1")}),(0,_jsxruntime.jsx)("li",{children:(0,_library.$t)("defaultApp.nextSteps.step2")}),(0,_jsxruntime.jsx)("li",{children:(0,_library.$t)("defaultApp.nextSteps.step3")})]})]})]}),(0,_jsxruntime.jsx)("p",{style:{textAlign:"center",color:"rgba(255,255,255,0.88)",marginTop:18},children:(0,_library.$t)("defaultApp.footer")})]})})});DefaultApp.displayName="DefaultApp";

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

@@ -0,0 +1,10 @@
+/**
+ * 默认应用页面组件
+ * 当用户未提供 app 选项时显示的默认页面
+ */
+interface DefaultAppProps {
+    title?: string;
+    description?: string;
+}
+declare const DefaultApp: import("react").NamedExoticComponent<DefaultAppProps>;
+export { DefaultApp };

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

@@ -0,0 +1 @@
+import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{memo}from"react";import{$t}from"../../library";const cardStyle={background:"rgba(255, 255, 255, 0.96)",borderRadius:10,boxShadow:"0 6px 20px rgba(0, 0, 0, 0.14)",padding:20};const DefaultApp=memo(({title,description})=>{const displayTitle=title||$t("defaultApp.title");const displayDescription=description||$t("defaultApp.description");return _jsx("div",{style:{minHeight:"100vh",display:"flex",alignItems:"center",justifyContent:"center",padding:24,background:"linear-gradient(130deg, #274c77 0%, #2c7da0 42%, #61a5c2 100%)"},children:_jsxs("div",{style:{maxWidth:860,width:"100%"},children:[_jsxs("div",{style:{textAlign:"center",marginBottom:28,color:"#fff"},children:[_jsx("div",{style:{fontSize:56,lineHeight:"60px",marginBottom:12},children:"🚀"}),_jsx("h1",{style:{margin:0,fontSize:34},children:displayTitle}),_jsx("p",{style:{marginTop:12,opacity:.9},children:displayDescription})]}),_jsxs("div",{style:{display:"grid",gap:16},children:[_jsxs("section",{style:cardStyle,children:[_jsxs("h2",{style:{marginTop:0},children:["💻 ",$t("defaultApp.quickStart.title")]}),_jsx("p",{children:$t("defaultApp.quickStart.description")}),_jsx("pre",{style:{margin:0,background:"#f4f6f8",borderRadius:8,padding:12,overflowX:"auto"},children:$t("defaultApp.quickStart.code")})]}),_jsxs("section",{style:cardStyle,children:[_jsxs("h2",{style:{marginTop:0},children:["📚 ",$t("defaultApp.nextSteps.title")]}),_jsxs("ul",{style:{paddingLeft:20,marginBottom:0},children:[_jsx("li",{children:$t("defaultApp.nextSteps.step1")}),_jsx("li",{children:$t("defaultApp.nextSteps.step2")}),_jsx("li",{children:$t("defaultApp.nextSteps.step3")})]})]})]}),_jsx("p",{style:{textAlign:"center",color:"rgba(255,255,255,0.88)",marginTop:18},children:$t("defaultApp.footer")})]})})});DefaultApp.displayName="DefaultApp";export{DefaultApp};

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

@@ -0,0 +1 @@
+"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 _AppContext.AppContextProvider},get BasicLayout(){return _BasicLayout.BasicLayout},get DefaultApp(){return _DefaultApp.DefaultApp},get useAppContext(){return _AppContext.useAppContext},get useConfig(){return _AppContext.useConfig},get useLocale(){return _AppContext.useLocale},get useStateManager(){return _AppContext.useStateManager},get useTheme(){return _AppContext.useTheme}});const _AppContext=require("./AppContext");const _DefaultApp=require("./DefaultApp");const _BasicLayout=require("./BasicLayout");

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

@@ -0,0 +1,8 @@
+/**
+ * 应用核心模块
+ */
+export { AppContextProvider, useAppContext, useTheme, useLocale, useConfig, useStateManager } from './AppContext';
+export type { AppContextProviderProps } from './AppContext';
+export type { AppContextValue, ThemeContextValue, LocaleContextValue, ConfigContextValue, StateManagerContextValue, ThemeConfig, AppConfig, } from './AppContext.types';
+export { DefaultApp } from './DefaultApp';
+export { BasicLayout } from './BasicLayout';

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

@@ -0,0 +1 @@
+export{AppContextProvider,useAppContext,useTheme,useLocale,useConfig,useStateManager}from"./AppContext";export{DefaultApp}from"./DefaultApp";export{BasicLayout}from"./BasicLayout";

package/dist/core-bak/config/AppConfig.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"appConfig",{enumerable:true,get:function(){return appConfig}});function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}let AppConfigManager=class AppConfigManager{static getInstance(){if(!AppConfigManager.instance){AppConfigManager.instance=new AppConfigManager}return AppConfigManager.instance}initialize(config){this._config={theme:config.theme||{mode:"light"},locale:config.locale||"zh-CN",antdConfig:config.antdConfig,initializationContext:config.initializationContext}}getConfig(){return{...this._config}}getTheme(){return{...this._config.theme}}setTheme(theme){if(typeof theme==="function"){this._config.theme=theme(this._config.theme)}else{this._config.theme={...theme}}}getLocale(){return this._config.locale}setLocale(locale){this._config.locale=locale}getAntdConfig(){return this._config.antdConfig}setAntdConfig(config){this._config.antdConfig=config}getInitializationContext(){return this._config.initializationContext}setInitializationContext(context){this._config.initializationContext=context}constructor(){_define_property(this,"_config",void 0);this._config={theme:{mode:"light"},locale:"zh-CN"}}};_define_property(AppConfigManager,"instance",null);const appConfig=AppConfigManager.getInstance();

package/dist/core-bak/config/AppConfig.d.ts

@@ -0,0 +1,88 @@
+import type { LangType } from '../../library/locale/types';
+import type { InitializationContext } from '../initialization';
+import type { AppConfig, ThemeConfig } from '../app';
+import type { UIProviderConfig } from '../types';
+/**
+ * 应用配置单例
+ *
+ * 用于在非 React 代码中访问全局配置
+ */
+declare class AppConfigManager {
+    private static instance;
+    private _config;
+    /**
+     * 私有构造函数，防止外部直接实例化
+     */
+    private constructor();
+    /**
+     * 获取单例实例
+     *
+     * @returns 单例实例
+     */
+    static getInstance(): AppConfigManager;
+    /**
+     * 初始化配置
+     *
+     * @param config - 应用配置
+     */
+    initialize(config: Partial<AppConfig>): void;
+    /**
+     * 获取完整配置
+     *
+     * @returns 应用配置
+     */
+    getConfig(): AppConfig;
+    /**
+     * 获取主题配置
+     *
+     * @returns 主题配置
+     */
+    getTheme(): ThemeConfig;
+    /**
+     * 更新主题配置
+     *
+     * @param theme - 主题配置或更新函数
+     */
+    setTheme(theme: ThemeConfig | ((prev: ThemeConfig) => ThemeConfig)): void;
+    /**
+     * 获取当前语言
+     *
+     * @returns 当前语言
+     */
+    getLocale(): LangType;
+    /**
+     * 更新语言
+     *
+     * @param locale - 语言类型
+     */
+    setLocale(locale: LangType): void;
+    /**
+     * 获取 Ant Design 配置
+     *
+     * @returns Ant Design 配置
+     */
+    getAntdConfig(): UIProviderConfig | undefined;
+    /**
+     * 更新 Ant Design 配置
+     *
+     * @param config - Ant Design 配置
+     */
+    setAntdConfig(config: UIProviderConfig | undefined): void;
+    /**
+     * 获取初始化上下文
+     *
+     * @returns 初始化上下文
+     */
+    getInitializationContext(): InitializationContext | undefined;
+    /**
+     * 更新初始化上下文
+     *
+     * @param context - 初始化上下文
+     */
+    setInitializationContext(context: InitializationContext | undefined): void;
+}
+/**
+ * 应用配置单例实例
+ */
+export declare const appConfig: AppConfigManager;
+export {};

package/dist/core-bak/config/AppConfig.js

@@ -0,0 +1 @@
+function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}let AppConfigManager=class AppConfigManager{static getInstance(){if(!AppConfigManager.instance){AppConfigManager.instance=new AppConfigManager}return AppConfigManager.instance}initialize(config){this._config={theme:config.theme||{mode:"light"},locale:config.locale||"zh-CN",antdConfig:config.antdConfig,initializationContext:config.initializationContext}}getConfig(){return{...this._config}}getTheme(){return{...this._config.theme}}setTheme(theme){if(typeof theme==="function"){this._config.theme=theme(this._config.theme)}else{this._config.theme={...theme}}}getLocale(){return this._config.locale}setLocale(locale){this._config.locale=locale}getAntdConfig(){return this._config.antdConfig}setAntdConfig(config){this._config.antdConfig=config}getInitializationContext(){return this._config.initializationContext}setInitializationContext(context){this._config.initializationContext=context}constructor(){_define_property(this,"_config",void 0);this._config={theme:{mode:"light"},locale:"zh-CN"}}};_define_property(AppConfigManager,"instance",null);export const appConfig=AppConfigManager.getInstance();

package/dist/core-bak/config/ConfigLoader.cjs

@@ -0,0 +1 @@
+"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 ConfigFileFormat(){return ConfigFileFormat},get ConfigLoader(){return ConfigLoader}});const _logger=require("@vlian/logger");function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}var ConfigFileFormat=/*#__PURE__*/function(ConfigFileFormat){ConfigFileFormat["JSON"]="json";ConfigFileFormat["YAML"]="yaml";return ConfigFileFormat}({});let ConfigChangeNotifier=class ConfigChangeNotifier{addListener(listener){this.listeners.add(listener);return()=>{this.listeners.delete(listener)}}removeListener(listener){this.listeners.delete(listener)}notify(newConfig,oldConfig){this.listeners.forEach(listener=>{try{listener(newConfig,oldConfig)}catch(error){_logger.logger.warn("配置变更监听器执行失败:",error)}})}clear(){this.listeners.clear()}constructor(){_define_property(this,"listeners",new Set)}};const configChangeNotifier=new ConfigChangeNotifier;let ConfigLoader=class ConfigLoader{static async loadFromJSON(path){try{if(typeof window!=="undefined"){const response=await fetch(path);if(!response.ok){throw new Error(`无法加载配置文件: ${path} (${response.status})`)}return await response.json()}if(typeof require!=="undefined"){const fs=require("fs");const content=fs.readFileSync(path,"utf-8");return JSON.parse(content)}throw new Error("不支持的环境：无法加载配置文件")}catch(error){_logger.logger.error(`加载JSON配置文件失败: ${path}`,error);throw error}}static async loadFromYAML(path){try{if(typeof window!=="undefined"){const response=await fetch(path);if(!response.ok){throw new Error(`无法加载配置文件: ${path} (${response.status})`)}const text=await response.text();if(typeof window.YAML!=="undefined"){return window.YAML.parse(text)}try{return JSON.parse(text)}catch{throw new Error("需要YAML解析库，请安装 yaml 包")}}if(typeof require!=="undefined"){const fs=require("fs");const yaml=require("yaml");const content=fs.readFileSync(path,"utf-8");return yaml.parse(content)}throw new Error("不支持的环境：无法加载配置文件")}catch(error){_logger.logger.error(`加载YAML配置文件失败: ${path}`,error);throw error}}static async loadFromFile(options){const{path,format="json",required=false,defaultConfig={}}=options;if(!path){if(required){throw new Error("配置文件路径未指定")}return defaultConfig}try{let config;switch(format){case"json":config=await this.loadFromJSON(path);break;case"yaml":config=await this.loadFromYAML(path);break;default:throw new Error(`不支持的配置文件格式: ${format}`)}_logger.logger.info(`成功加载配置文件: ${path}`);return config}catch(error){if(required){throw error}_logger.logger.warn(`配置文件加载失败，使用默认配置: ${path}`,error);return defaultConfig}}static mergeConfig(base,override){const merged={...base};for(const key in override){if(!Object.prototype.hasOwnProperty.call(override,key)){continue}const baseValue=merged[key];const overrideValue=override[key];if(baseValue&&overrideValue&&typeof baseValue==="object"&&typeof overrideValue==="object"&&!Array.isArray(baseValue)&&!Array.isArray(overrideValue)){merged[key]=this.mergeConfig(baseValue,overrideValue)}else{merged[key]=overrideValue}}return merged}static async loadFromMultipleSources(sources){let merged={};for(const source of sources){if("path"in source&&"format"in source){const fileConfig=await this.loadFromFile(source);merged=this.mergeConfig(merged,fileConfig)}else if(!("path"in source)&&!("format"in source)){merged=this.mergeConfig(merged,source)}}return merged}static loadFromEnv(prefix="FRAMEWORK_"){const config={};if(typeof process==="undefined"||!process.env){return config}for(const[key,value]of Object.entries(process.env)){if(!key.startsWith(prefix)){continue}const configKey=key.slice(prefix.length).toLowerCase().split("_").map((part,index)=>index===0?part:part.charAt(0).toUpperCase()+part.slice(1)).join("");let parsedValue=value;if(value==="true"||value==="false"){parsedValue=value==="true"}else if(!isNaN(Number(value))){parsedValue=Number(value)}else if(value?.startsWith("{")||value?.startsWith("[")){try{parsedValue=JSON.parse(value)}catch{}}config[configKey]=parsedValue}_logger.logger.debug("从环境变量加载配置:",config);return config}static async loadFromAllSources(sources=[],defaultConfig={},includeEnv=true,envPrefix="FRAMEWORK_"){const oldConfig={...defaultConfig};let merged={...defaultConfig};const fileConfigs=await this.loadFromMultipleSources(sources.filter(source=>typeof source==="object"&&"path"in source));merged=this.mergeConfig(merged,fileConfigs);if(includeEnv){const envConfig=this.loadFromEnv(envPrefix);merged=this.mergeConfig(merged,envConfig)}const codeConfigs=sources.filter(source=>typeof source==="object"&&!("path"in source));for(const codeConfig of codeConfigs){merged=this.mergeConfig(merged,codeConfig)}configChangeNotifier.notify(merged,oldConfig);return merged}static onConfigChange(listener){return configChangeNotifier.addListener(listener)}static removeConfigChangeListener(listener){configChangeNotifier.removeListener(listener)}};

package/dist/core-bak/config/ConfigLoader.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 配置文件加载模块
+ * 支持从JSON/YAML文件加载配置
+ * 优化：支持环境变量配置、配置热更新
+ */
+import type { StartOptions } from '../types';
+/**
+ * 配置文件格式
+ */
+export declare enum ConfigFileFormat {
+    JSON = "json",
+    YAML = "yaml"
+}
+/**
+ * 配置文件加载选项
+ */
+export interface ConfigFileLoadOptions {
+    /**
+     * 配置文件路径
+     */
+    path?: string;
+    /**
+     * 配置文件格式
+     */
+    format?: ConfigFileFormat;
+    /**
+     * 是否必需（如果为false，文件不存在时不报错）
+     */
+    required?: boolean;
+    /**
+     * 默认配置（文件不存在时使用）
+     */
+    defaultConfig?: Partial<StartOptions>;
+}
+/**
+ * 配置变更监听器
+ */
+export type ConfigChangeListener = (newConfig: Partial<StartOptions>, oldConfig: Partial<StartOptions>) => void;
+/**
+ * 配置加载器
+ */
+export declare class ConfigLoader {
+    /**
+     * 从JSON文件加载配置
+     *
+     * @param path - 文件路径
+     * @returns 配置对象
+     */
+    static loadFromJSON(path: string): Promise<Partial<StartOptions>>;
+    /**
+     * 从YAML文件加载配置
+     *
+     * @param path - 文件路径
+     * @returns 配置对象
+     */
+    static loadFromYAML(path: string): Promise<Partial<StartOptions>>;
+    /**
+     * 从文件加载配置
+     *
+     * @param options - 加载选项
+     * @returns 配置对象
+     */
+    static loadFromFile(options: ConfigFileLoadOptions): Promise<Partial<StartOptions>>;
+    /**
+     * 合并配置（深度合并）
+     *
+     * @param base - 基础配置
+     * @param override - 覆盖配置
+     * @returns 合并后的配置
+     */
+    static mergeConfig(base: Partial<StartOptions>, override: Partial<StartOptions>): Partial<StartOptions>;
+    /**
+     * 从多个源加载并合并配置
+     *
+     * @param sources - 配置源列表（按优先级从低到高）
+     * @returns 合并后的配置
+     */
+    static loadFromMultipleSources(sources: Array<Partial<StartOptions> | ConfigFileLoadOptions>): Promise<Partial<StartOptions>>;
+    /**
+     * 从环境变量加载配置
+     *
+     * 支持以下环境变量格式：
+     * - FRAMEWORK_LOGGER_LEVEL=DEBUG
+     * - FRAMEWORK_SHOW_SPLASH_SCREEN=always
+     * - FRAMEWORK_MIN_SPLASH_SCREEN_TIME=1000
+     *
+     * @param prefix - 环境变量前缀，默认为 'FRAMEWORK_'
+     * @returns 配置对象
+     */
+    static loadFromEnv(prefix?: string): Partial<StartOptions>;
+    /**
+     * 从多个源加载配置（包括环境变量）
+     *
+     * 优化：明确优先级，从低到高：
+     * 1. 默认配置
+     * 2. 配置文件
+     * 3. 环境变量
+     * 4. 代码配置（通过 sources 参数传入）
+     *
+     * @param sources - 配置源列表（代码配置，优先级最高）
+     * @param defaultConfig - 默认配置（优先级最低）
+     * @param includeEnv - 是否包含环境变量，默认为 true
+     * @param envPrefix - 环境变量前缀，默认为 'FRAMEWORK_'
+     * @returns 合并后的配置
+     */
+    static loadFromAllSources(sources?: Array<Partial<StartOptions> | ConfigFileLoadOptions>, defaultConfig?: Partial<StartOptions>, includeEnv?: boolean, envPrefix?: string): Promise<Partial<StartOptions>>;
+    /**
+     * 添加配置变更监听器
+     *
+     * @param listener - 配置变更监听器
+     * @returns 取消监听的函数
+     */
+    static onConfigChange(listener: ConfigChangeListener): () => void;
+    /**
+     * 移除配置变更监听器
+     */
+    static removeConfigChangeListener(listener: ConfigChangeListener): void;
+}