react-native-x-components 0.1.0

package/dist/XTopViewStore/index.js

@@ -0,0 +1,49 @@
+/**
+ * ============================================================================
+ * XTopViewStore —— 全局弹窗宿主的状态仓库（zustand）
+ * ============================================================================
+ *
+ * 【为什么需要它？】
+ * 弹窗如果渲染在页面内部（比如 ScrollView 里），会遇到两个问题：
+ *   1. 遮罩的 absoluteFill 只相对最近的定位父级生效，页面后面的兄弟节点
+ *      （比如 Button）会画在遮罩上面 → 遮不住；
+ *   2. 弹窗会跟着页面滚动，也无法覆盖到导航头/TabBar 等页面之外的区域。
+ *
+ * 解决方案（也是 duxui XTopView 的原理）：把弹窗"托管"到一个全局 store，
+ * 再由挂在应用根部的 <XTopView /> 渲染出来。这样弹窗永远在最顶层，
+ * 遮罩天然覆盖整个屏幕，与它在哪个页面里调用无关。
+ *
+ * 【三个 API 的含义】
+ *   add(element)    -> 挂载一个弹窗，返回唯一 key（之后用 key 来操作它）
+ *   update(key, el) -> 替换指定 key 的弹窗元素（用于"关闭时切换成离场态"）
+ *   remove(key)     -> 从宿主中移除（离场动画播完后再调用）
+ *
+ * 【zustand 用法速记】
+ *   create<T>()(set => ({...})) 返回一个 hook：useXTopViewStore(s => s.xxx)
+ *   - 选择器 s => s.add 只在 add 引用变化时才触发组件重渲染；
+ *   - 组件内也能用 useXTopViewStore.getState().add(...) 直接调（不用 hook）。
+ * ============================================================================
+ */
+import { create } from 'zustand';
+/** 自增 key 计数器：保证每次 add 的 key 全局唯一 */
+let keyValue = 0;
+export const useXTopViewStore = create()(set => ({
+    /** 初始状态：没有任何弹窗 */
+    items: [],
+    /** 挂载：追加到 items 末尾（数组尾部 = 绘制在最上层），返回 key */
+    add: element => {
+        const key = ++keyValue;
+        set(state => ({ items: [...state.items, { key, element }] }));
+        return key;
+    },
+    /**
+     * 更新：用 map 把 key 匹配的那一项替换成新元素。
+     * 注意是替换整个元素对象（新的 React 元素），React 会按 key 复用组件实例，
+     * 只更新 props —— XPullView 正是靠这个把 visible=false 传给已挂载的弹层。
+     */
+    update: (key, element) => set(state => ({
+        items: state.items.map(item => (item.key === key ? { ...item, element } : item)),
+    })),
+    /** 移除：用 filter 过滤掉目标 key，触发 <XTopView /> 重渲染 */
+    remove: key => set(state => ({ items: state.items.filter(item => item.key !== key) })),
+}));

package/dist/XUpload/XUploadImage.d.ts

