react-native-x-components 0.1.0

package/dist/XFormPro/components/FieldTrigger.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Pressable, StyleSheet, Text } from 'react-native';
+import { useXTheme } from '../../theme';
+import { useXLocale } from '../../XLocale';
+import AntDesign from '@react-native-vector-icons/ant-design';
+export function FieldTrigger({ text, placeholder, onPress, disabled }) {
+    const t = useXTheme();
+    const { t: i18n } = useXLocale();
+    const resolvedPlaceholder = placeholder ?? i18n('pleaseSelect');
+    return (_jsxs(Pressable, { style: ({ pressed }) => [
+            styles.trigger,
+            { borderColor: t.colorBorder, backgroundColor: disabled ? t.colorBgContainerDisabled : t.colorBgLayout },
+            pressed && styles.pressed,
+            disabled && styles.disabled,
+        ], onPress: onPress, disabled: disabled, children: [_jsx(Text, { style: [styles.text, { color: text ? t.colorText : t.colorTextQuaternary }, !text && styles.placeholder], allowFontScaling: false, children: text || resolvedPlaceholder }), _jsx(AntDesign, { name: 'right', size: 16, color: t.colorTextTertiary })] }));
+}
+const styles = StyleSheet.create({
+    trigger: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        borderWidth: StyleSheet.hairlineWidth,
+        borderRadius: 8,
+        paddingHorizontal: 12,
+        paddingVertical: 10,
+        minHeight: 40,
+    },
+    pressed: {
+        opacity: 0.75,
+    },
+    disabled: {},
+    text: {
+        flex: 1,
+        fontSize: 15,
+        marginRight: 8,
+    },
+    placeholder: {},
+});

package/dist/XFormPro/components/XDateField.d.ts

@@ -0,0 +1,22 @@
+/**
+ * XDateField —— XFormPro 的 datePicker 类型控件：触发区 + XPickerDate 弹层。
+ *
+ * 日期/日期时间/时间统一走 format：
+ * - 'YYYY-MM-DD'            日期
+ * - 'YYYY-MM-DD HH:mm'      日期时间
+ * - 'HH:mm:ss' / 'HH:mm'    时间（原 timePicker 类型）
+ */
+import React from 'react';
+export interface XDateFieldProps {
+    value?: string;
+    onChange?: (value: string) => void;
+    /** 列配置（见 XPickerDate），如 'YYYY-MM-DD'、'HH:mm' */
+    format?: string;
+    placeholder?: string;
+    title?: string;
+    minYear?: number;
+    maxYear?: number;
+    disabled?: boolean;
+}
+export declare function XDateField({ value, onChange, format, placeholder, title, minYear, maxYear, disabled }: XDateFieldProps): React.JSX.Element;
+export default XDateField;

package/dist/XFormPro/components/XDateField.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * XDateField —— XFormPro 的 datePicker 类型控件：触发区 + XPickerDate 弹层。
+ *
+ * 日期/日期时间/时间统一走 format：
+ * - 'YYYY-MM-DD'            日期
+ * - 'YYYY-MM-DD HH:mm'      日期时间
+ * - 'HH:mm:ss' / 'HH:mm'    时间（原 timePicker 类型）
+ */
+import { useState } from 'react';
+import { XPickerDate } from '../../XPickerDate';
+import { FieldTrigger } from './FieldTrigger';
+import { useXLocale } from '../../XLocale';
+export function XDateField({ value, onChange, format, placeholder, title, minYear, maxYear, disabled }) {
+    const { t } = useXLocale();
+    const [visible, setVisible] = useState(false);
+    return (_jsxs(_Fragment, { children: [_jsx(FieldTrigger, { text: value, placeholder: placeholder ?? t('selectDate'), disabled: disabled, onPress: () => setVisible(true) }), _jsx(XPickerDate, { visible: visible, onClose: () => setVisible(false), value: value, title: title ?? t('selectDate'), format: format, minYear: minYear, maxYear: maxYear, onChange: v => {
+                    onChange?.(v);
+                    setVisible(false);
+                } })] }));
+}
+export default XDateField;

package/dist/XFormPro/components/XSelectField.d.ts

