@hi-ui/schema-fields 4.0.0-experimental.7 → 4.0.0-experimental.9

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @hi-ui/schema-fields
 
+## 4.0.0-experimental.9
+
+### Patch Changes
+
+- Updated dependencies [8dc3817cf]
+- Updated dependencies [8f23e9322]
+- Updated dependencies [b27483796]
+- Updated dependencies [900c6c2f0]
+- Updated dependencies
+- Updated dependencies [f8321b72f]
+- Updated dependencies [fe579e212]
+- Updated dependencies [8561492d5]
+  - @hi-ui/date-picker@5.0.0-experimental.1
+  - @hi-ui/cascader@5.0.0-experimental.1
+  - @hi-ui/check-cascader@5.0.0-experimental.1
+  - @hi-ui/check-select@5.0.0-experimental.1
+  - @hi-ui/check-tree-select@5.0.0-experimental.1
+  - @hi-ui/input@5.0.0-experimental.1
+  - @hi-ui/number-input@5.0.0-experimental.1
+  - @hi-ui/select@5.0.0-experimental.1
+  - @hi-ui/textarea@5.0.0-experimental.1
+  - @hi-ui/time-picker@5.0.0-experimental.1
+  - @hi-ui/tree-select@5.0.0-experimental.1
+  - @hi-ui/counter@5.0.0-experimental.1
+  - @hi-ui/schema-option-injector@4.0.0-experimental.5
+  - @hi-ui/schema-types@4.0.0-experimental.2
+  - @hi-ui/schema-core@4.0.0-experimental.7
+
 ## 4.0.0-experimental.7
 
 ### Patch Changes

package/lib/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/bundle.d.ts

@@ -0,0 +1,76 @@
+import React from 'react';
+import type { FieldMapType } from './base';
+import { ProCascader, type ProCascaderProps } from './fields/basic/cascader';
+import { ProCheckCascader, type ProCheckCascaderProps } from './fields/basic/check-cascader';
+import { ProCheckSelect, type ProCheckSelectProps } from './fields/basic/check-select';
+import { ProCheckTreeSelect, type ProCheckTreeSelectProps } from './fields/basic/check-tree-select';
+import { ProCheckbox, type ProCheckboxProps } from './fields/basic/checkbox';
+import { ProCounter, type ProCounterProps } from './fields/basic/counter';
+import { ProDate, type ProDateProps } from './fields/semantic/date';
+import { ProImage, type ProImageProps } from './fields/semantic/image';
+import { ProLink, type ProLinkProps } from './fields/semantic/link';
+import { ProNumber, type ProNumberProps } from './fields/semantic/number';
+import { ProRadio, type ProRadioProps } from './fields/basic/radio';
+import { ProRating, type ProRatingProps } from './fields/basic/rating';
+import { ProSelect, type ProSelectProps } from './fields/basic/select';
+import { ProSlider, type ProSliderProps } from './fields/basic/slider';
+import { ProSwitch, type ProSwitchProps } from './fields/basic/switch';
+import { ProTag, type ProTagProps } from './fields/semantic/tag';
+import { ProText, type ProTextProps } from './fields/semantic/text';
+import { ProTextArea, type ProTextAreaProps } from './fields/basic/textarea';
+import { ProTimePicker, type ProTimePickerProps } from './fields/basic/time-picker';
+import { ProTreeSelect, type ProTreeSelectProps } from './fields/basic/tree-select';
+import { ProUpload, type ProUploadProps } from './fields/basic/upload';
+import { ProNumberRange, type ProNumberRangeProps } from './fields/enhance/number-range';
+export { ProCascader, ProCheckCascader, ProCheckSelect, ProCheckTreeSelect, ProCheckbox, ProCounter, ProDate, ProImage, ProLink, ProNumber, ProRadio, ProRating, ProSelect, ProSlider, ProSwitch, ProTag, ProText, ProTextArea, ProTimePicker, ProTreeSelect, ProUpload, ProNumberRange, };
+export declare const ProFieldMap: {
+    cascader: typeof ProCascader;
+    'check-cascader': typeof ProCheckCascader;
+    'check-select': typeof ProCheckSelect;
+    'check-tree-select': typeof ProCheckTreeSelect;
+    checkbox: typeof ProCheckbox;
+    counter: typeof ProCounter;
+    date: typeof ProDate;
+    image: typeof ProImage;
+    link: typeof ProLink;
+    number: typeof ProNumber;
+    radio: typeof ProRadio;
+    rating: typeof ProRating;
+    select: typeof ProSelect;
+    slider: typeof ProSlider;
+    switch: typeof ProSwitch;
+    tag: typeof ProTag;
+    text: typeof ProText;
+    textarea: typeof ProTextArea;
+    'time-picker': typeof ProTimePicker;
+    'tree-select': typeof ProTreeSelect;
+    upload: typeof ProUpload;
+    'number-range': typeof ProNumberRange;
+};
+export type BuiltinFieldMapType = typeof ProFieldMap;
+export type ProFieldMapType = FieldMapType & BuiltinFieldMapType;
+export type ProFieldsProps = {
+    cascader: ProCascaderProps;
+    'check-cascader': ProCheckCascaderProps;
+    'check-select': ProCheckSelectProps;
+    'check-tree-select': ProCheckTreeSelectProps;
+    checkbox: ProCheckboxProps;
+    counter: ProCounterProps;
+    date: ProDateProps;
+    image: ProImageProps;
+    link: ProLinkProps;
+    number: ProNumberProps;
+    radio: ProRadioProps;
+    rating: ProRatingProps;
+    select: ProSelectProps;
+    slider: ProSliderProps;
+    switch: ProSwitchProps;
+    tag: ProTagProps;
+    text: ProTextProps;
+    textarea: ProTextAreaProps;
+    'time-picker': ProTimePickerProps;
+    'tree-select': ProTreeSelectProps;
+    upload: ProUploadProps;
+    'number-range': ProNumberRangeProps;
+};
+export declare function BuiltinFieldMapProvider(props: React.PropsWithChildren<unknown>): JSX.Element;

