zy-react-library 2.1.11 → 2.2.0

package/components/Word/index.js

@@ -0,0 +1 @@
+import{Modal as r,Button as e,message as n,Spin as t}from"antd";import{renderAsync as i}from"docx-preview";import{useRef as o,useState as l,useEffect as a}from"react";import c from"../../hooks/useDownloadFile/index.js";import{getFileUrl as d}from"../../utils/index.js";import{jsx as u}from"react/jsx-runtime";function s(s){const{visible:f=!1,onCancel:m,file:p,name:h,inline:w=!1,title:g="Word预览",style:y={}}=s,v=o(null),x=o(null),k=o(!1),W=d(),[C,b]=l(!1),{downloadFile:T}=c();a(()=>{if(!f&&!w||!p)return;k.current=!1;const r=setTimeout(()=>{(async()=>{b(!0),v.current.innerHTML="";try{const r=await fetch(p.includes(W)?p:W+p);if(!r.ok)throw new Error("加载 Word 文件失败");const e=await r.arrayBuffer();if(k.current)return;await i(e,v.current,null,{className:"docx-preview",inWrapper:!0,ignoreWidth:!1,ignoreHeight:!1,breakPages:!0})}catch{n.error("加载 Word 文件失败"),!w&&m&&m()}finally{k.current||b(!1)}})()},100);return()=>{k.current=!0,v.current&&(v.current.innerHTML=""),r&&clearTimeout(r)}},[f,w,p]);const j=()=>u(t,{spinning:C,children:u("div",{style:{height:"72vh",overflowY:"auto",padding:"24px",background:"#f5f5f5",...y},children:u("div",{ref:v})})});return w?j():u("div",{ref:x,children:u(r,{style:{top:100,maxWidth:"calc(100vw - 32px)",paddingBottom:24},open:f,mask:{closable:!1},width:900,title:g,onCancel:()=>{m()},getContainer:!1,footer:[u(e,{onClick:()=>{m()},children:"关闭"},"cancel"),u(e,{type:"primary",onClick:()=>{T({url:p,name:h})},children:"下载"},"download")],children:j()})})}s.displayName="Word";export{s as default};

package/css/common.less

@@ -0,0 +1,35 @@
+.@{ant-prefix}-modal-header {
+  border-bottom: 1px solid #ccc !important;
+  margin: 0 -24px 15px -24px !important;
+  padding: 0 24px 15px 24px !important;
+}
+
+.@{ant-prefix}-modal-footer {
+  justify-content: center !important;
+}
+
+.search-layout {
+  position: relative;
+
+  &::after {
+    content: '';
+    position: absolute;
+    bottom: -10px;
+    left: -20px;
+    right: -20px;
+    height: 10px;
+    background-color: rgb(241, 241, 242);
+  }
+
+  + .table-layout {
+    padding-top: 26px !important;
+  }
+}
+
+.table-layout {
+}
+
+.card-layout {
+  background-color: #fff;
+  border-radius: 6px;
+}

package/enum/formItemRender/index.d.ts

@@ -0,0 +1,68 @@
+import type { CheckboxProps } from "antd/es/checkbox";
+import type { DatePickerProps, MonthPickerProps, RangePickerProps, WeekPickerProps } from "antd/es/date-picker";
+import type { DividerProps } from "antd/es/divider";
+import type { FormListProps } from "antd/es/form";
+import type { InputProps, TextAreaProps } from "antd/es/input";
+import type { InputNumberProps } from "antd/es/input-number";
+import type { RadioProps } from "antd/es/radio";
+import type { SelectProps } from "antd/es/select";
+
+/**
+ * 表单项类型枚举
+ */
+export declare const FORM_ITEM_RENDER_ENUM: {
+  /** 映射为 antd Input */
+  INPUT: "input";
+  /** 映射为 antd Input.TextArea */
+  TEXTAREA: "textarea";
+  /** 映射为 antd InputNumber */
+  INPUT_NUMBER: "inputNumber";
+  /** 映射为 antd InputNumber */
+  NUMBER: "number";
+  /** 映射为 antd InputNumber */
+  INTEGER: "integer";
+  /** 映射为 antd Select */
+  SELECT: "select";
+  /** 映射为 antd Radio.Group */
+  RADIO: "radio";
+  /** 映射为 antd Checkbox.Group */
+  CHECKBOX: "checkbox";
+  /** 映射为 antd DatePicker，日期格式为YYYY-MM-DD */
+  DATE: "date";
+  /** 映射为 antd DatePicker.MonthPicker，日期格式为YYYY-MM */
+  DATE_MONTH: "dateMonth";
+  /** 映射为 antd DatePicker.YearPicker，日期格式为YYYY */
+  DATE_YEAR: "dateYear";
+  /** 映射为 antd DatePicker.WeekPicker，日期格式为YYYY-wo */
+  DATE_WEEK: "dateWeek";
+  /** 映射为 antd DatePicker.RangePicker，日期格式为YYYY-MM-DD */
+  DATE_RANGE: "dateRange";
+  /** 映射为 antd DatePicker，日期格式为YYYY-MM-DD HH:mm:ss */
+  DATETIME: "datetime";
+  /** 映射为 antd DatePicker.RangePicker，日期格式为YYYY-MM-DD HH:mm:ss */
+  DATETIME_RANGE: "datetimeRange";
+  /** 映射为 antd Divider */
+  DIVIDER: "divider";
+  /** 映射为 antd FormList */
+  FORM_LIST: "formList";
+};
+
+export interface FORM_ITEM_RENDER_TYPE_MAP {
+  input: InputProps;
+  textarea: TextAreaProps;
+  inputNumber: InputNumberProps;
+  number: InputNumberProps;
+  integer: InputNumberProps;
+  select: SelectProps;
+  radio: RadioProps;
+  checkbox: CheckboxProps;
+  date: DatePickerProps;
+  dateMonth: MonthPickerProps;
+  dateYear: DatePickerProps;
+  dateWeek: WeekPickerProps;
+  dateRange: RangePickerProps;
+  datetime: DatePickerProps;
+  datetimeRange: RangePickerProps;
+  divider: DividerProps;
+  formList: FormListProps;
+}

