@vlian/framework 1.2.62 → 2.0.1

package/dist/core-bak/router/types.d.ts

@@ -1,464 +0,0 @@
-import type { AppInstance } from '../startup/AppInstance';
-import type { createBrowserRouter, createMemoryRouter } from 'react-router-dom';
-import type { TransformOptions } from './utils/transform';
-import type { PreloadConfig } from './performance/RoutePreloader';
-export type RouteItemHandle = {
-    title: string;
-    i18nKey?: string;
-    order: number;
-    icon?: string;
-    hideInMenu?: boolean;
-    hideFooter?: boolean;
-    keepAlive?: boolean;
-    needLogin?: boolean;
-    roles?: Array<string>;
-    name?: string;
-    [key: string]: unknown;
-};
-export type RouteItem = {
-    layout?: string | ComponentImport | null;
-    page?: string | ComponentImport | null;
-    loading?: string | ComponentImport | null;
-    errors?: string | ComponentImport | null;
-    error?: string | ComponentImport | null;
-    name: string;
-    path: string | undefined;
-    isGroup?: boolean;
-    enableRedirection?: boolean;
-    handle: RouteItemHandle;
-    children?: RouteItem[];
-};
-export type RouteMapType = Record<string, () => Promise<any>>;
-/**
- * DOM 路由选项类型（从 createBrowserRouter 和 createHashRouter 的参数类型提取）
- */
-export type DOMRouterOpts = Parameters<typeof createBrowserRouter>[1];
-/**
- * Memory 路由选项类型（从 createMemoryRouter 的参数类型提取）
- */
-export type MemoryRouterOpts = Parameters<typeof createMemoryRouter>[1];
-/**
- * 路由元数据（兼容 RouteItemHandle）
- *
- * @deprecated 建议直接使用 RouteItem 和 RouteItemHandle
- */
-export interface RouteMeta {
-    /**
-     * 路由标题
-     */
-    title?: string;
-    /**
-     * 图标
-     */
-    icon?: string;
-    /**
-     * 排序
-     */
-    order?: number;
-    /**
-     * 权限标识
-     */
-    auth?: string | string[];
-    /**
-     * 是否在菜单中隐藏
-     */
-    hideInMenu?: boolean;
-    /**
-     * 是否启用 KeepAlive
-     */
-    keepAlive?: boolean;
-    /**
-     * 是否需要登录
-     */
-    needLogin?: boolean;
-    /**
-     * 角色列表
-     */
-    roles?: string[];
-    /**
-     * 路由名称（唯一标识）
-     */
-    name?: string;
-    /**
-     * 其他自定义元数据
-     */
-    [key: string]: unknown;
-}
-/**
- * 动态导入函数类型
- *
- * 用于懒加载组件，返回一个 Promise，resolve 后的值为组件模块对象
- * 组件必须使用默认导出（export default）
- */
-export type ComponentImport = () => Promise<any>;
-/**
- * 路由配置项
- *
- * 与 RouteItem 的区别：
- * - layout、page、loading、error/errors 可以是组件路径字符串（如 "@/pages/index.ts"）或动态导入函数
- * - 如果使用字符串，系统会自动转换为动态导入函数
- * - 如果使用函数，则直接使用，无需转换
- * - 对应的组件必须默认导出（export default xxxx）
- */
-export interface RouteConfig {
-    /**
-     * 布局组件路径（字符串）或动态导入函数
-     *
-     * 字符串示例： "@/pages/layout.tsx" 或 "../../pages/layout.tsx"
-     * 函数示例： () => import("@/pages/layout.tsx")
-     * 组件必须默认导出
-     */
-    layout?: string | ComponentImport | null;
-    /**
-     * 页面组件路径（字符串）或动态导入函数
-     *
-     * 字符串示例： "@/pages/index.tsx" 或 "../../pages/index.tsx"
-     * 函数示例： () => import("@/pages/index.tsx")
-     * 组件必须默认导出
-     */
-    page?: string | ComponentImport | null;
-    /**
-     * 加载组件路径（字符串）或动态导入函数
-     *
-     * 字符串示例： "@/components/Loading.tsx"
-     * 函数示例： () => import("@/components/Loading.tsx")
-     * 组件必须默认导出
-     */
-    loading?: string | ComponentImport | null;
-    /**
-     * 错误组件路径（字符串）或动态导入函数
-     *
-     * 字符串示例： "@/pages/error.tsx"
-     * 函数示例： () => import("@/pages/error.tsx")
-     * 组件必须默认导出
-     */
-    errors?: string | ComponentImport | null;
-    /**
-     * 错误组件路径（字符串）或动态导入函数（兼容字段，优先级高于 errors）
-     *
-     * 字符串示例： "@/pages/error.tsx"
-     * 函数示例： () => import("@/pages/error.tsx")
-     * 组件必须默认导出
-     */
-    error?: string | ComponentImport | null;
-    /**
-     * 路由名称（唯一标识）
-     */
-    name: string;
-    /**
-     * 路由路径
-     */
-    path: string | undefined;
-    /**
-     * 是否为路由组
-     */
-    isGroup?: boolean;
-    /**
-     * 是否启用重定向
-     */
-    enableRedirection?: boolean;
-    /**
-     * 路由元数据
-     */
-    handle: {
-        title: string;
-        i18nKey?: string;
-        order: number;
-        icon?: string;
-        hideInMenu?: boolean;
-        hideFooter?: boolean;
-        keepAlive?: boolean;
-        needLogin?: boolean;
-        roles?: Array<string>;
-        name?: string;
-        [key: string]: unknown;
-    };
-    /**
-     * 子路由配置
-     */
-    children?: RouteConfig[];
-}
-/**
- * 路由位置信息
- */
-export interface RouteLocation {
-    /**
-     * 路径
-     */
-    path: string;
-    /**
-     * 路径参数
-     */
-    params?: Record<string, unknown>;
-    /**
-     * 查询参数
-     */
-    query?: Record<string, unknown>;
-    /**
-     * 路由元数据
-     */
-    meta?: RouteMeta;
-}
-/**
- * 导航选项
- */
-export interface NavigateOptions {
-    /**
-     * 是否替换当前历史记录
-     */
-    replace?: boolean;
-    /**
-     * 状态数据
-     */
-    state?: unknown;
-    /**
-     * 查询参数
-     */
-    query?: Record<string, unknown>;
-}
-/**
- * 路由生命周期钩子
- */
-export interface RouteLifecycleHooks {
-    /**
-     * 路由跳转前钩子
-     *
-     * @param to - 目标路由
-     * @param from - 来源路由
-     * @returns 如果返回字符串，则跳转到该路径；如果返回 false，则阻止跳转；返回 true 或 undefined 则继续跳转
-     */
-    beforeEach?: (to: RouteLocation, from?: RouteLocation) => string | false | void | Promise<string | false | void>;
-    /**
-     * 路由跳转后钩子
-     *
-     * @param to - 目标路由
-     * @param from - 来源路由
-     */
-    afterEach?: (to: RouteLocation, from?: RouteLocation) => void | Promise<void>;
-}
-/**
- * 路由模式
- *
- * 对应 react-router-dom 的路由模式：
- * - `browser`: 使用 BrowserRouter（createBrowserRouter）
- * - `hash`: 使用 HashRouter（createHashRouter）
- * - `memory`: 使用 MemoryRouter（createMemoryRouter）
- */
-export type RouterMode = 'browser' | 'hash' | 'memory';
-/**
- * 应用路由接口
- *
- * 这是框架核心依赖的抽象接口，所有路由实现都必须实现此接口
- */
-export interface AppRouter {
-    /**
-     * 挂载到应用实例
-     *
-     * @param app - 应用实例
-     */
-    mount(app: AppInstance): void;
-    /**
-     * 路由跳转
-     *
-     * @param to - 目标路径或路由名称
-     * @param options - 导航选项
-     */
-    navigate(to: string, options?: NavigateOptions): void;
-    /**
-     * 获取当前路由信息
-     *
-     * @returns 当前路由位置信息
-     */
-    getCurrentRoute(): RouteLocation;
-    /**
-     * 销毁路由实例（可选）
-     */
-    destroy?(): void;
-}
-/**
- * 路径解析配置
- */
-export interface PathResolveConfig {
-    /**
-     * 项目根目录路径
-     *
-     * 用于解析相对路径的基准目录。
-     * 如果不提供，将使用调用框架的项目根目录（通常为 process.cwd()）。
-     *
-     * 注意：路径解析主要由构建工具（如 Vite、Webpack）处理，
-     * 此配置主要用于文档和错误提示。
-     *
-     * @example
-     * ```typescript
-     * router: {
-     *   pathResolve: {
-     *     basePath: '/path/to/project',
-     *   },
-     * }
-     * ```
-     */
-    basePath?: string;
-    /**
-     * 路径别名映射
-     *
-     * 用于将路径别名（如 @/）映射到实际路径。
-     * 如果不提供，将使用构建工具的配置（如 vite.config.ts 中的 resolve.alias）。
-     *
-     * 注意：路径别名解析主要由构建工具处理，
-     * 此配置主要用于文档和错误提示。
-     *
-     * @example
-     * ```typescript
-     * router: {
-     *   pathResolve: {
-     *     pathAliases: {
-     *       '@': './src',
-     *       '@components': './src/components',
-     *     },
-     *   },
-     * }
-     * ```
-     */
-    pathAliases?: Record<string, string>;
-}
-/**
- * 路由配置选项
- */
-export interface RouterConfig {
-    /**
-     * 是否启用路由
-     *
-     * - `true`: 启用内置路由（默认）
-     * - `false`: 禁用内置路由，使用自定义路由
-     * - `'disabled'`: 完全禁用路由
-     *
-     * @default true
-     */
-    enabled?: boolean | 'disabled';
-    /**
-     * 路由配置列表
-     *
-     * 使用 RouteConfig 类型
-     *
-     * 注意：RouteConfig 中的 layout、page、loading、error/errors 可以是：
-     * - 组件路径字符串：系统会自动转换为动态导入函数
-     * - 动态导入函数：直接使用，无需转换
-     *
-     * 路径字符串可以是：
-     * - 相对路径：如 `"./pages/index.tsx"`、`"../components/Layout.tsx"`
-     * - 路径别名：如 `"@/pages/index.tsx"`（需要在构建工具中配置，如 vite.config.ts）
-     * - 绝对路径：如 `"/src/pages/index.tsx"`（不推荐）
-     *
-     * 动态导入函数示例：
-     * - `() => import("./pages/index.tsx")`
-     * - `() => import("@/pages/index.tsx")`
-     *
-     * 路径解析由构建工具（如 Vite、Webpack）处理，框架会在运行时验证组件是否有默认导出。
-     */
-    routes?: RouteConfig[] | (() => RouteConfig[] | Promise<RouteConfig[]>);
-    /**
-     * 路由模式
-     *
-     * - `browser`: 使用 BrowserRouter（createBrowserRouter）- 默认
-     * - `hash`: 使用 HashRouter（createHashRouter）
-     * - `memory`: 使用 MemoryRouter（createMemoryRouter）
-     *
-     * @default 'browser'
-     */
-    mode?: RouterMode;
-    /**
-     * 路由选项
-     *
-     * 传递给 react-router-dom 的路由创建方法的选项
-     * - `browser` 和 `hash` 模式使用 `DOMRouterOpts`
-     * - `memory` 模式使用 `MemoryRouterOpts`
-     */
-    options?: DOMRouterOpts | MemoryRouterOpts;
-    /**
-     * 路径解析配置
-     *
-     * 用于配置路径解析选项，主要用于文档和错误提示。
-     * 实际的路径解析由构建工具（如 Vite、Webpack）处理。
-     */
-    pathResolve?: PathResolveConfig;
-    /**
-     * 转换选项
-     *
-     * 用于配置转换选项，主要用于转换路由配置。
-     */
-    transformOptions?: TransformOptions;
-    /**
-     * 路由预加载配置
-     *
-     * 默认策略为 `none`，即按需懒加载路由组件。
-     * 如需预加载，可显式配置 `strategy` 为 `next-level` / `visible` / `all`。
-     */
-    preload?: PreloadConfig;
-    /**
-     * 路由生命周期钩子
-     */
-    hooks?: RouteLifecycleHooks;
-    /**
-     * 是否启用配置验证（默认 true）
-     *
-     * 如果为 false，将跳过路由配置的 Zod 验证
-     */
-    enableValidation?: boolean;
-    /**
-     * 默认路由错误组件
-     *
-     * 当路由配置中的 `error`/`errors` 为空时，将使用此组件作为错误边界。
-     * 如果不提供，将使用框架内置的 `RouteErrorBoundary` 组件。
-     *
-     * 组件必须使用默认导出（export default）。
-     *
-     * @example
-     * ```typescript
-     * router: {
-     *   defaultRouteErrorComponent: () => import('./components/CustomErrorBoundary'),
-     *   routes: [
-     *     {
-     *       name: 'home',
-     *       path: '/',
-     *       page: './pages/Home',
-     *       // error/errors 为空时，将使用 defaultRouteErrorComponent
-     *     },
-     *   ],
-     * },
-     * ```
-     */
-    defaultRouteErrorComponent?: ComponentImport;
-    /**
-     * 默认路由加载组件
-     *
-     * 当路由配置中的 `loading` 为空时，将使用此组件作为加载指示器。
-     * 如果不提供，将使用框架内置 Loading 组件。
-     *
-     * 组件必须使用默认导出（export default）。
-     *
-     * @example
-     * ```typescript
-     * router: {
-     *   defaultRouteLoadingComponent: () => import('./components/CustomLoading'),
-     *   routes: [
-     *     {
-     *       name: 'home',
-     *       path: '/',
-     *       page: './pages/Home',
-     *       // loading 为空时，将使用 defaultRouteLoadingComponent
-     *     },
-     *   ],
-     * },
-     * ```
-     */
-    defaultRouteLoadingComponent?: ComponentImport;
-    /**
-     * 是否为路由注入 hydrateFallbackElement
-     *
-     * 默认关闭。仅在 SSR hydration 场景需要时开启。
-     * 若未显式配置，会根据 `options.hydrationData` 自动推断。
-     *
-     * @default false
-     */
-    enableHydrateFallback?: boolean;
-}

