react-native-x-components 0.1.0

package/dist/XInput/index.js

@@ -0,0 +1,136 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * 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 { forwardRef, useEffect, useRef, useState } from 'react';
+import { Pressable, StyleSheet, TextInput, View } from 'react-native';
+import { useXTheme } from '../theme';
+export const XInput = forwardRef(function XInput({ value, onChangeText, multiline, disabled, allowClear, style, containerStyle, editable, ...rest }, ref) {
+    const [focused, setFocused] = useState(false);
+    const isDisabled = disabled || editable === false;
+    /**
+     * Android IME 防回抛镜像（关键）：
+     * 受控模式下若把父级 store 的 value 每键原样回写给 TextInput，IME 合成会被
+     * 打断并触发原生层再次回抛 onChangeText，形成"回写 -> 回抛 -> 回写"的同步
+     * 递归（Maximum call stack size exceeded）。
+     * 做法：输入先写本地镜像再上报，传回 TextInput 的 value 恒等于原生当前文本，
+     * RN 的事件计数对得上就不会再 setText，循环从源头消失。
+     * 外部改值（回填/重置）通过 reportedRef 区分：value 不等于我们最近上报的
+     * 文本，说明是外部注入，才采纳进镜像。
+     */
+    const [mirror, setMirror] = useState(value);
+    const reportedRef = useRef(value);
+    useEffect(() => {
+        if (value !== reportedRef.current) {
+            reportedRef.current = value;
+            setMirror(value);
+        }
+    }, [value]);
+    const handleChange = (text) => {
+        reportedRef.current = text;
+        setMirror(text);
+        onChangeText?.(text);
+    };
+    // 受控用法显示镜像；非受控（没传 value）不干预，TextInput 自己管
+    const displayValue = value !== undefined ? mirror : undefined;
+    const t = useXTheme();
+    const showClear = !!allowClear && !multiline && !isDisabled && !!displayValue;
+    /** 清空后把光标送回输入框，继续输入不用再点一次 */
+    const handleClear = () => {
+        reportedRef.current = '';
+        setMirror('');
+        onChangeText?.('');
+        ref && typeof ref === 'object' && ref.current?.focus();
+    };
+    return (_jsxs(View, { style: [styles.container, containerStyle], children: [_jsx(TextInput, { ...rest, ref: ref, value: displayValue, onChangeText: handleChange, multiline: multiline, editable: !isDisabled, pointerEvents: isDisabled ? 'none' : undefined, style: [
+                    styles.input,
+                    {
+                        borderColor: focused && !isDisabled ? t.colorPrimary : t.colorBorder,
+                        color: isDisabled ? t.colorTextQuaternary : t.colorText,
+                        backgroundColor: isDisabled
+                            ? t.colorBgContainerDisabled
+                            : focused
+                                ? t.colorBgContainer
+                                : t.colorBgLayout,
+                    },
+                    multiline && styles.textarea,
+                    style,
+                ], placeholderTextColor: rest.placeholderTextColor ?? t.colorTextQuaternary, allowFontScaling: false, onFocus: e => {
+                    setFocused(true);
+                    rest.onFocus?.(e);
+                }, onBlur: e => {
+                    setFocused(false);
+                    rest.onBlur?.(e);
+                } }), showClear && (_jsx(Pressable, { onPress: handleClear, style: styles.clearBtn, hitSlop: 8, children: _jsxs(View, { style: [styles.clearCircle, { backgroundColor: t.colorTextQuaternary }], children: [_jsx(View, { style: [styles.clearX1, { backgroundColor: t.colorTextLightSolid }] }), _jsx(View, { style: [styles.clearX2, { backgroundColor: t.colorTextLightSolid }] })] }) }))] }));
+});
+/** antd Input.TextArea 的对应形态 */
+export const XTextArea = (props) => _jsx(XInput, { multiline: true, ...props });
+XInput.TextArea = XTextArea;
+const styles = StyleSheet.create({
+    container: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        alignSelf: 'stretch',
+    },
+    input: {
+        borderWidth: StyleSheet.hairlineWidth,
+        borderRadius: 8,
+        paddingHorizontal: 12,
+        paddingVertical: 8,
+        fontSize: 15,
+        flex: 1,
+    },
+    textarea: {
+        minHeight: 72,
+        textAlignVertical: 'top',
+        paddingVertical: 10,
+    },
+    clearBtn: {
+        position: 'absolute',
+        right: 8,
+        justifyContent: 'center',
+        alignItems: 'center',
+    },
+    clearCircle: {
+        width: 16,
+        height: 16,
+        borderRadius: 8,
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    clearX1: {
+        position: 'absolute',
+        width: 8,
+        height: 1.5,
+        transform: [{ rotate: '45deg' }],
+    },
+    clearX2: {
+        position: 'absolute',
+        width: 8,
+        height: 1.5,
+        transform: [{ rotate: '-45deg' }],
+    },
+});
+export default XInput;

