@skyfox2000/webui 1.0.13 → 1.2.0

package/src/index.ts

@@ -0,0 +1,201 @@
+// 类型定义 - 明确导出
+export type {
+   // 基础数据类型
+   AnyControl,
+   PostOptions,
+   ExecuteOptions,
+} from '@/typings/data.d';
+
+export type {
+   // 页面类型
+   PageControl,
+   PageControlOption,
+   PrimaryKey,
+} from '@/typings/page.d';
+
+// 导出枚举
+export { ProviderKeys } from '@/typings/page.d';
+
+export type {
+   // 表格类型
+   GridControl,
+   GridControlOption,
+} from '@/typings/table.d';
+
+export type {
+   // 表单类型
+   EditorControl,
+   EditorControlOption,
+   InputFactoryItems,
+   ValidateRule,
+   ValidateRuleItem,
+   ValidateError,
+} from '@/typings/form.d';
+
+export type {
+   // 工具按钮类型
+   ButtonTool,
+   ButtonTools,
+   ButtonType,
+   IconTool,
+   RowRecord,
+} from '@/typings/tools.d';
+
+export type {
+   // 树控件类型
+   TreeControl,
+   TreeControlOption,
+   TreeNode,
+} from '@/typings/tree.d';
+
+export type {
+   // 上传类型
+   UploadFile,
+   MinioFile,
+   ExcelFileParams,
+} from '@/typings/upload.d';
+
+// 导出上传状态枚举
+export { UploadStatus } from '@/typings/upload.d';
+
+export type {
+   // URL类型
+   ApiUrls,
+   ReqUrls,
+} from '@/typings/urls.d';
+
+export type {
+   // 选项类型
+   OptionItemProps,
+   OptionProps,
+   SelectValue,
+} from '@/typings/option.d';
+
+export type {
+   // 菜单类型
+   BreadcrumbRoute,
+} from '@/typings/menu.d';
+
+// 常量导出 - 明确导出
+export { OPTIONS } from '@/const/options';
+export { OptionCommProps } from '@/typings/option.d';
+
+// 指令模块导出
+export { initDirective } from '@/directives/index';
+
+// 工具函数导出 - 明确导出每个函数
+// isEmpty 工具
+export { isEmpty } from '@/utils/isEmpty';
+
+// tree 工具
+export { queryTree } from '@/utils/tree';
+
+// tools 工具
+export {
+   getToolByKey,
+   getToolGroup,
+   getToolStatus,
+   getToolVisible,
+   onReloadClick,
+   onToolClicked,
+   onFullscreenClick,
+   onColumnVisibleChanged,
+   defaultTools,
+   useToolFactory,
+} from '@/utils/tools';
+
+// page 工具
+export { initPageFactory, useEditorFactory, useGridFactory, useTreeFactory, usePageFactory } from '@/utils/page';
+
+// options 工具
+export {
+   loadOption,
+   unloadOption,
+   getSelectedValues,
+   outFormDataFields,
+   onOptionChanged,
+   getSelectedLabels,
+} from '@/utils/options';
+
+// download 工具
+export { downloadBlob, donwloadFromMinio } from '@/utils/download';
+
+// icon-loader 工具
+export {
+   ICONS_LIB,
+   checkIconsExpired,
+   circleLoading,
+   createFromIconfont,
+   parseIcons,
+   getIconTransform,
+} from '@/utils/icon-loader';
+
+// cache 工具
+export { CacheKeys, Cache, initCacheCheck } from '@/utils/cache';
+
+// menu 工具
+export { initMenu, crumbs, showBreadcrumb } from '@/utils/menu';
+
+// form 工具
+export { onFormSave, onFormSaveAs, onFormClose, saveForm, getFormDetail, openNewForm, setFormData } from '@/utils/form';
+
+// form-validate 工具
+export {
+   initValidate,
+   formValidate,
+   validateData,
+   resetRules,
+   getRuleTexts,
+   useInputFactory,
+   useFormItemFactory,
+} from '@/utils/form-validate';
+
+// form-excel 工具
+export { validateExcel, checkExcelDuplicates, processExcelFile } from '@/utils/form-excel';
+export type { ExcelMarkCell, ExcelMarkInfo } from '@/utils/form-excel';
+
+// table 工具
+export {
+   filterColumns,
+   mergeColumns,
+   gridQueryList,
+   gridQueryFind,
+   gridRowUpdate,
+   gridStatusUpdate,
+   getRecordDetail,
+   onGridRowExpand,
+   onGridRowEdit,
+   onGridRowDelete,
+} from '@/utils/table';
+
+// data 工具
+export { doQuery, doExecute, doSave, doDelete } from '@/utils/data';
+
+// export-table 工具
+export { exportSelectedRows, exportResults } from '@/utils/export-table';
+
+// file-upload 工具
+export { path, AsyncUploader } from '@/utils/file-upload';
+
+// eventbus 工具
+export { EventPrefix } from '@/utils/eventbus';
+export { default as eventBus } from '@/utils/eventbus';
+
+export {
+   getHostInfo,
+   getAppInfo,
+   userLogin,
+   userLogout,
+   getToken,
+   getUserInfo,
+   mainAppPush,
+} from '@/utils/main-openapis';
+
+import router from '@/router';
+export { router as AppRouter };
+
+export { useAppInfo } from '@/stores/appInfo';
+export { useHostInfo } from '@/stores/hostInfo';
+export { useUserInfo } from '@/stores/userInfo';
+export { usePageInfo } from '@/stores/pageInfo';
+export { useSettingInfo } from '@/stores/settingInfo';

