@agg-build/ui 1.0.0

package/dist/trading.mjs

@@ -0,0 +1,49 @@
+"use client";
+import {
+  PlaceOrder,
+  PlaceOrderFailureView,
+  PlaceOrderSuccessView,
+  Settlement,
+  SettlementDetails,
+  defaultSettlementDifferencesTitle,
+  defaultSettlementSectionLabel,
+  defaultTradingDisclaimer,
+  getTradingAveragePriceLabel,
+  getTradingBalanceLabel,
+  getTradingDateLabel,
+  getTradingPriceLabel,
+  getTradingSharesLabel,
+  getTradingSlippageLabel,
+  getTradingValueLabel,
+  getTradingVenueLabel,
+  mapVenueMarketsToSettlementSections,
+  parseAmount,
+  parseVenue
+} from "./chunk-CGNDMLQL.mjs";
+import {
+  useEventTradingContext
+} from "./chunk-C7T56TJR.mjs";
+import "./chunk-2QJXRRYP.mjs";
+import "./chunk-6NS7D73S.mjs";
+export {
+  PlaceOrder,
+  PlaceOrderFailureView,
+  PlaceOrderSuccessView,
+  Settlement,
+  SettlementDetails,
+  defaultSettlementDifferencesTitle,
+  defaultSettlementSectionLabel,
+  defaultTradingDisclaimer,
+  getTradingAveragePriceLabel,
+  getTradingBalanceLabel,
+  getTradingDateLabel,
+  getTradingPriceLabel,
+  getTradingSharesLabel,
+  getTradingSlippageLabel,
+  getTradingValueLabel,
+  getTradingVenueLabel,
+  mapVenueMarketsToSettlementSections,
+  parseAmount,
+  parseVenue,
+  useEventTradingContext
+};

package/dist/types/auth/connect-button-view/connect-button-view.constants.d.mts

@@ -0,0 +1,30 @@
+export declare const connectButtonContainerClassName: string;
+export declare const authNoticeClassName: string;
+export declare const authErrorClassName: string;
+export declare const authModalContainerClassName: string;
+export declare const authModalBodyClassName: string;
+export declare const authSectionClassName: string;
+export declare const authSectionHeadingClassName: string;
+export declare const authMethodsListClassName: string;
+export declare const authInputFormClassName: string;
+export declare const authInputFieldClassName: string;
+export declare const authPrimaryActionClassName: string;
+export declare const authMethodGridClassName: string;
+export declare const authWalletMethodGridClassName: string;
+export declare const authSocialButtonClassName: string;
+export declare const authWalletButtonClassName: string;
+export declare const authWalletIconGroupClassName: string;
+export declare const authHelperTextClassName: string;
+export declare const authHelperLinkClassName: string;
+export declare const authDividerClassName: string;
+export declare const authDividerLineClassName: string;
+export declare const authDividerLabelClassName: string;
+export declare const authLegalTextClassName: string;
+export declare const connectedButtonsRowClassName: string;
+export declare const connectedBalanceChipClassName: string;
+export declare const profileMenuContentClassName: string;
+export declare const profileMenuSectionClassName: string;
+export declare const profileMenuSeparatorClassName: string;
+export declare const profileMenuActionItemClassName: string;
+export declare const avatarRootClassName: string;
+export declare const avatarIconClassName: string;

package/dist/types/auth/connect-button-view/connect-button-view.constants.d.ts