package/dist/XLicensePlate/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ============================================================================
+ * XLicensePlate —— 车牌号输入（duxui LicensePlate 的 XTheme 重写版）
+ * ============================================================================
+ *
+ * 【与 duxui LicensePlate 的关系】
+ * 保留 duxui 的核心交互：按输入进度切换三套键盘布局
+ *   省份（第 1 位）→ 城市字母（第 2 位）→ 字母+数字（第 3 位起）；
+ * 末位可输入特殊字符（港澳学领警挂）；新能源（8 位）末位仅 D/F。
+ * 差异：duxui 用 PullView + Context 三组件分发，这里整合为两组件：
+ *   - XLicensePlateKeyboard：纯键盘（phase/onInput/onBackspace 受控）；
+ *   - XLicensePlate：输入格 + XPullView 弹出整合体（开箱即用）。
+ * ============================================================================
+ */
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+/** 键盘阶段：省份 → 城市字母 → 字母数字 */
+export type XLicensePlatePhase = 'province' | 'city' | 'alnum';
+export interface XLicensePlateKeyboardProps {
+    phase: XLicensePlatePhase;
+    onInput: (key: string) => void;
+    onBackspace: () => void;
+    /** 限制可选键（新能源末位仅 D/F）；null = 不限制 */
+    allowedKeys?: string[] | null;
+    /** 是否处于末位（普通牌显示特殊字符行） */
+    isLast?: boolean;
+}
+export declare function XLicensePlateKeyboard({ phase, onInput, onBackspace, allowedKeys, isLast }: XLicensePlateKeyboardProps): React.JSX.Element;
+export interface XLicensePlateProps {
+    /** 受控值（如 '京A12345'） */
+    value?: string;
+    onChange?: (value: string) => void;
+    /** 车牌位数：7 普通 / 8 新能源，默认 7 */
+    length?: 7 | 8;
+    disabled?: boolean;
+    placeholder?: string;
+    style?: StyleProp<ViewStyle>;
+}
+export declare function XLicensePlate({ value, onChange, length, disabled, placeholder, style }: XLicensePlateProps): React.JSX.Element;
+export default XLicensePlate;

package/dist/XLicensePlate/index.js

