@hi-ui/schema-fields 4.0.0-experimental.1

package/lib/esm/fields/semantic/tag/index.js

@@ -0,0 +1,149 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import _inheritsLoose from '@babel/runtime/helpers/esm/inheritsLoose';
+import React from 'react';
+import { cx } from '@hi-ui/classname';
+import { omit, isNil } from 'lodash-es';
+import { Tag } from '@hi-ui/tag';
+import { ProField } from '../../../base.js';
+import { ReadonlyWrapper } from '../../../components/span/index.js';
+import './index.scss.js';
+
+// IPD的标签颜色规范，先记录在这里吧
+// https://www.figma.com/design/R7gUHJaKDPSAaWojTrNUe2/%E7%A0%94%E4%BA%A7%E4%BE%9B%E4%B8%9A%E5%8A%A1%E8%AE%BE%E8%AE%A1%E8%A7%84%E8%8C%83-IPD?node-id=2042-50477&node-type=frame&t=uCEcQbmB9uwVVUIQ-0
+var colorPreset = {
+  blue: {
+    back: '#EDF7FE',
+    fore: '#0744AD'
+  },
+  yellow: {
+    back: '#FEFCE9',
+    fore: '#875100'
+  },
+  green: {
+    back: '#EEFEF2',
+    fore: '#007D3E'
+  },
+  red: {
+    back: '#FEF1EE',
+    fore: '#B32D36'
+  },
+  orange: {
+    back: '#FEF5EE',
+    fore: '#B23E1B'
+  },
+  purple: {
+    back: '#F5EEFE',
+    fore: '#533DAD'
+  },
+  /** 蓝绿色 */cyan: {
+    back: '#ECFEFC',
+    fore: '#0C737A'
+  },
+  /** 天蓝色 */skyblue: {
+    back: '#ECFCFE',
+    fore: '#006BB3'
+  },
+  /** 深紫色 */darkPurple: {
+    back: '#EEF2FE',
+    fore: '#363AB3'
+  },
+  /** 蓝灰色 */blueGray: {
+    back: '#EEF7FE',
+    fore: '#3C5485'
+  },
+  /** 中灰色 */midGray: {
+    back: '#F2F4F7',
+    fore: '#1F2733'
+  }
+};
+var ColorEnumPreset = Object.keys(colorPreset);
+function isInvalidTagData(data) {
+  if (isNil(data)) return true;
+  if (data === '') return true;
+  return false;
+}
+var ProTag = /*#__PURE__*/function (_ProField) {
+  _inheritsLoose(ProTag, _ProField);
+  function ProTag() {
+    return _ProField.apply(this, arguments) || this;
+  }
+  var _proto = ProTag.prototype;
+  _proto.render = function render(data, ctx) {
+    if (isInvalidTagData(data)) return this.dftDom;
+    // 统一转换为数组处理
+    var dataList = (Array.isArray(data) ? data : [data]).filter(function (el) {
+      return !isInvalidTagData(el);
+    });
+    if (dataList.length === 0) return this.dftDom;
+    return this.renderTag(dataList, ctx);
+  };
+  _proto.renderTag = function renderTag(dataArray, ctx) {
+    var _this = this;
+    var fieldProps = this.getFieldProps({}, ctx);
+    var className = cx(fieldProps.className, {
+      'pro-tag--bordered': fieldProps.bordered
+    });
+    var tagProps = this.getTagProps(fieldProps);
+    return /*#__PURE__*/React.createElement(ReadonlyWrapper, {
+      style: {
+        gap: 4
+      }
+    }, dataArray.map(function (data, index) {
+      var _a;
+      var _preset = (_a = fieldProps.colorPreset) === null || _a === void 0 ? void 0 : _a[data];
+      var text = _this.getText(data, fieldProps.textMap);
+      // 没有预设颜色，则显示默认Tag样式
+      if (!_preset) {
+        return /*#__PURE__*/React.createElement("span", {
+          key: index
+        }, /*#__PURE__*/React.createElement(Tag, Object.assign({
+          type: "default"
+        }, tagProps, {
+          className: className
+        }), text));
+      }
+      // 内置类型
+      var type = _this.getType(_preset);
+      // 自定义颜色(文字色和背景色)
+      var color = _this.getColor(_preset);
+      return /*#__PURE__*/React.createElement("span", {
+        key: index
+      }, /*#__PURE__*/React.createElement(Tag, Object.assign({
+        type: type,
+        color: color === null || color === void 0 ? void 0 : color.fore,
+        background: color === null || color === void 0 ? void 0 : color.back
+      }, tagProps, {
+        className: className
+      }), text));
+    }));
+  };
+  _proto.getTagProps = function getTagProps(props) {
+    return omit(props, ['bordered', 'colorPreset']);
+  };
+  _proto.getType = function getType(preset) {
+    if (typeof preset !== 'string') return undefined;
+    if (preset in colorPreset) return undefined;
+    return preset;
+  };
+  _proto.getColor = function getColor(preset) {
+    if (typeof preset !== 'string') return preset;
+    if (preset in colorPreset) return colorPreset[preset];
+    return undefined;
+  };
+  _proto.getText = function getText(data, textMap) {
+    var _a, _b;
+    if (!textMap) return data;
+    if (textMap instanceof Map) return (_a = textMap.get(data)) !== null && _a !== void 0 ? _a : data;
+    return (_b = textMap[data]) !== null && _b !== void 0 ? _b : data;
+  };
+  return ProTag;
+}(ProField);
+export { ColorEnumPreset, ProTag, colorPreset };

