react-native-x-components 0.1.0

package/dist/XUpload/provider.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XUpload Provider —— 上传适配器的注入/获取
+ * ============================================================================
+ *
+ * 【两级注入】
+ * 1. 全局默认：setXUploadAdapter(adapter)（App 启动时注入 MinIO/业务适配器）；
+ * 2. 局部覆盖：<XUploadProvider adapter={...}>（子树内所有上传组件生效），
+ *    没有时回退全局默认；连全局也没注入时兜底 Mock 并 warn 一次。
+ * ============================================================================
+ */
+import { createContext, useContext, useMemo } from 'react';
+import { createMinioPresignedAdapter, createMockUploadAdapter } from './adapters';
+/** 全局默认适配器（初始为 Mock，避免演示页崩溃） */
+let globalAdapter = createMockUploadAdapter();
+let warnedNoAdapter = false;
+/** 注入全局默认适配器（App 启动时调用一次） */
+export function setXUploadAdapter(adapter) {
+    globalAdapter = adapter;
+}
+/** 获取全局默认适配器 */
+export function getXUploadAdapter() {
+    return globalAdapter;
+}
+const XUploadContext = createContext(null);
+export function XUploadProvider({ adapter, children }) {
+    const value = useMemo(() => adapter, [adapter]);
+    return _jsx(XUploadContext.Provider, { value: value, children: children });
+}
+/** 上传组件内部取适配器：局部 > 全局 > Mock(仅首次 warn) */
+export function useXUploadAdapter(localAdapter) {
+    const contextAdapter = useContext(XUploadContext);
+    const resolved = localAdapter ?? contextAdapter ?? globalAdapter;
+    if (!localAdapter && !contextAdapter && !warnedNoAdapter) {
+        warnedNoAdapter = true;
+        console.warn('[XUpload] 未注入上传适配器，当前使用 Mock 上传（结果不会真正上传）。' +
+            '请在 App 入口调用 setXUploadAdapter(createMinioPresignedAdapter({...})) 或使用 <XUploadProvider>。');
+    }
+    return resolved;
+}
+/** 便捷构造：MinIO 预签名适配器（re-export） */
+export const createMinioAdapter = createMinioPresignedAdapter;

package/dist/XUpload/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * XUpload 类型定义 —— 上传文件 / 上传结果 / 适配器协议
+ */
+/** 待上传文件（本机） */
+export interface XUploadFile {
+    /** 本地地址 file://... */
+    uri: string;
+    /** 文件名（含扩展名） */
+    name: string;
+    /** MIME 类型 */
+    mimeType: string;
+    /** 字节数（可选） */
+    size?: number;
+}
+/** 上传结果：MinIO/OSS 模式带 objectKey；直传模式带 url */
+export interface XUploadResult {
+    /** 可预览的地址（直链/预签名回显/本机地址） */
+    url?: string;
+    /** 对象 key（预签名模式核心字段，回显时再换预签名 URL） */
+    objectKey?: string;
+    /** 透传后端返回的其余字段 */
+    [key: string]: any;
+}
+/**
+ * 上传适配器协议 —— UI 与上传逻辑的唯一边界。
+ * 业务实现一个 upload 即可接入任意后端（MinIO 预签名 / 直传 / 七牛...）。
+ */
+export interface XUploadAdapter {
+    /** 上传一个文件；onProgress 回传 0~100 */
+    upload: (file: XUploadFile, onProgress?: (percent: number) => void) => Promise<XUploadResult>;
+}

package/dist/XUpload/types.js

@@ -0,0 +1,4 @@
+/**
+ * XUpload 类型定义 —— 上传文件 / 上传结果 / 适配器协议
+ */
+export {};