@@ -0,0 +1,30 @@
+export declare const connectButtonContainerClassName: string;
+export declare const authNoticeClassName: string;
+export declare const authErrorClassName: string;
+export declare const authModalContainerClassName: string;
+export declare const authModalBodyClassName: string;
+export declare const authSectionClassName: string;
+export declare const authSectionHeadingClassName: string;
+export declare const authMethodsListClassName: string;
+export declare const authInputFormClassName: string;
+export declare const authInputFieldClassName: string;
+export declare const authPrimaryActionClassName: string;
+export declare const authMethodGridClassName: string;
+export declare const authWalletMethodGridClassName: string;
+export declare const authSocialButtonClassName: string;
+export declare const authWalletButtonClassName: string;
+export declare const authWalletIconGroupClassName: string;
+export declare const authHelperTextClassName: string;
+export declare const authHelperLinkClassName: string;
+export declare const authDividerClassName: string;
+export declare const authDividerLineClassName: string;
+export declare const authDividerLabelClassName: string;
+export declare const authLegalTextClassName: string;
+export declare const connectedButtonsRowClassName: string;
+export declare const connectedBalanceChipClassName: string;
+export declare const profileMenuContentClassName: string;
+export declare const profileMenuSectionClassName: string;
+export declare const profileMenuSeparatorClassName: string;
+export declare const profileMenuActionItemClassName: string;
+export declare const avatarRootClassName: string;
+export declare const avatarIconClassName: string;

package/dist/types/auth/connect-button-view/connect-button-view.types.d.mts

@@ -0,0 +1,115 @@
+import type { ButtonHTMLAttributes, ReactNode } from "react";
+import type { IconName } from "../../primitives/icon";
+export type AuthConnectButtonViewMethodKind = "email" | "social" | "wallet";
+export type AuthConnectButtonViewMethodChain = "ethereum" | "solana";
+export type AuthConnectButtonViewClassNames = {
+    authError?: string;
+    authFormField?: string;
+    authHelperLink?: string;
+    authMethodButton?: string;
+    authMethodDescription?: string;
+    authMethodGrid?: string;
+    authModalContent?: string;
+    authNotice?: string;
+    authSectionHeading?: string;
+    balanceChip?: string;
+    balanceText?: string;
+    positionsText?: string;
+    connectButton?: string;
+    connectedRow?: string;
+    depositButton?: string;
+    profileMenuActionItem?: string;
+    profileMenuContent?: string;
+    profileMenuSection?: string;
+    profileMenuSeparator?: string;
+    profileTrigger?: string;
+    profileTriggerLabel?: string;
+    root?: string;
+};
+export type AuthConnectButtonViewButtonProps = Pick<ButtonHTMLAttributes<HTMLButtonElement>, "id" | "name" | "tabIndex" | "autoFocus" | "aria-describedby">;
+export type AuthConnectButtonViewMethodInput = {
+    type: "email";
+    helperText?: string;
+    placeholder?: string;
+    submitLabel?: string;
+} | undefined;
+export type AuthConnectButtonViewMethod = {
+    chain?: AuthConnectButtonViewMethodChain;
+    description: string;
+    iconName?: IconName;
+    id: string;
+    input?: AuthConnectButtonViewMethodInput;
+    isAvailable: boolean;
+    kind: AuthConnectButtonViewMethodKind;
+    label: string;
+};
+export type AuthConnectButtonViewProps = {
+    /** ID of the auth method currently selected in the chooser. */
+    activeMethodId: string | null;
+    /** Formatted wallet or account address shown in the connected state. */
+    addressLabel?: string;
+    /** Native props forwarded to the main connect button. */
+    buttonProps?: AuthConnectButtonViewButtonProps;
+    /** When set, the sign-in modal switches to a security-check screen showing this content. */
+    challengeContent?: ReactNode;
+    /** Class name overrides for auth view slots. */
+    classNames?: AuthConnectButtonViewClassNames;
+    /** Whether all auth controls should be disabled. */
+    disabled?: boolean;
+    /** Email connection method configuration, when supported. */
+    emailMethod: AuthConnectButtonViewMethod | null;
+    /** Inline validation error shown for the email flow. */
+    emailError?: string | null;
+    /** Controlled email input value. */
+    emailValue: string;
+    /** General auth error message shown in the view. */
+    errorMessage?: string | null;
+    /** Whether the user is currently authenticated. */
+    isAuthenticated: boolean;
+    /** Whether balances are currently loading. */
+    isBalanceLoading: boolean;
+    /** Whether an auth-related async action is in progress. */
+    isBusy: boolean;
+    /** Controlled open state for the auth method chooser. */
+    isChooserOpen: boolean;
+    /** Controlled open state for the profile menu. */
+    isProfileMenuOpen: boolean;
+    /** Optional informational notice shown above the auth actions. */
+    notice?: string | null;
+    /** Called when the chooser open state changes. */
+    onChooserOpenChange: (open: boolean) => void;
+    /** Called when the deposit action is clicked. */
+    onDepositClick: () => void;
+    /** Called when the disconnect action is clicked. */
+    onDisconnectClick: () => void;
+    /** Called when the email input value changes. */
+    onEmailChange: (value: string) => void;
+    /** Called when the email auth form is submitted. */
+    onEmailSubmit: () => void;
+    /** Called when the user selects an auth method. */
+    onMethodSelect: (methodId: string) => void;
+    /** Called when the profile card itself is clicked. */
+    onProfileCardClick: () => void;
+    /** Called when the profile trigger is clicked. */
+    onProfileClick: () => void;
+    /** Called when the profile menu open state changes. */
+    onProfileMenuOpenChange: (open: boolean) => void;
+    /** Social auth methods rendered in the chooser. */
+    socialMethods: readonly AuthConnectButtonViewMethod[];
+    /** Called when the withdraw action is clicked. */
+    onWithdrawClick: () => void;
+    /** Label shown for the connected profile trigger. */
+    profileLabel?: string;
+    /** Aggregated total balance shown in the connected state. */
+    totalBalance: number;
+    /** Aggregated positions value shown in the connected state. */
+    positionsBalance: number;
+    /** Number of closed positions currently eligible to claim. */
+    claimReadyCount?: number;
+    /** Called when user clicks the claim-winnings action in the indicator tooltip. */
+    onClaimWinningsClick?: () => void;
+    /** Wallet auth methods rendered in the chooser. */
+    walletMethods: readonly AuthConnectButtonViewMethod[];
+    /** Whether deposits are blocked for the user's geo location. */
+    isDepositBlocked?: boolean;
+};