package/dist/core-bak/router/types.js

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

package/dist/core-bak/router/utils/adapters/react-router/RouteErrorBoundary.cjs

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"RouteErrorBoundary",{enumerable:true,get:function(){return RouteErrorBoundary}});const _jsxruntime=require("react/jsx-runtime");const _react=require("react");const isDevelopment=process.env.NODE_ENV==="development";const RouteErrorBoundary=({error,resetErrorBoundary})=>{const[showDetails,setShowDetails]=(0,_react.useState)(false);const errorObject=error!==null&&typeof error==="object"?error:null;const errorMessage=typeof errorObject?.message==="string"&&errorObject.message!==""?errorObject.message:"未知错误";const hasCause=errorObject?.cause!==undefined;const isNotFoundError=errorObject?.status===404||typeof errorObject?.statusText==="string"&&/not\s*found/i.test(errorObject.statusText)||/no routes matched location|not found|404/i.test(errorMessage);const title=isNotFoundError?"页面不存在（404）":"出错了，请稍后再试";const friendlyMessage=isNotFoundError?"访问的路由未注册或不存在，请检查访问地址。":"请稍后再试或联系技术支持";const displayMessage=isDevelopment?errorMessage:friendlyMessage;return(0,_jsxruntime.jsx)("div",{role:"alert",style:{minHeight:"100vh",display:"flex",justifyContent:"center",alignItems:"center",padding:24},children:(0,_jsxruntime.jsxs)("div",{style:{maxWidth:760,width:"100%",border:"1px solid #dde5ec",borderRadius:10,padding:20},children:[(0,_jsxruntime.jsx)("h2",{style:{marginTop:0},children:title}),(0,_jsxruntime.jsx)("p",{children:displayMessage}),(0,_jsxruntime.jsxs)("div",{style:{display:"flex",gap:8,marginBottom:12},children:[(0,_jsxruntime.jsx)("button",{onClick:resetErrorBoundary,style:{border:"none",background:"#2f80ed",color:"#fff",borderRadius:6,padding:"8px 12px",cursor:"pointer"},children:"刷新重试"}),isDevelopment&&(0,_jsxruntime.jsx)("button",{onClick:()=>setShowDetails(!showDetails),style:{border:"1px solid #cfd7df",background:"#fff",borderRadius:6,padding:"8px 12px",cursor:"pointer"},children:showDetails?"收起详情":"展开详情"})]}),isDevelopment&&showDetails&&(0,_jsxruntime.jsxs)("div",{style:{background:"#f7fafc",borderRadius:8,padding:12,fontSize:12,fontFamily:"monospace"},children:[(0,_jsxruntime.jsxs)("div",{style:{marginBottom:10},children:[(0,_jsxruntime.jsx)("strong",{children:"错误信息："}),errorMessage]}),errorObject?.stack&&(0,_jsxruntime.jsxs)("div",{style:{marginBottom:10,whiteSpace:"pre-wrap",wordBreak:"break-word"},children:[(0,_jsxruntime.jsx)("strong",{children:"堆栈："}),(0,_jsxruntime.jsx)("br",{}),errorObject.stack]}),hasCause&&(0,_jsxruntime.jsxs)("div",{children:[(0,_jsxruntime.jsx)("strong",{children:"原因："}),errorObject?.cause instanceof Error?errorObject.cause.message:String(errorObject?.cause)]})]})]})})};

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

