@jnrs/vue-core 1.0.1 → 1.0.3

package/dist/index.d.ts

@@ -1 +1 @@
-export * as router from './utils/router';
+export * as router from './router/createVueRouter';

package/dist/index.js

@@ -1 +1 @@
-export * as router from './utils/router';
+export * as router from './router/createVueRouter';

package/dist/router/createRouter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
+ */
+import { useRoute, type Router, type RouterOptions, type RouteLocationRaw } from 'vue-router';
+import type { MenuItem, ModulesFileList } from './types';
+/**
+ * 创建 vue-router 实例
+ * @param options - 配置项
+ * @returns router 实例
+ */
+declare const createVueRouter: (options: Partial<RouterOptions>) => Router;
+declare const routerPush: (to: RouteLocationRaw, router: Router) => Promise<void | import("vue-router").NavigationFailure>;
+declare const routerReplace: (to: RouteLocationRaw, router: Router) => Promise<void | import("vue-router").NavigationFailure>;
+declare const getRoutes: (router: Router) => MenuItem[];
+declare const setupDynamicRoutes: (router: Router, layoutName: string | undefined, userRoutes: MenuItem[], modulesFileList: ModulesFileList) => Promise<void>;
+export { createVueRouter, setupDynamicRoutes, routerPush, routerReplace, getRoutes, useRoute, type ModulesFileList };

package/dist/router/createRouter.js