package/enum/formItemRender/index.js

@@ -0,0 +1 @@
+const e={INPUT:"input",TEXTAREA:"textarea",INPUT_NUMBER:"inputNumber",NUMBER:"number",INTEGER:"integer",SELECT:"select",RADIO:"radio",CHECKBOX:"checkbox",DATE:"date",DATE_MONTH:"dateMonth",DATE_YEAR:"dateYear",DATE_WEEK:"dateWeek",DATE_RANGE:"dateRange",DATETIME:"datetime",DATETIME_RANGE:"datetimeRange",DIVIDER:"divider",FORM_LIST:"formList"};export{e as FORM_ITEM_RENDER_ENUM};

package/hooks/useDeleteFile/index.d.ts

@@ -0,0 +1,22 @@
+export interface DeleteFileItem {
+  /** 文件URL */
+  filePath?: string;
+  /** 文件ID */
+  id?: string;
+  [key: string]: any;
+}
+
+export interface DeleteFileOptions {
+  /** 要删除的文件列表 */
+  files: DeleteFileItem[];
+  /** 是否单文件删除 */
+  single?: boolean;
+}
+
+export type DeleteFileFunction = (options: DeleteFileOptions) => Promise<void | any>;
+
+/**
+ * 删除文件
+ */
+export default function useDeleteFile(returnType: "array"): [boolean, DeleteFileFunction];
+export default function useDeleteFile(returnType?: "object"): { loading: boolean; deleteFile: DeleteFileFunction };

package/hooks/useDeleteFile/index.js

@@ -0,0 +1 @@
+import{request as e}from"@cqsjjb/jjb-common-lib/http.js";import{useState as i}from"react";import{getBaseGateway as t}from"../../utils/index.js";function l(l="object"){const[r,o]=i(!1);let s=0;const n=i=>{if(i)return s++,s>0&&o(!0),new Promise((l,r)=>{const{files:n=[],single:f=!0}=i;if(n)if(Array.isArray(n)){if(0===n.length)return s--,s<=0&&o(!1),void l();if(f){if(!n[0].filePath)return s--,s<=0&&o(!1),void l()}else if(0===n.filter(e=>e.id).length)return s--,s<=0&&o(!1),void l();e(f?`/${t()}/imgFiles/delete?filePath=${n[0].filePath}`:`/${t()}/imgFiles/ids?ids=${n.filter(e=>e.id).map(e=>e.id)}`,"delete").then(e=>{l(e.data)}).catch(e=>{r(e)}).finally(()=>{s--,s<=0&&o(!1)})}else console.error("【deleteFile】 的 files 需要是一个数组");else console.error("【deleteFile】 缺少 files 参数")});console.error("【deleteFile】 缺少 options 参数")};return"array"===l?[r,n]:{loading:r,deleteFile:n}}export{l as default};

package/hooks/useDictionary/index.d.ts

@@ -0,0 +1,24 @@
+export interface getDictionaryOptions {
+  /** appKey，默认 DICTIONARY_APP_KEY_ENUM.DEFAULT（0bb989ecada5470c87635018ece9f327） */
+  appKey?: string;
+  /** 要获取的字典 */
+  dictValue: string;
+}
+
+export interface DictionaryItem {
+  /** label */
+  dictLabel: string;
+  /** value */
+  dictValue: string;
+  /** 子级 */
+  children: DictionaryItem[];
+  [key: string]: any;
+}
+
+export type getDictionaryFunction = (options: getDictionaryOptions) => Promise<DictionaryItem[]>;
+
+/**
+ * 获取数据字典
+ */
+export default function useDictionary(returnType: "array"): [boolean, getDictionaryFunction];
+export default function useDictionary(returnType?: "object"): { loading: boolean; getDictionary: getDictionaryFunction };

package/hooks/useDictionary/index.js

