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

package/lib/types/extensible/selectable/index.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import { ProField } from '../../base';
+import type { ProFieldRenderCtx, ProFieldRenderEditableCtx } from '../../base';
+import type { NormalFieldCtxType } from '../../utils';
+import type { RefillPlaceholderProps } from './type';
+export type * from './type';
+export type ProSelectableFieldProps = {};
+export declare class ProSelectableField extends ProField {
+    suffixEl: JSX.Element;
+    /**
+     * 过滤掉原始参数中的自引用属性
+     * - 防止 immer 在处理数据时出现崩溃
+     * - 主要用在级联及树形选择组件中
+     */
+    hookedSetSelectedRawOption(ctx: NormalFieldCtxType<AnyObject>, args: AnyArray): void;
+    protected getOptionTitle(ctx: ProFieldRenderCtx<AnyType> | ProFieldRenderEditableCtx<AnyType>, dataKey?: string): string | string[] | undefined;
+    getDftPlaceholder(ctx: NormalFieldCtxType<AnyObject>): string | undefined;
+    /**
+     * 渲染字符串类型的已选结果
+     * - 用在单选、单选级联
+     */
+    renderEditableForStringSelected(data: unknown, ctx: ProFieldRenderEditableCtx<AnyType>): JSX.Element | null;
+    /**
+     * 渲染字符串类型的首次回显元素
+     * - 用在单选、单选级联
+     */
+    renderEditableForStringFirstRefill(data: unknown, ctx: ProFieldRenderEditableCtx<AnyType>, extra: {
+        dftRender: ProField['renderEditable'];
+        RefillComponent: (props: RefillPlaceholderProps) => React.ReactElement;
+    }): JSX.Element | null;
+}

package/lib/types/extensible/selectable/match-cascader.d.ts

@@ -0,0 +1,19 @@
+export type MatchedCascaderOptsType = {
+    id: string | number;
+    title: string;
+};
+/**
+ * 在嵌套选项数据中匹配多个路径
+ * @param values 二维数组，包含多个级联路径，例如 [['hubei', 'wuhan'], ['guangdong', 'shenzhen']]
+ * @param options 嵌套选项数据，包含 children 的树形结构
+ * @param extra 配置选项
+ * @returns 二维数组，保持输入的结构，每个路径对应一个匹配的选项链数组
+ *
+ * 边界条件处理：
+ * - 部分匹配：如果路径中某一层找不到，返回已匹配的部分（而不是空数组）
+ * - 缺失title：如果选项的title字段不存在，自动使用id字段作为默认值
+ * - 完全不匹配：如果第一层就找不到，返回空数组
+ */
+export declare function matchCascaderOpts(values: (string | number)[][], options: AnyArray, extra?: {
+    fieldNames?: Record<string, string>;
+}): MatchedCascaderOptsType[][];

package/lib/types/extensible/selectable/type.d.ts

@@ -0,0 +1,16 @@
+import type { ProField, ProFieldRenderEditableCtx } from '../../base';
+import type { ProSelectableField } from './index';
+export type RefillPlaceholderProps = {
+    /** 字段的值 */
+    value: unknown;
+    /** 选项数据 */
+    data: AnyArray;
+    /** 默认渲染函数 */
+    dftRender?: ProField['renderEditable'];
+    /** 字段名映射 */
+    fieldNames?: Record<string, string>;
+    /** 渲染上下文 */
+    ctx: ProFieldRenderEditableCtx<AnyObject>;
+    /** 字段的渲染实例 */
+    instance: ProSelectableField;
+};

package/lib/types/fields/basic/cascader/index.d.ts

@@ -0,0 +1,10 @@
+import { type CascaderProps } from '@hi-ui/cascader';
+import type { WithAsyncOptsDataProps } from '@hi-ui/schema-option-injector';
+import { ProSelectableField, type RefillPlaceholderProps } from '../../../extensible/selectable';
+import type { ProFieldRenderEditableCtx, ProFieldRenderFormItemCtx } from '../../../base';
+export type ProCascaderProps = WithAsyncOptsDataProps<CascaderProps & {}>;
+export declare class ProCascader extends ProSelectableField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCascaderProps>): JSX.Element;
+    renderEditable(data: string, ctx: ProFieldRenderEditableCtx<ProCascaderProps>): JSX.Element;
+}
+export declare function CascaderRefillPlaceholder(props: RefillPlaceholderProps): JSX.Element;

