@taskon/widget-react 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -1,180 +1,62 @@
-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 { ForwardRefExoticComponent } from 'react';
-import { GtcUserTaskStatus } from '@taskon/core';
 import { LeaderboardContentConfig } from '@taskon/core';
 import { LoginResult } from '@taskon/core';
-import { MeetCondition } from '@taskon/core';
-import { QuestApi } from '@taskon/core';
+import { PageBuilderConfig } 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 变体类型
+ * Clear the locale cache
+ * Useful for testing or when you need to force reload locales
  */
-export declare type ButtonVariant = "primary" | "secondary" | "outline" | "ghost" | "danger";
+export declare function clearLocaleCache(): void;
 
 /**
- * CardSelector 组件
+ * Convert cloud theme config (B-end format) to React TaskOnThemeConfig.
+ *
+ * Mapping:
+ *   CloudThemeConfig.colorMode        → TaskOnThemeConfig.mode + modeStrategy
+ *   CloudThemeConfig.light.*Color     → light.seed.*
+ *   CloudThemeConfig.dark.*Color      → dark.seed.*
+ *   CloudThemeConfig.shape            → seed.borderRadius / seed.fontSize
+ *   CloudThemeConfig.spacing          → seed.spacingBaseStep / seed.spacingChangeUnit
+ *
+ * Design rule:
+ *   - B-end configurable theme fields are treated as SeedToken inputs.
+ *   - Map tokens are derived by the theme algorithm from seed values.
+ *
+ * @param cloud - Cloud theme configuration from B-end
+ * @returns React-compatible TaskOnThemeConfig
  *
  * @example
- * ```tsx
- * const options = [
- *   { value: 'all', label: 'All Tasks' },
- *   { value: 1, label: 'Daily Tasks' },
- *   { value: 2, label: 'Weekly Tasks' },
- * ];
+ * ```ts
+ * const cloudTheme: CloudThemeConfig = {
+ *   colorMode: { type: "dual", dualVariant: "auto" },
+ *   light: { primaryColor: "#6366f1", ... },
+ *   dark: { primaryColor: "#818cf8", ... },
+ *   spacing: { sizeBaseStep: 4, sizeChangeUnit: 2 },
+ *   shape: { fontSize: 14, borderRadius: 8 },
+ * };
  *
- * <CardSelector
- *   options={options}
- *   value={selectedValue}
- *   onChange={setSelectedValue}
- *   allowDeselect
- * />
+ * const reactTheme = cloudThemeToReactTheme(cloudTheme);
+ * // { mode: "auto", seed: { borderRadius: 8, fontSize: 14 }, light: {...}, dark: {...} }
  * ```
  */
-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
- */
-export declare function clearLocaleCache(): void;
+export declare function cloudThemeToReactTheme(cloud: CloudThemeConfig): TaskOnThemeConfig;
 
 /**
  * Common messages type definition
@@ -197,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
  *
@@ -245,6 +96,11 @@ export declare interface CommunityTaskListProps {
      * Cloud config includes display options, sector filtering, etc.
      */
     widgetId?: number;
+    /**
+     * Manual theme mode override (highest priority when provided).
+     * Recommended with dual + toggle cloud strategy.
+     */
+    themeMode?: "light" | "dark" | "auto";
     /** Whether in preview mode */
     isPreview?: boolean;
     /** 社区信息（用于前置任务链接跳转） */