@@ -0,0 +1,16 @@
+/**
+ * XSelectField —— XFormPro 的 select 类型控件：触发区 + XPicker 弹层。
+ * Form.Item 注入 value/onChange 后即可作为表单控件使用。
+ */
+import React from 'react';
+import { XPickerOption } from '../../XPicker';
+export interface XSelectFieldProps {
+    value?: any;
+    onChange?: (value: any) => void;
+    options: XPickerOption[];
+    placeholder?: string;
+    title?: string;
+    disabled?: boolean;
+}
+export declare function XSelectField({ value, onChange, options, placeholder, title, disabled }: XSelectFieldProps): React.JSX.Element;
+export default XSelectField;

package/dist/XFormPro/components/XSelectField.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * XSelectField —— XFormPro 的 select 类型控件：触发区 + XPicker 弹层。
+ * Form.Item 注入 value/onChange 后即可作为表单控件使用。
+ */
+import { useState } from 'react';
+import { XPicker } from '../../XPicker';
+import { FieldTrigger } from './FieldTrigger';
+import { useXLocale } from '../../XLocale';
+export function XSelectField({ value, onChange, options, placeholder, title, disabled }) {
+    const { t } = useXLocale();
+    const [visible, setVisible] = useState(false);
+    const option = options.find(o => o.value === value);
+    return (_jsxs(_Fragment, { children: [_jsx(FieldTrigger, { text: option?.label, placeholder: placeholder ?? t('pleaseSelectLabel', { n: title ?? '' }), disabled: disabled, onPress: () => setVisible(true) }), _jsx(XPicker, { visible: visible, onClose: () => setVisible(false), options: options, value: value, title: title ?? t('pleaseSelect'), onChange: v => {
+                    onChange?.(v);
+                    setVisible(false);
+                } })] }));
+}
+export default XSelectField;

package/dist/XFormPro/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ============================================================================
+ * XFormPro —— 低代码表单（老 FormPro 的 X 系列重制版，基于 XForm 实现）
+ * ============================================================================
+ *
+ * 对外 API 与老 FormPro 同名同义（value/onUpdateValue/formItemOptions/
+ * ref.validate + restoreValidation），老页面迁移只改 import 和组件名。
+ *
+ * 与老 FormPro 的差异：
+ * 1. 内部用 XForm（自研）替代 @ant-design/react-native 的 Form；
+ * 2. 控件全部换 X 系列（详见 types.ts 的 XFm 映射说明）；
+ * 3. 新增 hiddenValues：编辑场景把 id 等字段带进表单 —— 不渲染表单项，
+ *    但值进 store，validate/onUpdateValue 的结果里都带，且不受 resetFields 影响。
+ *
+ * 使用方式：
+ * ```tsx
+ * const [formValue, setFormValue] = useState({name: '', sex: undefined});
+ * const formRef = useRef<XFormProInst>(null);
+ *
+ * const options: XFormItemOptions<typeof formValue> = {
+ *   name: {required: true, type: 'input', label: '姓名'},
+ *   sex: {required: true, type: 'radioGroup', label: '性别',
+ *         options: [{label: '男', value: 1}, {label: '女', value: 0}]},
+ * };
+ *
+ * <XFormPro ref={formRef} value={formValue} onUpdateValue={setFormValue}
+ *   formItemOptions={options} hiddenValues={{id: 'xxx'}} />
+ *
+ * const values = await formRef.current.validate(); // 含 hiddenValues
+ * ```
+ */
+import React from 'react';
+import type { XFormProInst, XFormProProps } from './types';
+export type { XFormModelValue, XOptionItem, XFormProRule, XBaseFormItemProps, XFormProItemProps, XFormItemOptions, XFormProProps, XFormProInst, XFm } from './types';
+export { registerXFormProRenderer } from './renderers';
+export type { XFormProCustomRenderer } from './renderers';
+/**
+ * forwardRef + 泛型断言：让 <XFormPro<FieldType>> 正确推导 props 和 ref 类型
+ * （与老 FormPro 相同的手法）。
+ */
+declare const XFormPro: <ModelValue extends Record<string, any>>(props: XFormProProps<ModelValue> & {
+    ref?: React.Ref<XFormProInst<ModelValue>>;
+}) => React.ReactElement;
+export default XFormPro;

