@voyage_ai/v402-web-ts 0.2.0 → 0.3.0

package/dist/react/index.d.ts

@@ -1,11 +1,6 @@
 import { PaymentRequirements } from 'x402/types';
 import React from 'react';
 
-/**
- * Common types for x402 SDK
- * Framework-agnostic types that work across different wallet implementations
- */
-
 /**
  * Network type enum - for wallet detection
  */
@@ -16,6 +11,23 @@ declare enum NetworkType {
     UNKNOWN = "unknown"
 }
 
+/**
+ * Wallet Discovery
+ *
+ * Discovers installed wallets using:
+ * - EIP-6963 for EVM wallets
+ * - Direct detection for Solana wallets
+ */
+
+interface WalletInfo {
+    id: string;
+    name: string;
+    icon: string;
+    networkType: NetworkType;
+    provider: any;
+    installed: boolean;
+}
+
 /**
  * useWallet Hook (External Store)
  *
@@ -28,10 +40,11 @@ interface UseWalletReturn {
     networkType: NetworkType | null;
     isConnecting: boolean;
     error: string | null;
-    connect: (networkType: NetworkType) => Promise<void>;
+    connect: (networkType: NetworkType, forceSelect?: boolean) => Promise<void>;
+    connectWithWallet: (wallet: WalletInfo) => Promise<void>;
     switchNetwork: (networkType: NetworkType) => Promise<void>;
     ensureNetwork: (networkType: NetworkType) => Promise<void>;
-    disconnect: () => void;
+    disconnect: () => Promise<void>;
     clearError: () => void;
 }
 /**
@@ -220,6 +233,8 @@ interface WalletConnectProps {
     className?: string;
     onConnect?: (address: string, networkType: NetworkType) => void;
     onDisconnect?: () => void;
+    /** 是否显示切换钱包按钮，默认为 true */
+    showSwitchWallet?: boolean;
 }
 /**
  * Pre-built wallet connection component
@@ -238,7 +253,22 @@ interface WalletConnectProps {
  * }
  * ```
  */
-declare function WalletConnect({ supportedNetworks, className, onConnect, onDisconnect, }: WalletConnectProps): React.JSX.Element;
+declare function WalletConnect({ supportedNetworks, className, onConnect, onDisconnect, showSwitchWallet, }: WalletConnectProps): React.JSX.Element;
+
+/**
+ * WalletSelectModal Component
+ *
+ * Modal for selecting a wallet to connect
+ * Uses Portal to render outside parent container (avoids clipping)
+ */
+
+interface WalletSelectModalProps {
+    isOpen: boolean;
+    networkType: NetworkType;
+    onSelect: (wallet: WalletInfo) => void;
+    onClose: () => void;
+}
+declare function WalletSelectModal({ isOpen, networkType, onSelect, onClose, }: WalletSelectModalProps): React.JSX.Element | null;
 
 interface HeaderInfo {
     title?: string;
@@ -255,4 +285,4 @@ interface V402CheckoutProps {
 }
 declare function V402Checkout({ checkoutId, headerInfo, isModal, onPaymentComplete, additionalParams, expectedNetwork, }: V402CheckoutProps): React.JSX.Element;
 
-export { type UsePageNetworkOptions, type UsePaymentInfoReturn, type UsePaymentReturn, type UseWalletReturn, V402Checkout, type V402CheckoutProps, WalletConnect, type WalletConnectProps, usePageNetwork, usePayment, usePaymentInfo, useWallet };
+export { type UsePageNetworkOptions, type UsePaymentInfoReturn, type UsePaymentReturn, type UseWalletReturn, V402Checkout, type V402CheckoutProps, WalletConnect, type WalletConnectProps, WalletSelectModal, type WalletSelectModalProps, usePageNetwork, usePayment, usePaymentInfo, useWallet };