react-native-x-components 0.1.0

package/dist/XElevator/index.js

@@ -0,0 +1,138 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XElevator —— 电梯楼层/字母导航列表（duxui Elevator 的 RN 原生重写版）
+ * ============================================================================
+ *
+ * 【与 duxui Elevator 的关系】
+ * duxui 用 ScrollView + Layout 手动累加每组高度算 scrollTop；
+ * RN 端 SectionList 原生支持分组吸顶 + scrollToLocation，
+ * 这里直接用 SectionList 重写：代码量减半、吸顶/定位更稳。
+ *
+ * 【右侧导航条】
+ * - 触摸（按下/滑动）定位：容器拦截 responder 事件，用 locationY 与
+ *   各标签 onLayout 记录的 y 区间比对，命中即 scrollToLocation；
+ * - 滚动联动高亮：onViewableItemsChanged 取第一个可见项所属 section。
+ *
+ * 【API 对标 duxui】list -> sections（{title, data}[]）、onItemClick、
+ * showNav、renderTop/Header/Footer/Empty；扩展 navLabel（导航条短标签，
+ * 默认取 title 首字符）、keyExtractor。
+ * ============================================================================
+ */
+import { useCallback, useRef, useState } from 'react';
+import { SectionList, StyleSheet, Text, View, } from 'react-native';
+import { useXTheme } from '../theme';
+export function XElevator({ sections, renderItem, keyExtractor, onItemClick, showNav = true, renderTop, renderFooter, renderEmpty, style, }) {
+    const t = useXTheme();
+    const listRef = useRef(null);
+    /** 导航条每个标签的 y 中心（onLayout 记录，用于触摸命中） */
+    const navYRef = useRef([]);
+    /** 当前高亮的分组下标 */
+    const [activeIndex, setActiveIndex] = useState(0);
+    /** 滚动定位到分组 */
+    const scrollToSection = useCallback((index) => {
+        if (index < 0 || index >= sections.length)
+            return;
+        listRef.current?.scrollToLocation({ sectionIndex: index, itemIndex: 0, viewPosition: 0 });
+    }, [sections.length]);
+    /**
+     * 导航条触摸（按下/滑动）：locationY 落在哪个标签区间 → 定位。
+     * onStartShouldSetResponder 抢占事件，滑动中 onResponderMove 连续命中。
+     */
+    const handleNavTouch = useCallback((e) => {
+        const y = e.nativeEvent.locationY;
+        const ys = navYRef.current;
+        for (let i = ys.length - 1; i >= 0; i--) {
+            if (ys[i] !== undefined && y >= ys[i]) {
+                if (activeIndex !== i)
+                    setActiveIndex(i);
+                scrollToSection(i);
+                return;
+            }
+        }
+        scrollToSection(0);
+    }, [activeIndex, scrollToSection]);
+    /** 第一个可见项所属分组 → 导航高亮 */
+    const handleViewableItemsChanged = useRef(({ viewableItems }) => {
+        const first = viewableItems.find(v => v.section);
+        if (!first?.section)
+            return;
+        const index = sections.findIndex(s => s.title === first.section.title);
+        if (index >= 0)
+            setActiveIndex(prev => (prev === index ? prev : index));
+    }).current;
+    /** 默认行渲染 */
+    const defaultRenderItem = (item, section, index) => (_jsx(Text, { style: [styles.itemText, { color: t.colorText }], children: item.name }));
+    /** SectionList 的行：包一层按压反馈 */
+    const renderRow = ({ item, section, index }) => {
+        const Row = renderItem ?? defaultRenderItem;
+        return (_jsx(View, { style: [styles.item, { borderBottomColor: t.colorSplit }], onTouchEnd: () => onItemClick?.(item, section), children: Row(item, section, index) }));
+    };
+    const hasData = sections.some(s => s.data.length > 0);
+    return (_jsxs(View, { style: [styles.container, style], children: [_jsxs(View, { style: styles.listWrap, children: [renderTop?.(), _jsx(SectionList, { ref: listRef, sections: sections, renderItem: renderRow, renderSectionHeader: ({ section }) => (_jsx(View, { style: [styles.sectionHeader, { backgroundColor: t.colorBgLayout }], children: _jsx(Text, { style: [styles.sectionTitle, { color: t.colorTextSecondary }], children: section.title }) })), keyExtractor: keyExtractor ?? ((item, index) => String(index)), stickySectionHeadersEnabled: true, onViewableItemsChanged: handleViewableItemsChanged, viewabilityConfig: { itemVisiblePercentThreshold: 10 }, ListEmptyComponent: renderEmpty ?? _jsx(Text, { style: [styles.empty, { color: t.colorTextTertiary }], children: "\u6682\u65E0\u6570\u636E" }), ListFooterComponent: renderFooter, getItemLayout: undefined, onScrollToIndexFailed: () => {
+                            // 分组高度未测量完成时定位可能失败，兜底到顶部分组
+                            listRef.current?.scrollToLocation({ sectionIndex: 0, itemIndex: 0, viewPosition: 0 });
+                        } }), renderFooter?.()] }), showNav && hasData && (_jsx(View, { style: [styles.nav, { backgroundColor: t.colorBgContainerDisabled }], onStartShouldSetResponder: () => true, onMoveShouldSetResponder: () => true, onResponderGrant: handleNavTouch, onResponderMove: handleNavTouch, children: sections.map((section, i) => (_jsx(View, { onLayout: e => {
+                        // 记录每个标签的"区间下界"，命中判断用
+                        navYRef.current[i] = e.nativeEvent.layout.y + e.nativeEvent.layout.height / 2;
+                    }, style: [styles.navItem, activeIndex === i && styles.navItemActive], children: _jsx(Text, { style: [
+                            styles.navText,
+                            { color: t.colorTextSecondary },
+                            activeIndex === i && { color: t.colorTextLightSolid },
+                        ], allowFontScaling: false, children: section.navLabel ?? section.title.slice(0, 1) }) }, section.title + i))) }))] }));
+}
+const styles = StyleSheet.create({
+    container: {
+        flex: 1,
+        overflow: 'hidden',
+        position: 'relative',
+    },
+    listWrap: {
+        flex: 1,
+    },
+    sectionHeader: {
+        paddingHorizontal: 16,
+        paddingVertical: 6,
+    },
+    sectionTitle: {
+        fontSize: 13,
+    },
+    item: {
+        paddingHorizontal: 16,
+        paddingVertical: 12,
+        borderBottomWidth: StyleSheet.hairlineWidth,
+    },
+    itemText: {
+        fontSize: 15,
+    },
+    empty: {
+        textAlign: 'center',
+        paddingVertical: 40,
+        fontSize: 14,
+    },
+    nav: {
+        position: 'absolute',
+        right: 4,
+        top: '20%',
+        borderRadius: 12,
+        paddingHorizontal: 5,
+        paddingVertical: 6,
+        alignItems: 'center',
+    },
+    navItem: {
+        paddingVertical: 2,
+        paddingHorizontal: 3,
+        borderRadius: 9,
+        minHeight: 18,
+        justifyContent: 'center',
+    },
+    navItemActive: {
+        backgroundColor: '#2080F0',
+    },
+    navText: {
+        fontSize: 11,
+        lineHeight: 14,
+        textAlign: 'center',
+    },
+});
+export default XElevator;