package/lib/types/fields/basic/check-cascader/index.d.ts

@@ -0,0 +1,11 @@
+import type { CheckCascaderProps as HiUICheckCascaderProps } from '@hi-ui/check-cascader';
+import type { WithAsyncOptsDataProps } from '@hi-ui/schema-option-injector';
+import { ProSelectableField } from '../../../extensible/selectable';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+type CheckCascaderProps = Omit<HiUICheckCascaderProps, 'data'> & Pick<Partial<HiUICheckCascaderProps>, 'data'>;
+export type ProCheckCascaderProps = WithAsyncOptsDataProps<CheckCascaderProps & {}>;
+export declare class ProCheckCascader extends ProSelectableField {
+    dftFieldProps: ProCheckCascaderProps;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCheckCascaderProps>): JSX.Element;
+}
+export {};

package/lib/types/fields/basic/check-select/index.d.ts

@@ -0,0 +1,34 @@
+import { type CheckSelectProps } from '@hi-ui/check-select';
+import type { WithAsyncOptsDataProps } from '@hi-ui/schema-option-injector';
+import { ProSelectableField } from '../../../extensible/selectable';
+import { type ProTagProps } from '../../semantic/tag';
+import type { ProFieldRenderCtx, ProFieldRenderEditableCtx, ProFieldRenderFormItemCtx } from '../../../base';
+import type { NormalFieldCtxType } from '../../../utils';
+export type ProCheckSelectProps = WithAsyncOptsDataProps<CheckSelectProps & {
+    /**
+     * 是否显示边框
+     * - 只读模式渲染为标签
+     */
+    bordered?: ProTagProps['bordered'];
+    /**
+     * 标签颜色预设
+     * - 只读模式渲染为标签
+     */
+    colorPreset?: ProTagProps['colorPreset'];
+    /**
+     * 标签属性
+     * - 只读模式渲染为标签
+     */
+    tagProps?: ProTagProps;
+}>;
+export declare class ProCheckSelect extends ProSelectableField {
+    private tagRef;
+    render(data: string[], ctx: ProFieldRenderCtx<ProCheckSelectProps>): JSX.Element;
+    getSelfFieldProps(ctx: NormalFieldCtxType<ProCheckSelectProps>): {
+        fieldProps: ProCheckSelectProps;
+        tagProps: ProTagProps;
+    };
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCheckSelectProps>): JSX.Element;
+    getDftPlaceholder(ctx: NormalFieldCtxType<ProCheckSelectProps>): string | undefined;
+    renderEditable(data: string[], ctx: ProFieldRenderEditableCtx<ProCheckSelectProps>): JSX.Element;
+}

package/lib/types/fields/basic/check-tree-select/index.d.ts

@@ -0,0 +1,10 @@
+import { type CheckTreeSelectProps } from '@hi-ui/check-tree-select';
+import type { WithAsyncOptsDataProps } from '@hi-ui/schema-option-injector';
+import { ProSelectableField } from '../../../extensible/selectable';
+import type { ProFieldRenderCtx, ProFieldRenderEditableCtx, ProFieldRenderFormItemCtx } from '../../../base';
+export type ProCheckTreeSelectProps = WithAsyncOptsDataProps<CheckTreeSelectProps & {}>;
+export declare class ProCheckTreeSelect extends ProSelectableField {
+    render(data: string[], ctx: ProFieldRenderCtx<ProCheckTreeSelectProps>): JSX.Element;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCheckTreeSelectProps>): JSX.Element;
+    renderEditable(data: string[], ctx: ProFieldRenderEditableCtx<ProCheckTreeSelectProps>): JSX.Element;
+}

package/lib/types/fields/basic/checkbox/index.d.ts

