@owocow/saber-ui 0.0.1 → 0.0.3

package/dist/utils/crypto.d.ts

@@ -0,0 +1,11 @@
+import { default as CryptoJS } from 'crypto-js';
+/** 随机生成 AES 密钥 */
+export declare function generateAesKey(): CryptoJS.lib.WordArray;
+/** 将 WordArray 转为 Base64 字符串 */
+export declare function encryptBase64(str: CryptoJS.lib.WordArray): string;
+/** Base64 字符串转 WordArray */
+export declare function decryptBase64(str: string): CryptoJS.lib.WordArray;
+/** 使用 AES 密钥加密 */
+export declare function encryptWithAes(message: string, aesKey: CryptoJS.lib.WordArray): string;
+/** 使用 AES 密钥解密 */
+export declare function decryptWithAes(message: string, aesKey: CryptoJS.lib.WordArray): string;

package/dist/utils/crypto.mjs

@@ -0,0 +1,36 @@
+import t from "crypto-js";
+function o() {
+  const e = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let n = "";
+  for (let r = 0; r < 32; r++)
+    n += e.charAt(Math.floor(Math.random() * e.length));
+  return n;
+}
+function a() {
+  return t.enc.Utf8.parse(o());
+}
+function i(e) {
+  return t.enc.Base64.stringify(e);
+}
+function d(e) {
+  return t.enc.Base64.parse(e);
+}
+function p(e, n) {
+  return t.AES.encrypt(e, n, {
+    mode: t.mode.ECB,
+    padding: t.pad.Pkcs7
+  }).toString();
+}
+function s(e, n) {
+  return t.AES.decrypt(e, n, {
+    mode: t.mode.ECB,
+    padding: t.pad.Pkcs7
+  }).toString(t.enc.Utf8);
+}
+export {
+  d as decryptBase64,
+  s as decryptWithAes,
+  i as encryptBase64,
+  p as encryptWithAes,
+  a as generateAesKey
+};

package/dist/utils/filter.d.ts

@@ -0,0 +1,20 @@
+export interface StatusFilterOption {
+    label: string;
+    value: string | number | boolean;
+}
+export interface FilterOptions {
+    /** 筛选选项列表，用于 SaberSelect / USelect 的 items */
+    options: StatusFilterOption[];
+    /** value → label 映射，用于列表展示时反查文本 */
+    optionsMap: Record<string, string>;
+    /** value → SaberStatusType 映射，用于 SaberStatus 组件 */
+    statusTypeMap: Record<string, string>;
+}
+/**
+ * 从 'label:value[:statusType]' 格式的字符串数组生成筛选选项、反查 Map 与状态类型 Map
+ *
+ * @example
+ * createFilterOptions(['启用:1:success', '禁用:0:danger'])
+ * // { options: [{ label: '启用', value: '1' }, ...], optionsMap: { '1': '启用', ... }, statusTypeMap: { '1': 'success', ... } }
+ */
+export declare function createFilterOptions(map: string[]): FilterOptions;

package/dist/utils/filter.mjs

@@ -0,0 +1,11 @@
+function r(a) {
+  const o = [], n = {}, p = {};
+  for (const i of a) {
+    const t = i.split(":"), c = t[0], s = t[1], e = t[2];
+    o.push({ label: c, value: s }), n[s] = c, e && (p[s] = e);
+  }
+  return { options: o, optionsMap: n, statusTypeMap: p };
+}
+export {
+  r as createFilterOptions
+};

package/dist/utils/format.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 金额格式化工具
+ */
+/** 格式化金额为人民币格式，如 ¥ 1,234.56 */
+export declare function formatCurrency(value?: number, options?: {
+    prefix?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}): string;

package/dist/utils/format.mjs

@@ -0,0 +1,7 @@
+function m(i, t) {
+  const { prefix: r = "¥", minimumFractionDigits: n = 2, maximumFractionDigits: o = 2 } = t ?? {};
+  return i == null ? `${r} 0.00` : `${r} ${i.toLocaleString("zh-CN", { minimumFractionDigits: n, maximumFractionDigits: o })}`;
+}
+export {
+  m as formatCurrency
+};