@@ -0,0 +1 @@
+import{request as t}from"@cqsjjb/jjb-common-lib/http.js";import{useState as o}from"react";import{DICTIONARY_APP_KEY_ENUM as e}from"zy-react-data/enum/dictionary";function i(i="object"){const[r,a]=o(!1);let c=0;const n=o=>{if(o)return c++,c>0&&a(!0),new Promise((i,r)=>{const{appKey:n=e.DEFAULT,dictValue:s}=o;Object.values(e).includes(n)?s?t("/config/dict-trees/list/by/dictValues","get",{appKey:n,dictValue:s}).then(t=>{i(t.data)}).catch(t=>{r(t)}).finally(()=>{c--,c<=0&&a(!1)}):console.error("【getDictionary】 缺少 options.dictValue 参数"):console.error(`【getDictionary】 传入的 options.appKey 不在 DICTIONARY_APP_KEY_ENUM 中，当前传入的 options.appKey 是 ${n}`)});console.error("【getDictionary】 缺少 options 参数")};return"array"===i?[r,n]:{loading:r,getDictionary:n}}export{i as default};

package/hooks/useDownloadBlob/index.d.ts

@@ -0,0 +1,16 @@
+interface UseDownloadBlobOptions {
+  /** 下载文件的自定义文件名（不含后缀），默认为当前时间戳 */
+  name?: string;
+  /** Blob 对象的 MIME 类型，默认为 Excel 类型 */
+  type?: string;
+  /** 请求时携带的查询参数对象 */
+  params?: Record<string, any>;
+}
+
+export type DownloadBlobFunction = (url: string, options?: UseDownloadBlobOptions) => Promise<{ data: Blob }>;
+
+/**
+ * 下载Blob流文件
+ */
+export default function useDownloadBlob(returnType: "array"): [boolean, DownloadBlobFunction];
+export default function useDownloadBlob(returnType?: "object"): { loading: boolean; downloadBlob: DownloadBlobFunction };

package/hooks/useDownloadBlob/index.js

@@ -0,0 +1 @@
+import{message as o}from"antd";import e from"dayjs";import{useState as n}from"react";function t(t="object"){const[r,a]=n(!1);let d=0;const c=(n,t)=>{if(d++,d>0&&a(!0),n)return new Promise((r,c)=>{const{name:l="",type:s="",params:i={}}=t,m=new URL((process.env.app.API_HOST||window.__JJB_ENVIRONMENT__.API_HOST)+n);Object.entries(i).forEach(([o,e])=>{m.searchParams.append(o,e)}),fetch(m,{method:"GET",mode:"cors",headers:{"Content-Type":"application/json",token:window.sessionStorage.token}}).then(o=>{if(o.ok)return o.blob();console.error("【downloadBlob】 网络响应异常")}).then(o=>{const n=new Blob([o],{type:s||"application/vnd.ms-excel"}),t=document.createElement("a"),a=window.URL.createObjectURL(n);t.style.display="none",t.href=a,t.download=l||e().format("YYYY-MM-DD HH:mm:ss"),document.body.appendChild(t),t.click(),document.body.removeChild(t),window.URL.revokeObjectURL(a),r({data:n})}).catch(e=>{o.error("导出失败"),c(e)}).finally(()=>{d--,d<=0&&a(!1)})});console.error("【downloadBlob】 缺少 url 参数")};return"array"===t?[r,c]:{loading:r,downloadBlob:c}}export{t as default};

package/hooks/useDownloadFile/index.d.ts

@@ -0,0 +1,14 @@
+export interface DownloadFileOptions {
+  /** 下载文件的URL */
+  url: string;
+  /** 下载文件的自定义文件名 */
+  name?: string;
+}
+
+export type DownloadFileFunction = (options: DownloadFileOptions) => void;
+
+/**
+ * 下载文件
+ */
+export default function useDownloadFile(returnType: "array"): [boolean, DownloadFileFunction];
+export default function useDownloadFile(returnType?: "object"): { loading: boolean; downloadFile: DownloadFileFunction };

package/hooks/useDownloadFile/index.js

@@ -0,0 +1 @@
+import{Modal as o,message as e}from"antd";import{useState as n}from"react";import{getFileUrl as t,getFileSuffix as c,getFileName as r}from"../../utils/index.js";function l(l="object"){const[d,a]=n(!1);let i=0;const m=n=>{i++,i>0&&a(!0);const{url:l,name:d}=n;l?o.confirm({title:"提示",content:"确定要下载此文件吗？",onOk:()=>{const o=t();let n=d;n?!c(n)&&c(l)&&(n=`${n}.${c(l)}`):n=r(l),fetch(l.includes(o)?l:o+l).then(o=>o.blob()).then(o=>{const e=document.createElement("a");document.body.appendChild(e),e.style.display="none";const t=window.URL.createObjectURL(o);e.href=t,e.download=`${n}`,e.click(),document.body.removeChild(e),window.URL.revokeObjectURL(t)}).catch(()=>{e.error("下载失败")}).finally(()=>{i--,i<=0&&a(!1)})},onCancel:()=>{i--,i<=0&&a(!1)}}):console.error("【downloadFile】 缺少 url 参数")};return"array"===l?[d,m]:{loading:d,downloadFile:m}}export{l as default};

package/hooks/useGetFile/index.d.ts