@@ -0,0 +1,19 @@
+import { type CheckboxGroupProps } from '@hi-ui/checkbox';
+import { type BasicGridOptsType } from '@hi-ui/schema-auto-grid';
+import { type BoolConfig } from '@hi-ui/schema-utils';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProCheckboxProps = CheckboxGroupProps & {
+    /** 网格配置 */
+    grid?: BoolConfig<BasicGridOptsType>;
+};
+export declare class ProCheckbox extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCheckboxProps>): JSX.Element;
+    renderNormalFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCheckboxProps>, extra: {
+        fieldProps: Omit<ProCheckboxProps, 'grid'>;
+    }): JSX.Element;
+    renderGridFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCheckboxProps>, extra: {
+        fieldProps: Omit<ProCheckboxProps, 'grid'>;
+        gridProps: ProCheckboxProps['grid'];
+    }): JSX.Element;
+}

package/lib/types/fields/basic/counter/index.d.ts

@@ -0,0 +1,7 @@
+import { type CounterProps } from '@hi-ui/counter';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProCounterProps = CounterProps & {};
+export declare class ProCounter extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProCounterProps>): JSX.Element;
+}

package/lib/types/fields/basic/radio/index.d.ts

@@ -0,0 +1,7 @@
+import { type RadioGroupProps } from '@hi-ui/radio';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProRadioProps = RadioGroupProps & {};
+export declare class ProRadio extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProRadioProps>): JSX.Element;
+}

package/lib/types/fields/basic/rating/index.d.ts

@@ -0,0 +1,7 @@
+import { type RatingProps } from '@hi-ui/rating';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProRatingProps = RatingProps & {};
+export declare class ProRating extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProRatingProps>): JSX.Element;
+}

package/lib/types/fields/basic/select/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import { type SelectProps } from '@hi-ui/select';
+import type { WithAsyncOptsDataProps } from '@hi-ui/schema-option-injector';
+import { ProSelectableField, type RefillPlaceholderProps } from '../../../extensible/selectable';
+import type { ProFieldRenderCtx, ProFieldRenderEditableCtx, ProFieldRenderFormItemCtx } from '../../../base';
+export type ProSelectProps = WithAsyncOptsDataProps<SelectProps & {}>;
+export declare class ProSelect extends ProSelectableField {
+    render(data: unknown, ctx: ProFieldRenderCtx<ProSelectProps>): React.ReactElement;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProSelectProps>): JSX.Element;
+    renderEditable(data: string, ctx: ProFieldRenderEditableCtx<ProSelectProps>): JSX.Element;
+}
+export declare function SelectRefillPlaceholder(props: RefillPlaceholderProps): JSX.Element;

package/lib/types/fields/basic/slider/index.d.ts

@@ -0,0 +1,7 @@
+import { type SliderProps } from '@hi-ui/slider';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProSliderProps = SliderProps & {};
+export declare class ProSlider extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProSliderProps>): JSX.Element;
+}

package/lib/types/fields/basic/switch/index.d.ts

@@ -0,0 +1,7 @@
+import { type SwitchProps } from '@hi-ui/switch';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProSwitchProps = SwitchProps & {};
+export declare class ProSwitch extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProSwitchProps>): JSX.Element;
+}

package/lib/types/fields/basic/textarea/index.d.ts

@@ -0,0 +1,7 @@
+import { type TextAreaProps } from '@hi-ui/textarea';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProTextAreaProps = TextAreaProps & {};
+export declare class ProTextArea extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProTextAreaProps>): JSX.Element;
+}

package/lib/types/fields/basic/time-picker/index.d.ts

@@ -0,0 +1,8 @@
+import { type TimePickerProps } from '@hi-ui/time-picker';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+import './index.scss';
+export type ProTimePickerProps = TimePickerProps & {};
+export declare class ProTimePicker extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProTimePickerProps>): JSX.Element;
+}