@@ -1,2 +0,0 @@
-import type { FallbackProps } from 'react-error-boundary';
-export declare const RouteErrorBoundary: ({ error, resetErrorBoundary }: FallbackProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1 +0,0 @@
-import{jsx as _jsx,jsxs as _jsxs}from"react/jsx-runtime";import{useState}from"react";const isDevelopment=process.env.NODE_ENV==="development";export const RouteErrorBoundary=({error,resetErrorBoundary})=>{const[showDetails,setShowDetails]=useState(false);const errorObject=error!==null&&typeof error==="object"?error:null;const errorMessage=typeof errorObject?.message==="string"&&errorObject.message!==""?errorObject.message:"未知错误";const hasCause=errorObject?.cause!==undefined;const isNotFoundError=errorObject?.status===404||typeof errorObject?.statusText==="string"&&/not\s*found/i.test(errorObject.statusText)||/no routes matched location|not found|404/i.test(errorMessage);const title=isNotFoundError?"页面不存在（404）":"出错了，请稍后再试";const friendlyMessage=isNotFoundError?"访问的路由未注册或不存在，请检查访问地址。":"请稍后再试或联系技术支持";const displayMessage=isDevelopment?errorMessage:friendlyMessage;return _jsx("div",{role:"alert",style:{minHeight:"100vh",display:"flex",justifyContent:"center",alignItems:"center",padding:24},children:_jsxs("div",{style:{maxWidth:760,width:"100%",border:"1px solid #dde5ec",borderRadius:10,padding:20},children:[_jsx("h2",{style:{marginTop:0},children:title}),_jsx("p",{children:displayMessage}),_jsxs("div",{style:{display:"flex",gap:8,marginBottom:12},children:[_jsx("button",{onClick:resetErrorBoundary,style:{border:"none",background:"#2f80ed",color:"#fff",borderRadius:6,padding:"8px 12px",cursor:"pointer"},children:"刷新重试"}),isDevelopment&&_jsx("button",{onClick:()=>setShowDetails(!showDetails),style:{border:"1px solid #cfd7df",background:"#fff",borderRadius:6,padding:"8px 12px",cursor:"pointer"},children:showDetails?"收起详情":"展开详情"})]}),isDevelopment&&showDetails&&_jsxs("div",{style:{background:"#f7fafc",borderRadius:8,padding:12,fontSize:12,fontFamily:"monospace"},children:[_jsxs("div",{style:{marginBottom:10},children:[_jsx("strong",{children:"错误信息："}),errorMessage]}),errorObject?.stack&&_jsxs("div",{style:{marginBottom:10,whiteSpace:"pre-wrap",wordBreak:"break-word"},children:[_jsx("strong",{children:"堆栈："}),_jsx("br",{}),errorObject.stack]}),hasCause&&_jsxs("div",{children:[_jsx("strong",{children:"原因："}),errorObject?.cause instanceof Error?errorObject.cause.message:String(errorObject?.cause)]})]})]})})};

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

@@ -1 +0,0 @@
-"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 _reactrouterdom=require("react-router-dom");const _RouteErrorBoundary=require("./RouteErrorBoundary");const _logger=require("@vlian/logger");function DefaultRouteHydrateFallback(){return(0,_jsxruntime.jsx)("div",{style:{padding:16,textAlign:"center",color:"#5f6c7b"},children:"Loading..."})}const transformRoutesToReactRoutes=async(routes,transformResult,defaultRouteErrorComponent,defaultRouteLoadingComponent,enableHydrateFallback=false)=>{function transformRouteToReactRoutes(routes){return routes.flatMap(route=>transformRouteToReactRoute(route))}function transformRouteToReactRoute(route){const{isGroup=false,enableRedirection=false,name,path,handle,children,page,layout,error,errors,loading}=route;const routeError=error??errors;async function getErrorComponent(){if(typeof routeError==="function"){return routeError()}const errorsMap=transformResult.errors;if(typeof routeError==="string"&&routeError!==""){const errorResolver=errorsMap.get(routeError);if(!errorResolver){return null}if(typeof errorResolver==="function"){return errorResolver()}return null}if(defaultRouteErrorComponent){return defaultRouteErrorComponent()}return{default:_RouteErrorBoundary.RouteErrorBoundary}}function convertConfig(m){if(!m){return null}const{action,loader,shouldRevalidate,default:Component}=m;if(!Component){_logger.logger.warn(`路由组件未找到 default 导出: ${name}`,m)}return{action,loader,shouldRevalidate,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){if(layout&&!index){if(typeof layout==="function"){const config=await layout();return convertConfig(config)}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;if(pageName==="notFound"){pageName="404"}if(page&&(!children?.length||index)){if(typeof page==="function"){const config=await page();return convertConfig(config)}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:[],id:name,handle:getHandle(),lazy:async()=>{const ErrorBoundary=await getErrorComponent();const config=await getConfig();const LoadingComponent=await getLoadingComponent();const HydrateFallback=LoadingComponent?.default??DefaultRouteHydrateFallback;if(!config){return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback}}return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback,...config}},path};if(enableHydrateFallback){reactRoute.hydrateFallbackElement=(0,_jsxruntime.jsx)(DefaultRouteHydrateFallback,{})}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();const LoadingComponent=await getLoadingComponent();const HydrateFallback=LoadingComponent?.default??DefaultRouteHydrateFallback;const Component=page;return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback,Component,...await getConfig(true)}}})}if(enableRedirection&&isGroup){const[firstChild]=reactRoute.children;if(firstChild?.path){reactRoute.children.unshift({index:true,handle:getHandle(true),element:(0,_jsxruntime.jsx)(_reactrouterdom.Navigate,{to:firstChild.path,replace:true})})}}}if((!children||children.length===0)&&layout&&page&&!isGroup){reactRoute.children=[{handle:getHandle(true),index:true,lazy:async()=>{const ErrorBoundary=await getErrorComponent();const LoadingComponent=await getLoadingComponent();const HydrateFallback=LoadingComponent?.default??DefaultRouteHydrateFallback;const Component=page;return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback,Component,...await getConfig(true)}}}]}return reactRoute}return transformRouteToReactRoutes(routes)};

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

@@ -1,5 +0,0 @@
-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, enableHydrateFallback?: boolean) => Promise<RouteObject[]>;

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

