@taskon/widget-react 0.0.1 → 0.0.2

package/dist/community-task.d.ts

@@ -1,247 +1,5 @@
-import { ChainType } from '@taskon/core';
-import { CommunityTaskInfo } from '@taskon/core';
 import { default as default_2 } from 'react';
-import { RecurrenceType } from '@taskon/core';
-import { SnsType } from '@taskon/core';
-import { TaskReviewResult } from '@taskon/core';
-
-/**
- * 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>
- * ```
- */
-declare function BaseTask(props: BaseTaskProps): default_2.ReactElement;
-export { BaseTask }
-export { BaseTask as CommunityTask }
-
-/**
- * 任务卡片基础 Props（最小知识原则）
- * BaseTask 只需要知道这些信息
- */
-declare interface BaseTaskProps {
-    /** 任务名称/标题（字符串或自定义渲染节点） */
-    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;
-}
-export { BaseTaskProps }
-export { BaseTaskProps as CommunityTaskProps }
+import { RewardDisplayMode } from '@taskon/core';
 
 /**
  * CommunityTaskList outer wrapper
@@ -260,6 +18,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;
     /** 社区信息（用于前置任务链接跳转） */
@@ -278,8 +41,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}`)}
@@ -287,13 +51,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) */
@@ -304,148 +83,10 @@ export declare interface CommunityTaskListProps {
     showSectorDescription?: boolean;
     /** Whether to show sector reward (default: true) */
     showSectorReward?: boolean;
+    /** How reward details are displayed in TaskChain claimed NFT cards */
+    rewardDisplayMode?: RewardDisplayMode;
+    /** Redirect URL for reward details when mode is redirect */
+    rewardRedirectUrl?: string;
 }
 
-/** 奖励信息（统一格式） */
-declare interface RewardInfo {
-    /** 奖励类型 */
-    type: "points" | "token" | "none";
-    /** 积分数量（仅 points 类型） */
-    amount?: number;
-    /** 积分名称（仅 points 类型） */
-    name?: string;
-    /** 积分图标（仅 points 类型） */
-    icon?: string;
-    /** 积分 ID（仅 points 类型） */
-    pointsId?: number;
-    /** 代币信息（仅 token 类型） */
-    token?: {
-        name: string;
-        amount: string;
-        address: string;
-        chain: string;
-        icon?: string;
-        /** 链图标 URL */
-        chainIcon?: string;
-        /** 总奖励单位数 */
-        totalUnit?: number;
-        /** 可用单位数 */
-        availableUnit?: number;
-    };
-}
-
-/**
- * useSubmitTask Hook
- * @description 处理任务提交逻辑
- * @module widgets/CommunityTask/hooks/useSubmitTask
- */
-/** 任务提交返回值 */
-declare interface SubmitTaskResult {
-    /** 是否成功 */
-    successful: boolean;
-    /** 冷却时间（毫秒） */
-    cool_down?: number;
-    /** 错误信息 */
-    error?: string;
-    /** 错误码（用于判断是否是 UNAUTHORIZED 等特殊错误） */
-    errorCode?: string;
-}
-
-/** 时间信息返回值 */
-declare interface TimeInfo {
-    /** 开始时间（格式化后的字符串） */
-    startTime: string;
-    /** 结束时间（格式化后的字符串） */
-    endTime: string;
-    /** 开始时间戳 */
-    startTimestamp: number | null;
-    /** 结束时间戳 */
-    endTimestamp: number | null;
-    /** 是否即将开始（未到开始时间） */
-    isUpcoming: boolean;
-    /** 是否已过期（超过结束时间） */
-    isExpired: boolean;
-}
-
-/**
- * useSubmitTask Hook
- * @description 提供任务提交功能，处理提交状态和错误
- *
- * @param taskId 任务 ID
- * @param onSuccess 提交成功回调（用于刷新任务状态）
- * @param platform 任务平台类型（用于显示平台相关的错误提示）
- * @param options 配置选项
- * @returns 提交函数和提交状态
- *
- * @example
- * ```tsx
- * const { submitTask, isSubmitting, error } = useSubmitTask(task.id, () => {
- *   console.log('任务提交成功，刷新状态');
- *   onUpdate();
- * }, 'Twitter');
- *
- * // 提交任务
- * const result = await submitTask();
- * if (result.successful) {
- *   // 成功处理
- * }
- * ```
- */
-export declare function useSubmitTask(taskId: number, onSuccess?: () => void, platform?: string, options?: UseSubmitTaskOptions): {
-    /** 提交任务函数 */
-    submitTask: (taskValue?: string) => Promise<SubmitTaskResult>;
-    /** 是否正在提交 */
-    isSubmitting: boolean;
-    /** 错误信息 */
-    error: string | null;
-};
-
-/**
- * useSubmitTask Hook 配置选项
- */
-declare interface UseSubmitTaskOptions {
-    /**
-     * 验证失败时是否也刷新数据
-     * 用于 SwapDex 等任务：用户完成了链上操作（times 增加），但还没达到要求次数
-     * 此时验证返回 false，但需要刷新以显示更新后的 times
-     */
-    refreshOnFail?: boolean;
-}
-
-/**
- * useTaskReward Hook
- * @description 根据任务信息计算奖励信息
- *
- * @param task 任务完整信息（可选，为 undefined 时返回无奖励）
- * @returns 奖励信息对象
- *
- * @example
- * ```tsx
- * const reward = useTaskReward(task);
- * if (reward.type === 'points') {
- *   console.log(reward.amount); // 100
- *   console.log(reward.name); // "TaskOn Points"
- * }
- * ```
- */
-export declare function useTaskReward(task: CommunityTaskInfo | undefined): RewardInfo;
-
-/**
- * useTaskTime Hook
- * @description 根据任务信息计算时间相关状态
- *
- * @param task 任务完整信息
- * @returns 时间信息对象
- *
- * @example
- * ```tsx
- * const timeInfo = useTaskTime(task);
- * if (timeInfo.isExpired) {
- *   console.log('任务已过期');
- * }
- * console.log(timeInfo.endTime); // "03/05/2026 02:18:52 UTC"
- * ```
- */
-export declare function useTaskTime(task: CommunityTaskInfo): TimeInfo;
-
 export { }

package/dist/community-task.js

@@ -1,9 +1,4 @@
-import { B, B as B2, C, b, u, a } from "./chunks/CommunityTaskList-CrH6r4Av.js";
+import { C } from "./chunks/CommunityTaskList-2nFy6l6m.js";
 export {
-  B as BaseTask,
-  B2 as CommunityTask,
-  C as CommunityTaskList,
-  b as useSubmitTask,
-  u as useTaskReward,
-  a as useTaskTime
+  C as CommunityTaskList
 };