package/lib/types/fields/basic/tree-select/index.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import { type TreeSelectProps } from '@hi-ui/tree-select';
+import type { WithAsyncOptsDataProps } from '@hi-ui/schema-option-injector';
+import { ProSelectableField } from '../../../extensible/selectable';
+import type { ProFieldRenderCtx, ProFieldRenderEditableCtx, ProFieldRenderFormItemCtx } from '../../../base';
+export type ProTreeSelectProps = WithAsyncOptsDataProps<TreeSelectProps & {}>;
+export declare class ProTreeSelect extends ProSelectableField {
+    render(data: unknown, ctx: ProFieldRenderCtx<ProTreeSelectProps>): React.ReactElement;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProTreeSelectProps>): JSX.Element;
+    renderEditable(data: string, ctx: ProFieldRenderEditableCtx<ProTreeSelectProps>): JSX.Element;
+}

package/lib/types/fields/basic/upload/custom.d.ts

@@ -0,0 +1,3 @@
+import { type UploadBridgeProps } from '../../../components/upload-bridge';
+export type CommonUploadProps = UploadBridgeProps;
+export declare function CommonUpload(props: CommonUploadProps): JSX.Element;

package/lib/types/fields/basic/upload/index.d.ts

@@ -0,0 +1,8 @@
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+import { CommonUpload, type CommonUploadProps } from './custom';
+export { CommonUpload, CommonUploadProps };
+export type ProUploadProps = CommonUploadProps & {};
+export declare class ProUpload extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProUploadProps>): JSX.Element;
+}

package/lib/types/fields/enhance/number-range/index.d.ts

@@ -0,0 +1,7 @@
+import type { NumberRangeProps } from '@hi-ui/number-range';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx } from '../../../base';
+export type ProNumberRangeProps = NumberRangeProps & {};
+export declare class ProNumberRange extends ProField {
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProNumberRangeProps>): JSX.Element;
+}

package/lib/types/fields/semantic/date/index.d.ts

@@ -0,0 +1,15 @@
+import { Dayjs } from 'dayjs';
+import { type DatePickerProps } from '@hi-ui/date-picker';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx, ProFieldRenderCtx, ProFieldRenderEditableCtx } from '../../../base';
+export type ProDateProps = Omit<DatePickerProps, 'format'> & {
+    format?: string | ((date: Dayjs) => string);
+};
+export declare class ProDate extends ProField {
+    dftFieldProps: ProDateProps;
+    render(data: string, ctx: ProFieldRenderCtx<ProDateProps>): JSX.Element;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProDateProps>): JSX.Element;
+    protected getFormattedText(date: Dayjs, fieldProps: ProDateProps): string;
+    protected getEditablePlaceholder(data: string | number | Date, ctx: ProFieldRenderEditableCtx<ProDateProps>): string;
+    renderEditable(data: string, ctx: ProFieldRenderEditableCtx<ProDateProps>): JSX.Element;
+}

package/lib/types/fields/semantic/image/index.d.ts

@@ -0,0 +1,11 @@
+import { ProField } from '../../../base';
+import type { ProFieldRenderCtx, ProFieldRenderFormItemCtx } from '../../../base';
+import { ImageUpload, type ImageUploadProps } from './upload';
+export type ProImageProps = UnknownObject & {
+    customImages?: (data: string[], ctx: ProFieldRenderCtx<ProImageProps>) => string[];
+};
+export { ImageUpload, ImageUploadProps };
+export declare class ProImage extends ProField {
+    render(data: unknown, ctx: ProFieldRenderCtx<ProImageProps>): JSX.Element;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ImageUploadProps>): JSX.Element;
+}

package/lib/types/fields/semantic/image/upload.d.ts

@@ -0,0 +1,3 @@
+import { type UploadBridgeProps } from '../../../components/upload-bridge';
+export type ImageUploadProps = Omit<UploadBridgeProps, 'type'>;
+export declare function ImageUpload(props: ImageUploadProps): JSX.Element;

package/lib/types/fields/semantic/link/index.d.ts

