@pollar/react 0.10.0-rc.8 → 0.10.1-rc.0

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, 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, SwapVenue, SwapToken, 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.login({ provider: id })`.
- */
-interface RenderWalletsProps {
-    /** Wrapper around `client.login({ provider: 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;
@@ -60,8 +43,6 @@ interface PollarContextValue {
     openSessionsModal: () => void;
     appConfig: PollarConfig;
     styles: PollarStyles;
-    /** UI slot overriding the per-adapter wallet button list (forwarded from provider props). */
-    renderWallets?: RenderWalletsSlot;
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
@@ -110,6 +91,30 @@ interface PollarContextValue {
     openWalletBalanceModal: () => void;
     openSendModal: () => void;
     openReceiveModal: () => void;
+    /**
+     * The swap venues this app exposes to end-users (empty = swap disabled, hide
+     * swap UI). Mirrors {@link PollarClient.getSwapConfig}.
+     */
+    getSwapConfig: () => Promise<SwapVenue[]>;
+    /**
+     * The curated "buy" tokens this app opted into (admin catalog). Mirrors
+     * {@link PollarClient.getSwapTokens}.
+     */
+    getSwapTokens: () => Promise<SwapToken[]>;
+    /**
+     * 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;
 }
@@ -130,11 +135,6 @@ interface PollarProviderProps {
      * `/applications/config` on mount.
      */
     appConfig?: PollarConfig;
-    /** UI customization slots. */
-    ui?: {
-        /** Replaces the default per-adapter wallet button list with a custom picker. */
-        renderWallets?: RenderWalletsSlot;
-    };
     adapters?: PollarAdapters;
     /**
      * Notified when persistent storage silently degrades to in-memory mode
@@ -148,7 +148,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> = {
@@ -227,6 +227,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;
 }
@@ -247,6 +252,7 @@ type WalletAdapterEntry = {
     meta: {
         label: string;
         iconUrl?: string;
+        group?: string;
     };
 };
 interface LoginModalTemplateProps {
@@ -277,8 +283,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;
@@ -286,7 +290,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, walletAdapters, 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 {
@@ -304,7 +308,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;
@@ -314,18 +318,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;
@@ -426,6 +438,60 @@ 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;
+    /** Swap config is still loading. */
+    configLoading: boolean;
+    /** Config loaded and this app exposes no swap venues — swap is disabled. */
+    swapUnavailable: boolean;
+    /** Buying the selected asset will create a trustline first (~0.5 XLM reserve). */
+    buyNeedsTrustline: boolean;
+    transaction: TransactionState;
+    showXdr: boolean;
+    copied: boolean;
+    explorerUrl: string | null;
+    walletType?: WalletId | null | undefined;
+    showBack: boolean;
+    isInProgress: boolean;
+    onClose: () => void;
+    onBack: () => void;
+    onRefresh: () => 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, configLoading, swapUnavailable, buyNeedsTrustline, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectSell, onSelectBuy, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -462,4 +528,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, 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, SwapVenue, SwapToken, 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.login({ provider: id })`.
- */
-interface RenderWalletsProps {
-    /** Wrapper around `client.login({ provider: 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;
@@ -60,8 +43,6 @@ interface PollarContextValue {
     openSessionsModal: () => void;
     appConfig: PollarConfig;
     styles: PollarStyles;
-    /** UI slot overriding the per-adapter wallet button list (forwarded from provider props). */
-    renderWallets?: RenderWalletsSlot;
     openTxModal: () => void;
     tx: TransactionState;
     buildTx: (operation: TxBuildBody['operation'], params: TxBuildBody['params'], options?: TxBuildBody['options']) => Promise<BuildOutcome>;
@@ -110,6 +91,30 @@ interface PollarContextValue {
     openWalletBalanceModal: () => void;
     openSendModal: () => void;
     openReceiveModal: () => void;
+    /**
+     * The swap venues this app exposes to end-users (empty = swap disabled, hide
+     * swap UI). Mirrors {@link PollarClient.getSwapConfig}.
+     */
+    getSwapConfig: () => Promise<SwapVenue[]>;
+    /**
+     * The curated "buy" tokens this app opted into (admin catalog). Mirrors
+     * {@link PollarClient.getSwapTokens}.
+     */
+    getSwapTokens: () => Promise<SwapToken[]>;
+    /**
+     * 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;
 }
@@ -130,11 +135,6 @@ interface PollarProviderProps {
      * `/applications/config` on mount.
      */
     appConfig?: PollarConfig;
-    /** UI customization slots. */
-    ui?: {
-        /** Replaces the default per-adapter wallet button list with a custom picker. */
-        renderWallets?: RenderWalletsSlot;
-    };
     adapters?: PollarAdapters;
     /**
      * Notified when persistent storage silently degrades to in-memory mode
@@ -148,7 +148,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> = {
@@ -227,6 +227,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;
 }
@@ -247,6 +252,7 @@ type WalletAdapterEntry = {
     meta: {
         label: string;
         iconUrl?: string;
+        group?: string;
     };
 };
 interface LoginModalTemplateProps {
@@ -277,8 +283,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;
@@ -286,7 +290,7 @@ interface LoginModalTemplateProps {
     onCancel: () => void;
     onRetry: () => void;
 }
-declare function LoginModalTemplate({ theme, accentColor, logoUrl, emailEnabled, embeddedWallets, smartWallet, providers, walletAdapters, 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 {
@@ -304,7 +308,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;
@@ -314,18 +318,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;
@@ -426,6 +438,60 @@ 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;
+    /** Swap config is still loading. */
+    configLoading: boolean;
+    /** Config loaded and this app exposes no swap venues — swap is disabled. */
+    swapUnavailable: boolean;
+    /** Buying the selected asset will create a trustline first (~0.5 XLM reserve). */
+    buyNeedsTrustline: boolean;
+    transaction: TransactionState;
+    showXdr: boolean;
+    copied: boolean;
+    explorerUrl: string | null;
+    walletType?: WalletId | null | undefined;
+    showBack: boolean;
+    isInProgress: boolean;
+    onClose: () => void;
+    onBack: () => void;
+    onRefresh: () => 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, configLoading, swapUnavailable, buyNeedsTrustline, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectSell, onSelectBuy, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
+
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
@@ -462,4 +528,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 };