package/dist/XForm/FormStore.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ============================================================================
+ * FormStore —— XForm 的数据中枢（对标 rc-field-form 的 FormStore 思路）
+ * ============================================================================
+ *
+ * 职责：
+ * 1. 集中保存所有字段值（store）与错误（errorsMap）
+ * 2. Form.Item 挂载时注册字段实体（rules / validateTrigger / initialValue），
+ *    卸载时注销（值保留，对标 antd preserve 默认行为）
+ * 3. 值变化 -> 通知所有字段实体重渲染 + onValuesChange 回调 + 按触发时机校验
+ *    本字段和 dependencies 依赖它的字段
+ * 4. validateFields / submit 的聚合校验
+ *
+ * 注册条目（entry）设计说明：
+ * Item 传进来的 entity 是"稳定对象 + 每轮渲染原地更新字段"，name 变化时
+ * entry.key 在注册那一刻被捕获，注销时按捕获值清理 —— 避免 name 原地更新后
+ * 清错 key 的竞态。
+ *
+ * 不做的事（刻意保持小）：
+ * - 不做 Form.List（antd 的动态列表字段）
+ * - 不做精确依赖调度：所有值变化通知全部实体，由 Item 自行读值，
+ *   表单规模下性能足够，换来实现简单可靠
+ */
+import type { XErrorEntity, XFieldData, XFormInstance, XNamePath, XRule, XValidateErrorEntity, XValidateTrigger } from './types';
+export interface XFieldEntity {
+    name: XNamePath;
+    rules?: XRule[];
+    validateTrigger?: XValidateTrigger | XValidateTrigger[];
+    dependencies?: XNamePath[];
+    initialValue?: any;
+    /** 触发该 Form.Item 重渲染（读取最新 value/errors） */
+    reRender: () => void;
+}
+interface XFormCallbacks {
+    onFinish?: (values: any) => void;
+    onFinishFailed?: (error: XValidateErrorEntity) => void;
+    onValuesChange?: (changedValues: any, allValues: any) => void;
+}
+export declare class FormStore {
+    private store;
+    /** initialValues（Form 级）：resetFields 的还原基准 */
+    private initialValues;
+    private fieldEntries;
+    /** 无 name 的 Item（函数式 children / shouldUpdate 联动渲染）的通用订阅者 */
+    private listeners;
+    private errorsMap;
+    private touchedKeys;
+    private callbacks;
+    /** 字段级校验 token：同一字段并发校验时只保留最后一次的结果（打字快时的竞态） */
+    private validateTokens;
+    private validateSeq;
+    registerField: (entity: XFieldEntity) => void;
+    unregisterField: (entity: XFieldEntity) => void;
+    /**
+     * 通用订阅：无 name 的 Form.Item（shouldUpdate + 函数式 children）注册，
+     * store 任何变化时被通知。返回退订函数。
+     */
+    subscribe: (listener: () => void) => (() => void);
+    setCallbacks: (callbacks: XFormCallbacks) => void;
+    initValues: (initialValues?: Record<string, any>) => void;
+    getFieldValue: (name: XNamePath) => any;
+    getFieldsValue: (nameList?: XNamePath[] | true) => any;
+    setFieldValue: (name: XNamePath, value: any) => void;
+    setFieldsValue: (values: Record<string, any>) => void;
+    setFields: (fields: XFieldData[]) => void;
+    resetFields: (nameList?: XNamePath[]) => void;
+    getFieldError: (name: XNamePath) => string[];
+    getFieldsError: (nameList?: XNamePath[]) => XErrorEntity[];
+    isFieldTouched: (name: XNamePath) => boolean;
+    isFieldsTouched: (nameList?: XNamePath[], allFieldsTouched?: boolean) => boolean;
+    updateValue: (name: XNamePath, value: any, trigger?: XValidateTrigger) => void;
+    /** 某字段的 onBlur 触发的校验入口 */
+    validateOnBlur: (name: XNamePath) => void;
+    private emitValuesChange;
+    validateFields: (nameList?: XNamePath[]) => Promise<any>;
+    /** 校验一组注册条目：并发执行，写回 errorsMap，通知重渲染 */
+    private validateEntries;
+    submit: () => Promise<void>;
+    private notifyAll;
+    getForm: () => XFormInstance<any>;
+}
+export {};

