@pollar/react 0.9.0 → 0.10.0-rc.10

package/dist/index.d.mts

@@ -1,28 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WalletId, AuthState, pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, PollarAdapter, KycStatus as KycStatus$1, RampQuote, KycProvider, KycStartResponse, RampDirection, PaymentInstructions, EnabledAssetRecord, WalletBalanceRecord, DistributionRulesState, DistributionRule } from '@pollar/core';
-export { SessionsState } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapQuoteParams, SwapQuote, PollarAdapter, WalletId, KycStatus as KycStatus$1, RampQuote, AuthState, KycProvider, KycStartResponse, RampDirection, RampTxStatus, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+export { AuthProviderContext, PollarAuthProvider, SessionsState } from '@pollar/core';
 import { ReactNode } from 'react';
 
 type ConfigResponse = pollarPaths['/applications/config']['get']['responses'][200]['content']['application/json'];
 type PollarConfig = ConfigResponse['content'];
 type PollarStyles = PollarConfig['styles'];
-/**
- * Props passed by `@pollar/react` to a `renderWallets` slot. External wallet
- * picker components receive these and call `onConnect(id)` when the user picks
- * a wallet; `@pollar/react` wraps that into `client.loginWallet(id)`.
- */
-interface RenderWalletsProps {
-    /** Wrapper around `client.loginWallet(id)`. */
-    onConnect: (id: WalletId) => void;
-    /** Current auth state — picker can disable buttons / surface loading. */
-    authState: AuthState;
-}
-/**
- * Signature for the `ui.renderWallets` slot on `<PollarProvider>`. When
- * provided, replaces the default Freighter/Albedo buttons in the LoginModal
- * with whatever the slot returns (typically a kit-powered wallet grid).
- */
-type RenderWalletsSlot = (props: RenderWalletsProps) => ReactNode;
 interface LoginButtonProps {
     onSuccess?: () => void;
     onError?: (error: Error) => void;
@@ -36,7 +19,14 @@ interface AuthModalProps {
 }
 
 interface PollarContextValue {
-    walletAddress: string;
+    /**
+     * The authenticated user's wallet as a discriminated union over `custody`
+     * (`internal` | `smart` | `external`), or `null` when unauthenticated. Every
+     * field is meaningful for any login method — `custody` is always present and
+     * strictly determines the shape of `provider`. Use `wallet.address` for the
+     * on-chain address and `wallet.provider` for the wallet/login provider.
+     */
+    wallet: WalletInfo | null;
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
@@ -53,8 +43,6 @@ interface PollarContextValue {
     openSessionsModal: () => void;
     appConfig: PollarConfig;
     styles: PollarStyles;
-    /** UI slot for wallet picker (forwarded from provider props). */
-    renderWallets?: RenderWalletsSlot;
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
@@ -66,7 +54,6 @@ interface PollarContextValue {
     buildAndSignAndSubmitTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<SubmitOutcome>;
     /** Alias of `buildAndSignAndSubmitTx`. */
     runTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<SubmitOutcome>;
-    walletType: WalletId | null;
     network: StellarNetwork;
     setNetwork: (network: StellarNetwork) => void;
     walletBalance: WalletBalanceState;
@@ -104,6 +91,20 @@ interface PollarContextValue {
     openWalletBalanceModal: () => void;
     openSendModal: () => void;
     openReceiveModal: () => void;
+    /**
+     * Quote an asset-to-asset swap across the requested venue(s). Read-only;
+     * returns quotes ranked best-first. Mirrors {@link PollarClient.getSwapQuote}.
+     */
+    getSwapQuote: (params: SwapQuoteParams) => Promise<SwapQuote[]>;
+    /**
+     * Execute a swap from a quote (establishes the buy-asset trustline first when
+     * needed). Drives the transaction state machine. Mirrors {@link PollarClient.swap}.
+     */
+    swap: (quote: SwapQuote, opts?: {
+        autoTrustline?: boolean;
+    }) => Promise<SubmitOutcome>;
+    /** Open the swap modal. */
+    openSwapModal: () => void;
     openDistributionRulesModal: () => void;
     adapters?: PollarAdapters;
 }
@@ -124,11 +125,6 @@ interface PollarProviderProps {
      * `/applications/config` on mount.
      */
     appConfig?: PollarConfig;
-    /** UI customization slots. */
-    ui?: {
-        /** Replaces the default Freighter/Albedo wallet picker. */
-        renderWallets?: RenderWalletsSlot;
-    };
     adapters?: PollarAdapters;
     /**
      * Notified when persistent storage silently degrades to in-memory mode
@@ -142,7 +138,7 @@ interface PollarProviderProps {
     onStorageDegrade?: OnStorageDegrade;
     children: ReactNode;
 }
-declare function PollarProvider({ client, appConfig: appConfigProp, ui, adapters, onStorageDegrade, children, }: PollarProviderProps): react_jsx_runtime.JSX.Element;
+declare function PollarProvider({ client, appConfig: appConfigProp, adapters, onStorageDegrade, children, }: PollarProviderProps): react_jsx_runtime.JSX.Element;
 declare function usePollar(): PollarContextValue;
 
 type WrappedAdapter<T extends PollarAdapter> = {
@@ -221,6 +217,11 @@ interface SendModalProps {
 }
 declare function SendModal({ onClose }: SendModalProps): react_jsx_runtime.JSX.Element;
 
+interface SwapModalProps {
+    onClose: () => void;
+}
+declare function SwapModal({ onClose }: SwapModalProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalProps {
     onClose: () => void;
 }
@@ -236,6 +237,14 @@ interface DistributionRulesModalProps {
 }
 declare function DistributionRulesModal({ onClose }: DistributionRulesModalProps): react_jsx_runtime.JSX.Element;
 
+type WalletAdapterEntry = {
+    id: WalletId;
+    meta: {
+        label: string;
+        iconUrl?: string;
+        group?: string;
+    };
+};
 interface LoginModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -252,6 +261,8 @@ interface LoginModalTemplateProps {
         github: boolean;
         apple: boolean;
     };
+    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, …). */
+    walletAdapters: WalletAdapterEntry[];
     appName: string;
     email?: string;
     onEmailChange?: (email: string) => void;
@@ -262,8 +273,6 @@ interface LoginModalTemplateProps {
     onLoginSmartWallet?: () => void;
     /** Create a new passkey + smart wallet (new user). */
     onCreateSmartWallet?: () => void;
-    /** Optional override for the wallet picker view. Defaults to a Freighter+Albedo list. */
-    renderWallets?: RenderWalletsSlot;
     authState: AuthState;
     codeInputKey?: number;
     onCodeSubmit?: (code: string) => void;
@@ -271,7 +280,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onWalletConnect, onLoginSmartWallet, onCreateSmartWallet, renderWallets, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, walletAdapters, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onWalletConnect, onLoginSmartWallet, onCreateSmartWallet, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 type KycStep = 'select_provider' | 'verifying' | 'polling' | 'done';
 interface KycModalTemplateProps {
@@ -289,7 +298,7 @@ interface KycModalTemplateProps {
 }
 declare function KycModalTemplate({ theme, accentColor, step, providers, selectedProvider, session, kycStatus, isLoading, onSelectProvider, onDoneVerifying, onClose, }: KycModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-type RampStep = 'input' | 'loading_quote' | 'select_route' | 'payment_instructions';
+type RampStep = 'input' | 'loading_quote' | 'select_route' | 'status' | 'error';
 interface RampWidgetTemplateProps {
     theme: string;
     accentColor: string;
@@ -299,18 +308,26 @@ interface RampWidgetTemplateProps {
     currency: string;
     country: string;
     quotes: RampQuote[];
-    paymentInstructions: PaymentInstructions | null;
     isLoading: boolean;
+    provider: string;
+    txStatus: RampTxStatus | null;
+    kycUrl: string | null;
+    stellarTxHash: string | null;
+    canComplete: boolean;
+    completing: boolean;
+    errorMsg: string | null;
     onDirectionChange: (d: RampDirection) => void;
     onAmountChange: (v: string) => void;
     onCurrencyChange: (v: string) => void;
     onCountryChange: (v: string) => void;
     onFindRoute: () => void;
     onSelectQuote: (q: RampQuote) => void;
-    onCopy: (value: string) => void;
+    onOpenKyc: () => void;
+    onCompleteWithdraw: () => void;
+    onRetry: () => void;
     onClose: () => void;
 }
-declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, quotes, paymentInstructions, isLoading, onDirectionChange, onAmountChange, onCurrencyChange, onCountryChange, onFindRoute, onSelectQuote, onCopy, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
+declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, quotes, isLoading, provider, txStatus, kycUrl, stellarTxHash, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onCurrencyChange, onCountryChange, onFindRoute, onSelectQuote, onOpenKyc, onCompleteWithdraw, onRetry, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface TransactionModalTemplateProps {
     theme: string;
@@ -411,6 +428,53 @@ interface SendModalTemplateProps {
 }
 declare function SendModalTemplate({ theme, accentColor, step, txTitle, assets, selectedAsset, amount, destination, formError, isLoadingBalance, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onSelectAsset, onAmountChange, onDestinationChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
 
+/** A selectable asset in the sell/buy pickers, normalized across balance/enabled records. */
+interface SwapAssetOption {
+    ref: SwapQuoteParams['sellAsset'];
+    code: string;
+    issuer?: string | undefined;
+    available?: string | undefined;
+    enabledInApp?: boolean | undefined;
+}
+interface SwapModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    step: 'form' | 'tx';
+    txTitle: string;
+    sellOptions: SwapAssetOption[];
+    buyOptions: SwapAssetOption[];
+    selectedSell: SwapAssetOption | null;
+    selectedBuy: SwapAssetOption | null;
+    amount: string;
+    provider: SwapProvider;
+    providers: SwapProvider[];
+    quote: SwapQuote | null;
+    quoteLoading: boolean;
+    quoteError: string;
+    formError: string;
+    isLoadingData: boolean;
+    smartUnsupported: boolean;
+    transaction: TransactionState;
+    showXdr: boolean;
+    copied: boolean;
+    explorerUrl: string | null;
+    walletType?: WalletId | null | undefined;
+    showBack: boolean;
+    isInProgress: boolean;
+    onClose: () => void;
+    onBack: () => void;
+    onSelectSell: (o: SwapAssetOption) => void;
+    onSelectBuy: (o: SwapAssetOption) => void;
+    onAmountChange: (value: string) => void;
+    onProviderChange: (p: SwapProvider) => void;
+    onSwap: () => void;
+    onToggleXdr: () => void;
+    onCopyHash: () => void;
+    onRetry: () => void;
+    onDone: () => void;
+}
+declare function SwapModalTemplate({ theme, accentColor, step, txTitle, sellOptions, buyOptions, selectedSell, selectedBuy, amount, provider, providers, quote, quoteLoading, quoteError, formError, isLoadingData, smartUnsupported, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onSelectSell, onSelectBuy, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -447,4 +511,4 @@ interface DistributionRulesModalTemplateProps {
 }
 declare function DistributionRulesModalTemplate({ theme, accentColor, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, type RenderWalletsProps, type RenderWalletsSlot, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };
+export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };

package/dist/index.d.ts

@@ -1,28 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WalletId, AuthState, pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, PollarAdapter, KycStatus as KycStatus$1, RampQuote, KycProvider, KycStartResponse, RampDirection, PaymentInstructions, EnabledAssetRecord, WalletBalanceRecord, DistributionRulesState, DistributionRule } from '@pollar/core';
-export { SessionsState } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapQuoteParams, SwapQuote, PollarAdapter, WalletId, KycStatus as KycStatus$1, RampQuote, AuthState, KycProvider, KycStartResponse, RampDirection, RampTxStatus, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+export { AuthProviderContext, PollarAuthProvider, SessionsState } from '@pollar/core';
 import { ReactNode } from 'react';
 
 type ConfigResponse = pollarPaths['/applications/config']['get']['responses'][200]['content']['application/json'];
 type PollarConfig = ConfigResponse['content'];
 type PollarStyles = PollarConfig['styles'];
-/**
- * Props passed by `@pollar/react` to a `renderWallets` slot. External wallet
- * picker components receive these and call `onConnect(id)` when the user picks
- * a wallet; `@pollar/react` wraps that into `client.loginWallet(id)`.
- */
-interface RenderWalletsProps {
-    /** Wrapper around `client.loginWallet(id)`. */
-    onConnect: (id: WalletId) => void;
-    /** Current auth state — picker can disable buttons / surface loading. */
-    authState: AuthState;
-}
-/**
- * Signature for the `ui.renderWallets` slot on `<PollarProvider>`. When
- * provided, replaces the default Freighter/Albedo buttons in the LoginModal
- * with whatever the slot returns (typically a kit-powered wallet grid).
- */
-type RenderWalletsSlot = (props: RenderWalletsProps) => ReactNode;
 interface LoginButtonProps {
     onSuccess?: () => void;
     onError?: (error: Error) => void;
@@ -36,7 +19,14 @@ interface AuthModalProps {
 }
 
 interface PollarContextValue {
-    walletAddress: string;
+    /**
+     * The authenticated user's wallet as a discriminated union over `custody`
+     * (`internal` | `smart` | `external`), or `null` when unauthenticated. Every
+     * field is meaningful for any login method — `custody` is always present and
+     * strictly determines the shape of `provider`. Use `wallet.address` for the
+     * on-chain address and `wallet.provider` for the wallet/login provider.
+     */
+    wallet: WalletInfo | null;
     getClient: () => PollarClient;
     openLoginModal: () => void;
     isAuthenticated: boolean;
@@ -53,8 +43,6 @@ interface PollarContextValue {
     openSessionsModal: () => void;
     appConfig: PollarConfig;
     styles: PollarStyles;
-    /** UI slot for wallet picker (forwarded from provider props). */
-    renderWallets?: RenderWalletsSlot;
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
@@ -66,7 +54,6 @@ interface PollarContextValue {
     buildAndSignAndSubmitTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<SubmitOutcome>;
     /** Alias of `buildAndSignAndSubmitTx`. */
     runTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<SubmitOutcome>;
-    walletType: WalletId | null;
     network: StellarNetwork;
     setNetwork: (network: StellarNetwork) => void;
     walletBalance: WalletBalanceState;
@@ -104,6 +91,20 @@ interface PollarContextValue {
     openWalletBalanceModal: () => void;
     openSendModal: () => void;
     openReceiveModal: () => void;
+    /**
+     * Quote an asset-to-asset swap across the requested venue(s). Read-only;
+     * returns quotes ranked best-first. Mirrors {@link PollarClient.getSwapQuote}.
+     */
+    getSwapQuote: (params: SwapQuoteParams) => Promise<SwapQuote[]>;
+    /**
+     * Execute a swap from a quote (establishes the buy-asset trustline first when
+     * needed). Drives the transaction state machine. Mirrors {@link PollarClient.swap}.
+     */
+    swap: (quote: SwapQuote, opts?: {
+        autoTrustline?: boolean;
+    }) => Promise<SubmitOutcome>;
+    /** Open the swap modal. */
+    openSwapModal: () => void;
     openDistributionRulesModal: () => void;
     adapters?: PollarAdapters;
 }
@@ -124,11 +125,6 @@ interface PollarProviderProps {
      * `/applications/config` on mount.
      */
     appConfig?: PollarConfig;
-    /** UI customization slots. */
-    ui?: {
-        /** Replaces the default Freighter/Albedo wallet picker. */
-        renderWallets?: RenderWalletsSlot;
-    };
     adapters?: PollarAdapters;
     /**
      * Notified when persistent storage silently degrades to in-memory mode
@@ -142,7 +138,7 @@ interface PollarProviderProps {
     onStorageDegrade?: OnStorageDegrade;
     children: ReactNode;
 }
-declare function PollarProvider({ client, appConfig: appConfigProp, ui, adapters, onStorageDegrade, children, }: PollarProviderProps): react_jsx_runtime.JSX.Element;
+declare function PollarProvider({ client, appConfig: appConfigProp, adapters, onStorageDegrade, children, }: PollarProviderProps): react_jsx_runtime.JSX.Element;
 declare function usePollar(): PollarContextValue;
 
 type WrappedAdapter<T extends PollarAdapter> = {
@@ -221,6 +217,11 @@ interface SendModalProps {
 }
 declare function SendModal({ onClose }: SendModalProps): react_jsx_runtime.JSX.Element;
 
+interface SwapModalProps {
+    onClose: () => void;
+}
+declare function SwapModal({ onClose }: SwapModalProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalProps {
     onClose: () => void;
 }
@@ -236,6 +237,14 @@ interface DistributionRulesModalProps {
 }
 declare function DistributionRulesModal({ onClose }: DistributionRulesModalProps): react_jsx_runtime.JSX.Element;
 
+type WalletAdapterEntry = {
+    id: WalletId;
+    meta: {
+        label: string;
+        iconUrl?: string;
+        group?: string;
+    };
+};
 interface LoginModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -252,6 +261,8 @@ interface LoginModalTemplateProps {
         github: boolean;
         apple: boolean;
     };
+    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, …). */
+    walletAdapters: WalletAdapterEntry[];
     appName: string;
     email?: string;
     onEmailChange?: (email: string) => void;
@@ -262,8 +273,6 @@ interface LoginModalTemplateProps {
     onLoginSmartWallet?: () => void;
     /** Create a new passkey + smart wallet (new user). */
     onCreateSmartWallet?: () => void;
-    /** Optional override for the wallet picker view. Defaults to a Freighter+Albedo list. */
-    renderWallets?: RenderWalletsSlot;
     authState: AuthState;
     codeInputKey?: number;
     onCodeSubmit?: (code: string) => void;
@@ -271,7 +280,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onWalletConnect, onLoginSmartWallet, onCreateSmartWallet, renderWallets, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, walletAdapters, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onWalletConnect, onLoginSmartWallet, onCreateSmartWallet, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 type KycStep = 'select_provider' | 'verifying' | 'polling' | 'done';
 interface KycModalTemplateProps {
@@ -289,7 +298,7 @@ interface KycModalTemplateProps {
 }
 declare function KycModalTemplate({ theme, accentColor, step, providers, selectedProvider, session, kycStatus, isLoading, onSelectProvider, onDoneVerifying, onClose, }: KycModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-type RampStep = 'input' | 'loading_quote' | 'select_route' | 'payment_instructions';
+type RampStep = 'input' | 'loading_quote' | 'select_route' | 'status' | 'error';
 interface RampWidgetTemplateProps {
     theme: string;
     accentColor: string;
@@ -299,18 +308,26 @@ interface RampWidgetTemplateProps {
     currency: string;
     country: string;
     quotes: RampQuote[];
-    paymentInstructions: PaymentInstructions | null;
     isLoading: boolean;
+    provider: string;
+    txStatus: RampTxStatus | null;
+    kycUrl: string | null;
+    stellarTxHash: string | null;
+    canComplete: boolean;
+    completing: boolean;
+    errorMsg: string | null;
     onDirectionChange: (d: RampDirection) => void;
     onAmountChange: (v: string) => void;
     onCurrencyChange: (v: string) => void;
     onCountryChange: (v: string) => void;
     onFindRoute: () => void;
     onSelectQuote: (q: RampQuote) => void;
-    onCopy: (value: string) => void;
+    onOpenKyc: () => void;
+    onCompleteWithdraw: () => void;
+    onRetry: () => void;
     onClose: () => void;
 }
-declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, quotes, paymentInstructions, isLoading, onDirectionChange, onAmountChange, onCurrencyChange, onCountryChange, onFindRoute, onSelectQuote, onCopy, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
+declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, quotes, isLoading, provider, txStatus, kycUrl, stellarTxHash, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onCurrencyChange, onCountryChange, onFindRoute, onSelectQuote, onOpenKyc, onCompleteWithdraw, onRetry, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface TransactionModalTemplateProps {
     theme: string;
@@ -411,6 +428,53 @@ interface SendModalTemplateProps {
 }
 declare function SendModalTemplate({ theme, accentColor, step, txTitle, assets, selectedAsset, amount, destination, formError, isLoadingBalance, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onSelectAsset, onAmountChange, onDestinationChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
 
+/** A selectable asset in the sell/buy pickers, normalized across balance/enabled records. */
+interface SwapAssetOption {
+    ref: SwapQuoteParams['sellAsset'];
+    code: string;
+    issuer?: string | undefined;
+    available?: string | undefined;
+    enabledInApp?: boolean | undefined;
+}
+interface SwapModalTemplateProps {
+    theme: string;
+    accentColor: string;
+    step: 'form' | 'tx';
+    txTitle: string;
+    sellOptions: SwapAssetOption[];
+    buyOptions: SwapAssetOption[];
+    selectedSell: SwapAssetOption | null;
+    selectedBuy: SwapAssetOption | null;
+    amount: string;
+    provider: SwapProvider;
+    providers: SwapProvider[];
+    quote: SwapQuote | null;
+    quoteLoading: boolean;
+    quoteError: string;
+    formError: string;
+    isLoadingData: boolean;
+    smartUnsupported: boolean;
+    transaction: TransactionState;
+    showXdr: boolean;
+    copied: boolean;
+    explorerUrl: string | null;
+    walletType?: WalletId | null | undefined;
+    showBack: boolean;
+    isInProgress: boolean;
+    onClose: () => void;
+    onBack: () => void;
+    onSelectSell: (o: SwapAssetOption) => void;
+    onSelectBuy: (o: SwapAssetOption) => void;
+    onAmountChange: (value: string) => void;
+    onProviderChange: (p: SwapProvider) => void;
+    onSwap: () => void;
+    onToggleXdr: () => void;
+    onCopyHash: () => void;
+    onRetry: () => void;
+    onDone: () => void;
+}
+declare function SwapModalTemplate({ theme, accentColor, step, txTitle, sellOptions, buyOptions, selectedSell, selectedBuy, amount, provider, providers, quote, quoteLoading, quoteError, formError, isLoadingData, smartUnsupported, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onSelectSell, onSelectBuy, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -447,4 +511,4 @@ interface DistributionRulesModalTemplateProps {
 }
 declare function DistributionRulesModalTemplate({ theme, accentColor, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, type RenderWalletsProps, type RenderWalletsSlot, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };
+export { type AuthModalProps, DistributionRulesModal, DistributionRulesModalTemplate, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type PollarConfig, PollarProvider, type PollarStyles, type RampStep, RampWidget, RampWidgetTemplate, ReceiveModal, ReceiveModalTemplate, type ReceiveModalTemplateProps, RouteDisplay, SendModal, SendModalTemplate, type SendModalTemplateProps, SessionsModal, SessionsModalTemplate, type SessionsModalTemplateProps, type SwapAssetOption, SwapModal, SwapModalTemplate, type SwapModalTemplateProps, TransactionModalTemplate, type TransactionModalTemplateProps, TxHistoryModalTemplate, TxStatusView, type TxStatusViewProps, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, createPollarAdapterHook, usePollar };