@taskon/widget-react 0.0.1-beta.2 → 0.0.1-beta.4

package/dist/index.d.ts

@@ -2,6 +2,7 @@ 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';
@@ -179,6 +180,39 @@ export declare interface CardSelectorProps<T = string | number> {
  */
 export declare function clearLocaleCache(): void;
 
+/**
+ * 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
+ * ```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 },
+ * };
+ *
+ * const reactTheme = cloudThemeToReactTheme(cloudTheme);
+ * // { mode: "auto", seed: { borderRadius: 8, fontSize: 14 }, light: {...}, dark: {...} }
+ * ```
+ */
+export declare function cloudThemeToReactTheme(cloud: CloudThemeConfig): TaskOnThemeConfig;
+
 /**
  * Common messages type definition
  *
@@ -248,6 +282,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;
     /** 社区信息（用于前置任务链接跳转） */
@@ -266,8 +305,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}`)}
@@ -275,13 +315,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) */
@@ -292,6 +347,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;
 }
 
 /**
@@ -466,6 +525,11 @@ export declare interface CommunityTaskProps {
     coolDown?: number;
     /** 冷却结束回调（用于重置 coolDown 状态） */
     onCoolDownComplete?: () => void;
+    /**
+     * 周期任务倒计时结束回调
+     * 用于在 next_time 到期后刷新单个任务卡片状态
+     */
+    onDoneCountdownComplete?: (taskId: number) => void | Promise<void>;
     /** 是否禁用交互 */
     disabled?: boolean;
     /**
@@ -497,6 +561,84 @@ export declare interface CommunityTaskProps {
     nextTime?: number;
 }
 
+/**
+ * ConfirmNoticeDialog component
+ *
+ * @description
+ * - Replicates the original ConfirmNotice content structure
+ * - Supports default two-button mode and custom action slot
+ * - Reuses Dialog for accessibility / portal / keyboard interactions
+ * - Intentionally removes glow background layer
+ */
+export declare function ConfirmNoticeDialog({ open, onOpenChange, type, title, desc, col, cancelButton, confirmButton, onCancel, onConfirm, onClose, closeOnCancel, closeOnConfirm, cancelDisabled, confirmDisabled, showCloseButton, closeOnOverlayClick, closeOnEscapeKey, maxWidth, className, contentClassName, children, actions, footer, accessibilityTitle, accessibilityDescription, }: ConfirmNoticeDialogProps): default_2.ReactElement;
+
+/**
+ * ConfirmNoticeDialog props
+ */
+export declare interface ConfirmNoticeDialogProps {
+    /** Whether the dialog is open (controlled) */
+    open: boolean;
+    /** Controlled open state callback */
+    onOpenChange: (open: boolean) => void;
+    /** Notice visual type */
+    type?: ConfirmNoticeType;
+    /** Title rendered below the icon */
+    title?: default_2.ReactNode;
+    /** Description rendered below the title */
+    desc?: default_2.ReactNode;
+    /** Allow action area wrapping on desktop */
+    col?: boolean;
+    /** Cancel button label. Hidden if omitted */
+    cancelButton?: default_2.ReactNode;
+    /** Confirm button label. Hidden if omitted */
+    confirmButton?: default_2.ReactNode;
+    /** Cancel button click callback */
+    onCancel?: () => void;
+    /** Confirm button click callback */
+    onConfirm?: () => void;
+    /** Called when dialog closes via overlay / ESC / close button / programmatic close */
+    onClose?: () => void;
+    /** Auto close after cancel click, defaults to true */
+    closeOnCancel?: boolean;
+    /** Auto close after confirm click, defaults to true */
+    closeOnConfirm?: boolean;
+    /** Disable cancel button */
+    cancelDisabled?: boolean;
+    /** Disable confirm button */
+    confirmDisabled?: boolean;
+    /** Show top-right close button, defaults to false (closer to original ConfirmNotice) */
+    showCloseButton?: boolean;
+    /** Allow closing by overlay click, defaults to true */
+    closeOnOverlayClick?: boolean;
+    /** Allow closing by ESC key, defaults to true */
+    closeOnEscapeKey?: boolean;
+    /** Dialog max width, defaults to 470 (same as original) */
+    maxWidth?: string | number;
+    /** Additional class on content root */
+    className?: string;
+    /** Additional class on Dialog.Content */
+    contentClassName?: string;
+    /** Custom body content between description and actions */
+    children?: default_2.ReactNode;
+    /** Custom action area. Overrides default cancel/confirm buttons */
+    actions?: default_2.ReactNode;
+    /** Extra content rendered after actions */
+    footer?: default_2.ReactNode;
+    /**
+     * Accessible dialog title
+     * - Falls back to string `title`
+     * - Uses default value when title is not a string
+     */
+    accessibilityTitle?: string;
+    /** Accessible dialog description */
+    accessibilityDescription?: string;
+}
+
+/**
+ * ConfirmNotice visual style type
+ */
+export declare type ConfirmNoticeType = "default" | "success" | "warn";
+
 /**
  * Create a locale loader function for a widget
  *
@@ -626,6 +768,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 的配置和显示选项
@@ -689,13 +836,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;
@@ -776,6 +942,14 @@ export declare interface QuestWidgetProps {
      * 云端配置包含 campaignId、显示选项、自定义分享文案等
      */
     widgetId?: number;
+    /**
+     * 手动主题模式（传入后拥有最高优先级）
+     * 建议在云端配置为 dual + toggle 时使用，避免与固定模式配置语义冲突。
+     * - light: 强制浅色主题
+     * - dark: 强制深色主题
+     * - auto: 跟随系统主题
+     */
+    themeMode?: "light" | "dark" | "auto";
     /**
      * Campaign ID
      * - 如果传入 widgetId，campaignId 可从云端配置获取
@@ -810,8 +984,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>;
     /**
@@ -854,10 +1026,22 @@ 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;
 }
 
 /**
@@ -1045,6 +1229,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 */
@@ -1076,7 +1266,7 @@ export declare interface TaskOnThemeConfig {
  * />
  * ```
  */