package/dist/XForm/FormStore.js

@@ -0,0 +1,279 @@
+import { deepClone, getValueByPath, isSameNamePath, matchDependency, namePathKey, setValueByPath } from './utils';
+import { validateValue } from './validate';
+export class FormStore {
+    store = {};
+    /** initialValues（Form 级）：resetFields 的还原基准 */
+    initialValues = {};
+    fieldEntries = [];
+    /** 无 name 的 Item（函数式 children / shouldUpdate 联动渲染）的通用订阅者 */
+    listeners = new Set();
+    errorsMap = new Map();
+    touchedKeys = new Set();
+    callbacks = {};
+    /** 字段级校验 token：同一字段并发校验时只保留最后一次的结果（打字快时的竞态） */
+    validateTokens = new Map();
+    validateSeq = 0;
+    // ------------------------------------------------------------------
+    // 字段实体注册
+    // ------------------------------------------------------------------
+    registerField = (entity) => {
+        const key = namePathKey(entity.name);
+        // 同 key 重复注册（StrictMode 双挂载等场景）：先清旧条目
+        this.fieldEntries = this.fieldEntries.filter(entry => entry.key !== key);
+        this.fieldEntries.push({ entity, key });
+        // Item 的 initialValue：仅当 store 里还没有值时生效（对标 antd initialValue 语义）
+        if (entity.initialValue !== undefined && getValueByPath(this.store, entity.name) === undefined) {
+            this.store = setValueByPath(this.store, entity.name, entity.initialValue);
+            entity.reRender();
+        }
+    };
+    unregisterField = (entity) => {
+        const entry = this.fieldEntries.find(e => e.entity === entity);
+        if (entry) {
+            this.fieldEntries = this.fieldEntries.filter(e => e !== entry);
+            this.errorsMap.delete(entry.key);
+            this.touchedKeys.delete(entry.key);
+        }
+    };
+    /**
+     * 通用订阅：无 name 的 Form.Item（shouldUpdate + 函数式 children）注册，
+     * store 任何变化时被通知。返回退订函数。
+     */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    // ------------------------------------------------------------------
+    // callbacks（Form 组件每轮渲染注入最新闭包）
+    // ------------------------------------------------------------------
+    setCallbacks = (callbacks) => {
+        this.callbacks = callbacks;
+    };
+    initValues = (initialValues) => {
+        if (initialValues) {
+            this.initialValues = deepClone(initialValues);
+            this.store = { ...this.store, ...deepClone(initialValues) };
+            this.notifyAll();
+        }
+    };
+    // ------------------------------------------------------------------
+    // 取值
+    // ------------------------------------------------------------------
+    getFieldValue = (name) => getValueByPath(this.store, name);
+    getFieldsValue = (nameList) => {
+        if (nameList === true)
+            return deepClone(this.store);
+        if (!nameList)
+            return deepClone(this.store);
+        const out = {};
+        for (const name of nameList) {
+            const key = namePathKey(name);
+            out[key] = deepClone(getValueByPath(this.store, name));
+        }
+        return out;
+    };
+    // ------------------------------------------------------------------
+    // 设值（外部 API：setFieldValue / setFieldsValue / setFields）
+    // ------------------------------------------------------------------
+    setFieldValue = (name, value) => {
+        this.store = setValueByPath(this.store, name, value);
+        // 程序化设值只重渲染，不触发 onValuesChange（antd 同款语义：
+        // 外部回显/回填不属于"用户输入"，避免受控回声）
+        this.notifyAll();
+    };
+    setFieldsValue = (values) => {
+        Object.keys(values).forEach(key => {
+            this.store = setValueByPath(this.store, key, values[key]);
+        });
+        this.notifyAll();
+    };
+    setFields = (fields) => {
+        for (const field of fields) {
+            if ('value' in field) {
+                this.store = setValueByPath(this.store, field.name, field.value);
+            }
+            if (field.errors) {
+                this.errorsMap.set(namePathKey(field.name), field.errors);
+            }
+        }
+        this.notifyAll();
+    };
+    // ------------------------------------------------------------------
+    // 重置
+    // ------------------------------------------------------------------
+    resetFields = (nameList) => {
+        const targets = nameList ?? this.fieldEntries.map(entry => entry.entity.name);
+        for (const name of targets) {
+            const key = namePathKey(name);
+            const fromInitial = getValueByPath(this.initialValues, name);
+            const entry = this.fieldEntries.find(e => e.key === key);
+            const nextValue = fromInitial !== undefined ? fromInitial : entry?.entity.initialValue !== undefined ? entry.entity.initialValue : undefined;
+            this.store = setValueByPath(this.store, name, nextValue);
+            this.errorsMap.delete(key);
+            this.touchedKeys.delete(key);
+        }
+        this.notifyAll();
+    };
+    // ------------------------------------------------------------------
+    // 错误读取
+    // ------------------------------------------------------------------
+    getFieldError = (name) => this.errorsMap.get(namePathKey(name)) ?? [];
+    getFieldsError = (nameList) => {
+        const targets = nameList ?? this.fieldEntries.map(entry => entry.entity.name);
+        return targets.map(name => ({ name, errors: this.getFieldError(name) }));
+    };
+    // ------------------------------------------------------------------
+    // touched
+    // ------------------------------------------------------------------
+    isFieldTouched = (name) => this.touchedKeys.has(namePathKey(name));
+    isFieldsTouched = (nameList, allFieldsTouched = false) => {
+        const keys = (nameList ?? [...this.touchedKeys]).map(namePathKey);
+        if (!keys.length)
+            return false;
+        return allFieldsTouched ? keys.every(k => this.touchedKeys.has(k)) : keys.some(k => this.touchedKeys.has(k));
+    };
+    // ------------------------------------------------------------------
+    // 值更新（Form.Item 注入的 onChange 走这里）
+    // ------------------------------------------------------------------
+    updateValue = (name, value, trigger = 'onChange') => {
+        const key = namePathKey(name);
+        const prev = getValueByPath(this.store, name);
+        const unchanged = Object.is(prev, value);
+        this.store = setValueByPath(this.store, name, value);
+        this.touchedKeys.add(key);
+        /**
+         * 同值守卫（关键）：Android 受控 TextInput 在 IME 合成期间会把 React 提交的
+         * value 原样回抛 onChangeText；若值没变仍通知重渲染，会形成
+         * "commit -> 回抛 -> commit" 的同步递归，直接 Maximum call stack size exceeded。
+         * 值不变时只记 touched，不触发重渲染/回调/校验。
+         */
+        if (unchanged) {
+            return;
+        }
+        this.notifyAll();
+        this.emitValuesChange(name, value);
+        // 本字段按触发时机校验
+        const entry = this.fieldEntries.find(e => e.key === key);
+        if (entry) {
+            const triggers = normalizeTriggers(entry.entity.validateTrigger);
+            if (triggers.includes(trigger)) {
+                this.validateEntries([entry]);
+            }
+            // dependencies：依赖本字段的其他字段重新校验（经典场景：二次输入密码）
+            const dependents = this.fieldEntries.filter(e => e !== entry && matchDependency(e.entity.dependencies, name));
+            if (dependents.length) {
+                this.validateEntries(dependents);
+            }
+        }
+    };
+    /** 某字段的 onBlur 触发的校验入口 */
+    validateOnBlur = (name) => {
+        const key = namePathKey(name);
+        const entry = this.fieldEntries.find(e => e.key === key);
+        if (!entry)
+            return;
+        const triggers = normalizeTriggers(entry.entity.validateTrigger);
+        if (triggers.includes('onBlur')) {
+            this.validateEntries([entry]);
+        }
+    };
+    emitValuesChange = (name, value) => {
+        if (!this.callbacks.onValuesChange)
+            return;
+        const all = deepClone(this.store);
+        if (name === null) {
+            this.callbacks.onValuesChange(value, all);
+        }
+        else {
+            this.callbacks.onValuesChange(setValueByPath({}, name, value), all);
+        }
+    };
+    // ------------------------------------------------------------------
+    // 校验
+    // ------------------------------------------------------------------
+    validateFields = async (nameList) => {
+        const entries = nameList
+            ? this.fieldEntries.filter(entry => nameList.some(n => isSameNamePath(n, entry.entity.name)))
+            : [...this.fieldEntries];
+        await this.validateEntries(entries);
+        const failed = entries.filter(entry => (this.errorsMap.get(entry.key) ?? []).length > 0);
+        const values = nameList ? this.getFieldsValue(nameList) : this.getFieldsValue();
+        if (failed.length) {
+            const errorEntity = {
+                values,
+                errorFields: failed.map(entry => ({ name: entry.entity.name, errors: this.errorsMap.get(entry.key) ?? [] })),
+                outOfDate: false,
+            };
+            throw errorEntity;
+        }
+        return values;
+    };
+    /** 校验一组注册条目：并发执行，写回 errorsMap，通知重渲染 */
+    validateEntries = async (entries) => {
+        if (!entries.length)
+            return;
+        // 每个字段领一个新 token；await 期间同字段又触发了新一轮校验的话，本轮结果作废
+        const myTokens = new Map();
+        for (const entry of entries) {
+            const token = ++this.validateSeq;
+            this.validateTokens.set(entry.key, token);
+            myTokens.set(entry.key, token);
+        }
+        const results = await Promise.all(entries.map(async (entry) => {
+            const { name, rules } = entry.entity;
+            const value = getValueByPath(this.store, name);
+            const errors = await validateValue(value, rules, name);
+            return { entry, errors };
+        }));
+        for (const { entry, errors } of results) {
+            if (this.validateTokens.get(entry.key) !== myTokens.get(entry.key))
+                continue; // 过期结果，丢弃
+            if (errors.length) {
+                this.errorsMap.set(entry.key, errors);
+            }
+            else {
+                this.errorsMap.delete(entry.key);
+            }
+        }
+        this.notifyAll();
+    };
+    // ------------------------------------------------------------------
+    // 提交
+    // ------------------------------------------------------------------
+    submit = async () => {
+        try {
+            const values = await this.validateFields();
+            this.callbacks.onFinish?.(values);
+        }
+        catch (error) {
+            this.callbacks.onFinishFailed?.(error);
+        }
+    };
+    // ------------------------------------------------------------------
+    // 通知 & 实例
+    // ------------------------------------------------------------------
+    notifyAll = () => {
+        this.fieldEntries.forEach(entry => entry.entity.reRender());
+        this.listeners.forEach(listener => listener());
+    };
+    getForm = () => ({
+        getFieldValue: this.getFieldValue,
+        getFieldsValue: this.getFieldsValue,
+        setFieldValue: this.setFieldValue,
+        setFieldsValue: this.setFieldsValue,
+        setFields: this.setFields,
+        resetFields: this.resetFields,
+        getFieldError: this.getFieldError,
+        getFieldsError: this.getFieldsError,
+        validateFields: this.validateFields,
+        submit: this.submit,
+        isFieldTouched: this.isFieldTouched,
+        isFieldsTouched: this.isFieldsTouched,
+        __getStore: () => this,
+    });
+}
+function normalizeTriggers(trigger) {
+    if (!trigger)
+        return ['onChange'];
+    return Array.isArray(trigger) ? trigger : [trigger];
+}

