@usethink/shared-frontend 0.1.0

package/dist/utils/request.d.ts

@@ -0,0 +1,45 @@
+import type { AxiosRequestConfig } from "axios";
+import type { UploadFileParams } from "@/api/axios";
+export interface RequestOptions extends AxiosRequestConfig {
+    /** 是否直接将数据从响应中提取出(默认true)，例如直接返回 res.data，而忽略 res.code 等信息 */
+    isReturnResult?: boolean;
+    /** 请求成功是提示信息 */
+    successMsg?: string;
+    /** 请求失败是提示信息 */
+    errorMsg?: string;
+    /** 成功时，是否显示后端返回的成功信息 */
+    showSuccessMsg?: boolean;
+    /** 失败时，是否显示后端返回的失败信息 */
+    showErrorMsg?: boolean;
+    requestType?: "json" | "form";
+    /**
+     * 是否把参数添加到url中(POST)
+     */
+    isJoinParamsToUrl?: boolean;
+}
+/** 真实请求的路径前缀 */
+export declare const baseApiUrl: string;
+export declare const baseAotClientUrl: string;
+export type BaseResponse<T = any> = Omit<API.ResOp, "data"> & {
+    data: T;
+};
+export declare function request<T = any>(url: string, config: {
+    isReturnResult: false;
+} & RequestOptions): Promise<BaseResponse<T>>;
+export declare function request<T = any>(url: string, config: RequestOptions): Promise<BaseResponse<T>["data"]>;
+export declare function request<T = any>(config: {
+    isReturnResult: false;
+} & RequestOptions): Promise<BaseResponse<T>>;
+export declare function request<T = any>(config: RequestOptions): Promise<BaseResponse<T>["data"]>;
+/**
+ * Aot客户端请求
+ * @param config 配置项
+ */
+export declare function aotClientHttp<T = any>(config: AxiosRequestConfig): Promise<BaseResponse<T>["data"]>;
+/**
+ * 上传文件
+ * @param config 配置项
+ * @param params 参数
+ * @returns
+ */
+export declare const uploadFile: <T = any>(config: AxiosRequestConfig, params: UploadFileParams) => Promise<any>;

