@liujitcn/kratos-admin-core 0.0.1

package/dist/package/src/rpc/system/common/v1/enum.ts

@@ -0,0 +1,80 @@
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.11.8
+//   protoc               unknown
+// source: system/common/v1/enum.proto
+
+/* eslint-disable */
+
+/** 系统配置类型 */
+export enum BaseConfigType {
+  UNKNOWN_BCT = 0,
+  /** TEXT - 文本 */
+  TEXT = 1,
+  /** IMAGE - 图片 */
+  IMAGE = 2,
+  /** RICH_TEXT - 富文本 */
+  RICH_TEXT = 3,
+  /** DICT - 字典 */
+  DICT = 4,
+  /** BOOLEAN - 布尔 */
+  BOOLEAN = 5,
+}
+
+/** 定时任务日志状态 */
+export enum BaseJobLogStatus {
+  UNKNOWN_BJLS = 0,
+  /** SUCCESS - 成功 */
+  SUCCESS = 1,
+  /** FAIL - 失败 */
+  FAIL = 2,
+}
+
+/** 菜单类型 */
+export enum BaseMenuType {
+  UNKNOWN_MT = 0,
+  /** FOLDER - 目录 */
+  FOLDER = 1,
+  /** MENU - 菜单 */
+  MENU = 2,
+  /** BUTTON - 按钮 */
+  BUTTON = 3,
+  /** EXT_LINK - 外部链接 */
+  EXT_LINK = 4,
+}
+
+/** 角色数据范围 */
+export enum BaseRoleDataScope {
+  UNKNOWN_RDS = 0,
+  /** ALL - 全部数据 */
+  ALL = 1,
+  /** DEPT_AND_CHILDREN - 部门及子部门数据 */
+  DEPT_AND_CHILDREN = 2,
+  /** SELF_DEPT - 本部门数据 */
+  SELF_DEPT = 3,
+  /** SELF_USER - 本人数据 */
+  SELF_USER = 4,
+}
+
+/** 用户性别 */
+export enum BaseUserGender {
+  UNKNOWN_BUG = 0,
+  /** SECRET - 保密 */
+  SECRET = 1,
+  /** BOY - 男 */
+  BOY = 2,
+  /** GIRL - 禁用 */
+  GIRL = 3,
+}
+
+/** 代码生成表状态 */
+export enum CodeGenTableStatus {
+  /** UNKNOWN_CGTS - 未指定 */
+  UNKNOWN_CGTS = 0,
+  /** DRAFT_CGTS - 草稿 */
+  DRAFT_CGTS = 1,
+  /** GENERATED_CGTS - 已生成 */
+  GENERATED_CGTS = 2,
+  /** DISABLED_CGTS - 停用 */
+  DISABLED_CGTS = 3,
+}

package/dist/package/src/security.ts

@@ -0,0 +1,3 @@
+export * from "./utils/oauthProvider";
+export * from "./utils/passwordCrypto";
+export * from "./utils/passwordStrength";

package/dist/package/src/stores/helper/persist.ts

@@ -0,0 +1,19 @@
+import type { PersistenceOptions } from "pinia-plugin-persistedstate";
+
+/**
+ * @description pinia 持久化参数配置
+ * @param {String} key 存储到持久化的 name
+ * @param {Array} paths 需要持久化的 state name
+ * @return persist
+ * */
+const piniaPersistConfig = (key: string, paths?: string[]) => {
+  const persist: PersistenceOptions = {
+    key,
+    storage: localStorage,
+    // storage: sessionStorage,
+    pick: paths
+  };
+  return persist;
+};
+
+export default piniaPersistConfig;

package/dist/package/src/stores/index.ts

@@ -0,0 +1,8 @@
+import { createPinia } from "pinia";
+import piniaPluginPersistedstate from "pinia-plugin-persistedstate";
+
+// pinia persist
+const pinia = createPinia();
+pinia.use(piniaPluginPersistedstate);
+
+export default pinia;

package/dist/package/src/stores/interface/index.ts

