zy-react-library 2.1.11 → 2.2.0

package/README.md

@@ -37,7 +37,7 @@ import { FORM_ITEM_RENDER_ENUM } from "zy-react-library/enum/formItemRender";
 
 - 本文档根据当前包内 `.d.ts` 类型声明整理。
 - 继承自 `antd`、`@ant-design/pro-components`、`ahooks` 的原生属性不逐项展开，文档会说明继承关系；库自身新增的参数逐项列出。
-- `css`、`json`、除 `formItemRender` 外的枚举仅做简要说明。
+- `css` 仅做简要说明。
 - 参数表中的 `-` 表示源码未设置显式默认值；`undefined` 表示源码显式传入或保留为 `undefined`。
 
 ## 基础样式
@@ -50,15 +50,7 @@ import "zy-react-library/css/common.less";
 
 `common.less` 提供组件库通用样式，适合在应用入口统一引入。
 
-## 静态 JSON
-
-| 文件 | 引入路径 | 简要说明 |
-| --- | --- | --- |
-| `area.json` | `zy-react-library/json/area.json` | 行政区域树形数据，供地区级联、地区树选择使用。 |
-| `industry.json` | `zy-react-library/json/industry.json` | 行业分类树形数据，供行业级联、行业树选择使用。 |
-| `nation.json` | `zy-react-library/json/nation.json` | 民族数据列表。 |
-
-## 枚举
+## 枚举
 
 ### FORM_ITEM_RENDER_ENUM
 
@@ -88,18 +80,7 @@ import { FORM_ITEM_RENDER_ENUM } from "zy-react-library/enum/formItemRender";
 | `DATETIME` | `"datetime"` | `antd DatePicker` 日期时间 | `DatePickerProps` |
 | `DATETIME_RANGE` | `"datetimeRange"` | `antd DatePicker.RangePicker` 日期时间范围 | `RangePickerProps` |
 | `DIVIDER` | `"divider"` | `antd Divider` | `DividerProps` |
-| `FORM_LIST` | `"formList"` | `antd Form.List` | `FormListProps` |
-
-### 其他枚举
-
-| 枚举 | 引入路径                           | 简要说明 |
-| --- |------------------------------------| --- |
-| `DICTIONARY_APP_KEY_ENUM` | `zy-react-library/enum/dictionary` | 字典接口使用的 `appKey` 常量，包含 `DEFAULT`、`GWJ`。 |
-| `HIDDEN_SOURCE_ENUM` | `zy-react-library/enum/hidden/gwj` | 隐患来源选项列表。 |
-| `HIDDEN_STATE_ENUM` | `zy-react-library/enum/hidden/gwj` | 隐患状态选项列表。 |
-| `HIDDEN_RECTIFICATION_TYPE_ENUM` | `zy-react-library/enum/hidden/gwj` | 隐患整改类型选项列表。 |
-| `UPLOAD_FILE_TYPE_ENUM` | `zy-react-library/enum/uploadFile` | 文件上传类型编码枚举。 |
-| `UPLOAD_FILE_PATH_ENUM` | `zy-react-library/enum/uploadFile` | 文件上传类型编码到服务端路径标识的映射。 |
+| `FORM_LIST` | `"formList"` | `antd Form.List` | `FormListProps` |
 
 ## 表单配置类型
 
@@ -232,22 +213,22 @@ import { FORM_ITEM_RENDER_ENUM } from "zy-react-library/enum/formItemRender";
 | `TooltipPreviewImg` | `files=[]`、`fileUrlKey="filePath"`。 |
 | `SelectCreate` | `showDelete=true`、`label=""`、`maxCount=1`，内部固定 `mode="tags"`。 |
 | `BasicSelect` | `placeholder=""`、`data=[]`、`nameKey="name"`、`idKey="id"`，内置 `showSearch=true`、`allowClear=true`、`optionFilterProp="children"`。 |