package/dist/XFormPro/index.js

@@ -0,0 +1,111 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XFormPro —— 低代码表单（老 FormPro 的 X 系列重制版，基于 XForm 实现）
+ * ============================================================================
+ *
+ * 对外 API 与老 FormPro 同名同义（value/onUpdateValue/formItemOptions/
+ * ref.validate + restoreValidation），老页面迁移只改 import 和组件名。
+ *
+ * 与老 FormPro 的差异：
+ * 1. 内部用 XForm（自研）替代 @ant-design/react-native 的 Form；
+ * 2. 控件全部换 X 系列（详见 types.ts 的 XFm 映射说明）；
+ * 3. 新增 hiddenValues：编辑场景把 id 等字段带进表单 —— 不渲染表单项，
+ *    但值进 store，validate/onUpdateValue 的结果里都带，且不受 resetFields 影响。
+ *
+ * 使用方式：
+ * ```tsx
+ * const [formValue, setFormValue] = useState({name: '', sex: undefined});
+ * const formRef = useRef<XFormProInst>(null);
+ *
+ * const options: XFormItemOptions<typeof formValue> = {
+ *   name: {required: true, type: 'input', label: '姓名'},
+ *   sex: {required: true, type: 'radioGroup', label: '性别',
+ *         options: [{label: '男', value: 1}, {label: '女', value: 0}]},
+ * };
+ *
+ * <XFormPro ref={formRef} value={formValue} onUpdateValue={setFormValue}
+ *   formItemOptions={options} hiddenValues={{id: 'xxx'}} />
+ *
+ * const values = await formRef.current.validate(); // 含 hiddenValues
+ * ```
+ */
+import { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useRef } from 'react';
+import XForm from '../XForm';
+import { deepClone } from '../XForm/utils';
+import { renderXFormField } from './renderers';
+import { useXLocale } from '../XLocale';
+export { registerXFormProRenderer } from './renderers';
+/**
+ * 通用非空校验（老 FormPro 的 universalValidator 同款）：
+ * null/undefined/纯空格串/空数组 视为空
+ */
+function isValueEmpty(value) {
+    return (value === null ||
+        value === undefined ||
+        (typeof value === 'string' && value.trim() === '') ||
+        (Array.isArray(value) && value.length === 0));
+}
+function XFormProInner(props, ref) {
+    const { value, onUpdateValue, labelWidth, layout = 'vertical', formItemOptions, hiddenValues } = props;
+    const { t } = useXLocale();
+    const [form] = XForm.useForm();
+    /** 用户输入产生的值变化（外部 value 同步不回声） */
+    const isInternalChange = useRef(false);
+    // --- 构建表单元数据：补必填规则（老 FormPro 同款逻辑） ---
+    const formMeta = useMemo(() => {
+        if (!formItemOptions)
+            return {};
+        const cloned = deepClone(formItemOptions);
+        for (const [key, raw] of Object.entries(cloned)) {
+            const entry = raw;
+            entry.path = key;
+            if (entry.required && !entry.rules && !entry.rule) {
+                entry.rules = [{ required: true, message: `${entry.label ?? key}${t('cannotBeEmpty')}` }];
+            }
+        }
+        return cloned;
+    }, [formItemOptions]);
+    // --- 用户输入：上报父级（含 hiddenValues，因为它们在 store 里） ---
+    const handleValuesChange = useCallback((_changed, allValues) => {
+        isInternalChange.current = true;
+        onUpdateValue?.(deepClone(allValues));
+    }, [onUpdateValue]);
+    // --- 外部 value 变化 -> 回显（编辑回填/重置场景） ---
+    useEffect(() => {
+        if (isInternalChange.current) {
+            isInternalChange.current = false;
+            return;
+        }
+        form.setFieldsValue(value);
+    }, [value, form]);
+    // --- hiddenValues：进 store 不渲染（编辑场景的 id 等字段原样带回） ---
+    useEffect(() => {
+        if (hiddenValues) {
+            form.setFieldsValue(hiddenValues);
+        }
+    }, [hiddenValues, form]);
+    // --- 实例方法（老 FormPro 同名同义） ---
+    useImperativeHandle(ref, () => ({
+        validate: () => form.validateFields(),
+        restoreValidation: () => {
+            const names = Object.keys(formMeta);
+            form.setFields(names.map(name => ({ name, errors: [] })));
+        },
+    }), [form, formMeta]);
+    return (_jsx(XForm, { form: form, initialValues: value, onValuesChange: handleValuesChange, layout: layout, labelWidth: labelWidth, children: Object.entries(formMeta).map(([field, raw]) => {
+            const entry = raw;
+            if (entry.hide)
+                return null;
+            const rules = entry.rules ?? (entry.rule ? [entry.rule] : undefined);
+            return (_jsx(XForm.Item, { name: field, label: entry.label, rules: rules, 
+                // XInput 走 RN 原生 onChangeText 值回调，其余控件都是 onChange
+                trigger: entry.type === 'input' ? 'onChangeText' : 'onChange', children: renderXFormField(entry, form, t) }, field));
+        }) }));
+}
+/**
+ * forwardRef + 泛型断言：让 <XFormPro<FieldType>> 正确推导 props 和 ref 类型
+ * （与老 FormPro 相同的手法）。
+ */
+const XFormPro = forwardRef(XFormProInner);
+export default XFormPro;

