@pollar/react 0.10.0-rc.0 → 0.10.0-rc.10

package/dist/index.d.mts

@@ -1,46 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WalletId, AuthState, pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, 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';
+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;
-/**
- * Presentation metadata for a custom login provider button in the LoginModal
- * (e.g. Privy, Magic). Pairs with a {@link PollarAuthProvider} registered on the
- * client via its `providers` config: clicking the button calls
- * `client.login({ provider: id })`, and the provider opens its own UI.
- *
- * Logic (the actual login) lives in the `PollarAuthProvider`; this is only the
- * button's look. Keeping them separate means React never needs to know how a
- * provider authenticates.
- */
-interface CustomLoginProvider {
-    /** Must match the `id` of a registered `PollarAuthProvider`. */
-    id: string;
-    /** Button label, e.g. "Continue with Privy". */
-    label: string;
-    /** Optional icon URL rendered in the button. */
-    iconUrl?: string;
-}
 interface LoginButtonProps {
     onSuccess?: () => void;
     onError?: (error: Error) => void;
@@ -78,10 +43,6 @@ interface PollarContextValue {
     openSessionsModal: () => void;
     appConfig: PollarConfig;
     styles: PollarStyles;
-    /** UI slot for wallet picker (forwarded from provider props). */
-    renderWallets?: RenderWalletsSlot;
-    /** Custom login provider buttons (forwarded from `ui.customProviders`). */
-    customProviders?: CustomLoginProvider[];
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
@@ -130,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;
 }
@@ -150,17 +125,6 @@ interface PollarProviderProps {
      * `/applications/config` on mount.
      */
     appConfig?: PollarConfig;
-    /** UI customization slots. */
-    ui?: {
-        /** Replaces the default Freighter/Albedo wallet picker. */
-        renderWallets?: RenderWalletsSlot;
-        /**
-         * Custom login provider buttons (e.g. Privy) shown in the LoginModal. Each
-         * must match a {@link PollarAuthProvider} registered on the client; clicking
-         * one calls `client.login({ provider: id })` and the provider opens its own UI.
-         */
-        customProviders?: CustomLoginProvider[];
-    };
     adapters?: PollarAdapters;
     /**
      * Notified when persistent storage silently degrades to in-memory mode
@@ -174,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> = {
@@ -253,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;
 }
@@ -268,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;
@@ -284,22 +261,18 @@ interface LoginModalTemplateProps {
         github: boolean;
         apple: boolean;
     };
-    /** Custom login provider buttons (e.g. Privy). Each calls `onCustomLogin(id)`. */
-    customProviders?: CustomLoginProvider[];
+    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, …). */
+    walletAdapters: WalletAdapterEntry[];
     appName: string;
     email?: string;
     onEmailChange?: (email: string) => void;
     onEmailSubmit?: () => void;
     onSocialLogin?: (provider: 'google' | 'github') => void;
-    /** Triggers a custom provider login by id (wraps `client.login({ provider: id })`). */
-    onCustomLogin?: (id: string) => void;
     onWalletConnect?: (id: WalletId) => void;
     /** Log in with an existing passkey (returning user). */
     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;
@@ -307,7 +280,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, customProviders, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onCustomLogin, 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 {
@@ -325,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;
@@ -335,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;
@@ -447,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;
@@ -483,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, type CustomLoginProvider, 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,46 +1,11 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { WalletId, AuthState, pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, 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';
+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;
-/**
- * Presentation metadata for a custom login provider button in the LoginModal
- * (e.g. Privy, Magic). Pairs with a {@link PollarAuthProvider} registered on the
- * client via its `providers` config: clicking the button calls
- * `client.login({ provider: id })`, and the provider opens its own UI.
- *
- * Logic (the actual login) lives in the `PollarAuthProvider`; this is only the
- * button's look. Keeping them separate means React never needs to know how a
- * provider authenticates.
- */
-interface CustomLoginProvider {
-    /** Must match the `id` of a registered `PollarAuthProvider`. */
-    id: string;
-    /** Button label, e.g. "Continue with Privy". */
-    label: string;
-    /** Optional icon URL rendered in the button. */
-    iconUrl?: string;
-}
 interface LoginButtonProps {
     onSuccess?: () => void;
     onError?: (error: Error) => void;
@@ -78,10 +43,6 @@ interface PollarContextValue {
     openSessionsModal: () => void;
     appConfig: PollarConfig;
     styles: PollarStyles;
-    /** UI slot for wallet picker (forwarded from provider props). */
-    renderWallets?: RenderWalletsSlot;
-    /** Custom login provider buttons (forwarded from `ui.customProviders`). */
-    customProviders?: CustomLoginProvider[];
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
@@ -130,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;
 }
@@ -150,17 +125,6 @@ interface PollarProviderProps {
      * `/applications/config` on mount.
      */
     appConfig?: PollarConfig;
-    /** UI customization slots. */
-    ui?: {
-        /** Replaces the default Freighter/Albedo wallet picker. */
-        renderWallets?: RenderWalletsSlot;
-        /**
-         * Custom login provider buttons (e.g. Privy) shown in the LoginModal. Each
-         * must match a {@link PollarAuthProvider} registered on the client; clicking
-         * one calls `client.login({ provider: id })` and the provider opens its own UI.
-         */
-        customProviders?: CustomLoginProvider[];
-    };
     adapters?: PollarAdapters;
     /**
      * Notified when persistent storage silently degrades to in-memory mode
@@ -174,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> = {
@@ -253,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;
 }
@@ -268,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;
@@ -284,22 +261,18 @@ interface LoginModalTemplateProps {
         github: boolean;
         apple: boolean;
     };
-    /** Custom login provider buttons (e.g. Privy). Each calls `onCustomLogin(id)`. */
-    customProviders?: CustomLoginProvider[];
+    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, …). */
+    walletAdapters: WalletAdapterEntry[];
     appName: string;
     email?: string;
     onEmailChange?: (email: string) => void;
     onEmailSubmit?: () => void;
     onSocialLogin?: (provider: 'google' | 'github') => void;
-    /** Triggers a custom provider login by id (wraps `client.login({ provider: id })`). */
-    onCustomLogin?: (id: string) => void;
     onWalletConnect?: (id: WalletId) => void;
     /** Log in with an existing passkey (returning user). */
     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;
@@ -307,7 +280,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, customProviders, appName, email, onEmailChange, onEmailSubmit, onSocialLogin, onCustomLogin, 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 {
@@ -325,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;
@@ -335,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;
@@ -447,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;
@@ -483,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, type CustomLoginProvider, 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 };