@unifold/ui-react 0.1.67 → 0.1.68-beta.1

package/dist/index.d.mts

@@ -1,16 +1,17 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { DirectExecutionSucceededEvent, DirectExecutionResponse, ChainType, EvmContractCall, DepositMethod, DepositEvent, Wallet, ProductType, FiatCurrency, ExecutionStatus, FeaturedToken, PaymentNetwork, ConfirmIntegrationTransferResult, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, DestinationToken, DestinationTokenChain, PaymentIntent, DepositQuote, SupportedDestinationTokensResponse, SupportedDepositTokensResponse, VerifyAddressResponse } from '@unifold/core';
+import { DirectExecutionSucceededEvent, DirectExecutionResponse, ChainType, EvmContractCall, DepositMethod, DepositEvent, Wallet, ProductType, FiatCurrency, ExecutionStatus, FeaturedToken, PaymentNetwork, DefaultTokenResponse, ConfirmIntegrationTransferResult, CheckoutMethod, CheckoutPaymentIntent, CheckoutEvent, WithdrawDirectExecutionSucceededEvent, WithdrawEvent, DestinationToken, DestinationTokenChain, PaymentIntent, DepositQuote, SupportedDestinationTokensResponse, SupportedDepositTokensResponse, VerifyAddressResponse } from '@unifold/core';
 export { ChainType, DepositMethod } from '@unifold/core';
+import * as React$1 from 'react';
+import { MutableRefObject } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import * as class_variance_authority_types from 'class-variance-authority/types';
-import * as React$1 from 'react';
 import { VariantProps } from 'class-variance-authority';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as SelectPrimitive from '@radix-ui/react-select';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import { ClassValue } from 'clsx';
 