package/dist/utils/http.d.ts

@@ -0,0 +1,45 @@
+import { ApiResponse, ListResponse } from '../types/api';
+export type { ApiResponse, ListResponse } from '../types/api';
+/** @deprecated 请使用 ListResponse。 */
+export type ListResult<T = unknown> = ListResponse<T>;
+export interface HttpConfig {
+    /** API 基础路径，如 `/api` */
+    baseURL: string;
+    /** 客户端标识，放入请求头 Clientid */
+    clientId: string;
+    /** 鉴权失败（token 无效/过期，code 401）回调，由业务方注入登出逻辑；403/402 视为无权限，仅提示不登出 */
+    onAuthError: () => void;
+    /** storage 中 token 的 key，默认 `'token'` */
+    tokenKey?: string;
+    /** 请求超时（毫秒），默认 10000 */
+    timeout?: number;
+    /** 是否启用请求/响应加密 */
+    encryptEnabled?: boolean;
+    /** 加密响应头的 key，默认 `'encrypt-key'` */
+    encryptHeaderKey?: string;
+}
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+interface RequestOptions {
+    method?: HttpMethod;
+    data?: object;
+    params?: object;
+    withToken?: boolean;
+    encrypt?: boolean;
+}
+interface UploadOptions {
+    data?: Record<string, string | Blob>;
+    field?: string;
+    onProgress?: (percent: number) => void;
+    withToken?: boolean;
+}
+export declare function setupHttp(config: HttpConfig): void;
+export declare function request<T = unknown>(url: string, options?: RequestOptions): Promise<T>;
+export declare const http: {
+    get<T = unknown, P extends object = object>(url: string, params?: P, withToken?: boolean): Promise<ApiResponse<T>>;
+    list<T = unknown, P extends object = object>(url: string, params?: P, withToken?: boolean): Promise<ListResponse<T>>;
+    post<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean, encrypt?: boolean): Promise<ApiResponse<T>>;
+    put<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean, encrypt?: boolean): Promise<ApiResponse<T>>;
+    patch<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean, encrypt?: boolean): Promise<ApiResponse<T>>;
+    delete<T = unknown, D extends object = object>(url: string, data?: D, withToken?: boolean): Promise<ApiResponse<T>>;
+    upload<T = unknown>(url: string, file: File | File[], options?: UploadOptions): Promise<T>;
+};

package/dist/utils/http.mjs

