@vlian/framework 1.2.18 → 1.2.25

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * @vlian/framework v1.2.18
+ * @vlian/framework v1.2.25
  * Secra Framework - 一个现代化的低代码框架
  * (c) 2026 Secra Framework Contributors
  * Licensed under Apache-2.0
@@ -17676,7 +17676,7 @@
         }
         /**
        * 获取单例实例
-       * 
+       *
        * @returns Singleton 实例
        */ static getInstance() {
             if (!Storage.instance) {
@@ -20446,7 +20446,7 @@
     }
     /**
      * 插件管理器
-     * 
+     *
      * 优化：
      * 1. 支持插件依赖管理
      * 2. 支持插件优先级控制
@@ -20455,7 +20455,7 @@
      */ let PluginManager$1 = class PluginManager {
         /**
        * 注册插件
-       * 
+       *
        * 优化：检查插件依赖是否已注册
        */ register(plugin) {
             if (this.plugins.has(plugin.name)) {
@@ -20488,7 +20488,7 @@
         }
         /**
        * 获取插件加载顺序（考虑依赖和优先级）
-       * 
+       *
        * @returns 插件名称数组，按加载顺序排列
        */ getLoadOrder() {
             const plugins = Array.from(this.plugins.values());
@@ -20540,7 +20540,7 @@
         }
         /**
        * 动态加载插件（热插拔）
-       * 
+       *
        * @param options - 插件加载选项
        * @returns 加载的插件
        */ async loadPlugin(options) {
@@ -20584,7 +20584,7 @@
         }
         /**
        * 初始化单个插件
-       * 
+       *
        * @param name - 插件名称
        * @param options - 启动选项
        * @param context - 初始化上下文
@@ -20615,7 +20615,7 @@
         }
         /**
        * 卸载插件（热插拔）
-       * 
+       *
        * @param name - 插件名称
        * @param force - 是否强制卸载（即使有依赖）
        */ async unloadPlugin(name, force = false) {
@@ -20647,7 +20647,7 @@
         }
         /**
        * 检查插件是否可以热加载
-       * 
+       *
        * @param plugin - 插件
        * @returns 是否可以热加载
        */ canHotLoad(plugin) {
@@ -20662,7 +20662,7 @@
         }
         /**
        * 注册插件加载器（用于延迟加载）
-       * 
+       *
        * @param name - 插件名称
        * @param loader - 加载器函数
        */ registerLoader(name, loader) {
@@ -20670,7 +20670,7 @@
         }
         /**
        * 使用加载器加载插件
-       * 
+       *
        * @param name - 插件名称
        * @param options - 加载选项
        * @returns 加载的插件
@@ -20717,7 +20717,7 @@
         }
         /**
        * 执行初始化前钩子
-       * 
+       *
        * 优化：按依赖顺序执行
        */ async executeBeforeInit(options) {
             const loadOrder = this.getLoadOrder();
@@ -20742,7 +20742,7 @@
         }
         /**
        * 执行初始化钩子
-       * 
+       *
        * 优化：按依赖顺序执行，并更新插件状态
        */ async executeInit(options, context) {
             const loadOrder = this.getLoadOrder();
@@ -20768,7 +20768,7 @@
         }
         /**
        * 执行初始化后钩子
-       * 
+       *
        * 优化：按依赖顺序执行（逆序，确保依赖插件先执行）
        */ async executeAfterInit(options, context) {
             const loadOrder = this.getLoadOrder();
@@ -20797,7 +20797,7 @@
         }
         /**
        * 获取插件状态
-       * 
+       *
        * @param name - 插件名称
        * @returns 插件状态
        */ getPluginStatus(name) {
@@ -20805,7 +20805,7 @@
         }
         /**
        * 检查插件是否已加载
-       * 
+       *
        * @param name - 插件名称
        * @returns 是否已加载
        */ isLoaded(name) {
@@ -20813,21 +20813,21 @@
         }
         /**
        * 获取已加载的插件列表
-       * 
+       *
        * @returns 插件名称数组
        */ getLoadedPlugins() {
             return Array.from(this.plugins.keys());
         }
         /**
        * 获取所有插件状态
-       * 
+       *
        * @returns 插件状态映射
        */ getAllPluginStatus() {
             return new Map(this.pluginStatus);
         }
         /**
        * 获取插件沙箱
-       * 
+       *
        * @param name - 插件名称
        * @returns 插件沙箱或undefined
        */ getSandbox(name) {
@@ -20863,68 +20863,6 @@
      * 默认插件管理器
      */ const pluginManager = new PluginManager$1();
 
-    /**
-     * 配置缓存键
-     */ const CONFIG_CACHE_KEY = '__framework_config_cache__';
-    /**
-     * 加载配置（带超时、重试和缓存）
-     */ async function loadConfigWithRetry(loadConfig, strategy, fallbackConfig) {
-        const timeout = strategy.configTimeout ?? 5000;
-        const retryCount = strategy.retryCount ?? 3;
-        const retryDelay = strategy.retryDelay ?? 1000;
-        const enableCache = strategy.enableCache ?? true;
-        const cacheTTL = strategy.cacheTTL ?? 5 * 60 * 1000; // 5分钟
-        const configVersion = strategy.configVersion;
-        // 检查缓存
-        if (enableCache && storage.localCache) {
-            try {
-                const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;
-                const cached = await storage.localCache.get(cacheKey);
-                if (cached && (!configVersion || cached.version === configVersion)) {
-                    logger.debug('使用缓存的配置');
-                    return cached.data;
-                }
-            } catch (error) {
-                logger.warn('读取配置缓存失败:', error);
-            }
-        }
-        // 重试加载配置
-        let lastError = null;
-        for(let attempt = 0; attempt <= retryCount; attempt++){
-            try {
-                if (attempt > 0) {
-                    logger.debug(`配置加载重试 ${attempt}/${retryCount}`);
-                    // 指数退避
-                    await new Promise((resolve)=>setTimeout(resolve, retryDelay * Math.pow(2, attempt - 1)));
-                }
-                const configPromise = loadConfig();
-                const timeoutPromise = new Promise((_, reject)=>setTimeout(()=>reject(new NetworkError('配置加载超时')), timeout));
-                const config = await Promise.race([
-                    configPromise,
-                    timeoutPromise
-                ]);
-                // 保存到缓存
-                if (enableCache && storage.localCache) {
-                    try {
-                        const cacheKey = `${CONFIG_CACHE_KEY}_${configVersion || 'default'}`;
-                        await storage.localCache.set(cacheKey, {
-                            data: config,
-                            version: configVersion
-                        }, cacheTTL);
-                    } catch (error) {
-                        logger.warn('保存配置缓存失败:', error);
-                    }
-                }
-                return config;
-            } catch (error) {
-                lastError = error instanceof Error ? error : new Error(String(error));
-                logger.warn(`配置加载失败 (尝试 ${attempt + 1}/${retryCount + 1}):`, lastError);
-            }
-        }
-        // 所有重试都失败，使用降级配置
-        logger.warn('配置加载失败，使用降级配置:', lastError);
-        return fallbackConfig || {};
-    }
     /**
      * 初始化方法
      * 
@@ -20956,89 +20894,8 @@
             // 1. 设置日志级别
             onProgress?.(5, '初始化日志系统...');
             logger.setLevel(options.loggerLevel ?? LogLevel.INFO);
-            // 2. 加载关键配置
-            if (options.configStrategy?.loadCriticalConfig) {
-                onProgress?.(10, '加载关键配置...');
-                try {
-                    config = await loadConfigWithRetry(options.configStrategy.loadCriticalConfig, options.configStrategy, options.configStrategy.fallbackConfig);
-                    // 验证配置安全性
-                    if (options.configSecurity) {
-                        const securityResult = await ConfigSecurity.validateConfigSecurity(config, options.configSecurity);
-                        if (!securityResult.valid) {
-                            logger.warn('配置安全验证失败:', securityResult.errors);
-                        // 根据安全策略决定是否继续
-                        }
-                    }
-                    options.configStrategy.onConfigLoaded?.(config);
-                    onProgress?.(30, '关键配置加载完成');
-                } catch (error) {
-                    logger.warn('关键配置加载失败，使用默认配置:', error);
-                    config = options.configStrategy.fallbackConfig || {};
-                    options.configStrategy.onConfigLoaded?.(config);
-                    onProgress?.(30, '使用默认配置');
-                }
-            } else {
-                onProgress?.(30);
-            }
-            // 2.5. 渐进式加载非关键配置（在应用渲染后异步加载）
-            if (options.configStrategy?.loadNonCriticalConfig) {
-                // 智能延迟加载：根据网络状况动态调整延迟时间
-                const getDelayTime = ()=>{
-                    if (typeof navigator === 'undefined' || !('connection' in navigator)) {
-                        return 1000; // 默认延迟
-                    }
-                    const connection = navigator.connection;
-                    if (!connection) {
-                        return 1000;
-                    }
-                    // 根据网络类型调整延迟
-                    const effectiveType = connection.effectiveType;
-                    switch(effectiveType){
-                        case 'slow-2g':
-                        case '2g':
-                            return 3000; // 慢网络延迟更久
-                        case '3g':
-                            return 2000;
-                        case '4g':
-                        default:
-                            return 500; // 快网络可以更快加载
-                    }
-                };
-                // 使用 requestIdleCallback 在空闲时加载
-                if (typeof requestIdleCallback !== 'undefined') {
-                    requestIdleCallback(async ()=>{
-                        try {
-                            const nonCriticalConfig = await loadConfigWithRetry(options.configStrategy.loadNonCriticalConfig, options.configStrategy, {});
-                            // 合并到主配置
-                            config = {
-                                ...config,
-                                ...nonCriticalConfig
-                            };
-                            options.configStrategy?.onConfigLoaded?.(config);
-                            logger.debug('非关键配置加载完成');
-                        } catch (error) {
-                            logger.warn('非关键配置加载失败:', error);
-                        }
-                    }, {
-                        timeout: getDelayTime()
-                    });
-                } else {
-                    // 降级方案：智能延迟加载
-                    setTimeout(async ()=>{
-                        try {
-                            const nonCriticalConfig = await loadConfigWithRetry(options.configStrategy.loadNonCriticalConfig, options.configStrategy, {});
-                            config = {
-                                ...config,
-                                ...nonCriticalConfig
-                            };
-                            options.configStrategy?.onConfigLoaded?.(config);
-                            logger.debug('非关键配置加载完成');
-                        } catch (error) {
-                            logger.warn('非关键配置加载失败:', error);
-                        }
-                    }, getDelayTime());
-                }
-            }
+            // 2. 预留配置阶段
+            onProgress?.(30);
             // 3. 初始化之前回调
             if (options.lifecycle?.beforeInitialization) {
                 onProgress?.(35, '执行初始化前回调...');
@@ -25683,8 +25540,13 @@
     const isDevelopment = process.env.NODE_ENV === 'development';
     const RouteErrorBoundary = ({ error, resetErrorBoundary })=>{
         const [showDetails, setShowDetails] = React.useState(false);
-        const errorWithCause = error;
-        const hasCause = 'cause' in error && errorWithCause.cause !== undefined;
+        const errorObject = error !== null && typeof error === 'object' ? error : null;
+        const errorMessage = typeof errorObject?.message === 'string' && errorObject.message !== '' ? errorObject.message : '未知错误';
+        const hasCause = errorObject?.cause !== undefined;
+        const isNotFoundError = errorObject?.status === 404 || typeof errorObject?.statusText === 'string' && /not\s*found/i.test(errorObject.statusText) || /no routes matched location|not found|404/i.test(errorMessage);
+        const title = isNotFoundError ? '页面不存在（404）' : '出错了，请稍后再试';
+        const friendlyMessage = isNotFoundError ? '访问的路由未注册或不存在，请检查访问地址。' : '请稍后再试或联系技术支持';
+        const displayMessage = isDevelopment ? errorMessage : friendlyMessage;
         return /*#__PURE__*/ jsxRuntime.jsx("div", {
             role: "alert",
             style: {
@@ -25707,10 +25569,10 @@
                         style: {
                             marginTop: 0
                         },
-                        children: "出错了，请稍后再试"
+                        children: title
                     }),
                     /*#__PURE__*/ jsxRuntime.jsx("p", {
-                        children: isDevelopment ? error.message : '请稍后再试或联系技术支持'
+                        children: displayMessage
                     }),
                     /*#__PURE__*/ jsxRuntime.jsxs("div", {
                         style: {
@@ -25761,10 +25623,10 @@
                                     /*#__PURE__*/ jsxRuntime.jsx("strong", {
                                         children: "错误信息："
                                     }),
-                                    error.message
+                                    errorMessage
                                 ]
                             }),
-                            error.stack && /*#__PURE__*/ jsxRuntime.jsxs("div", {
+                            errorObject?.stack && /*#__PURE__*/ jsxRuntime.jsxs("div", {
                                 style: {
                                     marginBottom: 10,
                                     whiteSpace: 'pre-wrap',
@@ -25775,7 +25637,7 @@
                                         children: "堆栈："
                                     }),
                                     /*#__PURE__*/ jsxRuntime.jsx("br", {}),
-                                    error.stack
+                                    errorObject.stack
                                 ]
                             }),
                             hasCause && /*#__PURE__*/ jsxRuntime.jsxs("div", {
@@ -25783,7 +25645,7 @@
                                     /*#__PURE__*/ jsxRuntime.jsx("strong", {
                                         children: "原因："
                                     }),
-                                    errorWithCause.cause instanceof Error ? errorWithCause.cause.message : String(errorWithCause.cause)
+                                    errorObject?.cause instanceof Error ? errorObject.cause.message : String(errorObject?.cause)
                                 ]
                             })
                         ]
@@ -25803,7 +25665,7 @@
             children: "Loading..."
         });
     }
