@oj-module/runtime 0.1.5

package/dist/router/routes/core/auth.d.ts

@@ -0,0 +1,13 @@
+import type { AppRouteRecordRaw } from "../../types";
+/**
+ * 内置登录兜底路由（P2，login 模块化）。
+ *
+ * 与模块形态运行时同构：fullscreen 外壳 + children 内容区。
+ * baseRoutes 不经 resolveRouteLayouts 注入（router/index.ts 直接消费），
+ * 故内核路由显式挂 FullscreenLayout；模块侧则声明 `layout: "fullscreen"` 由框架注入。
+ *
+ * handle.login/internal 供 resolveLoginRoute（P3）识别：存在外部 login
+ * 模块路由时剔除本条内置兜底。
+ */
+declare const routes: AppRouteRecordRaw[];
+export default routes;

package/dist/router/routes/core/exception.d.ts

@@ -0,0 +1,12 @@
+import type { AppRouteRecordRaw } from "../../types";
+/**
+ * P7.14 / 评审 F11：框架内置 /exception/403|404|500 兜底路由。
+ *
+ * 守卫硬编码向这三个路径跳转，它们因此是框架契约的一部分，必须由框架
+ * 自己兜底（此前依赖可禁用的 modules/exception 提供）。exception 模块
+ * 启用时其同路径路由优先——auth-guard 只在路径未被任何来源覆盖时
+ * 注入本兜底（见 ensureBuiltinExceptionRoutes）。
+ */
+export declare const builtinExceptionRoutes: AppRouteRecordRaw[];
+/** 目标路径未被覆盖时注入内置异常页兜底；返回新数组，不改入参 */
+export declare function ensureBuiltinExceptionRoutes(routes: AppRouteRecordRaw[]): AppRouteRecordRaw[];

package/dist/router/routes/core/fallback.d.ts

@@ -0,0 +1,3 @@
+import type { RouteObject } from "react-router";
+declare const routes: RouteObject[];
+export default routes;

package/dist/router/routes/core/index.d.ts

@@ -0,0 +1,2 @@
+/** 核心路由 */
+export declare const coreRoutes: any;

package/dist/router/routes/index.d.ts

@@ -0,0 +1,118 @@
+import type { AppRouteRecordRaw, RouteFileModule } from "../types";
+export declare const externalRouteFiles: RouteFileModule;
+export declare const staticRouteFiles: RouteFileModule;
+/**
+ * 外部路由 1. 不进行权限校验， 2. 不会触发请求，例如用户信息接口
+ * @example "privacy-policy", "terms-of-service" 等
+ */
+export declare const externalRoutes: AppRouteRecordRaw[];
+/** 静态路由 */
+export declare const staticRoutes: AppRouteRecordRaw[];
+/**
+ * 基本路由列表，由核心路由、外部路由组成，会一直存在系统中
+ */
+declare const baseRoutes: ({
+    handle: {
+        order: number;
+        title: import("#node_modules/@types/react").ReactNode;
+        icon?: import("#node_modules/@types/react").ReactNode;
+        roles?: string[];
+        permissions?: string[];
+        keepAlive?: boolean;
+        layout?: "container" | "parent" | "fullscreen" | "none";
+        login?: boolean;
+        internal?: boolean;
+        hideInMenu?: boolean;
+        iframeLink?: string;
+        externalLink?: string;
+        ignoreAccess?: boolean;
+        currentActiveMenu?: string;
+        backstage?: boolean;
+    };
+    redirect?: string;
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    children?: undefined | undefined;
+    index: true;
+} | {
+    handle: {
+        order: number;
+        title: import("#node_modules/@types/react").ReactNode;
+        icon?: import("#node_modules/@types/react").ReactNode;
+        roles?: string[];
+        permissions?: string[];
+        keepAlive?: boolean;
+        layout?: "container" | "parent" | "fullscreen" | "none";
+        login?: boolean;
+        internal?: boolean;
+        hideInMenu?: boolean;
+        iframeLink?: string;
+        externalLink?: string;
+        ignoreAccess?: boolean;
+        currentActiveMenu?: string;
+        backstage?: boolean;
+    };
+    redirect?: string;
+    children?: AppRouteRecordRaw[];
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    index?: false | undefined;
+})[];
+/** 权限路由列表（静态路由，模块路由由 module-loader 动态提供） */
+declare const accessRoutes: AppRouteRecordRaw[];
+/**
+ * 路由白名单 1. 不进行权限校验， 2. 不会触发请求，例如用户信息接口
+ * @example "privacy-policy", "terms-of-service" 等
+ */
+declare const whiteRouteNames: (string | undefined)[];
+export { accessRoutes, baseRoutes, whiteRouteNames, };