package/lib/esm/fields/semantic/tag/index.scss.js

@@ -0,0 +1,13 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import __styleInject__ from '@hi-ui/style-inject';
+var css_248z = ".pro-tag--bordered {border: 0.5px solid #dfe2e8;}";
+__styleInject__(css_248z);
+export { css_248z as default };

package/lib/esm/fields/semantic/text/index.js

@@ -0,0 +1,47 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import _inheritsLoose from '@babel/runtime/helpers/esm/inheritsLoose';
+import React from 'react';
+import { omit } from 'lodash-es';
+import { Input } from '@hi-ui/input';
+import { mapToDumb } from '@hi-ui/dumb-wrapper';
+import { ProField } from '../../../base.js';
+var DumbInput = mapToDumb(Input, {
+  getChangedValue: function getChangedValue(evt, value) {
+    return value;
+  }
+});
+var ProText = /*#__PURE__*/function (_ProField) {
+  _inheritsLoose(ProText, _ProField);
+  function ProText() {
+    return _ProField.apply(this, arguments) || this;
+  }
+  var _proto = ProText.prototype;
+  _proto.render = function render(data, ctx) {
+    if (!data) return this.dftDom;
+    if (typeof data === 'string') {
+      return this.renderString(data, ctx);
+    }
+    try {
+      return this.renderString(String(data), ctx);
+    } catch (error) {
+      return this.dftDom;
+    }
+  };
+  _proto.renderFormItem = function renderFormItem(_, ctx) {
+    var fieldProps = this.getFieldProps({
+      placeholder: this.getDftPlaceholder(ctx)
+    }, ctx);
+    var pureInputProps = omit(fieldProps, ['numberOfLines', 'tooltipClassName', 'useRawInput']);
+    return fieldProps.useRawInput ? ( /*#__PURE__*/React.createElement(Input, Object.assign({}, pureInputProps))) : ( /*#__PURE__*/React.createElement(DumbInput, Object.assign({}, pureInputProps)));
+  };
+  return ProText;
+}(ProField);
+export { DumbInput, ProText };

package/lib/esm/index.js