@@ -1 +0,0 @@
-import{jsx as _jsx}from"react/jsx-runtime";import{Navigate}from"react-router-dom";import{RouteErrorBoundary}from"./RouteErrorBoundary";import{logger}from"@vlian/logger";function DefaultRouteHydrateFallback(){return _jsx("div",{style:{padding:16,textAlign:"center",color:"#5f6c7b"},children:"Loading..."})}export const transformRoutesToReactRoutes=async(routes,transformResult,defaultRouteErrorComponent,defaultRouteLoadingComponent,enableHydrateFallback=false)=>{function transformRouteToReactRoutes(routes){return routes.flatMap(route=>transformRouteToReactRoute(route))}function transformRouteToReactRoute(route){const{isGroup=false,enableRedirection=false,name,path,handle,children,page,layout,error,errors,loading}=route;const routeError=error??errors;async function getErrorComponent(){if(typeof routeError==="function"){return routeError()}const errorsMap=transformResult.errors;if(typeof routeError==="string"&&routeError!==""){const errorResolver=errorsMap.get(routeError);if(!errorResolver){return null}if(typeof errorResolver==="function"){return errorResolver()}return null}if(defaultRouteErrorComponent){return defaultRouteErrorComponent()}return{default:RouteErrorBoundary}}function convertConfig(m){if(!m){return null}const{action,loader,shouldRevalidate,default:Component}=m;if(!Component){logger.warn(`路由组件未找到 default 导出: ${name}`,m)}return{action,loader,shouldRevalidate,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){if(layout&&!index){if(typeof layout==="function"){const config=await layout();return convertConfig(config)}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;if(pageName==="notFound"){pageName="404"}if(page&&(!children?.length||index)){if(typeof page==="function"){const config=await page();return convertConfig(config)}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:[],id:name,handle:getHandle(),lazy:async()=>{const ErrorBoundary=await getErrorComponent();const config=await getConfig();const LoadingComponent=await getLoadingComponent();const HydrateFallback=LoadingComponent?.default??DefaultRouteHydrateFallback;if(!config){return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback}}return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback,...config}},path};if(enableHydrateFallback){reactRoute.hydrateFallbackElement=_jsx(DefaultRouteHydrateFallback,{})}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();const LoadingComponent=await getLoadingComponent();const HydrateFallback=LoadingComponent?.default??DefaultRouteHydrateFallback;const Component=page;return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback,Component,...await getConfig(true)}}})}if(enableRedirection&&isGroup){const[firstChild]=reactRoute.children;if(firstChild?.path){reactRoute.children.unshift({index:true,handle:getHandle(true),element:_jsx(Navigate,{to:firstChild.path,replace:true})})}}}if((!children||children.length===0)&&layout&&page&&!isGroup){reactRoute.children=[{handle:getHandle(true),index:true,lazy:async()=>{const ErrorBoundary=await getErrorComponent();const LoadingComponent=await getLoadingComponent();const HydrateFallback=LoadingComponent?.default??DefaultRouteHydrateFallback;const Component=page;return{ErrorBoundary:ErrorBoundary?.default,HydrateFallback,Component,...await getConfig(true)}}}]}return reactRoute}return transformRouteToReactRoutes(routes)};

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