package/dist/XWheel/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ============================================================================
+ * XWheel -- 通用滚轮列（antd-mobile picker-view/wheel.tsx 架构的 RN 移植）
+ * ============================================================================
+ *
+ * 【被 XPickerDate（多列日期）与 XPicker（单列选项）共用】
+ *
+ * 架构（antd 的核心，丝滑的全部秘密）：
+ * - 没有 ScrollView。"一个手势 + 一个平移值"：Gesture.Pan 驱动单个 y 共享值，
+ *   整个行容器只是一个 View 整体 translateY。滚动中每帧只有 1 个 transform
+ *   更新，零逐行计算、零 JS 参与。
+ * - 所有行视觉完全一致（无逐行高亮）。选中表现完全来自遮罩层：
+ *   上下渐变把远处行淡出到背景色 + 中间两条 1px 框线。
+ * - 拖拽中越界走橡皮筋（rubberbandIfOutOfBounds，antd 原公式）；
+ *   松手按"位置 + 速度投影"夹边界取整到行，withSpring 落位，
+ *   同时立即上报选中（不等动画结束，antd 行为）。
+ * ============================================================================
+ */
+import React from 'react';
+/** 滚轮选项：label 显示文本，value 回传值 */
+export interface XWheelOption<T = any> {
+    label: string;
+    value: T;
+}
+/** 父组件在"确定"时通过 ref 强制结算的句柄 */
+export interface XWheelHandle {
+    /**
+     * 按当前视觉位置返回选项（拖拽/spring 进行中也能拿到正确值）。
+     * antd 确认的是"看到的"值，不是"上次落位的"。
+     */
+    flush: () => XWheelOption | undefined;
+}
+interface XWheelProps {
+    /** 选项列表（顺序即列内顺序） */
+    items: XWheelOption[];
+    /** 当前选中值（受控，父组件传；不在列表中时夹到最近边界） */
+    value?: any;
+    /** 选中上报（松手/点选时触发；antd 的 onSelect） */
+    onSelect: (value: any) => void;
+}
+/**
+ * XWheel -- 单列滚轮。
+ *
+ * 唯一的动态值是 y（0 = 第一项停在选中位，负值向上滚）。
+ * 每帧只发生一件事：y 变化 -> 一个 useAnimatedStyle 重新求值 ->
+ * 容器整体 translateY。所有行是纯静态 View，滚动中零重渲染、零重绘。
+ */
+export declare const XWheel: React.NamedExoticComponent<XWheelProps & React.RefAttributes<XWheelHandle>>;
+export {};

package/dist/XWheel/index.js