-type DepositConfirmationMode = "auto_ui" | "auto_silent" | "manual";
+type DepositConfirmationMode = 'auto_ui' | 'auto_silent' | 'manual';
 interface UseDepositPollingOptions {
     userId: string | undefined;
     publishableKey: string;
@@ -108,7 +109,7 @@ interface EthereumProvider {
 }
 
 /** Quick amount chips on the browser wallet "Enter amount" step */
-type BrowserWalletAmountQuickSelect = "usd" | "percentage";
+type BrowserWalletAmountQuickSelect = 'usd' | 'percentage';
 interface SolanaWalletProvider {
     isPhantom?: boolean;
     isConnected?: boolean;
@@ -141,7 +142,7 @@ interface EvmWalletProvider {
     removeListener?(event: string, callback: (...args: unknown[]) => void): void;
 }
 
-type DepositModalInitialScreen = "main" | "transfer" | "card" | "cashapp" | "tracker" | "pay_with_exchange" | "exchange_connect" | "wallet_connect";
+type DepositModalInitialScreen = 'main' | 'transfer' | 'card' | 'cashapp' | 'apple_pay' | 'tracker' | 'pay_with_exchange' | 'exchange_connect' | 'wallet_connect' | 'bank_transfer' | 'stripe_link';
 interface DepositModalProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -186,7 +187,7 @@ interface DepositModalProps {
     /** Show balance in deposit modal header. Defaults to false */
     showBalanceHeader?: boolean;
     /** Input variant for Transfer Crypto view: "single_input" or "double_input" (default) */
-    transferInputVariant?: "single_input" | "double_input";
+    transferInputVariant?: 'single_input' | 'double_input';
     /** Controls when deposit polling starts and what UI is shown.
      *  - "auto_ui": After 10s, starts polling and shows "Processing..." card (default)
      *  - "auto_silent": After 10s, starts polling silently (no waiting UI)
@@ -210,10 +211,41 @@ interface DepositModalProps {
     enableConnectExchange?: boolean;
     /** Enable "Pay with Cash App" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
     enableCashApp?: boolean;
+    enableStripeLink?: boolean;
+    email?: string;
+    /**
+     * Enable "Pay with Apple Pay" (headless Coinbase) option. Overrides dashboard
+     * default. Resolves as flag ?? dashboard `apple_pay.enabled` ?? true. The
+     * server still gates per-region (US-only, NY excluded at launch) at the
+     * order-creation step.
+     */
+    enableApplePay?: boolean;
+    /**
+     * Title shown for the Apple Pay row in the main menu. @default `"Pay with Apple Pay"`
+     */
+    applePayTitle?: string;
+    /**
+     * Subtitle shown for the Apple Pay row in the main menu. @default `"Instant"`
+     */
+    applePaySubTitle?: string;
+    /**
+     * Enable the "Bank Transfer" section (SEPA, etc.). Overrides dashboard default.
+     * Resolves as flag ?? dashboard `bank_transfer.enabled` ?? true.
+     *
+     * Even when enabled, the rails listed inside are filtered by country —
+     * users outside the SEPA zone see a disabled "coming soon" card.
+     */
+    enableBankTransfer?: boolean;
     /** Deposit with Card — onramp step: hide the You use / You buy / You receive card. @default false */
     hideDepositFlowInfo?: boolean;
     /** Deposit with Card — onramp step: hide the temporary wallet address disclaimer. @default false */
     hideDisplayDescription?: boolean;
+    /**
+     * Pre-trusted email from the host platform's signed-in user. Used by the
+     * Apple Pay (headless Coinbase) flow to skip the email-OTP step and the
+     * localStorage email lookup. Phone OTP is always still required.
+     */
+    externalUserEmail?: string;
     onDepositSuccess?: (data: {
         message: string;
         transaction?: unknown;
@@ -230,7 +262,7 @@ interface DepositModalProps {
         /** Which funding method produced this error event. */
         method?: DepositMethod;
     }) => void;
-    theme?: "light" | "dark" | "auto";
+    theme?: 'light' | 'dark' | 'auto';
     /** Hide the dialog overlay and close button for inline/embedded mode */
     hideOverlay?: boolean;
     /** First screen when the modal opens. Default `main` (deposit menu). */
@@ -241,9 +273,9 @@ interface DepositModalProps {
      * - `"tabs"`: options are grouped under "Use Crypto" / "Use Cash" tabs to keep
      *   the menu compact and mobile-friendly.
      */
-    displayMode?: "stacked" | "tabs";
+    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, 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, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableTransferCrypto, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, enableFiatOnramp, enableConnectExchange, enableCashApp, enableApplePay, applePayTitle, applePaySubTitle, enableBankTransfer, enableStripeLink, email: emailProp, hideDepositFlowInfo, hideDisplayDescription, externalUserEmail, onDepositSuccess, onDepositError, onEvent, theme, hideOverlay, initialScreen, displayMode, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
 
 interface DepositHeaderProps {
     title: string;
@@ -361,8 +393,8 @@ declare function TransferCryptoDoubleInput({ userId, publishableKey, recipientAd
 interface BuyWithCardProps {
     userId: string;
     publishableKey: string;
-    view?: "amount" | "quotes" | "onramp";
-    onViewChange?: (view: "amount" | "quotes" | "onramp", quotesCount?: number) => void;
+    view?: 'amount' | 'quotes' | 'onramp';
+    onViewChange?: (view: 'amount' | 'quotes' | 'onramp', quotesCount?: number) => void;
     maxAmountUsd?: number;
     accentColor?: string;
     destinationTokenSymbol?: string;
@@ -393,6 +425,85 @@ interface BuyWithCardProps {
 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;
 
+type View = 'loading_config' | 'disabled' | 'email_input' | 'phone_input' | 'submitting_session' | 'email_otp' | 'phone_otp' | 'amount' | 'checking_deposit' | 'success' | 'guest_limit_reached';
+interface BuyWithApplePayProps {
+    userId: string;
+    publishableKey: string;
+    recipientAddress?: string;
+    destinationChainType?: ChainType;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    destinationTokenSymbol?: string;
+    /** Host-platform-trusted email. Skips email screen + email OTP. */
+    externalUserEmail?: string;
+    /**
+     * SDK-level override for the dashboard `apple_pay.enabled` flag.
+     * Resolution order: this prop → `projectConfig.apple_pay.enabled` →
+     * default `true`. Set to `false` to render the disabled state, `true`
+     * to force enable regardless of the dashboard toggle.
+     */
+    enableApplePay?: boolean;
+    /** Force the USD amount and skip the amount-entry step. */
+    amountUsd?: string;
+    minAmountUsd?: number;
+    maxAmountUsd?: number;
+    suggestedAmountsUsd?: number[];
+    /**
+     * Pre-fetched Unifold deposit wallets. When omitted, the component fetches
+     * them via `/deposit_addresses`. Coinbase sends the purchased crypto to
+     * the matching-chain wallet's address, then our backend forwards to
+     * `recipientAddress`.
+     */
+    wallets?: Wallet[];
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+        executionId?: string;
+        execution?: DirectExecutionSucceededEvent;
+    }) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+        code?: string;
+    }) => void;
+    onEvent?: (event: DepositEvent) => void;
+    /** Stream of the internal view for parent-header sync. */
+    onViewChange?: (view: View) => void;
+    /**
+     * Label for the exit button on terminal screens (currently the
+     * guest-limit error). `"Return"` when Apple Pay was reached via the
+     * deposit-method menu (`initialScreen` unset / `"main"`); `"Close"`
+     * when the modal was opened directly to Apple Pay.
+     */
+    exitLabel?: 'Return' | 'Close';
+    /** Invoked when the user taps the exit button on a terminal screen. */
+    onExit?: () => void;
+    themeClass?: string;
+}
+/** Imperative handle: `requestBack` returns true when the child handled the back. */
+interface BuyWithApplePayHandle {
+    requestBack: () => boolean;
+}
+declare const BuyWithApplePay: React$1.ForwardRefExoticComponent<BuyWithApplePayProps & React$1.RefAttributes<BuyWithApplePayHandle>>;
+
+interface StoredApplePaySession {
+    email: string;
+    /** US phone in E.164 (e.g. +12345678901). */
+    phone: string;
+    termsAcceptedAt: string;
+    phoneVerifiedAt?: string;
+    emailVerifiedAt?: string;
+    /** Onramp verification JWT — skips OTP within its window. */
+    onrampToken?: string;
+    /** Epoch ms; treated as expired 60s before this to avoid order-race. */
+    onrampTokenExpiresAtMs?: number;
+}
+declare function getStoredApplePaySession(userId: string): StoredApplePaySession | null;
+declare function setStoredApplePaySession(userId: string, contact: StoredApplePaySession): void;
+declare function clearStoredApplePaySession(userId: string): void;
+declare function isPhoneVerificationFresh(contact: StoredApplePaySession | null): boolean;
+declare function isOnrampTokenFresh(contact: StoredApplePaySession | null): boolean;
+
 interface CurrencyModalProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -492,6 +603,61 @@ interface DepositTrackerButtonProps {
 }
 declare function DepositTrackerButton({ onClick, title, subtitle, badge, }: DepositTrackerButtonProps): react_jsx_runtime.JSX.Element;
 
+interface BankTransferButtonProps {
+    onClick: () => void;
+    title: string;
+    subtitle: string;
+    /** When true, renders the row as a disabled "coming soon" card (no click). */
+    comingSoon?: boolean;
+}
+declare function BankTransferButton({ onClick, title, subtitle, comingSoon, }: BankTransferButtonProps): react_jsx_runtime.JSX.Element;
+
+interface StripeLinkButtonProps {
+    onClick: () => void;
+    title?: string;
+    subtitle?: string;
+    iconUrl?: string;
+}
+declare function StripeLinkButton({ onClick, title, subtitle, iconUrl, }: StripeLinkButtonProps): react_jsx_runtime.JSX.Element;
+
+type BankTransferView = 'providers' | 'amount' | 'pending';
+interface BankTransferProps {
+    userId: string;
+    publishableKey: string;
+    view?: BankTransferView;
+    onViewChange?: (view: BankTransferView) => void;
+    recipientAddress?: string;
+    destinationChainType?: ChainType;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    destinationTokenSymbol?: string;
+    wallets?: Wallet[];
+    /** Pre-resolved default token (saves a network round-trip when provided). */
+    defaultToken?: DefaultTokenResponse | null;
+    assetCdnUrl?: string;
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+        executionId?: string;
+    }) => void;
+    onEvent?: (event: DepositEvent) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+        code?: string;
+    }) => void;
+}
+/**
+ * Bank-transfer deposit flow. Three steps:
+ *  1. Provider list (returned by `getBankTransferProviders`)
+ *  2. Amount input (Swapped-only today; other providers may diverge later)
+ *  3. Pending — Swapped widget opens in a new tab, we poll for the deposit
+ *
+ * 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;
+
 interface DepositWallet {
     id: string;
     chain_type: string;
@@ -537,18 +703,72 @@ declare namespace CoinbaseConnect {
     var displayName: string;
 }
 
+type StripeLinkStep = 'email' | 'register' | 'auth' | 'kyc' | 'kyc_form' | 'kyc_document' | 'wallet' | 'payment' | 'add_payment' | 'amount' | 'review' | 'checkout' | 'success' | 'error';
+interface PayWithStripeLinkProps {
+    userId: string;
+    publishableKey: string;
+    recipientAddress?: string;
+    destinationChainType?: ChainType;
+    destinationChainId?: string;
+    destinationTokenAddress?: string;
+    /**
+     * Pre-created deposit intent wallets (one per chain type). When provided, the
+     * Stripe onramp delivers to the deposit intent address matching the Stripe
+     * default token's chain type, instead of sending directly to
+     * `recipientAddress`. When omitted, the component fetches them itself.
+     */
+    wallets?: Wallet[];
+    /** Pre-fill email — skips the email screen and auto-submits against Stripe SDK */
+    email?: string;
+    /** URL for the Link logo icon (from CDN) */
+    iconUrl?: string;
+    /** Controlled step state (optional — for header back button coordination) */
+    step?: StripeLinkStep;
+    onStepChange?: (step: StripeLinkStep) => void;
+    /** Ref populated by the component with a custom back handler.
+     *  Returns true if the back was handled internally (e.g. KYC form sub-step). */
+    backHandlerRef?: MutableRefObject<(() => boolean) | null>;
+    onEvent?: (event: DepositEvent) => void;
+    onDepositSuccess?: (data: {
+        message: string;
+        transaction?: unknown;
+    }) => void;
+    onDepositError?: (error: {
+        message: string;
+        error?: unknown;
+    }) => void;
+}
+
+/**
+ * Headless Stripe Link onramp component.
+ *
+ * Orchestrates the full flow:
+ * 1. Email → create auth intent via backend
+ * 2. Auth → Stripe SDK `authenticate()` for OTP consent
+ * 3. KYC → check status, submit KYC info / verify documents if needed
+ * 4. Wallet → register destination wallet
+ * 5. Payment → collect payment method via Stripe SDK
+ * 6. Amount → user enters fiat amount
+ * 7. Checkout → create session + confirm
+ * 8. Success / Error
+ *
+ * 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;
+
 interface DepositExecutionItemProps {
     execution: DirectExecutionResponse;
     onClick?: () => void;
 }
-declare function DepositExecutionItem({ execution, onClick, }: DepositExecutionItemProps): react_jsx_runtime.JSX.Element;
+declare function DepositExecutionItem({ execution, onClick }: DepositExecutionItemProps): react_jsx_runtime.JSX.Element;
 
 interface DepositDetailContentProps {
     execution: DirectExecutionResponse;
     /** Merged into root (e.g. wider horizontal padding in embedded deposit details). */
     className?: string;
     /** Use "withdraw" to show "Withdrawal Tx" instead of "Deposit Tx" in details. */
-    variant?: "deposit" | "withdraw";
+    variant?: 'deposit' | 'withdraw';
 }
 declare function DepositDetailContent({ execution, className, variant, }: DepositDetailContentProps): react_jsx_runtime.JSX.Element;
 