@@ -0,0 +1,31 @@
+import { ProField } from '../../../base';
+import type { ProFieldRenderCtx } from '../../../base';
+export type ProLinkProps = UnknownObject & {
+    /** 是否使用href跳转，默认使用Link组件跳转 */
+    isHref?: boolean;
+    /**
+     * 链接字段，优先级低于 customLink
+     * @desc 支持路径字符串，例如 user.avatar
+     */
+    linkField?: string;
+    /** 自定义链接地址，优先级高于 linkField */
+    customLink?: (data: string, ctx: CustomLinkCtx) => string;
+    /** 额外传递给Link组件的state，模型会自动将rowData注入 */
+    extraLinkState?: AnyObject;
+};
+export type CustomLinkCtx = ProFieldRenderCtx<ProLinkProps>;
+export declare class ProLink extends ProField {
+    renderCtx: ProFieldRenderCtx<ProLinkProps>;
+    fieldProps: ProLinkProps;
+    render(data: string, ctx: ProFieldRenderCtx<ProLinkProps>): JSX.Element;
+    /**
+     * renderHref
+     * @desc 是指固定的链接地址，直接跳转出系统 */
+    renderHref(href: string): JSX.Element;
+    /**
+     * renderLink
+     * @desc 是指链接地址是动态的，需要根据数据进行拼接
+     * @desc 通常用于链接到系统其他页面 */
+    renderLink(data: unknown): JSX.Element;
+    getGoTo(data: unknown): any;
+}

package/lib/types/fields/semantic/number/index.d.ts

@@ -0,0 +1,21 @@
+import { type NumberInputProps } from '@hi-ui/number-input';
+import { ProField } from '../../../base';
+import type { ProFieldRenderCtx, ProFieldRenderEditableCtx, ProFieldRenderFormItemCtx } from '../../../base';
+import type { NormalFieldCtxType } from '../../../utils';
+export type ProNumberProps = NumberInputProps & {
+    /**
+     * 指定数字变化的精度
+     * @desc 可编辑模式时，指定数字变化的精度
+     * @desc 内部使用 HiUI 的 formatter 方法实现四舍五入精度处理
+     * @desc 如需更复杂的格式化逻辑精度处理，请结合 NumberUtil 自行实现 formatter 方法
+     */
+    precision?: number;
+};
+export declare class ProNumber extends ProField {
+    protected _getFieldProps(ctx: NormalFieldCtxType<ProNumberProps>): ProNumberProps;
+    render(data: unknown, ctx: ProFieldRenderCtx<ProNumberProps>): JSX.Element;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProNumberProps>): JSX.Element;
+    protected getEditablePlaceholder(data: unknown): number | null;
+    renderEditable(data: unknown, ctx: ProFieldRenderEditableCtx<ProNumberProps>): JSX.Element;
+    toFormatted(data: number, ctx: NormalFieldCtxType<ProNumberProps>): string;
+}

package/lib/types/fields/semantic/tag/index.d.ts

@@ -0,0 +1,78 @@
+import React from 'react';
+import { type TagProps } from '@hi-ui/tag';
+import { ProField, type ProFieldRenderCtx } from '../../../base';
+import './index.scss';
+type ColorPreset = {
+    back: TagProps['background'];
+    fore: TagProps['color'];
+};
+export declare const colorPreset: {
+    blue: {
+        back: string;
+        fore: string;
+    };
+    yellow: {
+        back: string;
+        fore: string;
+    };
+    green: {
+        back: string;
+        fore: string;
+    };
+    red: {
+        back: string;
+        fore: string;
+    };
+    orange: {
+        back: string;
+        fore: string;
+    };
+    purple: {
+        back: string;
+        fore: string;
+    };
+    /** 蓝绿色 */ cyan: {
+        back: string;
+        fore: string;
+    };
+    /** 天蓝色 */ skyblue: {
+        back: string;
+        fore: string;
+    };
+    /** 深紫色 */ darkPurple: {
+        back: string;
+        fore: string;
+    };
+    /** 蓝灰色 */ blueGray: {
+        back: string;
+        fore: string;
+    };
+    /** 中灰色 */ midGray: {
+        back: string;
+        fore: string;
+    };
+};
+type BuiltinColorEnum = Required<TagProps>['type'];
+type SCMColorEnumPreset = keyof typeof colorPreset;
+export declare const ColorEnumPreset: SCMColorEnumPreset[];
+export type ProTagProps = TagProps & {
+    /** 是否显示边框 */
+    bordered?: boolean;
+    colorPreset: Record<string, LiteralUnion<BuiltinColorEnum | SCMColorEnumPreset> | ColorPreset>;
+    /** 文本映射
+     * - 例如：字段值为0/1，想要显示为 否/是
+     * - 可以配置为：textMap: { 0: '否', 1: '是' } 或 textMap: new Map([[0, '否'], [1, '是']])
+     * - Map 中 key 的类型可以是任意类型
+     * - Map 中 value 的类型需要是有效的 React 子元素类型，例如：string、number、React.ReactNode 等
+     */
+    textMap?: Record<string, string | number | React.ReactNode> | Map<unknown, string | number | React.ReactNode>;
+};
+export declare class ProTag extends ProField {
+    render(data: string | string[], ctx: ProFieldRenderCtx<ProTagProps>): JSX.Element;
+    renderTag(dataArray: string[], ctx: ProFieldRenderCtx<ProTagProps>): JSX.Element;
+    getTagProps(props: ProTagProps): Omit<ProTagProps, "bordered" | "colorPreset">;
+    getType(preset: ValueOf<ProTagProps['colorPreset']>): "default" | "yellow" | "purple" | "skyblue" | "primary" | "success" | "warning" | "danger" | "ultramarine" | "rosered" | undefined;
+    getColor(preset: ValueOf<ProTagProps['colorPreset']>): ColorPreset | undefined;
+    getText(data: string, textMap: ProTagProps['textMap']): {};
+}
+export {};