@@ -0,0 +1,147 @@
+import { ofetch as H } from "ofetch";
+import { decryptBase64 as L, decryptWithAes as O, generateAesKey as R, encryptBase64 as I, encryptWithAes as K } from "./crypto.mjs";
+import { rsaDecrypt as B, rsaEncrypt as U } from "./rsa.mjs";
+import { storage as k } from "./storage.mjs";
+import { getToast as T } from "./toast.mjs";
+let $ = "", S = "", _ = "token", y = null, b = !1, P = "encrypt-key", A = null;
+function v() {
+  if (!A)
+    throw new Error("[http] 尚未初始化，请先调用 setupHttp({ baseURL, clientId, onAuthError })");
+  return A;
+}
+function C() {
+  return new Headers({ Clientid: S });
+}
+function N(r) {
+  $ = r.baseURL, S = r.clientId, y = r.onAuthError, _ = r.tokenKey ?? "token", b = r.encryptEnabled ?? !1, P = r.encryptHeaderKey ?? "encrypt-key", A = H.create({
+    baseURL: $,
+    timeout: r.timeout ?? 1e4,
+    async onResponse({ response: t }) {
+      const e = b ? t.headers.get(P) : null;
+      if (e) {
+        const c = L(String(B(e)));
+        t._data = JSON.parse(O(String(t._data), c));
+      } else if (typeof t._data == "string")
+        try {
+          t._data = JSON.parse(t._data);
+        } catch {
+        }
+      const o = t._data;
+      if (!o) return;
+      const { code: n, msg: i } = o;
+      if (n === 200) return;
+      const p = T();
+      if (n === 401) {
+        p.add({ title: i, color: "error" }), y == null || y();
+        return;
+      }
+      if (n === 402 || n === 403) {
+        p.add({ title: i ?? "无权限访问该资源", color: "error" });
+        return;
+      }
+      if (n === 404) {
+        p.add({ title: "后端 API 不存在", color: "error" });
+        return;
+      }
+      throw p.add({ title: i ?? `请求失败，错误码：${n}`, color: "error" }), new Error(i ?? `请求失败，错误码：${n}`);
+    },
+    onResponseError({ response: t }) {
+      var n;
+      const e = t.status, o = (n = t._data) == null ? void 0 : n.msg;
+      T().add({
+        title: `请求错误 ${e}${o ? `：${o}` : ""}`,
+        color: "error"
+      });
+    }
+  });
+}
+function m(r, t = {}) {
+  const { method: e = "GET", data: o, params: n, withToken: i = !0, encrypt: p = !1 } = t, c = C();
+  if (i) {
+    const a = k.get(_);
+    a && c.set("Authorization", `Bearer ${a}`);
+  }
+  let f = e !== "GET" ? o : void 0, E;
+  if (b && p && (e === "POST" || e === "PUT" || e === "PATCH") && f) {
+    const a = R();
+    c.set(P, String(U(I(a)))), f = K(typeof f == "object" ? JSON.stringify(f) : String(f), a), E = "text";
+  }
+  return v()(r, {
+    method: e,
+    headers: c,
+    body: f,
+    query: e === "GET" ? { ...n, _t: Date.now() } : void 0,
+    responseType: E
+  });
+}
+const z = {
+  get(r, t, e = !0) {
+    return m(r, { method: "GET", params: t, withToken: e });
+  },
+  list(r, t, e = !0) {
+    return m(r, { method: "GET", params: t, withToken: e });
+  },
+  post(r, t, e = !0, o = !1) {
+    return m(r, { method: "POST", data: t, withToken: e, encrypt: o });
+  },
+  put(r, t, e = !0, o = !1) {
+    return m(r, { method: "PUT", data: t, withToken: e, encrypt: o });
+  },
+  patch(r, t, e = !0, o = !1) {
+    return m(r, { method: "PATCH", data: t, withToken: e, encrypt: o });
+  },
+  delete(r, t, e = !0) {
+    return m(r, { method: "DELETE", data: t, withToken: e });
+  },
+  upload(r, t, e = {}) {
+    const { data: o, field: n = "file", onProgress: i, withToken: p = !0 } = e, c = new FormData();
+    (Array.isArray(t) ? t : [t]).forEach((a) => c.append(n, a)), o && Object.entries(o).forEach(([a, l]) => c.append(a, l));
+    const E = $, g = { Clientid: S };
+    if (p) {
+      const a = k.get(_);
+      a && (g.Authorization = `Bearer ${a}`);
+    }
+    return new Promise((a, l) => {
+      const s = new XMLHttpRequest();
+      s.open("POST", `${E}${r}`), Object.entries(g).forEach(([u, d]) => s.setRequestHeader(u, d)), i && s.upload.addEventListener("progress", (u) => {
+        u.lengthComputable && i(Math.round(u.loaded / u.total * 100));
+      }), s.addEventListener("load", () => {
+        if (s.status < 200 || s.status >= 300) {
+          T().add({ title: `请求错误 ${s.status}`, color: "error" }), l(new Error(`请求错误 ${s.status}`));
+          return;
+        }
+        let u;
+        try {
+          u = JSON.parse(s.responseText);
+        } catch {
+          l(new Error("响应解析失败"));
+          return;
+        }
+        const { code: d, msg: h } = u;
+        if (d === 200) {
+          a(u.data);
+          return;
+        }
+        const w = T();
+        if (d === 401) {
+          w.add({ title: h, color: "error" }), y == null || y(), l(new Error(h ?? `鉴权失败，错误码：${d}`));
+          return;
+        }
+        if (d === 402 || d === 403) {
+          w.add({ title: h ?? "无权限访问该资源", color: "error" }), l(new Error(h ?? `无权限，错误码：${d}`));
+          return;
+        }
+        if (d === 404) {
+          w.add({ title: "后端 API 不存在", color: "error" }), l(new Error("后端 API 不存在"));
+          return;
+        }
+        w.add({ title: h ?? `上传失败，错误码：${d}`, color: "error" }), l(new Error(h ?? `上传失败，错误码：${d}`));
+      }), s.addEventListener("error", () => l(new Error("上传请求失败"))), s.send(c);
+    });
+  }
+};
+export {
+  z as http,
+  m as request,
+  N as setupHttp
+};

