@taskon/widget-react 0.0.1-beta.1

package/dist/quest.d.ts

@@ -0,0 +1,400 @@
+import { CampaignStatus } from '@taskon/core';
+import { CampaignStatusInfo } from '@taskon/core';
+import { CampaignWinnerReward } from '@taskon/core';
+import { ChainType } from '@taskon/core';
+import { default as default_2 } from 'react';
+import { EligibilityValueItem } from '@taskon/core';
+import { QuestApi } from '@taskon/core';
+import { QuestCampaignInfo } from '@taskon/core';
+import { QuestPointsInfo } from '@taskon/core';
+import { QuestRewardInfo } from '@taskon/core';
+import { QuestRewardInfoSimple } from '@taskon/core';
+import { RewardDisplayMode } from '@taskon/core';
+import { RewardValueInfo } from '@taskon/core';
+import { SnsType } from '@taskon/core';
+import { TaskValueItem } from '@taskon/core';
+import { UserCampaignStatusInfo } from '@taskon/core';
+import { UserTaskStatus } from '@taskon/core';
+
+/**
+ * Quest Complete Button 组件 Props
+ */
+export declare interface QuestCompleteButtonProps {
+    /** Campaign ID */
+    campaignId: number;
+    /** Campaign 信息 */
+    campaign: QuestCampaignInfo;
+    /** 用户状态信息 */
+    userStatus?: UserCampaignStatusInfo;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 提交成功回调 */
+    onSuccess?: () => void;
+    /** 提交失败回调 */
+    onError?: (error: Error) => void;
+}
+
+/**
+ * Quest 资格展示信息
+ */
+export declare interface QuestEligibilityDisplay {
+    /** 资格条件列表 */
+    eligibilities: EligibilityValueItem[];
+    /** 用户是否符合资格 */
+    isEligible: boolean;
+    /** 各条件的验证结果 */
+    eligibilityResults: boolean[];
+}
+
+/**
+ * Quest Header 组件 Props
+ */
+export declare interface QuestHeaderProps {
+    /** Campaign 信息 */
+    campaign: QuestCampaignInfo;
+    /** 是否显示 Banner */
+    showBanner?: boolean;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 是否显示描述 */
+    showDescription?: boolean;
+    /** 查看更多描述回调 */
+    onViewMore?: () => void;
+}
+
+/**
+ * Quest 奖励展示信息
+ */
+export declare interface QuestRewardDisplay {
+    /** 资格者奖励 */
+    qualifierRewards: QuestRewardInfo[];
+    /** 获奖者奖励（简化信息） */
+    winnerRewardsSimple: QuestRewardInfoSimple[];
+    /** 是否有资格者奖励 */
+    hasQualifierRewards: boolean;
+    /** 是否有获奖者奖励 */
+    hasWinnerRewards: boolean;
+}
+
+/**
+ * Quest Sidebar 组件 Props
+ */
+export declare interface QuestSidebarProps {
+    /** Campaign 信息 */
+    campaign: QuestCampaignInfo;
+    /** Campaign 状态信息 */
+    statusInfo?: CampaignStatusInfo;
+    /** 用户状态信息 */
+    userStatus?: UserCampaignStatusInfo;
+}
+
+/**
+ * Quest 状态信息（用于展示）
+ */
+export declare interface QuestStatusDisplay {
+    /** 状态类型 */
+    status: QuestStatusType;
+    /** 状态标签（Upcoming / Ongoing / Ended） */
+    label: string;
+    /** 原始状态枚举 */
+    originalStatus: CampaignStatus;
+    /** 是否已开始 */
+    isStarted: boolean;
+    /** 是否已结束 */
+    isEnded: boolean;
+    /** 是否进行中 */
+    isActive: boolean;
+    /** 剩余时间（毫秒，仅进行中状态有效） */
+    remainingTime?: number;
+}
+
+/**
+ * Quest 状态（简化）
+ */
+export declare type QuestStatusType = "upcoming" | "ongoing" | "ended";
+
+/**
+ * Quest Task List 组件 Props
+ */
+export declare interface QuestTaskListProps {
+    /** 任务列表 */
+    tasks: TaskValueItem[];
+    /** 用户任务状态 */
+    userTaskStatuses?: UserTaskStatus[];
+    /** Campaign ID */
+    campaignId: number;
+    /** 任务点击回调 */
+    onTaskClick?: (task: TaskValueItem) => void;
+    /** 任务完成回调 */
+    onTaskCompleted?: (taskId: number) => void;
+}
+
+/**
+ * Quest 任务进度信息
+ */
+export declare interface QuestTaskProgress {
+    /** 必做任务总数 */
+    requiredTotal: number;
+    /** 必做任务已完成数 */
+    requiredCompleted: number;
+    /** 选做任务总数 */
+    optionalTotal: number;
+    /** 选做任务已完成数 */
+    optionalCompleted: number;
+    /** 最少需要完成的选做任务数 */
+    minOptionalRequired: number;
+    /** 是否满足提交条件 */
+    canSubmit: boolean;
+    /** 当前积分 */
+    currentPoints: QuestPointsInfo | null;
+}
+
+/**
+ * Quest 用户状态展示信息
+ */
+export declare interface QuestUserStatusDisplay {
+    /** 是否为访客 */
+    isVisitor: boolean;
+    /** 是否为参与者 */
+    isParticipant: boolean;
+    /** 是否已提交 */
+    isSubmitter: boolean;
+    /** 是否为资格者 */
+    isQualifier: boolean;
+    /** 是否为获奖者 */
+    isWinner: boolean;
+    /** 提交是否失败 */
+    submitFailed: boolean;
+    /** 用户排名 */
+    ranking: number;
+    /** 任务进度 */
+    taskProgress: QuestTaskProgress;
+}
+
+/**
+ * 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;
+}
+
+/**
+ * 获取 Quest 详情 Hook
+ *
+ * @param options Hook 配置（包含从根组件传入的 api 实例）
+ * @returns Quest 详情、加载状态、错误信息、重新加载方法
+ */
+export declare function useQuestDetail(options: UseQuestDetailOptions): UseQuestDetailReturn;
+
+/**
+ * useQuestDetail Hook 参数
+ */
+export 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 返回值
+ */
+export 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 参数
+ */
+export declare interface UseQuestStatusOptions {
+    /** Quest API 实例（从根组件传入） */
+    api: QuestApi | null;
+    /** Campaign ID */
+    campaignId: number;
+    /** 渠道标识 */
+    channel?: string;
+    /** KOL 句柄 */
+    kolHandle?: string;
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+}
+
+/**
+ * useQuestStatus Hook 返回值
+ */
+export 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 参数
+ */
+export declare interface UseQuestUserStatusOptions {
+    /** Quest API 实例（从根组件传入） */
+    api: QuestApi | null;
+    /** Campaign ID */
+    campaignId: number;
+    /** 渠道标识（可选） */
+    channel?: string;
+    /** KOL 标识（可选） */
+    kolHandle?: string;
+    /** 是否启用（默认 true） */
+    enabled?: boolean;
+}
+
+/**
+ * useQuestUserStatus Hook 返回值
+ */
+export 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;
+}
+
+export { }

package/dist/quest.js

@@ -0,0 +1,8 @@
+import { Q, Q as Q2, u, b, a } from "./chunks/Quest-DKFZ-pPU.js";
+export {
+  Q as Quest,
+  Q2 as QuestWidget,
+  u as useQuestDetail,
+  b as useQuestStatus,
+  a as useQuestUserStatus
+};