package/dist/router/types.d.ts

@@ -0,0 +1,90 @@
+import type { ReactNode } from "react";
+import type { IndexRouteObject, NonIndexRouteObject, createBrowserRouter as RemixRouter } from "react-router";
+export interface IndexRouteMeta extends Omit<IndexRouteObject, "id"> {
+    redirect?: string;
+    handle: RouteMeta;
+}
+export interface NonIndexRouteMeta extends Omit<NonIndexRouteObject, "id"> {
+    redirect?: string;
+    handle: RouteMeta;
+    children?: AppRouteRecordRaw[];
+}
+export type AppRouteRecordRaw = IndexRouteMeta | NonIndexRouteMeta;
+export interface RouteMeta {
+    /**
+     * 路由标题，通常用于页面标题或者侧边栏菜单显示
+     */
+    title: ReactNode;
+    /**
+     * 菜单图标，用于侧边栏菜单项的图标显示
+     */
+    icon?: ReactNode;
+    /**
+     * 菜单排序，用于控制侧边栏菜单的显示顺序
+     */
+    order?: number;
+    /**
+     * 用于配置页面的权限，只有拥有对应权限的用户才能访问页面，不配置则不需要权限。
+     */
+    roles?: string[];
+    /**
+     * 页面内按钮级别的权限，用于控制页面内按钮的显示和隐藏
+     */
+    permissions?: string[];
+    /**
+     * 设置页面是否开启缓存，开启后页面会缓存，不会重新加载，仅在标签页启用时有效。
+     * @default true
+     */
+    keepAlive?: boolean;
+    /**
+     * 布局包裹方式（P2.2，设计文档 D9）。显式声明，不做隐式推导。
+     * - `"container"`：套完整 chrome（header / sidebar / tabbar / content）
+     * - `"parent"`：套父级布局（自身含 Outlet，用于嵌套菜单场景）
+     * - `"fullscreen"`：套全屏外壳（视口 + 品牌区 + 角落工具 + 页脚，无 chrome），登录页用（P1）
+     * - `"none"`：不套任何布局，页面/子路由直接渲染
+     * @default "container"（迁移期向后兼容，目标在 P2.7 补全显式声明后改为 `"none"`）
+     */
+    layout?: "container" | "parent" | "fullscreen" | "none";
+    /**
+     * 登录页标记（login 模块化，P1）：声明在 `path: "/login"` 的模块路由上，
+     * 供 resolveLoginRoute 识别并剔除内置兜底。仅模块路由受信，后端路由忽略。
+     */
+    login?: boolean;
+    /**
+     * 内置兜底标记（login 模块化，P1）：框架内置登录页专用，
+     * 存在外部 login 模块路由时被 resolveLoginRoute 剔除。
+     */
+    internal?: boolean;
+    /**
+     * 是否在菜单中隐藏，用于控制某些路由不在侧边栏菜单中显示
+     */
+    hideInMenu?: boolean;
+    /**
+     * iframe链接，如果路由需要在iframe中加载外部页面时使用
+     */
+    iframeLink?: string;
+    /**
+     * 外部链接，点击后直接在新标签页中打开
+     */
+    externalLink?: string;
+    /**
+     * 用于配置页面是否忽略权限，直接可以访问
+     */
+    ignoreAccess?: boolean;
+    /**
+     * @description 指定当前激活的菜单，适用于动态路由情景下激活父菜单
+     * @example 从父路由 '/user/info' 导航到子路由 '/user/info/1' 时，可以手动手动指定以高亮显示父菜单 '/user/info'
+     */
+    currentActiveMenu?: string;
+    /**
+     * 当前路由为请求后端接口得到的
+     */
+    backstage?: boolean;
+}
+export type ReactRouterType = ReturnType<typeof RemixRouter>;
+export type RouterSubscriber = Parameters<ReactRouterType["subscribe"]>[0];
+export type RouterState = ReactRouterType["state"];
+export type RouterNavigate = ReactRouterType["navigate"];
+export type RouteFileModule = Record<string, {
+    default: AppRouteRecordRaw[];
+}>;