@@ -0,0 +1,85 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import { FieldMapProvider } from './ctx.js';
+export { matchFieldClass, useFieldMap, useMatchFieldClass } from './ctx.js';
+import { ProCascader } from './fields/basic/cascader/index.js';
+import { ProCheckCascader } from './fields/basic/check-cascader/index.js';
+import { ProCheckSelect } from './fields/basic/check-select/index.js';
+import { ProCheckTreeSelect } from './fields/basic/check-tree-select/index.js';
+import { ProCheckbox } from './fields/basic/checkbox/index.js';
+import { ProCounter } from './fields/basic/counter/index.js';
+import { ProDate } from './fields/semantic/date/index.js';
+import { ProImage } from './fields/semantic/image/index.js';
+import { ProLink } from './fields/semantic/link/index.js';
+import { ProNumber } from './fields/semantic/number/index.js';
+import { ProRadio } from './fields/basic/radio/index.js';
+import { ProRating } from './fields/basic/rating/index.js';
+import { ProSelect } from './fields/basic/select/index.js';
+import { ProSlider } from './fields/basic/slider/index.js';
+import { ProSwitch } from './fields/basic/switch/index.js';
+import { ProTag } from './fields/semantic/tag/index.js';
+export { ColorEnumPreset, colorPreset } from './fields/semantic/tag/index.js';
+import { ProText } from './fields/semantic/text/index.js';
+export { DumbInput } from './fields/semantic/text/index.js';
+import { ProTextArea } from './fields/basic/textarea/index.js';
+import { ProTimePicker } from './fields/basic/time-picker/index.js';
+import { ProTreeSelect } from './fields/basic/tree-select/index.js';
+import { ProUpload } from './fields/basic/upload/index.js';
+import { ProNumberRange } from './fields/enhance/number-range/index.js';
+export { ProField } from './base.js';
+export { ReadonlyWrapper, ReadonlyWrapper as Span } from './components/span/index.js';
+export { getFieldProps, getFormItemProps, getWrapperProps } from './utils.js';
+export { ImagePreview } from './components/image-preview/index.js';
+export { UploadBridge } from './components/upload-bridge/index.js';
+export { EditableField } from './editable/index.js';
+export { getLabel } from './utils/label.js';
+export { BatchDepUpdate } from './utils/batch-dep-update.js';
+export { wrapFormBinding } from './utils/form-binding.js';
+export { isReadonly, runDynamicEditable, useReadonly } from './editable/use-readonly.js';
+export { EditableControlProvider, useEditableControlCtx } from './editable/ctx.js';
+export { SimpleCase, isSimpleCase } from './editable/simple.js';
+export { ReadonlyCase } from './editable/readonly.js';
+export { EditableCase } from './editable/editable.js';
+
+// export { ProUser, type ProUserProps } from './enhance/user'
+var ProFieldMap = {
+  cascader: ProCascader,
+  'check-cascader': ProCheckCascader,
+  'check-select': ProCheckSelect,
+  'check-tree-select': ProCheckTreeSelect,
+  checkbox: ProCheckbox,
+  counter: ProCounter,
+  date: ProDate,
+  image: ProImage,
+  link: ProLink,
+  number: ProNumber,
+  radio: ProRadio,
+  rating: ProRating,
+  select: ProSelect,
+  slider: ProSlider,
+  "switch": ProSwitch,
+  tag: ProTag,
+  text: ProText,
+  textarea: ProTextArea,
+  'time-picker': ProTimePicker,
+  'tree-select': ProTreeSelect,
+  upload: ProUpload,
+  // 'edit-table': ProEditTable,
+  'number-range': ProNumberRange
+  // user: ProUser,
+};
+
+function BuiltinFieldMapProvider(props) {
+  return /*#__PURE__*/React.createElement(FieldMapProvider, {
+    fields: ProFieldMap
+  }, props.children);
+}
+export { BuiltinFieldMapProvider, FieldMapProvider, ProCascader, ProCheckCascader, ProCheckSelect, ProCheckTreeSelect, ProCheckbox, ProCounter, ProDate, ProFieldMap, ProImage, ProLink, ProNumber, ProNumberRange, ProRadio, ProRating, ProSelect, ProSlider, ProSwitch, ProTag, ProText, ProTextArea, ProTimePicker, ProTreeSelect, ProUpload };

package/lib/esm/utils/batch-dep-update.js

@@ -0,0 +1,35 @@
+import _typeof from "@babel/runtime/helpers/esm/typeof";
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { set } from 'lodash-es';
+var BatchDepUpdate = /*#__PURE__*/function () {
+  function BatchDepUpdate() {}
+  BatchDepUpdate.update = function update(values) {
+    return {
+      _IS_BATCH_UPDATE_: true,
+      values: values
+    };
+  };
+  BatchDepUpdate.isBatch = function isBatch(value) {
+    return _typeof(value) === 'object' && !!value && '_IS_BATCH_UPDATE_' in value && 'values' in value;
+  }
+  // key 可能会是普通字符串或路径数组
+  ;
+
+  BatchDepUpdate.getValues = function getValues(key, value) {
+    if (this.isBatch(value)) return value.values;else {
+      var _ref;
+      // 仅在明确传入路径数组时，才使用 set 方法
+      if (Array.isArray(key)) return set({}, key, value);else return _ref = {}, _ref[key] = value, _ref;
+    }
+  };
+  return BatchDepUpdate;
+}();
+export { BatchDepUpdate };