@@ -263,8 +119,9 @@ export declare interface CommunityTaskListProps {
      */
     initialTaskId?: number;
     /**
-     * Callback when dialog opens (host can use to update URL params)
-     * @param taskId Currently opened task ID
+     * Callback when dialog opens or switches task (host can use to update URL params).
+     * Fires whenever active task changes, including eligibility-driven task switches.
+     * @param taskId Currently active task ID
      * @example
      * ```tsx
      * onTaskOpen={(taskId) => router.replace(`?task=${taskId}`)}
@@ -272,13 +129,28 @@ export declare interface CommunityTaskListProps {
      */
     onTaskOpen?: (taskId: number) => void;
     /**
-     * Callback when dialog closes (host can use to clear URL params)
+     * Callback when dialog closes (host can use to clear URL params).
+     * Fires only when dialog is actually closed; in-place task switches do not emit close first.
      * @example
      * ```tsx
      * onTaskClose={() => router.replace(pathname)}
      * ```
      */
     onTaskClose?: () => void;
+    /**
+     * Initial TaskChain campaign ID from URL (passed by host after parsing URL)
+     * Used to auto-open TaskChain dialog on page refresh or shared links
+     */
+    initialTaskChainId?: number;
+    /**
+     * Callback when TaskChain dialog opens (host can use to update URL params)
+     * @param taskChainId Currently opened TaskChain campaign ID
+     */
+    onTaskChainOpen?: (taskChainId: number) => void;
+    /**
+     * Callback when TaskChain dialog closes (host can use to clear URL params)
+     */
+    onTaskChainClose?: () => void;
     /** Sector IDs to display; undefined means show all */
     sectorIds?: number[];
     /** Whether to show sector tab selector (default: true) */
@@ -289,209 +161,10 @@ export declare interface CommunityTaskListProps {
     showSectorDescription?: boolean;
     /** Whether to show sector reward (default: true) */
     showSectorReward?: boolean;
-}
-
-/**
- * 任务卡片基础 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;
-    /** 是否禁用交互 */
-    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;
+    /** How reward details are displayed in TaskChain claimed NFT cards */
+    rewardDisplayMode?: RewardDisplayMode;
+    /** Redirect URL for reward details when mode is redirect */
+    rewardRedirectUrl?: string;
 }
 
 /**
@@ -509,6 +182,8 @@ export declare interface CommunityTaskProps {
  * const loadMessages = createLocaleLoader(enMessages, {
  *   ko: () => import('./locales/ko'),
  *   ja: () => import('./locales/ja'),
+ *   ru: () => import('./locales/ru'),
+ *   es: () => import('./locales/es'),
  * });
  * ```
  */
@@ -538,6 +213,30 @@ 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;
 
+/**
+ * Ethereum Provider Interface (EIP-1193)
+ *
+ * Exported for scenarios where caller already owns a specific provider
+ * instance (e.g. wallet selection dialog) and needs to build an adapter
+ * around it.
+ */
+declare interface EthereumProvider {
+    request: (args: {
+        method: string;
+        params?: unknown[];
+    }) => Promise<unknown>;
+    on?: (event: string, callback: (...args: unknown[]) => void) => void;
+    removeListener?: (event: string, callback: (...args: unknown[]) => void) => void;
+}
+
+export declare class EvmWalletSelectionCanceledError extends Error {
+    constructor(message?: string);
+}
+
+export declare class EvmWalletSelectionInProgressError extends Error {
+    constructor(message?: string);
+}
+
 /**
  * Interpolate a string with parameters
  *
@@ -623,6 +322,11 @@ export declare interface LeaderboardWidgetProps {
      * Cloud config provides leaderboard tabs, display options, etc.
      */
     widgetId?: number;
