@pollar/react 0.11.2 → 0.11.3

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, SendPaymentParams, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, WalletId, WalletChain, KycStatus as KycStatus$1, RampQuote, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampTxStatus, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
+import { pollarPaths, PollarClient, PollarClientConfig, PollarAdapters, OnStorageDegrade, WalletInfo, PollarLoginOptions, SessionsState, TransactionState, TxBuildBody, BuildOutcome, SubmitOutcome, SignOutcome, SendPaymentParams, StellarNetwork, WalletBalanceState, EnabledAssetsState, TrustlineOutcome, TxHistoryState, SwapVenue, SwapToken, SwapQuoteParams, SwapQuote, EarnProviderId, EarnOpportunity, EarnPositionParams, EarnPosition, EarnTxParams, PollarAdapter, PasskeyCeremony, PasskeySigner, WalletChain, KycStatus as KycStatus$1, RampQuote, WalletId, AuthState, KycProvider, KycStartResponse, RampDirection, RampCountry, RampTxStatus, RampDepositInstructions, EnabledAssetRecord, WalletBalanceRecord, SwapProvider, DistributionRulesState, DistributionRule } from '@pollar/core';
 export { AuthProviderContext, PollarAuthProvider, SessionsState } from '@pollar/core';
-import { ReactNode } from 'react';
+import { ReactNode, CSSProperties } from 'react';
 
 type ConfigResponse = pollarPaths['/applications/config']['get']['responses'][200]['content']['application/json'];
 type PollarConfig = ConfigResponse['content'];