@@ -0,0 +1,172 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XLicensePlate —— 车牌号输入（duxui LicensePlate 的 XTheme 重写版）
+ * ============================================================================
+ *
+ * 【与 duxui LicensePlate 的关系】
+ * 保留 duxui 的核心交互：按输入进度切换三套键盘布局
+ *   省份（第 1 位）→ 城市字母（第 2 位）→ 字母+数字（第 3 位起）；
+ * 末位可输入特殊字符（港澳学领警挂）；新能源（8 位）末位仅 D/F。
+ * 差异：duxui 用 PullView + Context 三组件分发，这里整合为两组件：
+ *   - XLicensePlateKeyboard：纯键盘（phase/onInput/onBackspace 受控）；
+ *   - XLicensePlate：输入格 + XPullView 弹出整合体（开箱即用）。
+ * ============================================================================
+ */
+import { useCallback, useMemo, useState } from 'react';
+import { Pressable, StyleSheet, Text, View } from 'react-native';
+import { XPullView } from '../XPullView';
+import { useXTheme } from '../theme';
+import { useXLocale } from '../XLocale';
+/** 省份简称 + 使领（duxui carCity.json 同款数据） */
+const PROVINCE_ROWS = [
+    ['京', '津', '冀', '晋', '蒙', '辽', '吉'],
+    ['黑', '沪', '苏', '浙', '皖', '闽', '赣'],
+    ['鲁', '豫', '鄂', '湘', '粤', '桂', '琼'],
+    ['川', '贵', '云', '藏', '陕', '甘', '青'],
+    ['宁', '新', '渝', '使', '领'],
+];
+/** 字母表（车牌不含 I / O） */
+const LETTERS = 'ABCDEFGHJKLMNPQRSTUVWXYZ'.split('');
+/** 末位特殊字符（普通牌） */
+const TAIL_SPECIAL = ['港', '澳', '学', '领', '警', '挂'];
+export function XLicensePlateKeyboard({ phase, onInput, onBackspace, allowedKeys, isLast }) {
+    const t = useXTheme();
+    /** 单键 */
+    const renderKey = useCallback((label, flex = 1) => {
+        const disabled = allowedKeys != null && !allowedKeys.includes(label);
+        return (_jsx(Pressable, { disabled: disabled, onPress: () => !disabled && onInput(label), style: ({ pressed }) => [
+                styles.key,
+                { flex, borderRadius: t.borderRadius },
+                { backgroundColor: disabled ? t.colorBgContainerDisabled : pressed ? t.colorBgLayout : t.colorBgContainer },
+            ], children: _jsx(Text, { style: [styles.keyText, { color: disabled ? t.colorTextQuaternary : t.colorText }], allowFontScaling: false, children: label }) }, label));
+    }, [allowedKeys, onInput, t]);
+    /** 退格键 */
+    const backspaceKey = useCallback((flex = 1) => (_jsx(Pressable, { onPress: onBackspace, style: ({ pressed }) => [
+            styles.key,
+            { flex, backgroundColor: pressed ? t.colorBgLayout : t.colorBgContainerDisabled, borderRadius: t.borderRadius },
+        ], children: _jsx(Text, { style: [styles.keyText, { color: t.colorText }], allowFontScaling: false, children: "\u232B" }) }, '__backspace')), [onBackspace, t]);
+    /** 布局：行数组（每行 = [label, flex][]） */
+    const rows = useMemo(() => {
+        if (allowedKeys != null) {
+            // 受限模式（新能源末位 D/F）：单行受限键 + 退格
+            return [allowedKeys.map(k => [k, 1]).concat([['__bs', 1]])];
+        }
+        if (phase === 'province') {
+            return PROVINCE_ROWS.map(row => row.map(k => [k, 1]));
+        }
+        if (phase === 'city') {
+            return [
+                LETTERS.slice(0, 7),
+                LETTERS.slice(7, 14),
+                LETTERS.slice(14, 21),
+                LETTERS.slice(21),
+            ].map(row => row.map(k => [k, 1]));
+        }
+        // alnum：字母 3 行 + XYZ0123 + 456789 + 退格；（普通牌末位追加特殊字符行）
+        const rows = [
+            LETTERS.slice(0, 7).map(k => [k, 1]),
+            LETTERS.slice(7, 14).map(k => [k, 1]),
+            LETTERS.slice(14, 21).map(k => [k, 1]),
+            [...LETTERS.slice(21), '0', '1', '2', '3'].map(k => [k, 1]),
+            [...'456789'.split(''), '__bs'].map(k => [k, 1]),
+        ];
+        if (isLast) {
+            rows.unshift([...TAIL_SPECIAL, '__bs'].map(k => [k, 1]));
+        }
+        return rows;
+    }, [phase, allowedKeys, isLast]);
+    return (_jsx(View, { style: [styles.keyboard, { backgroundColor: t.colorBgLayout }], children: rows.map((row, ri) => (_jsx(View, { style: styles.row, children: row.map(([label, flex]) => label === '__bs' ? backspaceKey(flex) : renderKey(label, flex)) }, ri))) }));
+}
+export function XLicensePlate({ value = '', onChange, length = 7, disabled = false, placeholder, style }) {
+    const t = useXTheme();
+    const { t: i18n } = useXLocale();
+    const [visible, setVisible] = useState(false);
+    /** 当前键盘阶段 */
+    const phase = value.length === 0 ? 'province' : value.length === 1 ? 'city' : 'alnum';
+    /** 是否在末位 */
+    const isLast = value.length === length - 1;
+    /** 新能源末位仅 D/F */
+    const allowedKeys = isLast && length === 8 ? ['D', 'F'] : null;
+    const handleInput = useCallback((key) => {
+        if (value.length >= length)
+            return;
+        const next = value + key;
+        onChange?.(next);
+        // 输满自动收起
+        if (next.length >= length)
+            setVisible(false);
+    }, [value, length, onChange]);
+    const handleBackspace = useCallback(() => {
+        onChange?.(value.slice(0, -1));
+    }, [value, onChange]);
+    /** 输入格渲染 */
+    const cells = Array.from({ length }, (_, i) => {
+        const filled = i < value.length;
+        const active = i === value.length;
+        const isNewEnergyTail = length === 8 && i === 7;
+        return (_jsx(View, { style: [
+                styles.cell,
+                { backgroundColor: t.colorBgContainer, borderColor: t.colorBorder },
+                active && { borderColor: t.colorPrimary, borderWidth: 1.5 },
+                isNewEnergyTail && { borderColor: t.colorSuccess, borderWidth: 1.5 },
+            ], children: filled && (_jsx(Text, { style: [styles.cellText, { color: t.colorText }], allowFontScaling: false, children: value[i] })) }, i));
+    });
+    return (_jsxs(_Fragment, { children: [_jsx(Pressable, { onPress: () => !disabled && setVisible(true), style: [styles.cellRow, style], disabled: disabled, children: cells }), _jsx(XPullView, { visible: visible, onClose: () => setVisible(false), side: 'bottom', overlayOpacity: 0.4, children: _jsxs(View, { style: [styles.panel, { backgroundColor: t.colorBgContainer }], children: [_jsxs(View, { style: [styles.header, { borderBottomColor: t.colorSplit }], children: [_jsx(Text, { style: [styles.headerTitle, { color: t.colorTextSecondary }], allowFontScaling: false, children: length === 8 ? i18n('newEnergyTip') : i18n('platePlaceholder') }), _jsx(Pressable, { onPress: () => setVisible(false), hitSlop: 8, children: _jsx(Text, { style: [styles.doneBtn, { color: t.colorPrimary }], children: i18n('done') }) })] }), _jsx(XLicensePlateKeyboard, { phase: phase, onInput: handleInput, onBackspace: handleBackspace, allowedKeys: allowedKeys, isLast: isLast && length === 7 })] }) })] }));
+}
+const styles = StyleSheet.create({
+    keyboard: {
+        padding: 6,
+        gap: 6,
+    },
+    row: {
+        flexDirection: 'row',
+        gap: 6,
+    },
+    key: {
+        height: 42,
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    keyText: {
+        fontSize: 16,
+        fontWeight: '500',
+    },
+    cellRow: {
+        flexDirection: 'row',
+        gap: 6,
+    },
+    cell: {
+        flex: 1,
+        height: 52,
+        borderWidth: StyleSheet.hairlineWidth,
+        borderRadius: 6,
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    cellText: {
+        fontSize: 18,
+        fontWeight: '600',
+    },
+    panel: {
+        borderTopLeftRadius: 12,
+        borderTopRightRadius: 12,
+        overflow: 'hidden',
+    },
+    header: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        paddingHorizontal: 16,
+        height: 44,
+        borderBottomWidth: StyleSheet.hairlineWidth,
+    },
+    headerTitle: {
+        fontSize: 13,
+    },
+    doneBtn: {
+        fontSize: 15,
+        fontWeight: '600',
+    },
+});
+export default XLicensePlate;

package/dist/XLocale/index.d.ts

@@ -0,0 +1,23 @@
+/** 支持的语言 */
+export type XLocale = 'zh-CN' | 'en-US';
+/** 文案 key（字典的并集，TS 会约束组件里不许写错 key） */
+export type XLocaleKey = 'cancel' | 'confirm' | 'done' | 'close' | 'clear' | 'reset' | 'operationIrreversible' | 'expandSearch' | 'collapseSearch' | 'delete' | 'retry' | 'loading' | 'noData' | 'search' | 'pleaseInput' | 'pleaseInputLabel' | 'pleaseSelect' | 'pleaseSelectLabel' | 'cannotBeEmpty' | 'selectDate' | 'selectTime' | 'selectDateTime' | 'today' | 'weekScopeTip' | 'rewrite' | 'saveChar' | 'savedChars' | 'signHint' | 'undo' | 'tapToRecord' | 'recording' | 'stopRecord' | 'play' | 'pause' | 'rerecord' | 'useRecording' | 'maxDurationTip' | 'micPermissionTip' | 'uploadingPercent' | 'uploadFailed' | 'maxCountTip' | 'platePlaceholder' | 'newEnergyTip' | 'themeMode' | 'language' | 'light' | 'dark' | 'followSystem';
+/** 星期短标签（周一开始，与 XCalendar 默认 weekStartsOn=1 对齐） */
+export declare const X_WEEKDAYS: Record<XLocale, string[]>;
+/** "YYYY年M月" / "September 2026" 的本地化月标题 */
+export declare function xMonthTitle(locale: XLocale, year: number, month1based: number): string;
+/** 全局切换语言（命令式） */
+export declare function setXLocale(locale: XLocale): void;
+/** 读取当前语言（非组件上下文） */
+export declare function getXLocale(): XLocale;
+/**
+ * 组件内使用的翻译 Hook。
+ * t 引用随 locale 变化而更新（useCallback 依赖 locale），组件自然重渲染。
+ */
+export declare function useXLocale(): {
+    locale: XLocale;
+    setLocale: (locale: XLocale) => void;
+    t: (key: XLocaleKey, params?: Record<string, string | number>) => string;
+};
+/** 命令式翻译：Toast / 事件回调等非组件上下文里用（取当前语言一次性求值） */
+export declare function xT(key: XLocaleKey, params?: Record<string, string | number>): string;

package/dist/XLocale/index.js

@@ -0,0 +1,174 @@
+/**
+ * ============================================================================
+ * XLocale —— X-Components 内置轻量国际化（zh-CN / en-US）
+ * ============================================================================
+ *
+ * 【设计取向】
+ * 组件库只需要"组件内文案"的多语言（取消/确定/上传中…），为此引 i18next 这类
+ * 大依赖不值当。这里用 zustand 全局单例 + 双语字典 + 模板插值，几十行搞定：
+ *
+ * - useXLocale()：React 组件内用，返回 {locale, setLocale, t}；
+ * - xT()：命令式场景用（Toast、事件回调等非组件上下文）；
+ * - setXLocale('en-US')：全局切换，所有组件即时更新；
+ * - t('uploadingPercent', {n: 66}) → '上传中 66%' / 'Uploading 66%'。
+ *
+ * 【接入业务层 i18n】
+ * 业务若已有自己的 i18n 体系，可通过 setXLocale 同步业务语言；本模块只负责
+ * X 组件内部文案，不与应用页面文案耦合。
+ * ============================================================================
+ */
+import { useCallback } from 'react';
+import { create } from 'zustand';
+/** zh-CN 字典 */
+const zhCN = {
+    cancel: '取消',
+    confirm: '确定',
+    done: '完成',
+    close: '关闭',
+    clear: '清空',
+    reset: '重置',
+    operationIrreversible: '此操作不可撤销',
+    expandSearch: '展开搜索',
+    collapseSearch: '收起搜索',
+    delete: '删除',
+    retry: '重试',
+    loading: '加载中…',
+    noData: '暂无数据',
+    search: '搜索',
+    pleaseInput: '请输入',
+    pleaseInputLabel: '请输入{n}',
+    pleaseSelect: '请选择',
+    pleaseSelectLabel: '请选择{n}',
+    cannotBeEmpty: '不能为空',
+    selectDate: '请选择日期',
+    selectTime: '请选择时间',
+    selectDateTime: '请选择日期时间',
+    today: '今天',
+    weekScopeTip: '本周',
+    rewrite: '重写',
+    saveChar: '存字',
+    savedChars: '已存 {n} 字',
+    signHint: '请在格内签名',
+    undo: '撤销',
+    tapToRecord: '点击开始录音',
+    recording: '录音中',
+    stopRecord: '停止',
+    play: '播放',
+    pause: '暂停',
+    rerecord: '重新录制',
+    useRecording: '使用录音',
+    maxDurationTip: '最长录制 {n} 秒',
+    micPermissionTip: '需要麦克风权限才能录音',
+    uploadingPercent: '上传中 {n}%',
+    uploadFailed: '上传失败',
+    maxCountTip: '最多选择 {n} 张',
+    platePlaceholder: '点击输入车牌号',
+    newEnergyTip: '新能源',
+    themeMode: '主题模式',
+    language: '语言',
+    light: '浅色',
+    dark: '深色',
+    followSystem: '跟随系统',
+};
+/** en-US 字典 */
+const enUS = {
+    cancel: 'Cancel',
+    confirm: 'OK',
+    done: 'Done',
+    close: 'Close',
+    clear: 'Clear',
+    reset: 'Reset',
+    operationIrreversible: 'This action cannot be undone',
+    expandSearch: 'Expand',
+    collapseSearch: 'Collapse',
+    delete: 'Delete',
+    retry: 'Retry',
+    loading: 'Loading…',
+    noData: 'No data',
+    search: 'Search',
+    pleaseInput: 'Please input',
+    pleaseInputLabel: 'Please input {n}',
+    pleaseSelect: 'Please select',
+    pleaseSelectLabel: 'Please select {n}',
+    cannotBeEmpty: 'cannot be empty',
+    selectDate: 'Select date',
+    selectTime: 'Select time',
+    selectDateTime: 'Select date & time',
+    today: 'Today',
+    weekScopeTip: 'This week',
+    rewrite: 'Redo',
+    saveChar: 'Save',
+    savedChars: '{n} chars saved',
+    signHint: 'Sign inside the box',
+    undo: 'Undo',
+    tapToRecord: 'Tap to record',
+    recording: 'Recording',
+    stopRecord: 'Stop',
+    play: 'Play',
+    pause: 'Pause',
+    rerecord: 'Re-record',
+    useRecording: 'Use',
+    maxDurationTip: 'Max {n}s',
+    micPermissionTip: 'Microphone permission is required',
+    uploadingPercent: 'Uploading {n}%',
+    uploadFailed: 'Upload failed',
+    maxCountTip: 'Up to {n} items',
+    platePlaceholder: 'Tap to enter plate no.',
+    newEnergyTip: 'New Energy',
+    themeMode: 'Theme mode',
+    language: 'Language',
+    light: 'Light',
+    dark: 'Dark',
+    followSystem: 'System',
+};
+const DICTIONARIES = {
+    'zh-CN': zhCN,
+    'en-US': enUS,
+};
+/** 星期短标签（周一开始，与 XCalendar 默认 weekStartsOn=1 对齐） */
+export const X_WEEKDAYS = {
+    'zh-CN': ['一', '二', '三', '四', '五', '六', '日'],
+    'en-US': ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su'],
+};
+/** 英文月份全名（en 标题用；zh 用数字月份拼接） */
+const EN_MONTHS = [
+    'January', 'February', 'March', 'April', 'May', 'June',
+    'July', 'August', 'September', 'October', 'November', 'December',
+];
+/** "YYYY年M月" / "September 2026" 的本地化月标题 */
+export function xMonthTitle(locale, year, month1based) {
+    return locale === 'zh-CN' ? `${year}年${month1based}月` : `${EN_MONTHS[month1based - 1]} ${year}`;
+}
+const useXLocaleStore = create(set => ({
+    locale: 'zh-CN',
+    setLocale: locale => set({ locale }),
+}));
+/** 全局切换语言（命令式） */
+export function setXLocale(locale) {
+    useXLocaleStore.getState().setLocale(locale);
+}
+/** 读取当前语言（非组件上下文） */
+export function getXLocale() {
+    return useXLocaleStore.getState().locale;
+}
+/** 插值：'{n} 张' + {n:3} → '3 张' */
+function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (_, name) => params[name] !== undefined ? String(params[name]) : `{${name}}`);
+}
+/**
+ * 组件内使用的翻译 Hook。
+ * t 引用随 locale 变化而更新（useCallback 依赖 locale），组件自然重渲染。
+ */
+export function useXLocale() {
+    const locale = useXLocaleStore(s => s.locale);
+    const setLocale = useXLocaleStore(s => s.setLocale);
+    const t = useCallback((key, params) => interpolate(DICTIONARIES[locale][key], params), [locale]);
+    return { locale, setLocale, t };
+}
+/** 命令式翻译：Toast / 事件回调等非组件上下文里用（取当前语言一次性求值） */
+export function xT(key, params) {
+    const locale = useXLocaleStore.getState().locale;
+    return interpolate(DICTIONARIES[locale][key], params);
+}