package/lib/types/fields/semantic/text/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { type InputProps } from '@hi-ui/input';
+import { ProField } from '../../../base';
+import type { ProFieldRenderFormItemCtx, ProFieldProps, ProFieldRenderCtx } from '../../../base';
+export declare const DumbInput: (props: InputProps & React.RefAttributes<HTMLInputElement | null>) => React.ReactElement;
+export type ProTextProps = ProFieldProps & InputProps & {
+    /** 使用 HiUI 原始 Input 组件 */
+    useRawInput?: boolean;
+};
+export declare class ProText extends ProField {
+    render(data: string, ctx: ProFieldRenderCtx<ProTextProps>): JSX.Element;
+    renderFormItem(_: null, ctx: ProFieldRenderFormItemCtx<ProTextProps>): JSX.Element;
+}

package/lib/types/index.d.ts

@@ -0,0 +1,108 @@
+/// <reference types="@hi-ui/utility-types/global" />
+
+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, type ProCascaderProps } from './fields/basic/cascader';
+export { ProCheckCascader, type ProCheckCascaderProps } from './fields/basic/check-cascader';
+export { ProCheckSelect, type ProCheckSelectProps } from './fields/basic/check-select';
+export { ProCheckTreeSelect, type ProCheckTreeSelectProps } from './fields/basic/check-tree-select';
+export { ProCheckbox, type ProCheckboxProps } from './fields/basic/checkbox';
+export { ProCounter, type ProCounterProps } from './fields/basic/counter';
+export { ProDate, type ProDateProps } from './fields/semantic/date';
+export { ProImage, type ProImageProps, type ImageUploadProps } from './fields/semantic/image';
+export { ProLink, type ProLinkProps } from './fields/semantic/link';
+export { ProNumber, type ProNumberProps } from './fields/semantic/number';
+export { ProRadio, type ProRadioProps } from './fields/basic/radio';
+export { ProRating, type ProRatingProps } from './fields/basic/rating';
+export { ProSelect, type ProSelectProps } from './fields/basic/select';
+export { ProSlider, type ProSliderProps } from './fields/basic/slider';
+export { ProSwitch, type ProSwitchProps } from './fields/basic/switch';
+export { ProTag, type ProTagProps } from './fields/semantic/tag';
+export { ProText, type ProTextProps } from './fields/semantic/text';
+export { ProTextArea, type ProTextAreaProps } from './fields/basic/textarea';
+export { ProTimePicker, type ProTimePickerProps } from './fields/basic/time-picker';
+export { ProTreeSelect, type ProTreeSelectProps } from './fields/basic/tree-select';
+export { ProUpload, type ProUploadProps } from './fields/basic/upload';
+export { ProNumberRange, type ProNumberRangeProps } from './fields/enhance/number-range';
+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;
+export * from './base';
+export * from './components/span';
+export * from './ctx';
+export * from './utils';
+export * from './components/image-preview';
+export * from './components/upload-bridge';
+export { DumbInput } from './fields/semantic/text';
+export { colorPreset, ColorEnumPreset } from './fields/semantic/tag';
+export * from './editable';