-export declare function TemplateTask({ task, userStatus, meetConditions, communityInfo, disabled, onClick, onClaim, onUpdate, onEligTaskClick, coolDown: sharedCoolDown, onCoolDownComplete: sharedOnCoolDownComplete, }: TemplateTaskProps): default_2.ReactElement;
+export declare function TemplateTask({ task, userStatus, meetConditions, communityInfo, disabled, onClick, onClaim, onUpdate, onEligTaskClick, coolDown: sharedCoolDown, onCoolDownComplete: sharedOnCoolDownComplete, onDoneCountdownComplete, }: TemplateTaskProps): default_2.ReactElement;
 
 /**
  * TemplateTask 组件属性
@@ -1107,13 +1297,15 @@ export declare interface TemplateTaskProps {
         cool_down?: number;
     }>;
     /** 任务更新回调（完成/验证成功后） */
-    onUpdate?: () => void;
+    onUpdate?: (taskId: number) => void | Promise<void>;
     /** 点击资格条件中的前置任务回调（用于打开任务弹窗） */
     onEligTaskClick?: (taskId: number) => void;
     /** 共享的 coolDown 值（来自父组件） */
     coolDown?: number;
     /** coolDown 倒计时结束回调 */
     onCoolDownComplete?: () => void;
+    /** 周期任务倒计时结束回调（用于刷新单任务状态） */
+    onDoneCountdownComplete?: (taskId: number) => void | Promise<void>;
 }
 
 /**
@@ -1340,6 +1532,11 @@ 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 */

package/dist/index.js

@@ -1,19 +1,20 @@
-import { T, u, a } from "./chunks/ThemeProvider-wnSXrNQb.js";
-import { C, B, a as a2, T as T2 } from "./chunks/CommunityTaskList-BlH1Wdd5.js";
+import { B, c } from "./chunks/dynamic-import-helper-DwXlQC0S.js";
+import { T, c as c2, i, u, a, b } from "./chunks/ThemeProvider-CPI_roeh.js";
+import { C, B as B2, a as a2, T as T2 } from "./chunks/CommunityTaskList-C9Gv8KOF.js";
 import { RewardType } from "@taskon/core";