@@ -0,0 +1,146 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
+ */
+import { createRouter, useRoute } from 'vue-router';
+import { DEFAULT_OPTIONS, LAYOUT_NAME } from './defaults';
+/**
+ * 创建 vue-router 实例
+ * @param options - 配置项
+ * @returns router 实例
+ */
+const createVueRouter = (options) => {
+    const router = createRouter({ ...DEFAULT_OPTIONS, ...options });
+    // 获取用户权限
+    // const canUserAccess = async (to: RouteLocationNormalized) => {
+    //   const isAuthenticated = true
+    //   return to.name === 'Login' || to.meta.noAuth || isAuthenticated
+    // }
+    // 全局前置守卫
+    router.beforeEach(async (to) => {
+        // const canAccess = await canUserAccess(to)
+        // if (!canAccess) {
+        //   return {
+        //     name: 'Login',
+        //     query: { redirect: to.name?.toString() }
+        //   }
+        // }
+    });
+    return router;
+};
+// 路由跳转
+const routerPush = async (to, router) => {
+    try {
+        const failure = await router.push(to);
+        return failure;
+    }
+    catch (e) {
+        console.warn('[router.push] 失败', {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router.push({ name: '404' });
+    }
+};
+// 路由替换
+const routerReplace = async (to, router) => {
+    try {
+        const failure = await router.replace(to);
+        return failure;
+    }
+    catch (e) {
+        console.warn('[router.replace] 失败', {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router.replace({ name: '404' });
+    }
+};
+// 获取路由
+const getRoutes = (router) => {
+    const temp = [];
+    for (const route of router.getRoutes()) {
+        temp.push({
+            name: route.name,
+            path: route.path,
+            meta: route.meta
+        });
+    }
+    return temp;
+};
+// 加载动态路由
+const setupDynamicRoutes = async (router, layoutName = LAYOUT_NAME, userRoutes, modulesFileList) => {
+    menuToRoute(router, layoutName, modulesFileList, userRoutes, undefined);
+};
+// 组件加载器
+const getComponentLoader = (safePath, modulesFileList) => {
+    return modulesFileList[`/src/views${safePath}.vue`];
+};
+// 将菜单项转换为路由记录
+const menuToRoute = async (router, layoutName, modulesFileList, menus, parent) => {
+    for (const menu of menus) {
+        menu.meta.fullPathTitle = parent
+            ? parent.meta.fullPathTitle + ',' + menu.meta.title
+            : menu.meta.title;
+        // 当前项若没有component，则为目录，直接递归处理
+        if (!menu.component) {
+            if (menu.children && menu.children.length > 0) {
+                await menuToRoute(router, layoutName, modulesFileList, menu.children, menu);
+            }
+            continue;
+        }
+        // 安全处理组件路径
+        const safePath = menu.component.replace(/[^a-zA-Z0-9/._-]/g, '');
+        if (!safePath.startsWith('/') || safePath.includes('..')) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'INVALID_COMPONENT_PATH',
+                message: `组件路径拼写不符合规则，应以 '/' 开头且不能包含 '..'，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
+                timestamp: new Date().toISOString()
+            });
+            continue;
+        }
+        // 获取组件加载器
+        const loader = getComponentLoader(safePath, modulesFileList);
+        if (!loader) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'COMPONENT_NOT_FOUND',
+                message: `组件加载器无效，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
+                timestamp: new Date().toISOString()
+            });
+            continue;
+        }
+        // 构建路由记录
+        const routeRecord = {
+            name: menu.name,
+            path: menu.path,
+            meta: menu.meta,
+            redirect: menu.redirect,
+            component: () => loader()
+        };
+        // 根据 global 字段决定添加为全局路由还是布局子路由
+        if (menu.meta?.global) {
+            router.addRoute(routeRecord);
+        }
+        else {
+            router.addRoute(layoutName, routeRecord);
+        }
+    }
+};
+export { createVueRouter, setupDynamicRoutes, routerPush, routerReplace, getRoutes, useRoute };

package/dist/router/createVueRouter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
+ */
+import type { Router, RouteLocationRaw } from 'vue-router';
+import type { CreateVueRouter, MenuItem } from './types';
+/**
+ * 创建 vue-router 实例
+ * @param options 配置项
+ * @param fileModules 文件模块
+ * @param layoutName 布局组件名称
+ * @param globalComponent 全局 Layout 组件（mate.global=true时需传入）
+ * @param handleBeforeEach 路由前置守卫处理函数
+ * @returns router 实例
+ */
+declare const createVueRouter: ({ options, fileModules, layoutName, globalComponent, handleBeforeEach }: CreateVueRouter) => Router;
+/**
+ * 路由跳转或替换
+ * @param to 路由跳转参数
+ * @param type 默认为push， push | replace
+ * @returns Promise<boolean | void>
+ */
+declare const handleRouter: (to: RouteLocationRaw, type?: "push" | "replace") => Promise<void | import("vue-router").NavigationFailure>;
+/**
+ * 设置动态路由，生成路由记录
+ * @param menus 菜单项
+ * @param parent 父级菜单项
+ */
+declare const asyncGenerateRoute: (menus: MenuItem[], parent?: MenuItem) => Promise<void>;
+declare const getRoutes: () => MenuItem[];
+export { createVueRouter, asyncGenerateRoute, handleRouter, getRoutes };

package/dist/router/createVueRouter.js

@@ -0,0 +1,156 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
+ */
+import { createRouter } from 'vue-router';
+import { DEFAULT_OPTIONS } from './defaults';
+let router;
+let _fileModules;
+let _layoutName;
+let _globalComponent;
+/**
+ * 创建 vue-router 实例
+ * @param options 配置项
+ * @param fileModules 文件模块
+ * @param layoutName 布局组件名称
+ * @param globalComponent 全局 Layout 组件（mate.global=true时需传入）
+ * @param handleBeforeEach 路由前置守卫处理函数
+ * @returns router 实例
+ */
+const createVueRouter = ({ options, fileModules, layoutName, globalComponent, handleBeforeEach }) => {
+    _fileModules = fileModules;
+    if (layoutName) {
+        _layoutName = layoutName;
+    }
+    if (globalComponent) {
+        _globalComponent = globalComponent;
+    }
+    router = createRouter({ ...DEFAULT_OPTIONS, ...options });
+    router.beforeEach(async (to) => handleBeforeEach?.(to));
+    return router;
+};
+/**
+ * 路由跳转或替换
+ * @param to 路由跳转参数
+ * @param type 默认为push， push | replace
+ * @returns Promise<boolean | void>
+ */
+const handleRouter = async (to, type = 'push') => {
+    try {
+        const failure = await router[type](to);
+        return failure;
+    }
+    catch (e) {
+        console.warn(`router.${type} 失败`, {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router[type]({ name: '404' });
+    }
+};
+/**
+ * 组件加载器
+ * @param safePath 安全处理后的组件路径
+ * @param fileModules 文件模块
+ * @returns
+ */
+const getComponentLoader = (safePath) => {
+    return _fileModules[`/src/views${safePath}.vue`];
+};
+/**
+ * 设置动态路由，生成路由记录
+ * @param menus 菜单项
+ * @param parent 父级菜单项
+ */
+const asyncGenerateRoute = async (menus, parent) => {
+    for (const menu of menus) {
+        menu.meta.fullPathTitle = parent
+            ? parent.meta.fullPathTitle + ',' + menu.meta.title
+            : menu.meta.title;
+        // 当前项若没有component，则为目录，直接递归处理
+        if (!menu.component) {
+            if (menu.children && menu.children.length > 0) {
+                asyncGenerateRoute(menu.children, menu);
+            }
+            continue;
+        }
+        // 安全处理组件路径
+        const safePath = menu.component.replace(/[^a-zA-Z0-9/._-]/g, '');
+        if (!safePath.startsWith('/') || safePath.includes('..')) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'INVALID_COMPONENT_PATH',
+                message: `组件路径拼写不符合规则，应以 '/' 开头且不能包含 '..'，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
+                timestamp: new Date().toISOString()
+            });
+            continue;
+        }
+        // 获取组件加载器
+        const loader = getComponentLoader(safePath);
+        if (!loader) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'COMPONENT_NOT_FOUND',
+                message: `组件加载器无效，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
+                timestamp: new Date().toISOString()
+            });
+            continue;
+        }
+        // 根据 global 字段决定添加为全局路由还是布局子路由
+        let routeRecord = {
+            name: menu.name,
+            path: menu.path,
+            meta: menu.meta,
+            redirect: menu.redirect,
+            component: () => loader()
+        };
+        if (menu.meta?.global) {
+            if (_globalComponent !== undefined) {
+                routeRecord = {
+                    path: menu.path,
+                    meta: menu.meta,
+                    redirect: menu.redirect,
+                    component: () => _globalComponent,
+                    children: [
+                        {
+                            path: '',
+                            name: menu.name,
+                            meta: menu.meta,
+                            component: () => loader()
+                        }
+                    ]
+                };
+            }
+            router.addRoute(routeRecord);
+        }
+        else {
+            router.addRoute(_layoutName, routeRecord);
+        }
+    }
+};
+// 获取路由
+const getRoutes = () => {
+    const temp = [];
+    for (const route of router.getRoutes()) {
+        temp.push({
+            name: route.name,
+            path: route.path,
+            meta: route.meta
+        });
+    }
+    return temp;
+};
+export { createVueRouter, asyncGenerateRoute, handleRouter, getRoutes };