package/dist/XForm/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * ============================================================================
+ * XForm / XForm.Item —— 对标 antd Form（RN 自实现版）
+ * ============================================================================
+ *
+ * 用法（和 antd 一致）：
+ * ```tsx
+ * const [form] = XForm.useForm();
+ *
+ * <XForm
+ *   form={form}
+ *   initialValues={{name: '张三'}}
+ *   onFinish={values => console.log('提交', values)}
+ *   onFinishFailed={({errorFields}) => console.log('失败', errorFields)}
+ * >
+ *   <XForm.Item label='姓名' name='name' rules={[{required: true, message: '请输入姓名'}]}>
+ *     <TextInput placeholder='请输入姓名' />
+ *   </XForm.Item>
+ *
+ *   <XForm.Item label='性别' name='sex' rules={[{required: true, message: '请选择性别'}]}>
+ *     <XRadio.Group options={[{label: '男', value: 1}, {label: '女', value: 0}]} />
+ *   </XForm.Item>
+ *
+ *   <XButton type='primary' onPress={() => form.submit()}>提交</XButton>
+ * </XForm>
+ * ```
+ *
+ * Form.Item 支持的 antd API：
+ * - name / label / rules / initialValue
+ * - validateTrigger: 'onChange' | 'onBlur' | 两者数组（默认 onChange）
+ * - valuePropName: 默认 'value'（Checkbox 这类受控属性叫 checked 时改成 'checked'）
+ * - trigger: 值变化回调的 prop 名（默认 'onChange'）
+ * - getValueFromEvent: 自定义从回调参数里取值
+ * - dependencies: 这些字段的值变化会触发本字段重新校验（如二次输入密码）
+ * - help / validateStatus: 手动控制提示文案与状态色（设置后优先生效，help 默认按 error 色显示）
+ * - required: 只控制 * 号显示（校验语义请写在 rules 里，同 antd）
+ * - noStyle: 不渲染 label/错误文案/外层间距，只注入 value/onChange
+ * - shouldUpdate + 函数 children: 渲染函数拿到 form 实例，做联动 UI
+ *
+ * 与 antd 的差异：
+ * - 无 Form.List / Form.Provider（动态列表后续有需要再加）
+ * - store 任何变化会通知所有 Item 重渲染（antd 是精确调度；表单规模下性能足够）
+ * - label 布局提供 vertical（默认）/ horizontal 两种
+ */
+import React from 'react';
+import { StyleProp, ViewStyle, TextStyle } from 'react-native';
+import { useForm } from './useForm';
+import type { XFormInstance, XNamePath, XRule, XValidateTrigger } from './types';
+export type { XRule, XRuleObject, XNamePath, XFormInstance, XErrorEntity, XFieldData, XValidateErrorEntity, XValidateTrigger } from './types';
+export { useForm } from './useForm';
+export interface XFormProps {
+    /** useForm 创建的实例（不传时内部自建，外部拿不到实例方法） */
+    form?: XFormInstance<any>;
+    /** 初始值（只做初始化与 resetFields 还原基准，运行中修改不生效） */
+    initialValues?: Record<string, any>;
+    onFinish?: (values: any) => void;
+    onFinishFailed?: (errorInfo: {
+        values: any;
+        errorFields: {
+            name: XNamePath;
+            errors: string[];
+        }[];
+        outOfDate: boolean;
+    }) => void;
+    onValuesChange?: (changedValues: any, allValues: any) => void;
+    layout?: 'vertical' | 'horizontal';
+    /** horizontal 布局的 label 宽度 */
+    labelWidth?: number;
+    labelStyle?: StyleProp<TextStyle>;
+    requiredMark?: boolean;
+    style?: StyleProp<ViewStyle>;
+    children?: React.ReactNode;
+    testID?: string;
+}
+declare function XForm(props: XFormProps): React.JSX.Element;
+export interface XFormItemProps {
+    /** 字段名（不传则纯布局：不注入 value/onChange，也不校验） */
+    name?: XNamePath;
+    label?: React.ReactNode;
+    rules?: XRule[];
+    initialValue?: any;
+    validateTrigger?: XValidateTrigger | XValidateTrigger[];
+    /** 受控值的 prop 名，默认 'value'；Checkbox 场景传 'checked' */
+    valuePropName?: string;
+    /** 值变化的 prop 名，默认 'onChange' */
+    trigger?: string;
+    /** 自定义从回调参数里取值（默认自动识别：直传值 / 合成事件 / RN 原生事件） */
+    getValueFromEvent?: (...args: any[]) => any;
+    /** 这些字段的值变化会触发本字段重新校验 */
+    dependencies?: XNamePath[];
+    /** 手动提示文案（设置后优先生效，默认按 error 色显示；配 validateStatus 可换色） */
+    help?: React.ReactNode;
+    /** 手动校验状态：'error' | 'warning' | 'success' | 'validating' */
+    validateStatus?: 'error' | 'warning' | 'success' | 'validating';
+    /** 兼容 antd 的占位 prop（RN 无反馈图标，恒为无操作） */
+    hasFeedback?: boolean;
+    /** 只显示 * 号，不产生校验规则（同 antd：校验语义放 rules） */
+    required?: boolean;
+    /** 不渲染任何包裹：只注入 value/onChange */
+    noStyle?: boolean;
+    /** 函数式 children 联动渲染（配 shouldUpdate 使用；实现上 store 变化即重渲染） */
+    shouldUpdate?: boolean | ((prevValues: any, curValues: any) => boolean);
+    labelWidth?: number;
+    labelStyle?: StyleProp<TextStyle>;
+    style?: StyleProp<ViewStyle>;
+    /** 普通节点，或 shouldUpdate 场景下的渲染函数（拿到 form 实例） */
+    children?: React.ReactNode | ((form: XFormInstance<any>) => React.ReactNode);
+    testID?: string;
+}
+declare function XFormItem(props: XFormItemProps): React.JSX.Element;
+type XFormWithStatics = typeof XForm & {
+    Item: typeof XFormItem;
+    useForm: typeof useForm;
+};
+declare const XFormExported: XFormWithStatics;
+export default XFormExported;