@taskon/widget-react 0.0.1 → 0.0.2

package/dist/quest.d.ts

@@ -1,174 +1,10 @@
-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 主组件
@@ -210,6 +46,14 @@ export declare interface QuestWidgetProps {
      * 云端配置包含 campaignId、显示选项、自定义分享文案等
      */
     widgetId?: number;
+    /**
+     * 手动主题模式（传入后拥有最高优先级）
+     * 建议在云端配置为 dual + toggle 时使用，避免与固定模式配置语义冲突。
+     * - light: 强制浅色主题
+     * - dark: 强制深色主题
+     * - auto: 跟随系统主题
+     */
+    themeMode?: "light" | "dark" | "auto";
     /**
      * Campaign ID
      * - 如果传入 widgetId，campaignId 可从云端配置获取
@@ -232,6 +76,8 @@ export declare interface QuestWidgetProps {
     showTitle?: boolean;
     /** 是否显示描述 */
     showDescription?: boolean;
+    /** 是否显示参与人数 */
+    showParticipants?: boolean;
     /** 加载完成回调 */
     onLoaded?: (campaign: QuestCampaignInfo) => void;
     /** 任务完成回调 */
@@ -242,8 +88,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>;
     /**
@@ -256,134 +100,18 @@ export declare interface QuestWidgetProps {
      * 需要绑定 SNS 时的回调
      */
     onBindSnsRequired?: (snsTypes: SnsType[]) => void;
-    /** 分享链接（配置后显示分享按钮） */
+    /** 是否显示分享按钮（默认 true） */
+    showShare?: boolean;
+    /** 分享链接（未配置时回退到当前页面 URL） */
     shareUrl?: string;
     /** Twitter 分享文案（可选，有默认文案） */
     shareText?: 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;
+    /** 是否在 Twitter 分享文案末尾自动追加带 utm_source=x 的链接（默认 true） */
+    shareAutoAppendLink?: boolean;
+    /** 奖励详情展示模式：popup 弹窗 / redirect 跳转（默认 popup） */
+    rewardDisplayMode?: RewardDisplayMode;
+    /** 跳转 URL（当 rewardDisplayMode 为 'redirect' 时使用） */
+    rewardRedirectUrl?: string;
 }
 
 export { }

package/dist/quest.js

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

package/dist/user-center.d.ts

@@ -0,0 +1,56 @@
+import { default as default_2 } from 'react';
+import { UserCenterConfig } from '@taskon/core';
+import { UserCenterRewardCardType } from '@taskon/core';
+import { UserCenterTabType } from '@taskon/core';
+
+/**
+ * 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;
+    /**
+     * 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;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: default_2.CSSProperties;
+}
+
+export { }

package/dist/user-center.js

@@ -0,0 +1,4 @@
+import { U } from "./chunks/UserCenterWidget-XL6LZRZM.js";
+export {
+  U as UserCenterWidget
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskon/widget-react",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "TaskOn React Widget Library",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,14 @@
     "./quest": {
       "types": "./dist/quest.d.ts",
       "import": "./dist/quest.js"
+    },
+    "./user-center": {
+      "types": "./dist/user-center.d.ts",
+      "import": "./dist/user-center.js"
+    },
+    "./page-builder": {
+      "types": "./dist/page-builder.d.ts",
+      "import": "./dist/page-builder.js"
     }
   },
   "files": [
@@ -38,6 +46,9 @@
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "lint": "eslint . --max-warnings 0",
     "check-types": "tsc --noEmit",
     "prepublishOnly": "node ../../scripts/prepublish.js && pnpm build",
@@ -53,20 +64,28 @@
     "@taskon/core": "workspace:*",
     "@taskon/eslint-config": "workspace:*",
     "@taskon/typescript-config": "workspace:*",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
     "@types/dompurify": "^3.2.0",
     "@types/node": "^22.15.3",
     "@types/qrcode": "^1.5.5",
     "@types/react": "19.2.2",
     "@types/react-dom": "19.2.2",
     "@vitejs/plugin-react": "^4.5.2",
+    "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.1",
     "ethers": "^6.0.0",
+    "jsdom": "^22.1.0",
+    "postcss-custom-media": "^12.0.1",
+    "postcss-import": "^16.1.1",
+    "postcss-mixins": "^12.1.2",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "typescript": "5.9.2",
+    "typescript": "5.8.2",
     "vite": "^6.3.5",
     "vite-plugin-dts": "^4.5.4",
-    "vite-plugin-lib-inject-css": "^2.2.2"
+    "vite-plugin-lib-inject-css": "^2.2.2",
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
     "@taskon/core": "^0.0.1",