react-native-x-components 0.1.0

package/dist/XAnimatedView/index.js

@@ -0,0 +1,227 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XAnimatedView —— 通用动画视图（duxapp Animated.View 的 RN 移植版）
+ * ============================================================================
+ *
+ * 【它是干什么的？】
+ * XPullView 内部直接用了 useSharedValue + withTiming 写动画；而这里提供的
+ * XAnimatedView + anim() 是更通用的"动画引擎"，可以给任意自定义组件用，
+ * 用法和 duxapp 的 Animated.create() 完全一致（链式声明多段动画）。
+ *
+ * 【动画声明格式】
+ *   anim(200, 'ease-out')        // 默认时长 200ms、缓动 ease-out
+ *     .translateY(300)           // 第 1 步：Y 移到 300（屏外）
+ *     .opacity(0)                //        同时透明
+ *     .step()                    // 把上面这两个"动作"打包成一段
+ *     .translateY(0)             // 第 2 步：Y 移回 0
+ *     .opacity(1)                //        同时不透明
+ *     .step()                    // 打包成第二段
+ *     .export()                  // 输出 XAnimStep[] 交给 XAnimatedView
+ *
+ * 【多段动画如何播放？】
+ * 用一个 0→N 的 progress（withSequence 顺序播放 N 段 withTiming），
+ * 每段把 progress 推向 1、2、3……N。useAnimatedStyle 里用 interpolate
+ * 把 progress 映射成每个属性的具体值（inputRange: [0,1,2..N]）。
+ *
+ * 【为什么动画在 UI 线程？】
+ * useAnimatedStyle 的函数会被 Reanimated 编译成 worklet，运行在 UI 线程。
+ * JS 线程只需要发一次"开始动画"的指令，之后每一帧的插值计算
+ * 都在 UI 线程完成 → 即使 JS 线程忙（网络请求、列表渲染），动画也不掉帧。
+ * ============================================================================
+ */
+import { useEffect, useMemo } from 'react';
+import { StyleSheet } from 'react-native';
+import Animated, { Easing, cancelAnimation, interpolate, useAnimatedStyle, useSharedValue, withDelay, withSequence, withTiming, } from 'react-native-reanimated';
+/** 缓动函数表：字符串名 → Reanimated Easing 函数 */
+const EASINGS = {
+    linear: Easing.linear, // 匀速
+    ease: Easing.ease, // 默认缓动
+    'ease-in': Easing.in(Easing.ease), // 慢→快
+    'ease-out': Easing.out(Easing.ease), // 快→慢（入场常用，起步跟手）
+    'ease-in-out': Easing.inOut(Easing.ease), // 慢→快→慢（过渡常用）
+};
+/**
+ * 动画构建器（链式调用）
+ *
+ * 实现思路：
+ * - `current` 暂存当前累积的动作（{translateY: 300, opacity: 0}）；
+ * - `.step()` 把 current 打包成 {option, action} 推入 steps，然后清空 current；
+ * - `.export()` 把最后一段也打包并返回 steps 数组。
+ */
+export function anim(duration = 200, timingFunction = 'ease-in-out', delay = 0) {
+    const steps = [];
+    let current = {};
+    const api = {
+        step(option) {
+            // 只有 current 里真的有动作时才打包（避免空 step）
+            if (Object.keys(current).length) {
+                steps.push({
+                    option: { duration, timingFunction, delay, ...option },
+                    action: current,
+                });
+                current = {};
+            }
+            return api;
+        },
+        set(name, value) {
+            current[name] = value;
+            return api;
+        },
+        translateY(v) {
+            return api.set('translateY', v);
+        },
+        translateX(v) {
+            return api.set('translateX', v);
+        },
+        scale(v) {
+            return api.set('scale', v);
+        },
+        opacity(v) {
+            return api.set('opacity', v);
+        },
+        rotate(v) {
+            return api.set('rotate', v);
+        },
+        export() {
+            api.step();
+            return steps;
+        },
+    };
+    return api;
+}
+/**
+ * 推导动画起点：
+ * 组件 style 里写的是什么，动画就从哪开始。
+ * 比如 style={{transform: [{translateY: 300}], opacity: 0}}，
+ * 那第一帧就停在这个隐藏态，动画再插值到目标值 —— 这就是"不闪现"的秘诀。
+ * 如果没有显式初始值：opacity/scale 默认 1，其余默认 0。
+ */
+const getStartValue = (type, style) => {
+    const flat = StyleSheet.flatten(style);
+    // 1. 直接写在 style 上的属性（如 opacity）
+    if (typeof flat?.[type] === 'number') {
+        return flat[type];
+    }
+    // 2. 写在 transform 数组里的属性（如 translateY）
+    if (Array.isArray(flat?.transform)) {
+        const item = flat.transform.find((v) => v && typeof v === 'object' && type in v);
+        if (item && typeof item[type] === 'number') {
+            return item[type];
+        }
+    }
+    // 3. 兜底默认值
+    if (type === 'opacity' || type.startsWith('scale')) {
+        return 1;
+    }
+    return 0;
+};
+export const XAnimatedView = ({ animation = [], style, children, ...props }) => {
+    /** progress：0 → 1 → 2 … → N，驱动所有属性的插值 */
+    const progress = useSharedValue(0);
+    /**
+     * 把 animation 序列化成字符串作为依赖：
+     * 数组每次渲染都是新引用，直接拿它当依赖会导致动画重复播放；
+     * 序列化后只有内容真的变化才重播。
+     */
+    const animationKey = useMemo(() => JSON.stringify(animation), [animation]);
+    /**
+     * 播放动画：把 progress 从 0 按顺序推进到 1..N
+     */
+    useEffect(() => {
+        // 先取消上一次动画、归零，保证重复播放时从起点开始
+        cancelAnimation(progress);
+        progress.value = 0;
+        if (!animation.length) {
+            return;
+        }
+        // 每段动画 = 一个 withTiming：progress 推进到 index+1
+        const steps = animation.map((step, index) => {
+            const opt = step.option ?? {};
+            const timing = withTiming(index + 1, {
+                duration: opt.duration ?? 200,
+                easing: EASINGS[opt.timingFunction ?? 'linear'] ?? Easing.linear,
+            });
+            // 有 delay 就包一层 withDelay
+            return opt.delay ? withDelay(opt.delay, timing) : timing;
+        });
+        // withSequence：按顺序播放所有段（前一段完再播下一段）
+        progress.value = withSequence(...steps);
+        // 卸载时取消动画
+        return () => cancelAnimation(progress);
+    }, [animationKey, progress]);
+    /**
+     * 【关键】在 JS 线程预先计算好全部插值数据：
+     * worklet（useAnimatedStyle）运行在 UI 线程，里面不能调用任何
+     * 非 worklet 的 JS 函数，否则会抛
+     * "[Worklets] Tried to synchronously call a RemoteFunction"。
+     * 所以 getStartValue / 属性收集 / outputRange 推导全部在这里做完，
+     * worklet 里只留纯 interpolate 数值计算。
+     */
+    const animData = useMemo(() => {
+        if (!animation.length) {
+            return null;
+        }
+        // 收集所有段里出现过的属性类型（去重）
+        const typeSet = [];
+        animation.forEach(step => {
+            Object.keys(step.action).forEach(type => {
+                if (!typeSet.includes(type)) {
+                    typeSet.push(type);
+                }
+            });
+        });
+        if (!typeSet.length) {
+            return null;
+        }
+        // inputRange：progress 的取值点 [0, 1, 2, ..., N]
+        const inputRange = [0, ...animation.map((_, index) => index + 1)];
+        const entries = typeSet.map(type => {
+            // outputRange：起点（style 里的初始值）→ 每段的目标值
+            const outputRange = [getStartValue(type, style)];
+            animation.forEach(step => {
+                // 某一段没写这个属性就用上一段的值（保持不动）
+                outputRange.push(step.action[type] ?? outputRange[outputRange.length - 1]);
+            });
+            return { type, outputRange };
+        });
+        return { inputRange, entries };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [animationKey]);
+    /**
+     * 把 progress 映射成样式（worklet，UI 线程执行）：
+     * 只做纯数值插值，不调用任何外部 JS 函数。
+     */
+    const animatedStyle = useAnimatedStyle(() => {
+        if (!animData) {
+            return {};
+        }
+        const res = {};
+        const transform = [];
+        const { inputRange, entries } = animData;
+        for (let i = 0; i < entries.length; i++) {
+            const { type, outputRange } = entries[i];
+            // interpolate：把 progress 映射到 outputRange 区间
+            const value = interpolate(progress.value, inputRange, outputRange);
+            const isTransform = type.startsWith('translate') || type.startsWith('scale') || type.startsWith('rotate');
+            if (isTransform) {
+                // transform 属性：角度类要拼 'deg' 后缀
+                if (type.startsWith('rotate')) {
+                    transform.push({ [type]: `${value}deg` });
+                }
+                else {
+                    transform.push({ [type]: value });
+                }
+            }
+            else {
+                // 非 transform 属性（如 opacity）直接放根级
+                res[type] = value;
+            }
+        }
+        if (transform.length) {
+            res.transform = transform;
+        }
+        return res;
+    });
+    return (_jsx(Animated.View, { style: [style, animatedStyle], ...props, children: children }));
+};

package/dist/XButton/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ============================================================================
+ * XButton —— 对标 antd Button（RN 自实现版）
+ * ============================================================================
+ *
+ * 支持的 antd API：
+ * - type: primary | default | ghost | dashed | link | text
+ * - danger: 语义色变为错误红
+ * - size: large | middle | small
+ * - block: 撑满父容器宽度
+ * - loading: 加载态（自动禁用 + 显示转圈）
+ * - icon: 前置图标节点
+ * - shape: default | round | circle（circle 一般配合 icon-only 使用）
+ * - onPress / disabled / style / textStyle
+ *
+ * 与 antd 的差异（RN 环境限制，有意为之）：
+ * - dashed 在 Android 上圆角+虚线组合会退化为实线（RN 已知行为），视觉上仍保留虚线
+ * - 无 hover 态，按压反馈统一用透明度变化（对标 antd 的 active 态）
+ */
+import React from 'react';
+import { TextStyle, ViewStyle, StyleProp } from 'react-native';
+export type XButtonType = 'primary' | 'default' | 'ghost' | 'dashed' | 'link' | 'text';
+export type XButtonSize = 'large' | 'middle' | 'small';
+export type XButtonShape = 'default' | 'round' | 'circle';
+export interface XButtonProps {
+    type?: XButtonType;
+    size?: XButtonSize;
+    danger?: boolean;
+    block?: boolean;
+    loading?: boolean;
+    disabled?: boolean;
+    icon?: React.ReactNode;
+    shape?: XButtonShape;
+    onPress?: () => void;
+    onPressIn?: () => void;
+    onPressOut?: () => void;
+    children?: React.ReactNode;
+    style?: StyleProp<ViewStyle>;
+    /** 覆盖文字样式（一般只用来调字号/加粗，颜色跟随 type 自动算） */
+    textStyle?: StyleProp<TextStyle>;
+    testID?: string;
+}
+export declare function XButton({ type, size, danger, block, loading, disabled, icon, shape, onPress, onPressIn, onPressOut, children, style, textStyle, testID, }: XButtonProps): React.JSX.Element;
+export default XButton;

package/dist/XButton/index.js

@@ -0,0 +1,126 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { ActivityIndicator, Pressable, StyleSheet, Text, View } from 'react-native';
+import { useXTheme, xTheme } from '../theme';
+/** 尺寸相关样式：高度、左右内边距、字号、圆角基准 */
+function useSizeStyles(size, shape) {
+    switch (size) {
+        case 'large':
+            return {
+                height: xTheme.controlHeightLG,
+                paddingHorizontal: shape === 'circle' ? 0 : 18,
+                fontSize: xTheme.fontSizeLG,
+                radius: shape === 'round' || shape === 'circle' ? xTheme.controlHeightLG / 2 : xTheme.borderRadius,
+            };
+        case 'small':
+            return {
+                height: xTheme.controlHeightSM,
+                paddingHorizontal: shape === 'circle' ? 0 : 10,
+                fontSize: xTheme.fontSizeSM,
+                radius: shape === 'round' || shape === 'circle' ? xTheme.controlHeightSM / 2 : xTheme.borderRadius,
+            };
+        default:
+            return {
+                height: xTheme.controlHeight,
+                paddingHorizontal: shape === 'circle' ? 0 : 14,
+                fontSize: xTheme.fontSize,
+                radius: shape === 'round' || shape === 'circle' ? xTheme.controlHeight / 2 : xTheme.borderRadius,
+            };
+    }
+}
+export function XButton({ type = 'default', size = 'middle', danger = false, block = false, loading = false, disabled = false, icon, shape = 'default', onPress, onPressIn, onPressOut, children, style, textStyle, testID, }) {
+    const t = useXTheme();
+    const s = useSizeStyles(size, shape);
+    // 语义基准色：danger 用错误红，否则用主色
+    const baseColor = danger ? t.colorError : t.colorPrimary;
+    const isFilled = type === 'primary'; // 只有 primary 是实底
+    const isTextLike = type === 'link' || type === 'text'; // 无边框无底
+    const isGhostOrDashed = type === 'ghost' || type === 'dashed'; // 透明底 + 描边
+    // ---- 按 type × disabled 组合算出底色 / 文字色 / 边框色 ----
+    let backgroundColor = t.colorBgContainer;
+    let textColor = t.colorText;
+    let borderColor = t.colorBorder;
+    if (isFilled) {
+        backgroundColor = baseColor;
+        textColor = t.colorTextLightSolid;
+        borderColor = undefined;
+    }
+    else if (isGhostOrDashed) {
+        backgroundColor = 'transparent';
+        textColor = baseColor;
+        borderColor = baseColor;
+    }
+    else if (isTextLike) {
+        backgroundColor = 'transparent';
+        textColor = baseColor;
+        borderColor = undefined;
+    }
+    // 禁用/加载态统一压成灰（antd 规则：禁用后不区分 danger/type，统一样式）
+    const inert = disabled || loading;
+    if (inert) {
+        if (isFilled) {
+            backgroundColor = t.colorPrimaryDisabled;
+            textColor = t.colorTextLightSolid;
+        }
+        else {
+            backgroundColor = isTextLike ? 'transparent' : t.colorBgContainerDisabled;
+            textColor = t.colorTextQuaternary;
+            borderColor = isTextLike ? undefined : t.colorBorder;
+        }
+    }
+    // link 类型下划线：用 Text 的 textDecorationLine 实现
+    const underline = type === 'link' && !inert;
+    /**
+     * 纯文本 children 判定：字符串 / 数字 / 纯字符串数组都算。
+     * JSX 里写 `确定{cond ? '（2）' : ''}` 会生成字符串数组——若不包 <Text>
+     * 直接丢给 Pressable（View），RN 会报
+     * "Text strings must be rendered within a <Text> component"。
+     */
+    const isPlainChildren = typeof children === 'string' ||
+        typeof children === 'number' ||
+        (Array.isArray(children) && children.every(c => typeof c === 'string' || typeof c === 'number'));
+    const content = (_jsxs(_Fragment, { children: [loading && (_jsx(ActivityIndicator, { size: 'small', color: isFilled ? t.colorTextLightSolid : baseColor, style: styles.spinner })), !loading && icon != null && _jsx(View, { style: styles.iconWrap, children: icon }), isPlainChildren ? (_jsx(Text, { style: [
+                    { fontSize: s.fontSize, color: textColor, fontWeight: isFilled ? '600' : '400' },
+                    underline && { textDecorationLine: 'underline' },
+                    textStyle,
+                ], allowFontScaling: false, children: children })) : (children)] }));
+    const borderRadius = shape === 'circle' ? s.height / 2 : s.radius;
+    return (_jsx(Pressable, { testID: testID, disabled: inert, onPress: onPress, onPressIn: onPressIn, onPressOut: onPressOut, style: ({ pressed }) => [
+            styles.base,
+            {
+                height: s.height,
+                paddingHorizontal: s.paddingHorizontal,
+                borderRadius,
+                backgroundColor,
+                borderColor,
+                borderWidth: isTextLike ? 0 : StyleSheet.hairlineWidth * 2,
+            },
+            type === 'dashed' && !inert && { borderStyle: 'dashed' },
+            block && styles.block,
+            pressed && !inert && styles.pressed,
+            style,
+        ], children: content }));
+}
+const styles = StyleSheet.create({
+    base: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'center',
+        alignSelf: 'flex-start',
+        overflow: 'hidden',
+    },
+    block: {
+        alignSelf: 'stretch',
+    },
+    pressed: {
+        opacity: 0.75,
+    },
+    spinner: {
+        marginRight: 6,
+    },
+    iconWrap: {
+        marginRight: 6,
+        justifyContent: 'center',
+        alignItems: 'center',
+    },
+});
+export default XButton;