@@ -0,0 +1,102 @@
+import type { RouteItem, UserInfoForm } from "../../rpc/system/admin/v1/auth";
+import type { OptionBaseDictResponse_BaseDictItem } from "../../rpc/system/admin/v1/base_dict";
+
+/** 后台整体布局模式。 */
+export type LayoutType = "vertical" | "classic" | "transverse" | "columns";
+
+/** Element Plus 组件默认尺寸。 */
+export type AssemblySizeType = "large" | "default" | "small";
+
+/** 站点展示配置 */
+export interface SiteDisplayConfig {
+  /** 项目名称 */
+  sysName: string;
+  /** ICP 备案号 */
+  icp: string;
+  /** 版权文案 */
+  copyright: string;
+  /** 页面水印文案 */
+  watermark: string;
+  /** 管理端 Logo 地址 */
+  adminLogo: string;
+  /** 登录页左侧背景图地址 */
+  background: string;
+}
+
+/** 登录验证码配置 */
+export interface LoginCaptchaConfig {
+  /** 验证码类型 */
+  type: string;
+}
+
+/** 全局 UI 偏好和布局状态。 */
+export interface GlobalState {
+  layout: LayoutType;
+  assemblySize: AssemblySizeType;
+  maximize: boolean;
+  primary: string;
+  isDark: boolean;
+  isGrey: boolean;
+  isWeak: boolean;
+  asideInverted: boolean;
+  headerInverted: boolean;
+  isCollapse: boolean;
+  accordion: boolean;
+  watermark: boolean;
+  breadcrumb: boolean;
+  breadcrumbIcon: boolean;
+  tabs: boolean;
+  tabsIcon: boolean;
+  footer: boolean;
+}
+
+/** 当前登录用户认证状态。 */
+export interface UserState {
+  token: string;
+  refreshToken: string;
+  tokenType: string;
+  tokenExpiresAt: number;
+  userInfo: UserInfoForm;
+}
+
+/** 标签页菜单项状态。 */
+export interface TabsMenuProps {
+  icon: string;
+  title: string;
+  path: string;
+  name: string;
+  close: boolean;
+  isKeepAlive: boolean;
+}
+
+/** 多标签页状态。 */
+export interface TabsState {
+  tabsMenuList: TabsMenuProps[];
+}
+
+/** 动态路由和按钮权限状态。 */
+export interface AuthState {
+  routeName: string;
+  authButtonList: {
+    [key: string]: string[];
+  };
+  authMenuList: RouteItem[];
+}
+
+/** 需要缓存的页面组件名称状态。 */
+export interface KeepAliveState {
+  keepAliveName: string[];
+}
+
+/** 全局字典缓存状态。 */
+export interface DictState {
+  dictionary: Record<string, OptionBaseDictResponse_BaseDictItem[]>;
+}
+
+/** 站点配置状态 */
+export interface SiteConfigState {
+  /** 当前站点展示配置 */
+  display: SiteDisplayConfig;
+  /** 当前登录验证码配置 */
+  captcha: LoginCaptchaConfig;
+}

package/dist/package/src/stores/modules/auth.ts

