@das-fed/upf-utils 6.4.0-dev.236 → 6.4.0-dev.238

package/common-info/getPermissionMethod/index.d.ts

@@ -29,5 +29,31 @@ export declare const getGroupedCurrentUserPermissionList: () => {
 };
 export declare const getCurrentModulePermissionData: (returnType?: "id" | "code" | "all") => any;
 export declare const getCurrentUserPermissionList: (paramsObj: PermissionId | PermissionQueryInput | CurrentUserPermissionRequest, cb?: PermissionCallback<any[]>) => unknown;
-export declare const hasMenuPermissionByRouteCode: (routeCode: string, appId?: PermissionId) => any;
+/**
+ * 基于 sessionStorage 中的 menuList 树，判断当前用户是否拥有指定菜单或应用的访问权限。
+ *
+ * - 仅传 `appId`：判断该应用是否存在于权限列表中（应用级权限）。
+ * - 仅传 `routeCode`：在所有应用的菜单树中查找是否包含该路由编码（菜单级权限）。
+ * - 同时传入 `appId` 与 `routeCode`：在指定应用的菜单树中查找是否包含该路由编码。
+ * - 两者均未传：直接返回 `false`。
+ *
+ * 菜单匹配时仅采集最深层的菜单节点（父级容器节点不参与判断），以避免中间层级干扰鉴权结果。
+ *
+ * @param routeCode - 菜单路由编码，对应菜单配置中的 `routeCode` 字段，可不传。
+ * @param appId - 应用 ID，用于限定查询的应用范围，可不传。
+ * @returns `true` 表示拥有对应权限，`false` 表示无权限或参数无效。
+ *
+ * @example
+ * // 判断是否拥有某应用权限
+ * hasMenuPermissionByRouteCode(undefined, '001')
+ *
+ * @example
+ * // 判断是否拥有某菜单路由权限（全局范围）
+ * hasMenuPermissionByRouteCode('user.manage')
+ *
+ * @example
+ * // 判断在指定应用下是否拥有某菜单路由权限
+ * hasMenuPermissionByRouteCode('user.manage', '001')
+ */
+export declare const hasMenuPermissionByRouteCode: (routeCode?: string, appId?: PermissionId) => any;
 export {};