package/dist/XModalForm/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ============================================================================
+ * XModalForm —— 居中弹出表单（duxui XModalForm 移植）
+ * ============================================================================
+ *
+ * 【与底部弹窗的区别】
+ * side='center' 的 XPullView：面板从屏幕中间"放大"出现（scale 0.85→1）
+ * 同时透明度淡入，默认 150ms —— 比底部滑入更轻快，适合确认框/表单这类
+ * 小面积内容（duxui 同款设计）。
+ *
+ * 【表单校验约定】
+ * onSubmit 返回 false（或 Promise<false>）时弹窗不关闭，
+ * 可用来做"校验不通过就不让关"的逻辑。
+ * ============================================================================
+ */
+import React from 'react';
+import { ViewStyle, StyleProp } from 'react-native';
+interface XModalFormProps {
+    visible: boolean;
+    onClose: () => void;
+    title?: string;
+    /** 表单内容（TextInput 等，由调用方自由组合） */
+    children?: React.ReactNode;
+    /** 确认回调，返回 false 时不关闭（可做表单校验） */
+    onSubmit?: () => boolean | void | Promise<boolean | void>;
+    confirmText?: string;
+    cancelText?: string;
+    duration?: number;
+    style?: StyleProp<ViewStyle>;
+}
+export declare function XModalForm({ visible, onClose, title, children, onSubmit, confirmText, cancelText, duration, style, }: XModalFormProps): React.JSX.Element;
+export {};

