@vlian/framework 1.0.0

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

@@ -0,0 +1,129 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from "react";
+import { Result, Button, Collapse } from "antd";
+const isDevelopment = process.env.NODE_ENV === 'development';
+export const RouteErrorBoundary = ({ error, resetErrorBoundary })=>{
+    const [showDetails, setShowDetails] = useState(false);
+    // 可以在这里根据不同的业务逻辑处理错误或者上报给日志服务
+    // const { token } = theme.useToken();
+    // const themeColor = token.colorPrimary;
+    const errorWithCause = error;
+    const hasCause = 'cause' in error && errorWithCause.cause !== undefined;
+    const errorDetails = isDevelopment ? /*#__PURE__*/ _jsx("div", {
+        style: {
+            marginTop: 16,
+            textAlign: 'left'
+        },
+        children: /*#__PURE__*/ _jsx(Collapse, {
+            activeKey: showDetails ? [
+                'details'
+            ] : [],
+            onChange: (keys)=>setShowDetails(keys.includes('details')),
+            items: [
+                {
+                    key: 'details',
+                    label: /*#__PURE__*/ _jsxs("span", {
+                        children: [
+                            showDetails ? '▲' : '▼',
+                            " 错误详情"
+                        ]
+                    }),
+                    children: /*#__PURE__*/ _jsxs("div", {
+                        style: {
+                            fontFamily: 'monospace',
+                            fontSize: '12px',
+                            whiteSpace: 'pre-wrap',
+                            wordBreak: 'break-all'
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx("div", {
+                                style: {
+                                    marginBottom: 8,
+                                    fontWeight: 'bold'
+                                },
+                                children: "错误信息："
+                            }),
+                            /*#__PURE__*/ _jsx("div", {
+                                style: {
+                                    marginBottom: 16,
+                                    color: '#ff4d4f'
+                                },
+                                children: error.message
+                            }),
+                            error.stack && /*#__PURE__*/ _jsxs(_Fragment, {
+                                children: [
+                                    /*#__PURE__*/ _jsx("div", {
+                                        style: {
+                                            marginBottom: 8,
+                                            fontWeight: 'bold'
+                                        },
+                                        children: "堆栈信息："
+                                    }),
+                                    /*#__PURE__*/ _jsx("div", {
+                                        style: {
+                                            marginBottom: 16,
+                                            color: '#666'
+                                        },
+                                        children: error.stack
+                                    })
+                                ]
+                            }),
+                            hasCause && /*#__PURE__*/ _jsxs(_Fragment, {
+                                children: [
+                                    /*#__PURE__*/ _jsx("div", {
+                                        style: {
+                                            marginBottom: 8,
+                                            fontWeight: 'bold'
+                                        },
+                                        children: "原因："
+                                    }),
+                                    /*#__PURE__*/ _jsx("div", {
+                                        style: {
+                                            marginBottom: 16,
+                                            color: '#666'
+                                        },
+                                        children: errorWithCause.cause instanceof Error ? errorWithCause.cause.message : String(errorWithCause.cause)
+                                    })
+                                ]
+                            })
+                        ]
+                    })
+                }
+            ]
+        })
+    }) : null;
+    return /*#__PURE__*/ _jsx("div", {
+        className: "size-full flex-col-center gap-16px overflow-y-scroll flex-col flex justify-center items-center gap-4",
+        children: /*#__PURE__*/ _jsx("div", {
+            className: "flex text-400px text-primary",
+            children: /*#__PURE__*/ _jsx(Result, {
+                status: "error",
+                title: "出错了，请稍后再试",
+                subTitle: isDevelopment ? error.message : '请稍后再试或联系技术支持',
+                extra: /*#__PURE__*/ _jsxs("div", {
+                    style: {
+                        display: 'flex',
+                        gap: 8,
+                        flexDirection: 'column',
+                        alignItems: 'center'
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsx(Button, {
+                            type: "primary",
+                            onClick: resetErrorBoundary,
+                            children: "刷新重试"
+                        }),
+                        isDevelopment && /*#__PURE__*/ _jsx(Button, {
+                            type: "link",
+                            onClick: ()=>setShowDetails(!showDetails),
+                            children: showDetails ? '▲ 收起详情' : '▼ 展开详情'
+                        })
+                    ]
+                }),
+                children: errorDetails
+            })
+        })
+    });
+};
+
+//# sourceMappingURL=RouteErrorBoundary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/core/router/utils/adapters/react-router/RouteErrorBoundary.tsx"],"sourcesContent":["import { useState } from 'react';\nimport type { FallbackProps } from 'react-error-boundary';\nimport { Result, Button, Collapse } from 'antd';\n\nconst isDevelopment = process.env.NODE_ENV === 'development';\n\ninterface ErrorWithCause extends Error {\n    cause?: unknown;\n}\n\nexport const RouteErrorBoundary = ({ error, resetErrorBoundary }: FallbackProps) => {\n    const [showDetails, setShowDetails] = useState(false);\n\n    // 可以在这里根据不同的业务逻辑处理错误或者上报给日志服务\n    // const { token } = theme.useToken();\n    // const themeColor = token.colorPrimary;\n\n    const errorWithCause = error as ErrorWithCause;\n    const hasCause = 'cause' in error && errorWithCause.cause !== undefined;\n\n    const errorDetails = isDevelopment ? (\n        <div style={{ marginTop: 16, textAlign: 'left' }}>\n            <Collapse\n                activeKey={showDetails ? ['details'] : []}\n                onChange={(keys) => setShowDetails(keys.includes('details'))}\n                items={[\n                    {\n                        key: 'details',\n                        label: (\n                            <span>\n                                {showDetails ? '▲' : '▼'} 错误详情\n                            </span>\n                        ),\n                        children: (\n                            <div style={{ fontFamily: 'monospace', fontSize: '12px', whiteSpace: 'pre-wrap', wordBreak: 'break-all' }}>\n                                <div style={{ marginBottom: 8, fontWeight: 'bold' }}>错误信息：</div>\n                                <div style={{ marginBottom: 16, color: '#ff4d4f' }}>{error.message}</div>\n                                \n                                {error.stack && (\n                                    <>\n                                        <div style={{ marginBottom: 8, fontWeight: 'bold' }}>堆栈信息：</div>\n                                        <div style={{ marginBottom: 16, color: '#666' }}>{error.stack}</div>\n                                    </>\n                                )}\n                                \n                                {hasCause && (\n                                    <>\n                                        <div style={{ marginBottom: 8, fontWeight: 'bold' }}>原因：</div>\n                                        <div style={{ marginBottom: 16, color: '#666' }}>\n                                            {errorWithCause.cause instanceof Error \n                                                ? errorWithCause.cause.message \n                                                : String(errorWithCause.cause)}\n                                        </div>\n                                    </>\n                                )}\n                            </div>\n                        ),\n                    },\n                ]}\n            />\n        </div>\n    ) : null;\n\n    return (\n        <div className=\"size-full flex-col-center gap-16px overflow-y-scroll flex-col flex justify-center items-center gap-4\">\n            <div className=\"flex text-400px text-primary\">\n                <Result\n                    status=\"error\"\n                    title=\"出错了，请稍后再试\"\n                    subTitle={isDevelopment ? error.message : '请稍后再试或联系技术支持'}\n                    extra={\n                        <div style={{ display: 'flex', gap: 8, flexDirection: 'column', alignItems: 'center' }}>\n                            <Button type=\"primary\" onClick={resetErrorBoundary}>\n                                刷新重试\n                            </Button>\n                            {isDevelopment && (\n                                <Button\n                                    type=\"link\"\n                                    onClick={() => setShowDetails(!showDetails)}\n                                >\n                                    {showDetails ? '▲ 收起详情' : '▼ 展开详情'}\n                                </Button>\n                            )}\n                        </div>\n                    }\n                >\n                    {errorDetails}\n                </Result>\n            </div>\n        </div>\n    );\n};"],"names":["useState","Result","Button","Collapse","isDevelopment","process","env","NODE_ENV","RouteErrorBoundary","error","resetErrorBoundary","showDetails","setShowDetails","errorWithCause","hasCause","cause","undefined","errorDetails","div","style","marginTop","textAlign","activeKey","onChange","keys","includes","items","key","label","span","children","fontFamily","fontSize","whiteSpace","wordBreak","marginBottom","fontWeight","color","message","stack","Error","String","className","status","title","subTitle","extra","display","gap","flexDirection","alignItems","type","onClick"],"mappings":";AAAA,SAASA,QAAQ,QAAQ,QAAQ;AAEjC,SAASC,MAAM,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAEhD,MAAMC,gBAAgBC,QAAQC,GAAG,CAACC,QAAQ,KAAK;AAM/C,OAAO,MAAMC,qBAAqB,CAAC,EAAEC,KAAK,EAAEC,kBAAkB,EAAiB;IAC3E,MAAM,CAACC,aAAaC,eAAe,GAAGZ,SAAS;IAE/C,8BAA8B;IAC9B,sCAAsC;IACtC,yCAAyC;IAEzC,MAAMa,iBAAiBJ;IACvB,MAAMK,WAAW,WAAWL,SAASI,eAAeE,KAAK,KAAKC;IAE9D,MAAMC,eAAeb,8BACjB,KAACc;QAAIC,OAAO;YAAEC,WAAW;YAAIC,WAAW;QAAO;kBAC3C,cAAA,KAAClB;YACGmB,WAAWX,cAAc;gBAAC;aAAU,GAAG,EAAE;YACzCY,UAAU,CAACC,OAASZ,eAAeY,KAAKC,QAAQ,CAAC;YACjDC,OAAO;gBACH;oBACIC,KAAK;oBACLC,qBACI,MAACC;;4BACIlB,cAAc,MAAM;4BAAI;;;oBAGjCmB,wBACI,MAACZ;wBAAIC,OAAO;4BAAEY,YAAY;4BAAaC,UAAU;4BAAQC,YAAY;4BAAYC,WAAW;wBAAY;;0CACpG,KAAChB;gCAAIC,OAAO;oCAAEgB,cAAc;oCAAGC,YAAY;gCAAO;0CAAG;;0CACrD,KAAClB;gCAAIC,OAAO;oCAAEgB,cAAc;oCAAIE,OAAO;gCAAU;0CAAI5B,MAAM6B,OAAO;;4BAEjE7B,MAAM8B,KAAK,kBACR;;kDACI,KAACrB;wCAAIC,OAAO;4CAAEgB,cAAc;4CAAGC,YAAY;wCAAO;kDAAG;;kDACrD,KAAClB;wCAAIC,OAAO;4CAAEgB,cAAc;4CAAIE,OAAO;wCAAO;kDAAI5B,MAAM8B,KAAK;;;;4BAIpEzB,0BACG;;kDACI,KAACI;wCAAIC,OAAO;4CAAEgB,cAAc;4CAAGC,YAAY;wCAAO;kDAAG;;kDACrD,KAAClB;wCAAIC,OAAO;4CAAEgB,cAAc;4CAAIE,OAAO;wCAAO;kDACzCxB,eAAeE,KAAK,YAAYyB,QAC3B3B,eAAeE,KAAK,CAACuB,OAAO,GAC5BG,OAAO5B,eAAeE,KAAK;;;;;;gBAMzD;aACH;;SAGT;IAEJ,qBACI,KAACG;QAAIwB,WAAU;kBACX,cAAA,KAACxB;YAAIwB,WAAU;sBACX,cAAA,KAACzC;gBACG0C,QAAO;gBACPC,OAAM;gBACNC,UAAUzC,gBAAgBK,MAAM6B,OAAO,GAAG;gBAC1CQ,qBACI,MAAC5B;oBAAIC,OAAO;wBAAE4B,SAAS;wBAAQC,KAAK;wBAAGC,eAAe;wBAAUC,YAAY;oBAAS;;sCACjF,KAAChD;4BAAOiD,MAAK;4BAAUC,SAAS1C;sCAAoB;;wBAGnDN,+BACG,KAACF;4BACGiD,MAAK;4BACLC,SAAS,IAAMxC,eAAe,CAACD;sCAE9BA,cAAc,WAAW;;;;0BAMzCM;;;;AAKrB,EAAE"}

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

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "transformRoutesToReactRoutes", {
+    enumerable: true,
+    get: function() {
+        return transformRoutesToReactRoutes;
+    }
+});
+const _jsxruntime = require("react/jsx-runtime");
+const _react = /*#__PURE__*/ _interop_require_default(require("react"));
+const _reactrouterdom = require("react-router-dom");
+const _RouteErrorBoundary = require("./RouteErrorBoundary");
+const _antd = require("antd");
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const transformRoutesToReactRoutes = async (routes, transformResult, defaultRouteErrorComponent, defaultRouteLoadingComponent)=>{
+    /**
+     * 批量处理路由
+     * @param routes 路由组
+     */ function transformRouteToReactRoutes(routes) {
+        return routes.flatMap((route)=>transformRouteToReactRoute(route));
+    }
+    /**
+     * 处理单个路由
+     * @param route 路由
+     */ function transformRouteToReactRoute(route) {
+        const { isGroup = false, enableRedirection = false, name, path, handle, children, page, layout, loading, errors } = route;
+        // 获取错误组件
+        async function getErrorComponent() {
+            // 如果 errors 是函数，直接使用
+            if (typeof errors === 'function') {
+                return errors();
+            }
+            const errorsMap = transformResult.errors;
+            // 判断 errors 是否为 string 且不是空字符串
+            if (typeof errors === 'string' && errors !== '') {
+                // 使用 errors 作为 key 获取 transformResult.errors 的值
+                const errorResolver = errorsMap.get(errors);
+                // 如果获取不到，返回 null
+                if (!errorResolver) {
+                    return null;
+                }
+                // 如果获取到，返回对应的值（调用动态导入函数）
+                if (typeof errorResolver === 'function') {
+                    return errorResolver();
+                }
+                return null;
+            }
+            // 如果 errors 为空，使用配置的默认错误组件或内置的 RouteErrorBoundary 组件
+            if (defaultRouteErrorComponent) {
+                // 如果配置了默认错误组件，使用配置的组件
+                return defaultRouteErrorComponent();
+            }
+            // 如果没有配置默认错误组件，使用内置的 RouteErrorBoundary 组件
+            // 直接导入而非懒加载，因为：
+            // 1. RouteErrorBoundary 是框架核心组件，体积小
+            // 2. 错误边界需要快速响应，直接导入速度更快
+            // 3. 作为基础设施组件，应该保证可用性
+            return {
+                default: _RouteErrorBoundary.RouteErrorBoundary
+            };
+        }
+        // 获取默认加载组件（配置的或内置的 Spin）
+        function getDefaultLoadingComponent() {
+            if (defaultRouteLoadingComponent) {
+                // 如果配置了默认加载组件，使用 React.lazy 包装
+                // 使用懒加载是因为用户可能希望自定义组件支持代码分割
+                return /*#__PURE__*/ _react.default.lazy(()=>defaultRouteLoadingComponent().then((module)=>({
+                            default: module.default || module
+                        })));
+            }
+            // 如果没有配置默认加载组件，使用 antd 的 Spin 作为默认组件
+            // 直接导入而非懒加载，因为：
+            // 1. Spin 是 antd 的基础组件，体积小
+            // 2. 加载组件需要快速显示，直接导入速度更快
+            // 3. 作为基础设施组件，应该保证可用性
+            return _antd.Spin;
+        }
+        // 获取加载组件
+        function getLoadingComponent() {
+            // 如果 loading 是函数，直接使用 React.lazy 包装
+            if (typeof loading === 'function') {
+                return /*#__PURE__*/ _react.default.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.default.lazy(()=>loadingResolver().then((module)=>({
+                                default: module.default || module
+                            })));
+                }
+                // 如果 loadingResolver 不是函数，使用默认加载组件
+                return getDefaultLoadingComponent();
+            }
+            // 如果 loading 为空，使用默认加载组件
+            return getDefaultLoadingComponent();
+        }
+        // 获取转换配置
+        function convertConfig(m) {
+            if (!m) {
+                return null;
+            }
+            const { action, loader, shouldRevalidate, default: Component } = m;
+            // 如果 Component 不存在，记录警告
+            if (!Component) {
+                console.warn(`路由组件未找到 default 导出: ${name}`, m);
+            }
+            return {
+                action,
+                loader,
+                shouldRevalidate,
+                Component
+            };
+        }
+        // 获取配置
+        async function getConfig(index = false) {
+            // 如果有layout和不是index,返回布局配置
+            if (layout && !index) {
+                // 如果 layout 是函数，直接使用
+                if (typeof layout === 'function') {
+                    const config = await layout();
+                    return convertConfig(config);
+                }
+                // 如果 layout 是字符串，从 Map 中获取
+                if (typeof layout === 'string') {
+                    const layoutResolver = transformResult.layouts.get(layout);
+                    if (!layoutResolver) {
+                        throw new Error(`未找到名为 ${layout} 的布局组件`);
+                    }
+                    const config = await layoutResolver();
+                    return convertConfig(config);
+                }
+            }
+            let pageName = name;
+            // 如果是notFound则转成404
+            if (pageName === 'notFound') {
+                pageName = '404';
+            }
+            if (page && (!children?.length || index)) {
+                // 如果 page 是函数，直接使用
+                if (typeof page === 'function') {
+                    const config = await page();
+                    return convertConfig(config);
+                }
+                // 如果 page 是字符串，从 Map 中获取
+                if (typeof page === 'string') {
+                    const viewResolver = transformResult.pages.get(page);
+                    if (!viewResolver) {
+                        throw new Error(`未找到名为 ${page} 的页面组件`);
+                    }
+                    const config = await viewResolver();
+                    return convertConfig(config);
+                }
+            }
+            return null;
+        }
+        // 获取处理信息，即额外的配置信息
+        function getHandle(index = false) {
+            if ((layout || isGroup) && !index) {
+                return null;
+            }
+            return {
+                ...handle,
+                name,
+                path
+            };
+        }
+        const reactRoute = {
+            children: [],
+            HydrateFallback: getLoadingComponent(),
+            id: name,
+            handle: getHandle(),
+            lazy: async ()=>{
+                const ErrorBoundary = await getErrorComponent();
+                const config = await getConfig();
+                // 如果配置为空，确保至少返回一个空对象，避免展开 undefined
+                if (!config) {
+                    return {
+                        ErrorBoundary: ErrorBoundary?.default
+                    };
+                }
+                return {
+                    ErrorBoundary: ErrorBoundary?.default,
+                    ...config
+                };
+            },
+            path
+        };
+        // 处理子路由
+        if (children?.length) {
+            reactRoute.children = children.flatMap((child)=>transformRouteToReactRoute(child)).sort((a, b)=>{
+                const orderA = a.handle?.order ?? 99;
+                const orderB = b.handle?.order ?? 99;
+                return orderA - orderB;
+            });
+            if (page && !isGroup) {
+                reactRoute.children.unshift({
+                    handle: getHandle(true),
+                    index: true,
+                    lazy: async ()=>{
+                        const ErrorBoundary = await getErrorComponent();
+                        return {
+                            ErrorBoundary: ErrorBoundary?.default,
+                            ...await getConfig(true)
+                        };
+                    }
+                });
+            }
+            if (enableRedirection && isGroup) {
+                const [firstChild] = reactRoute.children;
+                if (firstChild?.path) {
+                    reactRoute.children.unshift({
+                        index: true,
+                        handle: getHandle(true),
+                        element: /*#__PURE__*/ (0, _jsxruntime.jsx)(_reactrouterdom.Navigate, {
+                            to: firstChild.path,
+                            replace: true
+                        })
+                    });
+                }
+            }
+        }
+        // 若存在 layout 且没有子路由，但同时声明了 page，则自动生成 index 子路由以渲染页面
+        // 场景：/test 使用自定义 layout，且没有 children 时仍应渲染 page
+        if ((!children || children.length === 0) && layout && page && !isGroup) {
+            reactRoute.children = [
+                {
+                    handle: getHandle(true),
+                    index: true,
+                    lazy: async ()=>{
+                        const ErrorBoundary = await getErrorComponent();
+                        return {
+                            ErrorBoundary: ErrorBoundary?.default,
+                            ...await getConfig(true)
+                        };
+                    }
+                }
+            ];
+        }
+        return reactRoute;
+    }
+    return transformRouteToReactRoutes(routes);
+};
+
+//# sourceMappingURL=transform.js.map

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