@@ -0,0 +1,49 @@
+export interface GetFileItem {
+  /** 文件路径 */
+  filePath: string;
+  /** 文件名称 */
+  fileName: string;
+  /** 文件ID */
+  id: string;
+  /** 文件URL(由addingPrefixToFile函数添加) */
+  url: string;
+  /** 文件名称(由addingPrefixToFile函数添加) */
+  name: string;
+  [key: string]: any;
+}
+
+export interface BaseParams {
+  /** 文件类型 */
+  eqType: number;
+}
+
+export interface SingleGetFileOptions extends BaseParams {
+  /** 外键ID */
+  eqForeignKey: string;
+  /** 是否单文件获取 */
+  single?: true;
+}
+
+export interface MultipleGetFileOptions extends BaseParams {
+  /** dataSource 中外键ID的 key */
+  foreignKey: string;
+  /** 是否单文件获取 */
+  single: false;
+  /** 数据源 */
+  dataSource: Record<string, any>[];
+}
+
+export type SingleFileResponse = GetFileItem[];
+
+export type MultipleFileResponse = Array<Record<string, any> & { files: GetFileItem[] }>;
+
+export interface GetFileFunction {
+  (options: SingleGetFileOptions): Promise<SingleFileResponse>;
+  (options: MultipleGetFileOptions): Promise<MultipleFileResponse>;
+}
+
+/**
+ * 获取文件
+ */
+export default function useGetFile(returnType: "array"): [boolean, GetFileFunction];
+export default function useGetFile(returnType?: "object"): { loading: boolean; getFile: GetFileFunction };

package/hooks/useGetFile/index.js

@@ -0,0 +1 @@
+import{request as e}from"@cqsjjb/jjb-common-lib/http.js";import{useState as o}from"react";import{UPLOAD_FILE_TYPE_ENUM as r}from"zy-react-data/enum/uploadFile";import{getBaseGateway as i,addingPrefixToFile as t}from"../../utils/index.js";function n(n="object"){const[l,s]=o(!1);let a=0;const c=o=>{if(o)return a++,a>0&&s(!0),new Promise((n,l)=>{const{eqType:c,eqForeignKey:p,single:f=!0,foreignKey:g,dataSource:u}=o;if(!c)return void console.error("【getFile】 缺少 options.eqType 参数");if(!Object.values(r).includes(c))return void console.error(`【getFile】 传入的 eqType 不在 UPLOAD_FILE_TYPE_ENUM 中，当前传入的 eqType 是 ${c}`);if(f){if(null==p||""===p)return void console.error("【getFile】 缺少 options.eqForeignKey 参数")}else{if(null==g||""===g)return void console.error("【getFile】 缺少 options.foreignKey 参数");if(null==u||""===u)return void console.error("【getFile】 缺少 options.dataSource 参数");if(0===u.length)return s(!1),void n(u)}const y=f?{eqType:c,eqForeignKey:p}:{eqType:c,inForeignKey:u.map(e=>e[g]).join(",")};e(`/${i()}/imgFiles/listAll`,"get",y).then(e=>{if(f)n(t(e.data).map(e=>({...e,type:void 0})));else{const o=new Map;e.data.forEach(e=>{o.has(e.foreignKey)||o.set(e.foreignKey,[]),o.get(e.foreignKey).push({...e,type:void 0})});const r=u.map(e=>{const r=e[g],i=o.has(r)?t(o.get(r)):[];return{...e,files:i}});n(r)}}).catch(e=>{l(e)}).finally(()=>{a--,a<=0&&s(!1)})});console.error("【getFile】 缺少 options 参数")};return"array"===n?[l,c]:{loading:l,getFile:c}}export{n as default};

package/hooks/useGetUrlQuery/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 获取路由参数
+ */
+export default function useGetUrlQuery(): Record<string, any>;

package/hooks/useGetUrlQuery/index.js

@@ -0,0 +1 @@
+function n(){const n=new URLSearchParams(window.location.search),o={};for(const[e,r]of n.entries())o[e]=r;return o}export{n as default};

package/hooks/useGetUserInfo/index.d.ts

@@ -0,0 +1,21 @@
+interface UserInfoData {
+  corpinfoId: string;
+  corpinfoName: string;
+  departmentId: string;
+  departmentName: string;
+  id: string;
+  name: string;
+  postId: string;
+  postName: string;
+  userId: string;
+  username: string;
+  [key: string]: any;
+}
+
+export type getUserInfoFunction = () => Promise<UserInfoData>;
+
+/**
+ * 获取用户信息
+ */
+export default function useGetUserInfo(returnType: "array"): [boolean, getUserInfoFunction];
+export default function useGetUserInfo(returnType?: "object"): { loading: boolean; getUserInfo: getUserInfoFunction };

package/hooks/useGetUserInfo/index.js

@@ -0,0 +1 @@
+import{request as t}from"@cqsjjb/jjb-common-lib/http.js";import{useState as o}from"react";import{getBaseGateway as e}from"../../utils/index.js";function r(r="object"){const[n,a]=o(!1);let i=0;const s=()=>(i++,i>0&&a(!0),new Promise((o,r)=>{t(`/${e()}/user/getInfo`,"get",{}).then(t=>{o(t.data)}).catch(t=>{r(t)}).finally(()=>{i--,i<=0&&a(!1)})}));return"array"===r?[n,s]:{loading:n,getUserInfo:s}}export{r as default};