package/lib/bundle.js

@@ -0,0 +1,66 @@
+/** @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';
+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';
+import { ProText } 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';
+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, 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/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/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/components/image-preview/index.js

@@ -0,0 +1,49 @@
+/** @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 Preview from '@hi-ui/preview';
+import Space from '@hi-ui/space';
+function ImagePreview(props) {
+  var images = props.images;
+  var _React$useState = React.useState(false),
+    visible = _React$useState[0],
+    setVisible = _React$useState[1];
+  var _React$useState2 = React.useState(0),
+    current = _React$useState2[0],
+    setCurrent = _React$useState2[1];
+  return /*#__PURE__*/React.createElement("div", {
+    className: "image-preview"
+  }, /*#__PURE__*/React.createElement(Preview, {
+    title: current + 1 + "/" + images.length,
+    src: images,
+    current: current,
+    onPreviewChange: setCurrent,
+    visible: visible,
+    onClose: function onClose() {
+      setVisible(false);
+    }
+  }), /*#__PURE__*/React.createElement(Space, null, images.map(function (url, index) {
+    return /*#__PURE__*/React.createElement("div", {
+      key: index,
+      className: "image-preview__item-wrapper"
+    }, /*#__PURE__*/React.createElement("img", {
+      src: url,
+      style: {
+        width: '100%',
+        cursor: 'pointer'
+      },
+      onClick: function onClick() {
+        setCurrent(index);
+        setVisible(true);
+      }
+    }));
+  })));
+}
+export { ImagePreview };

package/lib/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/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/components/upload-bridge/index.js