@@ -22,13 +22,13 @@ interface PollarContextValue {
     /**
      * 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
+     * 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;
     /**
-     * Every wallet the user holds, one per chain — a superset of {@link wallet},
+     * Every wallet the user holds, one per chain - a superset of {@link wallet},
      * with `chain` populated. `[]` when unauthenticated. Drives the network
      * selector in the Send / Wallet Balance / Assets modals: each entry is a
      * network the user can switch to, and the first one is the default.
@@ -40,7 +40,7 @@ interface PollarContextValue {
     /**
      * `true` once the server has confirmed the session (login / refresh /
      * `/auth/session/resume`). `false` while a cold-start session is still
-     * optimistic — gate sensitive actions (e.g. signing) on this.
+     * optimistic - gate sensitive actions (e.g. signing) on this.
      */
     verified: boolean;
     login: (options: PollarLoginOptions) => void;
@@ -52,7 +52,7 @@ interface PollarContextValue {
     styles: PollarStyles;
     /** Remote app-config load state. 'loading' while the initial fetch is in
      *  flight, 'error' if it failed (styles fall back to empty defaults), 'ready'
-     *  once resolved — or immediately 'ready' when `appConfig` is passed as a prop.
+     *  once resolved - or immediately 'ready' when `appConfig` is passed as a prop.
      *  The login modal shows a spinner/retry instead of an empty shell until this
      *  is 'ready'. */
     configStatus: 'loading' | 'ready' | 'error';
@@ -66,7 +66,7 @@ interface PollarContextValue {
     /** External-wallet only. Custodial flows should use `signAndSubmitTx`. */
     signTx: (unsignedXdr: string) => Promise<SignOutcome>;
     submitTx: (signedXdr: string) => Promise<SubmitOutcome>;
-    /** One-shot: build → sign → submit. Drives the same TransactionState flow as the split calls. */
+    /** One-shot: build -> sign -> submit. Drives the same TransactionState flow as the split calls. */
     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>;
@@ -176,6 +176,11 @@ interface PollarProviderProps {
      *
      * The client is locked at first render: changing this prop afterwards is
      * ignored. To swap clients, unmount and remount the provider.
+     *
+     * Either form gets the web passkey ceremony installed (a pre-built instance
+     * is filled in via `setPasskeyDefaults`), so the "Smart Wallet" login works
+     * without the consumer wiring WebAuthn. A ceremony you configured yourself is
+     * always kept.
      */
     client: PollarClient | PollarClientConfig;
     /**
@@ -189,13 +194,13 @@ interface PollarProviderProps {
      * bypass the type anyway (plain JS, or a cast), each missing field lands on a
      * default scattered across the components rather than on anything central:
      *
-     *   chains       absent → the chain order/filter falls back to the order the
+     *   chains       absent -> the chain order/filter falls back to the order the
      *                         session listed the user's wallets in (see useChains)
-     *   name         absent → 'Pollar'
-     *   theme        absent → 'light'
-     *   accentColor  absent → '#005DB4'
+     *   name         absent -> 'Pollar'
+     *   theme        absent -> 'light'
+     *   accentColor  absent -> '#005DB4'
      *   emailEnabled, providers, embeddedWallets, smartWallet
-     *                absent → false. NOTE: that means EVERY login method is off
+     *                absent -> false. NOTE: that means EVERY login method is off
      *                         and the login modal renders with no way in.
      *
      * Leave this `undefined` to have the SDK fetch `/applications/config` on
@@ -225,6 +230,32 @@ type WrappedAdapter<T extends PollarAdapter> = {
 };
 declare function createPollarAdapterHook<T extends PollarAdapter>(key: string): () => WrappedAdapter<T>;
 
+/**
+ * Browser passkey ceremony for the smart-wallet flow.
+ *
+ * `mode` is set explicitly by the caller's button, so there's no ambiguous
+ * autodetect:
+ *   - `'login'`    -> `get()` only (returning user - the OS shows the account
+ *                    picker for discoverable credentials on this domain). A
+ *                    failure here is surfaced as-is; it never falls through to
+ *                    registration, so cancelling the prompt can't accidentally
+ *                    create a second wallet.
+ *   - `'register'` -> `create()` only (new user -> the server deploys the
+ *                    C-address).
+ *
+ * rpId = the current page's hostname (the customer app's domain), which is what
+ * the passkey is bound to - the anti-phishing guarantee.
+ */
+declare const browserPasskeyCeremony: PasskeyCeremony;
+/**
+ * Browser passkey signer for smart-wallet transactions. Runs a WebAuthn `get()`
+ * whose challenge is the raw auth digest (the on-chain verifier checks
+ * clientDataJSON.challenge === base64url(digest)), and returns the public
+ * assertion fields (base64url) for the server to assemble into the Soroban auth
+ * entry. The secp256r1 key never leaves the device.
+ */
+declare const browserPasskeySigner: PasskeySigner;
+
 declare function WalletButton(): react_jsx_runtime.JSX.Element;
 
 interface WalletButtonTemplateProps {
@@ -237,7 +268,6 @@ interface WalletButtonTemplateProps {
     itemColor: string;
     wrapperRef: React.RefObject<HTMLDivElement>;
     isInProgress: boolean;
-    walletType: WalletId | null;
     /** Show the "Create account" action (external wallet not yet on-chain, IMMEDIATE funding). */
     showCreateAccount: boolean;
     creatingAccount: boolean;
@@ -264,7 +294,7 @@ declare function WalletButtonTemplate({ walletAddress, accentColor, open, copied
  */
 declare function resolveChain(chain: WalletChain | undefined): WalletChain;
 /**
- * The selectable chains — the first is the default everywhere (network picker,
+ * The selectable chains - the first is the default everywhere (network picker,
  * the address the wallet button shows). De-duplicated because two wallets on one
  * chain (e.g. a custodial and a linked external Stellar wallet) are still one
  * network choice.
@@ -339,9 +369,13 @@ declare function RampWidget({ onClose }: RampWidgetProps): react_jsx_runtime.JSX
 
 interface RouteDisplayProps {
     quote: RampQuote;
+    /** This route is the one being started - it owns the in-flight request. */
+    busy?: boolean;
+    /** Another route is starting, so this one is not selectable meanwhile. */
+    disabled?: boolean;
     onSelect: (quote: RampQuote) => void;
 }
-declare function RouteDisplay({ quote, onSelect }: RouteDisplayProps): react_jsx_runtime.JSX.Element;
+declare function RouteDisplay({ quote, busy, disabled, onSelect }: RouteDisplayProps): react_jsx_runtime.JSX.Element;
 
 interface WalletBalanceModalProps {
     onClose: () => void;
@@ -383,6 +417,52 @@ interface DistributionRulesModalProps {
 }
 declare function DistributionRulesModal({ onClose }: DistributionRulesModalProps): react_jsx_runtime.JSX.Element;
 
+/** Per-app overrides for the modal chrome, configured in the dashboard's
+ *  Branding screen. Every field is optional: absent means "use the value the
+ *  theme derives", which is what every modal rendered before these existed. */
+interface ModalStyleOverrides {
+    /** Card background. Overrides the theme's white / #1a1a1a. */
+    backgroundColor?: string | null | undefined;
+    /** Body text. Overrides the theme's #111827 / white. Secondary ("muted") text
+     *  keeps its theme color, so the two stay distinguishable. */
+    textColor?: string | null | undefined;
+    /** Fill of the SECONDARY buttons (the wallet / social / provider entries, the
+     *  retry button). The primary button is the accent's job. Unset => the theme's
+     *  own surface color, which is what these buttons always used. */
+    buttonColor?: string | null | undefined;
+    /** Radius of the modal card itself, in px. */
+    modalBorderRadius?: number | null | undefined;
+    /** Radius of the buttons inside the modal, in px. Independent of the card's. */
+    buttonBorderRadius?: number | null | undefined;
+}
+/** Text color that stays legible on `background`. The primary button's label was
+ *  hardcoded white, which a light fill (the Amber accent preset, say) turns
+ *  invisible - so it follows the fill's luminance instead. Unparseable colors
+ *  keep white, the pre-existing behavior. */
+declare function readableTextOn(background: string): string;
+/** How much room a modal gives its header. 'hero' is the identity-forward set
+ *  (login, KYC, ramp, the Privy sub-modal): roomier padding and a larger
+ *  centered heading. 'compact' is every utility modal (send, balance, history,
+ *  ...), which keeps the card's own 1.75rem padding. */
+type ModalVariant = 'hero' | 'compact';
+/** Theme-derived CSS custom properties shared by every Pollar modal, plus the
+ *  per-app overrides on top. One definition so the whole modal family stays
+ *  visually in lockstep - a var added here reaches all of them at once. */
+declare function buildModalCssVars(theme: string, accentColor: string, overrides?: ModalStyleOverrides, variant?: ModalVariant): CSSProperties;
+/** Everything a modal wrapper needs to dress itself from the app's branding:
+ *  the theme pair its template already took, the overrides to forward to that
+ *  template, and the inline style for the fixed overlay behind it. */
+interface ModalChrome {
+    theme: string;
+    accentColor: string;
+    styleOverrides: ModalStyleOverrides;
+    overlayStyle: CSSProperties;
+}
+/** Resolve the branding config into the props/styles a modal wrapper applies.
+ *  Called by every `.pollar-overlay` renderer so the z-index and the card
+ *  overrides can't drift apart between modals. */
+declare function modalChrome(styles: PollarStyles): ModalChrome;
+
 type WalletAdapterEntry = {
     id: WalletId;
     meta: {
@@ -394,6 +474,8 @@ type WalletAdapterEntry = {
 interface LoginModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     logoUrl: string | null;
     emailEnabled: boolean;
     embeddedWallets: boolean;
@@ -407,7 +489,7 @@ interface LoginModalTemplateProps {
         github: boolean;
         apple: boolean;
     };
-    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, …). */
+    /** Registered wallet adapters to render as buttons (Freighter, Albedo, Privy, ...). */
     walletAdapters: WalletAdapterEntry[];
     appName: string;
     email?: string;
@@ -426,12 +508,14 @@ 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, authState, codeInputKey, onCodeSubmit, onBack, onCancel, onRetry, }: LoginModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function LoginModalTemplate({ theme, accentColor, styleOverrides, 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 {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     step: KycStep;
     providers: KycProvider[];
     selectedProvider: KycProvider | null;
@@ -443,7 +527,7 @@ interface KycModalTemplateProps {
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function KycModalTemplate({ theme, accentColor, step, providers, selectedProvider, session, kycStatus, isLoading, onSelectProvider, onDoneVerifying, onRefresh, onClose, }: KycModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function KycModalTemplate({ theme, accentColor, styleOverrides, step, providers, selectedProvider, session, kycStatus, isLoading, onSelectProvider, onDoneVerifying, onRefresh, onClose, }: KycModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 type RampStep = 'input' | 'loading_quote' | 'select_route' | 'contact' | 'status' | 'error';
 /** A field a provider declares (via the quote) that the client must collect. */
@@ -452,16 +536,39 @@ interface RampFieldSpec {
     label: string;
     type: 'text' | 'email' | 'tel' | 'select';
     bankType?: 'CLABE' | 'PIX' | 'PSE' | 'ACH' | 'BREB';
-    /** For `type: 'select'` — dropdown choices (e.g. Stereum's Bolivian banks). */
+    /** For `type: 'select'` - dropdown choices (e.g. Stereum's Bolivian banks). */
     options?: {
         value: string;
         label: string;
+        placeholder?: string;
     }[];
+    /** Declared but not mandatory (Abroad's tax id). Blank must not block Continue. */
+    optional?: boolean;
+    /** Example of the expected shape, for formats a user cannot guess. */
+    placeholder?: string;
+    /**
+     * Key of a sibling `select` whose chosen option supplies the placeholder. One
+     * Pix field can then show a CPF mask, an email or a +55 number as the user
+     * switches kind, without this component knowing what a Pix key is.
+     */
+    placeholderFrom?: string;
+    /** Secondary line under the field, for a rule the label has no room for. */
+    hint?: string;
 }
 interface RampWidgetTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     step: RampStep;
+    /** Labels of the steps this run goes through. Length varies by route: only
+     *  providers that collect fields add a 'Details' step. */
+    flowSteps: string[];
+    /** Index into `flowSteps`, or -1 when the current step is outside the flow
+     *  (the error step) and the progress bar should be hidden. */
+    flowStepIndex: number;
+    /** Quote whose start request is in flight, so its row can show it. */
+    startingQuoteId: string | null;
     direction: RampDirection;
     amount: string;
     currency: string;
@@ -477,10 +584,14 @@ interface RampWidgetTemplateProps {
     txStatus: RampTxStatus | null;
     kycUrl: string | null;
     tosUrl: string | null;
+    /** Provider gated the flow on KYC and published no link; nothing was signed. */
+    kycBlocking: boolean;
+    /** The gate has since cleared - the user needs a fresh quote to continue. */
+    kycJustApproved: boolean;
     stellarTxHash: string | null;
     /** Stellar Expert URL for `stellarTxHash` (network-aware); null when unknown. */
     explorerUrl: string | null;
-    depositInstructions: Record<string, unknown> | null;
+    depositInstructions: RampDepositInstructions | null;
     canComplete: boolean;
     completing: boolean;
     errorMsg: string | null;
@@ -494,15 +605,20 @@ interface RampWidgetTemplateProps {
     onOpenKyc: () => void;
     onOpenTos: () => void;
     onCompleteWithdraw: () => void;
+    /** Step back to the amount, keeping what was entered. Distinct from `onRetry`
+     *  (which restarts a failed flow) so a "Back" button reads as navigation. */
+    onBack: () => void;
     onRetry: () => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function RampWidgetTemplate({ theme, accentColor, step, direction, amount, currency, country, requiredFields, fieldValues, countries, countriesLoading, refreshing, quotes, isLoading, provider, txStatus, kycUrl, tosUrl, stellarTxHash, explorerUrl, depositInstructions, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onFieldChange, onCountryChange, onFindRoute, onSelectQuote, onContactContinue, onOpenKyc, onOpenTos, onCompleteWithdraw, onRetry, onRefresh, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
+declare function RampWidgetTemplate({ theme, accentColor, styleOverrides, step, flowSteps, flowStepIndex, startingQuoteId, direction, amount, currency, country, requiredFields, fieldValues, countries, countriesLoading, refreshing, quotes, isLoading, provider, txStatus, kycUrl, tosUrl, kycBlocking, kycJustApproved, stellarTxHash, explorerUrl, depositInstructions, canComplete, completing, errorMsg, onDirectionChange, onAmountChange, onFieldChange, onCountryChange, onFindRoute, onSelectQuote, onContactContinue, onOpenKyc, onOpenTos, onCompleteWithdraw, onBack, onRetry, onRefresh, onClose, }: RampWidgetTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface TransactionModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     transaction: TransactionState;
     showXdr: boolean;
     copied: boolean;
@@ -514,7 +630,7 @@ interface TransactionModalTemplateProps {
     onCopyHash: () => void;
     onRetry?: () => void;
 }
-declare function TransactionModalTemplate({ theme, accentColor, transaction, showXdr, copied, explorerUrl, walletType, onClose, onSignAndSend, onToggleXdr, onCopyHash, onRetry, }: TransactionModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function TransactionModalTemplate({ theme, accentColor, styleOverrides, transaction, showXdr, copied, explorerUrl, walletType, onClose, onSignAndSend, onToggleXdr, onCopyHash, onRetry, }: TransactionModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface TxStatusViewProps {
     transaction: TransactionState;
@@ -533,6 +649,8 @@ declare function TxStatusView({ transaction, showXdr, copied, explorerUrl, walle
 interface TxHistoryModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     txHistory: TxHistoryState;
     offset: number;
     /** Networks the user holds a wallet on; the first one is the default. */
@@ -546,28 +664,32 @@ interface TxHistoryModalTemplateProps {
     onNext: () => void;
     onClose: () => void;
 }
-declare function TxHistoryModalTemplate({ theme, accentColor, txHistory, offset, chains, selectedChain, walletAddress, onSelectChain, onRefresh, onPrev, onNext, onClose, }: TxHistoryModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function TxHistoryModalTemplate({ theme, accentColor, styleOverrides, txHistory, offset, chains, selectedChain, walletAddress, onSelectChain, onRefresh, onPrev, onNext, onClose, }: TxHistoryModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface WalletBalanceModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     walletBalance: WalletBalanceState;
     /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
     /** Networks the user holds a wallet on; the first one is the default. */
     chains: WalletChain[];
     selectedChain: WalletChain | null;
-    /** testnet vs mainnet — gates the Solana devnet faucet hint. */
+    /** testnet vs mainnet - gates the Solana devnet faucet hint. */
     network: StellarNetwork;
     onSelectChain: (chain: WalletChain) => void;
     onRefresh: () => void;
     onClose: () => void;
 }
-declare function WalletBalanceModalTemplate({ theme, accentColor, walletBalance, walletAddress, chains, selectedChain, network, onSelectChain, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function WalletBalanceModalTemplate({ theme, accentColor, styleOverrides, walletBalance, walletAddress, chains, selectedChain, network, onSelectChain, onRefresh, onClose, }: WalletBalanceModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface EnabledAssetsModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     enabledAssets: EnabledAssetsState;
     /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
@@ -583,10 +705,12 @@ interface EnabledAssetsModalTemplateProps {
     onToggleTrustline: (record: EnabledAssetRecord) => void;
     onAddCustom: () => void;
 }
-declare function EnabledAssetsModalTemplate({ theme, accentColor, enabledAssets, walletAddress, chains, selectedChain, onSelectChain, busyKey, actionError, onRefresh, onClose, onToggleTrustline, onAddCustom, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function EnabledAssetsModalTemplate({ theme, accentColor, styleOverrides, enabledAssets, walletAddress, chains, selectedChain, onSelectChain, busyKey, actionError, onRefresh, onClose, onToggleTrustline, onAddCustom, }: EnabledAssetsModalTemplateProps): react_jsx_runtime.JSX.Element;
 interface CustomTrustlineModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     busy: boolean;
     actionError: string | null;
     onBack: () => void;
@@ -601,6 +725,8 @@ interface CustomTrustlineModalTemplateProps {
 interface SendModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     step: 'form' | 'tx';
     txTitle: string;
     assets: WalletBalanceRecord[];
@@ -637,7 +763,7 @@ interface SendModalTemplateProps {
     onRetry: () => void;
     onDone: () => void;
 }
-declare function SendModalTemplate({ theme, accentColor, step, txTitle, assets, selectedAsset, chains, selectedChain, walletAddress, canSendOnChain, onSelectChain, amount, destination, formError, isLoadingBalance, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, onSelectAsset, onAmountChange, onDestinationChange, onSubmit, onSignAndSend, onToggleXdr, onCopyHash, onRetry, onDone, }: SendModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function SendModalTemplate({ theme, accentColor, styleOverrides, step, txTitle, assets, selectedAsset, chains, selectedChain, walletAddress, canSendOnChain, onSelectChain, amount, destination, formError, isLoadingBalance, transaction, showXdr, copied, explorerUrl, walletType, showBack, isInProgress, onClose, onBack, onRefresh, 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 {
@@ -650,6 +776,8 @@ interface SwapAssetOption {
 interface SwapModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     step: 'form' | 'tx';
     txTitle: string;
     sellOptions: SwapAssetOption[];
@@ -667,7 +795,7 @@ interface SwapModalTemplateProps {
     smartUnsupported: boolean;
     /** Swap config is still loading. */
     configLoading: boolean;
-    /** Config loaded and this app exposes no swap venues — swap is disabled. */
+    /** 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;
@@ -693,11 +821,13 @@ interface SwapModalTemplateProps {
     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, onAddCustomToken, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function SwapModalTemplate({ theme, accentColor, styleOverrides, 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, onAddCustomToken, onAmountChange, onProviderChange, onSwap, onToggleXdr, onCopyHash, onRetry, onDone, }: SwapModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface ReceiveModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     /** Address of the wallet on {@link selectedChain}. */
     walletAddress: string;
     /** Networks the user holds a wallet on; the first one is the default. */
@@ -708,11 +838,13 @@ interface ReceiveModalTemplateProps {
     onCopy: () => void;
     onClose: () => void;
 }
-declare function ReceiveModalTemplate({ theme, accentColor, walletAddress, chains, selectedChain, onSelectChain, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function ReceiveModalTemplate({ theme, accentColor, styleOverrides, walletAddress, chains, selectedChain, onSelectChain, copied, onCopy, onClose, }: ReceiveModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface SessionsModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     state: SessionsState;
     revokingFamilyId: string | null;
     signingOutEverywhere: boolean;
@@ -721,11 +853,13 @@ interface SessionsModalTemplateProps {
     onLogoutEverywhere: () => void;
     onClose: () => void;
 }
-declare function SessionsModalTemplate({ theme, accentColor, state, revokingFamilyId, signingOutEverywhere, onRefresh, onRevoke, onLogoutEverywhere, onClose, }: SessionsModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function SessionsModalTemplate({ theme, accentColor, styleOverrides, state, revokingFamilyId, signingOutEverywhere, onRefresh, onRevoke, onLogoutEverywhere, onClose, }: SessionsModalTemplateProps): react_jsx_runtime.JSX.Element;
 
 interface DistributionRulesModalTemplateProps {
     theme: string;
     accentColor: string;
+    /** Per-app modal chrome overrides (background, card + button radius). */
+    styleOverrides?: ModalStyleOverrides;
     state: DistributionRulesState;
     claimingId: string | null;
     claimErrors: Record<string, string>;
@@ -734,6 +868,6 @@ interface DistributionRulesModalTemplateProps {
     onClaim: (rule: DistributionRule) => void;
     onClose: () => void;
 }
-declare function DistributionRulesModalTemplate({ theme, accentColor, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
+declare function DistributionRulesModalTemplate({ theme, accentColor, styleOverrides, state, claimingId, claimErrors, claimedIds, onRefresh, onClaim, onClose, }: DistributionRulesModalTemplateProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthModalProps, ChainSelect, type ChainSelectProps, type CustomTrustlineModalTemplateProps, DistributionRulesModal, DistributionRulesModalTemplate, EarnModal, 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, type UseChainsResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, chainsOf, createPollarAdapterHook, resolveChain, useChains, usePollar };
+export { type AuthModalProps, ChainSelect, type ChainSelectProps, type CustomTrustlineModalTemplateProps, DistributionRulesModal, DistributionRulesModalTemplate, EarnModal, EnabledAssetsModal, EnabledAssetsModalTemplate, type EnabledAssetsModalTemplateProps, KycModal, KycModalTemplate, KycStatus, type KycStep, type LoginButtonProps, LoginModalTemplate, type ModalChrome, type ModalStyleOverrides, type ModalVariant, 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, type UseChainsResult, WalletBalanceModal, WalletBalanceModalTemplate, type WalletBalanceModalTemplateProps, WalletButton, WalletButtonTemplate, type WalletButtonTemplateProps, addressForChain, browserPasskeyCeremony, browserPasskeySigner, buildModalCssVars, chainsOf, createPollarAdapterHook, modalChrome, readableTextOn, resolveChain, useChains, usePollar };