@taskon/widget-react 0.0.1 → 0.0.2

package/dist/core.d.ts

@@ -48,6 +48,8 @@ export declare interface CommonMessages {
  * const loadMessages = createLocaleLoader(enMessages, {
  *   ko: () => import('./locales/ko'),
  *   ja: () => import('./locales/ja'),
+ *   ru: () => import('./locales/ru'),
+ *   es: () => import('./locales/es'),
  * });
  * ```
  */
@@ -137,7 +139,11 @@ export declare type Locale = "en" | "ko" | "ja" | "ru" | "es";
 
 /**
  * Locale import map type
- * Maps supported locales to their dynamic import functions
+ * Maps supported non-English locales to their dynamic import functions.
+ *
+ * Notes:
+ * - Keys are optional so widgets can incrementally adopt locales.
+ * - Missing locale imports safely fall back to inlined English messages.
  */
 export declare type LocaleImportMap<T> = {
     [K in Exclude<SupportedLocale, "en">]?: () => Promise<{
@@ -178,13 +184,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;
@@ -193,6 +218,9 @@ export declare interface MapToken {
     fontSize?: number;
     fontSizeSm?: number;
     fontSizeLg?: number;
+    fontSizeXl?: number;
+    fontSizeXxl?: number;
+    fontSizeXxxl?: number;
     spacing?: number;
     spacingXs?: number;
     spacingSm?: number;
@@ -225,17 +253,32 @@ 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;
 }
 
 /**
- * Locales that have full translation support in all widgets
- * Other locales in the Locale type will fallback to English
+ * Locales recognized by the widget i18n runtime.
+ *
+ * Notes:
+ * - A widget can choose to provide only part of these locale files.
+ * - Missing locale modules still fall back to inlined English messages.
  */
-export declare type SupportedLocale = "en" | "ko" | "ja";
+export declare type SupportedLocale = "en" | "ko" | "ja" | "ru" | "es";
 
 /**
  * TaskOn Context value
@@ -250,9 +293,21 @@ export declare interface TaskOnContextValue {
      */
     client: TaskOnClient | null;
     /**
-     * Whether the provider is initializing
+     * Whether the provider is in full initialization flow.
+     *
+     * Notes:
+     * - Includes session restore and token validation.
+     * - When a stored token exists, this stays true until user info validation completes.
      */
     isInitializing: boolean;
+    /**
+     * Whether session prerequisites are ready for data requests.
+     * True means client is created and auth token has been loaded
+     * (or no token exists, anonymous mode).
+     *
+     * This can become true earlier than `isInitializing === false`.
+     */
+    isSessionReady: boolean;
     /**
      * Resolved locale
      */
@@ -297,7 +352,7 @@ export declare interface TaskOnContextValue {
      */
     chains: ChainInfo[];
     /**
-     * Community info (auto-loaded on init based on apiKey)
+     * Community info (auto-loaded on init based on clientId)
      * Used for displaying community logo and name in reward cards
      */
     communityInfo: CommunityInfo | null;
@@ -310,7 +365,7 @@ export declare interface TaskOnContextValue {
  * - TaskOn client management (based on @taskon/core)
  * - User authentication (login/logout)
  * - Locale configuration
- * - Wallet management (uses window.ethereum adapter)
+ * - Wallet management (host adapter or built-in wallet picker)
  * - Widget locale preloading (optional)
  * - Toast notifications (internal, user-transparent)
  */
@@ -321,10 +376,10 @@ export declare function TaskOnProvider({ config, children, preloadLocales, }: Ta
  */
 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
+     * Client ID for authentication (X-API-Key header)
+     * Note: clientId already contains community info, no need to configure communityId/communityKey separately
      */
-    apiKey: string;
+    clientId: string;
     /**
      * API base URL (optional)
      * @default https://white-label-api.taskon.xyz
@@ -338,8 +393,8 @@ export declare interface TaskOnProviderConfig {
     /**
      * Wallet configuration for blockchain interactions
      *
-     * When not provided, TaskOn will use built-in window.ethereum adapter
-     * for EVM wallet connections (MetaMask, etc.)
+     * When not provided, TaskOn will use SDK built-in wallet picker adapter
+     * for EVM wallet connections.
      */
     walletConfig?: WalletConfig;
     /**
@@ -352,7 +407,7 @@ export declare interface TaskOnProviderConfig {
      * ```tsx
      * <TaskOnProvider
      *   config={{
-     *     apiKey: 'your-api-key',
+     *     clientId: 'your-client-id',
      *     onRequestLogin: () => {
      *       setShowLoginModal(true);
      *     },
@@ -375,10 +430,13 @@ export declare interface TaskOnProviderConfig {
     /**
      * WalletConnect Project ID
      *
-     * Required for WalletConnect functionality.
-     * Get your project ID at https://cloud.walletconnect.com
+     * Only needed when you design Web3 wallet login or wallet-based reward flows.
+     * (e.g. wallet binding, on-chain verification, NFT/token claiming)
+     *
+     * Optional. If not provided, SDK built-in default project ID will be used.
+     * For production, it is strongly recommended to set your own project ID.
      *
-     * If not provided, WalletConnect option will be disabled in the wallet dialog.
+     * Get your project ID at https://cloud.walletconnect.com
      */
     walletConnectProjectId?: string;
 }
@@ -416,6 +474,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 */
@@ -506,7 +570,15 @@ export { UserInfo }
  *
  * @example
  * ```tsx
- * const { login, logout, userId, isLoggedIn, requestLogin } = useTaskOnAuth();
+ * const {
+ *   login,
+ *   logout,
+ *   userId,
+ *   isLoggedIn,
+ *   isInitializing,
+ *   isSessionReady,
+ *   requestLogin,
+ * } = useTaskOnAuth();
  *
  * // EVM wallet login
  * await login({ method: 'evm_wallet', value: '0x...', sign, timestamp });
@@ -525,6 +597,7 @@ export declare function useTaskOnAuth(): {
     userId: number | null;
     isLoggedIn: boolean;
     isInitializing: boolean;
+    isSessionReady: boolean;
     login: (params: LoginParams) => Promise<void>;
     logout: () => void;
     requestLogin: () => void;
@@ -764,15 +837,9 @@ export declare interface WalletAdapter {
 export declare interface WalletConfig {
     /**
      * Custom EVM wallet adapter
-     * If not provided, uses built-in window.ethereum adapter
+     * If not provided, uses SDK built-in wallet picker adapter
      */
     evmAdapter?: WalletAdapter;
-    /**
-     * Disable auto-detection of wallet providers
-     * When true, only uses adapter explicitly provided above
-     * @default false
-     */
-    disableAutoDetect?: boolean;
 }
 
 /**
@@ -798,6 +865,6 @@ export declare interface WalletState {
 /**
  * Supported widget names for preloading
  */
-export declare type WidgetName = "CommunityTask";
+export declare type WidgetName = "CommunityTask" | "Quest" | "TaskWidget" | "LeaderboardWidget" | "UserCenterWidget";
 
 export { }

package/dist/core.js

@@ -1,22 +1,21 @@
-import { T, u, a } from "./chunks/ThemeProvider-Cs8IUVQj.js";
+import { T, d, e, f, i, g, u, a, c, b } from "./chunks/ThemeProvider-CulHkqqY.js";
 import { RewardType } from "@taskon/core";
-import { T as T2, c, b, i, a as a2, u as u2 } from "./chunks/TaskOnProvider-QMwxGL44.js";
-import { a as a3, u as u3 } from "./chunks/useToast-BGJhd3BX.js";
-import { c as c2, i as i2, u as u4 } from "./chunks/useWidgetLocale-BVcopbZS.js";
+import { T as T2, u as u2 } from "./chunks/TaskOnProvider-CxtFIs3n.js";
+import { a as a2, u as u3 } from "./chunks/useToast-BGJhd3BX.js";
 export {
   RewardType,
   T2 as TaskOnProvider,
   T as ThemeProvider,
-  c2 as clearLocaleCache,
-  c as createLocaleLoader,
-  b as createT,
+  d as clearLocaleCache,
+  e as createLocaleLoader,
+  f as createT,
   i as interpolate,
-  i2 as isSupportedLocale,
-  a2 as useCommonLocale,
-  a3 as useEvmWallet,
+  g as isSupportedLocale,
+  u2 as useCommonLocale,
+  a2 as useEvmWallet,
   u as useTaskOnAuth,
   a as useTaskOnTheme,
-  u2 as useTranslation,
+  c as useTranslation,
   u3 as useWallet,
-  u4 as useWidgetLocale
+  b as useWidgetLocale
 };