@@ -0,0 +1,37 @@
+/**
+ * ============================================================================
+ * XUploadImage —— 图片上传（九宫格，适配器驱动）
+ * ============================================================================
+ *
+ * 【重构自 changhu/ImageUpload】原实现 UI 与 MinIO 上传逻辑耦合在组件内，
+ * 且用 '__uploading__' 占位 hack 展示进度。重构后：
+ * - UI 只关心"文件列表 + 进度"，上传走 useXUploadAdapter()（局部/全局可换）；
+ * - 进度用独立 overlay 状态，不污染 value；
+ * - 连续上传多张时用本地累加器 currentRef，避免闭包旧值覆盖；
+ * - 图片自动压缩（expo-image-manipulator，可关）；列宽按容器实测精确计算。
+ * ============================================================================
+ */
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import type { XUploadAdapter, XUploadResult } from './types';
+export interface XUploadImageProps {
+    /** 受控结果列表 */
+    value?: XUploadResult[];
+    onChange?: (items: XUploadResult[]) => void;
+    /** 最多张数，默认 9 */
+    max?: number;
+    /** 是否压缩（默认 true，缩到 compressWidth 宽 + JPEG quality） */
+    compress?: boolean;
+    compressWidth?: number;
+    quality?: number;
+    disabled?: boolean;
+    /** 列数，默认 3 */
+    columns?: number;
+    /** 局部适配器覆盖（不传用全局/Provider） */
+    adapter?: XUploadAdapter;
+    /** 点击已上传项（业务可接 XImagePreview 等） */
+    onItemPress?: (item: XUploadResult, index: number) => void;
+    style?: StyleProp<ViewStyle>;
+}
+export declare function XUploadImage({ value, onChange, max, compress, compressWidth, quality, disabled, columns, adapter: localAdapter, onItemPress, style, }: XUploadImageProps): React.JSX.Element;
+export default XUploadImage;

package/dist/XUpload/XUploadImage.js