package/dist/utils/index.d.ts

@@ -0,0 +1,12 @@
+export * from './permission';
+export * from './format';
+export * from './filter';
+export * from './tree';
+export * from './crypto';
+export * from './toast';
+export * from './storage';
+export * from './rsa';
+export * from './http';
+export { jsonClone } from './klona';
+export { nanoid } from './nanoid';
+export { addressParse, createAddressParser, type AddressParseDistrict, type AddressParseResult, type AddressParser, } from './addressParse';

package/dist/utils/index.mjs

@@ -0,0 +1,41 @@
+import { canAccess as t, hasPermission as o, hasRole as s, setupPermission as p } from "./permission.mjs";
+import { formatCurrency as m } from "./format.mjs";
+import { createFilterOptions as c } from "./filter.mjs";
+import { createTreeFromList as x } from "./tree.mjs";
+import { decryptBase64 as y, decryptWithAes as d, encryptBase64 as u, encryptWithAes as h, generateAesKey as A } from "./crypto.mjs";
+import { getToast as l, setToast as P, tryGetToast as T } from "./toast.mjs";
+import { setupStorage as C, storage as F } from "./storage.mjs";
+import { rsaDecrypt as W, rsaEncrypt as j, setupRsa as k } from "./rsa.mjs";
+import { http as D, request as E, setupHttp as G } from "./http.mjs";
+import { klona as K } from "klona/json";
+import { nanoid as O } from "nanoid";
+import { addressParse as b, createAddressParser as v } from "./addressParse.mjs";
+export {
+  b as addressParse,
+  t as canAccess,
+  v as createAddressParser,
+  c as createFilterOptions,
+  x as createTreeFromList,
+  y as decryptBase64,
+  d as decryptWithAes,
+  u as encryptBase64,
+  h as encryptWithAes,
+  m as formatCurrency,
+  A as generateAesKey,
+  l as getToast,
+  o as hasPermission,
+  s as hasRole,
+  D as http,
+  K as jsonClone,
+  O as nanoid,
+  E as request,
+  W as rsaDecrypt,
+  j as rsaEncrypt,
+  P as setToast,
+  G as setupHttp,
+  p as setupPermission,
+  k as setupRsa,
+  C as setupStorage,
+  F as storage,
+  T as tryGetToast
+};

package/dist/utils/klona.d.ts

@@ -0,0 +1,2 @@
+import { klona as jsonClone } from 'klona/json';
+export { jsonClone };

package/dist/utils/klona.mjs

@@ -0,0 +1,4 @@
+import { klona as a } from "klona/json";
+export {
+  a as jsonClone
+};

package/dist/utils/nanoid.d.ts

@@ -0,0 +1,2 @@
+import { nanoid } from 'nanoid';
+export { nanoid };

package/dist/utils/nanoid.mjs

@@ -0,0 +1,4 @@
+import { nanoid as r } from "nanoid";
+export {
+  r as nanoid
+};