package/dist/XCalendar/XCalendarPopup.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ============================================================================
+ * XCalendarPopup —— 弹窗日历（XCalendar + XPullView 组合）
+ * ============================================================================
+ *
+ * 【定位】duxui 官方没有独立弹窗日历（把 Calendar 塞 PullView 用），
+ * 这里做成正式组件：
+ * - 底部弹出（XPullView，与项目弹窗族同款动画/遮罩）；
+ * - 顶部工具栏「取消 | 标题 | 确定」与本项目 XPickerDate 完全同款布局，
+ *   颜色全部走 useXTheme（暗黑自适应）；
+ * - 打开瞬间把外部 value 复制进草稿（XPickerDate 的 prevVisibleRef 套路），
+ *   点确定才 onConfirm，点取消/遮罩丢弃草稿，符合选择器交互惯例。
+ * ============================================================================
+ */
+import React from 'react';
+import { XCalendarMode, XCalendarValue } from './index';
+export interface XCalendarPopupProps {
+    visible: boolean;
+    onClose: () => void;
+    /** 点确定：回传草稿值 */
+    onConfirm?: (value: XCalendarValue) => void;
+    /** 当前值（每次打开同步进草稿） */
+    value?: XCalendarValue;
+    /** 传给 XCalendar 的模式 */
+    mode?: XCalendarMode;
+    /** day 模式多选 */
+    multiple?: boolean;
+    /** 面板标题，默认"请选择日期" */
+    title?: string;
+    min?: string;
+    max?: string;
+    disabledDate?: (date: import('dayjs').Dayjs) => boolean;
+    weekStartsOn?: 0 | 1;
+    onMonthChange?: (year: number, month: number) => void;
+    duration?: number;
+}
+export declare function XCalendarPopup({ visible, onClose, onConfirm, value, mode, multiple, title, min, max, disabledDate, weekStartsOn, onMonthChange, duration, }: XCalendarPopupProps): React.JSX.Element;
+export default XCalendarPopup;