-| `DictionarySelect` | `appKey=DICTIONARY_APP_KEY_ENUM.DEFAULT`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
+| `DictionarySelect` | `appKey="0bb989ecada5470c87635018ece9f327"`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
 | `PersonnelSelect` | `params={}`、`placeholder="人员"`、`isNeedCorpInfoId=false`、`isNeedDepartmentId=true`、`isNeedPostId=false`、`extraParams={}`，内部默认额外参数 `{ noMain: "", eqEmploymentFlag: 1 }`。 |
 | `BasicSelectTree` | `getNodePathsIsIncludeOneself=true`、`placeholder=""`、`treeData=[]`、`nameKey="name"`、`idKey="id"`、`childrenKey="children"`、`onlyLastLevel=false`，内置 `showSearch=true`、`allowClear=true`、`style={ width: "100%" }`。 |
 | `AreaSelectTree` | 内部使用 `area.json`，默认 `nameKey="label"`、`idKey="value"`。 |
 | `IndustrySelectTree` | 内部使用 `industry.json`，默认 `nameKey="dict_label"`、`idKey="dict_value"`、`childrenKey="childrenList"`。 |
 | `DepartmentSelectTree` | `params={}`、`placeholder="部门"`、`isNeedCorpInfoId=false`、`isNeedParentId=false`、`searchType="current"`，内部固定 `childrenKey="childrenList"`。 |
-| `DictionarySelectTree` | `appKey=DICTIONARY_APP_KEY_ENUM.DEFAULT`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
+| `DictionarySelectTree` | `appKey="0bb989ecada5470c87635018ece9f327"`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
 | `HiddenLevelSelectTree` | `isShowNeglect=true`、`isShowLarger=true`、`isShowMajor=true`，内部固定 `placeholder="隐患级别"`、`onlyLastLevel=true`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
 | `HiddenPartSelectTree` | `params={}`、`isNeedCorpInfoId=false`，内部固定 `placeholder="隐患部位"`、`nameKey="hiddenregion"`、`idKey="hiddenregionId"`。 |
 | `BasicCascader` | `getNodePathsIsIncludeOneself=true`、`placeholder=""`、`data=[]`、`nameKey="name"`、`idKey="id"`、`childrenKey="children"`。 |
 | `AreaCascader` | 内部使用 `area.json`，默认 `nameKey="label"`、`idKey="value"`。 |
 | `IndustryCascader` | 内部使用 `industry.json`，默认 `nameKey="dict_label"`、`idKey="dict_value"`、`childrenKey="childrenList"`。 |
-| `DictionaryCascader` | `appKey=DICTIONARY_APP_KEY_ENUM.DEFAULT`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
+| `DictionaryCascader` | `appKey="0bb989ecada5470c87635018ece9f327"`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
 | `BasicLeftTree` | `getNodePathsIsIncludeOneself=true`、`treeData=[]`、`nameKey="name"`、`idKey="id"`、`childrenKey="children"`，搜索框固定宽度容器 `300`。 |
 | `AreaLeftTree` | 内部使用 `area.json`，默认 `nameKey="label"`、`idKey="value"`。 |
-| `DictionaryLeftTree` | `appKey=DICTIONARY_APP_KEY_ENUM.DEFAULT`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
+| `DictionaryLeftTree` | `appKey="0bb989ecada5470c87635018ece9f327"`、`dictValue=""`、`nameKey="dictLabel"`、`idKey="dictValue"`。 |
 | `DepartmentLeftTree` | `params={}`、`searchType="current"`，内部固定 `childrenKey="childrenList"`。 |
 | `Map` | `longitudeProps="longitude"`、`latitudeProps="latitude"`、`required=true`、`area=""`、`showArea=false`、`disable=false`、`type="baidu"`。 |
 | `MapSelector` | `area=""`、`showArea=false`、`disable=false`、`type="baidu"`；弹窗宽度 `1000`、`maskClosable=false`、地图容器高度 `500px`。 |