package/dist/router/defaults.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 默认配置项
+ * @property history - 路由历史模式
+ * @property routes - 路由记录数组
+ */
+declare const DEFAULT_OPTIONS: {
+    history: import("vue-router").RouterHistory;
+    routes: never[];
+};
+export { DEFAULT_OPTIONS };

package/dist/router/defaults.js

@@ -0,0 +1,11 @@
+import { createWebHistory } from 'vue-router';
+/**
+ * 默认配置项
+ * @property history - 路由历史模式
+ * @property routes - 路由记录数组
+ */
+const DEFAULT_OPTIONS = {
+    history: createWebHistory(),
+    routes: []
+};
+export { DEFAULT_OPTIONS };

package/dist/router/index.d.ts

@@ -0,0 +1,4 @@
+export type * from 'vue-router';
+export type * from './types';
+export { useRouter, useRoute } from 'vue-router';
+export { createVueRouter, asyncGenerateRoute, handleRouter, getRoutes } from './createVueRouter';

package/dist/router/index.js

@@ -0,0 +1,2 @@
+export { useRouter, useRoute } from 'vue-router';
+export { createVueRouter, asyncGenerateRoute, handleRouter, getRoutes } from './createVueRouter';

package/dist/router/router.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
+ */
+import { useRoute, type Router, type RouterOptions, type RouteLocationRaw } from 'vue-router';
+import type { MenuItem, ModulesFileList } from './types';
+/**
+ * 创建 vue-router 实例
+ * @param options - 配置项
+ * @returns router 实例
+ */
+declare const createVueRouter: (options: Partial<RouterOptions>) => Router;
+declare const routerPush: (to: RouteLocationRaw, router: Router) => Promise<void | import("vue-router").NavigationFailure>;
+declare const routerReplace: (to: RouteLocationRaw, router: Router) => Promise<void | import("vue-router").NavigationFailure>;
+declare const getRoutes: (router: Router) => MenuItem[];
+declare const setupDynamicRoutes: (router: Router, layoutName: string | undefined, userRoutes: MenuItem[], modulesFileList: ModulesFileList) => Promise<void>;
+export { createVueRouter, setupDynamicRoutes, routerPush, routerReplace, getRoutes, useRoute, type ModulesFileList };