-    const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent)=>{
+    const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent, enableHydrateFallback = false)=>{
         /**
          * 批量处理路由
          * @param routes 路由组
@@ -25934,28 +25796,31 @@
             }
             const reactRoute = {
                 children: [],
-                hydrateFallbackElement: /*#__PURE__*/ jsxRuntime.jsx(DefaultRouteHydrateFallback, {}),
                 id: name,
                 handle: getHandle(),
                 lazy: async ()=>{
                     const ErrorBoundary = await getErrorComponent();
                     const config = await getConfig();
                     const LoadingComponent = await getLoadingComponent();
+                    const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;
                     // 如果配置为空，确保至少返回一个空对象，避免展开 undefined
                     if (!config) {
                         return {
                             ErrorBoundary: ErrorBoundary?.default,
-                            HydrateFallback: LoadingComponent?.default
+                            HydrateFallback
                         };
                     }
                     return {
                         ErrorBoundary: ErrorBoundary?.default,
-                        HydrateFallback: LoadingComponent?.default,
+                        HydrateFallback,
                         ...config
                     };
                 },
                 path
             };
+            if (enableHydrateFallback) {
+                reactRoute.hydrateFallbackElement = /*#__PURE__*/ jsxRuntime.jsx(DefaultRouteHydrateFallback, {});
+            }
             // 处理子路由
             if (children?.length) {
                 reactRoute.children = children.flatMap((child)=>transformRouteToReactRoute(child)).sort((a, b)=>{
@@ -25970,9 +25835,10 @@
                         lazy: async ()=>{
                             const ErrorBoundary = await getErrorComponent();
                             const LoadingComponent = await getLoadingComponent();
+                            const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;
                             return {
                                 ErrorBoundary: ErrorBoundary?.default,
-                                HydrateFallback: LoadingComponent?.default,
+                                HydrateFallback,
                                 ...await getConfig(true)
                             };
                         }
@@ -26002,9 +25868,10 @@
                         lazy: async ()=>{
                             const ErrorBoundary = await getErrorComponent();
                             const LoadingComponent = await getLoadingComponent();
+                            const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;
                             return {
                                 ErrorBoundary: ErrorBoundary?.default,
-                                HydrateFallback: LoadingComponent?.default,
+                                HydrateFallback,
                                 ...await getConfig(true)
                             };
                         }
@@ -26114,7 +25981,8 @@
             delay: zod.z.number().int().positive().optional(),
             priorityThreshold: zod.z.number().int().nonnegative().optional(),
             timeout: zod.z.number().int().positive().optional()
-        }).optional()
+        }).optional(),
+        enableHydrateFallback: zod.z.boolean().optional()
     }).superRefine((config, ctx)=>{
         if (!Array.isArray(config.routes)) {
             return;
@@ -28014,7 +27882,7 @@
        */ async initialize(config) {
             // 转换路由配置
             const transformResult = await transformRoutes(config.routes);
-            const reactRoutes = await transformRoutesToReactRoutes(transformResult.routes, transformResult, config.defaultRouteErrorComponent, config.defaultRouteLoadingComponent);
+            const reactRoutes = await transformRoutesToReactRoutes(transformResult.routes, transformResult, config.defaultRouteErrorComponent, config.defaultRouteLoadingComponent, Boolean(config.options?.hydrationData));
             // 创建路由实例
             const mode = config.mode || 'browser';
             if (mode === 'browser') {
@@ -28185,14 +28053,15 @@
                 // 缓存转换结果
                 this.cache.set(cacheKey, result);
             }
-            const reactRoutes = await transformRoutesToReactRoutes(result.routes, result, config.defaultRouteErrorComponent, config.defaultRouteLoadingComponent);
+            const enableHydrateFallback = config.enableHydrateFallback ?? Boolean(config.options?.hydrationData);
+            const reactRoutes = await transformRoutesToReactRoutes(result.routes, result, config.defaultRouteErrorComponent, config.defaultRouteLoadingComponent, enableHydrateFallback);
             // 注册路由到预加载器
             if (result.routes) {
                 this.preloader.registerRoutes(result.routes, result);
                 // 开始预加载
                 this.preloader.startPreload();
             }
-            await this.resolveInitialLazyRoutes(reactRoutes);
+            await this.resolveInitialLazyRoutes(reactRoutes, !enableHydrateFallback);
             let routerInstance = null;
             if (config.mode === 'browser') {
                 routerInstance = reactRouterDom.createBrowserRouter(reactRoutes, config.options);
@@ -28225,17 +28094,35 @@
             logger.info('路由管理器初始化完成');
         }
         /**
-         * 预解析当前 URL 命中的 lazy 路由，避免首屏长时间停留在 hydrate fallback。
-         * 非首屏路由仍保持懒加载，保留代码分割收益。
-         */ async resolveInitialLazyRoutes(routes) {
+         * 预解析 lazy 路由，避免首屏或重定向链路长时间停留在 hydrate fallback。
+         * resolveAll=true 时会在初始化阶段解析全部 lazy 路由。
+         */ async resolveInitialLazyRoutes(routes, resolveAll = false) {
             if (typeof window === 'undefined') {
                 return;
             }
-            const matches = reactRouterDom.matchRoutes(routes, window.location.pathname) ?? [];
-            if (matches.length === 0) {
-                return;
+            let targetRoutes = [];
+            if (resolveAll) {
+                const stack = [
+                    ...routes
+                ];
+                while(stack.length > 0){
+                    const current = stack.shift();
+                    if (!current) {
+                        continue;
+                    }
+                    targetRoutes.push(current);
+                    if (current.children && current.children.length > 0) {
+                        stack.push(...current.children);
+                    }
+                }
+            } else {
+                const matches = reactRouterDom.matchRoutes(routes, window.location.pathname) ?? [];
+                if (matches.length === 0) {
+                    return;
+                }
+                targetRoutes = matches.map((match)=>match.route);
             }
-            await Promise.all(matches.map(async ({ route })=>{
+            await Promise.all(targetRoutes.map(async (route)=>{
                 const lazy = route.lazy;
                 if (typeof lazy !== 'function') {
                     return;
@@ -29663,8 +29550,7 @@
             const initContext = await initialization({
                 loggerLevel: options.loggerLevel,
                 locale: i18n.resources,
-                lifecycle: options.lifecycle,
-                configStrategy: undefined
+                lifecycle: options.lifecycle
             });
             await options.lifecycle?.afterInitialization?.(initContext);
         });
@@ -29796,8 +29682,6 @@
             // 3. 使用无 UI Kernel 管理启动阶段（配置、主题、i18n、服务注入、统一错误处理）
             const kernelRuntime = await startKernel({
                 loggerLevel: options.loggerLevel,
-                configLoader: options.configStrategy?.loadCriticalConfig,
-                configFallback: options.configStrategy?.fallbackConfig,
                 locale: {
                     locale: (options.locale ? Object.keys(options.locale)[0] : 'zh-CN') || 'zh-CN',
                     resources: options.locale
@@ -30345,32 +30229,6 @@
         }
     }
 
-    function buildAntdCompatTheme(theme) {
-        const token = {
-            ...theme.tokens || {}
-        };
-        if (theme.primaryColor) {
-            token.colorPrimary = theme.primaryColor;
-        }
-        return {
-            ...theme.compatibility?.antd || {},
-            token
-        };
-    }
-    function buildShadcnCompatTheme(theme) {
-        const cssVariables = {
-            ...theme.compatibility?.shadcn || {},
-            ...theme.tokens || {}
-        };
-        if (theme.primaryColor) {
-            cssVariables['app-primary-color'] = theme.primaryColor;
-        }
-        return {
-            cssVariables,
-            className: theme.mode === 'dark' ? 'dark' : theme.mode === 'light' ? 'light' : 'system'
-        };
-    }
-
     function _define_property$8(obj, key, value) {
         if (key in obj) {
             Object.defineProperty(obj, key, {
@@ -34148,8 +34006,6 @@
     exports.adapterRegistry = adapterRegistry;
     exports.appConfig = appConfig;
     exports.axiosAdapter = axiosAdapter;
-    exports.buildAntdCompatTheme = buildAntdCompatTheme;
-    exports.buildShadcnCompatTheme = buildShadcnCompatTheme;
     exports.cancelRequestContext = cancelRequestContext;
     exports.clearCurrentTraceId = clearCurrentTraceId;
     exports.commonSchemas = commonSchemas;