@@ -0,0 +1,73 @@
+import { defineStore } from "pinia";
+import { defAuthService } from "../../api/system/auth";
+import { AuthState } from "../../stores/interface";
+import { getFlatMenuList, getShowMenuList, getAllBreadcrumbList, isExternalPath } from "../../utils";
+import type { RouteItem } from "../../rpc/system/admin/v1/auth";
+
+const GLOBAL_AUTH_BUTTON_KEY = "__global__";
+
+/** 规范化路由路径，统一转换为绝对路径。 */
+function normalizeRoutePath(path?: string, parentPath = "") {
+  if (!path) return "";
+  if (path === "/") return "/";
+  if (isExternalPath(path)) return path;
+  if (path.startsWith("/")) return path;
+
+  const normalizedParentPath = parentPath && parentPath !== "/" ? parentPath.replace(/\/+$/, "") : "";
+  const normalizedCurrentPath = path.replace(/^\/+/, "");
+  const pathSegments = [normalizedParentPath.replace(/^\/+/, ""), normalizedCurrentPath].filter(Boolean);
+  return `/${pathSegments.join("/")}`;
+}
+
+/** 递归规范化菜单树，避免菜单点击时发生相对路径拼接。 */
+function normalizeRouteTree(menuList: RouteItem[], parentPath = ""): RouteItem[] {
+  return menuList.map(item => {
+    const currentPath = normalizeRoutePath(item.path, parentPath);
+    return {
+      ...item,
+      path: currentPath,
+      children: normalizeRouteTree(item.children ?? [], currentPath)
+    };
+  });
+}
+
+export const useAuthStore = defineStore("admin-auth", {
+  state: (): AuthState => ({
+    // 按钮权限列表
+    authButtonList: {},
+    // 菜单权限列表
+    authMenuList: [],
+    // 当前页面的 router name，用来做按钮权限筛选
+    routeName: ""
+  }),
+  getters: {
+    // 按钮权限列表
+    authButtonListGet: state => state.authButtonList,
+    // 菜单权限列表 ==> 这里的菜单没有经过任何处理
+    authMenuListGet: state => state.authMenuList,
+    // 菜单权限列表 ==> 左侧菜单栏渲染，需要剔除 hide == true
+    showMenuListGet: state => getShowMenuList(state.authMenuList),
+    // 菜单权限列表 ==> 扁平化之后的一维数组菜单，主要用来添加动态路由
+    flatMenuListGet: state => getFlatMenuList(state.authMenuList),
+    // 递归处理后的所有面包屑导航列表
+    breadcrumbListGet: state => getAllBreadcrumbList(state.authMenuList)
+  },
+  actions: {
+    /** 获取按钮权限列表 */
+    async getAuthButtonList() {
+      const data = await defAuthService.ListUserButton({});
+      this.authButtonList = {
+        [GLOBAL_AUTH_BUTTON_KEY]: data.value ?? []
+      };
+    },
+    /** 获取菜单权限列表 */
+    async getAuthMenuList() {
+      const data = await defAuthService.TreeUserMenu({});
+      this.authMenuList = normalizeRouteTree(data.routes ?? []);
+    },
+    /** 设置当前路由名称 */
+    async setRouteName(name: string) {
+      this.routeName = name;
+    }
+  }
+});

package/dist/package/src/stores/modules/config.ts