package/dist/types/auth/connect-button-view/connect-button-view.types.d.ts

@@ -0,0 +1,115 @@
+import type { ButtonHTMLAttributes, ReactNode } from "react";
+import type { IconName } from "../../primitives/icon";
+export type AuthConnectButtonViewMethodKind = "email" | "social" | "wallet";
+export type AuthConnectButtonViewMethodChain = "ethereum" | "solana";
+export type AuthConnectButtonViewClassNames = {
+    authError?: string;
+    authFormField?: string;
+    authHelperLink?: string;
+    authMethodButton?: string;
+    authMethodDescription?: string;
+    authMethodGrid?: string;
+    authModalContent?: string;
+    authNotice?: string;
+    authSectionHeading?: string;
+    balanceChip?: string;
+    balanceText?: string;
+    positionsText?: string;
+    connectButton?: string;
+    connectedRow?: string;
+    depositButton?: string;
+    profileMenuActionItem?: string;
+    profileMenuContent?: string;
+    profileMenuSection?: string;
+    profileMenuSeparator?: string;
+    profileTrigger?: string;
+    profileTriggerLabel?: string;
+    root?: string;
+};
+export type AuthConnectButtonViewButtonProps = Pick<ButtonHTMLAttributes<HTMLButtonElement>, "id" | "name" | "tabIndex" | "autoFocus" | "aria-describedby">;
+export type AuthConnectButtonViewMethodInput = {
+    type: "email";
+    helperText?: string;
+    placeholder?: string;
+    submitLabel?: string;
+} | undefined;
+export type AuthConnectButtonViewMethod = {
+    chain?: AuthConnectButtonViewMethodChain;
+    description: string;
+    iconName?: IconName;
+    id: string;
+    input?: AuthConnectButtonViewMethodInput;
+    isAvailable: boolean;
+    kind: AuthConnectButtonViewMethodKind;
+    label: string;
+};
+export type AuthConnectButtonViewProps = {
+    /** ID of the auth method currently selected in the chooser. */
+    activeMethodId: string | null;
+    /** Formatted wallet or account address shown in the connected state. */
+    addressLabel?: string;
+    /** Native props forwarded to the main connect button. */
+    buttonProps?: AuthConnectButtonViewButtonProps;
+    /** When set, the sign-in modal switches to a security-check screen showing this content. */
+    challengeContent?: ReactNode;
+    /** Class name overrides for auth view slots. */
+    classNames?: AuthConnectButtonViewClassNames;
+    /** Whether all auth controls should be disabled. */
+    disabled?: boolean;
+    /** Email connection method configuration, when supported. */
+    emailMethod: AuthConnectButtonViewMethod | null;
+    /** Inline validation error shown for the email flow. */
+    emailError?: string | null;
+    /** Controlled email input value. */
+    emailValue: string;
+    /** General auth error message shown in the view. */
+    errorMessage?: string | null;
+    /** Whether the user is currently authenticated. */
+    isAuthenticated: boolean;
+    /** Whether balances are currently loading. */
+    isBalanceLoading: boolean;
+    /** Whether an auth-related async action is in progress. */
+    isBusy: boolean;
+    /** Controlled open state for the auth method chooser. */
+    isChooserOpen: boolean;
+    /** Controlled open state for the profile menu. */
+    isProfileMenuOpen: boolean;
+    /** Optional informational notice shown above the auth actions. */
+    notice?: string | null;
+    /** Called when the chooser open state changes. */
+    onChooserOpenChange: (open: boolean) => void;
+    /** Called when the deposit action is clicked. */
+    onDepositClick: () => void;
+    /** Called when the disconnect action is clicked. */
+    onDisconnectClick: () => void;
+    /** Called when the email input value changes. */
+    onEmailChange: (value: string) => void;
+    /** Called when the email auth form is submitted. */
+    onEmailSubmit: () => void;
+    /** Called when the user selects an auth method. */
+    onMethodSelect: (methodId: string) => void;
+    /** Called when the profile card itself is clicked. */
+    onProfileCardClick: () => void;
+    /** Called when the profile trigger is clicked. */
+    onProfileClick: () => void;
+    /** Called when the profile menu open state changes. */
+    onProfileMenuOpenChange: (open: boolean) => void;
+    /** Social auth methods rendered in the chooser. */
+    socialMethods: readonly AuthConnectButtonViewMethod[];
+    /** Called when the withdraw action is clicked. */
+    onWithdrawClick: () => void;
+    /** Label shown for the connected profile trigger. */
+    profileLabel?: string;
+    /** Aggregated total balance shown in the connected state. */
+    totalBalance: number;
+    /** Aggregated positions value shown in the connected state. */
+    positionsBalance: number;
+    /** Number of closed positions currently eligible to claim. */
+    claimReadyCount?: number;
+    /** Called when user clicks the claim-winnings action in the indicator tooltip. */
+    onClaimWinningsClick?: () => void;
+    /** Wallet auth methods rendered in the chooser. */
+    walletMethods: readonly AuthConnectButtonViewMethod[];
+    /** Whether deposits are blocked for the user's geo location. */
+    isDepositBlocked?: boolean;
+};

