@taskon/widget-react 0.0.1-beta.5 → 0.0.1-beta.6

package/dist/index.d.ts

@@ -1,180 +1,24 @@
-import { CampaignStatusInfo } from '@taskon/core';
 import { CampaignWinnerReward } from '@taskon/core';
 import { ChainInfo } from '@taskon/core';
 import { ChainType } from '@taskon/core';
 import { CloudThemeConfig } from '@taskon/core';
 import { CommunityInfo } from '@taskon/core';
-import { CommunityTaskInfo } from '@taskon/core';
-import { ComponentPropsWithoutRef } from 'react';
 import { default as default_2 } from 'react';
-import { ElementType } from 'react';
-import { ForwardRefExoticComponent } from 'react';
-import { GtcUserTaskStatus } from '@taskon/core';
 import { LeaderboardContentConfig } from '@taskon/core';
 import { LoginResult } from '@taskon/core';
-import { MeetCondition } from '@taskon/core';
 import { PageBuilderConfig } from '@taskon/core';
-import { QuestApi } from '@taskon/core';
 import { QuestCampaignInfo } from '@taskon/core';
 import { ReactNode } from 'react';
-import { RecurrenceType } from '@taskon/core';
-import { RefAttributes } from 'react';
 import { RewardDisplayMode } from '@taskon/core';
 import { RewardType } from '@taskon/core';
 import { RewardValueInfo } from '@taskon/core';
 import { SnsType } from '@taskon/core';
 import { TaskOnClient } from '@taskon/core';
-import { TaskReviewResult } from '@taskon/core';
-import { UserCampaignStatusInfo } from '@taskon/core';
 import { UserCenterConfig } from '@taskon/core';
 import { UserCenterRewardCardType } from '@taskon/core';
 import { UserCenterTabType } from '@taskon/core';
 import { UserInfo } from '@taskon/core';
 