package/lib/esm/utils/form-binding.js

@@ -0,0 +1,34 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+// TODO 待完善类型定义
+function wrapFormBinding(formBinding, fieldProps) {
+  return Object.assign(Object.assign({}, formBinding), {
+    value: formBinding.value,
+    onChange: function onChange() {
+      var _a2;
+      var _a;
+      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+        args[_key] = arguments[_key];
+      }
+      formBinding.onChange.apply(formBinding, args);
+      (_a = fieldProps.onChange) === null || _a === void 0 ? void 0 : (_a2 = _a).call.apply(_a2, [fieldProps].concat(args));
+    },
+    onBlur: function onBlur() {
+      var _a3;
+      var _a;
+      for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+        args[_key2] = arguments[_key2];
+      }
+      formBinding.onBlur.apply(formBinding, args);
+      (_a = fieldProps.onBlur) === null || _a === void 0 ? void 0 : (_a3 = _a).call.apply(_a3, [fieldProps].concat(args));
+    }
+  });
+}
+export { wrapFormBinding };

package/lib/esm/utils/label.js

@@ -0,0 +1,21 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import EllipsisTooltip from '@hi-ui/ellipsis-tooltip';
+function getLabel(field, ctx) {
+  var _a, _b, _c;
+  // 在组中时，不需要显示 label
+  if ((_a = field.extra) === null || _a === void 0 ? void 0 : _a.mustInGroup) return undefined;
+  if (typeof ((_b = field.extra) === null || _b === void 0 ? void 0 : _b.customLabel) === 'function') {
+    return (_c = field.extra) === null || _c === void 0 ? void 0 : _c.customLabel(ctx);
+  }
+  return typeof field.title === 'string' ? ( /*#__PURE__*/React.createElement(EllipsisTooltip, null, field.title)) : field.title;
+}
+export { getLabel };

package/lib/esm/utils.js

