@unifold/ui-react 0.1.68 → 0.1.69

package/dist/index.d.mts

@@ -182,6 +182,11 @@ interface DepositModalProps {
     defaultSourceTokenAddress?: string;
     /** Source token symbol (e.g. `"USDC"`). Must be paired with `defaultSourceChainType` + `defaultSourceChainId`. */
     defaultSourceSymbol?: string;
+    /**
+     * Pre-fill USD amount inputs in deposit flows (Connect Wallet, Deposit with
+     * Card, Bank Transfer, and Cash App) as an initial typed value.
+     */
+    prefilledAmountUsd?: string;
     /** Hide the "Deposit Tracker" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false (shown). */
     hideDepositTracker?: boolean;
     /** Show balance in deposit modal header. Defaults to false */
@@ -284,7 +289,7 @@ interface DepositModalProps {
      */
     displayMode?: 'stacked' | 'tabs';
 }
-declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, contractCalls, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle, applePaySubTitle, enableBankTransfer, enableStripeLink, userEmail, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, displayMode, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
+declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, contractCalls, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle, applePaySubTitle, enableBankTransfer, enableStripeLink, userEmail, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, displayMode, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
 
 interface DepositHeaderProps {
     title: string;
@@ -349,6 +354,8 @@ interface TransferCryptoSingleInputProps {
         minimumDepositAmountUsd: number;
         isStablecoin: boolean;
     }) => void;
+    /** Optional USD prefilled used to render an estimated "You send" target. */
+    prefilledAmountUsd?: string;
     /** Checkout mode: estimated source amount to send (from /public/quotes). Shown above the QR code. */
     checkoutQuote?: {
         sourceAmount: string;
@@ -364,7 +371,7 @@ interface TransferCryptoSingleInputProps {
     /** Product context sent to the API — "deposit" (default) or "payment". */
     productType?: ProductType;
 }
-declare function TransferCryptoSingleInput({ userId, publishableKey, clientSecret, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, onSourceTokenChange, checkoutQuote, isCheckoutQuoteLoading, persistCheckingIndicator, productType, }: TransferCryptoSingleInputProps): react_jsx_runtime.JSX.Element;
+declare function TransferCryptoSingleInput({ userId, publishableKey, clientSecret, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, onSourceTokenChange, prefilledAmountUsd, checkoutQuote, isCheckoutQuoteLoading, persistCheckingIndicator, productType, }: TransferCryptoSingleInputProps): react_jsx_runtime.JSX.Element;
 
 interface TransferCryptoDoubleInputProps {
     userId: string;
@@ -377,6 +384,8 @@ interface TransferCryptoDoubleInputProps {
     defaultSourceChainId?: string;
     defaultSourceTokenAddress?: string;
     defaultSourceSymbol?: string;
+    /** Optional USD prefilled used to render an estimated "You send" target. */
+    prefilledAmountUsd?: string;
     /** Controls when polling starts and whether a waiting UI is shown.
      *  - "auto_ui": After 10s, starts polling and shows "Processing..." card (default)
      *  - "auto_silent": After 10s, starts polling silently (no waiting UI)
@@ -397,7 +406,7 @@ interface TransferCryptoDoubleInputProps {
     }) => void;
     wallets?: Wallet[];
 }
-declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, }: TransferCryptoDoubleInputProps): react_jsx_runtime.JSX.Element;
+declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, }: TransferCryptoDoubleInputProps): react_jsx_runtime.JSX.Element;
 
 interface BuyWithCardProps {
     userId: string;
@@ -430,9 +439,11 @@ interface BuyWithCardProps {
     hideDepositFlowInfo?: boolean;
     /** When true, hides the temporary wallet address disclaimer below the flow. @default false */
     hideDisplayDescription?: boolean;
+    /** Optional USD prefilled for the amount input (treated like manual user input). */
+    prefilledAmountUsd?: string;
 }
 declare function BuyWithCard({ userId, publishableKey, view: externalView, onViewChange, maxAmountUsd, accentColor, // Keep prop for backward compatibility but don't use default
-destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, onDepositSuccess, onDepositError, onEvent, themeClass, wallets: externalWallets, assetCdnUrl, hideDepositFlowInfo, hideDisplayDescription, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
+destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, onDepositSuccess, onDepositError, onEvent, themeClass, wallets: externalWallets, assetCdnUrl, hideDepositFlowInfo, hideDisplayDescription, prefilledAmountUsd, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
 
 type View = 'loading_config' | 'disabled' | 'email_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'checking_deposit' | 'success' | 'guest_limit_reached' | 'limit_upgrade_intro' | 'limit_upgrade_form' | 'limit_upgrade_submitting' | 'limit_upgrade_failed';
 interface BuyWithApplePayProps {
@@ -645,6 +656,8 @@ interface BankTransferProps {
         error?: unknown;
         code?: string;
     }) => void;
+    /** Optional USD prefilled for the amount input (treated like manual user input). */
+    prefilledAmountUsd?: string;
 }
 /**
  * Bank-transfer deposit flow. Three steps:
@@ -655,7 +668,7 @@ interface BankTransferProps {
  * The widget itself handles KYC + IBAN entry + payment; we just collect the
  * fiat amount up-front so users aren't surprised by the default in the widget.
  */
-declare function BankTransfer({ userId, publishableKey, view: externalView, onViewChange, destinationChainType, destinationChainId, destinationTokenAddress, destinationTokenSymbol, wallets, defaultToken: externalDefaultToken, assetCdnUrl, onDepositSuccess, onEvent, onDepositError, }: BankTransferProps): react_jsx_runtime.JSX.Element;
+declare function BankTransfer({ userId, publishableKey, view: externalView, onViewChange, destinationChainType, destinationChainId, destinationTokenAddress, destinationTokenSymbol, wallets, defaultToken: externalDefaultToken, assetCdnUrl, onDepositSuccess, onEvent, onDepositError, prefilledAmountUsd, }: BankTransferProps): react_jsx_runtime.JSX.Element;
 
 interface DepositWallet {
     id: string;
@@ -696,8 +709,10 @@ interface CoinbaseConnectProps {
     defaultSourceChainId?: string;
     defaultSourceTokenAddress?: string;
     defaultSourceSymbol?: string;
+    /** Optional USD prefilled for the amount input (treated like manual user input). */
+    prefilledAmountUsd?: string;
 }
-declare function CoinbaseConnect({ publishableKey, userId, wallets, recipientAddress, destinationTokenAddress, destinationChainId, destinationChainType, onTransferSuccess, onDepositSuccess, onDepositError, onTransferError, onClose, onBack: parentOnBack, onDisconnect, skipToHoldings, canGoBack, onExecutionsChange, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, }: CoinbaseConnectProps): react_jsx_runtime.JSX.Element | null;
+declare function CoinbaseConnect({ publishableKey, userId, wallets, recipientAddress, destinationTokenAddress, destinationChainId, destinationChainType, onTransferSuccess, onDepositSuccess, onDepositError, onTransferError, onClose, onBack: parentOnBack, onDisconnect, skipToHoldings, canGoBack, onExecutionsChange, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, }: CoinbaseConnectProps): react_jsx_runtime.JSX.Element | null;
 declare namespace CoinbaseConnect {
     var displayName: string;
 }
@@ -710,6 +725,8 @@ interface PayWithStripeLinkProps {
     destinationChainType?: ChainType;
     destinationChainId?: string;
     destinationTokenAddress?: string;
+    countryCode?: string;
+    subdivisionCode?: string;
     /**
      * Pre-created deposit intent wallets (one per chain type). When provided, the
      * Stripe onramp delivers to the deposit intent address matching the Stripe
@@ -754,7 +771,7 @@ interface PayWithStripeLinkProps {
  * The Stripe publishable key is auto-fetched from the backend via GET /config,
  * so consumers only need their Unifold publishable key.
  */
-declare function PayWithStripeLink({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, wallets: externalWallets, email: emailProp, iconUrl, step: controlledStep, onStepChange, backHandlerRef, onDepositSuccess, onDepositError, }: PayWithStripeLinkProps): react_jsx_runtime.JSX.Element | null;
+declare function PayWithStripeLink({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, countryCode, subdivisionCode, wallets: externalWallets, email: emailProp, iconUrl, step: controlledStep, onStepChange, backHandlerRef, onDepositSuccess, onDepositError, }: PayWithStripeLinkProps): react_jsx_runtime.JSX.Element | null;
 
 interface DepositExecutionItemProps {
     execution: DirectExecutionResponse;

package/dist/index.d.ts

@@ -182,6 +182,11 @@ interface DepositModalProps {
     defaultSourceTokenAddress?: string;
     /** Source token symbol (e.g. `"USDC"`). Must be paired with `defaultSourceChainType` + `defaultSourceChainId`. */
     defaultSourceSymbol?: string;
+    /**
+     * Pre-fill USD amount inputs in deposit flows (Connect Wallet, Deposit with
+     * Card, Bank Transfer, and Cash App) as an initial typed value.
+     */
+    prefilledAmountUsd?: string;
     /** Hide the "Deposit Tracker" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false (shown). */
     hideDepositTracker?: boolean;
     /** Show balance in deposit modal header. Defaults to false */
@@ -284,7 +289,7 @@ interface DepositModalProps {
      */
     displayMode?: 'stacked' | 'tabs';
 }
-declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, contractCalls, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle, applePaySubTitle, enableBankTransfer, enableStripeLink, userEmail, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, displayMode, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
+declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, contractCalls, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle, applePaySubTitle, enableBankTransfer, enableStripeLink, userEmail, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, displayMode, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
 
 interface DepositHeaderProps {
     title: string;
@@ -349,6 +354,8 @@ interface TransferCryptoSingleInputProps {
         minimumDepositAmountUsd: number;
         isStablecoin: boolean;
     }) => void;
+    /** Optional USD prefilled used to render an estimated "You send" target. */
+    prefilledAmountUsd?: string;
     /** Checkout mode: estimated source amount to send (from /public/quotes). Shown above the QR code. */
     checkoutQuote?: {
         sourceAmount: string;
@@ -364,7 +371,7 @@ interface TransferCryptoSingleInputProps {
     /** Product context sent to the API — "deposit" (default) or "payment". */
     productType?: ProductType;
 }
-declare function TransferCryptoSingleInput({ userId, publishableKey, clientSecret, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, onSourceTokenChange, checkoutQuote, isCheckoutQuoteLoading, persistCheckingIndicator, productType, }: TransferCryptoSingleInputProps): react_jsx_runtime.JSX.Element;
+declare function TransferCryptoSingleInput({ userId, publishableKey, clientSecret, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, onSourceTokenChange, prefilledAmountUsd, checkoutQuote, isCheckoutQuoteLoading, persistCheckingIndicator, productType, }: TransferCryptoSingleInputProps): react_jsx_runtime.JSX.Element;
 
 interface TransferCryptoDoubleInputProps {
     userId: string;
@@ -377,6 +384,8 @@ interface TransferCryptoDoubleInputProps {
     defaultSourceChainId?: string;
     defaultSourceTokenAddress?: string;
     defaultSourceSymbol?: string;
+    /** Optional USD prefilled used to render an estimated "You send" target. */
+    prefilledAmountUsd?: string;
     /** Controls when polling starts and whether a waiting UI is shown.
      *  - "auto_ui": After 10s, starts polling and shows "Processing..." card (default)
      *  - "auto_silent": After 10s, starts polling silently (no waiting UI)
@@ -397,7 +406,7 @@ interface TransferCryptoDoubleInputProps {
     }) => void;
     wallets?: Wallet[];
 }
-declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, }: TransferCryptoDoubleInputProps): react_jsx_runtime.JSX.Element;
+declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, depositConfirmationMode, onExecutionsChange, onDepositSuccess, onDepositError, wallets: externalWallets, }: TransferCryptoDoubleInputProps): react_jsx_runtime.JSX.Element;
 
 interface BuyWithCardProps {
     userId: string;
@@ -430,9 +439,11 @@ interface BuyWithCardProps {
     hideDepositFlowInfo?: boolean;
     /** When true, hides the temporary wallet address disclaimer below the flow. @default false */
     hideDisplayDescription?: boolean;
+    /** Optional USD prefilled for the amount input (treated like manual user input). */
+    prefilledAmountUsd?: string;
 }
 declare function BuyWithCard({ userId, publishableKey, view: externalView, onViewChange, maxAmountUsd, accentColor, // Keep prop for backward compatibility but don't use default
-destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, onDepositSuccess, onDepositError, onEvent, themeClass, wallets: externalWallets, assetCdnUrl, hideDepositFlowInfo, hideDisplayDescription, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
+destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, onDepositSuccess, onDepositError, onEvent, themeClass, wallets: externalWallets, assetCdnUrl, hideDepositFlowInfo, hideDisplayDescription, prefilledAmountUsd, }: BuyWithCardProps): react_jsx_runtime.JSX.Element;
 
 type View = 'loading_config' | 'disabled' | 'email_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'checking_deposit' | 'success' | 'guest_limit_reached' | 'limit_upgrade_intro' | 'limit_upgrade_form' | 'limit_upgrade_submitting' | 'limit_upgrade_failed';
 interface BuyWithApplePayProps {
@@ -645,6 +656,8 @@ interface BankTransferProps {
         error?: unknown;
         code?: string;
     }) => void;
+    /** Optional USD prefilled for the amount input (treated like manual user input). */
+    prefilledAmountUsd?: string;
 }
 /**
  * Bank-transfer deposit flow. Three steps:
@@ -655,7 +668,7 @@ interface BankTransferProps {
  * The widget itself handles KYC + IBAN entry + payment; we just collect the
  * fiat amount up-front so users aren't surprised by the default in the widget.
  */
-declare function BankTransfer({ userId, publishableKey, view: externalView, onViewChange, destinationChainType, destinationChainId, destinationTokenAddress, destinationTokenSymbol, wallets, defaultToken: externalDefaultToken, assetCdnUrl, onDepositSuccess, onEvent, onDepositError, }: BankTransferProps): react_jsx_runtime.JSX.Element;
+declare function BankTransfer({ userId, publishableKey, view: externalView, onViewChange, destinationChainType, destinationChainId, destinationTokenAddress, destinationTokenSymbol, wallets, defaultToken: externalDefaultToken, assetCdnUrl, onDepositSuccess, onEvent, onDepositError, prefilledAmountUsd, }: BankTransferProps): react_jsx_runtime.JSX.Element;
 
 interface DepositWallet {
     id: string;
@@ -696,8 +709,10 @@ interface CoinbaseConnectProps {
     defaultSourceChainId?: string;
     defaultSourceTokenAddress?: string;
     defaultSourceSymbol?: string;
+    /** Optional USD prefilled for the amount input (treated like manual user input). */
+    prefilledAmountUsd?: string;
 }
-declare function CoinbaseConnect({ publishableKey, userId, wallets, recipientAddress, destinationTokenAddress, destinationChainId, destinationChainType, onTransferSuccess, onDepositSuccess, onDepositError, onTransferError, onClose, onBack: parentOnBack, onDisconnect, skipToHoldings, canGoBack, onExecutionsChange, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, }: CoinbaseConnectProps): react_jsx_runtime.JSX.Element | null;
+declare function CoinbaseConnect({ publishableKey, userId, wallets, recipientAddress, destinationTokenAddress, destinationChainId, destinationChainType, onTransferSuccess, onDepositSuccess, onDepositError, onTransferError, onClose, onBack: parentOnBack, onDisconnect, skipToHoldings, canGoBack, onExecutionsChange, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, prefilledAmountUsd, }: CoinbaseConnectProps): react_jsx_runtime.JSX.Element | null;
 declare namespace CoinbaseConnect {
     var displayName: string;
 }
@@ -710,6 +725,8 @@ interface PayWithStripeLinkProps {
     destinationChainType?: ChainType;
     destinationChainId?: string;
     destinationTokenAddress?: string;
+    countryCode?: string;
+    subdivisionCode?: string;
     /**
      * Pre-created deposit intent wallets (one per chain type). When provided, the
      * Stripe onramp delivers to the deposit intent address matching the Stripe
@@ -754,7 +771,7 @@ interface PayWithStripeLinkProps {
  * The Stripe publishable key is auto-fetched from the backend via GET /config,
  * so consumers only need their Unifold publishable key.
  */
-declare function PayWithStripeLink({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, wallets: externalWallets, email: emailProp, iconUrl, step: controlledStep, onStepChange, backHandlerRef, onDepositSuccess, onDepositError, }: PayWithStripeLinkProps): react_jsx_runtime.JSX.Element | null;
+declare function PayWithStripeLink({ userId, publishableKey, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, countryCode, subdivisionCode, wallets: externalWallets, email: emailProp, iconUrl, step: controlledStep, onStepChange, backHandlerRef, onDepositSuccess, onDepositError, }: PayWithStripeLinkProps): react_jsx_runtime.JSX.Element | null;
 
 interface DepositExecutionItemProps {
     execution: DirectExecutionResponse;