-/**
- * Button 通用按钮组件
- *
- * 基于 Radix UI Slot 实现，支持 asChild 模式
- *
- * @example
- * ```tsx
- * // 基础用法
- * <Button>点击我</Button>
- *
- * // 不同变体
- * <Button variant="primary">主要按钮</Button>
- * <Button variant="secondary">次要按钮</Button>
- * <Button variant="outline">描边按钮</Button>
- * <Button variant="ghost">幽灵按钮</Button>
- * <Button variant="danger">危险按钮</Button>
- *
- * // 不同尺寸
- * <Button size="small">小按钮</Button>
- * <Button size="medium">中等按钮</Button>
- * <Button size="large">大按钮</Button>
- *
- * // 加载状态
- * <Button loading>加载中</Button>
- *
- * // 带图标
- * <Button leftIcon={<Icon />}>左侧图标</Button>
- * <Button rightIcon={<Icon />}>右侧图标</Button>
- *
- * // 禁用状态
- * <Button disabled>禁用按钮</Button>
- *
- * // asChild 模式（将 Button 样式应用到子元素）
- * <Button asChild>
- *   <a href="/about">链接按钮</a>
- * </Button>
- * ```
- */
-export declare const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<HTMLButtonElement>>;
-
-/**
- * Button 组件属性
- */
-export declare interface ButtonProps extends ComponentPropsWithoutRef<"button"> {
-    /**
-     * 按钮尺寸
-     * @default "medium"
-     */
-    size?: ButtonSize;
-    /**
-     * 按钮变体
-     * @default "primary"
-     */
-    variant?: ButtonVariant;
-    /**
-     * 是否为加载状态
-     * @default false
-     */
-    loading?: boolean;
-    /**
-     * 图标位置
-     */
-    iconPosition?: "left" | "right" | "only";
-    /**
-     * 左侧图标
-     */
-    leftIcon?: ReactNode;
-    /**
-     * 右侧图标
-     */
-    rightIcon?: ReactNode;
-    /**
-     * 是否作为子元素渲染（使用 Radix Slot）
-     * 当为 true 时，Button 会将所有属性传递给第一个子元素
-     * @default false
-     */
-    asChild?: boolean;
-    /**
-     * 按钮内容
-     */
-    children?: ReactNode;
-}
-
-/**
- * Button 尺寸类型
- */
-export declare type ButtonSize = "small" | "medium" | "large";
-
-/**
- * Button 变体类型
- */
-export declare type ButtonVariant = "primary" | "secondary" | "outline" | "ghost" | "danger";
-
-/**
- * CardSelector 组件
- *
- * @example
- * ```tsx
- * const options = [
- *   { value: 'all', label: 'All Tasks' },
- *   { value: 1, label: 'Daily Tasks' },
- *   { value: 2, label: 'Weekly Tasks' },
- * ];
- *
- * <CardSelector
- *   options={options}
- *   value={selectedValue}
- *   onChange={setSelectedValue}
- *   allowDeselect
- * />
- * ```
- */
-export declare function CardSelector<T extends string | number = string | number>({ options, value, onChange, allowDeselect, className, itemClassName, }: CardSelectorProps<T>): default_2.ReactElement;
-
-/**
- * 选项配置
- */
-export declare interface CardSelectorOption<T = string | number> {
-    /** 选项的值 */
-    value: T;
-    /** 选项的显示文本 */
-    label: string;
-}
-
-/**
- * CardSelector 组件属性
- */
-export declare interface CardSelectorProps<T = string | number> {
-    /** 选项列表 */
-    options: CardSelectorOption<T>[];
-    /** 当前选中的值 */
-    value?: T;
-    /** 值变化回调 */
-    onChange?: (value: T | undefined) => void;
-    /** 是否允许取消选择（点击已选中项取消选择）
-     * @default true
-     */
-    allowDeselect?: boolean;
-    /** 自定义根容器类名 */
-    className?: string;
-    /** 自定义选项类名 */
-    itemClassName?: string;
-}
-
 /**
  * Clear the locale cache
  * Useful for testing or when you need to force reload locales
@@ -235,37 +79,6 @@ export declare interface CommonMessages {
     confirm: string;
 }
 
-/**
- * BaseTask 组件
- * @description 基础任务卡片，职责：
- * - 卡片布局（flex 容器）
- * - 周期标签显示
- * - 任务标题显示
- * - 有效时间显示
- * - 按钮区域管理
- * - 完成状态样式
- *
- * @example
- * ```tsx
- * <BaseTask
- *   title="Follow @TaskOn_xyz"
- *   isWon={false}
- *   isCompleted={false}
- *   isPeriodic={true}
- *   recurrenceLabel="Daily"
- *   taskId={123}
- *   actionLabel="Follow"
- *   actionLink="https://twitter.com/TaskOn_xyz"
- *   reward={{ type: 'points', amount: 100, name: 'Points', icon: '/icon.png' }}
- *   onClick={() => console.log('卡片被点击')}
- *   onClaim={() => console.log('Claim 按钮被点击')}
- * >
- *   <div>额外的任务描述内容</div>
- * </BaseTask>
- * ```
- */
-export declare function CommunityTask(props: CommunityTaskProps): default_2.ReactElement;
-
 /**
  * CommunityTaskList outer wrapper
  *
@@ -354,292 +167,6 @@ export declare interface CommunityTaskListProps {
     rewardRedirectUrl?: string;
 }
 
-/**
- * 任务卡片基础 Props（最小知识原则）
- * BaseTask 只需要知道这些信息
- */
-export declare interface CommunityTaskProps {
-    /** 任务名称/标题（字符串或自定义渲染节点） */
-    title: string | React.ReactNode;
-    /** 是否已中奖/完成 */
-    isWon: boolean;
-    /** 是否已提交（可能未中奖） */
-    isCompleted: boolean;
-    /** 是否是周期任务 */
-    isPeriodic: boolean;
-    /** 操作按钮文案（如 "Follow"、"Join"） */
-    actionLabel?: string;
-    /** 操作按钮链接（默认在新标签页打开） */
-    actionLink?: string;
-    /** 点击操作按钮后是否自动验证 */
-    actionAutoVerify?: boolean;
-    /**
-     * 点击 Action 按钮时自动打开弹窗
-     * 用于 PowTask、InviteFriends 等需要在弹窗中填写内容的任务
-     */
-    actionAutoDialog?: boolean;
-    /** 是否总是显示操作按钮（即使已完成） */
-    alwaysShowAction?: boolean;
-    /**
-     * 标题跳转链接
-     * 如果提供，标题将变成可点击的链接，在新标签页打开
-     */
-    targetLink?: string;
-    /** 是否隐藏 Claim 按钮 */
-    noClaim?: boolean;
-    /**
-     * 是否需要验证后才能 Claim
-     * - true: 显示 "Verify & Claim"
-     * - false: 显示 "Claim"
-     */
-    verifyClaim?: boolean;
-    /**
-     * 点击 Claim 仅打开弹窗（不提交）
-     * 用于 QuizTask、SurveyTask 等需要在弹窗中选择答案的任务
-     */
-    claimDialog?: boolean;
-    /**
-     * 社交账号类型（用于 OAuth 绑定）
-     * 决定 Claim 时需要绑定哪种社交账号
-     */
-    snsType?: SnsType;
-    /**
-     * 链类型（用于钱包绑定）
-     * 决定 Claim 时需要绑定哪种链的钱包
-     */
-    chainType?: ChainType;
-    /** 周期标签文本（如 "Daily"、"Weekly"） */
-    recurrenceLabel?: string;
-    /** 任务重复类型（用于 Claim 按钮文案逻辑） */
-    recurrence?: RecurrenceType;
-    /** 是否隐藏周期标签 */
-    noRecurrence?: boolean;
-    /**
-     * Unlimited 任务是否显示大的 Claim 按钮
-     * - true: 显示正常大小的 Claim 按钮
-     * - false: 显示小的 Update 按钮（已有积分）
-     * @default true
-     */
-    showUnlimitedClaim?: boolean;
-    /** 任务 ID */
-    taskId: number;
-    /** 有效时间相关 */
-    validTime?: {
-        /** 开始时间（格式化字符串） */
-        startTime?: string;
-        /** 结束时间（格式化字符串） */
-        endTime?: string;
-        /** 是否已过期 */
-        isExpired?: boolean;
-    };
-    /**
-     * 验证时间范围（OnChain 任务专用）
-     * 显示 "This task only verify action during {start} - {end}(UTC)"
-     */
-    validationTimeFrame?: {
-        /** 开始时间（毫秒或秒时间戳） */
-        start_time: number;
-        /** 结束时间（毫秒或秒时间戳） */
-        end_time: number;
-    };
-    /** 奖励信息 */
-    reward?: {
-        /** 奖励类型 */
-        type: "points" | "token" | "none";
-        /** 积分数量（points 类型，单次奖励） */
-        amount?: number;
-        /** 积分名称（points 类型） */
-        name?: string;
-        /** 积分图标（points 类型） */
-        icon?: string;
-        /** 累计积分（周期任务完成时显示） */
-        totalAmount?: number;
-        /** Token 信息（token 类型） */
-        token?: {
-            /** Token 名称 */
-            name: string;
-            /** 每次奖励数量 */
-            amount: string;
-            /** Token 图标 */
-            icon?: string;
-            /** 链名称 */
-            chain?: string;
-            /** 链图标 */
-            chainIcon?: string;
-            /** 总奖励单位数 */
-            totalUnit?: number;
-            /** 可用单位数 */
-            availableUnit?: number;
-        };
-    };
-    /** 卡片内容（由具体任务组件提供，用于展示任务特定内容） */
-    children?: React.ReactNode;
-    /**
-     * 自定义 Action 按钮区域
-     * 如果提供，将替换默认的 Action 按钮
-     * @example
-     * ```tsx
-     * <BaseTask
-     *   actionSlot={<CustomActionButton onClick={handleAction} />}
-     * />
-     * ```
-     */
-    actionSlot?: React.ReactNode;
-    /**
-     * 自定义奖励展示（已完成状态）
-     * 如果提供，将替换默认的 Won 奖励显示
-     * @example
-     * ```tsx
-     * <BaseTask
-     *   rewardSlot={<CustomRewardDisplay amount={100} />}
-     * />
-     * ```
-     */
-    rewardSlot?: React.ReactNode;
-    /**
-     * 是否已登录
-     * - true: 正常显示卡片
-     * - false/undefined: 显示登录遮层，点击触发 onLogin
-     * @default true
-     */
-    isLoggedIn?: boolean;
-    /** 点击卡片回调（用于打开弹窗） */
-    onClick?: () => void;
-    /**
-     * 点击 Claim 按钮回调
-     * @param token - 可选的 OAuth token（reAuth 成功后传入）
-     * @returns 可选返回 Promise，包含结果信息用于 reAuth 判断和 coolDown 更新
-     */
-    onClaim?: (token?: string) => void | Promise<{
-        successful: boolean;
-        errorCode?: string;
-        cool_down?: number;
-    }>;
-    /**
-     * 点击登录遮层回调
-     * 未登录时（isLoggedIn=false）点击卡片会触发此回调
-     */
-    onLogin?: () => void;
-    /** 是否正在提交 */
-    isSubmitting?: boolean;
-    /** 冷却时间（毫秒） */
-    coolDown?: number;
-    /** 冷却结束回调（用于重置 coolDown 状态） */
-    onCoolDownComplete?: () => void;
-    /**
-     * 周期任务倒计时结束回调
-     * 用于在 next_time 到期后刷新单个任务卡片状态
-     */
-    onDoneCountdownComplete?: (taskId: number) => void | Promise<void>;
-    /** 是否禁用交互 */
-    disabled?: boolean;
-    /**
-     * 审核结果状态
-     * - Passed: 审核通过
-     * - Failed: 审核失败（显示 "Oops! Failed"）
-     * - UnReviewed: 审核中（显示 "Under Review"）
-     */
-    reviewResult?: TaskReviewResult;
-    /**
-     * CheckProgressTip 需要的社区信息
-     * 用于显示 "Contact {name} to check your progress"
-     */
-    communityInfo?: {
-        /** 社区名称 */
-        name?: string;
-        /** 社区联系链接（Discord/Telegram/Twitter） */
-        contactLink?: string;
-    };
-    /**
-     * 周期任务：当前周期是否已完成
-     * 配合 nextTime 用于显示 DoneCountdown
-     */
-    currentCompleted?: boolean;
-    /**
-     * 周期任务：下次可完成的时间戳（毫秒）
-     * 用于显示 DoneCountdown 倒计时
-     */
-    nextTime?: number;
-}
-
-/**
- * ConfirmNoticeDialog component
- *
- * @description
- * - Replicates the original ConfirmNotice content structure
- * - Supports default two-button mode and custom action slot
- * - Reuses Dialog for accessibility / portal / keyboard interactions
- * - Intentionally removes glow background layer
- */
-export declare function ConfirmNoticeDialog({ open, onOpenChange, type, title, desc, col, cancelButton, confirmButton, onCancel, onConfirm, onClose, closeOnCancel, closeOnConfirm, cancelDisabled, confirmDisabled, showCloseButton, closeOnOverlayClick, closeOnEscapeKey, maxWidth, className, contentClassName, children, actions, footer, accessibilityTitle, accessibilityDescription, }: ConfirmNoticeDialogProps): default_2.ReactElement;
-
-/**
- * ConfirmNoticeDialog props
- */
-export declare interface ConfirmNoticeDialogProps {
-    /** Whether the dialog is open (controlled) */
-    open: boolean;
-    /** Controlled open state callback */
-    onOpenChange: (open: boolean) => void;
-    /** Notice visual type */
-    type?: ConfirmNoticeType;
-    /** Title rendered below the icon */
-    title?: default_2.ReactNode;
-    /** Description rendered below the title */
-    desc?: default_2.ReactNode;
-    /** Allow action area wrapping on desktop */
-    col?: boolean;
-    /** Cancel button label. Hidden if omitted */
-    cancelButton?: default_2.ReactNode;
-    /** Confirm button label. Hidden if omitted */
-    confirmButton?: default_2.ReactNode;
-    /** Cancel button click callback */
-    onCancel?: () => void;
-    /** Confirm button click callback */
-    onConfirm?: () => void;
-    /** Called when dialog closes via overlay / ESC / close button / programmatic close */
-    onClose?: () => void;
-    /** Auto close after cancel click, defaults to true */
-    closeOnCancel?: boolean;
-    /** Auto close after confirm click, defaults to true */
-    closeOnConfirm?: boolean;
-    /** Disable cancel button */
-    cancelDisabled?: boolean;
-    /** Disable confirm button */
-    confirmDisabled?: boolean;
-    /** Show top-right close button, defaults to false (closer to original ConfirmNotice) */
-    showCloseButton?: boolean;
-    /** Allow closing by overlay click, defaults to true */
-    closeOnOverlayClick?: boolean;
-    /** Allow closing by ESC key, defaults to true */
-    closeOnEscapeKey?: boolean;
-    /** Dialog max width, defaults to 470 (same as original) */
-    maxWidth?: string | number;
-    /** Additional class on content root */
-    className?: string;
-    /** Additional class on Dialog.Content */
-    contentClassName?: string;
-    /** Custom body content between description and actions */
-    children?: default_2.ReactNode;
-    /** Custom action area. Overrides default cancel/confirm buttons */
-    actions?: default_2.ReactNode;
-    /** Extra content rendered after actions */
-    footer?: default_2.ReactNode;
-    /**
-     * Accessible dialog title
-     * - Falls back to string `title`
-     * - Uses default value when title is not a string
-     */
-    accessibilityTitle?: string;
-    /** Accessible dialog description */
-    accessibilityDescription?: string;
-}
-
-/**
- * ConfirmNotice visual style type
- */
-export declare type ConfirmNoticeType = "default" | "success" | "warn";
-
 /**
  * Create a locale loader function for a widget
  *
@@ -686,44 +213,6 @@ export declare function createLocaleLoader<T>(defaultMessages: T, imports: Local
  */
 export declare function createT<T extends Record<string, string>>(messages: T): <K extends keyof T>(key: K, params?: InterpolationParams) => string;
 