package/dist/router/utils/add-route-id-by-path.d.ts

@@ -0,0 +1,81 @@
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * 为路由对象添加一个唯一的 ID，替代路由自动生成的 id，该 ID 默认为路由的路径（path）
+ * {
+ *   path: '/dashboard',
+ * }
+ *
+ * 转化后
+ *
+ * {
+ *   path: '/dashboard',
+ *   id: '/dashboard',
+ * }
+ */
+export declare function addRouteIdByPath(routes: AppRouteRecordRaw[], parentId?: string): ({
+    id: string | undefined;
+    redirect?: string;
+    handle: import("../types").RouteMeta;
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    children?: undefined | undefined;
+    index: true;
+} | {
+    id: string | undefined;
+    redirect?: string;
+    handle: import("../types").RouteMeta;
+    children?: AppRouteRecordRaw[];
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    index?: false | undefined;
+})[];

package/dist/router/utils/ascending.d.ts

@@ -0,0 +1,99 @@
+import type { AppRouteRecordRaw } from "../types";
+/** 按照路由中 order 升序来排序路由 */
+export declare function ascending(arr: AppRouteRecordRaw[]): ({
+    handle: {
+        order: number;
+        title: import("#node_modules/@types/react").ReactNode;
+        icon?: import("#node_modules/@types/react").ReactNode;
+        roles?: string[];
+        permissions?: string[];
+        keepAlive?: boolean;
+        layout?: "container" | "parent" | "fullscreen" | "none";
+        login?: boolean;
+        internal?: boolean;
+        hideInMenu?: boolean;
+        iframeLink?: string;
+        externalLink?: string;
+        ignoreAccess?: boolean;
+        currentActiveMenu?: string;
+        backstage?: boolean;
+    };
+    redirect?: string;
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    children?: undefined | undefined;
+    index: true;
+} | {
+    handle: {
+        order: number;
+        title: import("#node_modules/@types/react").ReactNode;
+        icon?: import("#node_modules/@types/react").ReactNode;
+        roles?: string[];
+        permissions?: string[];
+        keepAlive?: boolean;
+        layout?: "container" | "parent" | "fullscreen" | "none";
+        login?: boolean;
+        internal?: boolean;
+        hideInMenu?: boolean;
+        iframeLink?: string;
+        externalLink?: string;
+        ignoreAccess?: boolean;
+        currentActiveMenu?: string;
+        backstage?: boolean;
+    };
+    redirect?: string;
+    children?: AppRouteRecordRaw[];
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    index?: false | undefined;
+})[];

package/dist/router/utils/flatten-routes.d.ts

@@ -0,0 +1,5 @@
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * 将路由扁平化为一个对象，键为路由的 path，值为路由对象
+ */
+export declare function flattenRoutes(routes: AppRouteRecordRaw[]): Record<string, AppRouteRecordRaw>;

package/dist/router/utils/generate-menu-items-from-routes.d.ts