package/src/router/index.ts

@@ -0,0 +1,196 @@
+import { useUserInfo } from '@/stores/userInfo';
+import { isMicroApp, mainAppApis, RouteRecord, EnvConfig } from '@skyfox2000/microbase';
+import { RouteLocationNormalizedGeneric, RouteRecordRaw, Router, createRouter, createWebHashHistory } from 'vue-router';
+import { useAppInfo } from '@/stores/appInfo';
+import { Ref, ref } from 'vue';
+
+export const LOGIN_PATH = '/login/';
+
+/**
+ * 默认路由
+ */
+const routes: RouteRecord[] = [];
+
+/**
+ * 添加子应用路径
+ * @param subRoutes 子应用路由
+ */
+export const addAppRoutes = (subRoutes: RouteRecord[]) => {
+   for (const route of subRoutes) {
+      /// 删除重复的路由
+      const index = routes.findIndex((r) => r.path === route.path);
+      if (index !== -1) {
+         routes.splice(index, 1);
+      }
+      routes.push(route);
+      router.addRoute(route);
+   }
+};
+
+/**
+ * 平铺路由地址，方便快速查找
+ */
+export const flattenRoute = (
+   route: RouteRecordRaw,
+   flattenRoutes: Record<string, RouteRecord>,
+   parent?: RouteRecord,
+   parentPath = '',
+): void => {
+   const path = parentPath + (parentPath ? '/' : '') + route.path;
+   flattenRoutes[path] = { ...route, parent: parent };
+   if (route.children) {
+      route.children.forEach((child) => flattenRoute(child, flattenRoutes, route as RouteRecord, path));
+   }
+};
+
+const router: Router = createRouter({
+   history: createWebHashHistory('/'),
+   routes: routes,
+});
+
+export { routes };
+
+/**
+ * 路由权限判断
+ * @param route 指定路由
+ * @param isLogin 是否已登录
+ * @returns 权限判断结果
+ */
+export const hasPermission = (route: RouteRecord, isLogin: boolean): boolean => {
+   const roles = route.meta?.roles ?? [];
+   const permission = route.meta?.permission;
+
+   // 如果用户未登录，且路由没有角色和权限要求，则允许访问
+   if (!isLogin) {
+      return roles.length === 0 && !permission;
+   }
+
+   // 如果用户已登录
+   if (isLogin) {
+      const userInfoStore = useUserInfo();
+
+      if (EnvConfig.VITE_PERMISSION_MODE === 'role') {
+         // 仅判断角色权限，未配置或者长度为0则可以访问
+         if (roles.length === 0) {
+            return true;
+         }
+         return userInfoStore.hasRole(roles);
+      } else if (EnvConfig.VITE_PERMISSION_MODE === 'permit') {
+         // 角色或权限任意满足要求即可
+
+         // 如果都没有配置，默认允许访问
+         if (roles.length === 0 && !permission) {
+            return true;
+         }
+
+         let hasRolePermission = false;
+         let hasPermitPermission = false;
+
+         // 检查角色权限
+         if (roles.length > 0) {
+            hasRolePermission = userInfoStore.hasRole(roles);
+         }
+
+         // 检查功能权限
+         if (permission) {
+            hasPermitPermission = userInfoStore.hasPermit(route.path, ':page');
+         }
+
+         // 任意一个有权限即可访问
+         return hasRolePermission || hasPermitPermission;
+      }
+   }
+
+   // 默认返回 false，即无匹配条件时不允许访问
+   return false;
+};
+
+// 保存等待处理的路由导航
+export const pendingNavigation: Ref<{ to: RouteLocationNormalizedGeneric; next: Function } | null> = ref(null);
+
+/**
+ * 路由导航守卫
+ * 处理权限检查和登录重定向
+ */
+router.beforeEach((to, _from, next) => {
+   const toRoute = to as unknown as RouteRecord;
+
+   if (to.path.startsWith('/error/') || to.path.startsWith(LOGIN_PATH)) {
+      return next();
+   }
+   const meta = toRoute.meta;
+   const roles = meta?.roles ?? [];
+   const requiresAuth = roles.length > 0 || meta?.permission?.length; // 判断是否需要权限
+
+   // 如果是根路径，重定向到默认页面
+   if (to.path === '/') {
+      const appInfoStore = useAppInfo();
+      if (!appInfoStore.menuLoaded) {
+         pendingNavigation.value = {
+            to,
+            next: (defaultPage: string) => {
+               next({ path: defaultPage });
+            },
+         };
+         return;
+      }
+      // 获取默认应用
+      appInfoStore.toDefaultApp();
+      return;
+   }
+
+   if (!requiresAuth) {
+      next(); // 不需要权限的页面，直接允许访问
+   } else {
+      const userInfoStore = useUserInfo();
+      if (!userInfoStore.isLogin) {
+         // 未登录，跳转到登录界面
+         next({ path: LOGIN_PATH });
+      } else {
+         const appInfoStore = useAppInfo();
+         // 如果菜单未加载完成且不是登录页，先保存当前导航信息，等待菜单加载完成
+         if (!appInfoStore.menuLoaded) {
+            pendingNavigation.value = {
+               to,
+               next,
+            };
+            return;
+         }
+
+         const permitResult = hasPermission(toRoute, userInfoStore.isLogin);
+         if (permitResult) {
+            next();
+         } else {
+            next(); // 无权限时重定向到403页面
+         }
+      }
+   }
+});
+
+/**
+ * 子应用更新主应用路由
+ */
+router.afterEach((to: RouteLocationNormalizedGeneric) => {
+   if (isMicroApp() && mainAppApis.value) {
+      const { mainAppPush } = mainAppApis.value;
+      if (mainAppPush) mainAppPush(to.hash);
+   }
+});
+
+/**
+ * 继续执行之前挂起的导航
+ * @param path 默认路径
+ */
+export const continueNavigation = (defaultPage: string) => {
+   if (pendingNavigation.value) {
+      const { to, next } = pendingNavigation.value;
+      pendingNavigation.value = null;
+      if (to.path === '/') {
+         next(defaultPage);
+      } else {
+         next(to.path);
+      }
+   }
+};
+
+export default router;