package/dist/XFormPro/renderers.d.ts

@@ -0,0 +1,24 @@
+/**
+ * XFormPro 的控件渲染分发：type -> 具体组件
+ *
+ * 自定义类型（如 skiaSignature 等需额外依赖的组件）通过 registerXFormProRenderer
+ * 注册，避免组件库硬依赖重型第三方包。未注册的类型返回 null。
+ */
+import React from 'react';
+import type { XFormInstance } from '../XForm';
+import type { XFormProItemProps } from './types';
+import type { XLocaleKey } from '../XLocale';
+export type XFormProCustomRenderer = (props: Record<string, any> | undefined, form: XFormInstance<any>) => React.ReactNode;
+/**
+ * 注册自定义控件渲染器（按 type 名匹配）。
+ *
+ * 例如注册签名组件：
+ * ```ts
+ * registerXFormProRenderer('skiaSignature', (props) => <SkiaSignature {...props} />);
+ * ```
+ */
+export declare function registerXFormProRenderer(type: string, renderer: XFormProCustomRenderer): void;
+/**
+ * 渲染单个表单项的输入控件（value/onChange 由 XForm.Item 注入，这里只管组件形态）
+ */
+export declare function renderXFormField(item: XFormProItemProps<any, any>, form: XFormInstance<any>, t: (key: XLocaleKey, params?: Record<string, string | number>) => string): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;

package/dist/XFormPro/renderers.js

@@ -0,0 +1,53 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { XInput } from '../XInput';
+import { XRadio } from '../XRadio';
+import { XCheckbox } from '../XCheckbox';
+import { XCascadeSelect } from '../XCascadeSelect';
+import { XMultiSelect } from '../XMultiSelect';
+import { XSelectField } from './components/XSelectField';
+import { XDateField } from './components/XDateField';
+const customRenderers = {};
+/**
+ * 注册自定义控件渲染器（按 type 名匹配）。
+ *
+ * 例如注册签名组件：
+ * ```ts
+ * registerXFormProRenderer('skiaSignature', (props) => <SkiaSignature {...props} />);
+ * ```
+ */
+export function registerXFormProRenderer(type, renderer) {
+    customRenderers[type] = renderer;
+}
+/**
+ * 渲染单个表单项的输入控件（value/onChange 由 XForm.Item 注入，这里只管组件形态）
+ */
+export function renderXFormField(item, form, t) {
+    const placeholder = item.componentsProps?.placeholder ??
+        (item.type === 'input' ? t('pleaseInputLabel', { n: item.label ?? '' }) : t('pleaseSelectLabel', { n: item.label ?? '' }));
+    switch (item.type) {
+        case 'custom':
+            return item.customRender ? item.customRender(form.getFieldsValue(), form) : null;
+        case 'input':
+            return _jsx(XInput, { placeholder: placeholder, style: { width: item.inputWidth ?? '100%' }, ...item.componentsProps });
+        case 'radioGroup':
+            return _jsx(XRadio.Group, { options: item.options ?? [], ...item.componentsProps });
+        case 'checkboxGroup':
+            return _jsx(XCheckbox.Group, { options: item.options ?? [], ...item.componentsProps });
+        case 'select':
+            return _jsx(XSelectField, { options: item.options ?? [], placeholder: placeholder, ...item.componentsProps });
+        case 'cascadeSelect':
+            return _jsx(XCascadeSelect, { options: item.cascadeOptions ?? [], placeholder: placeholder, ...item.componentsProps });
+        case 'multiSelect':
+            return _jsx(XMultiSelect, { options: item.options ?? [], placeholder: placeholder, ...item.componentsProps });
+        case 'datePicker':
+            return _jsx(XDateField, { placeholder: placeholder, ...item.componentsProps });
+        default: {
+            // 自定义类型（如 skiaSignature）：通过 registerXFormProRenderer 注册
+            const customRenderer = customRenderers[item.type];
+            if (customRenderer) {
+                return customRenderer(item.componentsProps, form);
+            }
+            return _jsx(XInput, { placeholder: placeholder, ...item.componentsProps });
+        }
+    }
+}

