@pollar/react 0.11.1 → 0.11.3-rc.1

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, WalletId, WalletChain, KycStatus as KycStatus$1, RampQuote, 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'];
@@ -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;
     /**
@@ -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 {
@@ -339,9 +370,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 +418,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 +475,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;
@@ -426,12 +509,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 +528,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. */
@@ -456,12 +541,35 @@ interface RampFieldSpec {
     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 +585,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 +606,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 +631,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,18 +650,28 @@ 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. */
+    chains: WalletChain[];
+    selectedChain: WalletChain | null;
+    /** Address of the wallet on {@link selectedChain}. */
+    walletAddress: string;
+    onSelectChain: (chain: WalletChain) => void;
     onRefresh: () => void;
     onPrev: () => void;
     onNext: () => void;
     onClose: () => void;
 }
-declare function TxHistoryModalTemplate({ theme, accentColor, txHistory, offset, 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;
@@ -557,11 +684,13 @@ interface WalletBalanceModalTemplateProps {
     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;
@@ -577,10 +706,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;
@@ -595,6 +726,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[];
@@ -631,7 +764,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 {
@@ -644,6 +777,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[];
@@ -687,11 +822,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. */
@@ -702,11 +839,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;
@@ -715,11 +854,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>;
@@ -728,6 +869,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 };