@@ -607,18 +827,28 @@ interface CheckoutModalProps {
     defaultSourceTokenAddress?: string;
     /** Source token symbol (e.g. `"USDC"`). Must be paired with `defaultSourceChainType` + `defaultSourceChainId`. */
     defaultSourceSymbol?: string;
-    theme?: "light" | "dark" | "auto";
+    theme?: 'light' | 'dark' | 'auto';
     onCheckoutSuccess?: (data: {
         paymentIntentId: string;
         status: string;
+        method?: CheckoutMethod;
+        /**
+         * The full payment intent at the time of the success callback, mapped to
+         * SDK camelCase. Present whenever the SDK has retrieved the PI (always for
+         * the terminal `succeeded` callback; may be undefined for intermediate
+         * wallet-confirmed `processing` callbacks fired before the PI is polled).
+         */
+        paymentIntent?: CheckoutPaymentIntent;
     }) => void;
     onCheckoutError?: (error: {
         message: string;
         error?: unknown;
         code?: string;
+        method?: CheckoutMethod;
     }) => void;
+    onEvent?: (event: CheckoutEvent) => void;
 }
-declare function CheckoutModal({ open, onOpenChange, clientSecret, publishableKey, modalTitle, enableTransferCrypto, enableConnectWallet, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, theme, onCheckoutSuccess, onCheckoutError, }: CheckoutModalProps): react_jsx_runtime.JSX.Element;
+declare function CheckoutModal({ open, onOpenChange, clientSecret, publishableKey, modalTitle, enableTransferCrypto, enableConnectWallet, defaultSourceChainType, defaultSourceChainId, defaultSourceTokenAddress, defaultSourceSymbol, theme, onCheckoutSuccess, onCheckoutError, onEvent, }: CheckoutModalProps): react_jsx_runtime.JSX.Element;
 
 interface WithdrawTransactionInfo {
     /** Source (sending) chain type */
@@ -681,7 +911,7 @@ interface WithdrawModalProps {
         code?: string;
     }) => void;
     onEvent?: (event: WithdrawEvent) => void;