package/dist/XFormPro/types.d.ts

@@ -0,0 +1,142 @@
+/**
+ * XFormPro 类型定义 —— 低代码表单（基于 XForm，对标老 FormPro 的配置式 API）
+ */
+import type { ReactNode } from 'react';
+import type { XInputProps } from '../XInput';
+import type { XRadioGroupProps } from '../XRadio';
+import type { XCheckboxGroupProps } from '../XCheckbox';
+import type { XCascadeSelectProps } from '../XCascadeSelect';
+import type { XMultiSelectProps } from '../XMultiSelect';
+import type { XPickerProps } from '../XPicker';
+import type { XPickerDateProps } from '../XPickerDate';
+import type { XFormInstance } from '../XForm';
+/** 表单数据对象 */
+export type XFormModelValue = {
+    [k: string]: any;
+};
+/** 平铺选项数据（radioGroup / checkboxGroup / select / multiSelect 用） */
+export type XOptionItem = {
+    label: string;
+    value: any;
+    disabled?: boolean;
+};
+/**
+ * 支持的表单控件类型映射（componentsProps 的类型按 type 收窄）
+ *
+ * 与老 FormPro 的差异：
+ * - input      -> XInput（multiline 即多行文本，textarea 取消）
+ * - inputItem / inputNumber / textarea -> 移除
+ * - radioGroup -> XRadio.Group
+ * - checkboxGroup -> XCheckbox.Group
+ * - select     -> XPicker（XSelectField 触发器包装）
+ * - cascadeSelect -> XCascadeSelect（自研级联，antd Cascader 数据结构）
+ * - multiSelect -> XMultiSelect（XPullView + XCheckbox 重制）
+ * - datePicker  -> XPickerDate（时间模式通过 componentsProps.format 传 'HH:mm:ss' 等，timePicker 类型取消）
+ * - skiaSignature -> SkiaSignature
+ * - imageUpload / videoUpload -> 后续再加
+ */
+export type XFm = {
+    custom: {
+        props: Record<string, any>;
+    };
+    input: {
+        props: Partial<Omit<XInputProps, 'value' | 'onChangeText'>>;
+    };
+    radioGroup: {
+        props: Partial<Omit<XRadioGroupProps, 'value' | 'onChange' | 'options'>>;
+    };
+    checkboxGroup: {
+        props: Partial<Omit<XCheckboxGroupProps, 'value' | 'onChange' | 'options'>>;
+    };
+    select: {
+        props: Partial<Omit<XPickerProps, 'visible' | 'value' | 'onChange' | 'options' | 'onClose'>> & {
+            placeholder?: string;
+        };
+    };
+    cascadeSelect: {
+        props: Partial<Omit<XCascadeSelectProps, 'value' | 'onChange' | 'options'>>;
+    };
+    multiSelect: {
+        props: Partial<Omit<XMultiSelectProps, 'value' | 'onChange' | 'options'>>;
+    };
+    datePicker: {
+        props: Partial<Omit<XPickerDateProps, 'visible' | 'value' | 'onChange' | 'onClose'>> & {
+            placeholder?: string;
+        };
+    };
+    skiaSignature: {
+        props: Partial<Record<string, any>>;
+    };
+};
+/** 单条校验规则（对应 XForm 的 XRule 子集） */
+export type XFormProRule = {
+    required?: boolean;
+    message?: string;
+    pattern?: RegExp;
+    min?: number;
+    max?: number;
+    validator?: (_rule: any, value: any) => Promise<void>;
+};
+/** 表单项基础配置 */
+export type XBaseFormItemProps<ModelValue = Record<string, any>> = {
+    /** 标签文本 */
+    label?: string;
+    /** 是否必填（为 true 且未配置 rules 时自动生成必填校验） */
+    required?: boolean;
+    /** 校验规则（单条），不传则 required 为 true 时自动生成 */
+    rule?: XFormProRule;
+    /** 校验规则（多条），优先级高于 rule */
+    rules?: XFormProRule[];
+    /** 是否隐藏（编辑场景按状态隐藏字段） */
+    hide?: boolean;
+    /** 输入框宽度（input 类型），默认 100% */
+    inputWidth?: number | string;
+    /** 自定义渲染函数，仅 type 为 custom 时生效 */
+    customRender?: (modelValue: ModelValue, form: XFormInstance<any>) => ReactNode;
+    /** 选项数据（radioGroup / checkboxGroup / select / multiSelect 用） */
+    options?: XOptionItem[];
+    /** 级联数据（cascadeSelect 用，antd Cascader 同款树结构） */
+    cascadeOptions?: XCascadeSelectProps['options'];
+};
+/** 表单项完整配置（判别联合：componentsProps 类型随 type 收窄） */
+export type XFormProItemProps<ModelValue, TK extends keyof XFm = keyof XFm> = XBaseFormItemProps<ModelValue> & {
+    /** 控件类型 */
+    type: TK;
+    /** 控件 props（透传给具体组件，value/onChange 由表单注入） */
+    componentsProps?: XFm[TK]['props'];
+};
+/**
+ * 表单配置对象：key 对应 model 字段名，value 为表单项配置。
+ * 键可选：hiddenValues 托管的字段（如 id）无需配置表单项。
+ */
+export type XFormItemOptions<ModelValue> = {
+    [K in keyof ModelValue]?: {
+        [T in keyof XFm]: XFormProItemProps<ModelValue, T>;
+    }[keyof XFm];
+};
+/** XFormPro 组件 Props */
+export interface XFormProProps<ModelValue = Record<string, any>> {
+    /** 表单数据（受控；编辑回显/重置场景改这个值即可） */
+    value: ModelValue;
+    /** 值变化回调（用户输入触发，含 hiddenValues） */
+    onUpdateValue?: (value: ModelValue) => void;
+    /** 标签宽度（horizontal 布局用） */
+    labelWidth?: number;
+    /** 标签位置，默认 vertical */
+    layout?: 'vertical' | 'horizontal';
+    /** 表单配置 */
+    formItemOptions?: XFormItemOptions<ModelValue>;
+    /**
+     * 隐藏字段（编辑场景的关键）：不渲染表单项，但值会进 store，
+     * validate/提交/onUpdateValue 的结果里都带（如 id、createBy 原样带回）；
+     * 不受 resetFields 影响。
+     */
+    hiddenValues?: Partial<ModelValue>;
+}
+/** XFormPro 暴露的实例方法（老 FormPro 同名同义） */
+export interface XFormProInst<ModelValue = Record<string, any>> {
+    /** 校验表单，成功 resolve 全量值（含 hiddenValues），失败 reject {values, errorFields} */
+    validate: () => Promise<ModelValue>;
+    /** 清除全部校验错误 */
+    restoreValidation: () => void;
+}

