zkit-ui 1.0.0

package/dist/services/PermissionPurposeDialogService/index.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @file PermissionPurposeDialogService - 权限用途说明 TopSheet
+ * @description 在系统权限申请框弹出前后，于屏幕顶部展示一条白底黑字的非阻塞说明条，
+ *   告知用户该权限的使用目的。纯展示、不拦截交互、无按钮。
+ *   支持按权限自动填充默认文案，也支持完全自定义。
+ * @example
+ * ```tsx
+ * import { permissionPurposeDialog } from 'zkit-ui';
+ *
+ * // 展示说明
+ * const purpose = permissionPurposeDialog.show({ permission: 'location' });
+ * // ... 发起系统权限请求 ...
+ * // 请求完成后关闭
+ * purpose.hide();
+ * ```
+ */
+import * as React from 'react';
+/** 内置支持的权限用途类型 */
+export type PermissionPurpose = 'location' | 'camera' | 'microphone' | 'photos' | 'notification' | 'contacts' | 'calendar' | 'bluetooth' | 'motion' | 'custom';
+/** 弹窗配置 */
+export type PermissionPurposeDialogOptions = {
+    /** 作用域标识，用于按标识关闭 */
+    scopeKey?: string;
+    /** 权限用途，会自动填充默认标题与描述 */
+    permission?: PermissionPurpose;
+    /** 自定义标题（优先于默认文案） */
+    title?: string;
+    /** 自定义描述（优先于默认文案） */
+    message?: string;
+    /** 自动关闭时长（毫秒）。不传则保持显示，直到显式关闭 */
+    duration?: number;
+    /** 顶部安全区下方额外偏移。默认 `wp(8)` */
+    topOffset?: number;
+};
+/** `show()` 返回的句柄，用于精确关闭或更新本次说明。 */
+export type PermissionPurposeDialogHandle = {
+    /** 本次说明的唯一标识。 */
+    id: string;
+    /** 只关闭当前 id 对应的说明，避免旧异步流程误关新说明。 */
+    hide: () => void;
+    /** 只更新当前 id 对应的说明配置。 */
+    update: (patch: Partial<PermissionPurposeDialogOptions>) => void;
+};
+type ResolvedPermissionPurposeDialogOptions = {
+    id: string;
+    scopeKey?: string;
+    permission: PermissionPurpose;
+    title: string;
+    message: string;
+    topOffset: number;
+};
+type PermissionPurposeDialogState = {
+    open: boolean;
+    options: ResolvedPermissionPurposeDialogOptions;
+};
+/**
+ * 权限用途说明弹窗服务类
+ * @internal
+ */
+declare class PermissionPurposeDialogServiceClass {
+    private mounted;
+    private idSeed;
+    private activeId;
+    private activeOptions;
+    private hideTimer;
+    private setState;
+    /** @internal */
+    setMounted(mounted: boolean): void;
+    /** @internal */
+    setStateUpdater(updater: React.Dispatch<React.SetStateAction<PermissionPurposeDialogState>> | null): void;
+    /** 展示权限用途说明 */
+    show(options?: PermissionPurposeDialogOptions): PermissionPurposeDialogHandle;
+    /** 关闭说明 */
+    hide(): void;
+    /** 按 scopeKey 关闭 */
+    hideByScope(scopeKey?: string): void;
+    /** @internal 清理所有定时器 */
+    clearAllTimers(): void;
+    private openWithOptions;
+    private hideInternal;
+    /** 只关闭指定 id 的说明，避免旧流程误关新说明。 */
+    private hideById;
+    /** 只更新指定 id 的说明。 */
+    private updateById;
+    private createId;
+    private createHandle;
+    private clearHideTimer;
+}
+/** 权限用途说明弹窗服务实例 */
+export declare const permissionPurposeDialog: PermissionPurposeDialogServiceClass;
+/**
+ * 权限用途说明 Provider
+ * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ */
+export declare function PermissionPurposeDialogProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/services/PermissionPurposeDialogService/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/PermissionPurposeDialogService/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,kBAAkB;AAClB,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,cAAc,GACd,UAAU,GACV,UAAU,GACV,WAAW,GACX,QAAQ,GACR,QAAQ,CAAC;AAEb,WAAW;AACX,MAAM,MAAM,8BAA8B,GAAG;IAC3C,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,6BAA6B,GAAG;IAC1C,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,8BAA8B,CAAC,KAAK,IAAI,CAAC;CAClE,CAAC;AASF,KAAK,sCAAsC,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,sCAAsC,CAAC;CACjD,CAAC;AA2FF;;;GAGG;AACH,cAAM,mCAAmC;IACvC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAAmF;IAEnG,gBAAgB;IAChB,UAAU,CAAC,OAAO,EAAE,OAAO;IAS3B,gBAAgB;IAChB,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,4BAA4B,CAAC,CAAC,GAAG,IAAI;IAIlG,eAAe;IACf,IAAI,CAAC,OAAO,GAAE,8BAAmC,GAAG,6BAA6B;IAYjF,WAAW;IACX,IAAI;IAIJ,oBAAoB;IACpB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM;IAM7B,wBAAwB;IACxB,cAAc;IAId,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,YAAY;IAiBpB,+BAA+B;IAC/B,OAAO,CAAC,QAAQ;IAKhB,oBAAoB;IACpB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,cAAc;CAMvB;AAED,mBAAmB;AACnB,eAAO,MAAM,uBAAuB,qCAA4C,CAAC;AAwFjF;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAmB1F"}