-/**
- * Rich text translation component.
- *
- * It first translates text with temporary markers, then replaces markers
- * with provided React nodes.
- */
-export declare function I18nT<T extends Record<string, string>, K extends keyof T>({ t, i18nKey, values, components, textClassName, as: Wrapper, className, }: I18nTProps<T, K>): default_2.ReactElement;
-
-/**
- * Slot component map for rich placeholders.
- *
- * Key is the interpolation name in message template, e.g. {community}
- */
-export declare type I18nTComponents = Record<string, ReactNode>;
-
-/**
- * I18nT component props
- *
- * @template T - Locale messages object type
- * @template K - Message key type
- */
-export declare interface I18nTProps<T extends Record<string, string>, K extends keyof T> {
-    /** Translation function returned by useTranslation/useXxxLocale */
-    t: TFunction<T>;
-    /** Translation key */
-    i18nKey: K;
-    /** Plain interpolation values */
-    values?: InterpolationParams;
-    /** Rich component slots */
-    components?: I18nTComponents;
-    /** Optional className for plain text fragments between rich slots */
-    textClassName?: string;
-    /** Optional wrapper element type (default: Fragment) */
-    as?: ElementType;
-    /** Optional wrapper className (only applied when `as` is provided) */
-    className?: string;
-}
-
 /**
  * Interpolate a string with parameters
  *
@@ -1114,9 +603,21 @@ export declare interface TaskOnContextValue {
      */
     client: TaskOnClient | null;
     /**
-     * Whether the provider is initializing
+     * Whether the provider is in full initialization flow.
+     *
+     * Notes:
+     * - Includes session restore and token validation.
+     * - When a stored token exists, this stays true until user info validation completes.
      */
     isInitializing: boolean;