@@ -0,0 +1,27 @@
+/** @LICENSE
+ * @hi-ui/schema-fields
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-fields#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { getPipeGetterValue, mergeProps } from '@hi-ui/schema-utils';
+import { wrapFormBinding } from './utils/form-binding.js';
+import 'react';
+import '@hi-ui/ellipsis-tooltip';
+import 'lodash-es';
+function getFieldProps(dftProps, ctx) {
+  var fieldProps = getPipeGetterValue(dftProps, ctx.field.fieldProps);
+  // formBinding 本质是 Form 注入给 field 的属性，因此在此处统一处理
+  var formBindingProps = ctx.formBinding ? wrapFormBinding(ctx.formBinding, fieldProps) : {};
+  return mergeProps(fieldProps, formBindingProps);
+}
+function getWrapperProps(dftProps, ctx) {
+  return getPipeGetterValue(dftProps, ctx.field.wrapperProps);
+}
+function getFormItemProps(dftProps, ctx) {
+  return getPipeGetterValue(dftProps, ctx.field.formItemProps);
+}
+export { getFieldProps, getFormItemProps, getWrapperProps, wrapFormBinding };

package/lib/types/base.d.ts

@@ -0,0 +1,44 @@
+import React from 'react';
+import { InputProps } from '@hi-ui/input';
+import { AbstractProField } from '@hi-ui/schema-core';
+import type { FormItemProps, ProFieldProps, ProFieldRenderCtx, ProFieldRenderCellCtx, ProFieldRenderFooterCellCtx, ProFieldRenderFormItemCtx, ProFieldRenderEditableCtx, ProFieldRenderEditCellCtx, FieldRendererType } from '@hi-ui/schema-core';
+import type { NormalFieldCtxType } from './utils';
+export { ProFieldProps, ProFieldRenderCtx, ProFieldRenderCellCtx, ProFieldRenderFooterCellCtx, ProFieldRenderFormItemCtx, ProFieldRenderEditableCtx, ProFieldRenderEditCellCtx, FieldRendererType, };
+/**
+ * 增强型的自定义渲染函数
+ * - 用于在字段内部渲染逻辑的基础之上进行额外增强
+ */
+export type EnhancedRenderersType = Partial<{
+    [K in keyof AbstractProField as K extends 'constructor' ? never : K]: AbstractProField[K] extends AnyFn ? (dom: React.ReactNode, innerCtx: {
+        render: ProField;
+        data: Parameters<AbstractProField[K]>[0];
+        renderCtx: Parameters<AbstractProField[K]>[1];
+    }) => React.ReactNode : never;
+}>;
+export declare class ProField extends AbstractProField {
+    dftDom: JSX.Element;
+    protected getFieldProps<FieldProps extends AnyObject>(dftProps: FieldProps, ctx: NormalFieldCtxType<FieldProps>): FieldProps;
+    protected getWrapperProps<WrapperProps extends AnyObject>(dftProps: WrapperProps, ctx: Pick<ProFieldRenderCtx<AnyObject, WrapperProps>, 'field'>): WrapperProps;
+    protected getFormItemProps(dftProps: FormItemProps, ctx: Pick<ProFieldRenderFormItemCtx, 'field'>): FormItemProps;
+    /**
+     * 渲染字符串的内部方法
+     * @desc 很多类型的字段最终渲染时都是文本，因此提取一个公共方法到此处
+     * @desc 封装了 EllipsisTooltip 的逻辑 */
+    protected renderString(text: string, ctx: ProFieldRenderCtx<ProFieldProps>): JSX.Element;
+    /** 只读模式的渲染逻辑 */
+    render(data: unknown, ctx: ProFieldRenderCtx<AnyType>): JSX.Element;
+    /**
+     * 表格单元格渲染逻辑
+     * @desc 默认直接使用 render 的逻辑 */
+    renderCell(data: unknown, ctx: ProFieldRenderCellCtx<AnyType>): JSX.Element;
+    /**
+     * 表格 Footer 单元格渲染逻辑
+     * @desc 没有默认逻辑，需由字段自行实现 */
+    renderFooterCell(ctx: ProFieldRenderFooterCellCtx<AnyType>): React.ReactNode;
+    renderFormItem(data: null, ctx: ProFieldRenderFormItemCtx<AnyType>): void;
+    protected getEditablePlaceholder(data: unknown, ctx: ProFieldRenderEditableCtx<AnyType>): unknown;
+    /** 编辑模式的渲染逻辑，在只读与可编辑之间切换 */
+    renderEditable(data: unknown, ctx: ProFieldRenderEditableCtx<AnyType>, extraProps?: InputProps): JSX.Element;
+    getDftPlaceholder(ctx: NormalFieldCtxType<AnyType>): string | undefined;
+}
+export type FieldMapType = Record<string, typeof ProField>;

package/lib/types/components/async-refill-placeholder/index.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { ProFieldRenderEditableCtx } from '../../base';
+export declare const AsyncRefillPlaceholder: React.FC<{
+    data: string;
+    ctx: ProFieldRenderEditableCtx<AnyObject>;
+    genInitialOptsData: () => Promise<AnyObject[]>;
+}>;

package/lib/types/components/image-preview/index.d.ts

@@ -0,0 +1,5 @@
+type ImagePreviewProps = {
+    images: string[];
+};
+export declare function ImagePreview(props: ImagePreviewProps): JSX.Element;
+export {};

package/lib/types/components/span/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export type ReadonlyWrapperProps = {
+    children: React.ReactNode;
+    dataSet?: Record<string, Primitive | undefined>;
+    style?: React.CSSProperties;
+};
+export declare function ReadonlyWrapper(props: ReadonlyWrapperProps): JSX.Element;
+export { ReadonlyWrapper as Span };

package/lib/types/components/upload-bridge/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { UploadProps } from '@hi-ui/upload';
+import type { UploadBridgeProps } from './type';
+export { UploadBridgeProps };
+export declare function UploadBridge(props: React.PropsWithChildren<UploadBridgeProps>): React.ReactElement<UploadProps, string | React.JSXElementConstructor<any>>;