package/dist/XModalForm/index.js

@@ -0,0 +1,85 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XModalForm —— 居中弹出表单（duxui XModalForm 移植）
+ * ============================================================================
+ *
+ * 【与底部弹窗的区别】
+ * side='center' 的 XPullView：面板从屏幕中间"放大"出现（scale 0.85→1）
+ * 同时透明度淡入，默认 150ms —— 比底部滑入更轻快，适合确认框/表单这类
+ * 小面积内容（duxui 同款设计）。
+ *
+ * 【表单校验约定】
+ * onSubmit 返回 false（或 Promise<false>）时弹窗不关闭，
+ * 可用来做"校验不通过就不让关"的逻辑。
+ * ============================================================================
+ */
+import { useCallback, useMemo } from 'react';
+import { Pressable, StyleSheet, View, ScrollView, Text } from 'react-native';
+import { XPullView } from '../XPullView';
+import { useXTheme } from '../theme';
+import { useXLocale } from '../XLocale';
+export function XModalForm({ visible, onClose, title, children, onSubmit, confirmText, cancelText, duration = 150, style, }) {
+    const t = useXTheme();
+    const { t: i18n } = useXLocale();
+    const resolvedConfirm = confirmText ?? i18n('confirm');
+    const resolvedCancel = cancelText ?? i18n('cancel');
+    /** 点确定：await 校验回调，只有没返回 false 才关闭 */
+    const handleSubmit = useCallback(async () => {
+        const result = await onSubmit?.();
+        if (result !== false) {
+            onClose();
+        }
+    }, [onSubmit, onClose]);
+    const styles = useMemo(() => StyleSheet.create({
+        /** 卡片本体：固定宽度 300、圆角、白底 */
+        card: {
+            width: 300,
+            backgroundColor: t.colorBgContainer,
+            borderRadius: 12,
+            overflow: 'hidden',
+        },
+        header: {
+            paddingHorizontal: 20,
+            paddingTop: 18,
+            paddingBottom: 12,
+        },
+        title: {
+            fontSize: 17,
+            fontWeight: '600',
+            textAlign: 'center',
+        },
+        body: {
+            maxHeight: 320,
+            paddingHorizontal: 20,
+            paddingVertical: 8,
+        },
+        footer: {
+            flexDirection: 'row',
+            borderTopWidth: StyleSheet.hairlineWidth,
+            borderTopColor: t.colorSplit,
+        },
+        footerBtn: {
+            flex: 1,
+            height: 48,
+            justifyContent: 'center',
+            alignItems: 'center',
+        },
+        cancelBtn: {},
+        submitBtn: {
+            borderLeftWidth: StyleSheet.hairlineWidth,
+            borderLeftColor: t.colorSplit,
+        },
+        pressed: {
+            backgroundColor: t.colorBgLayout,
+        },
+        cancelText: {
+            fontSize: 16,
+        },
+        submitText: {
+            fontSize: 16,
+            fontWeight: '600',
+        },
+    }), [t]);
+    return (_jsx(XPullView, { visible: visible, onClose: onClose, side: 'center', duration: duration, overlayOpacity: 0.25, children: _jsxs(View, { style: [styles.card, style], children: [!!title && (_jsx(View, { style: styles.header, children: _jsx(Text, { style: [styles.title, { color: t.colorText }], children: title }) })), _jsx(ScrollView, { style: styles.body, keyboardShouldPersistTaps: 'handled', children: children }), _jsxs(View, { style: styles.footer, children: [_jsx(Pressable, { onPress: onClose, style: ({ pressed }) => [styles.footerBtn, styles.cancelBtn, pressed && styles.pressed], children: _jsx(Text, { style: [styles.cancelText, { color: t.colorTextSecondary }], children: resolvedCancel }) }), _jsx(Pressable, { onPress: handleSubmit, style: ({ pressed }) => [styles.footerBtn, styles.submitBtn, pressed && styles.pressed], children: _jsx(Text, { style: [styles.submitText, { color: t.colorPrimary }], children: resolvedConfirm }) })] })] }) }));
+}