@@ -832,7 +813,7 @@ import DictionarySelect from "zy-react-library/components/Select/Dictionary";
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 | --- | --- | --- | --- | --- |
-| `appKey` | `string` | 否 | `DICTIONARY_APP_KEY_ENUM.DEFAULT` | 字典应用 key。 |
+| `appKey` | `string` | 否 | `"0bb989ecada5470c87635018ece9f327"` | 字典应用 key。 |
 | `dictValue` | `string` | 是 | `""` | 字典类型值；为空会输出缺少参数错误。 |
 | `nameKey` | `string` | 否 | `"dictLabel"` | 标签字段名。 |
 | `idKey` | `string` | 否 | `"dictValue"` | 值字段名。 |
@@ -970,7 +951,7 @@ import DictionarySelectTree from "zy-react-library/components/SelectTree/Diction
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 | --- | --- | --- | --- | --- |
-| `appKey` | `string` | 否 | `DICTIONARY_APP_KEY_ENUM.DEFAULT` | 字典应用 key。 |
+| `appKey` | `string` | 否 | `"0bb989ecada5470c87635018ece9f327"` | 字典应用 key。 |
 | `dictValue` | `string` | 是 | - | 字典类型值。 |
 | `nameKey` | `string` | 否 | 节点标签字段名。 |
 | `idKey` | `string` | 否 | 节点值字段名。 |
@@ -1118,7 +1099,7 @@ import DictionaryCascader from "zy-react-library/components/Cascader/Dictionary"
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 | --- | --- | --- | --- | --- |
-| `appKey` | `string` | 否 | `DICTIONARY_APP_KEY_ENUM.DEFAULT` | 字典应用 key。 |
+| `appKey` | `string` | 否 | `"0bb989ecada5470c87635018ece9f327"` | 字典应用 key。 |
 | `dictValue` | `string` | 是 | - | 字典类型值。 |
 | `nameKey` | `string` | 否 | 节点标签字段名。 |
 | `idKey` | `string` | 否 | 节点值字段名。 |
@@ -1177,7 +1158,7 @@ import DictionaryLeftTree from "zy-react-library/components/LeftTree/Dictionary"
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 | --- | --- | --- | --- | --- |
-| `appKey` | `string` | 否 | `DICTIONARY_APP_KEY_ENUM.DEFAULT` | 字典应用 key。 |
+| `appKey` | `string` | 否 | `"0bb989ecada5470c87635018ece9f327"` | 字典应用 key。 |
 | `dictValue` | `string` | 是 | `""` | 字典类型值；为空会输出缺少参数错误。 |
 | `nameKey` | `string` | 否 | `"dictLabel"` | 节点标题字段名。 |
 | `idKey` | `string` | 否 | `"dictValue"` | 节点 key 字段名。 |
@@ -1238,7 +1219,7 @@ import DepartmentLeftTree from "zy-react-library/components/LeftTree/Department/
 | `useImportFile` | `returnType="object"`；执行导入时 `options.files=[]`、`options.params={}`。 |
 | `useDownloadBlob` | `returnType="object"`；执行下载时 `options.name=""`、`options.type=""`、`options.params={}`，未传 `type` 时使用 `application/vnd.ms-excel`，未传 `name` 时使用当前时间 `YYYY-MM-DD HH:mm:ss`。 |
 | `useDownloadFile` | `returnType="object"`；未传 `name` 时从 `url` 中截取文件名。 |
-| `useDictionary` | `returnType="object"`；执行获取时 `appKey=DICTIONARY_APP_KEY_ENUM.DEFAULT`。 |
+| `useDictionary` | `returnType="object"`；执行获取时 `appKey="0bb989ecada5470c87635018ece9f327"`。 |
 | `useGetUserInfo` | `returnType="object"`。 |
 | `useIdle` | `timeout=10000`、`events=["mousemove","mousedown","resize","keydown","touchstart","wheel"]`。 |
 | `useIsExistenceDuplicateSelection` | `message="存在重复项，请勿重复选择"`。 |