package/dist/utils/permission.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 权限鉴权工具模块
+ *
+ * 使用前必须在 main.ts 中 await setupPermission() 注入用户信息获取器：
+ *
+ * @example
+ * import { setupPermission } from '@owocow/saber-ui/utils/permission'
+ * import { useAuthStore } from '@/store/auth'
+ * import { SUPER_ADMIN_ROLE, SUPER_PERM } from '@/enums'
+ *
+ * await setupPermission(() => useAuthStore().userInfo, {
+ *   superRoles: [SUPER_ADMIN_ROLE],
+ *   superPerms: [SUPER_PERM],
+ * })
+ */
+/** 用户信息最小约定 — 只需 roles 和 permissions 两个字段 */
+export interface UserInfo {
+    roles: string[];
+    permissions: string[];
+}
+/** 路由/菜单/按钮 meta 中的权限配置 */
+export interface PermissionMeta {
+    roles?: string | string[];
+    permissions?: string | string[];
+}
+/** setupPermission 可选配置 */
+export interface PermissionOptions {
+    /** 超级管理员角色列表，命中任一即跳过所有鉴权；默认 ['admin'] */
+    superRoles?: string[];
+    /** 超级权限标识列表，命中任一即跳过权限检查；默认 ['*:*:*'] */
+    superPerms?: string[];
+}
+type UserInfoGetter = () => UserInfo | Promise<UserInfo>;
+/**
+ * 初始化权限模块，注入用户信息获取器。
+ * 会立即调用 getter 一次以验证可用性，因此支持 await。
+ */
+export declare function setupPermission(getter: UserInfoGetter, options?: PermissionOptions): Promise<void>;
+/** 是否拥有任一所需角色；required 为空视为通过 */
+export declare function hasRole(required?: string | string[]): boolean;
+/** 是否拥有任一所需权限；required 为空视为通过 */
+export declare function hasPermission(required?: string | string[]): boolean;
+/** 路由/菜单/按钮的统一鉴权入口 */
+export declare function canAccess(meta?: PermissionMeta | null): boolean;
+export {};

package/dist/utils/permission.mjs

@@ -0,0 +1,38 @@
+let u = null, t = ["admin"], i = ["*:*:*"];
+async function a(r, e) {
+  u = r, e != null && e.superRoles && (t = e.superRoles), e != null && e.superPerms && (i = e.superPerms), await r();
+}
+function f() {
+  if (!u)
+    throw new Error(
+      "[permission] 尚未初始化，请在 main.ts 调用 await setupPermission(() => useAuthStore().userInfo)"
+    );
+  return u();
+}
+function l(r) {
+  return Array.isArray(r) ? r : [r];
+}
+function s(r, e) {
+  return r.some((n) => e.includes(n));
+}
+function c(r) {
+  const e = r != null ? l(r).filter(Boolean) : [];
+  if (!e.length) return !0;
+  const { roles: n } = f();
+  return s(t, n) ? !0 : s(e, n);
+}
+function o(r) {
+  const e = r != null ? l(r).filter(Boolean) : [];
+  if (!e.length) return !0;
+  const { permissions: n } = f();
+  return s(i, n) ? !0 : s(e, n);
+}
+function m(r) {
+  return r ? c(r.roles) && o(r.permissions) : !0;
+}
+export {
+  m as canAccess,
+  o as hasPermission,
+  c as hasRole,
+  a as setupPermission
+};

package/dist/utils/rsa.d.ts

@@ -0,0 +1,26 @@
+/**
+ * RSA 加解密模块
+ *
+ * 使用前需在 main.ts 中调用 setupRsa() 注入密钥：
+ *
+ * @example
+ * import { setupRsa } from '@owocow/saber-ui/utils/rsa'
+ *
+ * setupRsa({
+ *   publicKey: import.meta.env.VITE_APP_RSA_PUBLIC_KEY,
+ *   privateKey: import.meta.env.VITE_APP_RSA_PRIVATE_KEY,
+ * })
+ *
+ * // 之后任意位置直接使用
+ * import { rsaEncrypt, rsaDecrypt } from '@owocow/saber-ui/utils/rsa'
+ */
+export interface RsaConfig {
+    publicKey: string;
+    privateKey: string;
+}
+/** 初始化 RSA 模块 */
+export declare function setupRsa(config: RsaConfig): void;
+/** RSA 公钥加密 */
+export declare function rsaEncrypt(txt: string): string | false;
+/** RSA 私钥解密 */
+export declare function rsaDecrypt(txt: string): string | false;