package/dist/utils/request.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("axios"),y=require("lodash-es"),B=require("qs"),S=require("ant-design-vue"),c=require("../enums/cacheEnum.js"),l=require("./Storage.js"),b=require("../enums/httpEnum.js"),I=require("../store/modules/user.js"),O=require("./nprogress.js"),$=require("../api/saveRefreshTime.js"),x=require("../api/login/index.js"),M=require("../router/index.js"),K=require("./urlUtils.js");var j={};const U="未知错误，请重试",H=j.VITE_BASE_API_URL,v=j.VITE_BASE_AOT_CLIENT_URL;let A=!1,_=[];function V(e){_.forEach(t=>t(e)),_=[]}function Y(e){_.push(e)}const d=w.create({baseURL:H,timeout:6e4,paramsSerializer(e){return B.stringify(e,{arrayFormat:"brackets"})}});d.interceptors.request.use(e=>{var a,n;O.start();const t=l.Storage.get(c.ACCESS_TOKEN_KEY,null,!0);return t&&e.headers&&(e.headers.Authorization=`Bearer ${t}`,(a=e.params)!=null&&a.HeaderUniqForm&&(e.headers.HeaderUniqForm=JSON.stringify(e.params.HeaderUniqForm),delete e.params.HeaderUniqForm),(n=e.data)!=null&&n.HeaderUniqForm&&delete e.data.HeaderUniqForm,$.saveRefreshtime()),(e.data??(e==null?void 0:e.params))&&(e.headers.get("Content-Type")||e.headers.set("Content-Type","application/json")),e},e=>Promise.reject(e));d.interceptors.response.use(e=>{var s;O.close();let t=e.data;if((s=e.config)!=null&&s.isCustomHttp_||t instanceof Blob||t instanceof ArrayBuffer)return Promise.resolve(e);if(!t||t.status!==b.ResultEnum.SUCCESS||!t.success){S.message.error((t==null?void 0:t.msg)||U),[1101,1102].includes(t.status)&&(l.Storage.remove(c.ACCESS_TOKEN_KEY),S.Modal.confirm({title:"警告",content:t.msg||"账号异常，您可以取消停留在该页上，或重新登录",okText:"重新登录",cancelText:"取消",onOk:()=>{localStorage.clear(),window.location.reload()}}));const a=new Error(t.msg||U);return a.status=t.status,Promise.reject(a)}else return e},e=>{var p,u,r,f,o,h,E,g,R,C,T,N,F;O.close();const t=l.Storage.getVal(c.IS_CHANGE_ROUTER),s=((p=e.config)==null?void 0:p.isCustomHttp_)??!1,a=((u=e.config)==null?void 0:u.isAotClientHttp_)??!1;if(!s&&(((r=e.response)==null?void 0:r.status)===401||((f=e.response)==null?void 0:f.status)===403&&t)){const i=Date.now(),P=l.Storage.getExpire(c.REFRESH_TIME);if(P&&i<=P)return A?new Promise(m=>{Y(q=>{var k;(k=e.config)!=null&&k.headers&&(e.config.headers.Authorization=`Bearer ${q}`),m(d(e.config))})}):(A=!0,x.refreshToken(l.Storage.get(c.ACCESS_TOKEN_KEY,null,!0)).then(m=>{var q;if(I.useUserStoreWithOut().setToken(m.token,m.expiresAt),S.message.loading("动态刷新token成功, 重新加载中...",1500),(q=e.config)!=null&&q.headers&&(e.config.headers.Authorization=`Bearer ${m.token}`),V(m.token),A=!1,t){M.default.go(0),l.Storage.setVal(c.IS_CHANGE_ROUTER,!1);return}return d(e.config)}).catch(()=>{A=!1,_=[],l.Storage.remove(c.ACCESS_TOKEN_KEY),window.location.reload()}));l.Storage.remove(c.ACCESS_TOKEN_KEY),window.location.reload()}let n=((h=(o=e==null?void 0:e.response)==null?void 0:o.data)==null?void 0:h.msg)??((g=(E=e==null?void 0:e.response)==null?void 0:E.data)==null?void 0:g.detail)??((C=(R=e==null?void 0:e.response)==null?void 0:R.data)==null?void 0:C.title)??((N=(T=e==null?void 0:e.response)==null?void 0:T.data)==null?void 0:N.errors)??(e==null?void 0:e.message)??U;if(typeof n=="object"&&(n=JSON.stringify(n)),(F=e.response)!=null&&F.data)try{const i=typeof e.response.data=="string"?JSON.parse(e.response.data):e.response.data;n=(i==null?void 0:i.msg)??(i==null?void 0:i.detail)??(i==null?void 0:i.title)??(i==null?void 0:i.errors)??n}catch{}return s?n=`自定义的请求返回错误: ${n}`:a&&(n=`Aot客户端请求返回错误: ${n}`),S.message.error({content:n,key:n}),e.message=n,Promise.reject(e)});async function z(e,t={}){let s=y.isString(e)?e:e.url;const a=y.isString(e)?t:e;try{const{requestType:n,isReturnResult:p=!0,isJoinParamsToUrl:u=!1,...r}=a;u&&(s=K.setObjToUrlParams(s,a.data));const f=await d.request({url:s,...r,headers:{...r.headers,...n==="form"?{"Content-Type":"multipart/form-data"}:{}}}),{data:o}=f;if(o instanceof Blob)return o;const{status:h,success:E,msg:g}=o||{};if(o&&Reflect.has(o,"status")&&h===b.ResultEnum.SUCCESS&&E){const{successMsg:C,showSuccessMsg:T}=a;T&&S.message.success(C??g??"操作成功!")}return p?o.data:o}catch(n){return Promise.reject(n)}}async function J(e){try{e.url=K.uniqueSlash(v+e.url),y.set(e,"isAotClientHttp_",!0);const t=await d.request(e),{data:s}=t;return(s==null?void 0:s.data)??s}catch(t){return Promise.reject(t)}}const L=async(e,t)=>{const s=new window.FormData,a=t.name||"file";t.filename?s.append(a,t.file,t.filename):s.append(a,t.file),t.data&&Object.keys(t.data).forEach(r=>{const f=t.data[r];if(Array.isArray(f)){f.forEach(o=>{s.append(`${r}[]`,o)});return}s.append(r,t.data[r])});const n=`${H+e.url}`;e.url=n;const p=await d.request({...e,method:"POST",data:s,headers:{"Content-type":b.ContentTypeEnum.FORM_DATA,IgnoreCancelToken:!0}}),{data:u}=p;return(u==null?void 0:u.data)??u};exports.aotClientHttp=J;exports.baseAotClientUrl=v;exports.baseApiUrl=H;exports.request=z;exports.uploadFile=L;

package/dist/utils/tableConfig.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 表格统一分页/样式/滚动配置
+ * 所有主数据表格统一使用此配置，避免各页面各自为政
+ *
+ * 设计原则：
+ * 1. 统一 size="small" — 行高紧凑，单屏信息密度高
+ * 2. 统一 scroll.y — 固定表头，数据区滚动，分页控件始终可见
+ * 3. 统一分页配置 — 页码、每页条数、总数显示一致
+ * 4. 筛选栏单行 — 不超过一行，控件紧凑，利用 card #extra 或紧凑 toolbar
+ *
+ * 空间预算（以 1080p 为例，视口高度 ~950px）：
+ *  独立页面：global-header(64) + page-pad(48) + card-title(46) + th(40) + pag(40) = 238 → 取 260px
+ *  Tab 内嵌：+ tabs-header(46) + 内层-padding(24) + toolbar(40) = 348 → 取 440px
+ */
+/** 默认分页配置 — 所有表格统一使用，pageSize 固定 20 */
+export declare const DEFAULT_PAGINATION: {
+    pageSize: number;
+    showSizeChanger: boolean;
+    pageSizeOptions: string[];
+    showTotal: (total: number) => string;
+};
+/** 表格统一尺寸 */
+export declare const TABLE_SIZE: "small";
+/**
+ * 独立页面表格 scroll.y
+ * 适用于筛选栏在 card #extra（单行）的场景：/device/iot、/device/exe、/device/audit 等
+ */
+export declare const PAGE_SCROLL_Y = "calc(100vh - 260px)";
+/**
+ * Tab 内嵌表格 scroll.y
+ * 适用于嵌在 a-tabs 内的表格：ExeRulesTab、TagManagementTab、MonitorTab、SimulationTab 等
+ */
+export declare const TAB_SCROLL_Y = "calc(100vh - 440px)";
+/**
+ * 生成分页配置
+ * @param total 数据总数，<= threshold 时禁用分页
+ * @param threshold 启用分页的最小数据量，默认 20
+ * @param overrides 覆盖默认值
+ */
+export declare function usePagination(total: number, threshold?: number, overrides?: Partial<typeof DEFAULT_PAGINATION>): false | {
+    pageSize: number;
+    showSizeChanger: boolean;
+    pageSizeOptions: string[];
+    showTotal: (total: number) => string;
+};