@@ -0,0 +1,10 @@
+import type { MenuItemType } from "../../layout/layout-menu/types";
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * 根据路由列表生成菜单项数组
+ *
+ * @param routeList 路由列表，类型为 AppRouteRecordRaw 数组
+ * @param parentPath 父路由绝对路径（递归用，顶层为 "/"）
+ * @returns 返回菜单项数组，数组元素类型为 MenuItemType
+ */
+export declare function generateMenuItemsFromRoutes(routeList: AppRouteRecordRaw[], parentPath?: string): MenuItemType[];

package/dist/router/utils/generate-routes-from-backend.d.ts

@@ -0,0 +1,79 @@
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * @zh 根据路由获取框架页面组件路径（仅 src/pages；模块页面不在此解析）
+ * @en Get framework page component path by route (src/pages only; module pages are resolved elsewhere)
+ */
+export declare function getComponentPathByRoute(route: AppRouteRecordRaw & {
+    component?: string;
+}): string;
+/**
+ * @zh 根据后端路由配置生成前端路由
+ * @en Generate frontend routes based on backend route configurations
+ */
+export declare function generateRoutesFromBackend(backendRoutes: Array<AppRouteRecordRaw>): Promise<({
+    id: string | undefined;
+    redirect?: string;
+    handle: import("../types").RouteMeta;
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    children?: undefined | undefined;
+    index: true;
+} | {
+    id: string | undefined;
+    redirect?: string;
+    handle: import("../types").RouteMeta;
+    children?: AppRouteRecordRaw[];
+    caseSensitive?: boolean | undefined;
+    path?: string | undefined;
+    middleware?: import("react-router").MiddlewareFunction[] | undefined;
+    loader?: (import("react-router").LoaderFunction | boolean) | undefined;
+    action?: (import("react-router").ActionFunction | boolean) | undefined;
+    hasErrorBoundary?: boolean | undefined;
+    shouldRevalidate?: import("react-router").ShouldRevalidateFunction | undefined;
+    lazy?: ({
+        middleware?: (() => Promise<import("react-router").MiddlewareFunction<unknown>[] | null | undefined>) | undefined;
+        loader?: (() => Promise<boolean | import("react-router").LoaderFunction<any> | null | undefined>) | undefined;
+        action?: (() => Promise<boolean | import("react-router").ActionFunction<any> | null | undefined>) | undefined;
+        hasErrorBoundary?: (() => Promise<boolean | null | undefined>) | undefined;
+        shouldRevalidate?: (() => Promise<import("react-router").ShouldRevalidateFunction | null | undefined>) | undefined;
+        handle?: (() => Promise<any>) | undefined;
+        Component?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        element?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        ErrorBoundary?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        errorElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+        HydrateFallback?: (() => Promise<import("#node_modules/@types/react").ComponentType<{}> | null | undefined>) | undefined;
+        hydrateFallbackElement?: (() => Promise<import("#node_modules/@types/react").ReactNode>) | undefined;
+    } | import("react-router").LazyRouteFunction<import("react-router").BaseRouteObject>) | undefined;
+    Component?: (React.ComponentType | null) | undefined;
+    element?: import("#node_modules/@types/react").ReactNode;
+    ErrorBoundary?: (React.ComponentType | null) | undefined;
+    errorElement?: import("#node_modules/@types/react").ReactNode;
+    HydrateFallback?: (React.ComponentType | null) | undefined;
+    hydrateFallbackElement?: import("#node_modules/@types/react").ReactNode;
+    index?: false | undefined;
+})[]>;

package/dist/router/utils/generate-routes-from-frontend.d.ts

@@ -0,0 +1,5 @@
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * 动态生成路由 - 前端方式
+ */
+export declare function generateRoutesByFrontend(routes: AppRouteRecordRaw[], roles: string[]): AppRouteRecordRaw[];

package/dist/router/utils/merge-route-modules.d.ts