-    theme?: "light" | "dark" | "auto";
+    theme?: 'light' | 'dark' | 'auto';
     hideOverlay?: boolean;
 }
 declare function WithdrawModal({ open, onOpenChange, publishableKey, modalTitle, externalUserId, sourceChainType, sourceChainId, sourceTokenAddress, sourceTokenSymbol, recipientAddress: recipientAddressProp, senderAddress, defaultDestinationChainType, defaultDestinationChainId, defaultDestinationTokenAddress, defaultDestinationSymbol, onWithdraw, onWithdrawSuccess, onWithdrawError, onEvent, theme, hideOverlay, }: WithdrawModalProps): react_jsx_runtime.JSX.Element;
@@ -691,7 +921,7 @@ interface WithdrawTokenSelectorProps {
     onSelect: (token: DestinationToken, chain: DestinationTokenChain) => void;
     onBack: () => void;
 }
-declare function WithdrawTokenSelector({ tokens, onSelect, onBack, }: WithdrawTokenSelectorProps): react_jsx_runtime.JSX.Element;
+declare function WithdrawTokenSelector({ tokens, onSelect, onBack }: WithdrawTokenSelectorProps): react_jsx_runtime.JSX.Element;
 
 interface WithdrawDoubleInputProps {
     tokens: DestinationToken[];
@@ -770,7 +1000,7 @@ interface WithdrawExecutionItemProps {
     execution: DirectExecutionResponse;
     onClick?: () => void;
 }
-declare function WithdrawExecutionItem({ execution, onClick, }: WithdrawExecutionItemProps): react_jsx_runtime.JSX.Element;
+declare function WithdrawExecutionItem({ execution, onClick }: WithdrawExecutionItemProps): react_jsx_runtime.JSX.Element;
 
 interface WithdrawConfirmingViewProps {
     txInfo: WithdrawTransactionInfo;
@@ -788,10 +1018,10 @@ type DetectedWallet = {
     name: string;
     address: string;
 } & ({
-    chainFamily: "evm";
+    chainFamily: 'evm';
     provider: EvmWalletProvider;
 } | {
-    chainFamily: "solana";
+    chainFamily: 'solana';
     provider: SolanaWalletProvider;
 });
 declare function sendEvmWithdraw(params: {
@@ -827,7 +1057,7 @@ interface CurrencyListItemProps {
     isSelected: boolean;
     onSelect: (currencyCode: string) => void;
 }
-declare function CurrencyListItem({ currency, isSelected, onSelect, }: CurrencyListItemProps): react_jsx_runtime.JSX.Element;
+declare function CurrencyListItem({ currency, isSelected, onSelect }: CurrencyListItemProps): react_jsx_runtime.JSX.Element;
 
 interface CurrencyListSectionProps {
     title: string;
@@ -944,6 +1174,31 @@ interface AllowedCountryResult {
  */
 declare function useAllowedCountry(publishableKey: string): AllowedCountryResult;
 
+/**
+ * Returns `value` after it has stayed unchanged for `delay` milliseconds.
+ * During the wait window the previously-settled value is returned, so a
+ * downstream effect / API call keyed on the result only fires once the
+ * input stops changing.
+ *
+ * Typical pattern:
+ *
+ * ```ts
+ * const debouncedAmount = useDebounce(amount, 800);
+ * useEffect(() => {
+ *   void prepareSession(debouncedAmount);
+ * }, [debouncedAmount]);
+ * ```
+ *
+ * For eager UI work that should run on every keystroke (e.g. clearing a
+ * stale session), key that effect on the raw `value`; keep the debounced
+ * effect on the returned value. The two concerns are then cleanly split.
+ *
+ * The hook is intentionally a value-debounce, not a callback-debounce —
+ * value-debouncing composes with any side-effect, while a debounced
+ * callback couples timing to a specific function.
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+
 interface UsePaymentIntentParams {
     clientSecret: string;
     publishableKey: string;
@@ -1158,7 +1413,7 @@ declare const colors: {
     };
 };
 type ThemeColors = typeof defaultColors.light;
-type ThemeMode = "light" | "dark";
+type ThemeMode = 'light' | 'dark';
 /** Partial theme colors for customization */
 type CustomThemeColors = Partial<ThemeColors>;
 /** Theme customization options */
@@ -1317,7 +1572,7 @@ interface ThemeContextValue {
 interface ThemeProviderProps {
     children: React$1.ReactNode;
     /** Force a specific theme mode, or 'auto' to use system preference */
-    mode?: ThemeMode | "auto";
+    mode?: ThemeMode | 'auto';
     /** Simple accent/primary color override (applies to both light and dark) */
     accentColor?: string;
     /** Full theme customization per mode */
@@ -1349,4 +1604,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function truncateAddress(address: string, startChars?: number, endChars?: number): string;
 
-export { type AllowedCountryResult, type BrowserWalletAmountQuickSelect, Button, type ButtonProps, type ButtonTokens, BuyWithCard, type BuyWithCardProps, type CardTokens, CheckingForDepositIndicator, CheckoutModal, type CheckoutModalProps, CoinbaseConnect, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, ConnectExchangeButton, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, DepositModal, type DepositModalInitialScreen, type DepositModalProps, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, type DetectedWallet, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type EvmWalletProvider, type FontConfig, HYPERCORE_CHAIN_ID, type HeaderTokens, type InputTokens, type ListTokens, ManualDepositButton, QRCodeSkeleton, type ResolvedFonts, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SolanaWalletProvider, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, type UseDepositQuoteParams, type UsePaymentIntentParams, type UseSupportedDepositTokensOptions, WithdrawConfirmingView, WithdrawDoubleInput, WithdrawExecutionItem, WithdrawForm, WithdrawModal, type WithdrawModalProps, WithdrawTokenSelector, type WithdrawTransactionInfo, buttonVariants, cn, colors, defaultColors, detectBrowserWallet, getColors, isHypercoreChain, mergeColors, resolveComponentTokens, sendEvmWithdraw, sendHypercoreWithdraw, sendSolanaWithdraw, truncateAddress, useAddressBalance, useAllowedCountry, useDepositPolling, useDepositQuote, usePaymentIntent, useSourceTokenValidation, useSupportedDepositTokens, useSupportedDestinationTokens, useTheme, useVerifyRecipientAddress, useWithdrawPolling };
+export { type AllowedCountryResult, BankTransfer, BankTransferButton, type BankTransferProps, type BankTransferView, type BrowserWalletAmountQuickSelect, Button, type ButtonProps, type ButtonTokens, BuyWithApplePay, type BuyWithApplePayProps, BuyWithCard, type BuyWithCardProps, type CardTokens, CheckingForDepositIndicator, CheckoutModal, type CheckoutModalProps, CoinbaseConnect, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, ConnectExchangeButton, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, DepositModal, type DepositModalInitialScreen, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, type DetectedWallet, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type EvmWalletProvider, type FontConfig, HYPERCORE_CHAIN_ID, type HeaderTokens, type InputTokens, type ListTokens, ManualDepositButton, PayWithStripeLink, type PayWithStripeLinkProps, QRCodeSkeleton, type ResolvedFonts, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SolanaWalletProvider, type StoredApplePaySession, StripeLinkButton, type StripeLinkStep, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, type UseDepositQuoteParams, type UsePaymentIntentParams, type UseSupportedDepositTokensOptions, WithdrawConfirmingView, WithdrawDoubleInput, WithdrawExecutionItem, WithdrawForm, WithdrawModal, type WithdrawModalProps, WithdrawTokenSelector, type WithdrawTransactionInfo, buttonVariants, clearStoredApplePaySession, cn, colors, defaultColors, detectBrowserWallet, getColors, getStoredApplePaySession, isHypercoreChain, isOnrampTokenFresh, isPhoneVerificationFresh, mergeColors, resolveComponentTokens, sendEvmWithdraw, sendHypercoreWithdraw, sendSolanaWithdraw, setStoredApplePaySession, truncateAddress, useAddressBalance, useAllowedCountry, useDebounce, useDepositPolling, useDepositQuote, usePaymentIntent, useSourceTokenValidation, useSupportedDepositTokens, useSupportedDestinationTokens, useTheme, useVerifyRecipientAddress, useWithdrawPolling };