package/dist/utils/toolsValidate.d.ts

@@ -0,0 +1,153 @@
+/**
+ * 工具类集合，适用于平时开发
+ */
+/**
+ * 验证百分比（不可以小数）
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyNumberPercentage(val: string): string;
+/**
+ * 验证百分比（可以小数）
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyNumberPercentageFloat(val: string): string;
+/**
+ * 小数或整数(不可以负数)
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyNumberIntegerAndFloat(val: string): string;
+/**
+ * 正整数验证
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifiyNumberInteger(val: string): string;
+/**
+ * 去掉中文及空格
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyCnAndSpace(val: string): string;
+/**
+ * 去掉英文及空格
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyEnAndSpace(val: string): string;
+/**
+ * 禁止输入空格
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyAndSpace(val: string): string;
+/**
+ * 金额用 `,` 区分开
+ * @param val 当前值字符串
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyNumberComma(val: string): any;
+/**
+ * 匹配文字变色（搜索时）
+ * @param val 当前值字符串
+ * @param text 要处理的字符串值
+ * @param color 搜索到时字体高亮颜色
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyTextColor(val: string, text?: string, color?: string): string;
+/**
+ * 数字转中文大写
+ * @param val 当前值字符串
+ * @param unit 默认：仟佰拾亿仟佰拾万仟佰拾元角分
+ * @returns 返回处理后的字符串
+ */
+export declare function verifyNumberCnUppercase(val: any, unit?: string, v?: string): string;
+/**
+ * 手机号码
+ * @param val 当前值字符串
+ * @returns 返回 true: 手机号码正确
+ */
+export declare function verifyPhone(val: string): boolean;
+/**
+ * 国内电话号码
+ * @param val 当前值字符串
+ * @returns 返回 true: 国内电话号码正确
+ */
+export declare function verifyTelPhone(val: string): boolean;
+/**
+ * 登录账号 (字母开头，允许5-16字节，允许字母数字下划线)
+ * @param val 当前值字符串
+ * @returns 返回 true: 登录账号正确
+ */
+export declare function verifyAccount(val: string): boolean;
+/**
+ * 密码 (以字母开头，长度在6~16之间，只能包含字母、数字和下划线)
+ * @param val 当前值字符串
+ * @returns 返回 true: 密码正确
+ */
+export declare function verifyPassword(val: string): boolean;
+/**
+ * 混合密码 (字母+数字+可选特殊字符，长度在6-16之间)
+ * @param val 当前值字符串
+ * @returns 返回 true: 强密码正确
+ */
+export declare function verifyPasswordHybrid(val: string): boolean;
+/**
+ * 强密码 (字母+数字+特殊字符，长度在6-16之间)
+ * @param val 当前值字符串
+ * @returns 返回 true: 强密码正确
+ */
+export declare function verifyPasswordPowerful(val: string): boolean;
+/**
+ * 密码强度
+ * @param val 当前值字符串
+ * @description 弱：纯数字，纯字母，纯特殊字符
+ * @description 中：字母+数字，字母+特殊字符，数字+特殊字符
+ * @description 强：字母+数字+特殊字符
+ * @returns 返回处理后的字符串：弱、中、强
+ */
+export declare function verifyPasswordStrength(val: string): string;
+/**
+ * IP地址
+ * @param val 当前值字符串
+ * @returns 返回 true: IP地址正确
+ */
+export declare function verifyIPAddress(val: string): boolean;
+/**
+ * 邮箱
+ * @param val 当前值字符串
+ * @returns 返回 true: 邮箱正确
+ */
+export declare function verifyEmail(val: string): boolean;
+/**
+ * 身份证
+ * @param val 当前值字符串
+ * @returns 返回 true: 身份证正确
+ */
+export declare function verifyIdCard(val: string): boolean;
+/**
+ * 姓名
+ * @param val 当前值字符串
+ * @returns 返回 true: 姓名正确
+ */
+export declare function verifyFullName(val: string): boolean;
+/**
+ * 邮政编码
+ * @param val 当前值字符串
+ * @returns 返回 true: 邮政编码正确
+ */
+export declare function verifyPostalCode(val: string): boolean;
+/**
+ * url 处理
+ * @param val 当前值字符串
+ * @returns 返回 true: url 正确
+ */
+export declare function verifyUrl(val: string): boolean;
+/**
+ * 车牌号
+ * @param val 当前值字符串
+ * @returns 返回 true：车牌号正确
+ */
+export declare function verifyCarNum(val: string): boolean;