@@ -0,0 +1,119 @@
+import { defineStore } from "pinia";
+import { defConfigService } from "../../api/base/config";
+import { BaseConfigSite } from "../../rpc/common/v1/enum";
+import type { LoginCaptchaConfig, SiteConfigState, SiteDisplayConfig } from "../../stores/interface";
+import defaultLogoUrl from "../../assets/images/logo.svg";
+import defaultBackgroundUrl from "../../assets/images/login_left.png";
+
+const CAPTCHA_TYPE_KEY = "captchaType";
+
+const DEFAULT_SITE_DISPLAY_CONFIG: SiteDisplayConfig = {
+  sysName: "Admin",
+  icp: "",
+  copyright: "2026 © Admin",
+  watermark: "Admin",
+  adminLogo: defaultLogoUrl,
+  background: defaultBackgroundUrl
+};
+
+const DEFAULT_LOGIN_CAPTCHA_CONFIG: LoginCaptchaConfig = {
+  type: "digit"
+};
+
+/**
+ * 合并站点展示配置，忽略空字符串配置，避免后端返回空值覆盖默认值。
+ */
+function mergeSiteDisplayConfig(
+  currentDisplayConfig: SiteDisplayConfig,
+  nextDisplayConfig: Partial<SiteDisplayConfig>
+): SiteDisplayConfig {
+  const mergedDisplayConfig = { ...currentDisplayConfig };
+
+  Object.entries(nextDisplayConfig).forEach(([key, value]) => {
+    if (typeof value !== "string") return;
+    if (!value.trim()) return;
+    mergedDisplayConfig[key as keyof SiteDisplayConfig] = value;
+  });
+
+  return mergedDisplayConfig;
+}
+
+/**
+ * 将服务端配置项转换为站点展示配置字段。
+ */
+function normalizeSiteDisplayConfig(configMap: Record<string, string>) {
+  return {
+    sysName: configMap.sysName,
+    icp: configMap.icp,
+    copyright: configMap.copyright,
+    watermark: configMap.watermark,
+    adminLogo: configMap.adminLogo,
+    background: configMap.background
+  } satisfies Partial<SiteDisplayConfig>;
+}
+
+/**
+ * 将服务端配置项转换为登录验证码配置字段。
+ */
+function normalizeLoginCaptchaConfig(configMap: Record<string, string>) {
+  return {
+    type: configMap[CAPTCHA_TYPE_KEY]
+  } satisfies Partial<LoginCaptchaConfig>;
+}
+
+/**
+ * 将公共配置列表转换为便于读取的键值映射。
+ */
+function buildConfigMap(configs: Array<{ key?: string; value?: string }>) {
+  const configMap: Record<string, string> = {};
+  configs.forEach(configItem => {
+    if (!configItem.key) return;
+    configMap[configItem.key] = configItem.value ?? "";
+  });
+  return configMap;
+}
+
+export const useConfigStore = defineStore("admin-config", {
+  state: (): SiteConfigState => ({
+    display: { ...DEFAULT_SITE_DISPLAY_CONFIG },
+    captcha: { ...DEFAULT_LOGIN_CAPTCHA_CONFIG }
+  }),
+  getters: {},
+  actions: {
+    /**
+     * 设置站点展示配置。
+     */
+    setDisplayConfig(nextDisplayConfig: Partial<SiteDisplayConfig>) {
+      this.display = mergeSiteDisplayConfig(this.display, nextDisplayConfig);
+    },
+    /**
+     * 设置登录验证码配置。
+     */
+    setLoginCaptchaConfig(nextCaptchaConfig: Partial<LoginCaptchaConfig>) {
+      this.captcha = {
+        ...this.captcha,
+        ...Object.fromEntries(Object.entries(nextCaptchaConfig).filter(([, value]) => typeof value === "string" && value))
+      };
+    },
+    /**
+     * 重置为默认站点展示配置。
+     */
+    resetDisplayConfig() {
+      this.display = { ...DEFAULT_SITE_DISPLAY_CONFIG };
+      this.captcha = { ...DEFAULT_LOGIN_CAPTCHA_CONFIG };
+    },
+    /**
+     * 加载管理端站点配置，并以服务端返回值覆盖本地默认值。
+     */
+    async loadDisplayConfig() {
+      const configResponse = await defConfigService.GetConfig({
+        site: BaseConfigSite.ADMIN
+      });
+      const configMap = buildConfigMap(configResponse.configs ?? []);
+
+      this.setDisplayConfig(normalizeSiteDisplayConfig(configMap));
+      this.setLoginCaptchaConfig(normalizeLoginCaptchaConfig(configMap));
+      return this.display;
+    }
+  }
+});

package/dist/package/src/stores/modules/dict.ts