package/hooks/useIdle/index.d.ts

@@ -0,0 +1,11 @@
+export interface UseIdleOptions {
+  /** 空闲超时时间（毫秒），默认值 10000 */
+  timeout?: number;
+  /** 监听的事件列表，默认值 ["mousemove", "mousedown", "resize", "keydown", "touchstart", "wheel"] */
+  events?: string[];
+}
+
+/**
+ * 检测用户是否处于空闲状态
+ */
+export default function useIdle(options?: UseIdleOptions): boolean;

package/hooks/useIdle/index.js

@@ -0,0 +1 @@
+import{useState as e,useEffect as t}from"react";function o(o={}){const{timeout:r=1e4,events:n=["mousemove","mousedown","resize","keydown","touchstart","wheel"]}=o,[s,i]=e(!1);return t(()=>{let e;const t=()=>{i(!0)},o=()=>{clearTimeout(e),e=setTimeout(t,r)};s||o();const u=()=>{s?i(!1):o()};return n.forEach(e=>{window.addEventListener(e,u,{passive:!0})}),()=>{clearTimeout(e),n.forEach(e=>{window.removeEventListener(e,u)})}},[r,n,s]),s}export{o as default};

package/hooks/useImportFile/index.d.ts

@@ -0,0 +1,16 @@
+import type { UploadFile } from "antd/es/upload";
+
+interface UseImportFileOptions {
+  /** 要上传的文件数组 */
+  files: UploadFile[];
+  /** 额外携带的参数对象 */
+  params?: Record<string, any>;
+}
+
+export type ImportFileFunction = (url: string, options: UseImportFileOptions) => Promise<any>;
+
+/**
+ * 导入文件
+ */
+export default function useImportFile(returnType: "array"): [boolean, ImportFileFunction];
+export default function useImportFile(returnType?: "object"): { loading: boolean; importFile: ImportFileFunction };

package/hooks/useImportFile/index.js

@@ -0,0 +1 @@
+import{request as o}from"@cqsjjb/jjb-common-lib/http.js";import{useState as r}from"react";function t(t="object"){const[e,i]=r(!1);let n=0;const a=(r,t)=>{if(n++,n>0&&i(!0),r)return new Promise((e,a)=>{const{files:l=[],params:c={}}=t,p=new FormData;l.forEach(o=>{o.originFileObj&&p.append("file",o.originFileObj)}),Object.keys(c).forEach(o=>{p.append(o,c[o])}),o(r,"post",p,{"Content-Type":"multipart/form-data"}).then(o=>{e(o)}).catch(o=>{a(o)}).finally(()=>{n--,n<=0&&i(!1)})});console.error("【importFile】 缺少 url 参数")};return"array"===t?[e,a]:{loading:e,importFile:a}}export{t as default};

package/hooks/useIsExistenceDuplicateSelection/index.d.ts

@@ -0,0 +1,22 @@
+interface IsExistenceDuplicateSelectionOptions<T> {
+  /** 需要检查重复项的目标数组 */
+  data: T[];
+  /** 用于去重判断的对象属性名 */
+  key: keyof T | string;
+  /** 可选的错误提示信息 */
+  message?: string;
+}
+
+/**
+ * 检查数组中是否存在重复项的函数
+ */
+interface IsExistenceDuplicateSelectionFunction {
+  <T>(options: IsExistenceDuplicateSelectionOptions<T>): Promise<void>;
+}
+
+/**
+ * 检查数组中是否存在重复项
+ */
+export default function useIsExistenceDuplicateSelection(): {
+  isExistenceDuplicateSelection: IsExistenceDuplicateSelectionFunction;
+};

package/hooks/useIsExistenceDuplicateSelection/index.js

@@ -0,0 +1 @@
+import{message as e}from"antd";import{uniqBy as t}from"lodash-es";function r(){return{isExistenceDuplicateSelection:r=>{const{data:n,key:o,message:s="存在重复项，请勿重复选择"}=r;return new Promise(r=>{t(n,o).length!==n.length?e.error(s):r()})}}}export{r as default};

package/hooks/useTable/index.d.ts