package/lib/types/components/upload-bridge/type.d.ts

@@ -0,0 +1,26 @@
+import type { StandardProps } from 'ahooks/es/useControllableValue';
+import type { UploadProps } from '@hi-ui/upload';
+export type BaseFileInfoType = {
+    /** 文件名称 */
+    name: string;
+    /** 包含协议、域名、路径等的完整文件地址 */
+    url: string;
+};
+export type UploadFileType = string | File | (BaseFileInfoType & {
+    /** 文件唯一标识 */
+    fileId?: string;
+});
+export type UploadBridgeProps = Partial<StandardProps<UploadFileType[]>> & Omit<UploadProps, 'customUpload' | 'onChange' | 'fileList' | 'onRemove' | 'maxSize' | 'uploadAction' | 'data' | 'name' | 'method' | 'headers' | 'withCredentials' | 'beforeUpload'> & {
+    /**
+     * 上传模式
+     * @default 'formData'
+     * @desc formData 模式时，响应给外部的是【文件】的列表
+     * @desc json 模式时，响应给外部的是【文件基本信息对象】的列表
+     * @desc json 模式时需传入 request 方法，用来上传文件
+     * @desc json 模式下，返回的信息顺序需与上传的顺序一致，否则可能导致自动去重逻辑失效
+     */
+    mode?: 'formData' | 'json';
+    request?: (files: File[]) => Promise<(string | BaseFileInfoType)[]>;
+    /** 接收上传的文件体积上限（单位：KB） */
+    maxSize?: number;
+};

package/lib/types/components/upload-bridge/utils.d.ts

@@ -0,0 +1,11 @@
+import type { UploadFileItem } from '@hi-ui/upload';
+import type { UploadFileType } from './type';
+export declare function toFileList(file?: UploadFileType | UploadFileType[]): {
+    fileIdSet?: undefined;
+    fileList?: undefined;
+} | {
+    fileIdSet: Set<string>;
+    fileList: UploadFileItem[];
+};
+export declare function genFileIdentifier(file: UploadFileType): string;
+export declare function sliceToMaxCount<T>(value: T[], maxCount: number | undefined, curCount?: number): T[];

package/lib/types/ctx.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { ProFieldMapType } from '.';
+export declare function FieldMapProvider(props: React.PropsWithChildren<{
+    fields: Partial<ProFieldMapType>;
+}>): JSX.Element;
+export type UseFieldMapOpts = {
+    /** 自定义字段渲染器映射配置 */
+    fieldMap?: Partial<ProFieldMapType>;
+};
+export declare function useFieldMap(opts?: UseFieldMapOpts): ProFieldMapType;
+export type MatchFieldClassOpts = UseFieldMapOpts & {
+    name?: string;
+    field: FieldConfigType;
+    fieldMap: ProFieldMapType;
+};
+export declare function matchFieldClass(opts: MatchFieldClassOpts): typeof import("./base").ProField;
+export type UseMatchFieldClassOpts = Omit<MatchFieldClassOpts, 'fieldMap'> & {
+    fieldMap?: ProFieldMapType;
+};
+export declare function useMatchFieldClass(opts: UseMatchFieldClassOpts): typeof import("./base").ProField;

package/lib/types/editable/ctx.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { FieldControlType } from '@hi-ui/schema-core';
+export type EditableControlCtxType = Partial<Pick<FieldControlType, 'editable' | 'readonly'>>;
+export declare function EditableControlProvider(props: React.PropsWithChildren<EditableControlCtxType>): JSX.Element;
+export declare function useEditableControlCtx(): Partial<Pick<FieldControlType, "readonly" | "editable">>;

package/lib/types/editable/editable.d.ts

@@ -0,0 +1,18 @@
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { ProField, ProFieldRenderEditableCtx } from '../index';
+export { isReadonly } from './use-readonly';
+export type EditableCaseProps = {
+    /** 字段配置 */
+    field: FieldConfigType;
+    /** 字段渲染器 */
+    FieldClass: typeof ProField;
+    /** 渲染的上下文 */
+    ctx: Omit<ProFieldRenderEditableCtx, 'onActivate' | 'onDeactivate'>;
+    /** 当前值 */
+    value?: unknown;
+    /** 失焦时是否保持激活状态，默认为false */
+    keepActiveOnBlur?: boolean;
+    /** 是否默认激活 */
+    defaultActive?: boolean;
+};
+export declare function EditableCase(props: EditableCaseProps): JSX.Element;