@@ -0,0 +1,65 @@
+import { defineStore } from "pinia";
+import pinia from "../../stores";
+import { defBaseDictService } from "../../api/system/base_dict";
+import type { DictState } from "../../stores/interface";
+import piniaPersistConfig from "../../stores/helper/persist";
+import type { OptionBaseDictResponse_BaseDict, OptionBaseDictResponse_BaseDictItem } from "../../rpc/system/admin/v1/base_dict";
+
+export const useDictStore = defineStore("admin-dict", {
+  state: (): DictState => ({
+    dictionary: {}
+  }),
+  getters: {},
+  actions: {
+    /** 设置单个字典缓存 */
+    setDictionary(dict: OptionBaseDictResponse_BaseDict) {
+      if (!dict.code) return;
+      this.dictionary[dict.code] = dict.items ?? [];
+    },
+    /** 从服务端加载全部字典缓存 */
+    async loadDictionaries(forceRefresh = false) {
+      if (!forceRefresh && Object.keys(this.dictionary).length) return this.dictionary;
+
+      const dictRes = await defBaseDictService.OptionBaseDict({});
+      const nextDictionary: Record<string, OptionBaseDictResponse_BaseDictItem[]> = {};
+
+      const baseDicts = dictRes.base_dicts ?? [];
+      baseDicts.forEach(dict => {
+        if (!dict.code) return;
+        nextDictionary[dict.code] = dict.items ?? [];
+      });
+
+      this.dictionary = nextDictionary;
+      return this.dictionary;
+    },
+    /** 获取指定字典缓存 */
+    getDictionary(dictCode: string): OptionBaseDictResponse_BaseDictItem[] {
+      return this.dictionary[dictCode] ?? [];
+    },
+    /** 确保指定字典编码已加载，避免持久化旧缓存缺少新增字典时下拉为空 */
+    async ensureDictionary(dictCode: string) {
+      const cachedDict = this.getDictionary(dictCode);
+      if (cachedDict.length) return cachedDict;
+
+      await this.loadDictionaries(true);
+      return this.getDictionary(dictCode);
+    },
+    /** 清空字典缓存 */
+    clearDictionaryCache() {
+      this.dictionary = {};
+    },
+    /** 强制刷新字典缓存 */
+    async updateDictionaryCache() {
+      this.clearDictionaryCache();
+      await this.loadDictionaries(true);
+    }
+  },
+  persist: piniaPersistConfig("admin-dict")
+});
+
+/**
+ * 在非 setup 场景使用 Dict Store。
+ */
+export function useDictStoreHook() {
+  return useDictStore(pinia);
+}

package/dist/package/src/stores/modules/global.ts

@@ -0,0 +1,54 @@
+import { defineStore } from "pinia";
+import { GlobalState } from "../../stores/interface";
+import { DEFAULT_PRIMARY } from "../../config";
+import piniaPersistConfig from "../../stores/helper/persist";
+
+export const useGlobalStore = defineStore("admin-global", {
+  // 修改默认值之后，需清除 localStorage 数据
+  state: (): GlobalState => ({
+    // 布局模式 (纵向：vertical | 经典：classic | 横向：transverse | 分栏：columns)
+    layout: "vertical",
+    // element 组件大小
+    assemblySize: "default",
+    // 当前页面是否全屏
+    maximize: false,
+    // 主题颜色
+    primary: DEFAULT_PRIMARY,
+    // 深色模式
+    isDark: false,
+    // 灰色模式
+    isGrey: false,
+    // 色弱模式
+    isWeak: false,
+    // 侧边栏反转
+    asideInverted: false,
+    // 头部反转
+    headerInverted: false,
+    // 折叠菜单
+    isCollapse: false,
+    // 菜单手风琴
+    accordion: true,
+    // 页面水印
+    watermark: false,
+    // 面包屑导航
+    breadcrumb: true,
+    // 面包屑导航图标
+    breadcrumbIcon: true,
+    // 标签页
+    tabs: true,
+    // 标签页图标
+    tabsIcon: true,
+    // 页脚
+    footer: true
+  }),
+  getters: {},
+  actions: {
+    // Set GlobalState
+    setGlobalState(...args: ObjToKeyValArray<GlobalState>) {
+      this.$patch(state => {
+        state[args[0]] = args[1];
+      });
+    }
+  },
+  persist: piniaPersistConfig("admin-global")
+});

package/dist/package/src/stores/modules/keepAlive.ts

@@ -0,0 +1,22 @@
+import { defineStore } from "pinia";
+import { KeepAliveState } from "../../stores/interface";
+
+export const useKeepAliveStore = defineStore("admin-keepAlive", {
+  state: (): KeepAliveState => ({
+    keepAliveName: []
+  }),
+  actions: {
+    // Add KeepAliveName
+    async addKeepAliveName(name: string) {
+      !this.keepAliveName.includes(name) && this.keepAliveName.push(name);
+    },
+    // Remove KeepAliveName
+    async removeKeepAliveName(name: string) {
+      this.keepAliveName = this.keepAliveName.filter(item => item !== name);
+    },
+    // Set KeepAliveName
+    async setKeepAliveName(keepAliveName: string[] = []) {
+      this.keepAliveName = keepAliveName;
+    }
+  }
+});