+    /**
+     * Whether session prerequisites are ready for data requests.
+     * True means client is created and auth token has been loaded
+     * (or no token exists, anonymous mode).
+     *
+     * This can become true earlier than `isInitializing === false`.
+     */
+    isSessionReady: boolean;
     /**
      * Resolved locale
      */
@@ -1239,10 +740,13 @@ export declare interface TaskOnProviderConfig {
     /**
      * WalletConnect Project ID
      *
-     * Required for WalletConnect functionality.
-     * Get your project ID at https://cloud.walletconnect.com
+     * Only needed when you design Web3 wallet login or wallet-based reward flows.
+     * (e.g. wallet binding, on-chain verification, NFT/token claiming)
      *
-     * If not provided, WalletConnect option will be disabled in the wallet dialog.
+     * Optional. If not provided, SDK built-in default project ID will be used.
+     * For production, it is strongly recommended to set your own project ID.
+     *
+     * Get your project ID at https://cloud.walletconnect.com
      */
     walletConnectProjectId?: string;
 }
@@ -1298,67 +802,6 @@ export declare interface TaskOnThemeConfig {
     dark?: ModeThemeConfig;
 }
 
-/**
- * TemplateTask 组件
- *
- * @description 通用模版任务组件，负责：
- * - 解析 task.template.params 获取任务参数
- * - 使用 BaseTask 展示任务卡片
- * - 渲染描述字段（desc、desc_fields）
- * - 处理 Action 按钮（action_label、action_link）
- *
- * @example
- * ```tsx
- * <TemplateTask
- *   task={taskInfo}
- *   userStatus={userStatus}
- *   onClick={() => console.log('卡片点击')}
- *   onClaim={() => console.log('Claim 点击')}
- * />
- * ```
- */
-export declare function TemplateTask({ task, userStatus, meetConditions, communityInfo, disabled, onClick, onClaim, onUpdate, onEligTaskClick, coolDown: sharedCoolDown, onCoolDownComplete: sharedOnCoolDownComplete, onDoneCountdownComplete, }: TemplateTaskProps): default_2.ReactElement;
-
-/**
- * TemplateTask 组件属性
- */
-export declare interface TemplateTaskProps {
-    /** 任务信息 */
-    task: CommunityTaskInfo;
-    /** 用户状态 */
-    userStatus?: GtcUserTaskStatus;
-    /** 资格条件列表（有值时显示遮罩） */
-    meetConditions?: MeetCondition[];
-    /** 社区信息（用于前置任务链接跳转） */
-    communityInfo?: {
-        community_key?: string;
-        dapp_domain?: string;
-    };
-    /** 是否禁用交互 */
-    disabled?: boolean;
-    /** 点击卡片回调 */
-    onClick?: () => void;
-    /**
-     * 点击 Claim 回调
-     * @param token 可选的 OAuth token（reAuth 成功后传入）
-     */
-    onClaim?: (token?: string) => void | Promise<{
-        successful: boolean;
-        errorCode?: string;
-        cool_down?: number;
-    }>;
-    /** 任务更新回调（完成/验证成功后） */
-    onUpdate?: (taskId: number) => void | Promise<void>;
-    /** 点击资格条件中的前置任务回调（用于打开任务弹窗） */
-    onEligTaskClick?: (taskId: number) => void;
-    /** 共享的 coolDown 值（来自父组件） */
-    coolDown?: number;
-    /** coolDown 倒计时结束回调 */
-    onCoolDownComplete?: () => void;
-    /** 周期任务倒计时结束回调（用于刷新单任务状态） */
-    onDoneCountdownComplete?: (taskId: number) => void | Promise<void>;
-}
-
 /**
  * Translation function type
  */