@@ -0,0 +1,214 @@
+/** @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 _regeneratorRuntime from '@babel/runtime/regenerator';
+import { __rest, __awaiter } from 'tslib';
+import React, { useMemo, useEffect } from 'react';
+import { omit } from 'lodash-es';
+import { useControllableValue } from 'ahooks';
+import { message } from '@hi-ui/message';
+import { useReadonlyRef } from '@hi-ui/schema-hooks';
+import { mergeProps } from '@hi-ui/schema-utils';
+import { toFileList, sliceToMaxCount, genFileIdentifier } from './utils.js';
+var noopOnChange = function noopOnChange() {
+  // noopOnChange
+};
+function normalizeProps(props) {
+  var value = props.value;
+  // value 为字符传时转换为数组；undefined 保持 undefined
+  var nextValue = Array.isArray(value) ? value : typeof value === 'string' ? [value] : undefined;
+  // 存在 request 方法时，默认使用 json 模式
+  var nextMode = props.mode || (props.request ? 'json' : 'formData');
+  // maxCount 大于 1 时，默认使用 multiple 模式
+  var nextMultiple = props.multiple || (props.maxCount || 0) > 1;
+  // 没开启 multiple，也没传 maxCount，则默认限制为 1
+  var nextMaxCount = props.maxCount || (!props.multiple ? 1 : undefined);
+  return Object.assign(Object.assign({}, props), {
+    value: nextValue,
+    mode: nextMode,
+    multiple: nextMultiple,
+    maxCount: nextMaxCount
+  });
+}
+function UploadBridge(props) {
+  var _this = this;
+  var children = props.children,
+    restProps = __rest(props, ["children"]);
+  var normalizedProps = normalizeProps(restProps);
+  var _useControllableValue = useControllableValue(normalizedProps),
+    _useControllableValue2 = _useControllableValue[0],
+    value = _useControllableValue2 === void 0 ? [] : _useControllableValue2,
+    _setValue = _useControllableValue[1];
+  var _useMemo = useMemo(function () {
+      return toFileList(value);
+    }, [value]),
+    fileList = _useMemo.fileList,
+    fileIdSet = _useMemo.fileIdSet;
+  var setValue = function setValue(value) {
+    // 只保留<maxCount>个文件
+    var sliced = sliceToMaxCount(value, normalizedProps.maxCount, 0);
+    var transformed = sliced.map(function (file) {
+      if (typeof file === 'string') return {
+        url: file,
+        fileId: file,
+        name: ''
+      };else return file;
+    });
+    _setValue(transformed);
+  };
+  // 此处的 Set 是给组件卸载的清理阶段有的
+  var fileUrlSetRef = useReadonlyRef(function () {
+    return new Set();
+  });
+  if (normalizedProps.mode === 'formData') {
+    fileList === null || fileList === void 0 ? void 0 : fileList.forEach(function (_ref) {
+      var url = _ref.url;
+      return fileUrlSetRef.current.add(url);
+    });
+  }
+  useEffect(function () {
+    return function () {
+      // 组件卸载时清理所有创建的URL
+      // 此处忽略掉这条规则，因为就是需要最新的 fileUrlSetRef
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+      fileUrlSetRef.current.forEach(function (url) {
+        if (url) {
+          // url 预期是 blob 协议的本地文件地址
+          // 若是外部传入的 http 协议的文件也没事
+          // revokeObjectURL 会直接忽略
+          URL.revokeObjectURL(url);
+        }
+      });
+    };
+  }, [fileUrlSetRef]);
+  var customUpload = function customUpload(fileList) {
+    return __awaiter(_this, void 0, void 0, /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+      var files, uniqueFiles, maxSize, maxSizeInBytes, oversizedFiles, sliced, urls, nextFiles, msg;
+      return _regeneratorRuntime.wrap(function _callee$(_context) {
+        while (1) {
+          switch (_context.prev = _context.next) {
+            case 0:
+              if (fileList) {
+                _context.next = 2;
+                break;
+              }
+              return _context.abrupt("return");
+            case 2:
+              files = Array.from(fileList); // 1. 文件去重
+              // 直接使用已计算的fileList中的fileId
+              uniqueFiles = files.filter(function (file) {
+                return !(fileIdSet === null || fileIdSet === void 0 ? void 0 : fileIdSet.has(genFileIdentifier(file)));
+              });
+              if (!(uniqueFiles.length === 0)) {
+                _context.next = 7;
+                break;
+              }
+              message.open({
+                type: 'warning',
+                title: '所选文件已存在'
+              });
+              return _context.abrupt("return");
+            case 7:
+              // 2. 检查文件大小 (maxSize单位为KB，需要转换为bytes进行比较)
+              maxSize = normalizedProps.maxSize || Infinity;
+              maxSizeInBytes = maxSize * 1024;
+              oversizedFiles = uniqueFiles.filter(function (file) {
+                return file.size > maxSizeInBytes;
+              });
+              if (!(oversizedFiles.length > 0)) {
+                _context.next = 13;
+                break;
+              }
+              message.open({
+                type: 'warning',
+                title: "\u6587\u4EF6\u5927\u5C0F\u8D85\u51FA" + maxSize + "KB\u9650\u5236"
+              });
+              return _context.abrupt("return");
+            case 13:
+              _context.prev = 13;
+              if (!(normalizedProps.mode === 'json')) {
+                _context.next = 27;
+                break;
+              }
+              if (normalizedProps.request) {
+                _context.next = 17;
+                break;
+              }
+              throw new Error('JSON 模式下必须提供 request 方法');
+            case 17:
+              // 只保留<maxCount - curLength>个文件
+              sliced = sliceToMaxCount(uniqueFiles, normalizedProps.maxCount, value.length); // 上传文件并获取URL
+              _context.next = 20;
+              return normalizedProps.request(sliced);
+            case 20:
+              urls = _context.sent;
+              if (!(!urls || urls.length === 0)) {
+                _context.next = 23;
+                break;
+              }
+              return _context.abrupt("return");
+            case 23:
+              nextFiles = urls.map(function (url, index) {
+                var fileId = genFileIdentifier(uniqueFiles[index]);
+                if (typeof url === 'string') return {
+                  url: url,
+                  fileId: fileId,
+                  name: ''
+                };else return Object.assign(Object.assign({}, url), {
+                  fileId: fileId
+                });
+              }); // 更新value
+              setValue([].concat(value || [], nextFiles));
+              _context.next = 28;
+              break;
+            case 27:
+              // formData模式直接返回File数组
+              setValue([].concat(value || [], uniqueFiles));
+            case 28:
+              _context.next = 35;
+              break;
+            case 30:
+              _context.prev = 30;
+              _context.t0 = _context["catch"](13);
+              console.log('UploadBridge customUpload request', _context.t0);
+              msg = '文件上传失败: ' + (_context.t0 instanceof Error ? _context.t0.message : '未知错误');
+              message.open({
+                type: 'error',
+                title: msg
+              });
+            case 35:
+            case "end":
+              return _context.stop();
+          }
+        }
+      }, _callee, null, [[13, 30]]);
+    }));
+  };
+  var handleRemove = function handleRemove(_1, _2, index) {
+    // 获取要删除的文件的URL
+    var fileToRemove = fileList === null || fileList === void 0 ? void 0 : fileList[index];
+    if (fileToRemove === null || fileToRemove === void 0 ? void 0 : fileToRemove.url) URL.revokeObjectURL(fileToRemove.url);
+    setValue(value.filter(function (_, idx) {
+      return idx !== index;
+    }));
+    return true;
+  };
+  var finalProps = mergeProps({
+    type: 'default'
+  }, omit(normalizedProps, [
+  // 移除无关的属性
+  'value', 'defaultValue', 'onChange', 'mode', 'request']));
+  return /*#__PURE__*/React.cloneElement(children, Object.assign(Object.assign({}, finalProps), {
+    customUpload: customUpload,
+    fileList: fileList,
+    onChange: noopOnChange,
+    onRemove: handleRemove
+  }));
+}
+export { UploadBridge };