@@ -0,0 +1,2 @@
+import type { AppRouteRecordRaw, RouteFileModule } from "../types";
+export declare function mergeRouteModules(...routes: RouteFileModule[]): AppRouteRecordRaw[];

package/dist/router/utils/remove-trailing-slash.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @zh 移除路径末尾的斜杠
+ * @en Remove trailing slashes from a path
+ * @param {string} pathname - The path to remove trailing slashes from
+ * @returns {string} The path with trailing slashes removed
+ * @example
+ * removeTrailingSlash('/about/') // return '/about'
+ * removeTrailingSlash('/about')  // return '/about'
+ */
+export declare function removeTrailingSlash(pathname: string): string;

package/dist/router/utils/resolve-layout.d.ts

@@ -0,0 +1,17 @@
+import type { ComponentType } from "react";
+import type { AppRouteRecordRaw, RouteMeta } from "../types";
+/**
+ * 根据路由 `handle.layout` 解析所用布局组件（P2.2，设计文档 D9）。
+ *
+ * 未声明即 `none` 是 D9 的目标态（P2.7 dogfooding 验证后自迁移期默认 `container` 翻转）：
+ * 布局必须显式声明，框架不做隐式推导；后端下发的父级路由需在 handle 中携带 layout。
+ */
+export declare function resolveLayoutComponent(handle?: Partial<RouteMeta>): ComponentType;
+/**
+ * 递归为缺少 Component 的父级路由按 `handle.layout` 注入布局组件（P2.7，US-8）。
+ *
+ * 模块路由不再直接 import ContainerLayout / ParentLayout，由框架在
+ * module-loader 出口统一包裹；已有 Component 的路由（页面组件）不受影响。
+ * 纯函数：返回新路由树，不修改模块 definition 中的原对象。
+ */
+export declare function resolveRouteLayouts(routes: AppRouteRecordRaw[]): AppRouteRecordRaw[];

package/dist/router/utils/resolve-login-route.d.ts

@@ -0,0 +1,31 @@
+import type { RouteObject } from "react-router";
+import type { AppRouteRecordRaw } from "../types";
+/**
+ * 结构性 router 接口（DIP）：不 import router 单例——
+ * 那会引入 router/index → layout → store → 本模块 的循环依赖（P3 实测 +98 环）。
+ */
+interface RouterLike {
+    routes: RouteObject[];
+    _internalSetRoutes: (routes: RouteObject[]) => void;
+    patchRoutes: (routeId: string, children: any[]) => void;
+}
+/**
+ * 内外 login 路由去重（P3，login 模块化）：唯一合成入口（SRP/DRY），
+ * 启动引导（index.tsx）与 setAccessStore 两处调用，无内部状态、可重入。
+ *
+ * 规则：
+ * - `handle.login` 只信**模块路由**（后端下发路由不参与）；
+ * - 契约路径固定 `/login`，非该路径的标记拒绝并告警；
+ * - 多模块声明时按（拓扑）序先到先得，其余告警忽略；
+ * - 存在有效外部 login 时：内置兜底（`internal: true`）从合成结果剔除，
+ *   并重建根路由 + 立即补 patch 获胜的外部 login 路由——
+ *   `patchRoutes` 只能增不能删，而 `_internalSetRoutes`（RR 7.18 起落入
+ *   HMR 树）会丢弃已 patch 的动态路由，故获胜路由须在同一调用内回补，
+ *   否则直接落地 /login 会闪现 404。
+ *
+ * 注意：**不能**放进 module-loader 的 `getRoutes()`（每次实时计算，会让模块看不到自己）。
+ *
+ * @returns 合成用的有效 base 列表（无外部 login 时原样返回 `base`）
+ */
+export declare function resolveLoginRoute(base: AppRouteRecordRaw[], incoming: AppRouteRecordRaw[], router: RouterLike, rootRoute: RouteObject[]): AppRouteRecordRaw[];
+export {};