@vlian/framework 1.2.18 → 1.2.19

package/dist/core/router/utils/adapters/react-router/transform.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../src/core/router/utils/adapters/react-router/transform.tsx"],"sourcesContent":["import type { RouteConfig } from '../../../types';\nimport {\n    type RouteObject,\n    Navigate\n} from 'react-router-dom';\nimport type { TransformRoutesResult } from '../../transform';\nimport { RouteErrorBoundary } from './RouteErrorBoundary';\nimport type { ComponentImport } from '../../../types';\nimport { logger } from '../../../../../utils';\n\nfunction DefaultRouteHydrateFallback() {\n    return (\n        <div style={{ padding: 16, textAlign: 'center', color: '#5f6c7b' }}>\n            Loading...\n        </div>\n    );\n}\n\nexport const transformRoutesToReactRoutes = async (\n    routes: RouteConfig[], \n    transformResult: TransformRoutesResult,\n    defaultRouteErrorComponent?: ComponentImport,\n    defaultRouteLoadingComponent?: ComponentImport,\n): Promise<RouteObject[]> => {\n\n    /**\n     * 批量处理路由\n     * @param routes 路由组\n     */\n    function transformRouteToReactRoutes(routes: RouteConfig[]) {\n        return routes.flatMap((route: RouteConfig) => transformRouteToReactRoute(route))\n    }\n\n    /**\n     * 处理单个路由\n     * @param route 路由\n     */\n    function transformRouteToReactRoute(route: RouteConfig): RouteObject {\n        const {\n            isGroup = false,\n            enableRedirection = false,\n            name,\n            path,\n            handle,\n            children,\n            page,\n            layout,\n            error,\n            errors,\n            loading,\n        } = route;\n        const routeError = error ?? errors;\n\n        // 获取错误组件\n        async function getErrorComponent() {\n            // 如果 error/errors 是函数，直接使用\n            if (typeof routeError === 'function') {\n                return routeError();\n            }\n\n            const errorsMap = transformResult.errors;\n\n            // 判断 error/errors 是否为 string 且不是空字符串\n            if (typeof routeError === 'string' && routeError !== '') {\n                // 使用 routeError 作为 key 获取 transformResult.errors 的值\n                const errorResolver = errorsMap.get(routeError);\n\n                // 如果获取不到，返回 null\n                if (!errorResolver) {\n                    return null;\n                }\n\n                // 如果获取到，返回对应的值（调用动态导入函数）\n                if (typeof errorResolver === 'function') {\n                    return errorResolver();\n                }\n\n                return null;\n            }\n\n            // 如果 errors 为空，使用配置的默认错误组件或内置的 RouteErrorBoundary 组件\n            if (defaultRouteErrorComponent) {\n                // 如果配置了默认错误组件，使用配置的组件\n                return defaultRouteErrorComponent();\n            }\n\n            // 如果没有配置默认错误组件，使用内置的 RouteErrorBoundary 组件\n            // 直接导入而非懒加载，因为：\n            // 1. RouteErrorBoundary 是框架核心组件，体积小\n            // 2. 错误边界需要快速响应，直接导入速度更快\n            // 3. 作为基础设施组件，应该保证可用性\n            return { default: RouteErrorBoundary };\n        }\n\n        // 获取转换配置\n        function convertConfig(m: any) {\n            if (!m) {\n                return null;\n            }\n            const { action, loader, shouldRevalidate, default: Component } = m;\n\n            // 如果 Component 不存在，记录警告\n            if (!Component) {\n                logger.warn(`路由组件未找到 default 导出: ${name}`, m);\n            }\n\n            return {\n                action, // always use action\n                loader, // always use loader\n                shouldRevalidate,\n                Component\n            };\n        }\n\n        // 获取加载组件\n        async function getLoadingComponent() {\n            if (typeof loading === 'function') {\n                return loading();\n            }\n\n            if (typeof loading === 'string' && loading !== '') {\n                const loadingResolver = transformResult.loadings.get(loading);\n                if (typeof loadingResolver === 'function') {\n                    return loadingResolver();\n                }\n            }\n\n            if (defaultRouteLoadingComponent) {\n                return defaultRouteLoadingComponent();\n            }\n\n            return null;\n        }\n\n        // 获取配置\n        async function getConfig(index: boolean = false) {\n            // 如果有layout和不是index,返回布局配置\n            if (layout && !index) {\n                // 如果 layout 是函数，直接使用\n                if (typeof layout === 'function') {\n                    const config = await layout();\n                    return convertConfig(config);\n                }\n\n                // 如果 layout 是字符串，从 Map 中获取\n                if (typeof layout === 'string') {\n                    const layoutResolver = transformResult.layouts.get(layout);\n                    if (!layoutResolver) {\n                        throw new Error(`未找到名为 ${layout} 的布局组件`);\n                    }\n                    const config = await layoutResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            let pageName = name;\n\n            // 如果是notFound则转成404\n            if (pageName === 'notFound') {\n                pageName = '404'\n            }\n\n            if (page && (!children?.length || index)) {\n                // 如果 page 是函数，直接使用\n                if (typeof page === 'function') {\n                    const config = await page();\n                    return convertConfig(config);\n                }\n\n                // 如果 page 是字符串，从 Map 中获取\n                if (typeof page === 'string') {\n                    const viewResolver = transformResult.pages.get(page);\n                    if (!viewResolver) {\n                        throw new Error(`未找到名为 ${page} 的页面组件`);\n                    }\n                    const config = await viewResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            return null;\n        }\n\n        // 获取处理信息，即额外的配置信息\n        function getHandle(index: boolean = false) {\n            if ((layout || isGroup) && !index) {\n                return null\n            }\n            return {\n                ...handle,\n                name,\n                path\n            }\n        }\n\n\n        const reactRoute: RouteObject = {\n            children: [],\n            hydrateFallbackElement: <DefaultRouteHydrateFallback />,\n            id: name,\n            handle: getHandle(),\n            lazy: async () => {\n                const ErrorBoundary = await getErrorComponent();\n                const config = await getConfig();\n                const LoadingComponent = await getLoadingComponent();\n\n                // 如果配置为空，确保至少返回一个空对象，避免展开 undefined\n                if (!config) {\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback: LoadingComponent?.default,\n                    };\n                }\n\n                return {\n                    ErrorBoundary: ErrorBoundary?.default,\n                    HydrateFallback: LoadingComponent?.default,\n                    ...config\n                };\n            },\n            path\n        };\n\n        // 处理子路由\n        if (children?.length) {\n            reactRoute.children = children.flatMap(child => transformRouteToReactRoute(child)).sort((a, b) => {\n                const orderA = a.handle?.order ?? 99;\n                const orderB = b.handle?.order ?? 99;\n                return orderA - orderB;\n            });\n\n            if (page && !isGroup) {\n                reactRoute.children.unshift({\n                    handle: getHandle(true),\n                    index: true,\n                    lazy: async () => {\n                        const ErrorBoundary = await getErrorComponent();\n                        const LoadingComponent = await getLoadingComponent();\n                        return {\n                            ErrorBoundary: ErrorBoundary?.default,\n                            HydrateFallback: LoadingComponent?.default,\n                            ...(await getConfig(true))\n                        };\n                    }\n                });\n            }\n\n            if (enableRedirection && isGroup) {\n                const [firstChild] = reactRoute.children;\n                if (firstChild?.path) {\n                    reactRoute.children.unshift({\n                        index: true,\n                        handle: getHandle(true),\n                        element: <Navigate to={firstChild.path as string} replace />\n                    });\n                }\n            }\n\n        }\n        // 若存在 layout 且没有子路由，但同时声明了 page，则自动生成 index 子路由以渲染页面\n        // 场景：/test 使用自定义 layout，且没有 children 时仍应渲染 page\n        if ((!children || children.length === 0) && layout && page && !isGroup) {\n            reactRoute.children = [{\n                handle: getHandle(true),\n                index: true,\n                lazy: async () => {\n                    const ErrorBoundary = await getErrorComponent();\n                    const LoadingComponent = await getLoadingComponent();\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback: LoadingComponent?.default,\n                        ...(await getConfig(true))\n                    };\n                }\n            }];\n        }\n\n        return reactRoute;\n    }\n\n    return transformRouteToReactRoutes(routes);\n}\n"],"names":["transformRoutesToReactRoutes","DefaultRouteHydrateFallback","div","style","padding","textAlign","color","routes","transformResult","defaultRouteErrorComponent","defaultRouteLoadingComponent","transformRouteToReactRoutes","flatMap","route","transformRouteToReactRoute","isGroup","enableRedirection","name","path","handle","children","page","layout","error","errors","loading","routeError","getErrorComponent","errorsMap","errorResolver","get","default","RouteErrorBoundary","convertConfig","m","action","loader","shouldRevalidate","Component","logger","warn","getLoadingComponent","loadingResolver","loadings","getConfig","index","config","layoutResolver","layouts","Error","pageName","length","viewResolver","pages","getHandle","reactRoute","hydrateFallbackElement","id","lazy","ErrorBoundary","LoadingComponent","HydrateFallback","child","sort","a","b","orderA","order","orderB","unshift","firstChild","element","Navigate","to","replace"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../src/core/router/utils/adapters/react-router/transform.tsx"],"sourcesContent":["import type { RouteConfig } from '../../../types';\nimport {\n    type RouteObject,\n    Navigate\n} from 'react-router-dom';\nimport type { TransformRoutesResult } from '../../transform';\nimport { RouteErrorBoundary } from './RouteErrorBoundary';\nimport type { ComponentImport } from '../../../types';\nimport { logger } from '../../../../../utils';\n\nfunction DefaultRouteHydrateFallback() {\n    return (\n        <div style={{ padding: 16, textAlign: 'center', color: '#5f6c7b' }}>\n            Loading...\n        </div>\n    );\n}\n\nexport const transformRoutesToReactRoutes = async (\n    routes: RouteConfig[], \n    transformResult: TransformRoutesResult,\n    defaultRouteErrorComponent?: ComponentImport,\n    defaultRouteLoadingComponent?: ComponentImport,\n    enableHydrateFallback: boolean = false,\n): Promise<RouteObject[]> => {\n\n    /**\n     * 批量处理路由\n     * @param routes 路由组\n     */\n    function transformRouteToReactRoutes(routes: RouteConfig[]) {\n        return routes.flatMap((route: RouteConfig) => transformRouteToReactRoute(route))\n    }\n\n    /**\n     * 处理单个路由\n     * @param route 路由\n     */\n    function transformRouteToReactRoute(route: RouteConfig): RouteObject {\n        const {\n            isGroup = false,\n            enableRedirection = false,\n            name,\n            path,\n            handle,\n            children,\n            page,\n            layout,\n            error,\n            errors,\n            loading,\n        } = route;\n        const routeError = error ?? errors;\n\n        // 获取错误组件\n        async function getErrorComponent() {\n            // 如果 error/errors 是函数，直接使用\n            if (typeof routeError === 'function') {\n                return routeError();\n            }\n\n            const errorsMap = transformResult.errors;\n\n            // 判断 error/errors 是否为 string 且不是空字符串\n            if (typeof routeError === 'string' && routeError !== '') {\n                // 使用 routeError 作为 key 获取 transformResult.errors 的值\n                const errorResolver = errorsMap.get(routeError);\n\n                // 如果获取不到，返回 null\n                if (!errorResolver) {\n                    return null;\n                }\n\n                // 如果获取到，返回对应的值（调用动态导入函数）\n                if (typeof errorResolver === 'function') {\n                    return errorResolver();\n                }\n\n                return null;\n            }\n\n            // 如果 errors 为空，使用配置的默认错误组件或内置的 RouteErrorBoundary 组件\n            if (defaultRouteErrorComponent) {\n                // 如果配置了默认错误组件，使用配置的组件\n                return defaultRouteErrorComponent();\n            }\n\n            // 如果没有配置默认错误组件，使用内置的 RouteErrorBoundary 组件\n            // 直接导入而非懒加载，因为：\n            // 1. RouteErrorBoundary 是框架核心组件，体积小\n            // 2. 错误边界需要快速响应，直接导入速度更快\n            // 3. 作为基础设施组件，应该保证可用性\n            return { default: RouteErrorBoundary };\n        }\n\n        // 获取转换配置\n        function convertConfig(m: any) {\n            if (!m) {\n                return null;\n            }\n            const { action, loader, shouldRevalidate, default: Component } = m;\n\n            // 如果 Component 不存在，记录警告\n            if (!Component) {\n                logger.warn(`路由组件未找到 default 导出: ${name}`, m);\n            }\n\n            return {\n                action, // always use action\n                loader, // always use loader\n                shouldRevalidate,\n                Component\n            };\n        }\n\n        // 获取加载组件\n        async function getLoadingComponent() {\n            if (typeof loading === 'function') {\n                return loading();\n            }\n\n            if (typeof loading === 'string' && loading !== '') {\n                const loadingResolver = transformResult.loadings.get(loading);\n                if (typeof loadingResolver === 'function') {\n                    return loadingResolver();\n                }\n            }\n\n            if (defaultRouteLoadingComponent) {\n                return defaultRouteLoadingComponent();\n            }\n\n            return null;\n        }\n\n        // 获取配置\n        async function getConfig(index: boolean = false) {\n            // 如果有layout和不是index,返回布局配置\n            if (layout && !index) {\n                // 如果 layout 是函数，直接使用\n                if (typeof layout === 'function') {\n                    const config = await layout();\n                    return convertConfig(config);\n                }\n\n                // 如果 layout 是字符串，从 Map 中获取\n                if (typeof layout === 'string') {\n                    const layoutResolver = transformResult.layouts.get(layout);\n                    if (!layoutResolver) {\n                        throw new Error(`未找到名为 ${layout} 的布局组件`);\n                    }\n                    const config = await layoutResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            let pageName = name;\n\n            // 如果是notFound则转成404\n            if (pageName === 'notFound') {\n                pageName = '404'\n            }\n\n            if (page && (!children?.length || index)) {\n                // 如果 page 是函数，直接使用\n                if (typeof page === 'function') {\n                    const config = await page();\n                    return convertConfig(config);\n                }\n\n                // 如果 page 是字符串，从 Map 中获取\n                if (typeof page === 'string') {\n                    const viewResolver = transformResult.pages.get(page);\n                    if (!viewResolver) {\n                        throw new Error(`未找到名为 ${page} 的页面组件`);\n                    }\n                    const config = await viewResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            return null;\n        }\n\n        // 获取处理信息，即额外的配置信息\n        function getHandle(index: boolean = false) {\n            if ((layout || isGroup) && !index) {\n                return null\n            }\n            return {\n                ...handle,\n                name,\n                path\n            }\n        }\n\n\n        const reactRoute: RouteObject = {\n            children: [],\n            id: name,\n            handle: getHandle(),\n            lazy: async () => {\n                const ErrorBoundary = await getErrorComponent();\n                const config = await getConfig();\n                const LoadingComponent = await getLoadingComponent();\n                const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;\n\n                // 如果配置为空，确保至少返回一个空对象，避免展开 undefined\n                if (!config) {\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback,\n                    };\n                }\n\n                return {\n                    ErrorBoundary: ErrorBoundary?.default,\n                    HydrateFallback,\n                    ...config\n                };\n            },\n            path\n        };\n\n        if (enableHydrateFallback) {\n            reactRoute.hydrateFallbackElement = <DefaultRouteHydrateFallback />;\n        }\n\n        // 处理子路由\n        if (children?.length) {\n            reactRoute.children = children.flatMap(child => transformRouteToReactRoute(child)).sort((a, b) => {\n                const orderA = a.handle?.order ?? 99;\n                const orderB = b.handle?.order ?? 99;\n                return orderA - orderB;\n            });\n\n            if (page && !isGroup) {\n                reactRoute.children.unshift({\n                    handle: getHandle(true),\n                    index: true,\n                    lazy: async () => {\n                        const ErrorBoundary = await getErrorComponent();\n                        const LoadingComponent = await getLoadingComponent();\n                        const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;\n                        return {\n                            ErrorBoundary: ErrorBoundary?.default,\n                            HydrateFallback,\n                            ...(await getConfig(true))\n                        };\n                    }\n                });\n            }\n\n            if (enableRedirection && isGroup) {\n                const [firstChild] = reactRoute.children;\n                if (firstChild?.path) {\n                    reactRoute.children.unshift({\n                        index: true,\n                        handle: getHandle(true),\n                        element: <Navigate to={firstChild.path as string} replace />\n                    });\n                }\n            }\n\n        }\n        // 若存在 layout 且没有子路由，但同时声明了 page，则自动生成 index 子路由以渲染页面\n        // 场景：/test 使用自定义 layout，且没有 children 时仍应渲染 page\n        if ((!children || children.length === 0) && layout && page && !isGroup) {\n            reactRoute.children = [{\n                handle: getHandle(true),\n                index: true,\n                lazy: async () => {\n                    const ErrorBoundary = await getErrorComponent();\n                    const LoadingComponent = await getLoadingComponent();\n                    const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback,\n                        ...(await getConfig(true))\n                    };\n                }\n            }];\n        }\n\n        return reactRoute;\n    }\n\n    return transformRouteToReactRoutes(routes);\n}\n"],"names":["transformRoutesToReactRoutes","DefaultRouteHydrateFallback","div","style","padding","textAlign","color","routes","transformResult","defaultRouteErrorComponent","defaultRouteLoadingComponent","enableHydrateFallback","transformRouteToReactRoutes","flatMap","route","transformRouteToReactRoute","isGroup","enableRedirection","name","path","handle","children","page","layout","error","errors","loading","routeError","getErrorComponent","errorsMap","errorResolver","get","default","RouteErrorBoundary","convertConfig","m","action","loader","shouldRevalidate","Component","logger","warn","getLoadingComponent","loadingResolver","loadings","getConfig","index","config","layoutResolver","layouts","Error","pageName","length","viewResolver","pages","getHandle","reactRoute","id","lazy","ErrorBoundary","LoadingComponent","HydrateFallback","hydrateFallbackElement","child","sort","a","b","orderA","order","orderB","unshift","firstChild","element","Navigate","to","replace"],"mappings":"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"}

package/dist/core/router/utils/adapters/react-router/transform.d.ts

@@ -2,4 +2,4 @@ import type { RouteConfig } from '../../../types';
 import { type RouteObject } from 'react-router-dom';
 import type { TransformRoutesResult } from '../../transform';
 import type { ComponentImport } from '../../../types';
-export declare const transformRoutesToReactRoutes: (routes: RouteConfig[], transformResult: TransformRoutesResult, defaultRouteErrorComponent?: ComponentImport, defaultRouteLoadingComponent?: ComponentImport) => Promise<RouteObject[]>;
+export declare const transformRoutesToReactRoutes: (routes: RouteConfig[], transformResult: TransformRoutesResult, defaultRouteErrorComponent?: ComponentImport, defaultRouteLoadingComponent?: ComponentImport, enableHydrateFallback?: boolean) => Promise<RouteObject[]>;

package/dist/core/router/utils/adapters/react-router/transform.js

@@ -12,7 +12,7 @@ function DefaultRouteHydrateFallback() {
         children: "Loading..."
     });
 }
