@vlian/framework 1.2.1 → 1.2.18

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

@@ -1,8 +1,17 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import React from "react";
 import { Navigate } from "react-router-dom";
 import { RouteErrorBoundary } from "./RouteErrorBoundary";
-import { Spin } from "antd";
+import { logger } from "../../../../../utils";
+function DefaultRouteHydrateFallback() {
+    return /*#__PURE__*/ _jsx("div", {
+        style: {
+            padding: 16,
+            textAlign: 'center',
+            color: '#5f6c7b'
+        },
+        children: "Loading..."
+    });
+}
 export const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent)=>{
     /**
      * 批量处理路由
@@ -14,18 +23,19 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
      * 处理单个路由
      * @param route 路由
      */ function transformRouteToReactRoute(route) {
-        const { isGroup = false, enableRedirection = false, name, path, handle, children, page, layout, loading, errors } = route;
+        const { isGroup = false, enableRedirection = false, name, path, handle, children, page, layout, error, errors, loading } = route;
+        const routeError = error ?? errors;
         // 获取错误组件
         async function getErrorComponent() {
-            // 如果 errors 是函数，直接使用
-            if (typeof errors === 'function') {
-                return errors();
+            // 如果 error/errors 是函数，直接使用
+            if (typeof routeError === 'function') {
+                return routeError();
             }
             const errorsMap = transformResult.errors;
-            // 判断 errors 是否为 string 且不是空字符串
-            if (typeof errors === 'string' && errors !== '') {
-                // 使用 errors 作为 key 获取 transformResult.errors 的值
-                const errorResolver = errorsMap.get(errors);
+            // 判断 error/errors 是否为 string 且不是空字符串
+            if (typeof routeError === 'string' && routeError !== '') {
+                // 使用 routeError 作为 key 获取 transformResult.errors 的值
+                const errorResolver = errorsMap.get(routeError);
                 // 如果获取不到，返回 null
                 if (!errorResolver) {
                     return null;
@@ -50,52 +60,6 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
                 default: RouteErrorBoundary
             };
         }
-        // 获取默认加载组件（配置的或内置的 Spin）
-        function getDefaultLoadingComponent() {
-            if (defaultRouteLoadingComponent) {
-                // 如果配置了默认加载组件，使用 React.lazy 包装
-                // 使用懒加载是因为用户可能希望自定义组件支持代码分割
-                return /*#__PURE__*/ React.lazy(()=>defaultRouteLoadingComponent().then((module)=>({
-                            default: module.default || module
-                        })));
-            }
-            // 如果没有配置默认加载组件，使用 antd 的 Spin 作为默认组件
-            // 直接导入而非懒加载，因为：
-            // 1. Spin 是 antd 的基础组件，体积小
-            // 2. 加载组件需要快速显示，直接导入速度更快
-            // 3. 作为基础设施组件，应该保证可用性
-            return Spin;
-        }
-        // 获取加载组件
-        function getLoadingComponent() {
-            // 如果 loading 是函数，直接使用 React.lazy 包装
-            if (typeof loading === 'function') {
-                return /*#__PURE__*/ React.lazy(()=>loading().then((module)=>({
-                            default: module.default || module
-                        })));
-            }
-            const loadingsMap = transformResult.loadings;
-            // 判断 loading 是否为 string 且不是空字符串
-            if (typeof loading === 'string' && loading !== '') {
-                // 使用 loading 作为 key 获取 transformResult.loadings 的值
-                const loadingResolver = loadingsMap.get(loading);
-                // 如果获取不到，使用默认加载组件
-                if (!loadingResolver) {
-                    return getDefaultLoadingComponent();
-                }
-                // 如果获取到，使用 React.lazy 包装动态导入函数
-                // loadingResolver 是一个返回 Promise 的函数，Promise resolve 后的值是组件模块
-                if (typeof loadingResolver === 'function') {
-                    return /*#__PURE__*/ React.lazy(()=>loadingResolver().then((module)=>({
-                                default: module.default || module
-                            })));
-                }
-                // 如果 loadingResolver 不是函数，使用默认加载组件
-                return getDefaultLoadingComponent();
-            }
-            // 如果 loading 为空，使用默认加载组件
-            return getDefaultLoadingComponent();
-        }
         // 获取转换配置
         function convertConfig(m) {
             if (!m) {
@@ -104,7 +68,7 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
             const { action, loader, shouldRevalidate, default: Component } = m;
             // 如果 Component 不存在，记录警告
             if (!Component) {
-                console.warn(`路由组件未找到 default 导出: ${name}`, m);
+                logger.warn(`路由组件未找到 default 导出: ${name}`, m);
             }
             return {
                 action,
@@ -113,6 +77,22 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
                 Component
             };
         }
+        // 获取加载组件
+        async function getLoadingComponent() {
+            if (typeof loading === 'function') {
+                return loading();
+            }
+            if (typeof loading === 'string' && loading !== '') {
+                const loadingResolver = transformResult.loadings.get(loading);
+                if (typeof loadingResolver === 'function') {
+                    return loadingResolver();
+                }
+            }
+            if (defaultRouteLoadingComponent) {
+                return defaultRouteLoadingComponent();
+            }
+            return null;
+        }
         // 获取配置
         async function getConfig(index = false) {
             // 如果有layout和不是index,返回布局配置
@@ -168,20 +148,23 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
         }
         const reactRoute = {
             children: [],
-            HydrateFallback: getLoadingComponent(),
+            hydrateFallbackElement: /*#__PURE__*/ _jsx(DefaultRouteHydrateFallback, {}),
             id: name,
             handle: getHandle(),
             lazy: async ()=>{
                 const ErrorBoundary = await getErrorComponent();
                 const config = await getConfig();
+                const LoadingComponent = await getLoadingComponent();
                 // 如果配置为空，确保至少返回一个空对象，避免展开 undefined
                 if (!config) {
                     return {
-                        ErrorBoundary: ErrorBoundary?.default
+                        ErrorBoundary: ErrorBoundary?.default,
+                        HydrateFallback: LoadingComponent?.default
                     };
                 }
                 return {
                     ErrorBoundary: ErrorBoundary?.default,
+                    HydrateFallback: LoadingComponent?.default,
                     ...config
                 };
             },
@@ -200,8 +183,10 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
                     index: true,
                     lazy: async ()=>{
                         const ErrorBoundary = await getErrorComponent();
+                        const LoadingComponent = await getLoadingComponent();
                         return {
                             ErrorBoundary: ErrorBoundary?.default,
+                            HydrateFallback: LoadingComponent?.default,
                             ...await getConfig(true)
                         };
                     }
@@ -230,8 +215,10 @@ export const transformRoutesToReactRoutes = async (routes, transformResult, defa
                     index: true,
                     lazy: async ()=>{
                         const ErrorBoundary = await getErrorComponent();
+                        const LoadingComponent = await getLoadingComponent();
                         return {
                             ErrorBoundary: ErrorBoundary?.default,
+                            HydrateFallback: LoadingComponent?.default,
                             ...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 React from \"react\";\nimport {\n    type RouteObject,\n    Navigate\n} from 'react-router-dom';\nimport type { TransformRoutesResult } from '../../transform';\nimport { RouteErrorBoundary } from './RouteErrorBoundary';\nimport { Spin } from 'antd';\nimport type { ComponentImport } from '../../../types';\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            loading,\n            errors\n        } = route;\n\n        // 获取错误组件\n        async function getErrorComponent() {\n            // 如果 errors 是函数，直接使用\n            if (typeof errors === 'function') {\n                return errors();\n            }\n\n            const errorsMap = transformResult.errors;\n\n            // 判断 errors 是否为 string 且不是空字符串\n            if (typeof errors === 'string' && errors !== '') {\n                // 使用 errors 作为 key 获取 transformResult.errors 的值\n                const errorResolver = errorsMap.get(errors);\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        // 获取默认加载组件（配置的或内置的 Spin）\n        function getDefaultLoadingComponent() {\n            if (defaultRouteLoadingComponent) {\n                // 如果配置了默认加载组件，使用 React.lazy 包装\n                // 使用懒加载是因为用户可能希望自定义组件支持代码分割\n                return React.lazy(() => defaultRouteLoadingComponent().then(module => ({ default: module.default || module })));\n            }\n            // 如果没有配置默认加载组件，使用 antd 的 Spin 作为默认组件\n            // 直接导入而非懒加载，因为：\n            // 1. Spin 是 antd 的基础组件，体积小\n            // 2. 加载组件需要快速显示，直接导入速度更快\n            // 3. 作为基础设施组件，应该保证可用性\n            return Spin;\n        }\n\n        // 获取加载组件\n        function getLoadingComponent() {\n            // 如果 loading 是函数，直接使用 React.lazy 包装\n            if (typeof loading === 'function') {\n                return React.lazy(() => loading().then(module => ({ default: module.default || module })));\n            }\n\n            const loadingsMap = transformResult.loadings;\n\n            // 判断 loading 是否为 string 且不是空字符串\n            if (typeof loading === 'string' && loading !== '') {\n                // 使用 loading 作为 key 获取 transformResult.loadings 的值\n                const loadingResolver = loadingsMap.get(loading);\n\n                // 如果获取不到，使用默认加载组件\n                if (!loadingResolver) {\n                    return getDefaultLoadingComponent();\n                }\n\n                // 如果获取到，使用 React.lazy 包装动态导入函数\n                // loadingResolver 是一个返回 Promise 的函数，Promise resolve 后的值是组件模块\n                if (typeof loadingResolver === 'function') {\n                    return React.lazy(() => loadingResolver().then(module => ({ default: module.default || module })));\n                }\n\n                // 如果 loadingResolver 不是函数，使用默认加载组件\n                return getDefaultLoadingComponent();\n            }\n\n            // 如果 loading 为空，使用默认加载组件\n            return getDefaultLoadingComponent();\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                console.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 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            HydrateFallback: getLoadingComponent(),\n            id: name,\n            handle: getHandle(),\n            lazy: async () => {\n                const ErrorBoundary = await getErrorComponent();\n                const config = await getConfig();\n\n                // 如果配置为空，确保至少返回一个空对象，避免展开 undefined\n                if (!config) {\n                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                    };\n                }\n\n                return {\n                    ErrorBoundary: ErrorBoundary?.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                        return {\n                            ErrorBoundary: ErrorBoundary?.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                    return {\n                        ErrorBoundary: ErrorBoundary?.default,\n                        ...(await getConfig(true))\n                    };\n                }\n            }];\n        }\n\n        return reactRoute;\n    }\n\n    return transformRouteToReactRoutes(routes);\n}\n\n\n\n\n"],"names":["React","Navigate","RouteErrorBoundary","Spin","transformRoutesToReactRoutes","routes","transformResult","defaultRouteErrorComponent","defaultRouteLoadingComponent","transformRouteToReactRoutes","flatMap","route","transformRouteToReactRoute","isGroup","enableRedirection","name","path","handle","children","page","layout","loading","errors","getErrorComponent","errorsMap","errorResolver","get","default","getDefaultLoadingComponent","lazy","then","module","getLoadingComponent","loadingsMap","loadings","loadingResolver","convertConfig","m","action","loader","shouldRevalidate","Component","console","warn","getConfig","index","config","layoutResolver","layouts","Error","pageName","length","viewResolver","pages","getHandle","reactRoute","HydrateFallback","id","ErrorBoundary","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): 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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"}

package/dist/core/router/utils/transform.cjs

@@ -122,7 +122,12 @@ function _interop_require_wildcard(obj, nodeInterop) {
  */ const DEFAULT_OPTIONS = {
     pathValidation: {
         enablePathValidation: true,
-        allowedPathPrefixes: [],
+        // 默认仅允许常见本地模块路径，生产环境建议进一步收紧。
+        allowedPathPrefixes: [
+            '@/',
+            './',
+            '../'
+        ],
         maxPathLength: 500,
         allowAbsolutePaths: false
     },
@@ -184,62 +189,62 @@ function _interop_require_wildcard(obj, nodeInterop) {
  */ function simpleHash(str) {
     return optimizedHash(str);
 }
-/**
- * 配置序列化缓存（避免重复序列化）
- */ const configStringCache = new Map();
+function serializeComponentRef(value) {
+    if (typeof value === 'string') {
+        return {
+            str: value
+        };
+    }
+    if (typeof value === 'function') {
+        // 函数引用无法稳定序列化源码，使用名称和长度参与哈希，避免同名不同体完全碰撞。
+        const fnText = String(value);
+        return {
+            fn: `${value.name || 'anonymous'}:${fnText.length}`
+        };
+    }
+    return {};
+}
+function serializeRouteConfig(route) {
+    const page = serializeComponentRef(route.page);
+    const layout = serializeComponentRef(route.layout);
+    const routeError = serializeComponentRef(route.error ?? route.errors);
+    const loading = serializeComponentRef(route.loading);
+    return {
+        name: route.name,
+        path: route.path,
+        page: page.str,
+        pageFn: page.fn,
+        layout: layout.str,
+        layoutFn: layout.fn,
+        error: routeError.str,
+        errorFn: routeError.fn,
+        loading: loading.str,
+        loadingFn: loading.fn,
+        isGroup: route.isGroup,
+        enableRedirection: route.enableRedirection,
+        handle: route.handle ? {
+            title: route.handle.title,
+            order: route.handle.order,
+            needLogin: route.handle.needLogin,
+            roles: Array.isArray(route.handle.roles) ? [
+                ...route.handle.roles
+            ] : undefined
+        } : undefined,
+        children: route.children?.map((child)=>serializeRouteConfig(child))
+    };
+}
 /**
  * 生成配置哈希（用于缓存键）
  * 优化：缓存序列化结果，避免重复序列化
  */ function generateConfigHash(routes) {
     try {
-        // 快速检查：如果路由数量为 0，直接返回
         if (routes.length === 0) {
             return 'empty';
         }
-        // 使用路由数量作为快速键的一部分
-        const quickKey = `${routes.length}_${routes[0]?.name || ''}_${routes[routes.length - 1]?.name || ''}`;
-        // 检查序列化缓存
-        if (configStringCache.has(quickKey)) {
-            const cachedStr = configStringCache.get(quickKey);
-            // 验证缓存是否仍然有效（简单检查）
-            const currentStr = JSON.stringify(routes, null, 0).substring(0, 100);
-            if (cachedStr.startsWith(currentStr.substring(0, 50))) {
-                return simpleHash(cachedStr);
-            }
-        }
-        // 使用 JSON.stringify 生成配置的字符串表示
-        // 只包含影响转换结果的字段
-        const configStr = JSON.stringify(routes, (key, value)=>{
-            // 只序列化相关字段
-            if ([
-                'name',
-                'path',
-                'page',
-                'layout',
-                'errors',
-                'loading',
-                'isGroup',
-                'enableRedirection',
-                'children'
-            ].includes(key)) {
-                return value;
-            }
-            if (key === 'handle' && value && typeof value === 'object') {
-                // 只序列化 handle 的基本字段
-                return {
-                    title: value.title,
-                    order: value.order
-                };
-            }
-            return undefined;
-        });
-        // 缓存序列化结果（限制缓存大小）
-        if (configStringCache.size < 20) {
-            configStringCache.set(quickKey, configStr);
-        }
+        const serializedRoutes = routes.map((route)=>serializeRouteConfig(route));
+        const configStr = JSON.stringify(serializedRoutes);
         return simpleHash(configStr);
     } catch  {
-        // 如果序列化失败，返回空字符串（不使用缓存）
         return '';
     }
 }
@@ -252,6 +257,7 @@ function _interop_require_wildcard(obj, nodeInterop) {
 const ABSOLUTE_PATH_REGEX = /^\/|^[A-Za-z]:\\/;
 const CONTROL_CHAR_REGEX = /[\x00-\x1f\x7f]/;
 const NULL_BYTE_REGEX = /%00|\\0|\x00/;
+const URL_SCHEME_REGEX = /^[A-Za-z][A-Za-z0-9+.-]*:/;
 // 保留供未来使用（命令注入检测）
 // const COMMAND_INJECTION_REGEX = /[;|&$`]/;
 // const ALLOWED_CHARS_REGEX = /^[a-zA-Z0-9\/\-_.@]+$/;
@@ -309,6 +315,13 @@ const NULL_BYTE_REGEX = /%00|\\0|\x00/;
     //       : '路径验证失败',
     //   };
     // }
+    // 禁止 URL scheme 导入（如 http:, https:, data:, javascript:）
+    if (URL_SCHEME_REGEX.test(path)) {
+        return {
+            valid: false,
+            error: process.env.NODE_ENV === 'development' ? '不允许使用带协议的路径' : '路径验证失败'
+        };
+    }
     // 检查绝对路径（使用预编译正则）
     if (!config.allowAbsolutePaths && ABSOLUTE_PATH_REGEX.test(path)) {
         return {
@@ -316,6 +329,13 @@ const NULL_BYTE_REGEX = /%00|\\0|\x00/;
             error: process.env.NODE_ENV === 'development' ? '不允许使用绝对路径' : '路径验证失败'
         };
     }
+    // 默认仅允许相对路径和别名路径，避免把第三方包名作为动态入口。
+    if (!path.startsWith('@/') && !path.startsWith('./') && !path.startsWith('../')) {
+        return {
+            valid: false,
+            error: process.env.NODE_ENV === 'development' ? '仅允许使用 @/、./、../ 开头的模块路径' : '路径验证失败'
+        };
+    }
     // 检查路径前缀白名单（优化：使用 Set 提高查找速度）
     if (config.allowedPathPrefixes.length > 0) {
         const prefixSet = new Set(config.allowedPathPrefixes);
@@ -390,7 +410,7 @@ const NULL_BYTE_REGEX = /%00|\\0|\x00/;
  */ function createDynamicImport(path) {
     // 使用类型断言，因为 TypeScript 的 import() 需要静态字符串
     // 但在运行时，我们可以使用动态路径
-    return ()=>Promise.resolve(path).then((p)=>/*#__PURE__*/ _interop_require_wildcard(require(p)));
+    return ()=>Promise.resolve(/* @vite-ignore */ path).then((p)=>/*#__PURE__*/ _interop_require_wildcard(require(p)));
 }
 /**
  * 提取并验证组件路径到 Map 中
@@ -537,9 +557,10 @@ const stackNodePool = new StackNodePool();
                     map: result.layouts
                 });
             }
-            if (route.errors && typeof route.errors === 'string') {
+            const routeError = route.error ?? route.errors;
+            if (routeError && typeof routeError === 'string') {
                 pathsToProcess.push({
-                    path: route.errors,
+                    path: routeError,
                     map: result.errors
                 });
             }
@@ -584,7 +605,7 @@ const stackNodePool = new StackNodePool();
             // 提取组件路径到 Map 中（同时进行验证）
             extractAndValidatePath(route.page, result.pages, config, options);
             extractAndValidatePath(route.layout, result.layouts, config, options);
-            extractAndValidatePath(route.errors, result.errors, config, options);
+            extractAndValidatePath(route.error ?? route.errors, result.errors, config, options);
             extractAndValidatePath(route.loading, result.loadings, config, options);
             // 处理子路由
             if (route.children && Array.isArray(route.children) && route.children.length > 0) {
@@ -708,26 +729,14 @@ async function transformRoutes(routes, options = {}) {
         if (mergedOptions.performance.enableCache && transformCache) {
             const configHash = generateConfigHash(routesArray);
             if (configHash) {
-                // 使用结构化克隆（如果可用）或浅拷贝 + 深拷贝 routes
-                let cachedResult;
-                if (typeof structuredClone !== 'undefined') {
-                    // 使用结构化克隆（更快且更安全）
-                    cachedResult = structuredClone(result);
-                    // Map 需要手动克隆（structuredClone 可能不支持 Map）
-                    cachedResult.pages = new Map(result.pages);
-                    cachedResult.layouts = new Map(result.layouts);
-                    cachedResult.errors = new Map(result.errors);
-                    cachedResult.loadings = new Map(result.loadings);
-                } else {
-                    // 回退到手动深拷贝
-                    cachedResult = {
-                        pages: new Map(result.pages),
-                        layouts: new Map(result.layouts),
-                        errors: new Map(result.errors),
-                        loadings: new Map(result.loadings),
-                        routes: JSON.parse(JSON.stringify(result.routes))
-                    };
-                }
+                // 注意：Map 中包含函数值，structuredClone 会失败；统一使用手动克隆。
+                const cachedResult = {
+                    pages: new Map(result.pages),
+                    layouts: new Map(result.layouts),
+                    errors: new Map(result.errors),
+                    loadings: new Map(result.loadings),
+                    routes: JSON.parse(JSON.stringify(result.routes))
+                };
                 transformCache.set(configHash, {
                     result: cachedResult,
                     timestamp: Date.now(),