+    /**
+     * Manual theme mode override (highest priority when provided).
+     * Recommended with dual + toggle cloud strategy.
+     */
+    themeMode?: "light" | "dark" | "auto";
     /**
      * 排行榜配置
      * 包含所有 Tab 的配置和显示选项
@@ -645,7 +349,11 @@ export declare type Locale = "en" | "ko" | "ja" | "ru" | "es";
 
 /**
  * Locale import map type
- * Maps supported locales to their dynamic import functions
+ * Maps supported non-English locales to their dynamic import functions.
+ *
+ * Notes:
+ * - Keys are optional so widgets can incrementally adopt locales.
+ * - Missing locale imports safely fall back to inlined English messages.
  */
 export declare type LocaleImportMap<T> = {
     [K in Exclude<SupportedLocale, "en">]?: () => Promise<{
@@ -686,13 +394,32 @@ export declare interface MapToken {
     colorSuccess?: string;
     colorWarning?: string;
     colorError?: string;
-    colorBg?: string;
-    colorBgElevated?: string;
-    colorBgSpotlight?: string;
+    /** Page/canvas base background */
+    colorBgCanvas?: string;
+    /** Main surface background (cards, panels) */
+    colorBgSurface?: string;
+    /** Subtle surface background (low-contrast cards) */
+    colorBgSurfaceSubtle?: string;
+    /** Strong surface background (section headers, tracks) */
+    colorBgSurfaceStrong?: string;
+    /** Floating layer background (tooltip, dropdown, popover) */
+    colorBgFloating?: string;
+    /** Overlay mask background */
+    colorBgMask?: string;
+    /** Inset background (inner slots/containers) */
+    colorBgInset?: string;
+    colorSuccessBg?: string;
+    colorWarningBg?: string;
+    colorErrorBg?: string;
+    colorSecondaryBg?: string;
     colorText?: string;
     colorTextSecondary?: string;
     colorTextTertiary?: string;
     colorTextDisabled?: string;
+    /** Link color */
+    colorLink?: string;
+    /** Text color on primary background elements (e.g. primary button text) */
+    colorTextOnPrimary?: string;
     colorBorder?: string;
     colorBorderSecondary?: string;
     borderRadius?: number;
@@ -701,6 +428,9 @@ export declare interface MapToken {
     fontSize?: number;
     fontSizeSm?: number;
     fontSizeLg?: number;
+    fontSizeXl?: number;
+    fontSizeXxl?: number;
+    fontSizeXxxl?: number;
     spacing?: number;
     spacingXs?: number;
     spacingSm?: number;
@@ -717,6 +447,22 @@ declare interface ModeThemeConfig {
     map?: MapToken;
 }
 
+/**
+ * PageBuilder - Render a composed page from PageBuilder config
+ */
+export declare function PageBuilder(props: PageBuilderProps): default_2.ReactElement;
+
+export declare interface PageBuilderProps {
+    /** PageBuilder ID (load config from API) */
+    pageId?: number;
+    /** Local config (skip API request) */
+    config?: PageBuilderConfig;
+    /** Custom className for root */
+    className?: string;
+    /** Custom style for root */
+    style?: default_2.CSSProperties;
+}
+
 /**
  * Quest Widget 主组件
  *
@@ -757,6 +503,14 @@ export declare interface QuestWidgetProps {
      * 云端配置包含 campaignId、显示选项、自定义分享文案等
      */
     widgetId?: number;
+    /**
+     * 手动主题模式（传入后拥有最高优先级）
+     * 建议在云端配置为 dual + toggle 时使用，避免与固定模式配置语义冲突。
+     * - light: 强制浅色主题
+     * - dark: 强制深色主题
+     * - auto: 跟随系统主题
+     */
+    themeMode?: "light" | "dark" | "auto";
     /**
      * Campaign ID
      * - 如果传入 widgetId，campaignId 可从云端配置获取
@@ -779,6 +533,8 @@ export declare interface QuestWidgetProps {
     showTitle?: boolean;
     /** 是否显示描述 */
     showDescription?: boolean;
+    /** 是否显示参与人数 */
+    showParticipants?: boolean;
     /** 加载完成回调 */
     onLoaded?: (campaign: QuestCampaignInfo) => void;
     /** 任务完成回调 */
@@ -789,8 +545,6 @@ export declare interface QuestWidgetProps {
     onError?: (error: Error) => void;
     /** 连接钱包回调（未登录时触发） */
     onConnectWallet?: () => void;
-    /** 领取 NFT 回调 (NFT/MintedNft/Cap) */
-    onClaimNft?: (reward: RewardValueInfo, layer: CampaignWinnerReward) => Promise<void>;
     /** 领取 Discord 角色回调 */
     onClaimDiscordRole?: (reward: RewardValueInfo, layer: CampaignWinnerReward) => Promise<void>;
     /**
@@ -803,10 +557,18 @@ export declare interface QuestWidgetProps {
      * 需要绑定 SNS 时的回调
      */
     onBindSnsRequired?: (snsTypes: SnsType[]) => void;
-    /** 分享链接（配置后显示分享按钮） */
+    /** 是否显示分享按钮（默认 true） */
+    showShare?: boolean;
+    /** 分享链接（未配置时回退到当前页面 URL） */
     shareUrl?: string;
     /** Twitter 分享文案（可选，有默认文案） */
     shareText?: string;
+    /** 是否在 Twitter 分享文案末尾自动追加带 utm_source=x 的链接（默认 true） */
+    shareAutoAppendLink?: boolean;
+    /** 奖励详情展示模式：popup 弹窗 / redirect 跳转（默认 popup） */
+    rewardDisplayMode?: RewardDisplayMode;
+    /** 跳转 URL（当 rewardDisplayMode 为 'redirect' 时使用） */
+    rewardRedirectUrl?: string;
 }
 
 export { RewardType }
@@ -825,17 +587,45 @@ export declare interface SeedToken {
     colorWarning?: string;
     /** Error color */
     colorError?: string;
+    /** Link color */
+    colorLink?: string;
+    /** Base text color */
+    colorText?: string;
+    /** Text color on primary buttons */
+    colorTextOnPrimary?: string;
+    /** Base page background color (used to derive background layers) */
+    colorBgBase?: string;
     /** Base border radius */
     borderRadius?: number;
     /** Base font size */
     fontSize?: number;
+    /** Spacing base step from cloud config */
+    spacingBaseStep?: number;
+    /** Spacing change unit from cloud config */
+    spacingChangeUnit?: number;
+}
+
+export declare function selectEvmWallet(options?: SelectEvmWalletOptions): Promise<SelectEvmWalletResult>;
+
+export declare interface SelectEvmWalletOptions {
+    signal?: AbortSignal;
+}
+
+export declare interface SelectEvmWalletResult {
+    walletId: string;
+    walletName: string;
+    address: string;
+    provider: EthereumProvider;
 }
 
 /**
- * Locales that have full translation support in all widgets
- * Other locales in the Locale type will fallback to English
+ * Locales recognized by the widget i18n runtime.
+ *
+ * Notes:
+ * - A widget can choose to provide only part of these locale files.
+ * - Missing locale modules still fall back to inlined English messages.
  */
-export declare type SupportedLocale = "en" | "ko" | "ja";
+export declare type SupportedLocale = "en" | "ko" | "ja" | "ru" | "es";
 
 /**
  * TaskOn Context value
@@ -850,9 +640,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
      */
@@ -897,7 +699,7 @@ export declare interface TaskOnContextValue {
      */
     chains: ChainInfo[];
     /**
-     * Community info (auto-loaded on init based on apiKey)
+     * Community info (auto-loaded on init based on clientId)
      * Used for displaying community logo and name in reward cards
      */
     communityInfo: CommunityInfo | null;
@@ -910,7 +712,7 @@ export declare interface TaskOnContextValue {
  * - TaskOn client management (based on @taskon/core)
  * - User authentication (login/logout)
  * - Locale configuration
- * - Wallet management (uses window.ethereum adapter)
+ * - Wallet management (host adapter or built-in wallet picker)
  * - Widget locale preloading (optional)
  * - Toast notifications (internal, user-transparent)
  */
@@ -921,10 +723,10 @@ export declare function TaskOnProvider({ config, children, preloadLocales, }: Ta
  */
 export declare interface TaskOnProviderConfig {
     /**
-     * API Key for authentication (X-API-Key header)
-     * Note: apiKey already contains community info, no need to configure communityId/communityKey separately
+     * Client ID for authentication (X-API-Key header)
+     * Note: clientId already contains community info, no need to configure communityId/communityKey separately
      */
-    apiKey: string;
+    clientId: string;
     /**
      * API base URL (optional)
      * @default https://white-label-api.taskon.xyz
@@ -938,8 +740,8 @@ export declare interface TaskOnProviderConfig {
     /**
      * Wallet configuration for blockchain interactions
      *
-     * When not provided, TaskOn will use built-in window.ethereum adapter
-     * for EVM wallet connections (MetaMask, etc.)
+     * When not provided, TaskOn will use SDK built-in wallet picker adapter
+     * for EVM wallet connections.
      */
     walletConfig?: WalletConfig;
     /**
@@ -952,7 +754,7 @@ export declare interface TaskOnProviderConfig {
      * ```tsx
      * <TaskOnProvider
      *   config={{
-     *     apiKey: 'your-api-key',
+     *     clientId: 'your-client-id',
      *     onRequestLogin: () => {
      *       setShowLoginModal(true);
      *     },
@@ -975,10 +777,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;
 }
@@ -1016,6 +821,12 @@ export declare interface TaskOnTheme {
 export declare interface TaskOnThemeConfig {
     /** Theme mode */
     mode?: ThemeMode;
+    /**
+     * Theme mode strategy.
+     * - auto: mode selection follows standard mode behavior
+     * - toggle: SDK/host controls mode manually (typically used with dual+toggle from cloud config)
+     */
+    modeStrategy?: "auto" | "toggle";
     /** Compact mode */
     compact?: boolean;
     /** Seed tokens */
@@ -1028,65 +839,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, }: 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?: () => void;
-    /** 点击资格条件中的前置任务回调（用于打开任务弹窗） */
-    onEligTaskClick?: (taskId: number) => void;
-    /** 共享的 coolDown 值（来自父组件） */
-    coolDown?: number;
-    /** coolDown 倒计时结束回调 */
-    onCoolDownComplete?: () => void;
-}
-
 /**
  * Translation function type
  */
@@ -1158,130 +910,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 外层组件
  *
@@ -1311,10 +939,19 @@ export declare interface UserCenterWidgetProps {
      * Cloud config provides tab options, display settings, etc.
      */
     widgetId?: number;
+    /**
+     * Manual theme mode override (highest priority when provided).
+     * Recommended with dual + toggle cloud strategy.
+     */
+    themeMode?: "light" | "dark" | "auto";
     /** Widget 配置 */
     config?: UserCenterConfig;
     /** 默认选中的 Tab */
     defaultTab?: UserCenterTabType;
+    /** 默认选中的奖励卡片（MyRewards 内部） */
+    defaultRewardCard?: UserCenterRewardCardType;
+    /** 默认 Points ID（仅当 defaultRewardCard=Points 时使用） */
+    defaultPointId?: number;
     /** Tab 切换回调 */
     onTabChange?: (tab: UserCenterTabType) => void;
     /** 自定义类名 */
@@ -1330,7 +967,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 });
@@ -1349,6 +994,7 @@ export declare function useTaskOnAuth(): {
     userId: number | null;
     isLoggedIn: boolean;
     isInitializing: boolean;
+    isSessionReady: boolean;
     login: (params: LoginParams) => Promise<void>;
     logout: () => void;
     requestLogin: () => void;
@@ -1588,15 +1234,9 @@ export declare interface WalletAdapter {
 export declare interface WalletConfig {
     /**
      * Custom EVM wallet adapter
-     * If not provided, uses built-in window.ethereum adapter
+     * If not provided, uses SDK built-in wallet picker adapter
      */
     evmAdapter?: WalletAdapter;
-    /**
-     * Disable auto-detection of wallet providers
-     * When true, only uses adapter explicitly provided above
-     * @default false
-     */
-    disableAutoDetect?: boolean;
 }
 
 /**
@@ -1608,6 +1248,24 @@ declare interface WalletContextValue extends WalletState {
     signEvmMessage: (message: string) => Promise<string | null>;
 }
 
+export declare function WalletPickerDialog({ open, onOpenChange, onSelect, onError, }: WalletPickerDialogProps): default_2.ReactElement;
+
+export declare function WalletPickerDialogHost(): default_2.ReactElement;
+
+export declare interface WalletPickerDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onSelect?: (selection: WalletPickerSelection) => Promise<void>;
+    onError?: (error: string) => void;
+}
+
+export declare interface WalletPickerSelection {
+    walletId: string;
+    walletName: string;
+    address: string;
+    provider: any;
+}
+
 /**
  * Wallet state exposed through context
  */
@@ -1622,6 +1280,6 @@ export declare interface WalletState {
 /**
  * Supported widget names for preloading
  */
-export declare type WidgetName = "CommunityTask";
+export declare type WidgetName = "CommunityTask" | "Quest" | "TaskWidget" | "LeaderboardWidget" | "UserCenterWidget";
 
 export { }