package/dist/utils/toolsValidate.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function a(r){let e=r.replace(/(^\s*)|(\s*$)/g,"");return e=e.replace(/[^\d]/g,""),e=e.replace(/^0/g,""),e=e.replace(/^[1-9]\d\d{1,3}$/,"100"),e}function i(r){let e=u(r);return e=e.replace(/^[1-9]\d\d{1,3}$/,"100"),e=e.replace(/^100\.$/,"100"),e}function u(r){let e=r.replace(/(^\s*)|(\s*$)/g,"");return e=e.replace(/[^\d.]/g,""),e=e.replace(/^0{2}$/g,"0"),e=e.replace(/^\./g,""),e=e.replace(".","$#$").replace(/\./g,"").replace("$#$","."),e=e.replace(/^(\-)*(\d+)\.(\d\d).*$/,"$1$2.$3"),e}function s(r){let e=r.replace(/(^\s*)|(\s*$)/g,"");return e=e.replace(/[\.]*/g,""),e=e.replace(/(^0[\d]*)$/g,"0"),e=e.replace(/^0\d$/g,"0"),e=e.replace(/[^\d]/g,""),e}function d(r){let e=r.replace(/[\u4e00-\u9fa5\s]+/g,"");return e=e.replace(/(^\s*)|(\s*$)/g,""),e}function l(r){let e=r.replace(/[a-zA-Z]+/g,"");return e=e.replace(/(^\s*)|(\s*$)/g,""),e}function c(r){return r.replace(/(^\s*)|(\s*$)/g,"")}function o(r){let e=u(r);return e=e.toString().split("."),e[0]=e[0].replace(/\B(?=(\d{3})+(?!\d))/g,","),e=e.join("."),e}function $(r,e="",t="red"){return e.replace(new RegExp(r,"gi"),`<span style='color: ${t}'>${r}</span>`)}function y(r,e="仟佰拾亿仟佰拾万仟佰拾元角分",t=""){r+="00";const f=r.indexOf(".");f>=0&&(r=r.substring(0,f)+r.substr(f+1,2)),e=e.substr(e.length-r.length);for(let n=0;n<r.length;n++)t+="零壹贰叁肆伍陆柒捌玖".substr(r.substr(n,1),1)+e.substr(n,1);return t=t.replace(/零角零分$/,"整").replace(/零[仟佰拾]/g,"零").replace(/零{2,}/g,"零").replace(/零([亿|万])/g,"$1").replace(/零+元/,"元").replace(/亿零{0,3}万/,"亿").replace(/^元/,"零元"),t}function p(r){return!!/^((12[0-9])|(13[0-9])|(14[5|7])|(15([0-3]|[5-9]))|(18[0|1,5-9]))\d{8}$/.test(r)}function v(r){return!!/\d{3}-\d{8}|\d{4}-\d{7}/.test(r)}function g(r){return!!/^[a-zA-Z][a-zA-Z0-9_]{4,15}$/.test(r)}function A(r){return!!/^[a-zA-Z]\w{5,15}$/.test(r)}function z(r){return!!/^(?=.*[a-zA-Z])(?=.*\d)[a-zA-Z\d!@#$%^&.*]{6,16}$/.test(r)}function P(r){return!!/^(?![a-zA-z]+$)(?!\d+$)(?![!@#$%^&\.*]+$)(?![a-zA-z\d]+$)(?![a-zA-z!@#$%^&\.*]+$)(?![\d!@#$%^&\.*]+$)[a-zA-Z\d!@#$%^&\.*]{6,16}$/.test(r)}function m(r){let e="";return/^(?:\d+|[a-zA-Z]+|[!@#$%^&\.*]+){6,16}$/.test(r)&&(e="弱"),/^(?![a-zA-z]+$)(?!\d+$)(?![!@#$%^&\.*]+$)[a-zA-Z\d!@#$%^&\.*]{6,16}$/.test(r)&&(e="中"),/^(?![a-zA-z]+$)(?!\d+$)(?![!@#$%^&\.*]+$)(?![a-zA-z\d]+$)(?![a-zA-z!@#$%^&\.*]+$)(?![\d!@#$%^&\.*]+$)[a-zA-Z\d!@#$%^&\.*]{6,16}$/.test(r)&&(e="强"),e}function b(r){return!!/^(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])$/.test(r)}function N(r){return!!/^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/.test(r)}function Z(r){return!!/^[1-9]\d{5}(18|19|20)\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\d{3}[0-9Xx]$/.test(r)}function C(r){return!!/^[\u4e00-\u9fa5]{1,6}(·[\u4e00-\u9fa5]{1,6}){0,2}$/.test(r)}function S(r){return!!/^[1-9][0-9]{5}$/.test(r)}function w(r){return!!/^(?:(?:(?:https?|ftp):)?\/\/)(?:\S+(?::\S*)?@)?(?:(?!(?:10|127)(?:\.\d{1,3}){3})(?!(?:169\.254|192\.168)(?:\.\d{1,3}){2})(?!172\.(?:1[6-9]|2\d|3[0-1])(?:\.\d{1,3}){2})(?:[1-9]\d?|1\d\d|2[01]\d|22[0-3])(?:\.(?:1?\d{1,2}|2[0-4]\d|25[0-5])){2}(?:\.(?:[1-9]\d?|1\d\d|2[0-4]\d|25[0-4]))|(?:(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)(?:\.(?:[a-z\u00a1-\uffff0-9]-*)*[a-z\u00a1-\uffff0-9]+)*(?:\.(?:[a-z\u00a1-\uffff]{2,})).?)(?::\d{2,5})?(?:[/?#]\S*)?$/i.test(r)}function h(r){return!!/^(([京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z](([0-9]{5}[DF])|([DF]([A-HJ-NP-Z0-9])[0-9]{4})))|([京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-Z][A-HJ-NP-Z0-9]{4}[A-HJ-NP-Z0-9挂学警港澳使领]))$/.test(r)}exports.verifiyNumberInteger=s;exports.verifyAccount=g;exports.verifyAndSpace=c;exports.verifyCarNum=h;exports.verifyCnAndSpace=d;exports.verifyEmail=N;exports.verifyEnAndSpace=l;exports.verifyFullName=C;exports.verifyIPAddress=b;exports.verifyIdCard=Z;exports.verifyNumberCnUppercase=y;exports.verifyNumberComma=o;exports.verifyNumberIntegerAndFloat=u;exports.verifyNumberPercentage=a;exports.verifyNumberPercentageFloat=i;exports.verifyPassword=A;exports.verifyPasswordHybrid=z;exports.verifyPasswordPowerful=P;exports.verifyPasswordStrength=m;exports.verifyPhone=p;exports.verifyPostalCode=S;exports.verifyTelPhone=v;exports.verifyTextColor=$;exports.verifyUrl=w;

package/dist/utils/tree.d.ts

@@ -0,0 +1,46 @@
+import type { TreeDataItem as ATreeDataItem } from 'ant-design-vue/es/tree/Tree';
+export interface TreeDataItem extends ATreeDataItem {
+    children: any;
+}
+/**
+ * 渲染部门至树形控件
+ * @param {Array} depts 所有部门
+ * @param {Number | null} parentId 父级部门ID
+ * @param {number[]|string[]} keyPath ID路径
+ */
+export declare const formatDept2Tree: (depts: API.SysDeptListResult[], parentId?: number | null, keyPath?: (string | number)[]) => TreeDataItem[];
+/**
+ * 渲染菜单至树形控件
+ * @param {Array} menus 所有菜单
+ * @param {Number | null} parentId 父级菜单ID
+ * @param {number[]|string[]} keyPath ID路径
+ */
+export declare const formatMenu2Tree: (menus: API.MenuListResult, parentId?: number | null, keyPath?: (string | number)[]) => TreeDataItem[];
+/**
+ * 渲染数据至树形控件
+ * @param {Array} data 所有数据
+ * @param {string} name 显示的字段
+ * @param {Number | null} parentId 父级ID
+ * @param {number[]|string[]} keyPath ID路径
+ * @param {string} id 递归的主键字段, 默认: Id
+ * @param {string} pid 父元素的字段, 默认: ParentId
+ */
+export declare const formatTree: (data: Array<any>, name: string, parentId?: number | null, keyPath?: (string | number)[], id?: string, pid?: string) => TreeDataItem[];
+/**
+ * 渲染数据至树形表格
+ * @param {Array} data 所有数据
+ * @param {number | string | null} parent 最顶级父级元素值
+ * @param {number[]|string[]} keyPath ID路径
+ * @param {string} id 递归的主键字段, 默认: Id
+ * @param {string} pid 父元素的字段, 默认: ParentId
+ * @param {boolean} isInit 是否是初始化, 默认: true
+ */
+export declare const formatToTreeTable: (data: Array<any>, parent?: number | string | null, keyPath?: (string | number)[], id?: string, pid?: string, isInit?: boolean) => TreeDataItem[];
+/**
+ * 在树中根据ID找child
+ * @param {string|number} id
+ * @param {any[]} treeData 树形数据
+ * @param {string} keyName 指定ID的属性名，默认是id
+ * @param {string} children 指定children的属性名，默认是children
+ */
+export declare const findChildById: <T = any>(id: any, treeData?: T[], keyName?: string, children?: string) => any;

package/dist/utils/tree.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=(n,t=null,c=[])=>n.filter(e=>e.parentId===t).map(e=>{const r=c.concat(t||[]),l=s(n,e.id,r);return Object.assign(e,{keyPath:r,title:e.name,key:e.id,value:e.id,formData:e,children:l.length?l:null})}),h=(n,t=null,c=[])=>n.filter(e=>e.parentId===t).map(e=>{const r=c.concat(t||[]),l=h(n,e.id,r);return Object.assign(e,{keyPath:r,title:e.name,key:e.id,value:e.id,formData:e,children:l.length?l:null})}),y=(n,t,c=null,e=[],r="id",l="parentId")=>n.filter(o=>o[l]===c).map(o=>{c===-1&&(c=null);const u=e.concat(c||[]),a=y(n,t,o[r],u,r,l);return Object.assign(o,{keyPath:u,title:o[t],name:o[t],key:o[r],value:o[r],formData:o,children:a.length?a:null})}),T=(n,t=null,c=[],e="id",r="parentId",l=!0)=>{var o;return l&&!n.find(a=>a[r]===t)&&(t=((o=n==null?void 0:n[0])==null?void 0:o[r])||t),n.filter(u=>u[r]===t).map(u=>{const a=c.concat(t||[]),f=T(n,u[e],a,e,r,!1);return Object.assign(u,{keyPath:a,key:u[e],children:f.length?f:null})})},g=(n,t=[],c="id",e="children")=>t.reduce((r,l)=>{var o;if(l[c]===n)return l;if(r)return r;if((o=l[e])!=null&&o.length)return g(n,l[e],c,e)},void 0);exports.findChildById=g;exports.formatDept2Tree=s;exports.formatMenu2Tree=h;exports.formatToTreeTable=T;exports.formatTree=y;

package/dist/utils/urlUtils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 将对象添加当作参数拼接到URL上面
+ * @param baseUrl 需要拼接的url
+ * @param obj 参数对象
+ * @returns {string} 拼接后的对象
+ * 例子:
+ *  let obj = {a: '3', b: '4'}
+ *  setObjToUrlParams('www.baidu.com', obj)
+ *  ==>www.baidu.com?a=3&b=4
+ */
+export declare function setObjToUrlParams(baseUrl: string, obj: object): string;
+/**
+ * 将路径中重复的正斜杆替换成单个斜杆隔开的字符串
+ * @param path 要处理的路径
+ * @returns {string} 将/去重后的结果
+ */
+export declare const uniqueSlash: (path: string) => string;

package/dist/utils/urlUtils.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(e,n){let t="",r="";for(const l in n)t+=`${l}=${encodeURIComponent(n[l])}&`;return t=t.replace(/&$/,""),/\?$/.test(e)?r=e+t:r=e.replace(/\/?$/,"?")+t,r}const s=e=>e.replace(/(https?:\/)|(\/)+/g,"$1$2");exports.setObjToUrlParams=o;exports.uniqueSlash=s;

package/dist/utils/useBufferStatus.d.ts

@@ -0,0 +1,32 @@
+export interface UseBufferStatusOptions {
+    /**
+     * 自动刷新间隔（毫秒）。默认 0 表示不自动刷新。
+     * plcMonitor 用 30000；tagHistory / systemMaintenance 用 0（手动刷新）。
+     */
+    autoRefreshMs?: number;
+    /** 查询失败时调用。默认空（静默）。 */
+    onError?: (err: unknown) => void;
+}
+/**
+ * 标签历史入库缓冲区状态 composable（/api/TagHistory/BufferStatus）。
+ *
+ * 消除 3 个页面里重复的 pending_count 拉取 + 定时刷新逻辑：
+ *   - plcMonitor.vue        autoRefreshMs=30000
+ *   - tagHistory.vue        手动刷新
+ *   - systemMaintenance.vue 手动刷新
+ *
+ * 用法：
+ * ```ts
+ * const { pending, loading, updatedAt, refresh } = useBufferStatus({ autoRefreshMs: 30000 })
+ * ```
+ */
+export declare function useBufferStatus(options?: UseBufferStatusOptions): {
+    /** 待写入条数 */
+    pending: import("vue").Ref<number, number>;
+    /** 是否正在查询 */
+    loading: import("vue").Ref<boolean, boolean>;
+    /** 上次查询成功时间（本地化字符串） */
+    updatedAt: import("vue").Ref<string, string>;
+    /** 手动触发一次查询 */
+    refresh: () => Promise<void>;
+};

package/dist/utils/useDownloadBlob.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Blob 文件下载 composable（统一所有"调 API 拿 Blob → 触发浏览器下载"场景）。
+ *
+ * 设计目标：
+ *  - 消除 4 个页面（tagHistory / DeviceWorkbench / auditLog / DataQueryTool）里
+ *    重复的 URL.createObjectURL + createElement('a') + click + revokeObjectURL 流程。
+ *  - 内置 loading 状态与错误提示，调用方只需一行代码。
+ *
+ * 用法：
+ * ```ts
+ * const { downloading, downloadBlob } = useDownloadBlob()
+ * await downloadBlob(() => exportDeviceBundle(id), `device-${id}.zip`)
+ * await downloadBlob(Promise.resolve(myCsvBlob), 'audit.csv', { successMsg: '已导出' })
+ * ```
+ */
+export declare function useDownloadBlob(): {
+    downloading: import("vue").Ref<boolean, boolean>;
+    downloadBlob: (source: Blob | Promise<Blob> | (() => Promise<Blob>), filename: string, options?: {
+        successMsg?: string;
+        errorMsg?: string;
+    }) => Promise<boolean>;
+};

package/dist/utils/useExeSubscription.d.ts

@@ -0,0 +1,40 @@
+import { type MaybeRef } from 'vue';
+export interface ExeExecutionInfo {
+    deviceId: number | string;
+    tagName?: string;
+    bizCode?: string;
+    success: boolean;
+    result?: string | number | null;
+    error?: string | null;
+    traceId?: string;
+    timestamp?: string;
+}
+export interface UseExeSubscriptionOptions {
+    /**
+     * 命中当前设备的执行完成事件时调用。组件用它触发列表刷新。
+     * 不传则只弹通知，不做任何副作用。
+     */
+    onChanged?: (info: ExeExecutionInfo) => void;
+    /** 是否弹右下角通知（默认 true） */
+    notify?: boolean;
+}
+/**
+ * 订阅 PlcHub 推送的 OnExeExecutionCompleted 事件（按 deviceId 分组）。
+ *
+ * 设计目标：
+ *  - 把 ExeRulesTab.vue 里那段"acquire + subscribe + 回调过滤 + 通知 + 清理"
+ *    抽成可复用 composable，未来 exeExecLog.vue / plcMonitor.vue 都能一行接入。
+ *  - 重连自动恢复订阅（SignalRConnectionManager 已支持 subscribedExeDevices）。
+ *
+ * 用法：
+ * ```ts
+ * useExeSubscription(
+ *   () => props.deviceId,
+ *   { onChanged: () => { loadExes(); loadLogs() } },
+ * )
+ * ```
+ */
+export declare function useExeSubscription(deviceId: MaybeRef<number | string | undefined>, options?: UseExeSubscriptionOptions): {
+    /** 让调用方能在特殊场景下手动重订阅 */
+    resubscribe: () => void;
+};

package/dist/utils/uuid.d.ts

@@ -0,0 +1,2 @@
+export declare function buildUUID(): string;
+export declare function buildShortUUID(prefix?: string): string;

package/dist/utils/uuid.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=[];for(let t=0;t<=15;t++)o[t]=t.toString(16);function n(){let t="";for(let e=1;e<=36;e++)e===9||e===14||e===19||e===24?t+="-":e===15?t+=4:e===20?t+=o[Math.random()*4|8]:t+=o[Math.random()*16|0];return t.replace(/-/g,"")}let i=0;function l(t=""){const e=Date.now(),r=Math.floor(Math.random()*1e9);return i++,`${t}_${r}${i}${String(e)}`}exports.buildShortUUID=l;exports.buildUUID=n;

package/dist/utils/validate.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 是否外链url
+ * @param {string} path
+ * @returns {Boolean}
+ */
+export declare function isExternal(path: string): boolean;
+/**
+ * 是否正确的手机号
+ * @param phone 手机号
+ * @returns
+ */
+export declare function isPhone(phone: string): boolean;
+/**
+ * 是否正确的邮箱
+ * @param str 邮箱
+ * @returns
+ */
+export declare function isEmail(str: string): boolean;
+/**
+ * 是否正确的JSON字符串
+ * @param str json
+ * @returns
+ */
+export declare function isJson(str: string): boolean;
+/**
+ * 判断当前页面的url是否是不需要token的路由地址
+ * eg: http://localhost:5002/*dffBgw1CRMM=#/reportQuery/2  返回true
+ * @returns true or false
+ */
+export declare function isNotNeedTokenUrl(): boolean;
+/**
+ * 判断当前是否竖屏状态(width < height)
+ * @returns true or false
+ */
+export declare function isVerticalScreen(): boolean;

package/dist/utils/validate.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function n(t){return/^(http?:|https?:|mailto:|tel:)/.test(t)}function r(t){return/^[1][3,4,5,7,8,9][0-9]{9}$/.test(t)}function i(t){return/^[a-z0-9]+([._\\-]*[a-z0-9])*@([a-z0-9]+[-a-z0-9]*[a-z0-9]+.){1,63}[a-z0-9]+$/.test(t)}function s(t){try{JSON.parse(JSON.stringify(t))}catch{return!1}return!0}function o(){try{const t=location.href.indexOf("/*");if(t<0)return!1;const e=location.href.indexOf("#/");return!(e<0||!location.href.substring(t+2,e))}catch{return!1}}function c(){const t=document.documentElement.clientWidth,e=document.documentElement.clientHeight;return t<e}exports.isEmail=i;exports.isExternal=n;exports.isJson=s;exports.isNotNeedTokenUrl=o;exports.isPhone=r;exports.isVerticalScreen=c;

package/dist/views/account/about.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("vue"),t=require("../../_virtual/_plugin-vue_export-helper.js"),c={},o={class:"about-placeholder"};function r(s,u){return e.openBlock(),e.createElementBlock("div",o,"About")}const n=t(c,[["render",r]]);module.exports=n;

package/dist/views/account/settings.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("vue"),t=require("../../_virtual/_plugin-vue_export-helper.js"),s={},c={class:"settings-placeholder"};function n(o,i){return e.openBlock(),e.createElementBlock("div",c,"Settings")}const r=t(s,[["render",n]]);module.exports=r;

package/dist/views/dashboard/welcome/index.vue.js

@@ -0,0 +1 @@
+"use strict";const e=;/* empty css            */;/* empty css            */const r=require("../../../_virtual/_plugin-vue_export-helper.js"),t=r(e,[["__scopeId","data-v-30503c1d"]]);module.exports=t;

package/dist/views/dashboard/welcome/index2.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("vue"),n={class:"shared-frontend-welcome"},o=e.defineComponent({__name:"index",setup(r){return(s,t)=>(e.openBlock(),e.createElementBlock("div",n,[...t[0]||(t[0]=[e.createElementVNode("h1",null,"Welcome",-1),e.createElementVNode("p",null,"This is the default welcome page from shared-frontend.",-1)])]))}});module.exports=o;

package/dist/views/error/404.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("./4042.vue.js");;/* empty css          */const _=require("../../_virtual/_plugin-vue_export-helper.js"),r=_(e,[["__scopeId","data-v-ca915d94"]]);module.exports=r;

package/dist/views/error/4042.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("vue"),t={class:"shared-frontend-404"},o=e.defineComponent({__name:"404",setup(r){return(s,n)=>(e.openBlock(),e.createElementBlock("div",t,[...n[0]||(n[0]=[e.createElementVNode("h1",null,"404",-1),e.createElementVNode("p",null,"Page not found.",-1)])]))}});module.exports=o;

package/dist/views/error/comp-not-found.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("vue"),o=require("../../_virtual/_plugin-vue_export-helper.js"),n={},c={class:"comp-not-found-placeholder"};function t(s,u){return e.openBlock(),e.createElementBlock("div",c,"Component Not Found")}const r=o(n,[["render",t]]);module.exports=r;

package/dist/views/login/index.vue.js

@@ -0,0 +1 @@
+"use strict";const e=;/* empty css            */;/* empty css            */const r=require("../../_virtual/_plugin-vue_export-helper.js"),t=r(e,[["__scopeId","data-v-8570a81e"]]);module.exports=t;

package/dist/views/login/index2.vue.js

@@ -0,0 +1 @@
+"use strict";const e=require("vue"),t={class:"shared-frontend-login"},o=e.defineComponent({__name:"index",setup(r){return(s,n)=>(e.openBlock(),e.createElementBlock("div",t,[...n[0]||(n[0]=[e.createElementVNode("h1",null,"Login",-1),e.createElementVNode("p",null,"This is the default login page from shared-frontend.",-1)])]))}});module.exports=o;

package/package.json

@@ -0,0 +1,129 @@
+{
+  "name": "@usethink/shared-frontend",
+  "version": "0.1.0",
+  "description": "@usethink 前端共享库 — Vue 3 工具函数、组件、Hooks、类型与业务能力",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qwdingyu/shared-frontend.git"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs",
+      "types": "./dist/utils/index.d.ts"
+    },
+    "./components": {
+      "import": "./dist/components/index.js",
+      "require": "./dist/components/index.cjs",
+      "types": "./dist/components/index.d.ts"
+    },
+    "./hooks": {
+      "import": "./dist/hooks/index.js",
+      "require": "./dist/hooks/index.cjs",
+      "types": "./dist/hooks/index.d.ts"
+    },
+    "./api": {
+      "import": "./dist/api/index.js",
+      "require": "./dist/api/index.cjs",
+      "types": "./dist/api/index.d.ts"
+    },
+    "./store": {
+      "import": "./dist/store/index.js",
+      "require": "./dist/store/index.cjs",
+      "types": "./dist/store/index.d.ts"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.cjs",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./constants": {
+      "import": "./dist/constants/index.js",
+      "require": "./dist/constants/index.cjs",
+      "types": "./dist/constants/index.d.ts"
+    },
+    "./enums": {
+      "import": "./dist/enums/index.js",
+      "require": "./dist/enums/index.cjs",
+      "types": "./dist/enums/index.d.ts"
+    },
+    "./styles/*": "./dist/styles/*",
+    "./*": "./dist/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "prepack": "pnpm run build",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "publish": "pnpm exec publish-toolkit publish --package . --registry=https://registry.npmjs.org/ --access=public"
+  },
+  "keywords": [
+    "vue",
+    "vue3",
+    "frontend",
+    "shared-library",
+    "usethink",
+    "pinia",
+    "ant-design-vue"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@ant-design/icons-vue": ">=7.0.0",
+    "@microsoft/signalr": ">=8.0.0",
+    "@vueuse/core": ">=10.0.0",
+    "ant-design-vue": ">=4.0.0",
+    "axios": ">=1.0.0",
+    "codemirror": ">=5.0.0",
+    "cropperjs": ">=1.0.0",
+    "dayjs": ">=1.11.0",
+    "echarts": ">=5.0.0",
+    "lodash-es": ">=4.17.0",
+    "mitt": ">=3.0.0",
+    "pinia": ">=2.0.0",
+    "tinymce": ">=6.0.0",
+    "vue": ">=3.0.0",
+    "vue-i18n": ">=9.0.0",
+    "vue-router": ">=4.0.0",
+    "vue-virtual-scroller": ">=2.0.0",
+    "xlsx": ">=0.18.0"
+  },
+  "dependencies": {
+    "file-saver": "^2.0.5",
+    "nprogress": "^0.2.0",
+    "qs": "^6.15.3",
+    "sortablejs": "^1.15.7"
+  },
+  "devDependencies": {
+    "@iconify-json/ant-design": "^1.2.5",
+    "@iconify-json/ep": "^1.2.4",
+    "@types/lodash-es": "~4.17.12",
+    "@types/node": "~20.12.4",
+    "@types/qs": "^6.15.1",
+    "@usethink/publish-toolkit": "~0.1.13",
+    "@vitejs/plugin-vue": "~5.0.4",
+    "@vue/tsconfig": "^0.5.1",
+    "codemirror": "^5.65.21",
+    "less": "^4.6.7",
+    "typescript": "~5.4.3",
+    "vite": "~5.2.8",
+    "vite-plugin-dts": "^3.9.1",
+    "vue": "~3.5.34",
+    "vue-types": "^7.0.0"
+  }
+}