@anker-in/headless-ui 1.1.28-alpha.1768202456200 → 1.1.29

package/dist/cjs/biz-components/WheelLottery/types.d.ts

@@ -1,1219 +0,0 @@
-/**
- * 大转盘抽奖组件（WheelLottery）类型定义
- *
- * @module WheelLotteryTypes
- * @date 2025-12-17
- */
-import type { Theme, Img } from '../../types/props.js';
-/**
- * WheelLottery 组件命令式控制接口
- *
- * 通过 ref 暴露给父组件，用于外部控制弹窗等状态
- *
- * @example
- * ```tsx
- * const lotteryRef = useRef<WheelLotteryHandle>(null)
- *
- * <WheelLottery ref={lotteryRef} prizes={prizes} />
- *
- * // 外部触发错误弹窗
- * lotteryRef.current?.showError({
- *   title: 'Network Error',
- *   message: 'Failed to connect to server',
- *   confirmText: 'Retry'
- * })
- *
- * // 显示规则弹窗
- * lotteryRef.current?.showRules()
- *
- * // 关闭所有弹窗
- * lotteryRef.current?.hideAllModals()
- * ```
- */
-export interface WheelLotteryHandle {
-    /**
-     * 显示错误弹窗
-     * @param config 错误弹窗配置
-     */
-    showError: (config: {
-        /** 错误信息 */
-        message: string;
-        /** 标题（可选） */
-        title?: string;
-        /** 确认按钮文本（可选） */
-        confirmText?: string;
-    }) => void;
-    /**
-     * 隐藏错误弹窗
-     */
-    hideError: () => void;
-    /**
-     * 显示未中奖弹窗（使用 ErrorModal）
-     * @param config 未中奖弹窗配置
-     */
-    showNoWin: (config?: {
-        /** 标题（可选） */
-        title?: string;
-        /** 提示信息（可选） */
-        message?: string;
-        /** 确认按钮文本（可选） */
-        confirmText?: string;
-    }) => void;
-    /**
-     * 隐藏未中奖弹窗
-     */
-    hideNoWin: () => void;
-    /**
-     * 显示中奖弹窗
-     * @param prize 中奖奖品
-     * @param config 中奖弹窗配置（可选）
-     */
-    showWinner: (prize: Prize, config?: Partial<WinnerModalConfig>) => void;
-    /**
-     * 隐藏中奖弹窗
-     */
-    hideWinner: () => void;
-    /**
-     * 显示规则弹窗
-     */
-    showRules: () => void;
-    /**
-     * 隐藏规则弹窗
-     */
-    hideRules: () => void;
-    /**
-     * 显示我的奖励弹窗
-     */
-    showRewards: () => void;
-    /**
-     * 隐藏我的奖励弹窗
-     */
-    hideRewards: () => void;
-    /**
-     * 显示分享弹窗
-     * @param config 分享弹窗配置（可选）
-     */
-    showShare: (config?: Partial<ShareModalConfig>) => void;
-    /**
-     * 隐藏分享弹窗
-     */
-    hideShare: () => void;
-    /**
-     * 关闭所有弹窗
-     */
-    hideAllModals: () => void;
-}
-/**
- * 默认转盘指针图片 URL
- */
-export declare const DEFAULT_POINTER_IMAGE = "https://cdn.shopify.com/s/files/1/0517/2199/4432/files/2790697ba78c1a85d953787a8be9b258.png?v=1766371471";
-export declare const DEFAULT_POINTER_DISABLE_IMAGE = "https://cdn.shopify.com/s/files/1/0582/4669/3040/files/2790697ba78c1a85d953787a8be9b258.png?v=1767610632";
-/**
- * 默认转盘底图（6 个奖品）
- */
-export declare const DEFAULT_WHEEL_BG_6_PRIZES = "https://cdn.shopify.com/s/files/1/0517/2199/4432/files/be866c03-4d29-4d59-a8d4-39f5d64bbc0e_ae_e_6.png?v=1766374361";
-/**
- * 默认转盘底图（8 个奖品）
- */
-export declare const DEFAULT_WHEEL_BG_8_PRIZES = "https://cdn.shopify.com/s/files/1/0517/2199/4432/files/ad63174a-3da0-4dcd-ac61-c83172c7893c_ae_e_8.png?v=1766374392";
-/**
- * 奖品（Prize）
- *
- * 代表转盘上的一个奖品区块，包含显示所需的所有信息。
- *
- * @example
- * ```tsx
- * const prize: Prize = {
- *   prizeKey: 'prize-001',
- *   name: 'Anker Prime Charger (100W, 3 Ports, GaN)',
- *   image: { url: 'https://images.unsplash.com/photo-123', alt: 'Charger' },
- *   rank: '1st',
- *   price: '$79.99'
- * }
- * ```
- */
-export interface Prize {
-    /**
-     * 唯一标识符，用于 React key 和中奖结果匹配
-     */
-    prizeKey: string;
-    /**
-     * 奖品名称，显示在转盘和奖池中
-     * @maxLength 100
-     */
-    name: string;
-    /**
-     * 奖品图片对象，包含 url 和 alt
-     */
-    image: Img;
-    /**
-     * 排名标识，仅在 Prize Pool 中显示
-     * @optional
-     */
-    rank?: '1st' | '2nd' | '3rd';
-    /**
-     * 价格或折扣信息，显示在奖池中
-     * @example "$99.99" | "12% Off"
-     * @optional
-     */
-    price?: string;
-}
-/**
- * 中奖信息（WinningInfo）
- *
- * 代表一条中奖记录，用于底部滚动条展示，营造活动氛围。
- *
- * @example
- * ```tsx
- * const winningInfo: WinningInfo = {
- *   winningKey: 'win-001',
- *   userName: 'Shuqi***',
- *   prizeName: '12% Off Discount',
- *   timestamp: 1702800000000
- * }
- * ```
- */
-export interface WinningInfo {
-    /**
-     * 唯一标识符
-     */
-    winningKey: string;
-    /**
-     * 用户名（已脱敏），如 "Shuqi***"
-     * @note 假设传入的用户名已经过脱敏处理，组件内部不再处理
-     */
-    userName: string;
-    /**
-     * 中奖奖品名称
-     */
-    prizeName: string;
-    /**
-     * 中奖时间戳（毫秒）
-     * @optional
-     */
-    timestamp?: number;
-}
-/**
- * 获取机会方式类型
- */
-export type ChanceMethodType = 'share' | 'points' | 'refer' | string;
-/**
- * 获取机会方式状态
- */
-export type ChanceMethodStatus = 'pending' | 'completed' | 'used';
-/**
- * 获取机会方式（ChanceMethod）
- *
- * 代表一种获取抽奖机会的方式，支持灵活配置（分享、积分、推荐等）。
- *
- * @example
- * ```tsx
- * const chanceMethod: ChanceMethod = {
- *   methodKey: 'share-001',
- *   type: 'share',
- *   title: 'Share on your socials',
- *   description: 'Share this event on your social media',
- *   buttonText: 'Redeem now',
- *   onClick: () => console.log('Share clicked'),
- *   disabled: false,
- *   status: 'pending'
- * }
- * ```
- */
-export interface ChanceMethod {
-    /**
-     * 唯一标识符
-     */
-    methodKey: string;
-    /**
-     * 方式类型，支持预定义类型（'share', 'points', 'refer'）或自定义类型
-     */
-    type: ChanceMethodType;
-    /**
-     * 方式标题，如 "Share on your socials"
-     */
-    title: string;
-    /**
-     * 详细说明文字
-     */
-    description: string;
-    /**
-     * 按钮文案，默认 "Redeem now"
-     * @default "Redeem now"
-     * @optional
-     */
-    buttonText?: string;
-    completed?: string;
-    used?: string;
-    /**
-     * 未登录时点击 GO 按钮的回调
-     * @example
-     * ```tsx
-     * onLoginRequired={() => {
-     *   // 打开登录弹窗或跳转登录页
-     *   router.push('/login')
-     * }}
-     * ```
-     */
-    onLoginRequired: () => void;
-    /**
-     * 点击按钮时的回调函数
-     * @note 业务逻辑（如积分扣除、分享验证）由父组件处理
-     */
-    onClick: () => void;
-    /**
-     * 是否禁用该方式
-     * @default false
-     * @optional
-     */
-    disabled?: boolean;
-    /**
-     * 获取机会方式的状态
-     * - pending: 未完成（默认状态）
-     * - completed: 已完成/已获得
-     * - used: 已使用
-     * @default "pending"
-     * @optional
-     */
-    status?: ChanceMethodStatus;
-    /**
-     * 是否显示加载状态
-     * @default false
-     * @optional
-     */
-    loading?: boolean;
-    /**
-     * 是否在点击时打开分享弹窗
-     * @default false
-     * @optional
-     */
-    openShareModal?: boolean;
-}
-/**
- * 用户数据（UserData）
- *
- * 代表当前用户的抽奖相关数据
- *
- * @example
- * ```tsx
- * const userData: UserData = {
- *   isLoggedIn: true,
- *   availableChances: 3,
- *   wonPrizes: [
- *     { id: 'prize-001', name: 'Charger', image: 'https://...', timestamp: 1702800000000 }
- *   ]
- * }
- * ```
- */
-export interface UserData {
-    /**
-     * 用户是否已登录
-     */
-    isLoggedIn: boolean;
-    /**
-     * 当前可使用的抽奖次数
-     * @default 0
-     */
-    availableChances: number;
-    /**
-     * 总机会数（用于显示进度，例如 "3/5"）
-     * @default undefined
-     * @optional
-     */
-    totalChances?: number;
-    /**
-     * 已获得的奖品列表
-     * @optional
-     */
-    wonPrizes?: Array<Prize & {
-        timestamp?: number;
-    }>;
-    /**  * 用户电子邮箱（可选，用于发送中奖通知等）
-     * @optional
-     */
-    email?: string;
-}
-/**
- * 缓动函数类型
- */
-export type EasingFunction = 'ease-out' | 'ease-in-out' | 'linear';
-/**
- * 中奖弹窗配置（WinnerModalConfig）
- *
- * 用于配置中奖弹窗的展示内容，通常由抽奖接口返回提供
- *
- * @example
- * ```tsx
- * const winnerModalConfig: WinnerModalConfig = {
- *   title: 'Congratulations!',
- *   prizeTitle: 'Anker Prime Charger',
- *   prizeImage: 'https://...',
- *   prizeDescription: 'High-speed charging for all your devices',
- *   learnMoreUrl: 'https://...',
- *   learnMoreText: 'View Details',
- *   couponCode: 'ANKER2024',
- *   expiresAt: '2024-12-31',
- *   couponDiscount: '20%',
- *   couponUnit: 'Off',
- *   confirmText: 'Claim Now'
- * }
- * ```
- */
-export interface WinnerModalConfig {
-    /**
-     * 中奖弹窗标题
-     * @default "You Have Won"
-     * @optional
-     */
-    title?: string;
-    /**
-     * 中奖弹窗奖品标题（优先级高于 prize.name）
-     * @optional
-     */
-    prizeTitle?: string;
-    /**
-     * 中奖弹窗奖品图片 URL（优先级高于 prize.image）
-     * @optional
-     */
-    prizeImage?: string;
-    /**
-     * 中奖弹窗奖品详情描述
-     * @optional
-     */
-    prizeDescription?: string;
-    /**
-     * 中奖弹窗 Learn More 链接
-     * @optional
-     */
-    learnMoreUrl?: string;
-    /**
-     * 中奖弹窗 Learn More 按钮文本
-     * @default "Learn More"
-     * @optional
-     */
-    learnMoreText?: string;
-    /**
-     * 中奖弹窗优惠码
-     * @optional
-     */
-    couponCode?: string;
-    /**
-     * 复制按钮文本
-     * @default "COPY"
-     * @optional
-     */
-    copyText?: string;
-    /**
-     * 代码文本前缀
-     * @default "CODE:"
-     * @optional
-     */
-    codeText?: string;
-    /**
-     * 中奖弹窗优惠码过期时间
-     * @optional
-     */
-    expiresAt?: string;
-    /**
-     * 中奖弹窗优惠券折扣文本（例如 "20%"）
-     * @optional
-     */
-    couponDiscount?: string;
-    /**
-     * 中奖弹窗优惠券单位文本
-     * @default "Off"
-     * @optional
-     */
-    couponUnit?: string;
-    /**
-     * 中奖弹窗确认按钮文本
-     * @default "Okay, Got It"
-     * @optional
-     */
-    confirmText?: string;
-}
-/**
- * Rules 弹窗配置
- *
- * @example
- * ```tsx
- * rulesModalConfig={{
- *   rulesData: [
- *     { title: 'Rule 1', content: 'Description...' },
- *     { title: 'Rule 2', content: ['Point 1', 'Point 2'] }
- *   ],
- *   rulesText: 'Game Rules',
- *   rulesTitle: 'Activity Rules'
- * }}
- * ```
- */
-export interface RulesModalConfig {
-    /**
-     * 规则数据列表
-     * @optional
-     */
-    rulesData?: Array<{
-        /**
-         * 规则标题
-         */
-        title: string;
-        /**
-         * 规则内容（支持字符串或字符串数组）
-         */
-        content: string | string[];
-    }>;
-    /**
-     * Rules 按钮文本
-     * @default "Rules"
-     * @optional
-     */
-    rulesText?: string;
-    /**
-     * 弹窗标题
-     * @default "Rules"
-     * @optional
-     */
-    rulesTitle?: string;
-}
-/**
- * My Rewards 弹窗配置
- *
- * @example
- * ```tsx
- * myRewardsModalConfig={{
- *   rewardsData: [
- *     {
- *       id: '1',
- *       name: 'Anker Charger',
- *       code: 'ANKER2024',
- *       status: 'Available',
- *       prizeTime: '2024-01-01',
- *       showCopyCode: true
- *     }
- *   ],
- *   myRewardsText: 'My Prizes',
- *   codeText: 'CODE:',
- *   copyText: 'COPY',
- *   prizeText: 'Prize time:',
- *   emptyText: 'No rewards yet'
- * }}
- * ```
- */
-export interface MyRewardsModalConfig {
-    /**
-     * 奖励数据列表
-     * @optional
-     */
-    rewardsData?: Array<{
-        /**
-         * 奖励 ID
-         */
-        id: string;
-        /**
-         * 奖励名称
-         */
-        name: string;
-        /**
-         * 优惠码（可选）
-         */
-        code?: string;
-        /**
-         * 状态
-         */
-        status: 'Available' | 'Expired' | 'Used';
-        /**
-         * 奖励时间
-         */
-        prizeTime?: string;
-        /**
-         * 是否可复制码
-         */
-        showCopyCode?: boolean;
-    }>;
-    /**
-     * My Rewards 按钮文本
-     * @default "My Rewards"
-     * @optional
-     */
-    myRewardsText?: string;
-    /**
-     * 弹窗标题
-     * @default "My Rewards"
-     * @optional
-     */
-    myRewardsTitle?: string;
-    /**
-     * 代码文本前缀
-     * @default "CODE:"
-     * @optional
-     */
-    codeText?: string;
-    /**
-     * 复制按钮文本
-     * @default "COPY"
-     * @optional
-     */
-    copyText?: string;
-    /**
-     * 奖励时间文本前缀
-     * @default "Prize time:"
-     * @optional
-     */
-    prizeText?: string;
-    /**
-     * 空状态提示文本
-     * @default "No rewards yet"
-     * @optional
-     */
-    emptyText?: string;
-}
-/**
- * 错误弹窗配置
- * @example
- * ```tsx
- * errorModalConfig={{
- *  title: 'Oops!',
- *  message: 'Something went wrong during the lottery process.',
- * confirmText: 'OK, I get'
- * }}
- * ```
- */
-export interface ErrorModalConfig {
-    /**
-     * 弹窗标题
-     * @default "Oops!"
-     * @optional
-     */
-    title?: string;
-    /**
-     * 错误消息内容
-     * @default "Something went wrong during the lottery process."
-     * @optional
-     */
-    message?: string;
-    /**
-     * 确认按钮文本
-     * @default "OK, I get"
-     * @optional
-     */
-    confirmText?: string;
-}
-/**
- * 社交平台类型
- */
-export type SocialPlatform = 'facebook' | 'twitter' | 'instagram' | 'linkedin' | 'tiktok' | 'youtube';
-/**
- * 社交平台配置
- */
-export interface SharePlatformConfig {
-    /**
-     * 平台类型
-     */
-    platform: SocialPlatform;
-    /**
-     * 平台名称
-     */
-    name: string;
-    /**
-     * 分享 URL（可选，如果提供则直接跳转）
-     */
-    url?: string;
-    /**
-     * 点击回调（如果提供 url 则此回调会在跳转前执行）
-     */
-    onClick?: () => void;
-    /**
-     * 是否禁用
-     */
-    disabled?: boolean;
-}
-/**
- * 分享弹窗配置
- */
-export interface ShareModalConfig {
-    /**
-     * 弹窗标题
-     * @default "Share to Get More Chances"
-     */
-    title?: string;
-    /**
-     * 副标题/引导文案
-     * @default "Share to Play Again Keep Trying! You Could Still Win Big!"
-     */
-    subtitle?: string;
-    /**
-     * 底部提示文案
-     * @default "Note: Maximum of 3 times per participant."
-     */
-    note?: string;
-    /**
-     * 社交平台配置列表
-     */
-    platforms?: SharePlatformConfig[];
-    /**
-     * 分享成功回调
-     */
-    onShareSuccess?: (platform: SocialPlatform) => void;
-}
-/**
- * WheelLottery 组件 Props
- *
- * @example
- * ```tsx
- * <WheelLottery
- *   prizes={prizes}
- *   winningPrizeId="prize-003"
- *   spinDuration={4000}
- *   easing="ease-out"
- *   chanceMethods={chanceMethods}
- *   chanceTitle="Want more chances to win?"
- *   winningInfos={winningInfos}
- *   onSpinStart={() => console.log('Spin started')}
- *   onSpinEnd={(prize) => alert(`You won ${prize.name}`)}
- * />
- * ```
- */
-export interface WheelLotteryProps {
-    /**
-     * 8 个奖品数组（必需）
-     * @minLength 8
-     * @maxLength 8
-     * @validation 如果长度不等于 8，应在开发环境下输出警告
-     */
-    prizes: Prize[];
-    /**
-     * 主题色
-     */
-    theme?: Theme;
-    /**
-     * 指定中奖奖品的 ID，用于测试或服务端决定结果
-     * @note 必须是 prizes 数组中某个 Prize 的 id
-     * @optional
-     */
-    winningPrizeId?: string;
-    /**
-     * 旋转时长（毫秒）
-     * @default 4000
-     * @range 3000-5000
-     * @optional
-     */
-    spinDuration?: number;
-    /**
-     * 缓动函数
-     * @default "ease-out"
-     * @optional
-     */
-    easing?: EasingFunction;
-    /**
-     * 转盘底图 URL（支持 6 个或 8 个奖品的背景图）
-     * @default 根据 prizes.length 自动选择 6 或 8 奖品底图
-     * @optional
-     */
-    wheelBackgroundImage?: string;
-    /**
-     * 转盘指针图片 URL
-     * @default 默认指针图片
-     * @optional
-     */
-    pointerImage?: string;
-    /**
-     * 获取机会方式数组
-     * @default DEFAULT_CHANCE_METHODS（3种默认方式：分享、积分、推荐）
-     * @note 当数组为空时，隐藏整个"获取机会"区域
-     * @optional
-     */
-    chanceMethods?: ChanceMethod[];
-    /**
-     * 获取机会区域标题
-     * @default "Want more chances to win?"
-     * @optional
-     */
-    chanceTitle?: string;
-    /**
-     * 获取机会区域副标题
-     * @optional
-     */
-    chanceSubtitle?: string;
-    /**
-     * 获取机会区域底部提示
-     * @optional
-     */
-    chanceFooterNote?: string;
-    /**
-     * 中奖信息数组，用于底部滚动条展示
-     * @default []
-     * @note 当数组为空时，隐藏底部滚动条或显示默认提示
-     * @optional
-     */
-    winningInfos?: WinningInfo[];
-    /**
-     * 抽奖开始时的回调，返回 Promise 以支持异步接口调用
-     * @returns Promise<string> - 中奖奖品的 ID，如果接口失败则 reject
-     * @optional
-     * @example
-     * ```tsx
-     * onSpinStart={async () => {
-     *   const result = await fetch('/api/lottery')
-     *   const data = await result.json()
-     *   return data.prizeId // 返回中奖奖品 ID
-     * }}
-     * ```
-     */
-    onSpinStart?: () => Promise<string>;
-    /**
-     * 抽奖结束时的回调，传递中奖奖品
-     * @param prize 中奖奖品对象
-     * @optional
-     */
-    onSpinEnd?: (prize: Prize) => void;
-    /**
-     * 抽奖错误时的回调
-     * @param error 错误信息
-     * @optional
-     */
-    onSpinError?: (error: Error) => void;
-    /**
-     * 中奖弹窗配置对象，通常由抽奖接口返回提供
-     * @optional
-     * @example
-     * ```tsx
-     * winnerModalConfig={{
-     *   title: 'Congratulations!',
-     *   prizeTitle: 'Anker Prime Charger',
-     *   prizeImage: 'https://...',
-     *   prizeDescription: 'High-speed charging',
-     *   learnMoreUrl: 'https://...',
-     *   couponCode: 'ANKER2024',
-     *   expiresAt: '2024-12-31',
-     *   couponDiscount: '20%',
-     *   confirmText: 'Claim Now'
-     * }}
-     * ```
-     */
-    winnerModalConfig?: WinnerModalConfig;
-    rulesModalConfig?: RulesModalConfig;
-    myRewardsModalConfig?: MyRewardsModalConfig;
-    errorModalConfig?: ErrorModalConfig;
-    /**
-     * 分享弹窗配置
-     * @optional
-     */
-    shareModalConfig?: ShareModalConfig;
-    /**
-     * 未登录时点击 GO 按钮的回调
-     * @example
-     * ```tsx
-     * onLoginRequired={() => {
-     *   // 打开登录弹窗或跳转登录页
-     *   router.push('/login')
-     * }}
-     * ```
-     */
-    onLoginRequired: () => void;
-    /**
-     * 用户数据
-     * @optional
-     * @example
-     * ```tsx
-     * userData={{
-     *   isLoggedIn: true,
-     *   availableChances: 3,
-     *   wonPrizes: [{ id: 'prize-001', name: 'Charger', image: 'https://...' }]
-     * }}
-     * ```
-     */
-    userData?: UserData;
-    /**
-     * 未登录时的提示文案
-     * @default "Please log in to participate"
-     * @optional
-     */
-    loginPromptText?: string;
-    /**
-     * 登录按钮文案
-     * @default "Log In"
-     * @optional
-     */
-    loginButtonText?: string;
-    /**
-     * 次数不足时的提示文案
-     * @default "You have no chances left"
-     * @optional
-     */
-    noChancesText?: string;
-    /**
-     * 复制优惠码回调
-     * @optional
-     */
-    onCopyCode?: (code: string) => void;
-    /**
-     * Rules 按钮文本
-     * @default "Rules"
-     * @optional
-     */
-    rulesText?: string;
-    /**
-     * Opportunities 文本数组
-     * @default ["Accumulate", "lottery opportunities"]
-     * @optional
-     */
-    opportunitiesText?: string[];
-    /**
-     * My Rewards 按钮文本
-     * @default "My Rewards"
-     * @optional
-     */
-    myRewardsText?: string;
-    /**
-     * 未中奖弹窗标题
-     * @default "Sorry, You Didn't Win This Time"
-     * @optional
-     */
-    noWinTitle?: string;
-    /**
-     * 未中奖弹窗副标题
-     * @default "Keep Trying, You Could Still Win Big!"
-     * @optional
-     */
-    noWinSubtitle?: string;
-    /**
-     * My Rewards 弹窗无奖励时的提示文本
-     * @default "No rewards yet"
-     * @optional
-     */
-    rewardsEmptyText?: string;
-    /**
-     * My Rewards 弹窗 CODE 标签文本
-     * @default "CODE:"
-     * @optional
-     */
-    rewardsCodeLabel?: string;
-    /**
-     * My Rewards 弹窗复制按钮文本
-     * @default "Copy"
-     * @optional
-     */
-    rewardsCopyButtonText?: string;
-    /**
-     * My Rewards 弹窗奖励时间标签文本
-     * @default "Prize time:"
-     * @optional
-     */
-    rewardsPrizeTimeLabel?: string;
-    /**
-     * 弹窗关闭按钮的 aria-label
-     * @default "关闭弹窗"
-     * @optional
-     */
-    modalCloseButtonAriaLabel?: string;
-    /**
-     * 自定义 CSS 类名，用于覆盖或扩展默认样式
-     * @optional
-     */
-    className?: string;
-}
-/**
- * 默认获取机会方式（3种）
- * @note 父组件需要覆盖 onClick 回调以实现具体业务逻辑
- */
-export declare const DEFAULT_CHANCE_METHODS: ChanceMethod[];
-/**
- * 默认转盘配置
- */
-export declare const DEFAULT_WHEEL_CONFIG: {
-    spinDuration: number;
-    easing: EasingFunction;
-    chanceTitle: string;
-};
-/**
- * 转盘运行时状态（组件内部使用）
- * @internal
- */
-export interface WheelState {
-    /**
-     * 转盘是否正在旋转
-     */
-    isSpinning: boolean;
-    /**
-     * 当前旋转角度（度数）
-     */
-    currentRotation: number;
-    /**
-     * 中奖奖品，抽奖结束后设置
-     */
-    winningPrize: Prize | null;
-    /**
-     * GO 按钮是否禁用
-     */
-    isButtonDisabled: boolean;
-    /**
-     * 是否已完成抽奖（用于控制转盘是否显示初始旋转动画）
-     */
-    isFinished: boolean;
-}
-/**
- * 初始转盘状态
- * @internal
- */
-export declare const INITIAL_WHEEL_STATE: WheelState;
-/**
- * Wheel 转盘组件 Props
- */
-export interface WheelProps {
-    /**
-     * 主题模式
-     * @optional
-     */
-    theme?: Theme;
-    /**
-     * 8 个奖品数组
-     */
-    prizes: Prize[];
-    /**
-     * 当前旋转角度(度数)
-     */
-    rotation: number;
-    /**
-     * 是否正在旋转
-     */
-    isSpinning: boolean;
-    /**
-     * 是否已完成抽奖（用于控制转盘是否显示初始旋转动画）
-     */
-    isFinished?: boolean;
-    /**
-     * GO 按钮是否禁用
-     */
-    isButtonDisabled: boolean;
-    /**
-     * GO 按钮点击回调
-     */
-    onGoClick: () => void;
-    /**
-     * 转盘底图 URL（可选）
-     */
-    wheelBackgroundImage?: string;
-    /**
-     * 转盘指针图片 URL（可选）
-     */
-    pointerImage?: string;
-    /**
-     * 登录用户数据（可选）
-     * @optional
-     */
-    userData?: UserData;
-    /**
-     * 打开分享弹窗回调（可选）
-     * @optional
-     */
-    onOpenShareModal?: () => void;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * PrizePool 奖品池组件 Props
- */
-export interface PrizePoolProps {
-    /**
-     * 主题模式
-     * @optional
-     */
-    theme?: Theme;
-    /**
-     * 奖品列表(通常是全部 8 个奖品)
-     */
-    prizes: Prize[];
-    /**
-     * 标题文本
-     * @default "Prize Pool"
-     */
-    title?: string;
-    /**
-     * 中奖人名单数据
-     * @optional
-     */
-    winningInfos?: WinningInfo[];
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * ChanceMethods 获取机会组件 Props
- */
-export interface ChanceMethodsProps {
-    /**
-     * 主题模式
-     * @optional
-     */
-    theme?: Theme;
-    /**
-     * 获取机会方式列表
-     */
-    methods: ChanceMethod[];
-    /**
-     * 标题文本
-     * @default "Want more chances to win?"
-     */
-    title?: string;
-    /**
-     * 副标题(可选)
-     */
-    subtitle?: string;
-    /**
-     * 底部提示文本(可选)
-     */
-    footerNote?: string;
-    /**
-     * 登录用户数据（可选）
-     * @optional
-     */
-    userData?: UserData;
-    /**
-     * 打开分享弹窗回调（可选）
-     * @optional
-     */
-    onOpenShareModal?: () => void;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * WinnerModal 中奖弹窗组件 Props
- */
-export interface WinnerModalProps {
-    /**
-     * 是否显示弹窗
-     */
-    isOpen: boolean;
-    /**
-     * 中奖奖品信息
-     */
-    prize: Prize | null;
-    /**
-     * 弹窗标题（可选，默认 "You Have Won"）
-     */
-    title?: string;
-    /**
-     * 奖品标题（可选，默认使用 prize.name）
-     */
-    prizeTitle?: string;
-    /**
-     * 奖品图片 URL（可选，默认使用 prize.image）
-     */
-    prizeImage?: string;
-    /**
-     * 奖品详情描述（可选）
-     */
-    prizeDescription?: string;
-    /**
-     * Learn More 链接（可选）
-     */
-    learnMoreUrl?: string;
-    /**
-     * Learn More 按钮文本（可选，默认 "Learn More"）
-     */
-    learnMoreText?: string;
-    /**
-     * 优惠码（可选）
-     */
-    couponCode?: string;
-    /**
-     * 优惠码过期时间（可选）
-     */
-    expiresAt?: string;
-    /**
-     * 优惠券折扣文本（可选，例如 "20%"，为空时不显示优惠券）
-     */
-    couponDiscount?: string;
-    /**
-     * 优惠券单位文本（可选，默认 "Off"）
-     */
-    couponUnit?: string;
-    /**
-     * 复制码按钮前缀
-     * @default "CODE:"
-     */
-    codeText?: string;
-    /**
-     * 复制按钮文本
-     * @default "COPY"
-     */
-    copyText?: string;
-    /**
-     * 复制成功后的按钮文本
-     * @default "COPIED"
-     */
-    copiedText?: string;
-    /**
-     * 复制码点击回调
-     */
-    onCopyCode?: (code: string) => void;
-    /**
-     * 关闭弹窗回调
-     */
-    onClose: () => void;
-    /**
-     * 确认按钮文本（可选，默认 "Okay, Got It"）
-     */
-    confirmText?: string;
-    /**
-     * 确认按钮点击回调（可选）
-     */
-    onConfirm?: () => void;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * 验证结果
- */
-export interface ValidationResult {
-    valid: boolean;
-    error?: string;
-}
-/**
- * 奖品验证选项
- */
-export interface ValidatePrizesOptions {
-    /**
-     * 是否允许缺少 rank 字段
-     * @default true
-     */
-    allowMissingRank?: boolean;
-    /**
-     * 是否允许缺少 price 字段
-     * @default true
-     */
-    allowMissingPrice?: boolean;
-}
-/**
- * 检查是否为有效的 Prize 对象
- * @param value 待检查的值
- * @returns 是否为有效的 Prize
- */
-export declare function isPrize(value: unknown): value is Prize;
-/**
- * 检查是否为有效的 ChanceMethod 对象
- * @param value 待检查的值
- * @returns 是否为有效的 ChanceMethod
- */
-export declare function isChanceMethod(value: unknown): value is ChanceMethod;
-/**
- * 检查是否为有效的 WinningInfo 对象
- * @param value 待检查的值
- * @returns 是否为有效的 WinningInfo
- */
-export declare function isWinningInfo(value: unknown): value is WinningInfo;
-/**
- * 抽奖回调函数类型
- */
-export type OnSpinEndCallback = (prize: Prize) => void;
-/**
- * 获取机会点击回调函数类型
- */
-export type OnChanceMethodClick = () => void;