package/lib/types/utils/batch-dep-update.d.ts

@@ -0,0 +1,13 @@
+type BatchUpdatePayloadType<TData extends AnyObject> = {
+    _IS_BATCH_UPDATE_: true;
+    values: Partial<TData>;
+};
+export declare class BatchDepUpdate {
+    static update<TData extends AnyObject>(values: Partial<TData>): {
+        _IS_BATCH_UPDATE_: true;
+        values: Partial<TData>;
+    };
+    static isBatch<TData extends AnyObject>(value: unknown): value is BatchUpdatePayloadType<TData>;
+    static getValues<TData extends AnyObject>(key: FieldPath, value: unknown): Partial<TData>;
+}
+export {};

package/lib/types/utils/form-binding.d.ts

@@ -0,0 +1,11 @@
+import type { FormBindingProps } from '@hi-ui/schema-core';
+type AnyFormBindingProps = Partial<Omit<FormBindingProps, 'onChange'> & {
+    onChange: (...args: AnyType[]) => void;
+}>;
+export declare function wrapFormBinding<T extends Partial<AnyFormBindingProps>>(formBinding: FormBindingProps, fieldProps: T): {
+    value: AnyType;
+    onChange: (...args: AnyType[]) => void;
+    onBlur: (...args: AnyType[]) => void;
+    invalid?: boolean | string;
+};
+export {};

package/lib/types/utils/label.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { FieldConfigType, EnhancedFormRefType, ListItemActionCtxType } from '@hi-ui/schema-core';
+export type FormItemLabelCtxType = {
+    formRef: EnhancedFormRefType;
+};
+export type FormListItemLabelCtxType = FormItemLabelCtxType & ListItemActionCtxType;
+export type OtherCustomLabelCtxType = {};
+export type CustomLabelUsedBy = 'FormItem' | 'FormListItem' | 'Other' | undefined;
+export type GetLabelCtxType<T extends CustomLabelUsedBy = CustomLabelUsedBy> = T extends 'FormItem' ? FormItemLabelCtxType : T extends 'FormListItem' ? FormListItemLabelCtxType : T extends 'Other' ? OtherCustomLabelCtxType : undefined;
+export type CustomLabelFn<T extends CustomLabelUsedBy = CustomLabelUsedBy> = (ctx: GetLabelCtxType<T>) => React.ReactNode;
+export declare function getLabel<T extends CustomLabelUsedBy = CustomLabelUsedBy>(field: FieldConfigType, ctx?: GetLabelCtxType<T>): any;

package/lib/types/utils.d.ts

@@ -0,0 +1,15 @@
+import { wrapFormBinding } from './utils/form-binding';
+import type { FormItemProps } from '@hi-ui/schema-core';
+import type { ProFieldRenderCtx, ProFieldRenderFormItemCtx } from './base';
+export { wrapFormBinding };
+export * from './utils/label';
+export * from './utils/batch-dep-update';
+/**
+ * 普适的字段上下文类型，用于获取字段属性
+ * @desc 包含字段本身的属性，以及可选的表单绑定属性
+ */
+export type NormalFieldCtxType<FieldProps extends AnyObject> = Pick<ProFieldRenderCtx<FieldProps>, 'field'> & Partial<Pick<ProFieldRenderFormItemCtx<FieldProps>, 'formBinding'>>;
+export declare function getFieldProps<FieldProps extends AnyObject>(dftProps: FieldProps, ctx: NormalFieldCtxType<FieldProps>): FieldProps;
+export declare function getWrapperProps<WrapperProps extends AnyObject>(dftProps: WrapperProps, ctx: Pick<ProFieldRenderCtx<AnyObject, WrapperProps>, 'field'>): WrapperProps;
+export type GetFormItemPropsCtxType = Pick<ProFieldRenderCtx, 'field'>;
+export declare function getFormItemProps(dftProps: FormItemProps, ctx: GetFormItemPropsCtxType): FormItemProps;