-export const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent)=>{
+export const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent, enableHydrateFallback = false)=>{
     /**
      * 批量处理路由
      * @param routes 路由组
@@ -148,28 +148,31 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
         }
         const reactRoute = {
             children: [],
-            hydrateFallbackElement: /*#__PURE__*/ _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__*/ _jsx(DefaultRouteHydrateFallback, {});
+        }
         // 处理子路由
         if (children?.length) {
             reactRoute.children = children.flatMap((child)=>transformRouteToReactRoute(child)).sort((a, b)=>{
@@ -184,9 +187,10 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
                     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)
                         };
                     }
@@ -216,9 +220,10 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
                     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)
                         };
                     }

package/dist/core/router/utils/adapters/react-router/transform.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../src/core/router/utils/adapters/react-router/transform.tsx"],"sourcesContent":["import type { RouteConfig } from '../../../types';\nimport {\n    type RouteObject,\n    Navigate\n} from 'react-router-dom';\nimport type { TransformRoutesResult } from '../../transform';\nimport { RouteErrorBoundary } from './RouteErrorBoundary';\nimport type { ComponentImport } from '../../../types';\nimport { logger } from '../../../../../utils';\n\nfunction DefaultRouteHydrateFallback() {\n    return (\n        <div style={{ padding: 16, textAlign: 'center', color: '#5f6c7b' }}>\n            Loading...\n        </div>\n    );\n}\n\nexport const transformRoutesToReactRoutes = async (\n    routes: RouteConfig[], \n    transformResult: TransformRoutesResult,\n    defaultRouteErrorComponent?: ComponentImport,\n    defaultRouteLoadingComponent?: ComponentImport,\n): Promise<RouteObject[]> => {\n\n    /**\n     * 批量处理路由\n     * @param routes 路由组\n     */\n    function transformRouteToReactRoutes(routes: RouteConfig[]) {\n        return routes.flatMap((route: RouteConfig) => transformRouteToReactRoute(route))\n    }\n\n    /**\n     * 处理单个路由\n     * @param route 路由\n     */\n    function transformRouteToReactRoute(route: RouteConfig): RouteObject {\n        const {\n            isGroup = false,\n            enableRedirection = false,\n            name,\n            path,\n            handle,\n            children,\n            page,\n            layout,\n            error,\n            errors,\n            loading,\n        } = route;\n        const routeError = error ?? errors;\n\n        // 获取错误组件\n        async function getErrorComponent() {\n            // 如果 error/errors 是函数，直接使用\n            if (typeof routeError === 'function') {\n                return routeError();\n            }\n\n            const errorsMap = transformResult.errors;\n\n            // 判断 error/errors 是否为 string 且不是空字符串\n            if (typeof routeError === 'string' && routeError !== '') {\n                // 使用 routeError 作为 key 获取 transformResult.errors 的值\n                const errorResolver = errorsMap.get(routeError);\n\n                // 如果获取不到，返回 null\n                if (!errorResolver) {\n                    return null;\n                }\n\n                // 如果获取到，返回对应的值（调用动态导入函数）\n                if (typeof errorResolver === 'function') {\n                    return errorResolver();\n                }\n\n                return null;\n            }\n\n            // 如果 errors 为空，使用配置的默认错误组件或内置的 RouteErrorBoundary 组件\n            if (defaultRouteErrorComponent) {\n                // 如果配置了默认错误组件，使用配置的组件\n                return defaultRouteErrorComponent();\n            }\n\n            // 如果没有配置默认错误组件，使用内置的 RouteErrorBoundary 组件\n            // 直接导入而非懒加载，因为：\n            // 1. RouteErrorBoundary 是框架核心组件，体积小\n            // 2. 错误边界需要快速响应，直接导入速度更快\n            // 3. 作为基础设施组件，应该保证可用性\n            return { default: RouteErrorBoundary };\n        }\n\n        // 获取转换配置\n        function convertConfig(m: any) {\n            if (!m) {\n                return null;\n            }\n            const { action, loader, shouldRevalidate, default: Component } = m;\n\n            // 如果 Component 不存在，记录警告\n            if (!Component) {\n                logger.warn(`路由组件未找到 default 导出: ${name}`, m);\n            }\n\n            return {\n                action, // always use action\n                loader, // always use loader\n                shouldRevalidate,\n                Component\n            };\n        }\n\n        // 获取加载组件\n        async function getLoadingComponent() {\n            if (typeof loading === 'function') {\n                return loading();\n            }\n\n            if (typeof loading === 'string' && loading !== '') {\n                const loadingResolver = transformResult.loadings.get(loading);\n                if (typeof loadingResolver === 'function') {\n                    return loadingResolver();\n                }\n            }\n\n            if (defaultRouteLoadingComponent) {\n                return defaultRouteLoadingComponent();\n            }\n\n            return null;\n        }\n\n        // 获取配置\n        async function getConfig(index: boolean = false) {\n            // 如果有layout和不是index,返回布局配置\n            if (layout && !index) {\n                // 如果 layout 是函数，直接使用\n                if (typeof layout === 'function') {\n                    const config = await layout();\n                    return convertConfig(config);\n                }\n\n                // 如果 layout 是字符串，从 Map 中获取\n                if (typeof layout === 'string') {\n                    const layoutResolver = transformResult.layouts.get(layout);\n                    if (!layoutResolver) {\n                        throw new Error(`未找到名为 ${layout} 的布局组件`);\n                    }\n                    const config = await layoutResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            let pageName = name;\n\n            // 如果是notFound则转成404\n            if (pageName === 'notFound') {\n                pageName = '404'\n            }\n\n            if (page && (!children?.length || index)) {\n                // 如果 page 是函数，直接使用\n                if (typeof page === 'function') {\n                    const config = await page();\n                    return convertConfig(config);\n                }\n\n                // 如果 page 是字符串，从 Map 中获取\n                if (typeof page === 'string') {\n                    const viewResolver = transformResult.pages.get(page);\n                    if (!viewResolver) {\n                        throw new Error(`未找到名为 ${page} 的页面组件`);\n                    }\n                    const config = await viewResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            return null;\n        }\n\n        // 获取处理信息，即额外的配置信息\n        function getHandle(index: boolean = false) {\n            if ((layout || isGroup) && !index) {\n                return null\n            }\n            return {\n                ...handle,\n                name,\n                path\n            }\n        }\n\n\n        const reactRoute: RouteObject = {\n            children: [],\n            hydrateFallbackElement: <DefaultRouteHydrateFallback />,\n            id: name,\n            handle: getHandle(),\n            lazy: async () => {\n                const ErrorBoundary = await getErrorComponent();\n                const config = await getConfig();\n                const LoadingComponent = await getLoadingComponent();\n\n                // 如果配置为空，确保至少返回一个空对象，避免展开 undefined\n                if (!config) {\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback: LoadingComponent?.default,\n                    };\n                }\n\n                return {\n                    ErrorBoundary: ErrorBoundary?.default,\n                    HydrateFallback: LoadingComponent?.default,\n                    ...config\n                };\n            },\n            path\n        };\n\n        // 处理子路由\n        if (children?.length) {\n            reactRoute.children = children.flatMap(child => transformRouteToReactRoute(child)).sort((a, b) => {\n                const orderA = a.handle?.order ?? 99;\n                const orderB = b.handle?.order ?? 99;\n                return orderA - orderB;\n            });\n\n            if (page && !isGroup) {\n                reactRoute.children.unshift({\n                    handle: getHandle(true),\n                    index: true,\n                    lazy: async () => {\n                        const ErrorBoundary = await getErrorComponent();\n                        const LoadingComponent = await getLoadingComponent();\n                        return {\n                            ErrorBoundary: ErrorBoundary?.default,\n                            HydrateFallback: LoadingComponent?.default,\n                            ...(await getConfig(true))\n                        };\n                    }\n                });\n            }\n\n            if (enableRedirection && isGroup) {\n                const [firstChild] = reactRoute.children;\n                if (firstChild?.path) {\n                    reactRoute.children.unshift({\n                        index: true,\n                        handle: getHandle(true),\n                        element: <Navigate to={firstChild.path as string} replace />\n                    });\n                }\n            }\n\n        }\n        // 若存在 layout 且没有子路由，但同时声明了 page，则自动生成 index 子路由以渲染页面\n        // 场景：/test 使用自定义 layout，且没有 children 时仍应渲染 page\n        if ((!children || children.length === 0) && layout && page && !isGroup) {\n            reactRoute.children = [{\n                handle: getHandle(true),\n                index: true,\n                lazy: async () => {\n                    const ErrorBoundary = await getErrorComponent();\n                    const LoadingComponent = await getLoadingComponent();\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback: LoadingComponent?.default,\n                        ...(await getConfig(true))\n                    };\n                }\n            }];\n        }\n\n        return reactRoute;\n    }\n\n    return transformRouteToReactRoutes(routes);\n}\n"],"names":["Navigate","RouteErrorBoundary","logger","DefaultRouteHydrateFallback","div","style","padding","textAlign","color","transformRoutesToReactRoutes","routes","transformResult","defaultRouteErrorComponent","defaultRouteLoadingComponent","transformRouteToReactRoutes","flatMap","route","transformRouteToReactRoute","isGroup","enableRedirection","name","path","handle","children","page","layout","error","errors","loading","routeError","getErrorComponent","errorsMap","errorResolver","get","default","convertConfig","m","action","loader","shouldRevalidate","Component","warn","getLoadingComponent","loadingResolver","loadings","getConfig","index","config","layoutResolver","layouts","Error","pageName","length","viewResolver","pages","getHandle","reactRoute","hydrateFallbackElement","id","lazy","ErrorBoundary","LoadingComponent","HydrateFallback","child","sort","a","b","orderA","order","orderB","unshift","firstChild","element","to","replace"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../src/core/router/utils/adapters/react-router/transform.tsx"],"sourcesContent":["import type { RouteConfig } from '../../../types';\nimport {\n    type RouteObject,\n    Navigate\n} from 'react-router-dom';\nimport type { TransformRoutesResult } from '../../transform';\nimport { RouteErrorBoundary } from './RouteErrorBoundary';\nimport type { ComponentImport } from '../../../types';\nimport { logger } from '../../../../../utils';\n\nfunction DefaultRouteHydrateFallback() {\n    return (\n        <div style={{ padding: 16, textAlign: 'center', color: '#5f6c7b' }}>\n            Loading...\n        </div>\n    );\n}\n\nexport const transformRoutesToReactRoutes = async (\n    routes: RouteConfig[], \n    transformResult: TransformRoutesResult,\n    defaultRouteErrorComponent?: ComponentImport,\n    defaultRouteLoadingComponent?: ComponentImport,\n    enableHydrateFallback: boolean = false,\n): Promise<RouteObject[]> => {\n\n    /**\n     * 批量处理路由\n     * @param routes 路由组\n     */\n    function transformRouteToReactRoutes(routes: RouteConfig[]) {\n        return routes.flatMap((route: RouteConfig) => transformRouteToReactRoute(route))\n    }\n\n    /**\n     * 处理单个路由\n     * @param route 路由\n     */\n    function transformRouteToReactRoute(route: RouteConfig): RouteObject {\n        const {\n            isGroup = false,\n            enableRedirection = false,\n            name,\n            path,\n            handle,\n            children,\n            page,\n            layout,\n            error,\n            errors,\n            loading,\n        } = route;\n        const routeError = error ?? errors;\n\n        // 获取错误组件\n        async function getErrorComponent() {\n            // 如果 error/errors 是函数，直接使用\n            if (typeof routeError === 'function') {\n                return routeError();\n            }\n\n            const errorsMap = transformResult.errors;\n\n            // 判断 error/errors 是否为 string 且不是空字符串\n            if (typeof routeError === 'string' && routeError !== '') {\n                // 使用 routeError 作为 key 获取 transformResult.errors 的值\n                const errorResolver = errorsMap.get(routeError);\n\n                // 如果获取不到，返回 null\n                if (!errorResolver) {\n                    return null;\n                }\n\n                // 如果获取到，返回对应的值（调用动态导入函数）\n                if (typeof errorResolver === 'function') {\n                    return errorResolver();\n                }\n\n                return null;\n            }\n\n            // 如果 errors 为空，使用配置的默认错误组件或内置的 RouteErrorBoundary 组件\n            if (defaultRouteErrorComponent) {\n                // 如果配置了默认错误组件，使用配置的组件\n                return defaultRouteErrorComponent();\n            }\n\n            // 如果没有配置默认错误组件，使用内置的 RouteErrorBoundary 组件\n            // 直接导入而非懒加载，因为：\n            // 1. RouteErrorBoundary 是框架核心组件，体积小\n            // 2. 错误边界需要快速响应，直接导入速度更快\n            // 3. 作为基础设施组件，应该保证可用性\n            return { default: RouteErrorBoundary };\n        }\n\n        // 获取转换配置\n        function convertConfig(m: any) {\n            if (!m) {\n                return null;\n            }\n            const { action, loader, shouldRevalidate, default: Component } = m;\n\n            // 如果 Component 不存在，记录警告\n            if (!Component) {\n                logger.warn(`路由组件未找到 default 导出: ${name}`, m);\n            }\n\n            return {\n                action, // always use action\n                loader, // always use loader\n                shouldRevalidate,\n                Component\n            };\n        }\n\n        // 获取加载组件\n        async function getLoadingComponent() {\n            if (typeof loading === 'function') {\n                return loading();\n            }\n\n            if (typeof loading === 'string' && loading !== '') {\n                const loadingResolver = transformResult.loadings.get(loading);\n                if (typeof loadingResolver === 'function') {\n                    return loadingResolver();\n                }\n            }\n\n            if (defaultRouteLoadingComponent) {\n                return defaultRouteLoadingComponent();\n            }\n\n            return null;\n        }\n\n        // 获取配置\n        async function getConfig(index: boolean = false) {\n            // 如果有layout和不是index,返回布局配置\n            if (layout && !index) {\n                // 如果 layout 是函数，直接使用\n                if (typeof layout === 'function') {\n                    const config = await layout();\n                    return convertConfig(config);\n                }\n\n                // 如果 layout 是字符串，从 Map 中获取\n                if (typeof layout === 'string') {\n                    const layoutResolver = transformResult.layouts.get(layout);\n                    if (!layoutResolver) {\n                        throw new Error(`未找到名为 ${layout} 的布局组件`);\n                    }\n                    const config = await layoutResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            let pageName = name;\n\n            // 如果是notFound则转成404\n            if (pageName === 'notFound') {\n                pageName = '404'\n            }\n\n            if (page && (!children?.length || index)) {\n                // 如果 page 是函数，直接使用\n                if (typeof page === 'function') {\n                    const config = await page();\n                    return convertConfig(config);\n                }\n\n                // 如果 page 是字符串，从 Map 中获取\n                if (typeof page === 'string') {\n                    const viewResolver = transformResult.pages.get(page);\n                    if (!viewResolver) {\n                        throw new Error(`未找到名为 ${page} 的页面组件`);\n                    }\n                    const config = await viewResolver();\n                    return convertConfig(config);\n                }\n            }\n\n            return null;\n        }\n\n        // 获取处理信息，即额外的配置信息\n        function getHandle(index: boolean = false) {\n            if ((layout || isGroup) && !index) {\n                return null\n            }\n            return {\n                ...handle,\n                name,\n                path\n            }\n        }\n\n\n        const reactRoute: RouteObject = {\n            children: [],\n            id: name,\n            handle: getHandle(),\n            lazy: async () => {\n                const ErrorBoundary = await getErrorComponent();\n                const config = await getConfig();\n                const LoadingComponent = await getLoadingComponent();\n                const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;\n\n                // 如果配置为空，确保至少返回一个空对象，避免展开 undefined\n                if (!config) {\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback,\n                    };\n                }\n\n                return {\n                    ErrorBoundary: ErrorBoundary?.default,\n                    HydrateFallback,\n                    ...config\n                };\n            },\n            path\n        };\n\n        if (enableHydrateFallback) {\n            reactRoute.hydrateFallbackElement = <DefaultRouteHydrateFallback />;\n        }\n\n        // 处理子路由\n        if (children?.length) {\n            reactRoute.children = children.flatMap(child => transformRouteToReactRoute(child)).sort((a, b) => {\n                const orderA = a.handle?.order ?? 99;\n                const orderB = b.handle?.order ?? 99;\n                return orderA - orderB;\n            });\n\n            if (page && !isGroup) {\n                reactRoute.children.unshift({\n                    handle: getHandle(true),\n                    index: true,\n                    lazy: async () => {\n                        const ErrorBoundary = await getErrorComponent();\n                        const LoadingComponent = await getLoadingComponent();\n                        const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;\n                        return {\n                            ErrorBoundary: ErrorBoundary?.default,\n                            HydrateFallback,\n                            ...(await getConfig(true))\n                        };\n                    }\n                });\n            }\n\n            if (enableRedirection && isGroup) {\n                const [firstChild] = reactRoute.children;\n                if (firstChild?.path) {\n                    reactRoute.children.unshift({\n                        index: true,\n                        handle: getHandle(true),\n                        element: <Navigate to={firstChild.path as string} replace />\n                    });\n                }\n            }\n\n        }\n        // 若存在 layout 且没有子路由，但同时声明了 page，则自动生成 index 子路由以渲染页面\n        // 场景：/test 使用自定义 layout，且没有 children 时仍应渲染 page\n        if ((!children || children.length === 0) && layout && page && !isGroup) {\n            reactRoute.children = [{\n                handle: getHandle(true),\n                index: true,\n                lazy: async () => {\n                    const ErrorBoundary = await getErrorComponent();\n                    const LoadingComponent = await getLoadingComponent();\n                    const HydrateFallback = LoadingComponent?.default ?? DefaultRouteHydrateFallback;\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        HydrateFallback,\n                        ...(await getConfig(true))\n                    };\n                }\n            }];\n        }\n\n        return reactRoute;\n    }\n\n    return transformRouteToReactRoutes(routes);\n}\n"],"names":["Navigate","RouteErrorBoundary","logger","DefaultRouteHydrateFallback","div","style","padding","textAlign","color","transformRoutesToReactRoutes","routes","transformResult","defaultRouteErrorComponent","defaultRouteLoadingComponent","enableHydrateFallback","transformRouteToReactRoutes","flatMap","route","transformRouteToReactRoute","isGroup","enableRedirection","name","path","handle","children","page","layout","error","errors","loading","routeError","getErrorComponent","errorsMap","errorResolver","get","default","convertConfig","m","action","loader","shouldRevalidate","Component","warn","getLoadingComponent","loadingResolver","loadings","getConfig","index","config","layoutResolver","layouts","Error","pageName","length","viewResolver","pages","getHandle","reactRoute","id","lazy","ErrorBoundary","LoadingComponent","HydrateFallback","hydrateFallbackElement","child","sort","a","b","orderA","order","orderB","unshift","firstChild","element","to","replace"],"mappings":"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"}

package/dist/core/router/validation/RouterConfigValidator.d.ts

@@ -55,6 +55,7 @@ export declare class RouterConfigValidator {
             priorityThreshold?: number | undefined;
             timeout?: number | undefined;
         } | undefined;
+        enableHydrateFallback?: boolean | undefined;
     };
     /**
      * 安全验证路由配置（不抛出异常）
@@ -103,6 +104,7 @@ export declare class RouterConfigValidator {
             priorityThreshold?: number | undefined;
             timeout?: number | undefined;
         } | undefined;
+        enableHydrateFallback?: boolean | undefined;
     }>;
     /**
      * 验证路由配置并提供修复建议

package/dist/core/router/validation/schema.cjs

@@ -120,7 +120,8 @@ const routerConfigSchema = _zod.z.object({
         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;

package/dist/core/router/validation/schema.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/router/validation/schema.ts"],"sourcesContent":["/**\n * 路由配置验证 Schema（使用 Zod）\n */\n\nimport { z } from 'zod';\n\n/**\n * RouteItemHandle Schema\n */\nexport const routeItemHandleSchema = z.object({\n  title: z.string().min(1, '路由标题不能为空'),\n  i18nKey: z.string().optional(),\n  order: z.number().int('排序值必须是整数'),\n  icon: z.string().optional(),\n  hideInMenu: z.boolean().optional(),\n  hideFooter: z.boolean().optional(),\n  keepAlive: z.boolean().optional(),\n  needLogin: z.boolean().optional(),\n  roles: z.array(z.string()).optional(),\n  name: z.string().optional(),\n}).passthrough(); // 允许其他自定义字段\n\n/**\n * ComponentImport Schema\n * 可以是字符串路径或函数\n */\nexport const componentImportSchema = z.union([\n  z.string().min(1, '组件路径不能为空'),\n  z.function(),\n  z.null(),\n]);\n\nconst routerOptionsSchema = z\n  .object({\n    basename: z.string().optional(),\n    future: z.record(z.string(), z.union([z.boolean(), z.string(), z.number()])).optional(),\n    hydrationData: z.unknown().optional(),\n    window: z.unknown().optional(),\n    initialEntries: z.array(z.string()).optional(),\n    initialIndex: z.number().int().nonnegative().optional(),\n  })\n  .passthrough();\n\nconst transformOptionsSchema = z\n  .object({\n    pathValidation: z\n      .object({\n        enablePathValidation: z.boolean().optional(),\n        allowedPathPrefixes: z.array(z.string().min(1)).optional(),\n        maxPathLength: z.number().int().positive().optional(),\n        allowAbsolutePaths: z.boolean().optional(),\n      })\n      .optional(),\n    performance: z\n      .object({\n        enableCache: z.boolean().optional(),\n        cacheTTL: z.number().int().positive().optional(),\n        maxCacheSize: z.number().int().positive().optional(),\n        maxRecursionDepth: z.number().int().positive().optional(),\n        enableParallelProcessing: z.boolean().optional(),\n        parallelBatchSize: z.number().int().positive().optional(),\n      })\n      .optional(),\n    enableDebugLog: z.boolean().optional(),\n  })\n  .passthrough();\n\n/**\n * RouteConfig Schema\n */\nexport const routeConfigSchema: z.ZodType<any> = z.lazy(() =>\n  z.object({\n    layout: componentImportSchema.optional().nullable(),\n    page: componentImportSchema.optional().nullable(),\n    loading: componentImportSchema.optional().nullable(),\n    error: componentImportSchema.optional().nullable(),\n    errors: componentImportSchema.optional().nullable(),\n    name: z.string().min(1, '路由名称不能为空'),\n    path: z.string().optional(),\n    isGroup: z.boolean().optional(),\n    enableRedirection: z.boolean().optional(),\n    handle: routeItemHandleSchema,\n    children: z.array(routeConfigSchema).optional(),\n  })\n);\n\n/**\n * RouterConfig Schema\n */\nexport const routerConfigSchema = z.object({\n  enabled: z.union([z.boolean(), z.literal('disabled')]).optional(),\n  routes: z\n    .union([\n      z.array(routeConfigSchema),\n      z.function(),\n    ])\n    .optional(),\n  mode: z.enum(['browser', 'hash', 'memory']).optional(),\n  options: routerOptionsSchema.optional(),\n  pathResolve: z\n    .object({\n      basePath: z.string().optional(),\n      pathAliases: z.record(z.string(), z.string()).optional(),\n    })\n    .optional(),\n  transformOptions: transformOptionsSchema.optional(),\n  preload: z\n    .object({\n      strategy: z.enum(['none', 'next-level', 'all', 'visible']).optional(),\n      delay: z.number().int().positive().optional(),\n      priorityThreshold: z.number().int().nonnegative().optional(),\n      timeout: z.number().int().positive().optional(),\n    })\n    .optional(),\n}).superRefine((config, ctx) => {\n  if (!Array.isArray(config.routes)) {\n    return;\n  }\n\n  const routeNameMap = new Map<string, string>();\n\n  const walk = (routes: Array<z.infer<typeof routeConfigSchema>>, parentPath: string): void => {\n    routes.forEach((route, index) => {\n      const currentPath = `${parentPath}[${index}]`;\n      const existingPath = routeNameMap.get(route.name);\n      if (existingPath) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['routes', index, 'name'],\n          message: `路由名称重复: \"${route.name}\"，首次定义位置 ${existingPath}`,\n        });\n      } else {\n        routeNameMap.set(route.name, currentPath);\n      }\n\n      if (Array.isArray(route.children) && route.children.length > 0) {\n        walk(route.children as Array<z.infer<typeof routeConfigSchema>>, `${currentPath}.children`);\n      }\n    });\n  };\n\n  walk(config.routes, 'routes');\n});\n\n/**\n * 验证路由配置\n * \n * @param config - 要验证的路由配置\n * @returns 验证后的路由配置\n * @throws z.ZodError 如果配置验证失败\n */\nexport function validateRouterConfig(config: unknown) {\n  return routerConfigSchema.parse(config);\n}\n\n/**\n * 安全验证路由配置（不抛出异常）\n * \n * @param config - 要验证的路由配置\n * @returns 验证结果\n */\nexport function safeValidateRouterConfig(config: unknown) {\n  return routerConfigSchema.safeParse(config);\n}\n"],"names":["componentImportSchema","routeConfigSchema","routeItemHandleSchema","routerConfigSchema","safeValidateRouterConfig","validateRouterConfig","z","object","title","string","min","i18nKey","optional","order","number","int","icon","hideInMenu","boolean","hideFooter","keepAlive","needLogin","roles","array","name","passthrough","union","function","null","routerOptionsSchema","basename","future","record","hydrationData","unknown","window","initialEntries","initialIndex","nonnegative","transformOptionsSchema","pathValidation","enablePathValidation","allowedPathPrefixes","maxPathLength","positive","allowAbsolutePaths","performance","enableCache","cacheTTL","maxCacheSize","maxRecursionDepth","enableParallelProcessing","parallelBatchSize","enableDebugLog","lazy","layout","nullable","page","loading","error","errors","path","isGroup","enableRedirection","handle","children","enabled","literal","routes","mode","enum","options","pathResolve","basePath","pathAliases","transformOptions","preload","strategy","delay","priorityThreshold","timeout","superRefine","config","ctx","Array","isArray","routeNameMap","Map","walk","parentPath","forEach","route","index","currentPath","existingPath","get","addIssue","code","ZodIssueCode","custom","message","set","length","parse","safeParse"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/core/router/validation/schema.ts"],"sourcesContent":["/**\n * 路由配置验证 Schema（使用 Zod）\n */\n\nimport { z } from 'zod';\n\n/**\n * RouteItemHandle Schema\n */\nexport const routeItemHandleSchema = z.object({\n  title: z.string().min(1, '路由标题不能为空'),\n  i18nKey: z.string().optional(),\n  order: z.number().int('排序值必须是整数'),\n  icon: z.string().optional(),\n  hideInMenu: z.boolean().optional(),\n  hideFooter: z.boolean().optional(),\n  keepAlive: z.boolean().optional(),\n  needLogin: z.boolean().optional(),\n  roles: z.array(z.string()).optional(),\n  name: z.string().optional(),\n}).passthrough(); // 允许其他自定义字段\n\n/**\n * ComponentImport Schema\n * 可以是字符串路径或函数\n */\nexport const componentImportSchema = z.union([\n  z.string().min(1, '组件路径不能为空'),\n  z.function(),\n  z.null(),\n]);\n\nconst routerOptionsSchema = z\n  .object({\n    basename: z.string().optional(),\n    future: z.record(z.string(), z.union([z.boolean(), z.string(), z.number()])).optional(),\n    hydrationData: z.unknown().optional(),\n    window: z.unknown().optional(),\n    initialEntries: z.array(z.string()).optional(),\n    initialIndex: z.number().int().nonnegative().optional(),\n  })\n  .passthrough();\n\nconst transformOptionsSchema = z\n  .object({\n    pathValidation: z\n      .object({\n        enablePathValidation: z.boolean().optional(),\n        allowedPathPrefixes: z.array(z.string().min(1)).optional(),\n        maxPathLength: z.number().int().positive().optional(),\n        allowAbsolutePaths: z.boolean().optional(),\n      })\n      .optional(),\n    performance: z\n      .object({\n        enableCache: z.boolean().optional(),\n        cacheTTL: z.number().int().positive().optional(),\n        maxCacheSize: z.number().int().positive().optional(),\n        maxRecursionDepth: z.number().int().positive().optional(),\n        enableParallelProcessing: z.boolean().optional(),\n        parallelBatchSize: z.number().int().positive().optional(),\n      })\n      .optional(),\n    enableDebugLog: z.boolean().optional(),\n  })\n  .passthrough();\n\n/**\n * RouteConfig Schema\n */\nexport const routeConfigSchema: z.ZodType<any> = z.lazy(() =>\n  z.object({\n    layout: componentImportSchema.optional().nullable(),\n    page: componentImportSchema.optional().nullable(),\n    loading: componentImportSchema.optional().nullable(),\n    error: componentImportSchema.optional().nullable(),\n    errors: componentImportSchema.optional().nullable(),\n    name: z.string().min(1, '路由名称不能为空'),\n    path: z.string().optional(),\n    isGroup: z.boolean().optional(),\n    enableRedirection: z.boolean().optional(),\n    handle: routeItemHandleSchema,\n    children: z.array(routeConfigSchema).optional(),\n  })\n);\n\n/**\n * RouterConfig Schema\n */\nexport const routerConfigSchema = z.object({\n  enabled: z.union([z.boolean(), z.literal('disabled')]).optional(),\n  routes: z\n    .union([\n      z.array(routeConfigSchema),\n      z.function(),\n    ])\n    .optional(),\n  mode: z.enum(['browser', 'hash', 'memory']).optional(),\n  options: routerOptionsSchema.optional(),\n  pathResolve: z\n    .object({\n      basePath: z.string().optional(),\n      pathAliases: z.record(z.string(), z.string()).optional(),\n    })\n    .optional(),\n  transformOptions: transformOptionsSchema.optional(),\n  preload: z\n    .object({\n      strategy: z.enum(['none', 'next-level', 'all', 'visible']).optional(),\n      delay: z.number().int().positive().optional(),\n      priorityThreshold: z.number().int().nonnegative().optional(),\n      timeout: z.number().int().positive().optional(),\n    })\n    .optional(),\n  enableHydrateFallback: z.boolean().optional(),\n}).superRefine((config, ctx) => {\n  if (!Array.isArray(config.routes)) {\n    return;\n  }\n\n  const routeNameMap = new Map<string, string>();\n\n  const walk = (routes: Array<z.infer<typeof routeConfigSchema>>, parentPath: string): void => {\n    routes.forEach((route, index) => {\n      const currentPath = `${parentPath}[${index}]`;\n      const existingPath = routeNameMap.get(route.name);\n      if (existingPath) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['routes', index, 'name'],\n          message: `路由名称重复: \"${route.name}\"，首次定义位置 ${existingPath}`,\n        });\n      } else {\n        routeNameMap.set(route.name, currentPath);\n      }\n\n      if (Array.isArray(route.children) && route.children.length > 0) {\n        walk(route.children as Array<z.infer<typeof routeConfigSchema>>, `${currentPath}.children`);\n      }\n    });\n  };\n\n  walk(config.routes, 'routes');\n});\n\n/**\n * 验证路由配置\n * \n * @param config - 要验证的路由配置\n * @returns 验证后的路由配置\n * @throws z.ZodError 如果配置验证失败\n */\nexport function validateRouterConfig(config: unknown) {\n  return routerConfigSchema.parse(config);\n}\n\n/**\n * 安全验证路由配置（不抛出异常）\n * \n * @param config - 要验证的路由配置\n * @returns 验证结果\n */\nexport function safeValidateRouterConfig(config: unknown) {\n  return routerConfigSchema.safeParse(config);\n}\n"],"names":["componentImportSchema","routeConfigSchema","routeItemHandleSchema","routerConfigSchema","safeValidateRouterConfig","validateRouterConfig","z","object","title","string","min","i18nKey","optional","order","number","int","icon","hideInMenu","boolean","hideFooter","keepAlive","needLogin","roles","array","name","passthrough","union","function","null","routerOptionsSchema","basename","future","record","hydrationData","unknown","window","initialEntries","initialIndex","nonnegative","transformOptionsSchema","pathValidation","enablePathValidation","allowedPathPrefixes","maxPathLength","positive","allowAbsolutePaths","performance","enableCache","cacheTTL","maxCacheSize","maxRecursionDepth","enableParallelProcessing","parallelBatchSize","enableDebugLog","lazy","layout","nullable","page","loading","error","errors","path","isGroup","enableRedirection","handle","children","enabled","literal","routes","mode","enum","options","pathResolve","basePath","pathAliases","transformOptions","preload","strategy","delay","priorityThreshold","timeout","enableHydrateFallback","superRefine","config","ctx","Array","isArray","routeNameMap","Map","walk","parentPath","forEach","route","index","currentPath","existingPath","get","addIssue","code","ZodIssueCode","custom","message","set","length","parse","safeParse"],"mappings":"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"}

package/dist/core/router/validation/schema.d.ts

@@ -77,6 +77,7 @@ export declare const routerConfigSchema: z.ZodObject<{
         priorityThreshold: z.ZodOptional<z.ZodNumber>;
         timeout: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    enableHydrateFallback: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 /**
  * 验证路由配置
@@ -126,6 +127,7 @@ export declare function validateRouterConfig(config: unknown): {
         priorityThreshold?: number | undefined;
         timeout?: number | undefined;
     } | undefined;
+    enableHydrateFallback?: boolean | undefined;
 };
 /**
  * 安全验证路由配置（不抛出异常）
@@ -174,4 +176,5 @@ export declare function safeValidateRouterConfig(config: unknown): z.ZodSafePars
         priorityThreshold?: number | undefined;
         timeout?: number | undefined;
     } | undefined;
+    enableHydrateFallback?: boolean | undefined;
 }>;

package/dist/core/router/validation/schema.js

@@ -99,7 +99,8 @@ const transformOptionsSchema = z.object({
         delay: z.number().int().positive().optional(),
         priorityThreshold: z.number().int().nonnegative().optional(),
         timeout: z.number().int().positive().optional()
-    }).optional()
+    }).optional(),
+    enableHydrateFallback: z.boolean().optional()
 }).superRefine((config, ctx)=>{
     if (!Array.isArray(config.routes)) {
         return;

package/dist/core/router/validation/schema.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/core/router/validation/schema.ts"],"sourcesContent":["/**\n * 路由配置验证 Schema（使用 Zod）\n */\n\nimport { z } from 'zod';\n\n/**\n * RouteItemHandle Schema\n */\nexport const routeItemHandleSchema = z.object({\n  title: z.string().min(1, '路由标题不能为空'),\n  i18nKey: z.string().optional(),\n  order: z.number().int('排序值必须是整数'),\n  icon: z.string().optional(),\n  hideInMenu: z.boolean().optional(),\n  hideFooter: z.boolean().optional(),\n  keepAlive: z.boolean().optional(),\n  needLogin: z.boolean().optional(),\n  roles: z.array(z.string()).optional(),\n  name: z.string().optional(),\n}).passthrough(); // 允许其他自定义字段\n\n/**\n * ComponentImport Schema\n * 可以是字符串路径或函数\n */\nexport const componentImportSchema = z.union([\n  z.string().min(1, '组件路径不能为空'),\n  z.function(),\n  z.null(),\n]);\n\nconst routerOptionsSchema = z\n  .object({\n    basename: z.string().optional(),\n    future: z.record(z.string(), z.union([z.boolean(), z.string(), z.number()])).optional(),\n    hydrationData: z.unknown().optional(),\n    window: z.unknown().optional(),\n    initialEntries: z.array(z.string()).optional(),\n    initialIndex: z.number().int().nonnegative().optional(),\n  })\n  .passthrough();\n\nconst transformOptionsSchema = z\n  .object({\n    pathValidation: z\n      .object({\n        enablePathValidation: z.boolean().optional(),\n        allowedPathPrefixes: z.array(z.string().min(1)).optional(),\n        maxPathLength: z.number().int().positive().optional(),\n        allowAbsolutePaths: z.boolean().optional(),\n      })\n      .optional(),\n    performance: z\n      .object({\n        enableCache: z.boolean().optional(),\n        cacheTTL: z.number().int().positive().optional(),\n        maxCacheSize: z.number().int().positive().optional(),\n        maxRecursionDepth: z.number().int().positive().optional(),\n        enableParallelProcessing: z.boolean().optional(),\n        parallelBatchSize: z.number().int().positive().optional(),\n      })\n      .optional(),\n    enableDebugLog: z.boolean().optional(),\n  })\n  .passthrough();\n\n/**\n * RouteConfig Schema\n */\nexport const routeConfigSchema: z.ZodType<any> = z.lazy(() =>\n  z.object({\n    layout: componentImportSchema.optional().nullable(),\n    page: componentImportSchema.optional().nullable(),\n    loading: componentImportSchema.optional().nullable(),\n    error: componentImportSchema.optional().nullable(),\n    errors: componentImportSchema.optional().nullable(),\n    name: z.string().min(1, '路由名称不能为空'),\n    path: z.string().optional(),\n    isGroup: z.boolean().optional(),\n    enableRedirection: z.boolean().optional(),\n    handle: routeItemHandleSchema,\n    children: z.array(routeConfigSchema).optional(),\n  })\n);\n\n/**\n * RouterConfig Schema\n */\nexport const routerConfigSchema = z.object({\n  enabled: z.union([z.boolean(), z.literal('disabled')]).optional(),\n  routes: z\n    .union([\n      z.array(routeConfigSchema),\n      z.function(),\n    ])\n    .optional(),\n  mode: z.enum(['browser', 'hash', 'memory']).optional(),\n  options: routerOptionsSchema.optional(),\n  pathResolve: z\n    .object({\n      basePath: z.string().optional(),\n      pathAliases: z.record(z.string(), z.string()).optional(),\n    })\n    .optional(),\n  transformOptions: transformOptionsSchema.optional(),\n  preload: z\n    .object({\n      strategy: z.enum(['none', 'next-level', 'all', 'visible']).optional(),\n      delay: z.number().int().positive().optional(),\n      priorityThreshold: z.number().int().nonnegative().optional(),\n      timeout: z.number().int().positive().optional(),\n    })\n    .optional(),\n}).superRefine((config, ctx) => {\n  if (!Array.isArray(config.routes)) {\n    return;\n  }\n\n  const routeNameMap = new Map<string, string>();\n\n  const walk = (routes: Array<z.infer<typeof routeConfigSchema>>, parentPath: string): void => {\n    routes.forEach((route, index) => {\n      const currentPath = `${parentPath}[${index}]`;\n      const existingPath = routeNameMap.get(route.name);\n      if (existingPath) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['routes', index, 'name'],\n          message: `路由名称重复: \"${route.name}\"，首次定义位置 ${existingPath}`,\n        });\n      } else {\n        routeNameMap.set(route.name, currentPath);\n      }\n\n      if (Array.isArray(route.children) && route.children.length > 0) {\n        walk(route.children as Array<z.infer<typeof routeConfigSchema>>, `${currentPath}.children`);\n      }\n    });\n  };\n\n  walk(config.routes, 'routes');\n});\n\n/**\n * 验证路由配置\n * \n * @param config - 要验证的路由配置\n * @returns 验证后的路由配置\n * @throws z.ZodError 如果配置验证失败\n */\nexport function validateRouterConfig(config: unknown) {\n  return routerConfigSchema.parse(config);\n}\n\n/**\n * 安全验证路由配置（不抛出异常）\n * \n * @param config - 要验证的路由配置\n * @returns 验证结果\n */\nexport function safeValidateRouterConfig(config: unknown) {\n  return routerConfigSchema.safeParse(config);\n}\n"],"names":["z","routeItemHandleSchema","object","title","string","min","i18nKey","optional","order","number","int","icon","hideInMenu","boolean","hideFooter","keepAlive","needLogin","roles","array","name","passthrough","componentImportSchema","union","function","null","routerOptionsSchema","basename","future","record","hydrationData","unknown","window","initialEntries","initialIndex","nonnegative","transformOptionsSchema","pathValidation","enablePathValidation","allowedPathPrefixes","maxPathLength","positive","allowAbsolutePaths","performance","enableCache","cacheTTL","maxCacheSize","maxRecursionDepth","enableParallelProcessing","parallelBatchSize","enableDebugLog","routeConfigSchema","lazy","layout","nullable","page","loading","error","errors","path","isGroup","enableRedirection","handle","children","routerConfigSchema","enabled","literal","routes","mode","enum","options","pathResolve","basePath","pathAliases","transformOptions","preload","strategy","delay","priorityThreshold","timeout","superRefine","config","ctx","Array","isArray","routeNameMap","Map","walk","parentPath","forEach","route","index","currentPath","existingPath","get","addIssue","code","ZodIssueCode","custom","message","set","length","validateRouterConfig","parse","safeValidateRouterConfig","safeParse"],"mappings":"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"}
+{"version":3,"sources":["../../../../src/core/router/validation/schema.ts"],"sourcesContent":["/**\n * 路由配置验证 Schema（使用 Zod）\n */\n\nimport { z } from 'zod';\n\n/**\n * RouteItemHandle Schema\n */\nexport const routeItemHandleSchema = z.object({\n  title: z.string().min(1, '路由标题不能为空'),\n  i18nKey: z.string().optional(),\n  order: z.number().int('排序值必须是整数'),\n  icon: z.string().optional(),\n  hideInMenu: z.boolean().optional(),\n  hideFooter: z.boolean().optional(),\n  keepAlive: z.boolean().optional(),\n  needLogin: z.boolean().optional(),\n  roles: z.array(z.string()).optional(),\n  name: z.string().optional(),\n}).passthrough(); // 允许其他自定义字段\n\n/**\n * ComponentImport Schema\n * 可以是字符串路径或函数\n */\nexport const componentImportSchema = z.union([\n  z.string().min(1, '组件路径不能为空'),\n  z.function(),\n  z.null(),\n]);\n\nconst routerOptionsSchema = z\n  .object({\n    basename: z.string().optional(),\n    future: z.record(z.string(), z.union([z.boolean(), z.string(), z.number()])).optional(),\n    hydrationData: z.unknown().optional(),\n    window: z.unknown().optional(),\n    initialEntries: z.array(z.string()).optional(),\n    initialIndex: z.number().int().nonnegative().optional(),\n  })\n  .passthrough();\n\nconst transformOptionsSchema = z\n  .object({\n    pathValidation: z\n      .object({\n        enablePathValidation: z.boolean().optional(),\n        allowedPathPrefixes: z.array(z.string().min(1)).optional(),\n        maxPathLength: z.number().int().positive().optional(),\n        allowAbsolutePaths: z.boolean().optional(),\n      })\n      .optional(),\n    performance: z\n      .object({\n        enableCache: z.boolean().optional(),\n        cacheTTL: z.number().int().positive().optional(),\n        maxCacheSize: z.number().int().positive().optional(),\n        maxRecursionDepth: z.number().int().positive().optional(),\n        enableParallelProcessing: z.boolean().optional(),\n        parallelBatchSize: z.number().int().positive().optional(),\n      })\n      .optional(),\n    enableDebugLog: z.boolean().optional(),\n  })\n  .passthrough();\n\n/**\n * RouteConfig Schema\n */\nexport const routeConfigSchema: z.ZodType<any> = z.lazy(() =>\n  z.object({\n    layout: componentImportSchema.optional().nullable(),\n    page: componentImportSchema.optional().nullable(),\n    loading: componentImportSchema.optional().nullable(),\n    error: componentImportSchema.optional().nullable(),\n    errors: componentImportSchema.optional().nullable(),\n    name: z.string().min(1, '路由名称不能为空'),\n    path: z.string().optional(),\n    isGroup: z.boolean().optional(),\n    enableRedirection: z.boolean().optional(),\n    handle: routeItemHandleSchema,\n    children: z.array(routeConfigSchema).optional(),\n  })\n);\n\n/**\n * RouterConfig Schema\n */\nexport const routerConfigSchema = z.object({\n  enabled: z.union([z.boolean(), z.literal('disabled')]).optional(),\n  routes: z\n    .union([\n      z.array(routeConfigSchema),\n      z.function(),\n    ])\n    .optional(),\n  mode: z.enum(['browser', 'hash', 'memory']).optional(),\n  options: routerOptionsSchema.optional(),\n  pathResolve: z\n    .object({\n      basePath: z.string().optional(),\n      pathAliases: z.record(z.string(), z.string()).optional(),\n    })\n    .optional(),\n  transformOptions: transformOptionsSchema.optional(),\n  preload: z\n    .object({\n      strategy: z.enum(['none', 'next-level', 'all', 'visible']).optional(),\n      delay: z.number().int().positive().optional(),\n      priorityThreshold: z.number().int().nonnegative().optional(),\n      timeout: z.number().int().positive().optional(),\n    })\n    .optional(),\n  enableHydrateFallback: z.boolean().optional(),\n}).superRefine((config, ctx) => {\n  if (!Array.isArray(config.routes)) {\n    return;\n  }\n\n  const routeNameMap = new Map<string, string>();\n\n  const walk = (routes: Array<z.infer<typeof routeConfigSchema>>, parentPath: string): void => {\n    routes.forEach((route, index) => {\n      const currentPath = `${parentPath}[${index}]`;\n      const existingPath = routeNameMap.get(route.name);\n      if (existingPath) {\n        ctx.addIssue({\n          code: z.ZodIssueCode.custom,\n          path: ['routes', index, 'name'],\n          message: `路由名称重复: \"${route.name}\"，首次定义位置 ${existingPath}`,\n        });\n      } else {\n        routeNameMap.set(route.name, currentPath);\n      }\n\n      if (Array.isArray(route.children) && route.children.length > 0) {\n        walk(route.children as Array<z.infer<typeof routeConfigSchema>>, `${currentPath}.children`);\n      }\n    });\n  };\n\n  walk(config.routes, 'routes');\n});\n\n/**\n * 验证路由配置\n * \n * @param config - 要验证的路由配置\n * @returns 验证后的路由配置\n * @throws z.ZodError 如果配置验证失败\n */\nexport function validateRouterConfig(config: unknown) {\n  return routerConfigSchema.parse(config);\n}\n\n/**\n * 安全验证路由配置（不抛出异常）\n * \n * @param config - 要验证的路由配置\n * @returns 验证结果\n */\nexport function safeValidateRouterConfig(config: unknown) {\n  return routerConfigSchema.safeParse(config);\n}\n"],"names":["z","routeItemHandleSchema","object","title","string","min","i18nKey","optional","order","number","int","icon","hideInMenu","boolean","hideFooter","keepAlive","needLogin","roles","array","name","passthrough","componentImportSchema","union","function","null","routerOptionsSchema","basename","future","record","hydrationData","unknown","window","initialEntries","initialIndex","nonnegative","transformOptionsSchema","pathValidation","enablePathValidation","allowedPathPrefixes","maxPathLength","positive","allowAbsolutePaths","performance","enableCache","cacheTTL","maxCacheSize","maxRecursionDepth","enableParallelProcessing","parallelBatchSize","enableDebugLog","routeConfigSchema","lazy","layout","nullable","page","loading","error","errors","path","isGroup","enableRedirection","handle","children","routerConfigSchema","enabled","literal","routes","mode","enum","options","pathResolve","basePath","pathAliases","transformOptions","preload","strategy","delay","priorityThreshold","timeout","enableHydrateFallback","superRefine","config","ctx","Array","isArray","routeNameMap","Map","walk","parentPath","forEach","route","index","currentPath","existingPath","get","addIssue","code","ZodIssueCode","custom","message","set","length","validateRouterConfig","parse","safeValidateRouterConfig","safeParse"],"mappings":"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"}

package/dist/index.umd.js

@@ -1,5 +1,5 @@
 /*!
- * @vlian/framework v1.2.18
+ * @vlian/framework v1.2.19
  * Secra Framework - 一个现代化的低代码框架
  * (c) 2026 Secra Framework Contributors
  * Licensed under Apache-2.0
@@ -25803,7 +25803,7 @@
             children: "Loading..."
         });
     }
-    const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent)=>{
+    const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent, enableHydrateFallback = false)=>{
         /**
          * 批量处理路由
          * @param routes 路由组
@@ -25934,28 +25934,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 +25973,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 +26006,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 +26119,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 +28020,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 +28191,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 +28232,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;