@@ -1484,7 +1465,7 @@ useDictionary("object"): { loading: boolean; getDictionary: getDictionaryFunctio
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 | --- | --- | --- | --- | --- |
-| `appKey` | `string` | 否 | `DICTIONARY_APP_KEY_ENUM.DEFAULT` | 字典应用 key。 |
+| `appKey` | `string` | 否 | `"0bb989ecada5470c87635018ece9f327"` | 字典应用 key。 |
 | `dictValue` | `string` | 是 | - | 字典类型值。 |
 
 返回 `Promise<DictionaryItem[]>`。

package/components/Cascader/Area/index.d.ts

@@ -0,0 +1,25 @@
+import type { FC } from "react";
+import type { BasicCascaderProps } from "../Basic";
+
+export interface AreaCascaderItem {
+  value: string;
+  label: string;
+  children: AreaCascaderItem[];
+}
+
+/**
+ * 组件属性
+ */
+export interface AreaCascaderProps extends Omit<BasicCascaderProps, "options" | "placeholder" | "nameKey" | "idKey" | "childrenKey" | "onGetNodePaths" | "onGetData"> {
+  /** 获取父级节点 */
+  onGetNodePaths?: (nodes: AreaCascaderItem[]) => void;
+  /** 获取数据 */
+  onGetData?: (data: AreaCascaderItem[], processedData: AreaCascaderItem[]) => void;
+}
+
+/**
+ * 属地级联组件
+ */
+declare const AreaCascader: FC<AreaCascaderProps>;
+
+export default AreaCascader;

package/components/Cascader/Area/index.js

@@ -0,0 +1 @@
+import a from"zy-react-data/json/area.json";import e from"../Basic/index.js";import{jsx as r}from"react/jsx-runtime";function t(t){const{...o}=t;return r(e,{data:a,nameKey:"label",idKey:"value",...o})}t.displayName="AreaCascader";export{t as default};

package/components/Cascader/Basic/index.d.ts

@@ -0,0 +1,31 @@
+import type { CascaderProps } from "antd/es/cascader";
+import type { FC } from "react";
+
+/**
+ * 组件属性
+ */
+export interface BasicCascaderProps extends Omit<CascaderProps, "fieldNames"> {
+  /** 树形数据 label 字段，默认 name */
+  nameKey?: string;
+  /** 树形数据 value 字段，默认 id */
+  idKey?: string;
+  /** 树形数据 children 字段，默认 children */
+  childrenKey?: string;
+  /** 决定 onGetNodePaths 是否包含自身节点，默认 true */
+  getNodePathsIsIncludeOneself?: boolean;
+  /** 获取父级节点 */
+  onGetNodePaths?: (nodes: Record<string, any>[]) => void;
+  /** 占位符 */
+  placeholder?: string;
+  /** 控制只能选择到第几级 */
+  level?: number;
+  /** 获取数据 */
+  onGetData?: (data: Record<string, any>[], processedData: Record<string, any>[]) => void;
+}
+
+/**
+ * 基础级联组件
+ */
+declare const BasicCascader: FC<BasicCascaderProps>;
+
+export default BasicCascader;

package/components/Cascader/Basic/index.js

@@ -0,0 +1 @@
+import{Cascader as e}from"antd";import{useMemo as a,useEffect as t}from"react";import{processTreeDataByLevel as n}from"../../../utils/index.js";import{jsx as r}from"react/jsx-runtime";function l(l){const{onGetData:o,onChange:i,onGetNodePaths:d,getNodePathsIsIncludeOneself:c=!0,placeholder:s="",data:m=[],nameKey:h="name",idKey:f="id",childrenKey:p="children",level:u,...y}=l,v=a(()=>u?n({data:m,level:u,childrenKey:p,currentLevel:1}):m,[m,u,p]);return t(()=>{o?.(m,v)},[m,v]),r(e,{options:v,placeholder:`请选择${s}`,onChange:(e,a)=>{if(a&&d){const e=(e=>{let a=e;return!c&&e&&(a=e.slice(0,-1)),a||[]})(a);d?.(e)}i?.(e,a)},onClear:()=>{d?.([])},fieldNames:{label:h,value:f,children:p},...y})}l.displayName="BasicCascader";export{l as default};

package/components/Cascader/Dictionary/index.d.ts

@@ -0,0 +1,34 @@
+import type { FC } from "react";
+import type { BasicCascaderProps } from "../Basic";
+
+export interface DictionaryCascaderItem {
+  dictValue: string;
+  dictLabel: string;
+  children: DictionaryCascaderItem[];
+  [key: string]: any;
+}
+
+/**
+ * 组件属性
+ */
+export interface DictionaryCascaderProps extends Omit<BasicCascaderProps, "options" | "nameKey" | "idKey" | "childrenKey" | "onGetNodePaths" | "onGetData"> {
+  /** appKey，默认 DICTIONARY_APP_KEY_ENUM.DEFAULT（0bb989ecada5470c87635018ece9f327） */
+  appKey?: string;
+  /** 要获取的字典 */
+  dictValue: string;
+  /** 树形数据 label 字段，默认 dictLabel */
+  nameKey?: string;
+  /** 树形数据 value 字段，默认 dictValue */
+  idKey?: string;
+  /** 获取父级节点 */
+  onGetNodePaths?: (nodes: DictionaryCascaderItem[]) => void;
+  /** 获取数据 */
+  onGetData?: (data: DictionaryCascaderItem[], processedData: DictionaryCascaderItem[]) => void;
+}
+
+/**
+ * 数据字典级联组件
+ */
+declare const DictionaryCascader: FC<DictionaryCascaderProps>;
+
+export default DictionaryCascader;

package/components/Cascader/Dictionary/index.js

@@ -0,0 +1 @@
+import{request as a}from"@cqsjjb/jjb-common-lib/http.js";import{useState as e,useEffect as t}from"react";import{DICTIONARY_APP_KEY_ENUM as i}from"zy-react-data/enum/dictionary";import{executeWithCache as r}from"../../../utils/index.js";import c from"../Basic/index.js";import{jsx as o}from"react/jsx-runtime";function n(n){const{appKey:d=i.DEFAULT,dictValue:s="",nameKey:m="dictLabel",idKey:p="dictValue",...y}=n,[u,l]=e([]);return t(()=>{(async()=>{if(!Object.values(i).includes(d))return void console.error(`【DictionaryCascader】 传入的 appKey 不在 DICTIONARY_APP_KEY_ENUM 中，当前传入的 appKey 是 ${d}`);if(!s)return void console.error("【DictionaryCascader】 缺少 dictValue 参数");const e={appKey:d,dictValue:s};await r(e,async()=>{const{data:e}=await a("/config/dict-trees/list/by/dictValues","get",{appKey:d,dictValue:s});return e},l)})()},[s]),o(c,{data:u,nameKey:m,idKey:p,...y})}n.displayName="DictionaryCascader";export{n as default};

package/components/Cascader/Industry/index.d.ts

@@ -0,0 +1,25 @@
+import type { FC } from "react";
+import type { BasicCascaderProps } from "../Basic";
+
+export interface IndustryCascaderItem {
+  dict_value: string;
+  dict_label: string;
+  childrenList: IndustryCascaderItem[];
+}
+
+/**
+ * 组件属性
+ */
+export interface IndustryCascaderProps extends Omit<BasicCascaderProps, "options" | "placeholder" | "nameKey" | "idKey" | "childrenKey" | "onGetNodePaths" | "onGetData"> {
+  /** 获取父级节点 */
+  onGetNodePaths?: (nodes: IndustryCascaderItem[]) => void;
+  /** 获取数据 */
+  onGetData?: (data: IndustryCascaderItem[], processedData: IndustryCascaderItem[]) => void;
+}
+
+/**
+ * 行业类型级联组件
+ */
+declare const IndustryCascader: FC<IndustryCascaderProps>;
+
+export default IndustryCascader;

package/components/Cascader/Industry/index.js

@@ -0,0 +1 @@
+import t from"zy-react-data/json/industry.json";import e from"../Basic/index.js";import{jsx as r}from"react/jsx-runtime";function a(a){const{...i}=a;return r(e,{data:t,nameKey:"dict_label",idKey:"dict_value",childrenKey:"childrenList",...i})}a.displayName="IndustryCascader";export{a as default};

package/components/Editor/index.d.ts

@@ -0,0 +1,29 @@
+import type { IDomEditor } from "@wangeditor/editor";
+import type { ForwardRefExoticComponent, RefAttributes } from "react";
+
+export interface EditorProps {
+  /** 编辑器内容值 */
+  value?: string;
+  /** 内容改变回调 */
+  onChange?: (html: string) => void;
+  /** 是否禁用 */
+  disabled?: boolean;
+}
+
+export interface EditorRef {
+  /** 获取编辑器实例 */
+  getEditorInstance: () => IDomEditor | null;
+  /** 获取HTML内容 */
+  getHtml: () => string | undefined;
+  /** 设置HTML内容 */
+  setHtml: (value: string) => void;
+  /** 获取文本内容 */
+  getText: () => string | undefined;
+}
+
+/**
+ * 富文本编辑器组件
+ */
+declare const Editor: ForwardRefExoticComponent<EditorProps & RefAttributes<EditorRef>>;
+
+export default Editor;

package/components/Editor/index.js

@@ -0,0 +1 @@
+import{Toolbar as e,Editor as t}from"@wangeditor/editor-for-react";import{forwardRef as o,useState as r,useEffect as l,useImperativeHandle as d}from"react";import{normalizeEmptyHtml as i}from"../../utils/index.js";import"@wangeditor/editor/dist/css/style.css";import{jsx as s,Fragment as a,jsxs as n}from"react/jsx-runtime";const m=o(({value:o,onChange:m,disabled:c},g)=>{const[u,f]=r(null),[p,x]=r("");return l(()=>{x(o)},[o]),l(()=>{u&&(c?u.disable():u.enable())},[c]),l(()=>()=>{u&&(u.destroy(),f(null))},[u]),d(g,()=>({getEditorInstance:()=>u,getHtml:()=>u&&u.getHtml(),setHtml:e=>{u&&u.setHtml(e)},getText:()=>u&&u.getText()})),s(a,{children:n("div",{style:{border:"1px solid #ccc"},children:[s(e,{editor:u,defaultConfig:{excludeKeys:["group-image","group-video","insertLink","emotion","todo","fullScreen","insertTable","codeBlock"]},mode:"default",style:{borderBottom:"1px solid #ccc"}}),s(t,{defaultConfig:{placeholder:"请输入内容..."},value:p,onCreated:e=>{f(e),c&&e.disable()},onChange:e=>{x(e.getHtml()),m?.(i(e.getHtml()))},mode:"default",style:{height:"500px",overflowY:"hidden"}})]})})});m.displayName="Editor";export{m as default};

package/components/Excel/index.d.ts

@@ -0,0 +1,22 @@
+import type { FC } from "react";
+
+export interface ExcelProps {
+  /** 是否显示弹窗 */
+  visible?: boolean;
+  /** 关闭回调 */
+  onCancel?: () => void;
+  /** xlsx 文件地址 */
+  file?: string;
+  /** xlsx 文件名 */
+  name?: string;
+  /** 是否内联展示 */
+  inline?: boolean;
+  /** 弹窗标题 */
+  title?: string;
+  /** 内容样式 */
+  style?: Record<string, any>;
+}
+
+declare const Excel: FC<ExcelProps>;
+
+export default Excel;

package/components/Excel/index.js

@@ -0,0 +1 @@
+import{Modal as e,Button as t,message as r,Spin as n}from"antd";import i from"exceljs";import{useRef as o,useState as l,useEffect as c}from"react";import a from"x-data-spreadsheet";import u from"../../hooks/useDownloadFile/index.js";import{getFileUrl as s}from"../../utils/index.js";import"x-data-spreadsheet/dist/xspreadsheet.css";import{jsx as d}from"react/jsx-runtime";function h(h){const{visible:x=!1,onCancel:w,file:p,name:v,inline:g=!1,title:y="Excel预览",style:C={}}=h,E=o(null),k=o(null),I=o(!1),T=s(),[b,j]=l(!1),{downloadFile:S}=u();c(()=>{if(!x&&!g||!p)return;I.current=!1;const e=setTimeout(()=>{(async()=>{j(!0),E.current.innerHTML="";try{const e=await fetch(p.includes(T)?p:T+p);if(!e.ok)throw new Error("加载 Excel 文件失败");const t=await e.arrayBuffer(),r=new i.Workbook;if(await r.xlsx.load(t),I.current)return;new a(E.current,{mode:"read",showToolbar:!1,showContextmenu:!1,view:{height:()=>E.current?.clientHeight||520,width:()=>E.current?.clientWidth||800}}).loadData(function(e){const t=[];return e.worksheets.forEach(e=>{t.push(function(e){const t={name:e.name,rows:{},cols:{len:e.columnCount||26},merges:e.model?.merges||[]};return e.columns.forEach((e,r)=>{e.width&&(t.cols[r]={width:Math.round(8*e.width)})}),e.eachRow({includeEmpty:!0},(e,r)=>{const n={cells:{}};e.height&&(n.height=Math.round(1.4*e.height)),e.eachCell({includeEmpty:!0},(e,t)=>{n.cells[t-1]={text:m(e)}}),t.rows[r-1]=n}),(t.merges||[]).forEach(e=>{const r=function(e){const[t,r=t]=e.split(":"),n=f(t),i=f(r);return{sri:n.rowIndex,sci:n.colIndex,eri:i.rowIndex,eci:i.colIndex}}(e),n=t.rows[r.sri]?.cells?.[r.sci];n&&(n.merge=[r.eri-r.sri,r.eci-r.sci])}),t}(e))}),t.length>0?t:[{name:"Sheet1",rows:{}}]}(r))}catch{r.error("加载 Excel 文件失败"),!g&&w&&w()}finally{I.current||j(!1)}})()},100);return()=>{I.current=!0,E.current&&(E.current.innerHTML=""),e&&clearTimeout(e)}},[x,g,p]);const D=()=>d(n,{spinning:b,children:d("div",{style:{height:"72vh",overflow:"hidden",...C},children:d("div",{ref:E,style:{width:"100%",height:"100%"}})})});return g?D():d("div",{ref:k,children:d(e,{style:{top:100,maxWidth:"calc(100vw - 32px)",paddingBottom:24},open:x,mask:{closable:!1},width:1e3,title:y,onCancel:()=>{w()},getContainer:!1,footer:[d(t,{onClick:()=>{w()},children:"关闭"},"cancel"),d(t,{type:"primary",onClick:()=>{S({url:p,name:v})},children:"下载"},"download")],children:D()})})}function m(e){if(null===e.value||void 0===e.value)return"";if(e.formula)return null===e.result||void 0===e.result?`=${e.formula}`:String(e.result);if(e.text)return e.text;if(e.value instanceof Date)return e.value.toLocaleDateString();if("object"==typeof e.value){if(e.value.text)return e.value.text;if(e.value.richText)return e.value.richText.map(e=>e.text).join("");if(void 0!==e.value.result)return String(e.value.result)}return String(e.value)}function f(e){const t=/^([A-Z]+)(\d+)$/i.exec(e);return t?{rowIndex:Number(t[2])-1,colIndex:(r=t[1],r.toUpperCase().split("").reduce((e,t)=>26*e+t.charCodeAt(0)-64,0)-1)}:{rowIndex:0,colIndex:0};var r}h.displayName="Excel";export{h as default};

package/components/FormBuilder/FormBuilder.d.ts

@@ -0,0 +1,66 @@
+import type { FormInstance, FormProps } from "antd/es/form";
+import type { Gutter } from "antd/es/grid/row";
+import type { ReactElement, ReactNode } from "react";
+import type { FormOption } from "./FormItemsRenderer";
+
+/**
+ * 深度部分类型，将所有嵌套属性都变为可选
+ */
+export type DeepPartial<T> = T extends object
+  ? { [P in keyof T]?: DeepPartial<T[P]> }
+  : T;
+
+/**
+ * FormBuilder 组件属性
+ */
+export interface FormBuilderProps<Values = any> extends Omit<FormProps, "form" | "onFinish"> {
+  /** 表单初始值 */
+  values?: DeepPartial<Values>;
+  /** 表单配置项数组 */
+  options: FormOption<Values>[];
+  /** 栅格间距，默认 24 */
+  gutter?: Gutter | [Gutter, Gutter];
+  /** 占据栅格列数，默认 12 */
+  span?: number;
+  /** 自动生成必填规则，默认 true */
+  useAutoGenerateRequired?: boolean;
+  /** 是否显示操作按钮区域，默认 true */
+  showActionButtons?: boolean;
+  /** 提交按钮文字，默认 "提交" */
+  submitButtonText?: string;
+  /** 取消按钮文字，默认 "取消" */
+  cancelButtonText?: string;
+  /** 是否显示提交按钮，默认 true */
+  showSubmitButton?: boolean;
+  /** 是否显示取消按钮，默认 true */
+  showCancelButton?: boolean;
+  /** 自定义操作按钮组 */
+  customActionButtons?: ReactNode;
+  /** 额外操作按钮组 */
+  extraActionButtons?: ReactNode;
+  /** 是否处于加载状态，默认 false */
+  loading?: boolean;
+  /** 表单实例（通过 Form.useForm() 创建） */
+  form: FormInstance<Values>;
+  /** 表单提交时的回调函数 */
+  onFinish?: (values: Values) => void;
+  /** 历史记录对象，用于返回上一页，默认使用 window.history.back */
+  history?: {
+    goBack?: () => void;
+    [key: string]: any;
+  };
+}
+
+/**
+ * 表单构建器组件
+ */
+type FormBuilderComponent = {
+  useForm: typeof import("antd").Form.useForm;
+  useWatch: typeof import("antd").Form.useWatch;
+} & {
+  <Values = any>(props: FormBuilderProps<Values>): ReactElement;
+};
+
+declare const FormBuilder: FormBuilderComponent;
+
+export default FormBuilder;

package/components/FormBuilder/FormBuilder.js

@@ -0,0 +1 @@
+import{Form as e,Spin as t,Row as o,Col as r,Space as i,Button as n,message as s}from"antd";import{useState as l,useEffect as a}from"react";import{throttle as u}from"throttle-debounce";import c from"./FormItemsRenderer.js";import{jsx as d,jsxs as m}from"react/jsx-runtime";const p=p=>{const{values:h,options:g,gutter:w=24,span:x=12,labelCol:y={span:4},useAutoGenerateRequired:b=!0,showActionButtons:B=!0,submitButtonText:f="提交",cancelButtonText:v="取消",showSubmitButton:A=!0,showCancelButton:C=!0,customActionButtons:F,extraActionButtons:T,history:k,loading:W=!1,...q}=p,[z,E]=l(window.innerWidth),R=u(50,()=>{const e=document.querySelector("#page-layout");e&&E(e.offsetWidth)});return a(()=>{const e=setTimeout(()=>{R()},0);return B&&window.addEventListener("resize",R),()=>{B&&window.removeEventListener("resize",R),clearTimeout(e)}},[B]),d(t,{spinning:W,children:m(e,{labelCol:y,scrollToFirstError:!0,wrapperCol:{span:24-y.span},initialValues:h,onFinishFailed:()=>{s.error("请补全必填项")},style:{width:`calc(100% - ${2*w}px)`,margin:"0 auto"},...q,children:[d(o,{gutter:w,children:d(c,{options:g,labelCol:y,span:x,gutter:w,useAutoGenerateRequired:b,initialValues:h})}),B&&m("div",{style:{position:"relative",zIndex:"99"},children:[d("div",{style:{height:"32px"}}),d(o,{style:{textAlign:"center",backgroundColor:"rgb(241, 241, 242)",padding:"10px 0",position:"fixed",bottom:"0",width:z,margin:"0 -44px"},children:d(r,{span:24,style:{textAlign:"center"},children:F||m(i,{children:[A&&d(n,{type:"primary",htmlType:"submit",children:f}),T,C&&d(n,{onClick:()=>{k?.goBack?k.goBack():window.history.back()},children:v})]})})})]})]})})};p.displayName="FormBuilder",p.useForm=e.useForm,p.useWatch=e.useWatch;export{p as default};