package/dist/XFormPro/types.js

@@ -0,0 +1 @@
+export {};

package/dist/XImage/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { ImageStyle } from 'react-native';
+import { ImageResizeMode } from 'react-native';
+export interface ImageWithLoaderProps {
+    uri: string;
+    style?: ImageStyle;
+    onPress?: () => void;
+    onLongPress?: () => void;
+    delayLongPress?: number;
+    resizeMode?: ImageResizeMode | undefined;
+    onDelete?: () => void;
+}
+export declare const XImage: React.FC<ImageWithLoaderProps>;

package/dist/XImage/index.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { ActivityIndicator, Image, StyleSheet, TouchableOpacity, View } from 'react-native';
+import AntDesign from '@react-native-vector-icons/ant-design';
+import { useXTheme } from '../theme';
+export const XImage = ({ resizeMode, uri, style, onPress, onLongPress, delayLongPress, onDelete }) => {
+    const t = useXTheme();
+    const [loading, setLoading] = useState(true);
+    return (_jsxs(View, { children: [_jsxs(TouchableOpacity, { delayLongPress: delayLongPress, onPress: onPress, onLongPress: onLongPress, activeOpacity: 0.8, children: [loading && (_jsx(View, { style: [style, styles.loadingContainer, { backgroundColor: t.colorSplit }], children: _jsx(ActivityIndicator, { size: 'small', color: t.colorPrimary }) })), _jsx(Image, { resizeMode: resizeMode, source: { uri }, style: [style, loading && { opacity: 0 }], onLoad: () => setLoading(false), onError: () => setLoading(false) })] }), onDelete && (_jsx(TouchableOpacity, { style: [styles.deleteBtn, { backgroundColor: t.colorError }], onPress: onDelete, activeOpacity: 0.7, hitSlop: { top: 4, right: 4, bottom: 4, left: 4 }, children: _jsx(AntDesign, { name: 'close', size: 14, color: t.colorTextLightSolid }) }))] }));
+};
+const styles = StyleSheet.create({
+    loadingContainer: {
+        position: 'absolute',
+        top: 0,
+        left: 0,
+        right: 0,
+        bottom: 0,
+        justifyContent: 'center',
+        alignItems: 'center',
+    },
+    deleteBtn: {
+        position: 'absolute',
+        top: -6,
+        right: -6,
+        width: 20,
+        height: 20,
+        borderRadius: 10,
+        alignItems: 'center',
+        justifyContent: 'center',
+        zIndex: 10,
+    },
+});