@@ -0,0 +1,75 @@
+import type { AntdTableOptions, AntdTableResult, Data, Params, Service } from "ahooks/lib/useAntdTable/types";
+import type { FormInstance } from "antd/es/form";
+
+type FormValues = Record<string, any>;
+/**
+ * useTable 钩子的选项参数
+ */
+export interface UseTableOptions<TData extends Data, TParams extends Params> extends Omit<AntdTableOptions<TData, TParams>, "defaultParams" | "form" | "defaultType"> {
+  /** 是否使用分页，默认是 */
+  usePagination?: boolean;
+  /** 默认分页参数，默认 { current: 1; pageSize: 10 } */
+  defaultPagination?: { current: number; pageSize: number };
+  /** 是否使用存储查询条件，默认是 */
+  useStorageQueryCriteria?: boolean;
+  /** 是否使用数据权限，默认是 */
+  usePermission?: boolean;
+  /** 额外参数 */
+  params?: Record<string, any> | (() => Record<string, any>);
+  /** 表单数据转换函数，在每次请求之前调用，接收当前搜索的表单项，要求返回一个对象 */
+  transform?: (formData: FormValues) => FormValues;
+  /** 表单实例（通过 Form.useForm() 创建） */
+  form?: FormInstance;
+}
+
+/**
+ * 基础分页配置接口
+ */
+export interface BasePaginationConfig {
+  /** 当前页码 */
+  current: number;
+  /** 每页数量 */
+  pageSize: number;
+  /** 总数 */
+  total: number;
+}
+
+/**
+ * 扩展分页配置接口
+ */
+export interface ExtendedPaginationConfig extends BasePaginationConfig {
+  /** 显示快速跳转 */
+  showQuickJumper: boolean;
+  /** 显示页码选择器 */
+  showSizeChanger: boolean;
+}
+
+/**
+ * useTable 钩子返回的结果
+ */
+export interface UseTableResult<TData extends Data, TParams extends Params> extends AntdTableResult<TData, TParams> {
+  /** 表格属性 */
+  tableProps: {
+    /** 表格数据 */
+    dataSource: TData["list"];
+    /** 表格加载状态 */
+    loading: boolean;
+    /** 表格改变 */
+    onChange: (pagination: any, filters?: any, sorter?: any) => void;
+    /** 分页属性 */
+    pagination: false | ExtendedPaginationConfig;
+    [key: string]: any;
+  };
+  /** 查询方法，等于直接调用 search.submit */
+  getData: () => void;
+}
+
+/**
+ * 自定义 useTable，继承 ahooks 的 useAntdTable，根据需求进行扩展
+ */
+declare function useTable<TData extends Data, TParams extends Params>(
+  service: Service<TData, TParams>,
+  options?: UseTableOptions<TData, TParams>,
+): UseTableResult<TData, TParams>;
+
+export default useTable;

package/hooks/useTable/index.js

@@ -0,0 +1 @@
+import{useAntdTable as e}from"ahooks";import t from"../useUrlQueryCriteria/index.js";function a(a,r){if(!a)return void console.error("【useTable】 缺少 service 参数");const{params:n,transform:o,...i}=r||{},{useStorageQueryCriteria:s=!0,usePagination:u=!0,usePermission:c=!0,defaultType:p="advance",defaultCurrent:l=1,defaultPageSize:g=20,defaultPagination:f={current:l,pageSize:g},...m}=i,{setUrlCriteriaQuery:y,getUrlCriteriaQuery:d}=t(),h=s?d("searchFormKeys","searchFormValues"):{},P=s&&u?d("paginationKeys","paginationValues"):{},S=Object.keys(h).length>0?h:{},b=u?Object.keys(P).length>0?P:f:{},z=e(function(e,t={},a,r){const n=("function"==typeof t?t():t)||{};return async({current:t,pageSize:o},i={})=>{let s=i;if("function"==typeof a){const e=a(i);e&&"object"==typeof e&&(s={...i,...e})}const u={pageIndex:t,pageSize:o,...s,...n};r&&(u.menuPath=window.location.pathname);const c=await e(u);return{list:c.data||[],total:c.totalCount||0,...c}}}(a,n,o,c),{...m,defaultParams:[b,S],defaultType:p,onSuccess:(e,t)=>{i.onSuccess&&i.onSuccess(e,t),s&&y(t[1]??{},u?{current:z.tableProps.pagination.current,pageSize:z.tableProps.pagination.pageSize}:{})}});return{...z,tableProps:{...z.tableProps,pagination:!!u&&{...z.tableProps.pagination,showQuickJumper:!0,showSizeChanger:!0}},getData:z.search.submit}}export{a as default};

package/hooks/useUploadFile/index.d.ts

@@ -0,0 +1,67 @@
+export interface UploadFile {
+  /** 原始文件对象 */
+  originFileObj?: File;
+  /** 文件URL */
+  filePath?: string;
+  /** 文件ID */
+  id?: string;
+  [key: string]: any;
+}
+
+export interface BaseParams {
+  /** 文件类型 */
+  type: number;
+  /** 企业id */
+  corpinfoId?: string;
+}
+
+export interface SingleParams extends BaseParams {
+  /** 外键id - 单文件上传时可选 */
+  foreignKey?: string;
+}
+
+export interface MultipleParams extends BaseParams {
+  /** 外键id - 多文件上传时必填 */
+  foreignKey: string;
+}
+
+export interface SingleUploadFileOptions {
+  /** 要上传的文件 */
+  files: UploadFile[];
+  /** 是否单文件上传 */
+  single?: true;
+  /** 上传的参数 */
+  params: SingleParams;
+}
+
+export interface MultipleUploadFileOptions {
+  /** 要上传的文件 */
+  files: UploadFile[];
+  /** 是否单文件上传 */
+  single: false;
+  /** 上传的参数 */
+  params: MultipleParams;
+}
+
+export interface SingleFileResponse {
+  /** 文件路径 */
+  filePath: string;
+  [key: string]: any;
+}
+
+export interface MultipleFileResponse {
+  /** 文件ID */
+  id: string;
+  [key: string]: any;
+}
+
+export interface UploadFileFunction {
+  (options: SingleUploadFileOptions): Promise<SingleFileResponse>;
+  (options: MultipleUploadFileOptions): Promise<MultipleFileResponse>;
+}
+
+/**
+ * 上传文件
+ */
+export default function useUploadFile(returnType: "array"): [boolean, UploadFileFunction];
+export default function useUploadFile(returnType?: "object"): { loading: boolean; uploadFile: UploadFileFunction };