package/dist/types/auth/connect-button-view/index.d.mts

@@ -0,0 +1,7 @@
+import type { JSX } from "react";
+import type { AuthConnectButtonViewProps } from "./connect-button-view.types";
+export type { AuthConnectButtonViewButtonProps, AuthConnectButtonViewClassNames, AuthConnectButtonViewMethod, AuthConnectButtonViewMethodInput, AuthConnectButtonViewProps, } from "./connect-button-view.types";
+export declare const AuthConnectButtonView: {
+    ({ activeMethodId, addressLabel, buttonProps, challengeContent, classNames, disabled, emailMethod, emailError, emailValue, errorMessage, isAuthenticated, isBalanceLoading, isBusy, isChooserOpen, isProfileMenuOpen, notice, onChooserOpenChange, onDepositClick, onDisconnectClick, onEmailChange, onEmailSubmit, onMethodSelect, onProfileCardClick, onProfileClick, onProfileMenuOpenChange, socialMethods, onWithdrawClick, profileLabel, totalBalance, positionsBalance, claimReadyCount, onClaimWinningsClick, walletMethods, isDepositBlocked, }: AuthConnectButtonViewProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/auth/connect-button-view/index.d.ts

@@ -0,0 +1,7 @@
+import type { JSX } from "react";
+import type { AuthConnectButtonViewProps } from "./connect-button-view.types";
+export type { AuthConnectButtonViewButtonProps, AuthConnectButtonViewClassNames, AuthConnectButtonViewMethod, AuthConnectButtonViewMethodInput, AuthConnectButtonViewProps, } from "./connect-button-view.types";
+export declare const AuthConnectButtonView: {
+    ({ activeMethodId, addressLabel, buttonProps, challengeContent, classNames, disabled, emailMethod, emailError, emailValue, errorMessage, isAuthenticated, isBalanceLoading, isBusy, isChooserOpen, isProfileMenuOpen, notice, onChooserOpenChange, onDepositClick, onDisconnectClick, onEmailChange, onEmailSubmit, onMethodSelect, onProfileCardClick, onProfileClick, onProfileMenuOpenChange, socialMethods, onWithdrawClick, profileLabel, totalBalance, positionsBalance, claimReadyCount, onClaimWinningsClick, walletMethods, isDepositBlocked, }: AuthConnectButtonViewProps): JSX.Element;
+    displayName: string;
+};

package/dist/types/auth/index.d.mts

@@ -0,0 +1 @@
+export * from "./connect-button-view";

package/dist/types/auth/index.d.ts

@@ -0,0 +1 @@
+export * from "./connect-button-view";

package/dist/types/constants.d.mts

@@ -0,0 +1,5 @@
+export declare const AGG_ROOT_CLASS_NAME = "agg-root";
+export declare const AGG_DEFAULT_URL = "https://build.agg.market";
+export declare const AGG_TERMS_OF_SERVICE_URL = "https://build.agg.market/terms-and-conditions";
+export declare const AGG_PRIVACY_POLICY_URL = "https://build.agg.market/privacy-policy";
+export declare const AGG_DOCS_URL = "https://docs.agg.market";

package/dist/types/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const AGG_ROOT_CLASS_NAME = "agg-root";
+export declare const AGG_DEFAULT_URL = "https://build.agg.market";
+export declare const AGG_TERMS_OF_SERVICE_URL = "https://build.agg.market/terms-and-conditions";
+export declare const AGG_PRIVACY_POLICY_URL = "https://build.agg.market/privacy-policy";
+export declare const AGG_DOCS_URL = "https://docs.agg.market";

package/dist/types/deposit/components/DepositQRCode.d.mts

@@ -0,0 +1,12 @@
+import type { JSX, ReactNode } from "react";
+export interface DepositQRCodeProps {
+    depositAddress: string;
+    networkLogoUrl: string;
+    /** Inline React node for the chain logo. Takes precedence over networkLogoUrl. */
+    networkLogo?: ReactNode;
+    size?: number;
+}
+export declare function DepositQRCode({ depositAddress, networkLogoUrl, networkLogo, size, }: DepositQRCodeProps): JSX.Element;
+export declare namespace DepositQRCode {
+    var displayName: string;
+}

package/dist/types/deposit/components/DepositQRCode.d.ts

@@ -0,0 +1,12 @@
+import type { JSX, ReactNode } from "react";
+export interface DepositQRCodeProps {
+    depositAddress: string;
+    networkLogoUrl: string;
+    /** Inline React node for the chain logo. Takes precedence over networkLogoUrl. */
+    networkLogo?: ReactNode;
+    size?: number;
+}
+export declare function DepositQRCode({ depositAddress, networkLogoUrl, networkLogo, size, }: DepositQRCodeProps): JSX.Element;
+export declare namespace DepositQRCode {
+    var displayName: string;
+}

package/dist/types/deposit/deposit-modal.constants.d.mts

@@ -0,0 +1,10 @@
+import type { DepositSelectOption } from "./deposit-modal.types";
+/**
+ * Display names for venue slugs.
+ * Re-uses the venue-logo labels as the single source of truth.
+ */
+export { venueLogoLabels as VENUE_DISPLAY_NAMES } from "../primitives/venue-logo/venue-logo.constants";
+/** Default network options for the card deposit flow. */
+export declare const CARD_NETWORK_OPTIONS: DepositSelectOption[];
+/** Maps network slugs to ramp destination currency codes. */
+export declare const NETWORK_TO_CURRENCY_CODE: Record<string, string>;

package/dist/types/deposit/deposit-modal.constants.d.ts

@@ -0,0 +1,10 @@
+import type { DepositSelectOption } from "./deposit-modal.types";
+/**
+ * Display names for venue slugs.
+ * Re-uses the venue-logo labels as the single source of truth.
+ */
+export { venueLogoLabels as VENUE_DISPLAY_NAMES } from "../primitives/venue-logo/venue-logo.constants";
+/** Default network options for the card deposit flow. */
+export declare const CARD_NETWORK_OPTIONS: DepositSelectOption[];
+/** Maps network slugs to ramp destination currency codes. */
+export declare const NETWORK_TO_CURRENCY_CODE: Record<string, string>;

package/dist/types/deposit/deposit-modal.types.d.mts

@@ -0,0 +1,233 @@
+export interface VenueBalance {
+    venue: string;
+    balance: number;
+    shortfall?: number;
+}
+export type DepositMethod = "wallet" | "crypto" | "card";
+export interface DepositFlowOption {
+    id: string;
+    title: string;
+    description: string;
+    value?: string;
+    highlighted?: boolean;
+}
+export interface DepositSelectOption {
+    value: string;
+    label: string;
+    iconUrl?: string;
+    icon?: React.ReactNode;
+}
+export interface WalletProcessingStep {
+    id: string;
+    label: string;
+    status: "complete" | "active" | "pending";
+}
+export type WalletTransactionStatus = "submitted" | "confirming" | "settled" | "error";
+export interface WalletDepositSummary {
+    amountReceived: string;
+    network: string;
+    fromWallet: string;
+    gasFee: string;
+}
+/** Parameters passed to `onConfirmWalletDeposit`. */
+export interface WalletDepositConfirmParams {
+    /** Resolved deposit address — EVM (0x…) or SVM (Base58) based on selected network. */
+    address: string;
+    amount: string;
+    chainId: number;
+    token: string;
+}
+/** Partner-provided wallet context. Network/token selection is managed internally. */
+export interface WalletDepositFlowData {
+    /** Platform balance shown on the method-selection screen. */
+    balance: number;
+    /** Connected wallet label shown in the form header, e.g. "3XzH…ULM9". */
+    walletLabel: string;
+    /** Wallet's current fiat balance used for amount validation. */
+    walletBalance: number;
+    /** Whether the wallet balance is currently being fetched. */
+    isWalletBalanceLoading?: boolean;
+    /** Controlled amount string. */
+    amount: string;
+    /** Optional inline error shown on the wallet form. */
+    formErrorMessage?: string;
+    /** Visual tone for the inline wallet form error. */
+    formErrorTone?: "warning" | "error";
+    /** Optional estimate row shown below the amount input. */
+    estimatedReceive?: string;
+    feeEstimate?: string;
+    eta?: string;
+    /**
+     * Processing steps shown during deposit.
+     * Defaults to the standard 2-step submit/confirmation flow when omitted.
+     */
+    processingSteps?: WalletProcessingStep[];
+    /**
+     * Optional transaction status for driving the processing screen from a real
+     * wallet broadcast/confirmation flow. When omitted, the modal stays on the
+     * confirmation state until the caller updates the flow or closes the modal.
+     */
+    transactionStatus?: WalletTransactionStatus;
+    /** Optional processing error copy shown when transactionStatus is "error". */
+    transactionErrorMessage?: string;
+    /**
+     * Success summary shown on the final screen.
+     * Defaults are derived from the deposit context (amount, network, wallet label).
+     * Provide `gasFee` here once known from the transaction receipt.
+     */
+    successSummary?: Partial<WalletDepositSummary>;
+}
+/** Optional config for the "Send crypto" tab. All fields have sensible defaults. */
+export interface SendCryptoConfig {
+    minDeposit?: string;
+    feeEstimate?: string;
+    eta?: string;
+}
+export interface CardProviderOption {
+    id: string;
+    name: string;
+    quote: string;
+    fee: string;
+    badge?: "best" | "low-kyc";
+    highlighted?: boolean;
+}
+export interface CardPurchaseSummary {
+    amountReceived: string;
+    network: string;
+    fees: string;
+}
+export interface CardFlowData {
+    amount: string;
+    currency: string;
+    tokenOptions: DepositSelectOption[];
+    /** Optional override list. Falls back to {@link CARD_NETWORK_OPTIONS}. */
+    networkOptions?: DepositSelectOption[];
+    selectedToken: string;
+    selectedNetwork: string;
+    providers: CardProviderOption[];
+    selectedProviderId?: string;
+    purchaseSummary: CardPurchaseSummary;
+    /** Minimum deposit amount in the selected currency. Shown as validation hint. */
+    minAmount?: number;
+}
+export interface DepositModalControlledProps {
+    open: boolean;
+    /** Called whenever the deposit modal open state changes. */
+    onOpenChange: (open: boolean) => void;
+    /** Controlled wallet-flow state used by the wallet deposit tab. */
+    walletFlow: WalletDepositFlowData;
+    /** Called when the wallet deposit amount changes. */
+    onWalletAmountChange: (amount: string) => void;
+    /** Called when the wallet flow should use the maximum available amount. */
+    onWalletMax: () => void;
+    /**
+     * Called when the user confirms a wallet deposit.
+     * Receives the resolved deposit address and amount so the caller can
+     * submit the on-chain transaction. Return a promise — the modal waits
+     * before advancing to the processing screen.
+     */
+    onConfirmWalletDeposit?: (params: WalletDepositConfirmParams) => Promise<void> | void;
+    /** Called after the wallet deposit flow reaches its completion state. */
+    onDoneWalletDeposit?: () => void;
+    /**
+     * Fired whenever the wallet-flow network dropdown changes (including the
+     * initial auto-select). The parent can use this to read the on-chain
+     * balance for the selected chain and update `walletFlow.walletBalance`.
+     */
+    onWalletNetworkChange?: (chainId: string) => void;
+    /**
+     * Fired whenever the wallet-flow token dropdown changes (including the
+     * initial auto-select after a network switch). Use together with
+     * `onWalletNetworkChange` to read the on-chain balance for the
+     * selected token and update `walletFlow.walletBalance`.
+     */
+    onWalletTokenChange?: (tokenSymbol: string) => void;
+    /**
+     * If provided, the wallet-flow network dropdown will prefer this chain
+     * on first render (e.g. pass the wallet's connected chainId so the
+     * dropdown and balance are in sync immediately).
+     */
+    initialWalletChainId?: string;
+    /**
+     * Set when exactly one external wallet kind is connected. When provided,
+     * the wallet flow filters its network options to chains compatible with
+     * that wallet (and hides the network selector if only one option remains).
+     * Leave undefined to show all chains.
+     */
+    connectedWalletKind?: "evm" | "solana";
+    /** Static config for the "Send crypto" tab (min deposit, fee, ETA). */
+    sendCryptoConfig?: SendCryptoConfig;
+    /** Called after the send-crypto flow reaches its completion state. */
+    onDoneSendCrypto?: () => void;
+    /** Optional controlled state for the card deposit flow. */
+    cardFlow?: CardFlowData;
+    /** Called when the user selects a deposit method tab. */
+    onSelectDepositMethod?: (method: DepositMethod) => void;
+    /** Called when the card deposit flow continues after amount entry. */
+    onContinueCardDeposit?: (amount: number) => void;
+    /** Called after the crypto transfer flow completes. */
+    onDoneCryptoTransfer?: () => void;
+    /** Called when the card deposit amount changes. */
+    onCardAmountChange?: (amount: string) => void;
+    /** Called when the source fiat currency changes. */
+    onCardCurrencyChange?: (currency: string) => void;
+    /** Called when the destination token changes. */
+    onCardTokenChange?: (token: string) => void;
+    /** Called when the destination network changes. */
+    onCardNetworkChange?: (network: string) => void;
+    /** Called when the user selects a ramp provider. */
+    onSelectCardProvider?: (providerId: string) => void;
+    /** Called after the card purchase flow completes. */
+    onDoneCardPurchase?: () => void;
+    /**
+     * Optional side-effect hook fired when the user clicks "View Activity" on
+     * the payment-pending screen. The modal then redirects to `/profile?tab=activity`
+     * regardless. Use this for analytics or partner-side teardown.
+     */
+    onViewActivity?: () => void;
+    /** URL to redirect the user to after the ramp widget transaction completes. */
+    cardRedirectUrl?: string;
+    /** Called when user clicks "Get Quotes". Should fetch ramp quotes and return CardProviderOption[]. */
+    onGetCardQuotes?: (params: {
+        /** Amount entered in the source fiat currency. */
+        sourceAmount: string;
+        /** ISO currency code for the fiat source amount. */
+        sourceCurrencyCode: string;
+        /** Destination token or currency code requested from providers. */
+        destinationCurrencyCode: string;
+    }) => Promise<CardProviderOption[]>;
+    /** Called when user selects a provider. Should create an ramp session and return the widget URL. */
+    onCreateCardSession?: (params: {
+        /** Identifier of the selected ramp provider. */
+        serviceProvider: string;
+        /** Amount entered in the source fiat currency. */
+        sourceAmount: string;
+        /** ISO currency code for the fiat source amount. */
+        sourceCurrencyCode: string;
+        /** Destination token or currency code requested from providers. */
+        destinationCurrencyCode: string;
+        /** Wallet address that should receive the purchased asset. */
+        walletAddress: string;
+        /** Optional redirect URL used after the provider flow completes. */
+        redirectUrl?: string;
+    }) => Promise<{
+        id: string;
+        widgetUrl: string;
+        serviceProviderWidgetUrl: string;
+    }>;
+    /** Poll card transaction status by session ID. Return the status string. */
+    onGetCardTransactionStatus?: (sessionId: string) => Promise<CardTransactionStatus>;
+    /**
+     * When set, the modal opens directly in the card success screen.
+     * Used to resume after a redirect from the payment provider.
+     */
+    pendingCardPurchaseSummary?: CardPurchaseSummary | null;
+}
+export interface DepositModalSelfDrivenProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+export type DepositModalProps = DepositModalControlledProps | DepositModalSelfDrivenProps;
+export interface CardTransactionStatus {
+    status: "pending" | "settling" | "settled" | "error" | "unknown";
+}