@taskon/widget-react 0.0.1-beta.1

package/dist/index.d.ts

@@ -0,0 +1,1660 @@
+import { CampaignStatusInfo } from '@taskon/core';
+import { CampaignWinnerReward } from '@taskon/core';
+import { ChainInfo } from '@taskon/core';
+import { ChainType } 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 { 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
+ */
+export declare function clearLocaleCache(): void;
+
+/**
+ * Common messages type definition
+ *
+ * These are shared messages used across multiple widgets.
+ * All language files must implement this interface.
+ */
+export declare interface CommonMessages {
+    /** Loading state text */
+    loading: string;
+    /** Generic error message */
+    error: string;
+    /** Retry action text */
+    retry: string;
+    /** Success message */
+    success: string;
+    /** Cancel action text */
+    cancel: string;
+    /** Confirm action text */
+    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
+ *
+ * Handles cloud config loading + ThemeProvider wrapping via WidgetShell.
+ * Merges cloud function config with local props, then renders inner component.
+ */
+export declare function CommunityTaskList(props: CommunityTaskListProps): default_2.ReactElement;
+
+/**
+ * CommunityTaskList component props
+ */
+export declare interface CommunityTaskListProps {
+    /**
+     * Widget ID - load configuration (theme + function) from cloud
+     * Cloud config includes display options, sector filtering, etc.
+     */
+    widgetId?: number;
+    /** Whether in preview mode */
+    isPreview?: boolean;
+    /** 社区信息（用于前置任务链接跳转） */
+    communityInfo?: {
+        community_key?: string;
+        dapp_domain?: string;
+    };
+    /**
+     * Initial task ID from URL (passed by host after parsing URL)
+     * Used to auto-open task dialog on page refresh or shared links
+     * @example
+     * ```tsx
+     * const searchParams = useSearchParams();
+     * <CommunityTaskList initialTaskId={Number(searchParams.get('task')) || undefined} />
+     * ```
+     */
+    initialTaskId?: number;
+    /**
+     * Callback when dialog opens (host can use to update URL params)
+     * @param taskId Currently opened task ID
+     * @example
+     * ```tsx
+     * onTaskOpen={(taskId) => router.replace(`?task=${taskId}`)}
+     * ```
+     */
+    onTaskOpen?: (taskId: number) => void;
+    /**
+     * Callback when dialog closes (host can use to clear URL params)
+     * @example
+     * ```tsx
+     * onTaskClose={() => router.replace(pathname)}
+     * ```
+     */
+    onTaskClose?: () => void;
+    /** Sector IDs to display; undefined means show all */
+    sectorIds?: number[];
+    /** Whether to show sector tab selector (default: true) */
+    showSectorTab?: boolean;
+    /** Whether to show sector name (default: true) */
+    showSectorName?: boolean;
+    /** Whether to show sector description (default: true) */
+    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;
+}
+
+/**
+ * Create a locale loader function for a widget
+ *
+ * @template T - The shape of the messages object
+ * @param defaultMessages - English messages (used as fallback)
+ * @param imports - Map of locale codes to dynamic import functions
+ * @returns A function that loads messages for a given locale
+ *
+ * @example
+ * ```ts
+ * import enMessages from './locales/en';
+ *
+ * const loadMessages = createLocaleLoader(enMessages, {
+ *   ko: () => import('./locales/ko'),
+ *   ja: () => import('./locales/ja'),
+ * });
+ * ```
+ */
+export declare function createLocaleLoader<T>(defaultMessages: T, imports: LocaleImportMap<T>): (locale: Locale) => Promise<{
+    default: T;
+}>;
+
+/**
+ * Create a translation function from a messages object
+ *
+ * @param messages - Object containing translation strings
+ * @returns A function that retrieves and interpolates translations
+ *
+ * @example
+ * ```ts
+ * const messages = {
+ *   greeting: 'Hello, {name}!',
+ *   points: 'You have {count} points',
+ * };
+ *
+ * const t = createT(messages);
+ *
+ * t('greeting', { name: 'John' })  // => 'Hello, John!'
+ * t('points', { count: 100 })      // => 'You have 100 points'
+ * t('greeting')                    // => 'Hello, {name}!' (no params)
+ * ```
+ */
+export declare function createT<T extends Record<string, string>>(messages: T): <K extends keyof T>(key: K, params?: InterpolationParams) => string;
+
+/**
+ * Interpolate a string with parameters
+ *
+ * @param template - String template with {key} placeholders
+ * @param params - Object containing values to replace placeholders
+ * @returns Interpolated string
+ *
+ * @example
+ * ```ts
+ * interpolate('Hello, {name}!', { name: 'John' })
+ * // => 'Hello, John!'
+ *
+ * interpolate('You have {count} points', { count: 100 })
+ * // => 'You have 100 points'
+ *
+ * interpolate('{a} + {b} = {result}', { a: 1, b: 2, result: 3 })
+ * // => '1 + 2 = 3'
+ * ```
+ */
+export declare function interpolate(template: string, params?: InterpolationParams): string;
+
+/**
+ * interpolate - Simple string interpolation utility
+ *
+ * Replaces placeholders in the format {key} with values from the params object.
+ * This is a lightweight alternative to full i18n libraries when only simple
+ * variable replacement is needed.
+ */
+/**
+ * Params object type for interpolation
+ */
+export declare type InterpolationParams = Record<string, string | number | undefined>;
+
+/**
+ * Parameters for contract invocation
+ */
+declare interface InvokeContractParams {
+    /** Contract address */
+    contract: string;
+    /** Contract ABI (Application Binary Interface) */
+    abi: unknown[];
+    /** Method name to call */
+    method: string;
+    /** Method parameters */
+    params: unknown[];
+    /** Target chain ID (optional, will switch network if needed) */
+    chainId?: number;
+    /** Transaction value in wei (for payable methods) */
+    value?: string;
+}
+
+/**
+ * Check if a locale has full translation support
+ */
+export declare function isSupportedLocale(locale: Locale): locale is SupportedLocale;
+
+/**
+ * 排行榜 Widget 外层组件
+ *
+ * Handles cloud config loading + ThemeProvider wrapping via WidgetShell.
+ * Merges cloud function config with local props, then renders inner component.
+ *
+ * @example
+ * ```tsx
+ * // Pure props mode
+ * <LeaderboardWidget config={config} />
+ *
+ * // Pure widgetId mode (config from cloud)
+ * <LeaderboardWidget widgetId={456} />
+ *
+ * // Mixed mode (props override cloud)
+ * <LeaderboardWidget widgetId={456} defaultTabId="sprint-1" />
+ * ```
+ */
+export declare function LeaderboardWidget(props: LeaderboardWidgetProps): default_2.ReactElement | null;
+
+/**
+ * LeaderboardWidget 组件 Props
+ */
+export declare interface LeaderboardWidgetProps {
+    /**
+     * Widget ID - load configuration (theme + function) from cloud
+     * Cloud config provides leaderboard tabs, display options, etc.
+     */
+    widgetId?: number;
+    /**
+     * 排行榜配置
+     * 包含所有 Tab 的配置和显示选项
+     * 如果传入 widgetId，可从云端获取；如果同时传入则 props 优先
+     */
+    config?: LeaderboardContentConfig;
+    /** 默认激活的 Tab ID（不传则默认第一个） */
+    defaultTabId?: string;
+    /** Tab 切换回调 */
+    onTabChange?: (tabId: string) => void;
+    /** 用户点击回调 */
+    onUserClick?: (userId: number, userName: string) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: default_2.CSSProperties;
+}
+
+export declare type Locale = "en" | "ko" | "ja" | "ru" | "es";
+
+/**
+ * Locale import map type
+ * Maps supported locales to their dynamic import functions
+ */
+export declare type LocaleImportMap<T> = {
+    [K in Exclude<SupportedLocale, "en">]?: () => Promise<{
+        default: T;
+    }>;
+};
+
+/**
+ * Supported login methods
+ */
+export declare type LoginMethod = "evm_wallet" | "email" | "discord" | "twitter" | "telegram";
+
+/**
+ * Unified login parameters
+ */
+export declare interface LoginParams {
+    /** Login method */
+    method: LoginMethod;
+    /** Value: wallet address / email / OAuth token */
+    value: string;
+    /** Signature from backend */
+    sign: string;
+    /** Timestamp used for signing (seconds) */
+    timestamp: number;
+}
+
+export { LoginResult }
+
+/**
+ * Map Token - Can override derived values
+ */
+export declare interface MapToken {
+    colorPrimary?: string;
+    colorPrimaryHover?: string;
+    colorPrimaryActive?: string;
+    colorPrimaryBg?: string;
+    colorSecondary?: string;
+    colorSuccess?: string;
+    colorWarning?: string;
+    colorError?: string;
+    colorBg?: string;
+    colorBgElevated?: string;
+    colorBgSpotlight?: string;
+    colorText?: string;
+    colorTextSecondary?: string;
+    colorTextTertiary?: string;
+    colorTextDisabled?: string;
+    colorBorder?: string;
+    colorBorderSecondary?: string;
+    borderRadius?: number;
+    borderRadiusSm?: number;
+    borderRadiusLg?: number;
+    fontSize?: number;
+    fontSizeSm?: number;
+    fontSizeLg?: number;
+    spacing?: number;
+    spacingXs?: number;
+    spacingSm?: number;
+    spacingMd?: number;
+    spacingLg?: number;
+    spacingXl?: number;
+}
+
+/**
+ * Mode-specific configuration
+ */
+declare interface ModeThemeConfig {
+    seed?: SeedToken;
+    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 主组件
+ *
+ * @description
+ * 将 taskon-website 中的 Quest (Campaign) 详情页迁移为 React Widget 组件
+ * 供第三方项目嵌入使用
+ *
+ * 架构原则：只在根组件访问 context，子组件通过 props 接收数据
+ *
+ * @example
+ * ```tsx
+ * import { QuestWidget } from '@taskon/widget-react';
+ *
+ * function App() {
+ *   return (
+ *     <TaskOnProvider config={{ ... }}>
+ *       <QuestWidget
+ *         campaignId={123}
+ *         showBanner={true}
+ *         onLoaded={(campaign) => console.log('Quest loaded:', campaign.name)}
+ *         onSubmitSuccess={() => console.log('Quest completed!')}
+ *       />
+ *     </TaskOnProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function QuestWidget(props: QuestWidgetProps): default_2.ReactElement;
+export { QuestWidget as Quest }
+export { QuestWidget }
+
+/**
+ * Quest Widget 主组件 Props
+ */
+export declare interface QuestWidgetProps {
+    /**
+     * Widget ID - 传入后从云端加载配置（theme + function）
+     * 云端配置包含 campaignId、显示选项、自定义分享文案等
+     */
+    widgetId?: number;
+    /**
+     * Campaign ID
+     * - 如果传入 widgetId，campaignId 可从云端配置获取
+     * - 如果同时传入 widgetId 和 campaignId，本地 props 优先
+     */
+    campaignId?: number;
+    /** 渠道标识（可选） */
+    channel?: string;
+    /** KOL 标识（可选） */
+    kolHandle?: string;
+    /** 邀请码（可选） */
+    inviteCode?: string;
+    /** Boost ID（可选） */
+    boostId?: number;
+    /** 是否为预览模式 */
+    isPreview?: boolean;
+    /** 是否显示 Banner */
+    showBanner?: boolean;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 是否显示描述 */
+    showDescription?: boolean;
+    /** 是否显示参与人数 */
+    showParticipants?: boolean;
+    /** 加载完成回调 */
+    onLoaded?: (campaign: QuestCampaignInfo) => void;
+    /** 任务完成回调 */
+    onTaskCompleted?: (taskId: number) => void;
+    /** Quest 提交成功回调 */
+    onSubmitSuccess?: () => void;
+    /** 错误回调 */
+    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>;
+    /**
+     * @deprecated 绑定现在由 Widget 内部处理，此回调不再使用
+     * 需要绑定链地址时的回调
+     */
+    onBindChainRequired?: (chainTypes: ChainType[]) => void;
+    /**
+     * @deprecated 绑定现在由 Widget 内部处理，此回调不再使用
+     * 需要绑定 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 }
+
+/**
+ * Seed Token - Input values that auto-derive other tokens
+ */
+export declare interface SeedToken {
+    /** Primary color */
+    colorPrimary?: string;
+    /** Secondary color */
+    colorSecondary?: string;
+    /** Success color */
+    colorSuccess?: string;
+    /** Warning color */
+    colorWarning?: string;
+    /** Error color */
+    colorError?: string;
+    /** Base border radius */
+    borderRadius?: number;
+    /** Base font size */
+    fontSize?: number;
+}
+
+/**
+ * Locales that have full translation support in all widgets
+ * Other locales in the Locale type will fallback to English
+ */
+export declare type SupportedLocale = "en" | "ko" | "ja";
+
+/**
+ * TaskOn Context value
+ */
+export declare interface TaskOnContextValue {
+    /**
+     * Provider configuration
+     */
+    config: TaskOnProviderConfig;
+    /**
+     * TaskOn client instance from @taskon/core
+     */
+    client: TaskOnClient | null;
+    /**
+     * Whether the provider is initializing
+     */
+    isInitializing: boolean;
+    /**
+     * Resolved locale
+     */
+    locale: Locale;
+    /**
+     * TaskOn user ID, null if not logged in
+     */
+    userId: number | null;
+    /**
+     * Current user info, null if not logged in
+     */
+    userInfo: UserInfo | null;
+    /**
+     * Current user token, null if not logged in
+     */
+    userToken: string | null;
+    /**
+     * Whether user is logged in
+     */
+    isLoggedIn: boolean;
+    /**
+     * Unified login method
+     */
+    login: (params: LoginParams) => Promise<void>;
+    /**
+     * Logout current user
+     */
+    logout: () => void;
+    /**
+     * Request login callback
+     * Triggers config.onRequestLogin if provided
+     */
+    requestLogin: () => void;
+    /**
+     * Refresh user info from server
+     * Call this after binding social accounts to update userInfo
+     */
+    refreshUserInfo: () => Promise<void>;
+    /**
+     * Chain info list (loaded on init)
+     * Used for determining chain types for wallet binding
+     */
+    chains: ChainInfo[];
+    /**
+     * Community info (auto-loaded on init based on apiKey)
+     * Used for displaying community logo and name in reward cards
+     */
+    communityInfo: CommunityInfo | null;
+}
+
+/**
+ * TaskOn Provider Component
+ *
+ * Root component for TaskOn Widget, providing:
+ * - TaskOn client management (based on @taskon/core)
+ * - User authentication (login/logout)
+ * - Locale configuration
+ * - Wallet management (uses window.ethereum adapter)
+ * - Widget locale preloading (optional)
+ * - Toast notifications (internal, user-transparent)
+ */
+export declare function TaskOnProvider({ config, children, preloadLocales, }: TaskOnProviderProps): ReactNode;
+
+/**
+ * TaskOn Provider configuration
+ */
+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
+     */
+    apiKey: string;
+    /**
+     * API base URL (optional)
+     * @default https://white-label-api.taskon.xyz
+     */
+    baseURL?: string;
+    /**
+     * Locale setting for internationalization
+     * @default auto-detect from browser
+     */
+    locale?: Locale;
+    /**
+     * Wallet configuration for blockchain interactions
+     *
+     * When not provided, TaskOn will use built-in window.ethereum adapter
+     * for EVM wallet connections (MetaMask, etc.)
+     */
+    walletConfig?: WalletConfig;
+    /**
+     * Callback when user requests to login
+     *
+     * This is triggered when user clicks on login overlay in widgets.
+     * Use this to show your login modal or redirect to login page.
+     *
+     * @example
+     * ```tsx
+     * <TaskOnProvider
+     *   config={{
+     *     apiKey: 'your-api-key',
+     *     onRequestLogin: () => {
+     *       setShowLoginModal(true);
+     *     },
+     *   }}
+     * >
+     * ```
+     */
+    onRequestLogin?: () => void;
+    /**
+     * OAuth tool URL for social account binding
+     *
+     * When users need to bind Twitter/Discord/Telegram accounts,
+     * this URL will be used to open the OAuth authorization popup.
+     *
+     * @default https://generalauthservice.com (main environment)
+     *
+     * For stage/test environment, use: https://stage.generalauthservice.com
+     */
+    oauthToolUrl?: string;
+    /**
+     * WalletConnect Project ID
+     *
+     * Required for WalletConnect functionality.
+     * Get your project ID at https://cloud.walletconnect.com
+     *
+     * If not provided, WalletConnect option will be disabled in the wallet dialog.
+     */
+    walletConnectProjectId?: string;
+}
+
+export declare interface TaskOnProviderProps {
+    /**
+     * TaskOn configuration object
+     */
+    config: TaskOnProviderConfig;
+    /**
+     * Child components
+     */
+    children: ReactNode;
+    /**
+     * List of widgets to preload locales for
+     */
+    preloadLocales?: WidgetName[];
+}
+
+/**
+ * Resolved theme object (returned by useTaskOnTheme)
+ */
+export declare interface TaskOnTheme {
+    /** Current mode (resolved, never "auto") */
+    mode: "light" | "dark";
+    /** Whether compact mode is enabled */
+    compact: boolean;
+    /** All tokens (resolved) */
+    tokens: Required<MapToken>;
+}
+
+/**
+ * Theme configuration
+ */
+export declare interface TaskOnThemeConfig {
+    /** Theme mode */
+    mode?: ThemeMode;
+    /** Compact mode */
+    compact?: boolean;
+    /** Seed tokens */
+    seed?: SeedToken;
+    /** Map tokens (override derived values) */
+    map?: MapToken;
+    /** Light mode specific configuration */
+    light?: ModeThemeConfig;
+    /** Dark mode specific configuration */
+    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
+ */
+export declare type TFunction<T> = <K extends keyof T>(key: K, params?: InterpolationParams) => string;
+
+/**
+ * Theme mode
+ * - light: Light mode
+ * - dark: Dark mode
+ * - auto: Follow system preference
+ */
+export declare type ThemeMode = "light" | "dark" | "auto";
+
+/**
+ * Theme Provider Component
+ *
+ * Provides theme configuration with support for:
+ * - light/dark/auto modes
+ * - Seed token derivation
+ * - Map token overrides
+ *
+ * @example
+ * ```tsx
+ * <ThemeProvider theme={{ mode: 'dark', seed: { colorPrimary: '#6366f1' } }}>
+ *   <App />
+ * </ThemeProvider>
+ * ```
+ */
+export declare function ThemeProvider({ theme: themeConfig, children, }: ThemeProviderProps): ReactNode;
+
+/**
+ * ThemeProvider Props
+ */
+export declare interface ThemeProviderProps {
+    /** Theme configuration */
+    theme?: TaskOnThemeConfig;
+    /** Child components */
+    children: React.ReactNode;
+}
+
+/**
+ * Hook for loading common locale messages
+ *
+ * @returns Object containing common messages and loading state
+ *
+ * @example
+ * ```tsx
+ * function MyWidget() {
+ *   const { messages: common, isLoading } = useCommonLocale();
+ *
+ *   if (isLoading) return <div>{common.loading}</div>;
+ *
+ *   return <button onClick={retry}>{common.retry}</button>;
+ * }
+ * ```
+ */
+export declare function useCommonLocale(): UseWidgetLocaleResult<CommonMessages>;
+
+/**
+ * Hook to access EVM wallet
+ */
+export declare function useEvmWallet(): {
+    adapter: WalletAdapter | null;
+    address: string | null;
+    chainId: number | null;
+    isConnected: boolean;
+    connect: () => Promise<string | null>;
+    disconnect: () => Promise<void>;
+    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 外层组件
+ *
+ * Handles cloud config loading + ThemeProvider wrapping via WidgetShell.
+ * Merges cloud function config with local props, then renders inner component.
+ *
+ * @example
+ * ```tsx
+ * // Pure props mode (existing behavior)
+ * <UserCenterWidget config={tabConfig} />
+ *
+ * // Pure widgetId mode (config from cloud)
+ * <UserCenterWidget widgetId={456} />
+ *
+ * // Mixed mode (props override cloud)
+ * <UserCenterWidget widgetId={456} defaultTab={UserCenterTabType.Identity} />
+ * ```
+ */
+export declare function UserCenterWidget(props: UserCenterWidgetProps): default_2.ReactElement;
+
+/**
+ * UserCenterWidget 属性
+ */
+export declare interface UserCenterWidgetProps {
+    /**
+     * Widget ID - load configuration (theme + function) from cloud
+     * Cloud config provides tab options, display settings, etc.
+     */
+    widgetId?: number;
+    /** Widget 配置 */
+    config?: UserCenterConfig;
+    /** 默认选中的 Tab */
+    defaultTab?: UserCenterTabType;
+    /** 默认选中的奖励卡片（MyRewards 内部） */
+    defaultRewardCard?: UserCenterRewardCardType;
+    /** 默认 Points ID（仅当 defaultRewardCard=Points 时使用） */
+    defaultPointId?: number;
+    /** Tab 切换回调 */
+    onTabChange?: (tab: UserCenterTabType) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: default_2.CSSProperties;
+}
+
+export { UserInfo }
+
+/**
+ * Public hook for TaskOn authentication
+ *
+ * @example
+ * ```tsx
+ * const { login, logout, userId, isLoggedIn, requestLogin } = useTaskOnAuth();
+ *
+ * // EVM wallet login
+ * await login({ method: 'evm_wallet', value: '0x...', sign, timestamp });
+ *
+ * // Email login
+ * await login({ method: 'email', value: 'user@example.com', sign, timestamp });
+ *
+ * // Discord login
+ * await login({ method: 'discord', value: oauthToken, sign, timestamp });
+ *
+ * // Request login (triggers config.onRequestLogin)
+ * requestLogin();
+ * ```
+ */
+export declare function useTaskOnAuth(): {
+    userId: number | null;
+    isLoggedIn: boolean;
+    isInitializing: boolean;
+    login: (params: LoginParams) => Promise<void>;
+    logout: () => void;
+    requestLogin: () => void;
+};
+
+/**
+ * Get current theme
+ * Must be used within a ThemeProvider
+ */
+export declare function useTaskOnTheme(): TaskOnTheme;
+
+/**
+ * Hook for widget translations with interpolation support
+ *
+ * This is a higher-level hook that wraps useWidgetLocale and adds
+ * a `t` function for convenient string interpolation.
+ *
+ * @template T - The shape of the messages object
+ * @param options - Same options as useWidgetLocale
+ * @returns Object containing t function, messages, and loading state
+ *
+ * @example
+ * ```tsx
+ * // messages/en.ts
+ * export default {
+ *   greeting: 'Hello, {name}!',
+ *   points: 'You have {count} points',
+ *   title: 'Task Widget',
+ * };
+ *
+ * // Component
+ * function TaskWidget() {
+ *   const { t, isLoading } = useTranslation({
+ *     widgetId: 'TaskWidget',
+ *     defaultMessages: enMessages,
+ *     loadMessages,
+ *   });
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h1>{t('title')}</h1>
+ *       <p>{t('greeting', { name: 'John' })}</p>
+ *       <p>{t('points', { count: 100 })}</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useTranslation<T>(options: UseWidgetLocaleOptions<T>): UseTranslationResult<T>;
+
+/**
+ * Return type for useTranslation hook
+ */
+export declare interface UseTranslationResult<T> {
+    /**
+     * Translation function with interpolation support
+     *
+     * @example
+     * ```ts
+     * t('greeting', { name: 'John' })  // => 'Hello, John!'
+     * t('points', { count: 100 })      // => 'You have 100 points'
+     * ```
+     */
+    t: TFunction<T>;
+    /**
+     * Raw messages object (without interpolation)
+     * Useful when you need direct access to message strings
+     */
+    messages: T;
+    /**
+     * Whether translations are currently loading
+     */
+    isLoading: boolean;
+}
+
+/**
+ * Hook to access wallet context
+ * Returns wallet state and actions for EVM
+ *
+ * @example
+ * ```tsx
+ * const { evmAddress, isEvmConnected, connectEvm, signEvmMessage } = useWallet();
+ *
+ * // Connect EVM wallet
+ * const address = await connectEvm();
+ *
+ * // Sign message
+ * const signature = await signEvmMessage("Hello World");
+ * ```
+ */
+export declare function useWallet(): WalletContextValue;
+
+/**
+ * Hook for loading widget-specific locale messages
+ *
+ * @template T - The shape of the messages object
+ * @param options - Configuration options
+ * @param options.defaultMessages - English messages (inlined, no loading needed)
+ * @param options.loadMessages - Function to dynamically import other locales
+ * @returns Object containing messages and loading state
+ *
+ * @example
+ * ```tsx
+ * import enMessages from './locales/en';
+ *
+ * function TaskWidget() {
+ *   const { messages, isLoading } = useWidgetLocale({
+ *     defaultMessages: enMessages,
+ *     loadMessages: (locale) => import(`./locales/${locale}.ts`),
+ *   });
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *
+ *   return <button>{messages.claim}</button>;
+ * }
+ * ```
+ */
+export declare function useWidgetLocale<T>(options: UseWidgetLocaleOptions<T>): UseWidgetLocaleResult<T>;
+
+/**
+ * Options for useWidgetLocale hook
+ *
+ * @template T - The shape of the messages object
+ */
+export declare interface UseWidgetLocaleOptions<T> {
+    /**
+     * Unique identifier for this widget
+     * Used as cache key prefix to avoid conflicts between widgets
+     *
+     * @example "TaskWidget", "WalletWidget"
+     */
+    widgetId: string;
+    /**
+     * Default messages (English) - inlined in bundle
+     * These are used immediately without any loading
+     */
+    defaultMessages: T;
+    /**
+     * Function to dynamically load messages for other locales
+     * Should return a dynamic import promise
+     *
+     * @example
+     * ```ts
+     * loadMessages: (locale) => import(`./locales/${locale}.ts`)
+     * ```
+     */
+    loadMessages: (locale: Locale) => Promise<{
+        default: T;
+    }>;
+}
+
+/**
+ * Return type for useWidgetLocale hook
+ *
+ * @template T - The shape of the messages object
+ */
+export declare interface UseWidgetLocaleResult<T> {
+    /**
+     * Current messages object based on active locale
+     * Falls back to default (English) messages if loading fails
+     */
+    messages: T;
+    /**
+     * Whether the locale messages are currently loading
+     * Only true when switching to a non-default locale
+     */
+    isLoading: boolean;
+}
+
+/**
+ * Wallet adapter interface for blockchain interactions
+ *
+ * This interface abstracts wallet operations, allowing widgets to work with
+ * different wallet providers (custom implementations or built-in adapters)
+ */
+export declare interface WalletAdapter {
+    /**
+     * Connect to wallet and return the connected address
+     * Should open wallet selection UI if needed
+     */
+    connect: () => Promise<string>;
+    /**
+     * Disconnect from wallet
+     */
+    disconnect: () => Promise<void>;
+    /**
+     * Sign a message with the connected wallet
+     * @param message - The message to sign
+     * @returns The signature
+     */
+    signMessage: (message: string) => Promise<string>;
+    /**
+     * Get the currently connected address
+     * @returns The address or null if not connected
+     */
+    getAddress: () => string | null;
+    /**
+     * Get the current chain ID
+     * @returns The chain ID or null if not available
+     */
+    getChainId?: () => number | null;
+    /**
+     * Switch to a different network
+     * @param chainId - The target chain ID
+     */
+    switchNetwork?: (chainId: number) => Promise<void>;
+    /**
+     * Invoke a smart contract method
+     * @param params - Contract invocation parameters
+     * @returns Transaction hash
+     */
+    invokeContract?: (params: InvokeContractParams) => Promise<string>;
+    /**
+     * Get wallet's native token balance (for gas estimation)
+     * @returns Balance in wei (string)
+     */
+    getBalance?: () => Promise<string>;
+    /**
+     * Subscribe to account changes
+     * @param callback - Called when account changes
+     * @returns Unsubscribe function
+     */
+    onAccountChange?: (callback: (address: string | null) => void) => () => void;
+    /**
+     * Subscribe to chain/network changes
+     * @param callback - Called when chain changes
+     * @returns Unsubscribe function
+     */
+    onChainChange?: (callback: (chainId: number) => void) => () => void;
+}
+
+/**
+ * Wallet configuration for TaskOnProvider
+ */
+export declare interface WalletConfig {
+    /**
+     * Custom EVM wallet adapter
+     * If not provided, uses built-in window.ethereum adapter
+     */
+    evmAdapter?: WalletAdapter;
+    /**
+     * Disable auto-detection of wallet providers
+     * When true, only uses adapter explicitly provided above
+     * @default false
+     */
+    disableAutoDetect?: boolean;
+}
+
+/**
+ * Wallet context value type
+ */
+declare interface WalletContextValue extends WalletState {
+    connectEvm: () => Promise<string | null>;
+    disconnectEvm: () => Promise<void>;
+    signEvmMessage: (message: string) => Promise<string | null>;
+}
+
+/**
+ * Wallet state exposed through context
+ */
+export declare interface WalletState {
+    evmAdapter: WalletAdapter | null;
+    evmAddress: string | null;
+    evmChainId: number | null;
+    isEvmConnected: boolean;
+    isDetecting: boolean;
+}
+
+/**
+ * Supported widget names for preloading
+ */
+export declare type WidgetName = "CommunityTask";
+
+export { }