package/lib/types/editable/index.d.ts

@@ -0,0 +1,14 @@
+import type { UseFieldMapOpts } from '../ctx';
+import { isSimpleCase, SimpleCase } from './simple';
+import { ReadonlyCase, type ReadonlyCaseProps, type UsedBy } from './readonly';
+import { EditableCase, type EditableCaseProps } from './editable';
+export { isReadonly, useReadonly, runDynamicEditable } from './use-readonly';
+export type EditableFieldProps<T extends UsedBy = 'other'> = UseFieldMapOpts & Omit<EditableCaseProps, 'FieldClass'> & Pick<ReadonlyCaseProps<T>, 'usedBy'> & {
+    /** 运行时的可编辑状态(可选),优先级最高 */
+    runtimeEditable?: boolean;
+};
+export declare function EditableField<T extends UsedBy = 'other'>(props: EditableFieldProps<T>): JSX.Element;
+export { SimpleCase, ReadonlyCase, EditableCase, isSimpleCase, };
+export type { ReadonlyCaseProps, EditableCaseProps, UsedBy, };
+export * from './ctx';
+export * from './type';

package/lib/types/editable/readonly.d.ts

@@ -0,0 +1,8 @@
+import type { ProFieldRenderCellCtx, ProFieldRenderCtx } from '../index';
+import type { EditableCaseProps } from './editable';
+export type UsedBy = 'table' | 'other';
+export type ReadonlyCaseProps<T extends UsedBy = 'other'> = Omit<EditableCaseProps, 'ctx'> & {
+    usedBy: T;
+    ctx: T extends 'table' ? ProFieldRenderCellCtx : ProFieldRenderCtx;
+};
+export declare function ReadonlyCase<T extends UsedBy = 'other'>(props: ReadonlyCaseProps<T>): JSX.Element;

package/lib/types/editable/simple.d.ts

@@ -0,0 +1,8 @@
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { EditableCaseProps } from './editable';
+export type SimpleCaseProps = Pick<EditableCaseProps, 'value'>;
+/**
+ * 简单字段且无自定义渲染，使用 SimpleCase
+ */
+export declare function isSimpleCase(field: FieldConfigType): boolean | undefined;
+export declare function SimpleCase(props: SimpleCaseProps): JSX.Element;

package/lib/types/editable/type.d.ts

@@ -0,0 +1,9 @@
+export type DynamicEditableCtxType = {
+    type: 'edit-table';
+    rowIndex: number;
+    rowId: string;
+    columnIndex: number;
+    columnId: string;
+    /** 原始行数据 */
+    rawData: AnyObject;
+};

package/lib/types/editable/use-readonly.d.ts

@@ -0,0 +1,26 @@
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { DynamicEditableCtxType } from './type';
+type ReadonlyCtrlType = Partial<Record<'editable' | 'readonly', boolean>>;
+type ReadonlyCtxType = {
+    component: ReadonlyCtrlType;
+    field: ReadonlyCtrlType;
+    runtimeEditable?: boolean;
+};
+/**
+ * 判断字段是否只读
+ * @param field 字段配置
+ * @param runtimeEditable 运行时的可编辑状态(可选)
+ */
+export declare function useReadonly(field: FieldConfigType, runtimeEditable?: boolean): boolean;
+/**
+ * 判断是否只读的工具函数
+ */
+export declare function isReadonly(ctx: ReadonlyCtxType): boolean;
+/**
+ * 运行动态可编辑函数
+ * - 会在字段内部完成【只读/可编辑/运行时可编辑】的判断后执行
+ * - 仅在上述判断为【可编辑】时，才会调用本函数
+ * - 本函数返回真值时，字段开启编辑，否则改为只读
+ */
+export declare function runDynamicEditable(field: FieldConfigType, readonly: boolean, getCtx: () => DynamicEditableCtxType): boolean;
+export {};