package/dist/XCalendar/XCalendarPopup.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XCalendarPopup —— 弹窗日历（XCalendar + XPullView 组合）
+ * ============================================================================
+ *
+ * 【定位】duxui 官方没有独立弹窗日历（把 Calendar 塞 PullView 用），
+ * 这里做成正式组件：
+ * - 底部弹出（XPullView，与项目弹窗族同款动画/遮罩）；
+ * - 顶部工具栏「取消 | 标题 | 确定」与本项目 XPickerDate 完全同款布局，
+ *   颜色全部走 useXTheme（暗黑自适应）；
+ * - 打开瞬间把外部 value 复制进草稿（XPickerDate 的 prevVisibleRef 套路），
+ *   点确定才 onConfirm，点取消/遮罩丢弃草稿，符合选择器交互惯例。
+ * ============================================================================
+ */
+import { useCallback, useRef, useState } from 'react';
+import { Pressable, StyleSheet, Text, View } from 'react-native';
+import { useSafeAreaInsets } from 'react-native-safe-area-context';
+import { XPullView } from '../XPullView';
+import { useXTheme } from '../theme';
+import { useXLocale } from '../XLocale';
+import { XCalendar } from './index';
+export function XCalendarPopup({ visible, onClose, onConfirm, value, mode = 'day', multiple = false, title, min, max, disabledDate, weekStartsOn = 1, onMonthChange, duration = 200, }) {
+    const t = useXTheme();
+    const { t: i18n } = useXLocale();
+    const insets = useSafeAreaInsets();
+    /** 草稿：点确定前的一切选择都在这里，取消即丢弃 */
+    const [draft, setDraft] = useState(value);
+    const prevVisibleRef = useRef(visible);
+    /** 打开瞬间同步草稿（渲染期修正，与 XPickerDate 同套路） */
+    if (visible !== prevVisibleRef.current) {
+        prevVisibleRef.current = visible;
+        if (visible)
+            setDraft(value);
+    }
+    /** 确定：回传草稿并关闭 */
+    const handleConfirm = useCallback(() => {
+        onConfirm?.(draft ?? (multiple ? [] : mode === 'day' ? '' : ['', '']));
+        onClose();
+    }, [draft, multiple, mode, onConfirm, onClose]);
+    return (_jsx(XPullView, { visible: visible, onClose: onClose, side: 'bottom', duration: duration, overlayOpacity: 0.4, children: _jsxs(View, { style: [styles.panel, { backgroundColor: t.colorBgContainer, paddingBottom: Math.max(insets.bottom, 10) }], children: [_jsxs(View, { style: [styles.toolbar, { borderBottomColor: t.colorSplit }], children: [_jsx(Pressable, { onPress: onClose, hitSlop: 8, children: _jsx(Text, { style: [styles.cancelBtn, { color: t.colorTextSecondary }], children: i18n('cancel') }) }), _jsx(Text, { style: [styles.title, { color: t.colorText }], numberOfLines: 1, children: title ?? i18n('selectDate') }), _jsx(Pressable, { onPress: handleConfirm, hitSlop: 8, children: _jsx(Text, { style: [styles.confirmBtn, { color: t.colorPrimary }], children: i18n('confirm') }) })] }), _jsx(View, { style: styles.calendarWrap, children: _jsx(XCalendar, { mode: mode, multiple: multiple, value: draft, onChange: setDraft, min: min, max: max, disabledDate: disabledDate, weekStartsOn: weekStartsOn, onMonthChange: onMonthChange }) })] }) }));
+}
+const styles = StyleSheet.create({
+    panel: {
+        borderTopLeftRadius: 12,
+        borderTopRightRadius: 12,
+        overflow: 'hidden',
+    },
+    toolbar: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        paddingHorizontal: 16,
+        height: 48,
+        borderBottomWidth: StyleSheet.hairlineWidth,
+    },
+    cancelBtn: {
+        fontSize: 15,
+    },
+    title: {
+        fontSize: 16,
+        fontWeight: '600',
+        flex: 1,
+        textAlign: 'center',
+        marginHorizontal: 8,
+    },
+    confirmBtn: {
+        fontSize: 15,
+        fontWeight: '600',
+    },
+    calendarWrap: {
+        paddingHorizontal: 12,
+        paddingTop: 4,
+    },
+});
+export default XCalendarPopup;