package/dist/services/PermissionPurposeDialogService/index.js

@@ -0,0 +1,360 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.permissionPurposeDialog = void 0;
+exports.PermissionPurposeDialogProvider = PermissionPurposeDialogProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+/**
+ * @file PermissionPurposeDialogService - 权限用途说明 TopSheet
+ * @description 在系统权限申请框弹出前后，于屏幕顶部展示一条白底黑字的非阻塞说明条，
+ *   告知用户该权限的使用目的。纯展示、不拦截交互、无按钮。
+ *   支持按权限自动填充默认文案，也支持完全自定义。
+ * @example
+ * ```tsx
+ * import { permissionPurposeDialog } from 'zkit-ui';
+ *
+ * // 展示说明
+ * const purpose = permissionPurposeDialog.show({ permission: 'location' });
+ * // ... 发起系统权限请求 ...
+ * // 请求完成后关闭
+ * purpose.hide();
+ * ```
+ */
+const React = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const react_native_safe_area_context_1 = require("react-native-safe-area-context");
+const zkit_tools_1 = require("zkit-tools");
+const Text_1 = require("../../ui/Text");
+/** 各权限类型的默认文案 */
+const DEFAULT_PURPOSE_TEXT = {
+    location: {
+        title: '需要使用位置',
+        message: '用于定位、附近内容或位置相关服务。授权只会在相关功能中使用。',
+    },
+    camera: {
+        title: '需要使用相机',
+        message: '用于拍照、扫码或上传现场图片。授权只会在相关功能中使用。',
+    },
+    microphone: {
+        title: '需要使用麦克风',
+        message: '用于录音、语音输入或通话相关功能。授权只会在相关功能中使用。',
+    },
+    photos: {
+        title: '需要访问相册',
+        message: '用于选择图片或视频，并完成上传、预览等操作。',
+    },
+    notification: {
+        title: '需要发送通知',
+        message: '用于接收重要提醒和状态更新，你可以随时在系统设置中调整。',
+    },
+    contacts: {
+        title: '需要访问通讯录',
+        message: '用于联系人选择、邀请或信息补全。授权只会在相关功能中使用。',
+    },
+    calendar: {
+        title: '需要访问日历',
+        message: '用于创建、读取或同步日程提醒。授权只会在相关功能中使用。',
+    },
+    bluetooth: {
+        title: '需要使用蓝牙',
+        message: '用于发现、连接或管理附近设备。授权只会在相关功能中使用。',
+    },
+    motion: {
+        title: '需要访问运动数据',
+        message: '用于识别运动状态或完成健康相关功能。授权只会在相关功能中使用。',
+    },
+};
+const DEFAULT_TITLE = '权限申请说明';
+const DEFAULT_PERMISSION = 'custom';
+const DEFAULT_TOP_OFFSET = (0, zkit_tools_1.wp)(8);
+const EXIT_DURATION_MS = 200;
+const PERMISSION_HOST_Z_INDEX = 9999;
+function isPresetPermission(permission) {
+    return Object.prototype.hasOwnProperty.call(DEFAULT_PURPOSE_TEXT, permission);
+}
+function normalizeText(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    return value.trim();
+}
+function normalizeDuration(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
+        return undefined;
+    return value;
+}
+function normalizeTopOffset(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return DEFAULT_TOP_OFFSET;
+    return Math.max(0, value);
+}
+function resolveOptions(options, id) {
+    var _a, _b, _c;
+    const rawPermission = (_a = options.permission) !== null && _a !== void 0 ? _a : DEFAULT_PERMISSION;
+    const permission = rawPermission === 'custom' || isPresetPermission(rawPermission) ? rawPermission : DEFAULT_PERMISSION;
+    const preset = isPresetPermission(permission) ? DEFAULT_PURPOSE_TEXT[permission] : null;
+    const title = normalizeText(options.title) || (preset === null || preset === void 0 ? void 0 : preset.title) || DEFAULT_TITLE;
+    const message = (_c = (_b = normalizeText(options.message)) !== null && _b !== void 0 ? _b : preset === null || preset === void 0 ? void 0 : preset.message) !== null && _c !== void 0 ? _c : '';
+    return {
+        id,
+        scopeKey: options.scopeKey,
+        permission,
+        title,
+        message,
+        topOffset: normalizeTopOffset(options.topOffset),
+    };
+}
+/**
+ * 权限用途说明弹窗服务类
+ * @internal
+ */
+class PermissionPurposeDialogServiceClass {
+    constructor() {
+        this.mounted = false;
+        this.idSeed = 0;
+        this.activeId = null;
+        this.activeOptions = null;
+        this.hideTimer = null;
+        this.setState = null;
+    }
+    /** @internal */
+    setMounted(mounted) {
+        this.mounted = mounted;
+        if (!mounted) {
+            this.activeId = null;
+            this.activeOptions = null;
+            this.clearHideTimer();
+        }
+    }
+    /** @internal */
+    setStateUpdater(updater) {
+        this.setState = updater;
+    }
+    /** 展示权限用途说明 */
+    show(options = {}) {
+        const id = this.createId();
+        if (!this.mounted || !this.setState) {
+            console.warn('[permissionPurposeDialog] Provider not mounted');
+            return this.createHandle(id);
+        }
+        this.openWithOptions(id, options);
+        return this.createHandle(id);
+    }
+    /** 关闭说明 */
+    hide() {
+        this.hideInternal();
+    }
+    /** 按 scopeKey 关闭 */
+    hideByScope(scopeKey) {
+        var _a;
+        if (!scopeKey)
+            return;
+        if (((_a = this.activeOptions) === null || _a === void 0 ? void 0 : _a.scopeKey) !== scopeKey)
+            return;
+        this.hideById(this.activeId);
+    }
+    /** @internal 清理所有定时器 */
+    clearAllTimers() {
+        this.clearHideTimer();
+    }
+    openWithOptions(id, options) {
+        var _a;
+        this.clearHideTimer();
+        this.activeId = id;
+        this.activeOptions = options;
+        const resolvedOptions = resolveOptions(options, id);
+        (_a = this.setState) === null || _a === void 0 ? void 0 : _a.call(this, { open: true, options: resolvedOptions });
+        const duration = normalizeDuration(options.duration);
+        if (duration != null) {
+            this.hideTimer = setTimeout(() => {
+                this.hideById(id);
+            }, duration);
+        }
+    }
+    hideInternal(id) {
+        if (id && id !== this.activeId)
+            return;
+        const closingId = this.activeId;
+        this.activeId = null;
+        this.activeOptions = null;
+        this.clearHideTimer();
+        if (!this.mounted || !this.setState)
+            return;
+        this.setState((prev) => {
+            if (closingId && prev.options.id !== closingId)
+                return prev;
+            if (!prev.open)
+                return prev;
+            return { ...prev, open: false };
+        });
+    }
+    /** 只关闭指定 id 的说明，避免旧流程误关新说明。 */
+    hideById(id) {
+        if (!id || id !== this.activeId)
+            return;
+        this.hideInternal(id);
+    }
+    /** 只更新指定 id 的说明。 */
+    updateById(id, patch) {
+        if (!id || id !== this.activeId || !this.activeOptions || !this.mounted || !this.setState) {
+            return;
+        }
+        this.openWithOptions(id, { ...this.activeOptions, ...patch });
+    }
+    createId() {
+        this.idSeed += 1;
+        return `permission_purpose_${Date.now()}_${this.idSeed}`;
+    }
+    createHandle(id) {
+        return {
+            id,
+            hide: () => this.hideById(id),
+            update: (patch) => this.updateById(id, patch),
+        };
+    }
+    clearHideTimer() {
+        if (this.hideTimer) {
+            clearTimeout(this.hideTimer);
+            this.hideTimer = null;
+        }
+    }
+}
+/** 权限用途说明弹窗服务实例 */
+exports.permissionPurposeDialog = new PermissionPurposeDialogServiceClass();
+const initialState = {
+    open: false,
+    options: resolveOptions({}, '__initial__'),
+};
+/** TopSheet 纯展示卡片 */
+function PermissionPurposeCard({ open, options, }) {
+    const insets = (0, react_native_safe_area_context_1.useSafeAreaInsets)();
+    const progress = React.useRef(new react_native_1.Animated.Value(open ? 1 : 0)).current;
+    const [visible, setVisible] = React.useState(open);
+    const accessibilityLabel = React.useMemo(() => {
+        if (!options.message)
+            return options.title;
+        return `${options.title}，${options.message}`;
+    }, [options.message, options.title]);
+    React.useEffect(() => {
+        return () => {
+            progress.stopAnimation();
+        };
+    }, [progress]);
+    React.useEffect(() => {
+        progress.stopAnimation();
+        if (open) {
+            setVisible(true);
+            // 入场直接显示，不做过渡。
+            // 因为 Android 系统权限弹框弹出后会冻结 App 动画线程，
+            // 若此处做动画，权限说明可能停在半透明状态，反而损害稳定性。
+            progress.setValue(1);
+            return;
+        }
+        if (!visible)
+            return;
+        // 退场：系统权限框关闭后 App 恢复正常，可以正常跑退出动画
+        react_native_1.Animated.timing(progress, {
+            toValue: 0,
+            duration: EXIT_DURATION_MS,
+            easing: react_native_1.Easing.out(react_native_1.Easing.cubic),
+            useNativeDriver: true,
+        }).start(({ finished }) => {
+            if (finished)
+                setVisible(false);
+        });
+    }, [open, options.id, progress, visible]);
+    const animatedStyle = React.useMemo(() => ({
+        opacity: progress,
+    }), [progress]);
+    if (!visible)
+        return null;
+    return ((0, jsx_runtime_1.jsx)(react_native_1.View, { pointerEvents: "none", style: [styles.host, { top: (insets.top || 0) + options.topOffset }], children: (0, jsx_runtime_1.jsx)(react_native_1.Animated.View, { accessible: open, accessibilityLabel: accessibilityLabel, accessibilityLiveRegion: "polite", accessibilityRole: "alert", importantForAccessibility: open ? 'yes' : 'no-hide-descendants', renderToHardwareTextureAndroid: react_native_1.Platform.OS === 'android', shouldRasterizeIOS: react_native_1.Platform.OS === 'ios', style: [
+                styles.sheet,
+                animatedStyle,
+            ], children: (0, jsx_runtime_1.jsxs)(react_native_1.View, { style: styles.content, children: [(0, jsx_runtime_1.jsx)(Text_1.Text, { style: styles.title, children: options.title }), options.message ? (0, jsx_runtime_1.jsx)(Text_1.Text, { style: styles.message, children: options.message }) : null] }) }) }));
+}
+/**
+ * 权限用途说明 Provider
+ * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ */
+function PermissionPurposeDialogProvider({ children }) {
+    const [state, setState] = React.useState(initialState);
+    React.useEffect(() => {
+        exports.permissionPurposeDialog.setMounted(true);
+        exports.permissionPurposeDialog.setStateUpdater(setState);
+        return () => {
+            exports.permissionPurposeDialog.clearAllTimers();
+            exports.permissionPurposeDialog.setStateUpdater(null);
+            exports.permissionPurposeDialog.setMounted(false);
+        };
+    }, []);
+    return ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [children, (0, jsx_runtime_1.jsx)(PermissionPurposeCard, { open: state.open, options: state.options })] }));
+}
+const styles = react_native_1.StyleSheet.create({
+    host: {
+        position: 'absolute',
+        left: (0, zkit_tools_1.wp)(0),
+        right: (0, zkit_tools_1.wp)(0),
+        alignItems: 'center',
+        zIndex: PERMISSION_HOST_Z_INDEX,
+        elevation: react_native_1.Platform.OS === 'android' ? PERMISSION_HOST_Z_INDEX : 0,
+    },
+    sheet: {
+        width: (0, zkit_tools_1.wp)(340),
+        maxWidth: '94%',
+        borderRadius: (0, zkit_tools_1.wp)(12),
+        backgroundColor: '#FFFFFF',
+        shadowColor: '#000000',
+        shadowOpacity: 0.12,
+        shadowOffset: { width: (0, zkit_tools_1.wp)(0), height: (0, zkit_tools_1.wp)(4) },
+        shadowRadius: (0, zkit_tools_1.wp)(12),
+        elevation: 8,
+    },
+    content: {
+        paddingHorizontal: (0, zkit_tools_1.wp)(16),
+        paddingVertical: (0, zkit_tools_1.wp)(14),
+    },
+    title: {
+        fontSize: (0, zkit_tools_1.wp)(15),
+        lineHeight: (0, zkit_tools_1.wp)(20),
+        fontWeight: '600',
+        color: '#111111',
+    },
+    message: {
+        marginTop: (0, zkit_tools_1.wp)(6),
+        fontSize: (0, zkit_tools_1.wp)(13),
+        lineHeight: (0, zkit_tools_1.wp)(18),
+        color: '#333333',
+    },
+});