package/lib/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/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/components/upload-bridge/utils.js

@@ -0,0 +1,66 @@
+/** @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 { extractFileInfo } from '@hi-ui/schema-utils';
+function toFileList(file) {
+  if (!file) return {};
+  var fileIdSet = new Set();
+  var files = Array.isArray(file) ? file : [file];
+  var fileList = files.map(function (file) {
+    var normalizedFile = typeof file === 'string' ? {
+      symbol: file,
+      fileId: file,
+      url: file
+    } : file instanceof File ? {
+      symbol: file.name,
+      name: file.name,
+      fileId: file.name + "-" + file.size + "-" + file.lastModified,
+      url: URL.createObjectURL(file)
+    } : {
+      symbol: file.url,
+      name: file.name,
+      fileId: file.name + "-" + file.url,
+      url: file.url
+    };
+    var info = extractFileInfo(normalizedFile.symbol);
+    // 添加到 fileIdSet
+    fileIdSet.add(normalizedFile.fileId);
+    return {
+      name: normalizedFile.name || info.fullName,
+      fileId: normalizedFile.fileId,
+      fileType: info.ext,
+      uploadState: 'success',
+      url: normalizedFile.url
+    };
+  });
+  return {
+    fileIdSet: fileIdSet,
+    fileList: fileList
+  };
+}
+// 文件唯一标识生成函数
+function genFileIdentifier(file) {
+  if (file instanceof File) {
+    return file.name + "-" + file.size + "-" + file.lastModified;
+  } else if (typeof file === 'string') {
+    return file;
+  } else {
+    return file.name + "-" + file.url;
+  }
+}
+function sliceToMaxCount(value, maxCount, curCount) {
+  if (curCount === void 0) {
+    curCount = 0;
+  }
+  // maxCount 存在时，计算需要保留的文件数量
+  var _maxCount = typeof maxCount === 'number' ? maxCount - curCount : undefined;
+  var sliceStart = Math.max(value.length - (_maxCount || 0), 0);
+  return value.slice(sliceStart);
+}
+export { genFileIdentifier, sliceToMaxCount, toFileList };

package/lib/ctx.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { ProField, EnhancedRenderersType } from './base';
+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 ProField;
+export declare function getFieldRenderFn<TKey extends keyof EnhancedRenderersType>(Class: typeof ProField, renderKey: TKey): ProField[TKey];
+export declare function matchFieldRenderFn<TKey extends keyof EnhancedRenderersType>(opts: MatchFieldClassOpts & {
+    renderKey: TKey;
+}): ProField[TKey];
+export type UseMatchFieldClassOpts = Omit<MatchFieldClassOpts, 'fieldMap'> & {
+    fieldMap?: ProFieldMapType;
+};
+export declare function useMatchFieldClass(opts: UseMatchFieldClassOpts): typeof ProField;

package/lib/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">>;