package/dist/XCalendar/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ============================================================================
+ * XCalendar —— 日历（duxui Calendar 的 TS + XTheme 重写版）
+ * ============================================================================
+ *
+ * 【与 duxui Calendar 的关系】
+ * 逻辑照抄 duxui：纯 View 网格自绘（不依赖任何日历库）、单选/周选/范围
+ * 三种模式统一按"范围"处理、min/max + disabledDate 拦截。
+ * 重写点：JSX → TS、静态色值 → useXTheme() token、文案 → i18n（中英）、
+ * 周起始默认周一（duxui 同款），多选支持 antd 式 multiple。
+ *
+ * 【模式与取值】
+ *   mode='day'    value: 'YYYY-MM-DD'          （multiple 时: string[]）
+ *   mode='week'   value: ['YYYY-MM-DD','YYYY-MM-DD']  所在周一起始
+ *   mode='scope'  value: ['YYYY-MM-DD','YYYY-MM-DD']  任意范围
+ *
+ * 【弹窗用法】配合 XCalendarPopup（底部 XPullView + 取消/确定工具栏，
+ * 样式对齐本项目 XPickerDate）。
+ * ============================================================================
+ */
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import { Dayjs } from 'dayjs';
+export type XCalendarMode = 'day' | 'week' | 'scope';
+/** day 模式单选 = string；multiple/scope/week = string[]（scope/week 恒为 [start,end]） */
+export type XCalendarValue = string | string[];
+export interface XCalendarProps {
+    /** day 单选 / week 整周 / scope 任意范围，默认 day */
+    mode?: XCalendarMode;
+    /** 受控值（建议传组件输出的同格式值） */
+    value?: XCalendarValue;
+    /** 默认值（非受控） */
+    defaultValue?: XCalendarValue;
+    /** day 模式多选 */
+    multiple?: boolean;
+    onChange?: (value: XCalendarValue) => void;
+    /** 最小日期 'YYYY-MM-DD' */
+    min?: string;
+    /** 最大日期 'YYYY-MM-DD' */
+    max?: string;
+    /** 禁用判断（返回 true 禁点） */
+    disabledDate?: (date: Dayjs) => boolean;
+    /** 周起始：0 周日 / 1 周一，默认 1 */
+    weekStartsOn?: 0 | 1;
+    /** 月份切换回调（year, month 1~12） */
+    onMonthChange?: (year: number, month: number) => void;
+    style?: StyleProp<ViewStyle>;
+}
+export declare function XCalendar({ mode, value, defaultValue, multiple, onChange, min, max, disabledDate, weekStartsOn, onMonthChange, style, }: XCalendarProps): React.JSX.Element;
+export default XCalendar;