package/dist/package/src/stores/modules/tabs.ts

@@ -0,0 +1,77 @@
+import router from "../../routers";
+import { defineStore } from "pinia";
+import { getUrlWithParams } from "../../utils";
+import { useKeepAliveStore } from "./keepAlive";
+import { TabsState, TabsMenuProps } from "../../stores/interface";
+import piniaPersistConfig from "../../stores/helper/persist";
+
+export const useTabsStore = defineStore("admin-tabs", {
+  state: (): TabsState => ({
+    tabsMenuList: []
+  }),
+  actions: {
+    /** 添加页签并同步 KeepAlive。 */
+    async addTabs(tabItem: TabsMenuProps) {
+      const keepAliveStore = useKeepAliveStore();
+      if (this.tabsMenuList.every(item => item.path !== tabItem.path)) {
+        this.tabsMenuList.push(tabItem);
+      }
+      // add keepalive
+      if (!keepAliveStore.keepAliveName.includes(tabItem.name) && tabItem.isKeepAlive) {
+        keepAliveStore.addKeepAliveName(tabItem.path);
+      }
+    },
+    /** 删除页签并同步 KeepAlive。 */
+    async removeTabs(tabPath: string, isCurrent: boolean = true) {
+      const keepAliveStore = useKeepAliveStore();
+      if (isCurrent) {
+        this.tabsMenuList.forEach((item, index) => {
+          if (item.path !== tabPath) return;
+          const nextTab = this.tabsMenuList[index + 1] || this.tabsMenuList[index - 1];
+          if (!nextTab) return;
+          router.push(nextTab.path);
+        });
+      }
+      // remove keepalive
+      const tabItem = this.tabsMenuList.find(item => item.path === tabPath);
+      tabItem?.isKeepAlive && keepAliveStore.removeKeepAliveName(tabItem.path);
+      // set tabs
+      this.tabsMenuList = this.tabsMenuList.filter(item => item.path !== tabPath);
+    },
+    /** 关闭指定页签一侧的其他页签。 */
+    async closeTabsOnSide(path: string, type: "left" | "right") {
+      const keepAliveStore = useKeepAliveStore();
+      const currentIndex = this.tabsMenuList.findIndex(item => item.path === path);
+      if (currentIndex !== -1) {
+        const range = type === "left" ? [0, currentIndex] : [currentIndex + 1, this.tabsMenuList.length];
+        this.tabsMenuList = this.tabsMenuList.filter((item, index) => {
+          return index < range[0] || index >= range[1] || !item.close;
+        });
+      }
+      // set keepalive
+      const KeepAliveList = this.tabsMenuList.filter(item => item.isKeepAlive);
+      keepAliveStore.setKeepAliveName(KeepAliveList.map(item => item.path));
+    },
+    /** 关闭除指定页签和固定页签外的其他页签。 */
+    async closeMultipleTab(tabsMenuValue?: string) {
+      const keepAliveStore = useKeepAliveStore();
+      this.tabsMenuList = this.tabsMenuList.filter(item => {
+        return item.path === tabsMenuValue || !item.close;
+      });
+      // set keepalive
+      const KeepAliveList = this.tabsMenuList.filter(item => item.isKeepAlive);
+      keepAliveStore.setKeepAliveName(KeepAliveList.map(item => item.path));
+    },
+    // Set Tabs
+    async setTabs(tabsMenuList: TabsMenuProps[]) {
+      this.tabsMenuList = tabsMenuList;
+    },
+    // Set Tabs Title
+    async setTabsTitle(title: string) {
+      this.tabsMenuList.forEach(item => {
+        if (item.path == getUrlWithParams()) item.title = title;
+      });
+    }
+  },
+  persist: piniaPersistConfig("admin-tabs")
+});