package/hooks/useUploadFile/index.js

@@ -0,0 +1 @@
+import{request as e}from"@cqsjjb/jjb-common-lib/http.js";import{useState as o}from"react";import{UPLOAD_FILE_TYPE_ENUM as r,UPLOAD_FILE_PATH_ENUM as i}from"zy-react-data/enum/uploadFile";import{getBaseGateway as t}from"../../utils/index.js";function l(l="object"){const[n,a]=o(!1);let p=0;const s=o=>{if(o)return p++,p>0&&a(!0),new Promise((l,n)=>{const{files:s=[],single:f=!0,params:d}=o;if(!s)return void console.error("【uploadFile】 缺少 files 参数");if(!Array.isArray(s))return void console.error("【uploadFile】 的 files 需要是一个数组");if(!d)return void console.error("【uploadFile】 缺少 options.params 参数");if(!d.type)return void console.error("【uploadFile】 缺少 options.params.type 参数");if(!Object.values(r).includes(d.type))return void console.error(`【uploadFile】 传入的 type 不在 UPLOAD_FILE_TYPE_ENUM 中，当前传入的 type 是 ${d.type}`);const u=i[d.type];if(!u)return void console.error(`【uploadFile】未找到 type ${d.type} 对应的 path `);if(!f){if(!d.hasOwnProperty("foreignKey"))return void console.error("【uploadFile】 的 single 是 false，缺少 options.params.foreignKey 参数");void 0!==d.foreignKey&&null!==d.foreignKey||(d.foreignKey="")}if(0===s.length)return p--,p<=0&&a(!1),void l(f?{filePath:""}:{id:d.foreignKey});const c=new FormData;if(s.forEach(e=>{e.originFileObj&&c.append("files",e.originFileObj)}),Object.keys(d).forEach(e=>{c.append(e,d[e])}),c.append("path",u),0===c.getAll("files").length)return p--,p<=0&&a(!1),void l(f?{filePath:s[0].filePath}:{id:d.foreignKey});e(f?`/${t()}/imgFiles/save`:`/${t()}/imgFiles/batchSave`,"post",c,{"Content-Type":"multipart/form-data"}).then(e=>{l(f?{filePath:e.data.filePath}:{id:e.data.foreignKey})}).catch(e=>{n(e)}).finally(()=>{p--,p<=0&&a(!1)})});console.error("【uploadFile】 缺少 options 参数")};return"array"===l?[n,s]:{loading:n,uploadFile:s}}export{l as default};

package/hooks/useUrlQueryCriteria/index.d.ts

@@ -0,0 +1,8 @@
+export type SetUrlCriteriaQueryFunction = (searchForm: Record<string, any>, pagination: Record<string, any>) => void;
+
+export type GetUrlCriteriaQueryFunction = (keysStr: "searchFormKeys" | "paginationKeys" | string, valuesStr: "searchFormValues" | "paginationValues" | string) => Record<string, any>;
+
+/**
+ * 处理搜索条件缓存到 URL
+ */
+export default function useUrlQueryCriteria(): { setUrlCriteriaQuery: SetUrlCriteriaQueryFunction; getUrlCriteriaQuery: GetUrlCriteriaQueryFunction };

package/hooks/useUrlQueryCriteria/index.js

@@ -0,0 +1 @@
+import s from"@ahooksjs/use-url-state";function e(){const[e,r]=s({searchFormKeys:"",searchFormValues:"",paginationKeys:"",paginationValues:""},{navigateMode:"replace"});return{setUrlCriteriaQuery:function(s,e){const t=s=>{const e=[],r=[];return Object.entries(s).forEach(([s,t])=>{t&&(e.push(s),Array.isArray(t)?r.push(`[${t.join("|")}]`):r.push(t))}),{keys:e.join(","),values:r.join(",")}},i=t(s),a=t(e);r({searchFormKeys:i.keys||void 0,searchFormValues:i.values||void 0,paginationKeys:a.keys||void 0,paginationValues:a.values||void 0})},getUrlCriteriaQuery:function(s,r){const t=e[s]?e[s].split(","):[],i=e[r]?e[r].split(","):[],a={};return t.forEach((s,e)=>{if(i[e])if(i[e].startsWith("[")&&i[e].endsWith("]")){const r=i[e].substring(1,i[e].length-1);a[s]=r?r.split("|"):[]}else a[s]=i[e]}),a}}}export{e as default};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zy-react-library",
   "private": false,
-  "version": "2.1.11",
+  "version": "2.2.0",
   "type": "module",
   "description": "",
   "author": "LiuJiaNan",