package/dist/services/PickerService/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * @file PickerService - 命令式选择器服务
+ * @description 提供 pick、pickDate、pickAddress、pickBetweenTime 等方法
+ * @example
+ * ```tsx
+ * import { pickerService } from 'zkit-ui';
+ *
+ * const result = await pickerService.pick({ options: [...], value: 'id' });
+ * const date = await pickerService.pickDate({ value: '2024-01-01' });
+ * ```
+ */
+import * as React from 'react';
+import { type PickerConfirmPayload, type PickerValue, type PickerProps } from '../../ui/Picker';
+import { type DatePickerProps, type DatePickerValue } from '../../ui/DatePicker';
+import { type AddressCascaderOption, type AddressCascaderProps, type AddressCascaderValue } from '../../ui/AddressCascader';
+import { type BetweenTimeProps } from '../../ui/BetweenTime';
+/** 通用选择器返回结果 */
+export type PickerResult = {
+    /** 选中值 */
+    value: PickerValue;
+    /** 选中值数组（多列时） */
+    values: PickerConfirmPayload['values'];
+    /** 选中项文本 */
+    label: string;
+    /** 选中项文本数组（多列时） */
+    labels: string[];
+    /** 选中项数据 */
+    items: PickerConfirmPayload['items'];
+} | null;
+/** 日期选择器返回结果 */
+export type DatePickerResult = {
+    /** 选中日期值 */
+    value: DatePickerValue;
+    /** 格式化后的日期文本 */
+    label: string;
+} | null;
+/** 地址选择器返回结果 */
+export type AddressPickerResult = {
+    /** 选中地址码数组 */
+    value: AddressCascaderValue;
+    /** 选中地址码数组 */
+    values: string[];
+    /** 完整地址文本 */
+    label: string;
+    /** 各级地址文本数组 */
+    labels: string[];
+    /** 选中项数据 */
+    items: AddressCascaderOption[];
+} | null;
+/** 时间区间选择器返回结果 */
+export type BetweenTimePickerResult = {
+    /** 时间区间 [开始, 结束] */
+    value: string[];
+} | null;
+/** 通用选择器配置 */
+export type PickOptions = Omit<PickerProps, 'open' | 'onOpenChange' | 'onConfirm' | 'onCancel' | 'children' | 'onDismissComplete'>;
+/** 日期选择器配置 */
+export type PickDateOptions = Omit<DatePickerProps, 'open' | 'onOpenChange' | 'onConfirm' | 'onCancel' | 'children' | 'onDismissComplete'>;
+/** 地址选择器配置 */
+export type PickAddressOptions = Omit<AddressCascaderProps, 'open' | 'onOpenChange' | 'onConfirm' | 'onCancel' | 'children' | 'onDismissComplete'>;
+/** 时间区间选择器配置 */
+export type PickBetweenTimeOptions = Omit<BetweenTimeProps, 'open' | 'onOpenChange' | 'onConfirm' | 'onCancel' | 'children' | 'onDismissComplete'>;
+type PickerType = 'picker' | 'date' | 'address' | 'betweenTime';
+type PickerRequestMap = {
+    picker: {
+        options: PickOptions;
+        result: PickerResult;
+    };
+    date: {
+        options: PickDateOptions;
+        result: DatePickerResult;
+    };
+    address: {
+        options: PickAddressOptions;
+        result: AddressPickerResult;
+    };
+    betweenTime: {
+        options: PickBetweenTimeOptions;
+        result: BetweenTimePickerResult;
+    };
+};
+type PickerRequestResult = PickerRequestMap[PickerType]['result'];
+type PickerRequest<T extends PickerType = PickerType> = {
+    [K in T]: {
+        id: string;
+        type: K;
+        options: PickerRequestMap[K]['options'];
+        resolve: ((result: PickerRequestResult) => void) | null;
+    };
+}[T];
+type PickerState = {
+    activeRequest: PickerRequest | null;
+    queuedRequests: PickerRequest[];
+    open: boolean;
+};
+/**
+ * 选择器服务类
+ * @internal
+ */
+declare class PickerServiceClass {
+    private setState;
+    private sequence;
+    /** @internal 设置状态更新器 */
+    setStateUpdater(updater: React.Dispatch<React.SetStateAction<PickerState>> | null): void;
+    /** @internal 显示选择器 */
+    private show;
+    /** 打开通用选择器 */
+    pick(options: PickOptions): Promise<PickerResult>;
+    /** 打开日期选择器 */
+    pickDate(options?: PickDateOptions): Promise<DatePickerResult>;
+    /** 打开地址选择器 */
+    pickAddress(options?: PickAddressOptions): Promise<AddressPickerResult>;
+    /** 打开时间区间选择器 */
+    pickBetweenTime(options?: PickBetweenTimeOptions): Promise<BetweenTimePickerResult>;
+    /** 关闭当前选择器 */
+    close(): void;
+}
+/** 选择器服务实例 */
+export declare const pickerService: PickerServiceClass;
+/**
+ * 选择器服务 Provider
+ * @description 需要在应用根组件中包裹，已内置于 ComponentLibProvider
+ */
+export declare function PickerServiceProvider({ children }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/services/PickerService/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/PickerService/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI1E,gBAAgB;AAChB,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU;IACV,KAAK,EAAE,WAAW,CAAC;IACnB,iBAAiB;IACjB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvC,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY;IACZ,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;CACtC,GAAG,IAAI,CAAC;AAET,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,YAAY;IACZ,KAAK,EAAE,eAAe,CAAC;IACvB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAAC;AAET,gBAAgB;AAChB,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc;IACd,KAAK,EAAE,oBAAoB,CAAC;IAC5B,cAAc;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY;IACZ,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC,GAAG,IAAI,CAAC;AAET,kBAAkB;AAClB,MAAM,MAAM,uBAAuB,GAAG;IACpC,oBAAoB;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,IAAI,CAAC;AAET,cAAc;AACd,MAAM,MAAM,WAAW,GAAG,IAAI,CAC5B,WAAW,EACX,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,mBAAmB,CACtF,CAAC;AACF,cAAc;AACd,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,eAAe,EACf,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,mBAAmB,CACtF,CAAC;AACF,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,oBAAoB,EACpB,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,mBAAmB,CACtF,CAAC;AACF,gBAAgB;AAChB,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,gBAAgB,EAChB,MAAM,GAAG,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,mBAAmB,CACtF,CAAC;AAEF,KAAK,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;AAEhE,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE;QACN,OAAO,EAAE,WAAW,CAAC;QACrB,MAAM,EAAE,YAAY,CAAC;KACtB,CAAC;IACF,IAAI,EAAE;QACJ,OAAO,EAAE,eAAe,CAAC;QACzB,MAAM,EAAE,gBAAgB,CAAC;KAC1B,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,kBAAkB,CAAC;QAC5B,MAAM,EAAE,mBAAmB,CAAC;KAC7B,CAAC;IACF,WAAW,EAAE;QACX,OAAO,EAAE,sBAAsB,CAAC;QAChC,MAAM,EAAE,uBAAuB,CAAC;KACjC,CAAC;CACH,CAAC;AAEF,KAAK,mBAAmB,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC;AAElE,KAAK,aAAa,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,IAAI;KACrD,CAAC,IAAI,CAAC,GAAG;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,CAAC,CAAC;QACR,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;KACzD;CACF,CAAC,CAAC,CAAC,CAAC;AAML,KAAK,WAAW,GAAG;IACjB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAIF;;;GAGG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAAkE;IAClF,OAAO,CAAC,QAAQ,CAAK;IAErB,wBAAwB;IACxB,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI;IAIjF,sBAAsB;IACtB,OAAO,CAAC,IAAI;IA8BZ,cAAc;IACd,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAIjD,cAAc;IACd,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIlE,cAAc;IACd,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI3E,gBAAgB;IAChB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIvF,cAAc;IACd,KAAK;CAMN;AAED,cAAc;AACd,eAAO,MAAM,aAAa,oBAA2B,CAAC;AAUtD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAwLhF"}