package/dist/XInput/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ============================================================================
+ * XInput —— 项目通用输入框（样式取自 componentsTest 的 styles.input）
+ * ============================================================================
+ *
+ * 把项目里反复手写的输入框样式沉淀成组件：
+ * 发丝边框 + 8 圆角 + 浅灰底，多行模式自动变成"备注"样式（minHeight + 顶部对齐）。
+ *
+ * 用法：
+ * ```tsx
+ * <XInput value={name} onChangeText={setName} placeholder='请输入姓名' />
+ * <XInput multiline placeholder='请输入备注' />
+ * <XInput disabled value='只读' />
+ * ```
+ *
+ * 与 antd Input 的对应：
+ * - value / onChangeText：RN 原生命名（方便 XForm.Item 直接注入，trigger='onChangeText'）
+ * - disabled：对应 antd disabled（不可编辑 + 禁用样式）
+ * - multiline：对应 antd Input.TextArea
+ * - allowClear：对应 antd allowClear（非多行时显示清空按钮）
+ * - 其余 props（maxLength/keyboardType/secureTextEntry 等）原样透传给 TextInput
+ *
+ * 注意：value 是完全受控透传，不做任何 trim/transform —— 改写会打断
+ * Android 中文输入法的合成过程（XForm 的同值守卫也依赖原样透传）。
+ */
+import React from 'react';
+import { TextInput, TextInputProps, StyleProp, TextStyle, ViewStyle } from 'react-native';
+export interface XInputProps extends TextInputProps {
+    value?: string;
+    onChangeText?: (text: string) => void;
+    multiline?: boolean;
+    /** 禁用：不可编辑 + 禁用底色（antd disabled） */
+    disabled?: boolean;
+    /** 有内容时显示清空按钮（antd allowClear；multiline 下不生效） */
+    allowClear?: boolean;
+    style?: StyleProp<TextStyle>;
+    /** 外层容器样式（有 allowClear 按钮时想要撑满/贴边用） */
+    containerStyle?: StyleProp<ViewStyle>;
+}
+export declare const XInput: React.ForwardRefExoticComponent<XInputProps & React.RefAttributes<TextInput>>;
+/** antd Input.TextArea 的对应形态 */
+export declare const XTextArea: (props: XInputProps) => React.JSX.Element;
+export default XInput;