@@ -11,7 +11,6 @@
     "css",
     "enum",
     "hooks",
-    "json",
     "regular",
     "utils",
     "README.md"
@@ -22,9 +21,10 @@
   "scripts": {
     "build": "rollup -c",
     "build:watch": "rollup -c -w",
+    "prepublishOnly": "npm run build",
     "patch": "npm version patch",
     "minor": "npm version minor",
-    "publish": "npm publish",
+    "release": "npm publish",
     "postinstall": "echo 'Thanks for using our component library!'"
   },
   "dependencies": {
@@ -62,9 +62,10 @@
     "eslint-plugin-react-hooks": "^7.0.0",
     "eslint-plugin-react-refresh": "^0.4.23",
     "glob": "^13.0.0",
-    "rollup": "^4.54.0",
     "react": "^18.3.1",
-    "typescript": "^5.9.3"
+    "rollup": "^4.54.0",
+    "typescript": "^5.9.3",
+    "zy-react-data": "^1.0.0"
   },
   "peerDependencies": {
     "@ahooksjs/use-url-state": ">=3.5.1 <4",
@@ -72,6 +73,7 @@
     "@ant-design/pro-components": ">=3.1.14-6 <4",
     "ahooks": ">=3.9.5 <4",
     "antd": ">=6.4.4 <7",
-    "react": ">=18.3.1 <19"
+    "react": ">=18.3.1 <19",
+    "zy-react-data": ">=1.0.0"
   }
 }

package/regular/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 匹配中国手机号码，可包含国家代码86，支持各种运营商号段。
+ */
+export const PHONE: RegExp;
+
+/**
+ * 匹配中国大陆的统一社会信用代码。
+ */
+export const UNIFIED_SOCIAL_CREDIT_CODE: RegExp;
+
+/**
+ * 匹配中国大陆的身份证号码，包括15位和18位号码，并验证最后一位校验码。
+ */
+export const ID_NUMBER: RegExp;
+
+/**
+ * 匹配中国大陆的移动电话号码，不包含国家代码。
+ */
+export const MOBILE_PHONE: RegExp;
+
+/**
+ * 匹配浮点数，允许整数、一位或两位小数，以及零的情况。
+ */
+export const FLOATING_POINT_NUMBER: RegExp;
+
+/**
+ * 两位小数。
+ */
+export const TWO_DECIMAL_PLACES: RegExp;
+
+/**
+ * 一位小数（非必须）。
+ */
+export const ONE_DECIMAL_PLACES: RegExp;
+
+/**
+ * 匹配中国大陆的车牌号码。
+ */
+export const LICENSE_PLATE_NUMBER: RegExp;
+
+/**
+ * 匹配强密码，要求至少8个字符，包含大小写字母、数字和特殊字符。
+ */
+export const STRONG_PASSWORD: RegExp;
+
+/**
+ * 匹配完整的HTML标签，包括开始标签和结束标签。
+ */
+export const HTML_TAG: RegExp;
+
+/**
+ * 匹配中国大陆的邮政编码。
+ */
+export const POSTAL_CODE: RegExp;
+
+/**
+ * 匹配座机号码。
+ */
+export const TEL_PHONE: RegExp;

package/regular/index.js

@@ -0,0 +1 @@
+const d=/^(?:(?:\+|00)86)?1(?:3\d|4[5-7|9]|5[0-3|5-9]|6[5-7]|7[0-8]|8\d|9[1|89])\d{8}$/,$=/^[0-9A-HJ-NPQRTUWXY]{2}\d{6}[0-9A-HJ-NPQRTUWXY]{10}$/,A=/^[1-9]\d{5}(?:18|19|20)\d{2}(?:0[1-9]|10|11|12)(?:0[1-9]|[12]\d|30|31)\d{3}[\dX]$/i,H=/^(13\d|14[579]|15[0-3,5-9]|166|17[0135-8]|18\d|19[89])\d{8}$/,J=/(^[1-9](\d+)?(\.\d{1,2})?$)|(^(0)$)|(^\d\.\d(\d)?$)/,N=/^\d+\.\d{2}$/,P=/^\d+(\.\d?)?$/,Z=/^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领][A-HJ-NP-Z][A-HJ-NP-Z0-9]{4,5}[A-HJ-NP-Z0-9挂学警港澳]$/,X=/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[^a-zA-Z\d]).{8,}$/,a=/<[^>]*>/g,g=/^(0[1-7]|1[0-356]|2[0-7]|3[0-6]|4[0-7]|5[1-7]|6[1-7]|7[0-5]|8[013-6])\d{4}$/g,o=/^(?:(?:\d{3}-)?\d{8}|^(?:\d{4}-)?\d{7,8})(?:-\d+)?$/;export{J as FLOATING_POINT_NUMBER,a as HTML_TAG,A as ID_NUMBER,Z as LICENSE_PLATE_NUMBER,H as MOBILE_PHONE,P as ONE_DECIMAL_PLACES,d as PHONE,g as POSTAL_CODE,X as STRONG_PASSWORD,o as TEL_PHONE,N as TWO_DECIMAL_PLACES,$ as UNIFIED_SOCIAL_CREDIT_CODE};