@@ -1 +0,0 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});Object.defineProperty(exports,"transformRoutes",{enumerable:true,get:function(){return transformRoutes}});const _logger=require("@vlian/logger");const _utils=require("@vlian/utils");function _define_property(obj,key,value){if(key in obj){Object.defineProperty(obj,key,{value:value,enumerable:true,configurable:true,writable:true})}else{obj[key]=value}return obj}function _getRequireWildcardCache(nodeInterop){if(typeof WeakMap!=="function")return null;var cacheBabelInterop=new WeakMap;var cacheNodeInterop=new WeakMap;return(_getRequireWildcardCache=function(nodeInterop){return nodeInterop?cacheNodeInterop:cacheBabelInterop})(nodeInterop)}function _interop_require_wildcard(obj,nodeInterop){if(!nodeInterop&&obj&&obj.__esModule){return obj}if(obj===null||typeof obj!=="object"&&typeof obj!=="function"){return{default:obj}}var cache=_getRequireWildcardCache(nodeInterop);if(cache&&cache.has(obj)){return cache.get(obj)}var newObj={__proto__:null};var hasPropertyDescriptor=Object.defineProperty&&Object.getOwnPropertyDescriptor;for(var key in obj){if(key!=="default"&&Object.prototype.hasOwnProperty.call(obj,key)){var desc=hasPropertyDescriptor?Object.getOwnPropertyDescriptor(obj,key):null;if(desc&&(desc.get||desc.set)){Object.defineProperty(newObj,key,desc)}else{newObj[key]=obj[key]}}}newObj.default=obj;if(cache){cache.set(obj,newObj)}return newObj}let LRUCache=class LRUCache{get(key){const item=this.cache.get(key);if(item){item.accessTime=Date.now();this.cache.delete(key);this.cache.set(key,item)}return item}set(key,value){if(this.cache.has(key)){this.cache.delete(key)}else if(this.cache.size>=this.maxSize){const firstKey=this.cache.keys().next().value;if(firstKey){this.cache.delete(firstKey)}}value.accessTime=Date.now();this.cache.set(key,value)}delete(key){return this.cache.delete(key)}clear(){this.cache.clear()}size(){return this.cache.size}cleanupExpired(cacheTTL){const now=Date.now();for(const[key,item]of this.cache.entries()){if(now-item.timestamp>cacheTTL){this.cache.delete(key)}}}constructor(maxSize=50){_define_property(this,"cache",new Map);_define_property(this,"maxSize",void 0);this.maxSize=maxSize}};let transformCache=null;const DEFAULT_OPTIONS={pathValidation:{enablePathValidation:true,allowedPathPrefixes:["@/","./","../"],maxPathLength:500,allowAbsolutePaths:false},performance:{enableCache:true,cacheTTL:5*60*1e3,maxCacheSize:50,maxRecursionDepth:100,enableParallelProcessing:true,parallelBatchSize:10},enableDebugLog:false};function optimizedHash(str){if(str.length<100){let hash=0;for(let i=0;i<str.length;i++){const char=str.charCodeAt(i);hash=(hash<<5)-hash+char;hash=hash&hash}return Math.abs(hash).toString(36)}let hash=0;const step=Math.max(1,Math.floor(str.length/100));for(let i=0;i<str.length;i+=step){const char=str.charCodeAt(i);hash=(hash<<5)-hash+char;hash=hash&hash}return Math.abs(hash).toString(36)}function simpleHash(str){return optimizedHash(str)}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{if(routes.length===0){return"empty"}const serializedRoutes=routes.map(route=>serializeRouteConfig(route));const configStr=JSON.stringify(serializedRoutes);return simpleHash(configStr)}catch{return""}}const validatedPathCache=new Set;const PATH_TRAVERSAL_REGEX=/\.\.(\/|\\)|\.\.%2[Ff]|\.\.%5[Cc]|%2[Ee]%2[Ee]%2[Ff]|%2[Ee]%2[Ee]%5[Cc]/i;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+.-]*:/;function validatePath(path,config){if(validatedPathCache.has(path)){return{valid:true}}if(path.length>config.maxPathLength){return{valid:false,error:process.env.NODE_ENV==="development"?`路径长度超过最大限制 ${config.maxPathLength} 字符`:"路径验证失败"}}if(path.length===0){return{valid:false,error:"路径不能为空"}}if(PATH_TRAVERSAL_REGEX.test(path)){return{valid:false,error:process.env.NODE_ENV==="development"?"路径包含路径遍历字符（../），可能存在安全风险":"路径验证失败"}}if(NULL_BYTE_REGEX.test(path)){return{valid:false,error:process.env.NODE_ENV==="development"?"路径包含空字节，可能存在安全风险":"路径验证失败"}}if(CONTROL_CHAR_REGEX.test(path)){return{valid:false,error:process.env.NODE_ENV==="development"?"路径包含控制字符，可能存在安全风险":"路径验证失败"}}if(URL_SCHEME_REGEX.test(path)){return{valid:false,error:process.env.NODE_ENV==="development"?"不允许使用带协议的路径":"路径验证失败"}}if(!config.allowAbsolutePaths&&ABSOLUTE_PATH_REGEX.test(path)){return{valid:false,error:process.env.NODE_ENV==="development"?"不允许使用绝对路径":"路径验证失败"}}if(!path.startsWith("@/")&&!path.startsWith("./")&&!path.startsWith("../")){return{valid:false,error:process.env.NODE_ENV==="development"?"仅允许使用 @/、./、../ 开头的模块路径":"路径验证失败"}}if(config.allowedPathPrefixes.length>0){const prefixSet=new Set(config.allowedPathPrefixes);const isAllowed=Array.from(prefixSet).some(prefix=>path.startsWith(prefix));if(!isAllowed){return{valid:false,error:process.env.NODE_ENV==="development"?`路径不在允许的前缀列表中: ${config.allowedPathPrefixes.join(", ")}`:"路径验证失败"}}}const validation=_utils.SecurityUtils.validateInput(path);if(!validation.safe){return{valid:false,error:process.env.NODE_ENV==="development"?validation.reason||"路径包含潜在的危险内容":"路径验证失败"}}if(validatedPathCache.size<1e3){validatedPathCache.add(path)}return{valid:true}}const NORMALIZE_REGEX={multipleSlashes:/\/+/g,dotSlash:/\/\.\//g,trailingDot:/\/\.$/};function normalizePath(path){return path.replace(NORMALIZE_REGEX.multipleSlashes,"/").replace(NORMALIZE_REGEX.dotSlash,"/").replace(NORMALIZE_REGEX.trailingDot,"").trim()}function isValidPathString(path){return typeof path==="string"&&path.length>0}function isComponentImport(path){return typeof path==="function"}function createDynamicImport(path){return()=>Promise.resolve(path).then(p=>/*#__PURE__*/_interop_require_wildcard(require(p)))}function extractAndValidatePath(path,map,config,options){if(isComponentImport(path)){return path}if(!isValidPathString(path)){return null}const normalizedPath=normalizePath(path);const existingImport=map.get(normalizedPath);if(existingImport!==undefined){return existingImport}if(config.enablePathValidation){const validation=validatePath(normalizedPath,config);if(!validation.valid){const errorMessage=process.env.NODE_ENV==="development"?`路径验证失败: ${validation.error}`:"路径验证失败";const error=new _utils.SecurityError(errorMessage,undefined,process.env.NODE_ENV==="development"?{path:normalizedPath}:{});if(options.enableDebugLog){_logger.logger.error("路径验证失败:",error)}if(process.env.NODE_ENV==="development"){throw error}else{_logger.logger.warn("路径验证失败，已跳过");return null}}}const importFn=createDynamicImport(normalizedPath);map.set(normalizedPath,importFn);if(options.enableDebugLog){_logger.logger.debug("提取路径:",normalizedPath)}return importFn}let StackNodePool=class StackNodePool{acquire(route,depth){if(this.pool.length>0){const node=this.pool.pop();node.route=route;node.depth=depth;return node}return{route,depth}}release(node){if(this.pool.length<this.maxPoolSize){this.pool.push(node)}}constructor(){_define_property(this,"pool",[]);_define_property(this,"maxPoolSize",100)}};const stackNodePool=new StackNodePool;async function extractPathsOnly(routes,result,config,options,maxDepth){const enableParallel=options.performance?.enableParallelProcessing??true;const batchSize=options.performance?.parallelBatchSize??10;if(enableParallel&&routes.length>batchSize){const pathsToProcess=[];const stack=[];for(let i=routes.length-1;i>=0;i--){stack.push({route:routes[i],depth:0})}while(stack.length>0){const{route,depth}=stack.pop();if(depth>maxDepth){_logger.logger.warn(`路径提取达到最大深度 ${maxDepth}，跳过路由:`,route.name);continue}if(route.page&&typeof route.page==="string"){pathsToProcess.push({path:route.page,map:result.pages})}if(route.layout&&typeof route.layout==="string"){pathsToProcess.push({path:route.layout,map:result.layouts})}const routeError=route.error??route.errors;if(routeError&&typeof routeError==="string"){pathsToProcess.push({path:routeError,map:result.errors})}if(route.loading&&typeof route.loading==="string"){pathsToProcess.push({path:route.loading,map:result.loadings})}if(route.children&&Array.isArray(route.children)&&route.children.length>0){for(let i=route.children.length-1;i>=0;i--){stack.push({route:route.children[i],depth:depth+1})}}}for(let i=0;i<pathsToProcess.length;i+=batchSize){const batch=pathsToProcess.slice(i,i+batchSize);await Promise.all(batch.map(({path,map})=>Promise.resolve(extractAndValidatePath(path,map,config,options))))}}else{const stack=[];for(let i=routes.length-1;i>=0;i--){stack.push(stackNodePool.acquire(routes[i],0))}while(stack.length>0){const node=stack.pop();const{route,depth}=node;if(depth>maxDepth){_logger.logger.warn(`路径提取达到最大深度 ${maxDepth}，跳过路由:`,route.name);stackNodePool.release(node);continue}extractAndValidatePath(route.page,result.pages,config,options);extractAndValidatePath(route.layout,result.layouts,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){for(let i=route.children.length-1;i>=0;i--){stack.push(stackNodePool.acquire(route.children[i],depth+1))}}stackNodePool.release(node)}}}function cleanupExpiredCache(cacheTTL){if(transformCache){transformCache.cleanupExpired(cacheTTL)}}async function transformRoutes(routes,options={}){const startTime=performance.now();const mergedOptions={pathValidation:{...DEFAULT_OPTIONS.pathValidation,...options.pathValidation},performance:{...DEFAULT_OPTIONS.performance,...options.performance},enableDebugLog:options.enableDebugLog??DEFAULT_OPTIONS.enableDebugLog};if(!routes){if(mergedOptions.enableDebugLog){_logger.logger.debug("路由配置为空，返回空结果")}return{pages:new Map,layouts:new Map,errors:new Map,loadings:new Map,routes:[]}}let routesArray;try{routesArray=typeof routes==="function"?await routes():routes}catch(error){const err=error instanceof Error?error:new Error("路由配置加载失败");_logger.logger.error("路由配置加载失败:",err);throw new _utils.ValidationError("路由配置加载失败",{originalError:err})}if(!Array.isArray(routesArray)||routesArray.length===0){if(mergedOptions.enableDebugLog){_logger.logger.debug("路由配置不是数组或为空，返回空结果")}return{pages:new Map,layouts:new Map,errors:new Map,loadings:new Map,routes:[]}}const cacheTTL=mergedOptions.performance.cacheTTL??DEFAULT_OPTIONS.performance.cacheTTL;const maxCacheSize=mergedOptions.performance.maxCacheSize??DEFAULT_OPTIONS.performance.maxCacheSize;if(mergedOptions.performance.enableCache){if(!transformCache||transformCache.size()!==maxCacheSize){transformCache=new LRUCache(maxCacheSize)}const configHash=generateConfigHash(routesArray);if(configHash){const cached=transformCache.get(configHash);if(cached&&Date.now()-cached.timestamp<cacheTTL){if(mergedOptions.enableDebugLog){_logger.logger.debug("使用缓存结果")}return cached.result}}cleanupExpiredCache(cacheTTL)}const result={pages:new Map,layouts:new Map,errors:new Map,loadings:new Map,routes:[]};try{const extractStartTime=performance.now();const pathValidation={enablePathValidation:mergedOptions.pathValidation.enablePathValidation??DEFAULT_OPTIONS.pathValidation.enablePathValidation,allowedPathPrefixes:mergedOptions.pathValidation.allowedPathPrefixes??DEFAULT_OPTIONS.pathValidation.allowedPathPrefixes,maxPathLength:mergedOptions.pathValidation.maxPathLength??DEFAULT_OPTIONS.pathValidation.maxPathLength,allowAbsolutePaths:mergedOptions.pathValidation.allowAbsolutePaths??DEFAULT_OPTIONS.pathValidation.allowAbsolutePaths};const maxRecursionDepth=mergedOptions.performance.maxRecursionDepth??DEFAULT_OPTIONS.performance.maxRecursionDepth;await extractPathsOnly(routesArray,result,pathValidation,mergedOptions,maxRecursionDepth);const extractEndTime=performance.now();const extractDuration=extractEndTime-extractStartTime;result.routes=routesArray;const cacheStartTime=performance.now();if(mergedOptions.performance.enableCache&&transformCache){const configHash=generateConfigHash(routesArray);if(configHash){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(),hash:configHash,accessTime:Date.now()})}}const cacheEndTime=performance.now();const cacheDuration=cacheEndTime-cacheStartTime;const endTime=performance.now();const totalDuration=endTime-startTime;if(mergedOptions.enableDebugLog){_logger.logger.debug(`路由转换完成，总耗时: ${totalDuration.toFixed(2)}ms`,{routeCount:result.routes.length,pageCount:result.pages.size,layoutCount:result.layouts.size,errorCount:result.errors.size,loadingCount:result.loadings.size,performance:{extractDuration:`${extractDuration.toFixed(2)}ms`,cacheDuration:`${cacheDuration.toFixed(2)}ms`,totalDuration:`${totalDuration.toFixed(2)}ms`},cache:{hit:transformCache?"miss":"disabled",size:transformCache?.size()??0}})}return result}catch(error){const err=error instanceof Error?error:new Error("路由转换失败");_logger.logger.error("路由转换失败:",err);throw new _utils.ValidationError("路由转换失败",{originalError:err})}}