@@ -1430,130 +873,6 @@ export declare function useEvmWallet(): {
     signMessage: (message: string) => Promise<string | null>;
 };
 
-/**
- * 获取 Quest 详情 Hook
- *
- * @param options Hook 配置（包含从根组件传入的 api 实例）
- * @returns Quest 详情、加载状态、错误信息、重新加载方法
- */
-export declare function useQuestDetail(options: UseQuestDetailOptions): UseQuestDetailReturn;
-
-/**
- * useQuestDetail Hook 参数
- */
-declare interface UseQuestDetailOptions {
-    /** Quest API 实例（从根组件传入） */
-    api: QuestApi | null;
-    /** Campaign ID */
-    campaignId: number;
-    /** 渠道标识（可选） */
-    channel?: string;
-    /** KOL 标识（可选） */
-    kolHandle?: string;
-    /** 邀请码（可选） */
-    inviteCode?: string;
-    /** Boost ID（可选） */
-    boostId?: number;
-    /** 是否启用（默认 true） */
-    enabled?: boolean;
-}
-
-/**
- * useQuestDetail Hook 返回值
- */
-declare interface UseQuestDetailReturn {
-    /** Campaign 详情数据 */
-    data: QuestCampaignInfo | null;
-    /** 是否加载中 */
-    isLoading: boolean;
-    /** 错误信息 */
-    error: string | null;
-    /** 重新加载 */
-    refetch: () => void;
-}
-
-/**
- * 获取 Quest 状态信息 Hook
- *
- * @param options Hook 配置（包含从根组件传入的 api 实例）
- * @returns Quest 状态、加载状态、错误信息、重新加载方法
- */
-export declare function useQuestStatus(options: UseQuestStatusOptions): UseQuestStatusReturn;
-
-/**
- * useQuestStatus Hook 参数
- */
-declare interface UseQuestStatusOptions {
-    /** Quest API 实例（从根组件传入） */
-    api: QuestApi | null;
-    /** Campaign ID */
-    campaignId: number;
-    /** 渠道标识 */
-    channel?: string;
-    /** KOL 句柄 */
-    kolHandle?: string;
-    /** 是否启用（默认 true） */
-    enabled?: boolean;
-}
-
-/**
- * useQuestStatus Hook 返回值
- */
-declare interface UseQuestStatusReturn {
-    /** Campaign 状态数据 */
-    data: CampaignStatusInfo | null;
-    /** 是否加载中 */
-    isLoading: boolean;
-    /** 错误信息 */
-    error: string | null;
-    /** 重新加载 */
-    refetch: () => void;
-}
-
-/**
- * 获取用户 Quest 状态 Hook
- *
- * @param options Hook 配置（包含从根组件传入的 api 实例）
- * @returns 用户状态、加载状态、错误信息、重新加载方法
- */
-export declare function useQuestUserStatus(options: UseQuestUserStatusOptions): UseQuestUserStatusReturn;
-
-/**
- * useQuestUserStatus Hook 参数
- */
-declare interface UseQuestUserStatusOptions {
-    /** Quest API 实例（从根组件传入） */
-    api: QuestApi | null;
-    /** Campaign ID */
-    campaignId: number;
-    /** 渠道标识（可选） */
-    channel?: string;
-    /** KOL 标识（可选） */
-    kolHandle?: string;
-    /** 是否启用（默认 true） */
-    enabled?: boolean;
-}
-
-/**
- * useQuestUserStatus Hook 返回值
- */
-declare interface UseQuestUserStatusReturn {
-    /** 用户状态数据 */
-    data: UserCampaignStatusInfo | null;
-    /** 是否加载中 */
-    isLoading: boolean;
-    /** 错误信息 */
-    error: string | null;
-    /** 重新加载 */
-    refetch: () => void;
-    /**
-     * 立即更新指定任务的本地状态（乐观更新）
-     * @param taskId 任务 ID
-     * @param isAsync 是否为异步任务（异步任务只更新 is_submitter）
-     */
-    updateTaskStatus: (taskId: number, isAsync?: boolean) => void;
-}
-
 /**
  * UserCenterWidget 外层组件
  *
@@ -1611,7 +930,15 @@ export { UserInfo }
  *
  * @example
  * ```tsx
- * const { login, logout, userId, isLoggedIn, requestLogin } = useTaskOnAuth();
+ * const {
+ *   login,
+ *   logout,
+ *   userId,
+ *   isLoggedIn,
+ *   isInitializing,
+ *   isSessionReady,
+ *   requestLogin,
+ * } = useTaskOnAuth();
  *
  * // EVM wallet login
  * await login({ method: 'evm_wallet', value: '0x...', sign, timestamp });
@@ -1630,6 +957,7 @@ export declare function useTaskOnAuth(): {
     userId: number | null;
     isLoggedIn: boolean;
     isInitializing: boolean;
+    isSessionReady: boolean;
     login: (params: LoginParams) => Promise<void>;
     logout: () => void;
     requestLogin: () => void;