-import { T as T3, c, b, i, a as a3, u as u2 } from "./chunks/TaskOnProvider-BD6Vp2x8.js";
-import { a as a4, u as u3 } from "./chunks/useToast-B-wyO5zL.js";
-import { c as c2, i as i2, u as u4 } from "./chunks/useWidgetLocale-JDelxtt8.js";
-import { B as B2 } from "./chunks/dynamic-import-helper-DxEFwm31.js";
-import { L } from "./chunks/LeaderboardWidget-CmYfDeHV.js";
-import { Q, Q as Q2, u as u5, b as b2, a as a5 } from "./chunks/Quest-DKFZ-pPU.js";
-import { U } from "./chunks/UserCenterWidget-Cw6h_5hT.js";
-import { P } from "./chunks/PageBuilder-Bw0zSkFh.js";
+import { T as T3, c as c3, b as b2, i as i2, a as a3, u as u2 } from "./chunks/TaskOnProvider-93UxARFo.js";
+import { a as a4, u as u3 } from "./chunks/useToast-CaRkylKe.js";
+import { C as C2 } from "./chunks/EligibilityInfo-D-Fuy9GE.js";
+import { L } from "./chunks/LeaderboardWidget-BV2D2q1N.js";
+import { Q, Q as Q2, u as u4, b as b3, a as a5 } from "./chunks/Quest-B5NyVr3o.js";
+import { U } from "./chunks/UserCenterWidget-BRtigY_S.js";
+import { P } from "./chunks/PageBuilder-DQoU4Mwf.js";
 export {
-  B2 as Button,
+  B as Button,
   C as CardSelector,
-  B as CommunityTask,
+  B2 as CommunityTask,
   a2 as CommunityTaskList,
+  C2 as ConfirmNoticeDialog,
   L as LeaderboardWidget,
   P as PageBuilder,
   Q as Quest,
@@ -24,18 +25,19 @@ export {
   T as ThemeProvider,
   U as UserCenterWidget,
   c2 as clearLocaleCache,
-  c as createLocaleLoader,
-  b as createT,
-  i as interpolate,
-  i2 as isSupportedLocale,
+  c as cloudThemeToReactTheme,
+  c3 as createLocaleLoader,
+  b2 as createT,
+  i2 as interpolate,
+  i as isSupportedLocale,
   a3 as useCommonLocale,
   a4 as useEvmWallet,
-  u5 as useQuestDetail,
-  b2 as useQuestStatus,
+  u4 as useQuestDetail,
+  b3 as useQuestStatus,
   a5 as useQuestUserStatus,
   u as useTaskOnAuth,
   a as useTaskOnTheme,
   u2 as useTranslation,
   u3 as useWallet,
-  u4 as useWidgetLocale
+  b as useWidgetLocale
 };

package/dist/leaderboard.d.ts

@@ -240,6 +240,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 的配置和显示选项
@@ -525,13 +530,15 @@ export declare interface UsePaginationResult {
  * @param props - 组件属性
  * @returns 用户单元格元素
  */
-export declare function UserCell({ userId, userName, avatar, isCurrentUser, youLabel, onUserClick, className, }: UserCellProps): JSX.Element;
+export declare function UserCell({ userId, userName, displayName, avatar, isCurrentUser, youLabel, onUserClick, className, }: UserCellProps): JSX.Element;
 
 export declare interface UserCellProps {
     /** 用户 ID */
     userId: number;
     /** 用户名 */
     userName: string;
+    /** 展示用名称（可用于格式化地址） */
+    displayName?: string;
     /** 头像 URL */
     avatar: string;
     /** 是否为当前登录用户 */

package/dist/leaderboard.js

@@ -1,5 +1,5 @@
-import { c, e, d, b, L, R, f, U, a, u } from "./chunks/LeaderboardWidget-CmYfDeHV.js";
-import { u as u2 } from "./chunks/dynamic-import-helper-DxEFwm31.js";
+import { c, e, d, b, L, R, f, U, a, u } from "./chunks/LeaderboardWidget-BV2D2q1N.js";
+import { u as u2 } from "./chunks/dynamic-import-helper-DwXlQC0S.js";
 import { isAllTimeResponse, isCampaignResponse } from "@taskon/core";
 export {
   c as LeaderboardHeader,

package/dist/page-builder.js

@@ -1,4 +1,4 @@
-import { P } from "./chunks/PageBuilder-Bw0zSkFh.js";
+import { P } from "./chunks/PageBuilder-DQoU4Mwf.js";
 export {
   P as PageBuilder
 };

package/dist/quest.d.ts

@@ -211,6 +211,14 @@ export declare interface QuestWidgetProps {
      * 云端配置包含 campaignId、显示选项、自定义分享文案等
      */
     widgetId?: number;
+    /**
+     * 手动主题模式（传入后拥有最高优先级）
+     * 建议在云端配置为 dual + toggle 时使用，避免与固定模式配置语义冲突。
+     * - light: 强制浅色主题
+     * - dark: 强制深色主题
+     * - auto: 跟随系统主题
+     */
+    themeMode?: "light" | "dark" | "auto";
     /**
      * Campaign ID
      * - 如果传入 widgetId，campaignId 可从云端配置获取
@@ -245,8 +253,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>;
     /**

package/dist/quest.js

@@ -1,4 +1,4 @@
-import { Q, Q as Q2, u, b, a } from "./chunks/Quest-DKFZ-pPU.js";
+import { Q, Q as Q2, u, b, a } from "./chunks/Quest-B5NyVr3o.js";
 export {
   Q as Quest,
   Q2 as QuestWidget,