@@ -0,0 +1,142 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XUploadImage —— 图片上传（九宫格，适配器驱动）
+ * ============================================================================
+ *
+ * 【重构自 changhu/ImageUpload】原实现 UI 与 MinIO 上传逻辑耦合在组件内，
+ * 且用 '__uploading__' 占位 hack 展示进度。重构后：
+ * - UI 只关心"文件列表 + 进度"，上传走 useXUploadAdapter()（局部/全局可换）；
+ * - 进度用独立 overlay 状态，不污染 value；
+ * - 连续上传多张时用本地累加器 currentRef，避免闭包旧值覆盖；
+ * - 图片自动压缩（expo-image-manipulator，可关）；列宽按容器实测精确计算。
+ * ============================================================================
+ */
+import { useCallback, useRef, useState } from 'react';
+import { Image, Pressable, StyleSheet, Text, View } from 'react-native';
+import { useXTheme } from '../theme';
+import { useXLocale } from '../XLocale';
+import { useXUploadAdapter } from './provider';
+import { compressImage, pickImageFiles } from './helpers';
+const CELL_GAP = 8;
+export function XUploadImage({ value, onChange, max = 9, compress = true, compressWidth = 1280, quality = 0.6, disabled = false, columns = 3, adapter: localAdapter, onItemPress, style, }) {
+    const t = useXTheme();
+    const { t: i18n } = useXLocale();
+    const adapter = useXUploadAdapter(localAdapter);
+    /** 非受控兜底 */
+    const [inner, setInner] = useState([]);
+    const items = value ?? inner;
+    /** 上传中的任务（进度 overlay） */
+    const [tasks, setTasks] = useState([]);
+    /** 连续上传时跨轮次累加（闭包旧值防线） */
+    const currentRef = useRef(items);
+    currentRef.current = items;
+    /** 容器实测宽度（精确列宽） */
+    const [gridWidth, setGridWidth] = useState(0);
+    const emit = useCallback((next) => {
+        currentRef.current = next;
+        setInner(next);
+        onChange?.(next);
+    }, [onChange]);
+    /** 加号：选图 → 逐张压缩上传（串行，进度独立展示） */
+    const handleAdd = useCallback(async () => {
+        if (disabled || tasks.length)
+            return;
+        const remaining = max - currentRef.current.length;
+        if (remaining <= 0)
+            return;
+        const picked = await pickImageFiles({ max: remaining, quality: 0.9 });
+        for (const raw of picked) {
+            if (currentRef.current.length >= max)
+                break;
+            const file = compress ? await compressImage(raw, compressWidth, quality) : raw;
+            const taskId = `${Date.now()}-${Math.random()}`;
+            setTasks(prev => [...prev, { id: taskId, progress: 0 }]);
+            try {
+                const result = await adapter.upload(file, percent => {
+                    setTasks(prev => prev.map(task => (task.id === taskId ? { ...task, progress: percent } : task)));
+                });
+                emit([...currentRef.current, result]);
+            }
+            catch (e) {
+                console.warn('[XUploadImage] upload failed:', e);
+            }
+            finally {
+                setTasks(prev => prev.filter(task => task.id !== taskId));
+            }
+        }
+    }, [disabled, max, tasks.length, compress, compressWidth, quality, adapter, emit]);
+    /** 删除 */
+    const handleRemove = useCallback((index) => {
+        emit(currentRef.current.filter((_, i) => i !== index));
+    }, [emit]);
+    const handleLayout = useCallback((e) => {
+        setGridWidth(e.nativeEvent.layout.width);
+    }, []);
+    /** 精确列宽：容器宽 - 间隙后均分 */
+    const cellWidth = gridWidth > 0 ? (gridWidth - CELL_GAP * (columns - 1)) / columns : undefined;
+    const showAdd = !disabled && items.length + tasks.length < max;
+    return (_jsxs(View, { style: [styles.grid, style], onLayout: handleLayout, children: [items.map((item, index) => (_jsxs(View, { style: [styles.cell, { borderRadius: t.borderRadius, borderColor: t.colorSplit, width: cellWidth }], children: [_jsx(Pressable, { style: styles.cellInner, onPress: () => onItemPress?.(item, index), children: _jsx(Image, { source: { uri: item.url ?? item.uri }, style: styles.image, resizeMode: 'cover' }) }), !disabled && (_jsx(Pressable, { style: styles.remove, onPress: () => handleRemove(index), hitSlop: 6, children: _jsx(Text, { style: styles.removeText, allowFontScaling: false, children: "\u2715" }) }))] }, `${item.objectKey ?? item.url ?? index}`))), tasks.map(task => (_jsx(View, { style: [
+                    styles.cell,
+                    styles.uploadingCell,
+                    { borderRadius: t.borderRadius, borderColor: t.colorSplit, backgroundColor: t.colorBgLayout, width: cellWidth },
+                ], children: _jsx(Text, { style: [styles.progressText, { color: t.colorPrimary }], allowFontScaling: false, children: i18n('uploadingPercent', { n: task.progress }) }) }, task.id))), showAdd && (_jsx(Pressable, { onPress: handleAdd, style: ({ pressed }) => [
+                    styles.cell,
+                    styles.addCell,
+                    { borderRadius: t.borderRadius, borderColor: t.colorBorder, width: cellWidth },
+                    pressed && { backgroundColor: t.colorBgLayout },
+                ], children: _jsx(Text, { style: [styles.addText, { color: t.colorTextTertiary }], allowFontScaling: false, children: "\uFF0B" }) }))] }));
+}
+const styles = StyleSheet.create({
+    grid: {
+        flexDirection: 'row',
+        flexWrap: 'wrap',
+        gap: CELL_GAP,
+    },
+    cell: {
+        aspectRatio: 1,
+        borderWidth: StyleSheet.hairlineWidth,
+        overflow: 'hidden',
+    },
+    cellInner: {
+        flex: 1,
+    },
+    image: {
+        width: '100%',
+        height: '100%',
+    },
+    remove: {
+        position: 'absolute',
+        top: 0,
+        right: 0,
+        width: 20,
+        height: 20,
+        borderBottomLeftRadius: 8,
+        alignItems: 'center',
+        justifyContent: 'center',
+        backgroundColor: 'rgba(0,0,0,0.45)',
+    },
+    removeText: {
+        color: '#fff',
+        fontSize: 11,
+        lineHeight: 13,
+    },
+    uploadingCell: {
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    progressText: {
+        fontSize: 12,
+        fontWeight: '600',
+    },
+    addCell: {
+        borderStyle: 'dashed',
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    addText: {
+        fontSize: 26,
+        lineHeight: 30,
+    },
+});
+export default XUploadImage;

package/dist/XUpload/XUploadVideo.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ============================================================================
+ * XUploadVideo —— 视频上传（单个，适配器驱动）
+ * ============================================================================
+ * 与 XUploadImage 同一适配器协议；不压缩（视频压缩超出组件库职责），
+ * 选择即上传，展示进度与结果（文件名 + 删除）。
+ * ============================================================================
+ */
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import type { XUploadAdapter, XUploadResult } from './types';
+export interface XUploadVideoProps {
+    /** 受控结果 */
+    value?: XUploadResult | null;
+    onChange?: (item: XUploadResult | null) => void;
+    /** 最长视频秒数（picker 侧限制），默认 60 */
+    videoMaxDuration?: number;
+    disabled?: boolean;
+    /** 局部适配器覆盖 */
+    adapter?: XUploadAdapter;
+    style?: StyleProp<ViewStyle>;
+}
+export declare function XUploadVideo({ value, onChange, videoMaxDuration, disabled, adapter: localAdapter, style, }: XUploadVideoProps): React.JSX.Element;
+export default XUploadVideo;

package/dist/XUpload/XUploadVideo.js

@@ -0,0 +1,83 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ============================================================================
+ * XUploadVideo —— 视频上传（单个，适配器驱动）
+ * ============================================================================
+ * 与 XUploadImage 同一适配器协议；不压缩（视频压缩超出组件库职责），
+ * 选择即上传，展示进度与结果（文件名 + 删除）。
+ * ============================================================================
+ */
+import { useCallback, useState } from 'react';
+import { Pressable, StyleSheet, Text, View } from 'react-native';
+import { useXTheme } from '../theme';
+import { useXLocale } from '../XLocale';
+import { useXUploadAdapter } from './provider';
+import { pickVideoFile } from './helpers';
+export function XUploadVideo({ value, onChange, videoMaxDuration = 60, disabled = false, adapter: localAdapter, style, }) {
+    const t = useXTheme();
+    const { t: i18n } = useXLocale();
+    const adapter = useXUploadAdapter(localAdapter);
+    const [inner, setInner] = useState(null);
+    const current = value !== undefined ? value : inner;
+    const [progress, setProgress] = useState(null);
+    const [failed, setFailed] = useState(false);
+    const emit = useCallback((item) => {
+        setInner(item);
+        onChange?.(item);
+    }, [onChange]);
+    /** 选择视频 → 上传 */
+    const handlePick = useCallback(async () => {
+        if (disabled || progress !== null)
+            return;
+        setFailed(false);
+        const file = await pickVideoFile({ videoMaxDuration });
+        if (!file)
+            return;
+        setProgress(0);
+        try {
+            const result = await adapter.upload(file, setProgress);
+            emit(result);
+        }
+        catch (e) {
+            console.warn('[XUploadVideo] upload failed:', e);
+            setFailed(true);
+        }
+        finally {
+            setProgress(null);
+        }
+    }, [disabled, progress, videoMaxDuration, adapter, emit]);
+    return (_jsx(View, { style: style, children: current ? (_jsxs(View, { style: [styles.resultBox, { borderColor: t.colorSplit, backgroundColor: t.colorBgLayout, borderRadius: t.borderRadius }], children: [_jsxs(Text, { numberOfLines: 1, style: [styles.resultText, { color: t.colorText }], children: ["\uD83C\uDFAC ", String(current.url ?? current.objectKey ?? '视频')] }), !disabled && (_jsx(Pressable, { onPress: () => emit(null), hitSlop: 6, children: _jsx(Text, { style: [styles.removeText, { color: t.colorError }], children: i18n('delete') }) }))] })) : (_jsx(Pressable, { onPress: handlePick, disabled: disabled, style: ({ pressed }) => [
+                styles.pickBox,
+                { borderColor: t.colorBorder, borderRadius: t.borderRadius },
+                pressed && { backgroundColor: t.colorBgLayout },
+            ], children: progress !== null ? (_jsx(Text, { style: [styles.pickText, { color: t.colorPrimary }], allowFontScaling: false, children: i18n('uploadingPercent', { n: progress }) })) : (_jsx(Text, { style: [styles.pickText, { color: failed ? t.colorError : t.colorTextSecondary }], allowFontScaling: false, children: failed ? `${i18n('uploadFailed')} · ${i18n('retry')}` : i18n('pleaseSelect') })) })) }));
+}
+const styles = StyleSheet.create({
+    resultBox: {
+        height: 48,
+        borderWidth: StyleSheet.hairlineWidth,
+        flexDirection: 'row',
+        alignItems: 'center',
+        justifyContent: 'space-between',
+        paddingHorizontal: 12,
+    },
+    resultText: {
+        fontSize: 14,
+        flex: 1,
+        marginRight: 8,
+    },
+    removeText: {
+        fontSize: 13,
+    },
+    pickBox: {
+        height: 64,
+        borderWidth: StyleSheet.hairlineWidth,
+        borderStyle: 'dashed',
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    pickText: {
+        fontSize: 14,
+    },
+});
+export default XUploadVideo;

package/dist/XUpload/adapters.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ============================================================================
+ * XUpload 内置适配器
+ * ============================================================================
+ * - createMinioPresignedAdapter：MinIO 预签名直传（changhu 同款后端约定，
+ *   两步：换预签名 URL → XHR PUT 直传，可选 objectKey 换预览 URL）；
+ * - createFormDataUploadAdapter：普通 multipart 直传；
+ * - createMockUploadAdapter：演示/开发用假上传。
+ *
+ * 所有适配器的进度都通过 XHR upload.onprogress 上报（RN 原生支持）。
+ * ============================================================================
+ */
+import type { XUploadAdapter, XUploadResult } from './types';
+export interface MinioPresignedAdapterOptions {
+    /**
+     * 换预签名 URL。changhu 后端约定示例：
+     *   GET /file/getUploadUrl?fileName=xx&contentType=image/png
+     *   → {objectKey, preSignedUrl}
+     */
+    getUploadUrl: (file: {
+        name: string;
+        mimeType: string;
+    }) => Promise<{
+        objectKey: string;
+        preSignedUrl: string;
+    }>;
+    /** 可选：objectKey → 预览地址（changhu: GET /file/getPreviewUrl） */
+    getPreviewUrl?: (objectKey: string) => Promise<string | undefined> | string | undefined;
+    /** PUT 请求头（预签名一般无需额外鉴权头） */
+    headers?: Record<string, string>;
+}
+/**
+ * MinIO 预签名适配器。
+ * 返回值：{objectKey, url}——url 优先用 getPreviewUrl 的回显地址，
+ * 否则取预签名 URL 去掉 query 的裸直链。
+ */
+export declare function createMinioPresignedAdapter(options: MinioPresignedAdapterOptions): XUploadAdapter;
+export interface FormDataAdapterOptions {
+    /** 上传接口地址（POST multipart/form-data） */
+    url: string;
+    /** 文件字段名，默认 'file' */
+    fieldName?: string;
+    headers?: Record<string, string>;
+    /** 附加表单字段 */
+    fields?: Record<string, string>;
+    /** 从响应中解析结果，默认取 JSON 的 {url | data.url} */
+    parseResponse?: (responseText: string) => XUploadResult;
+}
+export declare function createFormDataUploadAdapter(options: FormDataAdapterOptions): XUploadAdapter;
+export declare function createMockUploadAdapter(durationMs?: number): XUploadAdapter;

package/dist/XUpload/adapters.js

@@ -0,0 +1,110 @@
+/**
+ * ============================================================================
+ * XUpload 内置适配器
+ * ============================================================================
+ * - createMinioPresignedAdapter：MinIO 预签名直传（changhu 同款后端约定，
+ *   两步：换预签名 URL → XHR PUT 直传，可选 objectKey 换预览 URL）；
+ * - createFormDataUploadAdapter：普通 multipart 直传；
+ * - createMockUploadAdapter：演示/开发用假上传。
+ *
+ * 所有适配器的进度都通过 XHR upload.onprogress 上报（RN 原生支持）。
+ * ============================================================================
+ */
+/** XHR 上传（带进度） */
+function xhrUpload(url, method, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+body, headers, onProgress) {
+    return new Promise((resolve, reject) => {
+        const xhr = new XMLHttpRequest();
+        xhr.open(method, url);
+        for (const [k, v] of Object.entries(headers ?? {})) {
+            xhr.setRequestHeader(k, v);
+        }
+        if (onProgress) {
+            xhr.upload.onprogress = e => {
+                if (e.lengthComputable)
+                    onProgress(Math.min(100, Math.round((e.loaded / e.total) * 100)));
+            };
+        }
+        xhr.onload = () => {
+            if (xhr.status >= 200 && xhr.status < 300)
+                resolve();
+            else
+                reject(new Error(`upload failed: HTTP ${xhr.status}`));
+        };
+        xhr.onerror = () => reject(new Error('network error'));
+        xhr.send(body);
+    });
+}
+/** 本地文件 → Blob（RN 中 fetch file:// 协议可用） */
+async function fileToBlob(file) {
+    const res = await fetch(file.uri);
+    return res.blob();
+}
+/**
+ * MinIO 预签名适配器。
+ * 返回值：{objectKey, url}——url 优先用 getPreviewUrl 的回显地址，
+ * 否则取预签名 URL 去掉 query 的裸直链。
+ */
+export function createMinioPresignedAdapter(options) {
+    return {
+        async upload(file, onProgress) {
+            const { objectKey, preSignedUrl } = await options.getUploadUrl({ name: file.name, mimeType: file.mimeType });
+            const blob = await fileToBlob(file);
+            await xhrUpload(preSignedUrl, 'PUT', blob, options.headers, onProgress);
+            let previewUrl;
+            if (options.getPreviewUrl) {
+                previewUrl = await options.getPreviewUrl(objectKey);
+            }
+            return { objectKey, url: previewUrl ?? preSignedUrl.split('?')[0] };
+        },
+    };
+}
+export function createFormDataUploadAdapter(options) {
+    const parse = options.parseResponse ?? (text => {
+        try {
+            const json = JSON.parse(text);
+            return json?.data ?? json;
+        }
+        catch {
+            return {};
+        }
+    });
+    return {
+        async upload(file, onProgress) {
+            const formData = new FormData();
+            // RN 的 FormData 文件项格式
+            formData.append(options.fieldName ?? 'file', {
+                uri: file.uri,
+                name: file.name,
+                type: file.mimeType,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            });
+            for (const [k, v] of Object.entries(options.fields ?? {})) {
+                formData.append(k, v);
+            }
+            await xhrUpload(options.url, 'POST', formData, options.headers, onProgress);
+            return {};
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Mock 适配器（演示用）
+// ---------------------------------------------------------------------------
+export function createMockUploadAdapter(durationMs = 1200) {
+    return {
+        async upload(file, onProgress) {
+            const start = Date.now();
+            return new Promise(resolve => {
+                const timer = setInterval(() => {
+                    const ratio = Math.min(1, (Date.now() - start) / durationMs);
+                    onProgress?.(Math.round(ratio * 100));
+                    if (ratio >= 1) {
+                        clearInterval(timer);
+                        resolve({ url: file.uri });
+                    }
+                }, 100);
+            });
+        },
+    };
+}

package/dist/XUpload/helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * ============================================================================
+ * XUpload 辅助 —— 选图/选视频/压缩/base64 上传
+ * ============================================================================
+ * 全部基于 Expo 官方包（SDK 57 API，已按类型定义核对）：
+ * - expo-image-picker：launchImageLibraryAsync（mediaTypes: ['images'] 新写法）
+ * - expo-image-manipulator：manipulateAsync 压缩（JPEG）
+ * - expo-file-system：新版 File API 写 base64 临时文件
+ * ============================================================================
+ */
+import type { XUploadAdapter, XUploadFile, XUploadResult } from './types';
+/** 选图（可多选），返回本机文件列表 */
+export declare function pickImageFiles(options?: {
+    /** 最多可选，默认 9 */
+    max?: number;
+    quality?: number;
+}): Promise<XUploadFile[]>;
+/** 选视频（单个），取消返回 null */
+export declare function pickVideoFile(options?: {
+    videoMaxDuration?: number;
+}): Promise<XUploadFile | null>;
+/**
+ * 压缩图片（等比缩到指定宽度 + JPEG 质量），返回新文件。
+ * 小于目标宽度的图不压缩直接返回。
+ */
+export declare function compressImage(file: XUploadFile, maxWidth?: number, quality?: number): Promise<XUploadFile>;
+/**
+ * base64 → 临时文件 → 适配器上传（签名等"内存产物"的接入通道）。
+ * 上传完成自动清理临时文件。
+ */
+export declare function uploadBase64(base64: string, options?: {
+    name?: string;
+    mimeType?: string;
+    adapter?: XUploadAdapter;
+}): Promise<XUploadResult>;

package/dist/XUpload/helpers.js

@@ -0,0 +1,85 @@
+/**
+ * ============================================================================
+ * XUpload 辅助 —— 选图/选视频/压缩/base64 上传
+ * ============================================================================
+ * 全部基于 Expo 官方包（SDK 57 API，已按类型定义核对）：
+ * - expo-image-picker：launchImageLibraryAsync（mediaTypes: ['images'] 新写法）
+ * - expo-image-manipulator：manipulateAsync 压缩（JPEG）
+ * - expo-file-system：新版 File API 写 base64 临时文件
+ * ============================================================================
+ */
+import * as ImagePicker from 'expo-image-picker';
+import { SaveFormat, manipulateAsync } from 'expo-image-manipulator';
+import { EncodingType, File, Paths } from 'expo-file-system';
+import { getXUploadAdapter } from './provider';
+/** picker 资产 → XUploadFile */
+function toUploadFile(asset) {
+    return {
+        uri: asset.uri,
+        name: asset.fileName ?? asset.uri.split('/').pop() ?? `file-${Date.now()}`,
+        mimeType: asset.mimeType ?? 'application/octet-stream',
+        size: asset.fileSize ?? undefined,
+    };
+}
+/** 选图（可多选），返回本机文件列表 */
+export async function pickImageFiles(options) {
+    const res = await ImagePicker.launchImageLibraryAsync({
+        mediaTypes: ['images'],
+        allowsMultipleSelection: true,
+        selectionLimit: options?.max ?? 9,
+        quality: options?.quality ?? 0.9,
+    });
+    if (res.canceled)
+        return [];
+    return res.assets.map(toUploadFile);
+}
+/** 选视频（单个），取消返回 null */
+export async function pickVideoFile(options) {
+    const res = await ImagePicker.launchImageLibraryAsync({
+        mediaTypes: ['videos'],
+        videoMaxDuration: options?.videoMaxDuration ?? 60,
+    });
+    if (res.canceled || !res.assets.length)
+        return null;
+    return toUploadFile(res.assets[0]);
+}
+/**
+ * 压缩图片（等比缩到指定宽度 + JPEG 质量），返回新文件。
+ * 小于目标宽度的图不压缩直接返回。
+ */
+export async function compressImage(file, maxWidth = 1280, quality = 0.6) {
+    try {
+        const result = await manipulateAsync(file.uri, [{ resize: { width: maxWidth } }], { compress: quality, format: SaveFormat.JPEG });
+        return {
+            uri: result.uri,
+            name: file.name.replace(/\.\w+$/, '') + '.jpg',
+            mimeType: 'image/jpeg',
+            size: undefined,
+        };
+    }
+    catch {
+        // 压缩失败兜底原图
+        return file;
+    }
+}
+/**
+ * base64 → 临时文件 → 适配器上传（签名等"内存产物"的接入通道）。
+ * 上传完成自动清理临时文件。
+ */
+export async function uploadBase64(base64, options) {
+    const name = options?.name ?? `upload-${Date.now()}.png`;
+    const file = new File(Paths.cache, name);
+    file.write(base64, { encoding: EncodingType.Base64 });
+    try {
+        const adapter = options?.adapter ?? getXUploadAdapter();
+        return await adapter.upload({ uri: file.uri, name, mimeType: options?.mimeType ?? 'image/png' });
+    }
+    finally {
+        try {
+            file.delete();
+        }
+        catch {
+            // 清理失败不影响结果
+        }
+    }
+}

package/dist/XUpload/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * XUpload 统一出口
+ */
+export type { XUploadAdapter, XUploadFile, XUploadResult } from './types';
+export { createMinioPresignedAdapter, createFormDataUploadAdapter, createMockUploadAdapter } from './adapters';
+export type { MinioPresignedAdapterOptions, FormDataAdapterOptions } from './adapters';
+export { XUploadProvider, setXUploadAdapter, getXUploadAdapter, useXUploadAdapter, createMinioAdapter } from './provider';
+export { pickImageFiles, pickVideoFile, compressImage, uploadBase64 } from './helpers';
+export { XUploadImage } from './XUploadImage';
+export type { XUploadImageProps } from './XUploadImage';
+export { XUploadVideo } from './XUploadVideo';
+export type { XUploadVideoProps } from './XUploadVideo';

package/dist/XUpload/index.js

@@ -0,0 +1,5 @@
+export { createMinioPresignedAdapter, createFormDataUploadAdapter, createMockUploadAdapter } from './adapters';
+export { XUploadProvider, setXUploadAdapter, getXUploadAdapter, useXUploadAdapter, createMinioAdapter } from './provider';
+export { pickImageFiles, pickVideoFile, compressImage, uploadBase64 } from './helpers';
+export { XUploadImage } from './XUploadImage';
+export { XUploadVideo } from './XUploadVideo';

package/dist/XUpload/provider.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ============================================================================
+ * XUpload Provider —— 上传适配器的注入/获取
+ * ============================================================================
+ *
+ * 【两级注入】
+ * 1. 全局默认：setXUploadAdapter(adapter)（App 启动时注入 MinIO/业务适配器）；
+ * 2. 局部覆盖：<XUploadProvider adapter={...}>（子树内所有上传组件生效），
+ *    没有时回退全局默认；连全局也没注入时兜底 Mock 并 warn 一次。
+ * ============================================================================
+ */
+import React from 'react';
+import { createMinioPresignedAdapter } from './adapters';
+import type { XUploadAdapter } from './types';
+/** 注入全局默认适配器（App 启动时调用一次） */
+export declare function setXUploadAdapter(adapter: XUploadAdapter): void;
+/** 获取全局默认适配器 */
+export declare function getXUploadAdapter(): XUploadAdapter;
+export declare function XUploadProvider({ adapter, children }: {
+    adapter: XUploadAdapter;
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** 上传组件内部取适配器：局部 > 全局 > Mock(仅首次 warn) */
+export declare function useXUploadAdapter(localAdapter?: XUploadAdapter): XUploadAdapter;
+/** 便捷构造：MinIO 预签名适配器（re-export） */
+export declare const createMinioAdapter: typeof createMinioPresignedAdapter;