@unifold/ui-react 0.1.38 → 0.1.40

package/dist/index.d.mts

@@ -32,6 +32,12 @@ interface UseDepositPollingOptions {
         error?: unknown;
         code?: string;
     }) => void;
+    /**
+     * When true (with `depositWalletId`), enables `pollDirectExecutions` as soon as `enabled`
+     * becomes true — no 10s delay. Use when polling only starts after the on-chain tx is sent
+     * (e.g. browser wallet confirming step).
+     */
+    immediateDirectPolling?: boolean;
 }
 interface UseDepositPollingResult {
     executions: AutoSwapResponse[];
@@ -43,7 +49,49 @@ interface UseDepositPollingResult {
     /** Call this when user clicks "I've made the deposit" (manual mode) */
     handleIveDeposited: () => void;
 }
-declare function useDepositPolling({ userId, publishableKey, depositConfirmationMode, depositWalletId, enabled, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
+declare function useDepositPolling({ userId, publishableKey, depositConfirmationMode, depositWalletId, enabled, immediateDirectPolling, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
+
+declare global {
+    interface Window {
+        phantom?: {
+            solana?: PhantomSolanaProvider;
+            ethereum?: EthereumProvider;
+        };
+        solana?: PhantomSolanaProvider;
+        ethereum?: EthereumProvider;
+    }
+}
+interface PhantomSolanaProvider {
+    isPhantom?: boolean;
+    isConnected?: boolean;
+    publicKey?: {
+        toString(): string;
+    };
+    connect(opts?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey: {
+            toString(): string;
+        };
+    }>;
+    disconnect(): Promise<void>;
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
+}
+interface EthereumProvider {
+    isMetaMask?: boolean;
+    isPhantom?: boolean;
+    selectedAddress?: string;
+    request(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<unknown>;
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    removeListener(event: string, callback: (...args: unknown[]) => void): void;
+}
+
+/** Quick amount chips on the browser wallet "Enter amount" step */
+type BrowserWalletAmountQuickSelect = "usd" | "percentage";
 
 type DepositModalInitialScreen = "main" | "transfer" | "card" | "tracker";
 interface DepositModalProps {
@@ -80,6 +128,11 @@ interface DepositModalProps {
     depositConfirmationMode?: DepositConfirmationMode;
     /** Enable browser wallet connection option. Defaults to false */
     enableConnectWallet?: boolean;
+    /**
+     * Connect Wallet → Enter amount: percentage chips (10%, 25%, 50%, 75%, MAX) from USD balance, or fixed USD ($25…).
+     * @default "percentage"
+     */
+    browserWalletAmountQuickSelect?: BrowserWalletAmountQuickSelect;
     /** Enable "Pay with Exchange" option. Overrides dashboard default. Defaults to dashboard value or true. */
     enablePayWithExchange?: boolean;
     /** Deposit with Card — onramp step: hide the You use / You buy / You receive card. @default false */
@@ -102,7 +155,7 @@ interface DepositModalProps {
     /** First screen when the modal opens. Default `main` (deposit menu). */
     initialScreen?: DepositModalInitialScreen;
 }
-declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableConnectWallet, enablePayWithExchange, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, theme, hideOverlay, initialScreen, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
+declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, theme, hideOverlay, initialScreen, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
 
 interface DepositHeaderProps {
     title: string;
@@ -284,45 +337,6 @@ interface DepositTrackerButtonProps {
 }
 declare function DepositTrackerButton({ onClick, title, subtitle, badge, }: DepositTrackerButtonProps): react_jsx_runtime.JSX.Element;
 
-declare global {
-    interface Window {
-        phantom?: {
-            solana?: PhantomSolanaProvider;
-            ethereum?: EthereumProvider;
-        };
-        solana?: PhantomSolanaProvider;
-        ethereum?: EthereumProvider;
-    }
-}
-interface PhantomSolanaProvider {
-    isPhantom?: boolean;
-    isConnected?: boolean;
-    publicKey?: {
-        toString(): string;
-    };
-    connect(opts?: {
-        onlyIfTrusted?: boolean;
-    }): Promise<{
-        publicKey: {
-            toString(): string;
-        };
-    }>;
-    disconnect(): Promise<void>;
-    on(event: string, callback: (...args: unknown[]) => void): void;
-    off(event: string, callback: (...args: unknown[]) => void): void;
-}
-interface EthereumProvider {
-    isMetaMask?: boolean;
-    isPhantom?: boolean;
-    selectedAddress?: string;
-    request(args: {
-        method: string;
-        params?: unknown[];
-    }): Promise<unknown>;
-    on(event: string, callback: (...args: unknown[]) => void): void;
-    removeListener(event: string, callback: (...args: unknown[]) => void): void;
-}
-
 interface DepositExecutionItemProps {
     execution: AutoSwapResponse;
     onClick?: () => void;
@@ -331,8 +345,10 @@ declare function DepositExecutionItem({ execution, onClick, }: DepositExecutionI
 
 interface DepositDetailContentProps {
     execution: AutoSwapResponse;
+    /** Merged into root (e.g. wider horizontal padding in embedded deposit details). */
+    className?: string;
 }
-declare function DepositDetailContent({ execution }: DepositDetailContentProps): react_jsx_runtime.JSX.Element;
+declare function DepositDetailContent({ execution, className, }: DepositDetailContentProps): react_jsx_runtime.JSX.Element;
 
 interface DepositPollingUiProps {
     depositConfirmationMode: DepositConfirmationMode;
@@ -351,6 +367,14 @@ interface DepositPollingUiProps {
  */
 declare function DepositPollingUi({ depositConfirmationMode, showWaitingUi, hasExecution, onIveDeposited, }: DepositPollingUiProps): react_jsx_runtime.JSX.Element | null;
 
+interface ConfirmingViewProps {
+    isConfirming: boolean;
+    onClose: () => void;
+    executions?: AutoSwapResponse[];
+    isPolling?: boolean;
+}
+declare function ConfirmingView({ isConfirming, onClose, executions, isPolling, }: ConfirmingViewProps): react_jsx_runtime.JSX.Element;
+
 interface CurrencyListItemProps {
     currency: FiatCurrency;
     isSelected: boolean;
@@ -383,6 +407,15 @@ declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitiv
 interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
     /** Render inline without portal, overlay, or close button (for embedded/inline mode) */
     hideOverlay?: boolean;
+    /**
+     * When a `PortalContainerProvider` is set, portal content into it **without** the dimming
+     * overlay (same geometry as the default portaled dialog). Use for nested sheets that
+     * should fill the host shell (e.g. deposit details over browser-wallet confirming view).
+     * Does not combine with `hideOverlay` (embedded DepositModal still uses `hideOverlay` only).
+     */
+    omitOverlay?: boolean;
+    /** Merged into `DialogOverlay` (e.g. z-index above in-app layers such as deposit toasts). */
+    overlayClassName?: string;
 }
 declare const DialogContent: React.ForwardRefExoticComponent<DialogContentProps & React.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
@@ -738,4 +771,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function truncateAddress(address: string, startChars?: number, endChars?: number): string;
 
-export { type AllowedCountryResult, Button, type ButtonProps, type ButtonTokens, BuyWithCard, type BuyWithCardProps, type CardTokens, type ComponentConfig, type ComponentOverrides, type ComponentTokens, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, DepositModal, type DepositModalInitialScreen, type DepositModalProps, DepositPollingUi, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type FontConfig, type HeaderTokens, type InputTokens, type ListTokens, type ResolvedFonts, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, buttonVariants, cn, colors, defaultColors, getColors, mergeColors, resolveComponentTokens, truncateAddress, useAllowedCountry, useDepositPolling, useTheme };
+export { type AllowedCountryResult, type BrowserWalletAmountQuickSelect, Button, type ButtonProps, type ButtonTokens, BuyWithCard, type BuyWithCardProps, type CardTokens, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, DepositModal, type DepositModalInitialScreen, type DepositModalProps, DepositPollingUi, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type FontConfig, type HeaderTokens, type InputTokens, type ListTokens, type ResolvedFonts, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, buttonVariants, cn, colors, defaultColors, getColors, mergeColors, resolveComponentTokens, truncateAddress, useAllowedCountry, useDepositPolling, useTheme };

package/dist/index.d.ts

@@ -32,6 +32,12 @@ interface UseDepositPollingOptions {
         error?: unknown;
         code?: string;
     }) => void;
+    /**
+     * When true (with `depositWalletId`), enables `pollDirectExecutions` as soon as `enabled`
+     * becomes true — no 10s delay. Use when polling only starts after the on-chain tx is sent
+     * (e.g. browser wallet confirming step).
+     */
+    immediateDirectPolling?: boolean;
 }
 interface UseDepositPollingResult {
     executions: AutoSwapResponse[];
@@ -43,7 +49,49 @@ interface UseDepositPollingResult {
     /** Call this when user clicks "I've made the deposit" (manual mode) */
     handleIveDeposited: () => void;
 }
-declare function useDepositPolling({ userId, publishableKey, depositConfirmationMode, depositWalletId, enabled, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
+declare function useDepositPolling({ userId, publishableKey, depositConfirmationMode, depositWalletId, enabled, immediateDirectPolling, onDepositSuccess, onDepositError, }: UseDepositPollingOptions): UseDepositPollingResult;
+
+declare global {
+    interface Window {
+        phantom?: {
+            solana?: PhantomSolanaProvider;
+            ethereum?: EthereumProvider;
+        };
+        solana?: PhantomSolanaProvider;
+        ethereum?: EthereumProvider;
+    }
+}
+interface PhantomSolanaProvider {
+    isPhantom?: boolean;
+    isConnected?: boolean;
+    publicKey?: {
+        toString(): string;
+    };
+    connect(opts?: {
+        onlyIfTrusted?: boolean;
+    }): Promise<{
+        publicKey: {
+            toString(): string;
+        };
+    }>;
+    disconnect(): Promise<void>;
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
+}
+interface EthereumProvider {
+    isMetaMask?: boolean;
+    isPhantom?: boolean;
+    selectedAddress?: string;
+    request(args: {
+        method: string;
+        params?: unknown[];
+    }): Promise<unknown>;
+    on(event: string, callback: (...args: unknown[]) => void): void;
+    removeListener(event: string, callback: (...args: unknown[]) => void): void;
+}
+
+/** Quick amount chips on the browser wallet "Enter amount" step */
+type BrowserWalletAmountQuickSelect = "usd" | "percentage";
 
 type DepositModalInitialScreen = "main" | "transfer" | "card" | "tracker";
 interface DepositModalProps {
@@ -80,6 +128,11 @@ interface DepositModalProps {
     depositConfirmationMode?: DepositConfirmationMode;
     /** Enable browser wallet connection option. Defaults to false */
     enableConnectWallet?: boolean;
+    /**
+     * Connect Wallet → Enter amount: percentage chips (10%, 25%, 50%, 75%, MAX) from USD balance, or fixed USD ($25…).
+     * @default "percentage"
+     */
+    browserWalletAmountQuickSelect?: BrowserWalletAmountQuickSelect;
     /** Enable "Pay with Exchange" option. Overrides dashboard default. Defaults to dashboard value or true. */
     enablePayWithExchange?: boolean;
     /** Deposit with Card — onramp step: hide the You use / You buy / You receive card. @default false */
@@ -102,7 +155,7 @@ interface DepositModalProps {
     /** First screen when the modal opens. Default `main` (deposit menu). */
     initialScreen?: DepositModalInitialScreen;
 }
-declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableConnectWallet, enablePayWithExchange, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, theme, hideOverlay, initialScreen, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
+declare function DepositModal({ open, onOpenChange, userId, publishableKey, modalTitle, destinationTokenSymbol, recipientAddress, destinationChainType, destinationChainId, destinationTokenAddress, hideDepositTracker, showBalanceHeader, transferInputVariant, depositConfirmationMode, enableConnectWallet, browserWalletAmountQuickSelect, enablePayWithExchange, hideDepositFlowInfo, hideDisplayDescription, onDepositSuccess, onDepositError, theme, hideOverlay, initialScreen, transferCryptoTitle, depositWithCardTitle, payWithExchangeTitle, depositTrackerTitle, depositTrackerSubTitle, }: DepositModalProps): react_jsx_runtime.JSX.Element;
 
 interface DepositHeaderProps {
     title: string;
@@ -284,45 +337,6 @@ interface DepositTrackerButtonProps {
 }
 declare function DepositTrackerButton({ onClick, title, subtitle, badge, }: DepositTrackerButtonProps): react_jsx_runtime.JSX.Element;
 
-declare global {
-    interface Window {
-        phantom?: {
-            solana?: PhantomSolanaProvider;
-            ethereum?: EthereumProvider;
-        };
-        solana?: PhantomSolanaProvider;
-        ethereum?: EthereumProvider;
-    }
-}
-interface PhantomSolanaProvider {
-    isPhantom?: boolean;
-    isConnected?: boolean;
-    publicKey?: {
-        toString(): string;
-    };
-    connect(opts?: {
-        onlyIfTrusted?: boolean;
-    }): Promise<{
-        publicKey: {
-            toString(): string;
-        };
-    }>;
-    disconnect(): Promise<void>;
-    on(event: string, callback: (...args: unknown[]) => void): void;
-    off(event: string, callback: (...args: unknown[]) => void): void;
-}
-interface EthereumProvider {
-    isMetaMask?: boolean;
-    isPhantom?: boolean;
-    selectedAddress?: string;
-    request(args: {
-        method: string;
-        params?: unknown[];
-    }): Promise<unknown>;
-    on(event: string, callback: (...args: unknown[]) => void): void;
-    removeListener(event: string, callback: (...args: unknown[]) => void): void;
-}
-
 interface DepositExecutionItemProps {
     execution: AutoSwapResponse;
     onClick?: () => void;
@@ -331,8 +345,10 @@ declare function DepositExecutionItem({ execution, onClick, }: DepositExecutionI
 
 interface DepositDetailContentProps {
     execution: AutoSwapResponse;
+    /** Merged into root (e.g. wider horizontal padding in embedded deposit details). */
+    className?: string;
 }
-declare function DepositDetailContent({ execution }: DepositDetailContentProps): react_jsx_runtime.JSX.Element;
+declare function DepositDetailContent({ execution, className, }: DepositDetailContentProps): react_jsx_runtime.JSX.Element;
 
 interface DepositPollingUiProps {
     depositConfirmationMode: DepositConfirmationMode;
@@ -351,6 +367,14 @@ interface DepositPollingUiProps {
  */
 declare function DepositPollingUi({ depositConfirmationMode, showWaitingUi, hasExecution, onIveDeposited, }: DepositPollingUiProps): react_jsx_runtime.JSX.Element | null;
 
+interface ConfirmingViewProps {
+    isConfirming: boolean;
+    onClose: () => void;
+    executions?: AutoSwapResponse[];
+    isPolling?: boolean;
+}
+declare function ConfirmingView({ isConfirming, onClose, executions, isPolling, }: ConfirmingViewProps): react_jsx_runtime.JSX.Element;
+
 interface CurrencyListItemProps {
     currency: FiatCurrency;
     isSelected: boolean;
@@ -383,6 +407,15 @@ declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitiv
 interface DialogContentProps extends React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
     /** Render inline without portal, overlay, or close button (for embedded/inline mode) */
     hideOverlay?: boolean;
+    /**
+     * When a `PortalContainerProvider` is set, portal content into it **without** the dimming
+     * overlay (same geometry as the default portaled dialog). Use for nested sheets that
+     * should fill the host shell (e.g. deposit details over browser-wallet confirming view).
+     * Does not combine with `hideOverlay` (embedded DepositModal still uses `hideOverlay` only).
+     */
+    omitOverlay?: boolean;
+    /** Merged into `DialogOverlay` (e.g. z-index above in-app layers such as deposit toasts). */
+    overlayClassName?: string;
 }
 declare const DialogContent: React.ForwardRefExoticComponent<DialogContentProps & React.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
@@ -738,4 +771,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function truncateAddress(address: string, startChars?: number, endChars?: number): string;
 
-export { type AllowedCountryResult, Button, type ButtonProps, type ButtonTokens, BuyWithCard, type BuyWithCardProps, type CardTokens, type ComponentConfig, type ComponentOverrides, type ComponentTokens, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, DepositModal, type DepositModalInitialScreen, type DepositModalProps, DepositPollingUi, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type FontConfig, type HeaderTokens, type InputTokens, type ListTokens, type ResolvedFonts, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, buttonVariants, cn, colors, defaultColors, getColors, mergeColors, resolveComponentTokens, truncateAddress, useAllowedCountry, useDepositPolling, useTheme };
+export { type AllowedCountryResult, type BrowserWalletAmountQuickSelect, Button, type ButtonProps, type ButtonTokens, BuyWithCard, type BuyWithCardProps, type CardTokens, type ComponentConfig, type ComponentOverrides, type ComponentTokens, ConfirmingView, type ContainerTokens, CurrencyListItem, CurrencyListSection, CurrencyModal, type CustomThemeColors, type DepositConfirmationMode, DepositDetailContent, DepositExecutionItem, DepositHeader, DepositModal, type DepositModalInitialScreen, type DepositModalProps, DepositPollingUi, DepositSuccessToast, DepositTrackerButton, DepositWithCardButton, DepositsModal, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type FontConfig, type HeaderTokens, type InputTokens, type ListTokens, type ResolvedFonts, type SearchTokens, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, StyledQRCode, type ThemeColors, type ThemeConfig, type ThemeMode, ThemeProvider, type ThemeProviderProps, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TransferCryptoButton, TransferCryptoDoubleInput, TransferCryptoSingleInput, buttonVariants, cn, colors, defaultColors, getColors, mergeColors, resolveComponentTokens, truncateAddress, useAllowedCountry, useDepositPolling, useTheme };