@@ -0,0 +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":["transformRoutesToReactRoutes","routes","transformResult","defaultRouteErrorComponent","defaultRouteLoadingComponent","transformRouteToReactRoutes","flatMap","route","transformRouteToReactRoute","isGroup","enableRedirection","name","path","handle","children","page","layout","loading","errors","getErrorComponent","errorsMap","errorResolver","get","default","RouteErrorBoundary","getDefaultLoadingComponent","React","lazy","then","module","Spin","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","Navigate","to","replace"],"mappings":";;;;+BAYaA;;;eAAAA;;;;8DAXK;gCAIX;oCAE4B;sBACd;;;;;;AAId,MAAMA,+BAA+B,OACxCC,QACAC,iBACAC,4BACAC;IAGA;;;KAGC,GACD,SAASC,4BAA4BJ,MAAqB;QACtD,OAAOA,OAAOK,OAAO,CAAC,CAACC,QAAuBC,2BAA2BD;IAC7E;IAEA;;;KAGC,GACD,SAASC,2BAA2BD,KAAkB;QAClD,MAAM,EACFE,UAAU,KAAK,EACfC,oBAAoB,KAAK,EACzBC,IAAI,EACJC,IAAI,EACJC,MAAM,EACNC,QAAQ,EACRC,IAAI,EACJC,MAAM,EACNC,OAAO,EACPC,MAAM,EACT,GAAGX;QAEJ,SAAS;QACT,eAAeY;YACX,qBAAqB;YACrB,IAAI,OAAOD,WAAW,YAAY;gBAC9B,OAAOA;YACX;YAEA,MAAME,YAAYlB,gBAAgBgB,MAAM;YAExC,+BAA+B;YAC/B,IAAI,OAAOA,WAAW,YAAYA,WAAW,IAAI;gBAC7C,gDAAgD;gBAChD,MAAMG,gBAAgBD,UAAUE,GAAG,CAACJ;gBAEpC,iBAAiB;gBACjB,IAAI,CAACG,eAAe;oBAChB,OAAO;gBACX;gBAEA,yBAAyB;gBACzB,IAAI,OAAOA,kBAAkB,YAAY;oBACrC,OAAOA;gBACX;gBAEA,OAAO;YACX;YAEA,qDAAqD;YACrD,IAAIlB,4BAA4B;gBAC5B,sBAAsB;gBACtB,OAAOA;YACX;YAEA,2CAA2C;YAC3C,gBAAgB;YAChB,oCAAoC;YACpC,yBAAyB;YACzB,sBAAsB;YACtB,OAAO;gBAAEoB,SAASC,sCAAkB;YAAC;QACzC;QAEA,yBAAyB;QACzB,SAASC;YACL,IAAIrB,8BAA8B;gBAC9B,+BAA+B;gBAC/B,4BAA4B;gBAC5B,qBAAOsB,cAAK,CAACC,IAAI,CAAC,IAAMvB,+BAA+BwB,IAAI,CAACC,CAAAA,SAAW,CAAA;4BAAEN,SAASM,OAAON,OAAO,IAAIM;wBAAO,CAAA;YAC/G;YACA,qCAAqC;YACrC,gBAAgB;YAChB,2BAA2B;YAC3B,yBAAyB;YACzB,sBAAsB;YACtB,OAAOC,UAAI;QACf;QAEA,SAAS;QACT,SAASC;YACL,oCAAoC;YACpC,IAAI,OAAOd,YAAY,YAAY;gBAC/B,qBAAOS,cAAK,CAACC,IAAI,CAAC,IAAMV,UAAUW,IAAI,CAACC,CAAAA,SAAW,CAAA;4BAAEN,SAASM,OAAON,OAAO,IAAIM;wBAAO,CAAA;YAC1F;YAEA,MAAMG,cAAc9B,gBAAgB+B,QAAQ;YAE5C,gCAAgC;YAChC,IAAI,OAAOhB,YAAY,YAAYA,YAAY,IAAI;gBAC/C,mDAAmD;gBACnD,MAAMiB,kBAAkBF,YAAYV,GAAG,CAACL;gBAExC,kBAAkB;gBAClB,IAAI,CAACiB,iBAAiB;oBAClB,OAAOT;gBACX;gBAEA,+BAA+B;gBAC/B,6DAA6D;gBAC7D,IAAI,OAAOS,oBAAoB,YAAY;oBACvC,qBAAOR,cAAK,CAACC,IAAI,CAAC,IAAMO,kBAAkBN,IAAI,CAACC,CAAAA,SAAW,CAAA;gCAAEN,SAASM,OAAON,OAAO,IAAIM;4BAAO,CAAA;gBAClG;gBAEA,mCAAmC;gBACnC,OAAOJ;YACX;YAEA,yBAAyB;YACzB,OAAOA;QACX;QAEA,SAAS;QACT,SAASU,cAAcC,CAAM;YACzB,IAAI,CAACA,GAAG;gBACJ,OAAO;YACX;YACA,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAEC,gBAAgB,EAAEhB,SAASiB,SAAS,EAAE,GAAGJ;YAEjE,wBAAwB;YACxB,IAAI,CAACI,WAAW;gBACZC,QAAQC,IAAI,CAAC,CAAC,oBAAoB,EAAE/B,MAAM,EAAEyB;YAChD;YAEA,OAAO;gBACHC;gBACAC;gBACAC;gBACAC;YACJ;QACJ;QAEA,OAAO;QACP,eAAeG,UAAUC,QAAiB,KAAK;YAC3C,2BAA2B;YAC3B,IAAI5B,UAAU,CAAC4B,OAAO;gBAClB,qBAAqB;gBACrB,IAAI,OAAO5B,WAAW,YAAY;oBAC9B,MAAM6B,SAAS,MAAM7B;oBACrB,OAAOmB,cAAcU;gBACzB;gBAEA,2BAA2B;gBAC3B,IAAI,OAAO7B,WAAW,UAAU;oBAC5B,MAAM8B,iBAAiB5C,gBAAgB6C,OAAO,CAACzB,GAAG,CAACN;oBACnD,IAAI,CAAC8B,gBAAgB;wBACjB,MAAM,IAAIE,MAAM,CAAC,MAAM,EAAEhC,OAAO,MAAM,CAAC;oBAC3C;oBACA,MAAM6B,SAAS,MAAMC;oBACrB,OAAOX,cAAcU;gBACzB;YACJ;YAEA,IAAII,WAAWtC;YAEf,oBAAoB;YACpB,IAAIsC,aAAa,YAAY;gBACzBA,WAAW;YACf;YAEA,IAAIlC,QAAS,CAAA,CAACD,UAAUoC,UAAUN,KAAI,GAAI;gBACtC,mBAAmB;gBACnB,IAAI,OAAO7B,SAAS,YAAY;oBAC5B,MAAM8B,SAAS,MAAM9B;oBACrB,OAAOoB,cAAcU;gBACzB;gBAEA,yBAAyB;gBACzB,IAAI,OAAO9B,SAAS,UAAU;oBAC1B,MAAMoC,eAAejD,gBAAgBkD,KAAK,CAAC9B,GAAG,CAACP;oBAC/C,IAAI,CAACoC,cAAc;wBACf,MAAM,IAAIH,MAAM,CAAC,MAAM,EAAEjC,KAAK,MAAM,CAAC;oBACzC;oBACA,MAAM8B,SAAS,MAAMM;oBACrB,OAAOhB,cAAcU;gBACzB;YACJ;YAEA,OAAO;QACX;QAEA,kBAAkB;QAClB,SAASQ,UAAUT,QAAiB,KAAK;YACrC,IAAI,AAAC5B,CAAAA,UAAUP,OAAM,KAAM,CAACmC,OAAO;gBAC/B,OAAO;YACX;YACA,OAAO;gBACH,GAAG/B,MAAM;gBACTF;gBACAC;YACJ;QACJ;QAGA,MAAM0C,aAA0B;YAC5BxC,UAAU,EAAE;YACZyC,iBAAiBxB;YACjByB,IAAI7C;YACJE,QAAQwC;YACR1B,MAAM;gBACF,MAAM8B,gBAAgB,MAAMtC;gBAC5B,MAAM0B,SAAS,MAAMF;gBAErB,oCAAoC;gBACpC,IAAI,CAACE,QAAQ;oBACT,OAAO;wBACHY,eAAeA,eAAelC;oBAClC;gBACJ;gBAEA,OAAO;oBACHkC,eAAeA,eAAelC;oBAC9B,GAAGsB,MAAM;gBACb;YACJ;YACAjC;QACJ;QAEA,QAAQ;QACR,IAAIE,UAAUoC,QAAQ;YAClBI,WAAWxC,QAAQ,GAAGA,SAASR,OAAO,CAACoD,CAAAA,QAASlD,2BAA2BkD,QAAQC,IAAI,CAAC,CAACC,GAAGC;gBACxF,MAAMC,SAASF,EAAE/C,MAAM,EAAEkD,SAAS;gBAClC,MAAMC,SAASH,EAAEhD,MAAM,EAAEkD,SAAS;gBAClC,OAAOD,SAASE;YACpB;YAEA,IAAIjD,QAAQ,CAACN,SAAS;gBAClB6C,WAAWxC,QAAQ,CAACmD,OAAO,CAAC;oBACxBpD,QAAQwC,UAAU;oBAClBT,OAAO;oBACPjB,MAAM;wBACF,MAAM8B,gBAAgB,MAAMtC;wBAC5B,OAAO;4BACHsC,eAAeA,eAAelC;4BAC9B,GAAI,MAAMoB,UAAU,KAAK;wBAC7B;oBACJ;gBACJ;YACJ;YAEA,IAAIjC,qBAAqBD,SAAS;gBAC9B,MAAM,CAACyD,WAAW,GAAGZ,WAAWxC,QAAQ;gBACxC,IAAIoD,YAAYtD,MAAM;oBAClB0C,WAAWxC,QAAQ,CAACmD,OAAO,CAAC;wBACxBrB,OAAO;wBACP/B,QAAQwC,UAAU;wBAClBc,uBAAS,qBAACC,wBAAQ;4BAACC,IAAIH,WAAWtD,IAAI;4BAAY0D,OAAO;;oBAC7D;gBACJ;YACJ;QAEJ;QACA,qDAAqD;QACrD,gDAAgD;QAChD,IAAI,AAAC,CAAA,CAACxD,YAAYA,SAASoC,MAAM,KAAK,CAAA,KAAMlC,UAAUD,QAAQ,CAACN,SAAS;YACpE6C,WAAWxC,QAAQ,GAAG;gBAAC;oBACnBD,QAAQwC,UAAU;oBAClBT,OAAO;oBACPjB,MAAM;wBACF,MAAM8B,gBAAgB,MAAMtC;wBAC5B,OAAO;4BACHsC,eAAeA,eAAelC;4BAC9B,GAAI,MAAMoB,UAAU,KAAK;wBAC7B;oBACJ;gBACJ;aAAE;QACN;QAEA,OAAOW;IACX;IAEA,OAAOjD,4BAA4BJ;AACvC"}

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

@@ -0,0 +1,6 @@
+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[]>;
+//# sourceMappingURL=transform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../../../src/core/router/utils/adapters/react-router/transform.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EACH,KAAK,WAAW,EAEnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtD,eAAO,MAAM,4BAA4B,GACrC,QAAQ,WAAW,EAAE,EACrB,iBAAiB,qBAAqB,EACtC,6BAA6B,eAAe,EAC5C,+BAA+B,eAAe,KAC/C,OAAO,CAAC,WAAW,EAAE,CAqRvB,CAAA"}