@@ -0,0 +1,263 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XWheel -- 通用滚轮列（antd-mobile picker-view/wheel.tsx 架构的 RN 移植）
+ * ============================================================================
+ *
+ * 【被 XPickerDate（多列日期）与 XPicker（单列选项）共用】
+ *
+ * 架构（antd 的核心，丝滑的全部秘密）：
+ * - 没有 ScrollView。"一个手势 + 一个平移值"：Gesture.Pan 驱动单个 y 共享值，
+ *   整个行容器只是一个 View 整体 translateY。滚动中每帧只有 1 个 transform
+ *   更新，零逐行计算、零 JS 参与。
+ * - 所有行视觉完全一致（无逐行高亮）。选中表现完全来自遮罩层：
+ *   上下渐变把远处行淡出到背景色 + 中间两条 1px 框线。
+ * - 拖拽中越界走橡皮筋（rubberbandIfOutOfBounds，antd 原公式）；
+ *   松手按"位置 + 速度投影"夹边界取整到行，withSpring 落位，
+ *   同时立即上报选中（不等动画结束，antd 行为）。
+ * ============================================================================
+ */
+import React, { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useRef } from 'react';
+import { Pressable, StyleSheet, View, Text } from 'react-native';
+import Animated, { runOnJS, useAnimatedStyle, useSharedValue, withSpring } from 'react-native-reanimated';
+import { Gesture, GestureDetector } from 'react-native-gesture-handler';
+import LinearGradient from 'react-native-linear-gradient';
+import { useXTheme } from '../theme';
+/** 每行高度（antd: --item-height 34px） */
+const ITEM_HEIGHT = 34;
+/** 列可视高度（antd: --height 240px，约 7 行） */
+const VISIBLE_HEIGHT = 240;
+/** 把 #rrggbb 转成带透明度的 rgba（遮罩渐变用，避免写死白色背景） */
+const hexToRgba = (hex, alpha) => {
+    const h = hex.replace('#', '');
+    const r = parseInt(h.slice(0, 2), 16);
+    const g = parseInt(h.slice(2, 4), 16);
+    const b = parseInt(h.slice(4, 6), 16);
+    return `rgba(${r}, ${g}, ${b}, ${alpha})`;
+};
+/**
+ * 弹簧参数（antd: react-spring tension 400 / mass 0.8，换算到 Reanimated）。
+ * damping 50 ≈ 轻微过阻尼，落位干脆利落，与 antd 观感一致。
+ */
+const SPRING_CONFIG = { mass: 0.8, stiffness: 400, damping: 50 };
+/**
+ * 松手动量投影系数。antd: 位置 + velocity(px/ms) * 50；RNGH velocity 是
+ * px/s，等价换算为 velocity * 0.05（50ms 的动量投影，保守、不飘）。
+ */
+const VELOCITY_PROJECTION = 0.05;
+/** 橡皮筋参数（antd 原值：dimension = itemHeight*50, constant 0.2） */
+const RUBBERBAND_EXTENT_FACTOR = 50;
+const RUBBERBAND_CONSTANT = 0.2;
+/** 手势激活阈值：垂直位移超过它才算拖拽，小于它视为点击（行内 Pressable 接管） */
+const PAN_ACTIVE_OFFSET = 6;
+/* ------------------------------------------------------------------ *
+ * antd utils/bound.ts 与 utils/rubberband.ts 的逐行移植               *
+ * ------------------------------------------------------------------ */
+const bound = (position, min, max) => {
+    'worklet';
+    return Math.min(Math.max(position, min), max);
+};
+const rubberband = (distance, dimension, constant) => {
+    'worklet';
+    return (distance * dimension * constant) / (dimension + constant * distance);
+};
+/**
+ * 越界橡皮筋（antd 原公式）：越界后阻力随距离增大，拖不出"一屏"。
+ * dimension = itemHeight * 50, constant = 0.2 与 antd 完全一致。
+ * 注意：被手势 worklet 调用，自身必须是 worklet（'worklet' 指令不可省）。
+ */
+const rubberbandIfOutOfBounds = (position, min, max, dimension) => {
+    'worklet';
+    const c = RUBBERBAND_CONSTANT;
+    if (position < min) {
+        return -rubberband(min - position, dimension, c) + min;
+    }
+    if (position > max) {
+        return +rubberband(position - max, dimension, c) + max;
+    }
+    return position;
+};
+/**
+ * 把 value 换算成索引。
+ * 若 value 不在 items 里（如切到 2 月后，天列只剩 1~28，而 value 还是 31），
+ * 则夹到最近的边界：大于最大值 -> 最后一项，否则 -> 第一项。
+ */
+const clampIndex = (items, value) => {
+    let index = items.findIndex(item => item.value === value);
+    if (index === -1) {
+        index = items.length ? (value > items[items.length - 1].value ? items.length - 1 : 0) : 0;
+    }
+    return Math.max(0, index);
+};
+/**
+ * XWheel -- 单列滚轮。
+ *
+ * 唯一的动态值是 y（0 = 第一项停在选中位，负值向上滚）。
+ * 每帧只发生一件事：y 变化 -> 一个 useAnimatedStyle 重新求值 ->
+ * 容器整体 translateY。所有行是纯静态 View，滚动中零重渲染、零重绘。
+ */
+export const XWheel = React.memo(forwardRef(function XWheel({ items, value, onSelect }, ref) {
+    const t = useXTheme();
+    /** 受控 value 对应的目标索引 */
+    const targetIndex = clampIndex(items, value);
+    const listRef = useRef(items);
+    listRef.current = items;
+    const onSelectRef = useRef(onSelect);
+    onSelectRef.current = onSelect;
+    /** 滚轮位置（antd 的 y）：0 ~ -(n-1)*ITEM_HEIGHT，负值向上 */
+    const y = useSharedValue(-targetIndex * ITEM_HEIGHT);
+    /** 拖拽进行中（同步受控更新用；antd 的 draggingRef） */
+    const isDragging = useSharedValue(false);
+    /** 手势起始时的 y（onUpdate 里从它累加 translationY） */
+    const startY = useSharedValue(0);
+    /** 最后已上报的值：去重，切断"上报 -> 父更新 -> 再同步"循环 */
+    const lastSynced = useSharedValue(value);
+    /** JS 侧选中上报（stable，供 worklet runOnJS 调用；antd 的 onSelect） */
+    const select = useCallback((v) => {
+        if (v !== undefined && v !== lastSynced.value) {
+            lastSynced.value = v;
+            onSelectRef.current?.(v);
+        }
+    }, [lastSynced]);
+    /** 滚到某行（antd 的 scrollSelect：spring 动画 + 立即选中） */
+    const scrollSelect = useCallback((index) => {
+        const list = listRef.current;
+        const i = Math.min(Math.max(index, 0), Math.max(list.length - 1, 0));
+        y.value = withSpring(-i * ITEM_HEIGHT, SPRING_CONFIG);
+        select(list[i]?.value);
+    }, [y, select]);
+    /**
+     * 手势（antd 的 useDrag + rubberband）。
+     * deps=[items]：数据变化（如天列 31->28）时重建闭包，min 实时正确 --
+     * 拖着列时外部数据变化，松手自动被新边界夹取。
+     */
+    const pan = useMemo(() => Gesture.Pan()
+        // 垂直位移超过阈值才算拖滚轮；更小的位移留给行内 Pressable（点选）
+        .activeOffsetY([-PAN_ACTIVE_OFFSET, PAN_ACTIVE_OFFSET])
+        .onStart(() => {
+        'worklet';
+        isDragging.value = true;
+        startY.value = y.value;
+    })
+        .onUpdate(e => {
+        'worklet';
+        if (!items.length) {
+            return;
+        }
+        const min = -((items.length - 1) * ITEM_HEIGHT);
+        y.value = rubberbandIfOutOfBounds(startY.value + e.translationY, min, 0, ITEM_HEIGHT * RUBBERBAND_EXTENT_FACTOR);
+    })
+        .onEnd(e => {
+        'worklet';
+        isDragging.value = false;
+        if (!items.length) {
+            return;
+        }
+        const min = -((items.length - 1) * ITEM_HEIGHT);
+        // antd：位置 + 动量投影 -> 夹边界 -> 取整到行
+        const projected = y.value + e.velocityY * VELOCITY_PROJECTION;
+        const bounded = bound(projected, min, 0);
+        const target = -Math.round(bounded / ITEM_HEIGHT);
+        y.value = withSpring(-target * ITEM_HEIGHT, SPRING_CONFIG);
+        // 去重统一在 select 内部（不在此预写 lastSynced，
+        // 否则双重去重互相打架导致选中永远上报不出去）
+        const v = items[target]?.value;
+        if (v !== undefined) {
+            runOnJS(select)(v);
+        }
+    })
+        // 手势被打断（如弹层关闭）：只复位拖拽标记，位置交给受控同步
+        .onFinalize(() => {
+        'worklet';
+        isDragging.value = false;
+    }), [items, isDragging, startY, y, lastSynced, select]);
+    /**
+     * 受控同步（antd 的 useIsomorphicLayoutEffect）：
+     * 外部 value / 数据源变化时对齐。拖拽中坚决不动 y（antd 同款防护）。
+     */
+    useEffect(() => {
+        lastSynced.value = value;
+        if (isDragging.value) {
+            return;
+        }
+        y.value = withSpring(-targetIndex * ITEM_HEIGHT, SPRING_CONFIG);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [targetIndex, items]);
+    /**
+     * flush：确定按钮按下时按当前视觉位置取选项。
+     * 拖拽/spring 进行中拿到的也是"看到的"值（antd 行为）。
+     */
+    useImperativeHandle(ref, () => ({
+        flush: () => {
+            const list = listRef.current;
+            const index = Math.min(Math.max(-Math.round(y.value / ITEM_HEIGHT), 0), Math.max(list.length - 1, 0));
+            return list[index];
+        },
+    }), []);
+    /** 整个行容器唯一的动画样式：每帧只重求值这一个 */
+    const wheelStyle = useAnimatedStyle(() => ({
+        transform: [{ translateY: y.value }],
+    }));
+    /** 点某一行：滚到它并直接选中（antd 的 handleClick -> scrollSelect） */
+    const handlePressItem = useCallback((index) => {
+        if (isDragging.value) {
+            return;
+        }
+        scrollSelect(index);
+    }, [isDragging, scrollSelect]);
+    return (_jsxs(View, { style: styles.column, children: [_jsx(GestureDetector, { gesture: pan, children: _jsx(View, { style: StyleSheet.absoluteFill, children: _jsx(Animated.View, { style: [styles.wheel, wheelStyle], children: items.map((item, index) => (_jsx(Pressable, { onPress: () => handlePressItem(index), style: styles.item, children: _jsx(Text, { allowFontScaling: false, style: [styles.itemText, { color: t.colorText }], children: item.label }) }, String(item.value)))) }) }) }), _jsx(LinearGradient, { colors: [t.colorBgContainer, hexToRgba(t.colorBgContainer, 0.6)], start: { x: 0, y: 0 }, end: { x: 0, y: 1 }, pointerEvents: 'none', style: styles.maskTop }), _jsx(LinearGradient, { colors: [hexToRgba(t.colorBgContainer, 0.6), t.colorBgContainer], start: { x: 0, y: 0 }, end: { x: 0, y: 1 }, pointerEvents: 'none', style: styles.maskBottom }), _jsx(View, { pointerEvents: 'none', style: [styles.maskMiddle, { borderColor: t.colorSplit }] })] }));
+}));
+const styles = StyleSheet.create({
+    /** 单列：240 高，相对定位，遮罩绝对定位盖在上面 */
+    column: {
+        height: VISIBLE_HEIGHT,
+        flex: 1,
+        overflow: 'hidden',
+        position: 'relative',
+    },
+    /**
+     * 行容器（antd 的 column-wheel）：绝对定位在垂直中点，
+     * 唯一的动画是整体 translateY（y 为负值时向上滚）。
+     */
+    wheel: {
+        position: 'absolute',
+        top: (VISIBLE_HEIGHT - ITEM_HEIGHT) / 2,
+        left: 0,
+        right: 0,
+    },
+    /** 单行：纯静态样式（antd 的 column-item，高度 34、字色统一、无任何动画） */
+    item: {
+        height: ITEM_HEIGHT,
+        justifyContent: 'center',
+        alignItems: 'center',
+    },
+    itemText: {
+        fontSize: 16,
+    },
+    /** 上遮罩：远端全背景色 -> 靠中间半透明（antd mask-top 的渐变） */
+    maskTop: {
+        position: 'absolute',
+        top: 0,
+        left: 0,
+        right: 0,
+        height: (VISIBLE_HEIGHT - ITEM_HEIGHT) / 2,
+    },
+    /** 下遮罩：靠中间半透明 -> 远端全背景色（antd mask-bottom 的渐变） */
+    maskBottom: {
+        position: 'absolute',
+        bottom: 0,
+        left: 0,
+        right: 0,
+        height: (VISIBLE_HEIGHT - ITEM_HEIGHT) / 2,
+    },
+    /** 中间选中框：两条 1px 边框（antd mask-middle），背景透明不遮行 */
+    maskMiddle: {
+        position: 'absolute',
+        top: (VISIBLE_HEIGHT - ITEM_HEIGHT) / 2,
+        left: 0,
+        right: 0,
+        height: ITEM_HEIGHT,
+        borderTopWidth: StyleSheet.hairlineWidth,
+        borderBottomWidth: StyleSheet.hairlineWidth,
+    },
+});

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ============================================================================
+ * X-Components 统一出口（barrel）
+ * ============================================================================
+ *
+ * 所有 X 打头组件从这里导入：
+ * import {XButton, XForm, XRadio, XCheckbox, XProgress, XDivider} from '@/components/X-Components';
+ * import {XActionSheet, XPicker, XPickerDate, XConfirmForm, confirm} from '@/components/X-Components';
+ *
+ * 也可以从子目录直接导入具体组件。
+ *
+ * 【弹窗族组件关系图】（原 DuxPopup 整体迁入，组件名加 X 前缀）
+ *                          XPopupProvider（App 根部）
+ *                           ├── XConfirmForm（命令式确认框实例）
+ *                           └── XTopView（全局宿主：画所有弹层）
+ *                                     │
+ *                 useXTopViewStore（zustand：add/update/remove）
+ *                                     │
+ *                         ┌───────────┴───────────┐
+ *                         │                       │
+ *                     XPullView               XAnimatedView（通用动画引擎）
+ *                  （通用弹出层，核心）         anim() 链式构建器
+ *                         │
+ *         ┌───────────────┼────────────────┐
+ *         │               │                │
+ *    XActionSheet      XPicker        XPickerDate
+ *    （底部菜单）    （单列滚轮）   （日期时间滚轮，format 定列）
+ *                         │                │
+ *                         └───────┬────────┘
+ *                                 │
+ *                             XWheel（通用滚轮列）
+ *         │
+ *     XModalForm（居中弹层：确认/表单）
+ *         │
+ *     XConfirmForm（命令式封装：show() → Promise<boolean>）
+ *
+ * 【学习路径建议】
+ * 1. 先读 XPullView —— 整套架构的核心（TopView 挂载 + 入场/离场动画）；
+ * 2. 再读 XTopViewStore / XTopView —— 全局宿主的原理；
+ * 3. 然后读 XActionSheet / XPicker / XModalForm —— 学会"组合复用"XPullView；
+ * 4. 最后读 XConfirmForm —— 命令式 API（Promise）的实现套路。
+ * ============================================================================
+ */
+export { default as XButton } from './XButton';
+export type { XButtonProps, XButtonType, XButtonSize, XButtonShape } from './XButton';
+export { default as XDivider } from './XDivider';
+export type { XDividerProps } from './XDivider';
+export { default as XInput, XTextArea } from './XInput';
+export type { XInputProps } from './XInput';
+export { XImage } from './XImage';
+export type { ImageWithLoaderProps as XImageProps } from './XImage';
+export { default as XRadio } from './XRadio';
+export type { XRadioProps, XRadioGroupProps, XRadioButtonProps, XRadioChangeEvent } from './XRadio';
+export { default as XCheckbox } from './XCheckbox';
+export type { XCheckboxProps, XCheckboxGroupProps, XCheckboxChangeEvent } from './XCheckbox';
+export { default as XProgress } from './XProgress';
+export type { XProgressProps } from './XProgress';
+export { default as XTag } from './XTag';
+export type { XTagProps, XTagType, XTagSize, XTagVariant } from './XTag';
+export { default as XForm, useForm as XFormUseForm } from './XForm';
+export type { XFormProps, XFormItemProps, XRule, XRuleObject, XNamePath, XFormInstance, XErrorEntity, XFieldData, XValidateErrorEntity, XValidateTrigger } from './XForm';
+export { default as XCascadeSelect } from './XCascadeSelect';
+export type { XCascadeSelectProps, XCascadeOption } from './XCascadeSelect';
+export { default as XMultiSelect } from './XMultiSelect';
+export type { XMultiSelectProps } from './XMultiSelect';
+export { default as XFormPro } from './XFormPro';
+export { registerXFormProRenderer } from './XFormPro';
+export type { XFormModelValue, XOptionItem, XFormProRule, XBaseFormItemProps, XFormProItemProps, XFormItemOptions, XFormProProps, XFormProInst, XFm, XFormProCustomRenderer, } from './XFormPro';
+export { default as XAnimatedSearchPanel } from './XAnimatedSearchPanel';
+export type { XAnimatedSearchPanelProps } from './XAnimatedSearchPanel';
+export * from './XAnimatedView';
+export * from './XPullView';
+export * from './XTopView';
+export * from './XTopViewStore';
+export * from './XActionSheet';
+export * from './XWheel';
+export * from './XPicker';
+export * from './XPickerDate';
+export * from './XModalForm';
+export * from './XConfirmForm';
+export * from './XPopupProvider';
+export { XLoadingModal, XLoadingModalProvider, XLoadingModalService, XImagePreview, XImagePreviewProvider, XImagePreviewService, XToastProvider, XToastService, useXToast, } from './XProviders';
+export type { XLoadingModalProps, XLoadingModalConfig, XImagePreviewParams, XToastOptions, XToastType, XToastPosition } from './XProviders';
+export { xTheme } from './theme';
+export { lightTokens, darkTokens, setXThemeMode, getXThemeMode, useXThemeMode, useXTheme, useXThemeScheme } from './theme';
+export type { XTheme, XThemeMode, XThemeScheme } from './theme';
+export { useXLocale, setXLocale, getXLocale, xT, xMonthTitle, X_WEEKDAYS } from './XLocale';
+export type { XLocale, XLocaleKey } from './XLocale';
+export { XCarousel } from './XCarousel';
+export type { XCarouselProps, XCarouselItem } from './XCarousel';
+export { XTabs, XTabPane } from './XTabs';
+export type { XTabsProps, XTabPaneProps } from './XTabs';
+export { XElevator } from './XElevator';
+export type { XElevatorProps, XElevatorSection } from './XElevator';
+export { default as XDropdownMenu, XDropdownMenuItem } from './XDropdownMenu';
+export type { XDropdownMenuProps, XDropdownMenuItemProps, XMenuOption } from './XDropdownMenu';
+export { XCalendar } from './XCalendar';
+export type { XCalendarProps, XCalendarMode, XCalendarValue } from './XCalendar';
+export { XCalendarPopup } from './XCalendar/XCalendarPopup';
+export type { XCalendarPopupProps } from './XCalendar/XCalendarPopup';
+export { XRecord } from './XRecord';
+export type { XRecordProps, XRecordValue } from './XRecord';
+export { XNumberKeyboard, XNumberKeyboardPopup } from './XNumberKeyboard';
+export type { XNumberKeyboardProps, XNumberKeyboardPopupProps } from './XNumberKeyboard';
+export { default as XLicensePlate, XLicensePlateKeyboard } from './XLicensePlate';
+export type { XLicensePlateProps, XLicensePlateKeyboardProps, XLicensePlatePhase } from './XLicensePlate';
+export { XLineChart, XBarChart, XPieChart } from './XChart';
+export type { XLineChartProps, XBarChartProps, XBarChartItem, XPieChartProps, XPieChartItem } from './XChart';
+export { XSignature } from './XSignature';
+export type { XSignatureProps } from './XSignature';
+export { XSignatureSkia } from './XSignature/XSignatureSkia';
+export type { XSignatureSkiaProps, XSignatureSkiaValue, XSignatureCharacter, XSignatureStroke, } from './XSignature/XSignatureSkia';
+export * from './XUpload';

package/dist/index.js

@@ -0,0 +1,127 @@
+/**
+ * ============================================================================
+ * X-Components 统一出口（barrel）
+ * ============================================================================
+ *
+ * 所有 X 打头组件从这里导入：
+ * import {XButton, XForm, XRadio, XCheckbox, XProgress, XDivider} from '@/components/X-Components';
+ * import {XActionSheet, XPicker, XPickerDate, XConfirmForm, confirm} from '@/components/X-Components';
+ *
+ * 也可以从子目录直接导入具体组件。
+ *
+ * 【弹窗族组件关系图】（原 DuxPopup 整体迁入，组件名加 X 前缀）
+ *                          XPopupProvider（App 根部）
+ *                           ├── XConfirmForm（命令式确认框实例）
+ *                           └── XTopView（全局宿主：画所有弹层）
+ *                                     │
+ *                 useXTopViewStore（zustand：add/update/remove）
+ *                                     │
+ *                         ┌───────────┴───────────┐
+ *                         │                       │
+ *                     XPullView               XAnimatedView（通用动画引擎）
+ *                  （通用弹出层，核心）         anim() 链式构建器
+ *                         │
+ *         ┌───────────────┼────────────────┐
+ *         │               │                │
+ *    XActionSheet      XPicker        XPickerDate
+ *    （底部菜单）    （单列滚轮）   （日期时间滚轮，format 定列）
+ *                         │                │
+ *                         └───────┬────────┘
+ *                                 │
+ *                             XWheel（通用滚轮列）
+ *         │
+ *     XModalForm（居中弹层：确认/表单）
+ *         │
+ *     XConfirmForm（命令式封装：show() → Promise<boolean>）
+ *
+ * 【学习路径建议】
+ * 1. 先读 XPullView —— 整套架构的核心（TopView 挂载 + 入场/离场动画）；
+ * 2. 再读 XTopViewStore / XTopView —— 全局宿主的原理；
+ * 3. 然后读 XActionSheet / XPicker / XModalForm —— 学会"组合复用"XPullView；
+ * 4. 最后读 XConfirmForm —— 命令式 API（Promise）的实现套路。
+ * ============================================================================
+ */
+// ---------------------------------------------------------------------------
+// 基础组件（对标 antd）
+// ---------------------------------------------------------------------------
+export { default as XButton } from './XButton';
+export { default as XDivider } from './XDivider';
+export { default as XInput, XTextArea } from './XInput';
+export { XImage } from './XImage';
+export { default as XRadio } from './XRadio';
+export { default as XCheckbox } from './XCheckbox';
+export { default as XProgress } from './XProgress';
+export { default as XTag } from './XTag';
+export { default as XForm, useForm as XFormUseForm } from './XForm';
+export { default as XCascadeSelect } from './XCascadeSelect';
+export { default as XMultiSelect } from './XMultiSelect';
+export { default as XFormPro } from './XFormPro';
+export { registerXFormProRenderer } from './XFormPro';
+// ---------------------------------------------------------------------------
+// 复合组件（列表头折叠搜索面板，原 components/AnimatedSearchPanel 迁入）
+// ---------------------------------------------------------------------------
+export { default as XAnimatedSearchPanel } from './XAnimatedSearchPanel';
+// ---------------------------------------------------------------------------
+// 弹窗族（原 DuxPopup 迁入）
+// ---------------------------------------------------------------------------
+export * from './XAnimatedView';
+export * from './XPullView';
+export * from './XTopView';
+export * from './XTopViewStore';
+export * from './XActionSheet';
+export * from './XWheel';
+export * from './XPicker';
+export * from './XPickerDate';
+export * from './XModalForm';
+export * from './XConfirmForm';
+export * from './XPopupProvider';
+// ---------------------------------------------------------------------------
+// 命令式全局组件（Provider 类：Loading / 图片预览 / Toast，见 XProviders/usageExample.tsx）
+// ---------------------------------------------------------------------------
+export { XLoadingModal, XLoadingModalProvider, XLoadingModalService, XImagePreview, XImagePreviewProvider, XImagePreviewService, XToastProvider, XToastService, useXToast, } from './XProviders';
+export { xTheme } from './theme';
+export { lightTokens, darkTokens, setXThemeMode, getXThemeMode, useXThemeMode, useXTheme, useXThemeScheme } from './theme';
+// ---------------------------------------------------------------------------
+// 国际化（中英）
+// ---------------------------------------------------------------------------
+export { useXLocale, setXLocale, getXLocale, xT, xMonthTitle, X_WEEKDAYS } from './XLocale';
+// ---------------------------------------------------------------------------
+// 轮播图 / 选项卡 / 电梯楼层
+// ---------------------------------------------------------------------------
+export { XCarousel } from './XCarousel';
+export { XTabs, XTabPane } from './XTabs';
+export { XElevator } from './XElevator';
+// ---------------------------------------------------------------------------
+// 下拉菜单
+// ---------------------------------------------------------------------------
+export { default as XDropdownMenu, XDropdownMenuItem } from './XDropdownMenu';
+// ---------------------------------------------------------------------------
+// 日历 / 弹窗日历
+// ---------------------------------------------------------------------------
+export { XCalendar } from './XCalendar';
+export { XCalendarPopup } from './XCalendar/XCalendarPopup';
+// ---------------------------------------------------------------------------
+// 录音
+// ---------------------------------------------------------------------------
+export { XRecord } from './XRecord';
+// ---------------------------------------------------------------------------
+// 数字键盘（含弹出模式）
+// ---------------------------------------------------------------------------
+export { XNumberKeyboard, XNumberKeyboardPopup } from './XNumberKeyboard';
+// ---------------------------------------------------------------------------
+// 车牌号输入
+// ---------------------------------------------------------------------------
+export { default as XLicensePlate, XLicensePlateKeyboard } from './XLicensePlate';
+// ---------------------------------------------------------------------------
+// 图表（SVG 轻量三件套）
+// ---------------------------------------------------------------------------
+export { XLineChart, XBarChart, XPieChart } from './XChart';
+// ---------------------------------------------------------------------------
+// 签名（普通 + Skia 逐字）
+// ---------------------------------------------------------------------------
+export { XSignature } from './XSignature';
+export { XSignatureSkia } from './XSignature/XSignatureSkia';
+// ---------------------------------------------------------------------------
+// 上传（适配器模式：普通 multipart + MinIO 预签名直传）
+// ---------------------------------------------------------------------------
+export * from './XUpload';