package/dist/router/router.js

@@ -0,0 +1,146 @@
+/**
+ * @Author : TanRui
+ * @WeChat : Tan578853789
+ * @File   : index.ts
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
+ */
+import { createRouter, useRoute } from 'vue-router';
+import { DEFAULT_OPTIONS, LAYOUT_NAME } from './defaults';
+/**
+ * 创建 vue-router 实例
+ * @param options - 配置项
+ * @returns router 实例
+ */
+const createVueRouter = (options) => {
+    const router = createRouter({ ...DEFAULT_OPTIONS, ...options });
+    // 获取用户权限
+    // const canUserAccess = async (to: RouteLocationNormalized) => {
+    //   const isAuthenticated = true
+    //   return to.name === 'Login' || to.meta.noAuth || isAuthenticated
+    // }
+    // 全局前置守卫
+    router.beforeEach(async (to) => {
+        // const canAccess = await canUserAccess(to)
+        // if (!canAccess) {
+        //   return {
+        //     name: 'Login',
+        //     query: { redirect: to.name?.toString() }
+        //   }
+        // }
+    });
+    return router;
+};
+// 路由跳转
+const routerPush = async (to, router) => {
+    try {
+        const failure = await router.push(to);
+        return failure;
+    }
+    catch (e) {
+        console.warn('[router.push] 失败', {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router.push({ name: '404' });
+    }
+};
+// 路由替换
+const routerReplace = async (to, router) => {
+    try {
+        const failure = await router.replace(to);
+        return failure;
+    }
+    catch (e) {
+        console.warn('[router.replace] 失败', {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router.replace({ name: '404' });
+    }
+};
+// 获取路由
+const getRoutes = (router) => {
+    const temp = [];
+    for (const route of router.getRoutes()) {
+        temp.push({
+            name: route.name,
+            path: route.path,
+            meta: route.meta
+        });
+    }
+    return temp;
+};
+// 加载动态路由
+const setupDynamicRoutes = async (router, layoutName = LAYOUT_NAME, userRoutes, modulesFileList) => {
+    menuToRoute(router, layoutName, modulesFileList, userRoutes, undefined);
+};
+// 组件加载器
+const getComponentLoader = (safePath, modulesFileList) => {
+    return modulesFileList[`/src/views${safePath}.vue`];
+};
+// 将菜单项转换为路由记录
+const menuToRoute = async (router, layoutName, modulesFileList, menus, parent) => {
+    for (const menu of menus) {
+        menu.meta.fullPathTitle = parent
+            ? parent.meta.fullPathTitle + ',' + menu.meta.title
+            : menu.meta.title;
+        // 当前项若没有component，则为目录，直接递归处理
+        if (!menu.component) {
+            if (menu.children && menu.children.length > 0) {
+                await menuToRoute(router, layoutName, modulesFileList, menu.children, menu);
+            }
+            continue;
+        }
+        // 安全处理组件路径
+        const safePath = menu.component.replace(/[^a-zA-Z0-9/._-]/g, '');
+        if (!safePath.startsWith('/') || safePath.includes('..')) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'INVALID_COMPONENT_PATH',
+                message: `组件路径拼写不符合规则，应以 '/' 开头且不能包含 '..'，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
+                timestamp: new Date().toISOString()
+            });
+            continue;
+        }
+        // 获取组件加载器
+        const loader = getComponentLoader(safePath, modulesFileList);
+        if (!loader) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'COMPONENT_NOT_FOUND',
+                message: `组件加载器无效，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
+                timestamp: new Date().toISOString()
+            });
+            continue;
+        }
+        // 构建路由记录
+        const routeRecord = {
+            name: menu.name,
+            path: menu.path,
+            meta: menu.meta,
+            redirect: menu.redirect,
+            component: () => loader()
+        };
+        // 根据 global 字段决定添加为全局路由还是布局子路由
+        if (menu.meta?.global) {
+            router.addRoute(routeRecord);
+        }
+        else {
+            router.addRoute(layoutName, routeRecord);
+        }
+    }
+};
+export { createVueRouter, setupDynamicRoutes, routerPush, routerReplace, getRoutes, useRoute };

package/dist/router/types.d.ts

@@ -0,0 +1,21 @@
+import type { RouteRecordRaw, RouteMeta, RouterOptions, RouteLocationNormalizedGeneric } from 'vue-router';
+export interface MenuItem {
+    meta: RouteMeta;
+    path: string;
+    name?: string;
+    todoCount?: number;
+    component?: string;
+    redirect?: string;
+    children?: MenuItem[];
+}
+export interface RouteModule {
+    default: RouteRecordRaw | RouteRecordRaw[];
+}
+export type FileModules = Record<string, () => Promise<RouteModule>>;
+export interface CreateVueRouter<GC = unknown> {
+    options: Partial<RouterOptions>;
+    fileModules: FileModules;
+    layoutName?: string;
+    globalComponent?: Promise<GC>;
+    handleBeforeEach?: (to: RouteLocationNormalizedGeneric) => void;
+}

package/dist/router/types.js

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

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

@@ -12,14 +12,4 @@ declare const DEFAULT_OPTIONS: {
  * @description 用于标识应用的主布局组件
  */
 declare const LAYOUT_NAME = "Layout";
-/**
- * 模块基础路径
- * @description 用于动态导入视图组件的基础路径
- */
-declare const MODULES_BASE = "";
-/**
- * 异步获取菜单项的默认实现
- * @returns 空菜单项数组的 Promise
- */
-declare const asyncGetMenus: () => Promise<never[]>;
-export { DEFAULT_OPTIONS, LAYOUT_NAME, MODULES_BASE, asyncGetMenus };
+export { DEFAULT_OPTIONS, LAYOUT_NAME };

package/dist/utils/router/defaults.js

@@ -13,14 +13,4 @@ const DEFAULT_OPTIONS = {
  * @description 用于标识应用的主布局组件
  */
 const LAYOUT_NAME = 'Layout';
-/**
- * 模块基础路径
- * @description 用于动态导入视图组件的基础路径
- */
-const MODULES_BASE = '';
-/**
- * 异步获取菜单项的默认实现
- * @returns 空菜单项数组的 Promise
- */
-const asyncGetMenus = () => Promise.resolve([]);
-export { DEFAULT_OPTIONS, LAYOUT_NAME, MODULES_BASE, asyncGetMenus };
+export { DEFAULT_OPTIONS, LAYOUT_NAME };

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

@@ -2,32 +2,19 @@
  * @Author : TanRui
  * @WeChat : Tan578853789
  * @File   : index.ts
- * @Date   : 2025/10/07
- * @Desc.  : 路由入口
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
  */
-import { useRoute, type RouteLocationRaw, type NavigationFailure } from 'vue-router';
-import type { MenuItem, CreateVueRouterOptions } from './types';
+import { useRoute, type Router, type RouterOptions, type RouteLocationRaw } from 'vue-router';
+import type { MenuItem, ModulesFileList } from './types';
 /**
- * 创建 Vue Router 实例
- * @param options - 实例的配置项
- * @param layoutName - 布局组件名称，默认为 'Layout'
- * @param modulesBase - 模块基础路径，默认为 ''
- * @param modulesList - 模块列表对象
- * @param asyncGetMenusFn - 异步获取菜单项处理函数
- * @returns router 路由实例
- * @returns setupDynamicRoutes 动态路由加载函数
- * @returns useRoute 路由使用函数
- * @returns routerPush 路由跳转函数
- * @returns routerReplace 路由替换函数
- * @returns getRoutes 获取路由函数
- * @example const { router, setupDynamicRoutes } = createVueRouter({})
+ * 创建 vue-router 实例
+ * @param options - 配置项
+ * @returns router 实例
  */
-declare const createVueRouter: ({ options, layoutName, modulesBase, modulesList, asyncGetMenusFn }?: CreateVueRouterOptions) => {
-    router: import("vue-router").Router;
-    setupDynamicRoutes: () => Promise<void>;
-    useRoute: typeof useRoute;
-    routerPush: (to: RouteLocationRaw) => Promise<undefined | void | NavigationFailure>;
-    routerReplace: (to: RouteLocationRaw) => Promise<undefined | void | NavigationFailure>;
-    getRoutes: () => MenuItem[];
-};
-export { createVueRouter };
+declare const createVueRouter: (options: Partial<RouterOptions>) => Router;
+declare const routerPush: (to: RouteLocationRaw, router: Router) => Promise<void | import("vue-router").NavigationFailure>;
+declare const routerReplace: (to: RouteLocationRaw, router: Router) => Promise<void | import("vue-router").NavigationFailure>;
+declare const getRoutes: (router: Router) => MenuItem[];
+declare const setupDynamicRoutes: (router: Router, layoutName: string | undefined, userRoutes: MenuItem[], modulesFileList: ModulesFileList) => Promise<void>;
+export { createVueRouter, setupDynamicRoutes, routerPush, routerReplace, getRoutes, useRoute, type ModulesFileList };

package/dist/utils/router/index.js

@@ -2,161 +2,145 @@
  * @Author : TanRui
  * @WeChat : Tan578853789
  * @File   : index.ts
- * @Date   : 2025/10/07
- * @Desc.  : 路由入口
+ * @Date   : 2025/11/07
+ * @Desc.  : 路由
  */
 import { createRouter, useRoute } from 'vue-router';
-import { DEFAULT_OPTIONS, LAYOUT_NAME, MODULES_BASE, asyncGetMenus } from './defaults';
+import { DEFAULT_OPTIONS, LAYOUT_NAME } from './defaults';
 /**
- * 创建 Vue Router 实例
- * @param options - 实例的配置项
- * @param layoutName - 布局组件名称，默认为 'Layout'
- * @param modulesBase - 模块基础路径，默认为 ''
- * @param modulesList - 模块列表对象
- * @param asyncGetMenusFn - 异步获取菜单项处理函数
- * @returns router 路由实例
- * @returns setupDynamicRoutes 动态路由加载函数
- * @returns useRoute 路由使用函数
- * @returns routerPush 路由跳转函数
- * @returns routerReplace 路由替换函数
- * @returns getRoutes 获取路由函数
- * @example const { router, setupDynamicRoutes } = createVueRouter({})
+ * 创建 vue-router 实例
+ * @param options - 配置项
+ * @returns router 实例
  */
-const createVueRouter = ({ options = {}, layoutName = LAYOUT_NAME, modulesBase = MODULES_BASE, modulesList = [], asyncGetMenusFn } = {}) => {
-    const ops = { ...DEFAULT_OPTIONS, ...options };
-    // 创建路由实例
-    const router = createRouter(ops);
-    // 组件加载器
-    const getComponentLoader = (safePath) => {
-        // console.log(modulesBase + `/src/views${safePath}.vue`)
-        return modulesList[modulesBase + `/src/views${safePath}.vue`];
-    };
-    // 异步获取菜单项处理函数
-    const handleAsyncGetMenus = asyncGetMenusFn ?? asyncGetMenus;
-    // 将菜单项转换为路由记录
-    const menuToRoute = async (menus, parent) => {
-        for (const menu of menus) {
-            menu.meta.fullPathTitle = parent
-                ? parent.meta.fullPathTitle + ',' + menu.meta.title
-                : menu.meta.title;
-            // 当前项若没有component，则为目录，直接递归处理
-            if (!menu.component) {
-                if (menu.children && menu.children.length > 0) {
-                    await menuToRoute(menu.children, menu);
-                }
-                continue;
-            }
-            // 安全处理组件路径
-            const safePath = menu.component.replace(/[^a-zA-Z0-9/._-]/g, '');
-            if (!safePath.startsWith('/') || safePath.includes('..')) {
-                console.warn('[Router] 组件加载失败', {
-                    code: 'INVALID_COMPONENT_PATH',
-                    message: `组件路径拼写不符合规则，应以 '/' 开头且不能包含 '..'，请检查 component 字段是否配置正确`,
-                    menu: {
-                        path: menu.path,
-                        name: menu.name,
-                        component: menu.component
-                    },
-                    timestamp: new Date().toISOString()
-                });
-                continue;
-            }
-            // 获取组件加载器
-            const loader = getComponentLoader(safePath);
-            if (!loader) {
-                console.warn('[Router] 组件加载失败', {
-                    code: 'COMPONENT_NOT_FOUND',
-                    message: `组件加载器无效，请检查 component 字段是否配置正确`,
-                    menu: {
-                        path: menu.path,
-                        name: menu.name,
-                        component: menu.component
-                    },
-                    timestamp: new Date().toISOString()
-                });
-                continue;
-            }
-            // 构建路由记录
-            const routeRecord = {
-                name: menu.name,
-                path: menu.path,
-                meta: menu.meta,
-                redirect: menu.redirect,
-                component: () => loader()
-            };
-            // 根据 global 字段决定添加为全局路由还是布局子路由
-            if (menu.meta?.global) {
-                router.addRoute(routeRecord);
-            }
-            else {
-                router.addRoute(layoutName, routeRecord);
-            }
-        }
-    };
-    // 加载动态路由
-    const setupDynamicRoutes = async () => {
-        const userRoutes = await handleAsyncGetMenus();
-        menuToRoute(userRoutes);
-    };
+const createVueRouter = (options) => {
+    const router = createRouter({ ...DEFAULT_OPTIONS, ...options });
     // 获取用户权限
-    const canUserAccess = async (to) => {
-        const isAuthenticated = true;
-        return to.name === 'Login' || to.meta.noAuth || isAuthenticated;
-    };
+    // const canUserAccess = async (to: RouteLocationNormalized) => {
+    //   const isAuthenticated = true
+    //   return to.name === 'Login' || to.meta.noAuth || isAuthenticated
+    // }
     // 全局前置守卫
     router.beforeEach(async (to) => {
-        const canAccess = await canUserAccess(to);
-        if (!canAccess) {
-            return {
-                name: 'Login',
-                query: { redirect: to.name?.toString() }
-            };
-        }
+        // const canAccess = await canUserAccess(to)
+        // if (!canAccess) {
+        //   return {
+        //     name: 'Login',
+        //     query: { redirect: to.name?.toString() }
+        //   }
+        // }
     });
-    // 路由跳转
-    const routerPush = async (to) => {
-        try {
-            const failure = await router.push(to);
-            return failure;
+    return router;
+};
+// 路由跳转
+const routerPush = async (to, router) => {
+    try {
+        const failure = await router.push(to);
+        return failure;
+    }
+    catch (e) {
+        console.warn('[router.push] 失败', {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router.push({ name: '404' });
+    }
+};
+// 路由替换
+const routerReplace = async (to, router) => {
+    try {
+        const failure = await router.replace(to);
+        return failure;
+    }
+    catch (e) {
+        console.warn('[router.replace] 失败', {
+            code: 'ROUTER_NOT_MATCH',
+            message: '未匹配到有效路由',
+            error: to || e,
+            timestamp: new Date().toISOString()
+        });
+        router.replace({ name: '404' });
+    }
+};
+// 获取路由
+const getRoutes = (router) => {
+    const temp = [];
+    for (const route of router.getRoutes()) {
+        temp.push({
+            name: route.name,
+            path: route.path,
+            meta: route.meta
+        });
+    }
+    return temp;
+};
+// 加载动态路由
+const setupDynamicRoutes = async (router, layoutName = LAYOUT_NAME, userRoutes, modulesFileList) => {
+    menuToRoute(router, layoutName, modulesFileList, userRoutes, undefined);
+};
+// 组件加载器
+const getComponentLoader = (safePath, modulesFileList) => {
+    return modulesFileList[`/src/views${safePath}.vue`];
+};
+// 将菜单项转换为路由记录
+const menuToRoute = async (router, layoutName, modulesFileList, menus, parent) => {
+    for (const menu of menus) {
+        menu.meta.fullPathTitle = parent
+            ? parent.meta.fullPathTitle + ',' + menu.meta.title
+            : menu.meta.title;
+        // 当前项若没有component，则为目录，直接递归处理
+        if (!menu.component) {
+            if (menu.children && menu.children.length > 0) {
+                await menuToRoute(router, layoutName, modulesFileList, menu.children, menu);
+            }
+            continue;
         }
-        catch (e) {
-            console.warn('[router.push] 失败', {
-                code: 'ROUTER_NOT_MATCH',
-                message: '未匹配到有效路由',
-                error: to || e,
+        // 安全处理组件路径
+        const safePath = menu.component.replace(/[^a-zA-Z0-9/._-]/g, '');
+        if (!safePath.startsWith('/') || safePath.includes('..')) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'INVALID_COMPONENT_PATH',
+                message: `组件路径拼写不符合规则，应以 '/' 开头且不能包含 '..'，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
                 timestamp: new Date().toISOString()
             });
-            router.push({ name: '404' });
-        }
-    };
-    // 路由替换
-    const routerReplace = async (to) => {
-        try {
-            const failure = await router.replace(to);
-            return failure;
+            continue;
         }
-        catch (e) {
-            console.warn('[router.replace] 失败', {
-                code: 'ROUTER_NOT_MATCH',
-                message: '未匹配到有效路由',
-                error: to || e,
+        // 获取组件加载器
+        const loader = getComponentLoader(safePath, modulesFileList);
+        if (!loader) {
+            console.warn('[Router] 组件加载失败', {
+                code: 'COMPONENT_NOT_FOUND',
+                message: `组件加载器无效，请检查 component 字段是否配置正确`,
+                menu: {
+                    path: menu.path,
+                    name: menu.name,
+                    component: menu.component
+                },
                 timestamp: new Date().toISOString()
             });
-            router.replace({ name: '404' });
+            continue;
         }
-    };
-    // 获取路由
-    const getRoutes = () => {
-        const temp = [];
-        for (const route of router.getRoutes()) {
-            temp.push({
-                name: route.name,
-                path: route.path,
-                meta: route.meta
-            });
+        // 构建路由记录
+        const routeRecord = {
+            name: menu.name,
+            path: menu.path,
+            meta: menu.meta,
+            redirect: menu.redirect,
+            component: () => loader()
+        };
+        // 根据 global 字段决定添加为全局路由还是布局子路由
+        if (menu.meta?.global) {
+            router.addRoute(routeRecord);
+        }
+        else {
+            router.addRoute(layoutName, routeRecord);
         }
-        return temp;
-    };
-    return { router, setupDynamicRoutes, useRoute, routerPush, routerReplace, getRoutes };
+    }
 };
-export { createVueRouter };
+export { createVueRouter, setupDynamicRoutes, routerPush, routerReplace, getRoutes, useRoute };

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

@@ -0,0 +1,14 @@
+import type { RouteRecordNameGeneric, RouteRecordRaw, RouteMeta } from 'vue-router';
+export interface MenuItem {
+    name: string | RouteRecordNameGeneric;
+    path: string;
+    meta: RouteMeta;
+    todoCount?: number;
+    component?: string;
+    redirect?: string;
+    children?: MenuItem[];
+}
+export interface RouteModule {
+    default: RouteRecordRaw | RouteRecordRaw[];
+}
+export type ModulesFileList = Record<string, () => Promise<RouteModule>>;

package/dist/utils/router/types.js

@@ -0,0 +1,8 @@
+// router/types.ts 或类似位置
+export {};
+// export interface CreateVueRouterOptions {
+//   options?: Partial<RouterOptions>
+//   layoutName?: string
+//   modulesBase?: string
+//   modulesFileList?: Record<string, () => Promise<RouteModule>>
+// }

package/package.json

@@ -1,21 +1,19 @@
 {
   "name": "@jnrs/vue-core",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "As the name suggests.",
   "author": "Talia-Tan",
   "license": "ISC",
   "publishConfig": {
     "access": "public"
   },
-  "type": "module",
   "keywords": [
     "jnrs",
     "vue-core",
     "typescript",
     "helper"
   ],
-  "main": "dist/index.js",
-  "module": "dist/index.js",
+  "type": "module",
   "types": "dist/index.d.ts",
   "files": [
     "dist",
@@ -26,6 +24,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./router": {
+      "import": "./dist/router/index.js",
+      "types": "./dist/router/index.d.ts"
     }
   },
   "dependencies": {