@tokenflight/swap 0.0.4 → 0.1.2

package/dist/tokenflight-swap.d.ts

@@ -0,0 +1,829 @@
+import { ChainInfo } from '@tokenflight/api';
+import { ContractCallDeposit } from '@tokenflight/api';
+import { DEFAULT_API_ENDPOINT } from '@tokenflight/api';
+import { DepositApproval } from '@tokenflight/api';
+import { DepositBuildResponse } from '@tokenflight/api';
+import { EIP1193RequestApproval } from '@tokenflight/api';
+import { ErrorCode } from '@tokenflight/api';
+import { ExactOutMethod } from '@tokenflight/api';
+import { FiatJumpRoute } from '@tokenflight/api';
+import { FiatOrderRequest } from '@tokenflight/api';
+import { FiatOrderResponse } from '@tokenflight/api';
+import { FiatOrderStatus } from '@tokenflight/api';
+import { FiatPaymentMethod } from '@tokenflight/api';
+import { FiatProviderInfo } from '@tokenflight/api';
+import { FiatProvidersResponse } from '@tokenflight/api';
+import { FiatQuoteItem } from '@tokenflight/api';
+import { FiatQuoteRequest } from '@tokenflight/api';
+import { FiatQuoteResponse } from '@tokenflight/api';
+import { FiatQuotesResponse } from '@tokenflight/api';
+import { FiatStatusResponse } from '@tokenflight/api';
+import { OnChainTx } from '@tokenflight/api';
+import { OrderListResponse } from '@tokenflight/api';
+import { OrderResponse } from '@tokenflight/api';
+import { OrderStatus } from '@tokenflight/api';
+import { OrderTimestamps } from '@tokenflight/api';
+import { OrderTransactions } from '@tokenflight/api';
+import { QuoteRequest } from '@tokenflight/api';
+import { QuoteResponse } from '@tokenflight/api';
+import { QuoteRoute } from '@tokenflight/api';
+import { ResolvedToken } from '@tokenflight/api';
+import { RouteQuote } from '@tokenflight/api';
+import { RouteTag } from '@tokenflight/api';
+import { SolanaApproval } from '@tokenflight/api';
+import { SubmitDepositResponse } from '@tokenflight/api';
+import { SwapStrategy } from '@tokenflight/api';
+import { TERMINAL_FIAT_STATUSES } from '@tokenflight/api';
+import { TERMINAL_ORDER_STATUSES } from '@tokenflight/api';
+import { TokenExtensions } from '@tokenflight/api';
+import { TokenFlightError } from '@tokenflight/api';
+import { TokenInfo } from '@tokenflight/api';
+import { TokenListResponse } from '@tokenflight/api';
+import { TokenMeta } from '@tokenflight/api';
+import { TokenSearchResponse } from '@tokenflight/api';
+import { TradeType } from '@tokenflight/api';
+
+/**
+ * Add thousands separators (commas) to the integer part of a numeric string.
+ * e.g., "3200" → "3,200", "1234567.89" → "1,234,567.89", "0.5" → "0.5"
+ */
+export declare function addThousandsSeparator(value: string): string;
+
+/** Amount change data */
+export declare interface AmountChangedData {
+    amount: string;
+    direction: "from" | "to";
+}
+
+/**
+ * Boolean HTML attribute — accepts both native booleans and the
+ * string equivalents that `parseBooleanProp()` understands.
+ */
+declare type BooleanAttribute = boolean | "true" | "false" | "1" | "0" | "yes" | "no" | "";
+
+/**
+ * Build offers for ranking from API routes (EXACT_OUTPUT mode).
+ * Routes with unparseable amountIn are excluded from ranking.
+ */
+export declare function buildOffersForRanking(routes: readonly QuoteRoute[], tradeType: TradeType | null): OfferForRanking[];
+
+/** Callback interfaces for widget events */
+export declare interface Callbacks {
+    onSwapSuccess?(data: SwapSuccessData): void;
+    onSwapError?(data: SwapErrorData): void;
+    onWalletConnected?(data: WalletConnectedData): void;
+    onQuoteReceived?(data: QuoteResponse): void;
+    onAmountChanged?(data: AmountChangedData): void;
+    /** Called when user clicks Connect Wallet and no walletAdapter is provided */
+    onConnectWallet?(): void;
+    /** Called when user clicks the connected wallet address (for custom account modal handling) */
+    onAccountModal?(): void;
+    /** Called when a fiat order is created and the payment widget URL is available */
+    onFiatOrderCreated?(data: {
+        orderId: string;
+        widgetUrl: string;
+    }): void;
+    /** Called when a fiat order reaches a terminal status */
+    onFiatOrderCompleted?(data: {
+        orderId: string;
+        status: string;
+        txHash?: string;
+    }): void;
+    /** Called when a deposit completes successfully */
+    onDepositSuccess?(data: SwapSuccessData): void;
+    /** Called when a deposit fails */
+    onDepositError?(data: SwapErrorData): void;
+}
+
+export { ChainInfo }
+
+/** Chain type for multi-chain support */
+export declare type ChainType = "evm" | "solana";
+
+/** Clear all TokenFlight token cache entries */
+export declare function clearTokenCache(): void;
+
+/**
+ * Compute exchange rate as a display string.
+ * Returns how many toToken units you get per 1 fromToken.
+ */
+export declare function computeExchangeRate(amountIn: string, decimalsIn: number, amountOut: string, decimalsOut: number): string;
+
+export { ContractCallDeposit }
+
+/**
+ * Custom color overrides — keys are CSS variable names.
+ * Typed keys provide autocomplete; arbitrary `--tf-*` strings are also accepted.
+ *
+ * ```ts
+ * customColors: {
+ *   "--tf-primary": "#FF6B00",
+ *   "--tf-bg": "#1A1A2E",
+ *   "--tf-button-radius": "4px",
+ *   "--tf-widget-max-width": "480px",
+ * }
+ * ```
+ */
+export declare type CustomColors = Partial<Record<TfCssVar, string>> & Record<string, string>;
+
+export { DEFAULT_API_ENDPOINT }
+
+export { DepositApproval }
+
+export { DepositBuildResponse }
+
+/** Payment methods available in `<tokenflight-deposit>` */
+export declare type DepositMethod = "wallet" | "card";
+
+/** Non-derivable state for `<tokenflight-deposit>`. */
+export declare interface DepositState {
+    targetToken: ResolvedToken | null;
+    targetAmount: string;
+    fromToken: ResolvedToken | null;
+    recipient: string | null;
+    walletAddress: string | null;
+    execPhase: ExecPhase | null;
+    order: OrderResponse | null;
+    error: string | null;
+    errorCode: string | null;
+}
+
+/** @deprecated Deposit now uses a flat layout; overlays are boolean signals. Kept for public API compatibility. */
+export declare type DepositView = "entry" | "fixed" | "select-target" | "wallet-pay-with";
+
+export { EIP1193RequestApproval }
+
+export { ErrorCode }
+
+/** EVM wallet action via EIP-1193 */
+export declare interface EvmWalletAction {
+    type: "eip1193_request";
+    chainId: number;
+    method: string;
+    params: unknown[];
+}
+
+export { ExactOutMethod }
+
+/** Execution-only phases for the async build→wallet→submit→track→success flow */
+export declare type ExecPhase = "building" | "awaiting-wallet" | "submitting" | "tracking" | "success";
+
+/** Execution-only phases for the fiat flow */
+export declare type FiatExecPhase = "creating-order" | "awaiting-payment" | "tracking" | "success";
+
+export { FiatJumpRoute }
+
+export { FiatOrderRequest }
+
+export { FiatOrderResponse }
+
+export { FiatOrderStatus }
+
+export { FiatPaymentMethod }
+
+/** How the fiat payment provider UI is opened. */
+export declare type FiatPaymentMode = "overlay" | "popup";
+
+/** UI phases for the fiat flow (derived from signals + queries) */
+export declare type FiatPhase = "idle" | "quoting" | "quoted" | "creating-order" | "awaiting-payment" | "tracking" | "success" | "error";
+
+export { FiatProviderInfo }
+
+export { FiatProvidersResponse }
+
+export { FiatQuoteItem }
+
+export { FiatQuoteRequest }
+
+export { FiatQuoteResponse }
+
+export { FiatQuotesResponse }
+
+export { FiatStatusResponse }
+
+/**
+ * Format a display amount to a fixed number of significant decimals.
+ * Avoids showing excessive precision in the UI.
+ *
+ * When the integer part is "0", ensures at least `maxDecimals` significant
+ * digits are shown (e.g., "0.00472" → "0.0047" with maxDecimals=2).
+ */
+export declare function formatDisplayAmount(amount: string, maxDecimals?: number): string;
+
+/** Get the best overall route ID for exact output. */
+export declare function getBestOverallRouteId(routes: readonly QuoteRoute[], tradeType: TradeType | null): string | null;
+
+/** Get chain type from chainId */
+export declare function getChainType(chainId: number): "evm" | "solana";
+
+declare interface ImperativeWidgetOptions<TConfig> {
+    container: string | HTMLElement;
+    config: TConfig;
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+}
+
+/** Check if two chains are of different types (cross-chain swap) */
+export declare function isCrossChainSwap(fromChainId: number, toChainId: number): boolean;
+
+/** Check if a chainId is EVM */
+export declare function isEvmChain(chainId: number): boolean;
+
+/** Check if a chainId is Solana */
+export declare function isSolanaChain(chainId: number): boolean;
+
+/** Wallet adapter interface that all adapters must implement */
+export declare interface IWalletAdapter {
+    /** Human-readable name */
+    readonly name: string;
+    /** Icon URL */
+    readonly icon?: string;
+    /** Supported action types */
+    readonly supportedActionTypes: WalletActionType[];
+    /** Optional: supported chain IDs — when set, the widget only shows tokens on these chains */
+    readonly supportedChainIds?: number[];
+    /** Connect the wallet */
+    connect(chainType?: ChainType): Promise<void>;
+    /** Disconnect the wallet */
+    disconnect(): Promise<void>;
+    /** Check if connected */
+    isConnected(chainType?: ChainType): boolean;
+    /** Get the current address */
+    getAddress(chainType?: ChainType): Promise<string | null>;
+    /** Execute a wallet action */
+    executeWalletAction(action: WalletAction): Promise<WalletActionResult>;
+    /** Optional: sign a message */
+    signMessage?(message: string, chainType?: ChainType): Promise<string>;
+    /** Optional: open the wallet's native account/connected modal */
+    openAccountModal?(): Promise<void>;
+    /** Optional: clean up internal subscriptions and watchers */
+    destroy?(): void;
+    /** Subscribe to wallet events */
+    on(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+    /** Unsubscribe from wallet events */
+    off(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+}
+
+export declare class MockWalletAdapter implements IWalletAdapter {
+    readonly name = "Mock Wallet";
+    readonly icon: undefined;
+    readonly supportedActionTypes: WalletActionType[];
+    private connected;
+    private address;
+    private listeners;
+    connect(_chainType?: ChainType): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(_chainType?: ChainType): boolean;
+    getAddress(_chainType?: ChainType): Promise<string | null>;
+    executeWalletAction(_action: WalletAction): Promise<WalletActionResult>;
+    signMessage(_message: string): Promise<string>;
+    openAccountModal(): Promise<void>;
+    on(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+    off(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+    private emit;
+}
+
+/**
+ * Minimal offer data needed for ranking offers.
+ * For offers (EXACT_OUTPUT): lower amountIn is better.
+ */
+declare interface OfferForRanking {
+    routeId: string;
+    amountIn: bigint;
+    etaSeconds: number;
+    isGuaranteedOutput: boolean;
+    isOneClick: boolean;
+}
+
+export { OnChainTx }
+
+export { OrderListResponse }
+
+export { OrderResponse }
+
+export { OrderStatus }
+
+export { OrderTimestamps }
+
+export { OrderTransactions }
+
+export { QuoteRequest }
+
+export { QuoteResponse }
+
+export { QuoteRoute }
+
+/**
+ * Rank offers where lower input amount is better (EXACT_OUTPUT).
+ *
+ * Same algorithm as rankSwapOffers but inverted:
+ * best price = lowest amountIn, threshold = lowestAmountIn * 1.001
+ */
+export declare function rankOffers(offers: readonly OfferForRanking[]): string[];
+
+/** Receive component mode: crypto-only, fiat-only, or both */
+export declare type ReceiveMode = "crypto" | "fiat" | "all";
+
+/**
+ * Non-derivable state for `<tokenflight-receive>`.
+ *
+ * Derivable values (phase, selectedQuote, paymentTokens) are computed in
+ * ReceiveComponent from payTokenQuotes + loadingQuotes + these signals.
+ */
+export declare interface ReceiveState {
+    targetToken: ResolvedToken | null;
+    targetAmount: string;
+    /** Set before execution starts for TransactionComplete display */
+    fromToken: ResolvedToken | null;
+    /** Recipient address for cross-chain swaps */
+    recipient: string | null;
+    walletAddress: string | null;
+    /** Current execution phase, or null when idle/quoting/quoted */
+    execPhase: ExecPhase | null;
+    order: OrderResponse | null;
+    error: string | null;
+    errorCode: string | null;
+}
+
+declare function registerDepositElement(options?: RegisterElementsOptions): void;
+export { registerDepositElement }
+export { registerDepositElement as registerFiatElement }
+export { registerDepositElement as registerReceiveElement }
+
+export declare function registerElements(options?: RegisterElementsOptions): void;
+
+export declare interface RegisterElementsOptions {
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+    /** Custom CSS variable overrides merged on top of the active theme.
+     *  Keys are CSS variable names, e.g. `"--tf-primary"`, `"--tf-font-family"`. */
+    customColors?: CustomColors;
+    /** Default API endpoint for all widget instances. */
+    apiEndpoint?: string;
+    /** Default theme for all widget instances. */
+    theme?: Theme;
+    /** Default locale for all widget instances. */
+    locale?: SupportedLocale;
+}
+
+export declare function registerSwapElement(options?: RegisterElementsOptions): void;
+
+export declare function registerWidgetElement(options?: RegisterElementsOptions): void;
+
+export { ResolvedToken }
+
+export { RouteQuote }
+
+export { RouteTag }
+
+/** Chain ID for Solana mainnet in the API */
+export declare const SOLANA_CHAIN_ID = 20011000000;
+
+export { SolanaApproval }
+
+/** Solana sign and send transaction action */
+export declare interface SolanaSignAndSendAction {
+    type: "solana_signAndSendTransaction";
+    transaction: string;
+}
+
+/** Solana sign transaction action */
+export declare interface SolanaSignTransactionAction {
+    type: "solana_signTransaction";
+    transaction: string;
+}
+
+export { SubmitDepositResponse }
+
+/** Supported locale identifiers. Accepts any string for forward-compat; known values get bundled translations. */
+export declare type SupportedLocale = "en-US" | "zh-CN" | "zh-TW" | "ja-JP" | "ko-KR" | (string & {});
+
+/** Data emitted on swap error */
+export declare interface SwapErrorData {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+
+/** Swap flow phases */
+export declare type SwapPhase = "idle" | "quoting" | "quoted" | "building" | "awaiting-wallet" | "submitting" | "tracking" | "success" | "error";
+
+export { SwapStrategy }
+
+/** Data emitted on swap success */
+export declare interface SwapSuccessData {
+    orderId: string;
+    fromToken: string;
+    toToken: string;
+    fromAmount: string;
+    toAmount: string;
+    txHash: string;
+}
+
+export { TERMINAL_FIAT_STATUSES }
+
+export { TERMINAL_ORDER_STATUSES }
+
+/** All first-party CSS custom properties exposed for theming. */
+declare type TfCssVar = "--tf-bg" | "--tf-bg-secondary" | "--tf-bg-elevated" | "--tf-surface" | "--tf-surface-hover" | "--tf-input-bg" | "--tf-glass" | "--tf-text" | "--tf-text-secondary" | "--tf-text-tertiary" | "--tf-text-on-primary" | "--tf-border" | "--tf-border-light" | "--tf-primary" | "--tf-primary-alpha" | "--tf-primary-light" | "--tf-primary-glow" | "--tf-success" | "--tf-success-bg" | "--tf-error" | "--tf-error-bg" | "--tf-error-alpha" | "--tf-warning" | "--tf-warning-bg" | "--tf-shadow" | "--tf-shadow-lg" | "--tf-skeleton" | "--tf-radius-xs" | "--tf-radius-sm" | "--tf-radius" | "--tf-radius-lg" | "--tf-radius-xl" | "--tf-button-radius" | "--tf-widget-max-width" | "--tf-font-family" | "--tf-font-family-mono";
+
+/** Visual theme mode. */
+export declare type Theme = "light" | "dark" | "auto";
+
+/**
+ * Convert display amount to base units (bigint string) using token decimals.
+ * e.g., toBaseUnits("1", 6) → "1000000"
+ *       toBaseUnits("1.5", 6) → "1500000"
+ */
+export declare function toBaseUnits(displayAmount: string, decimals: number): string;
+
+/**
+ * Convert base units (bigint string) to display amount using token decimals.
+ * e.g., toDisplayAmount("1000000", 6) → "1"
+ *       toDisplayAmount("1500000", 6) → "1.5"
+ */
+export declare function toDisplayAmount(baseUnits: string, decimals: number): string;
+
+export { TokenExtensions }
+
+/** Shared configuration fields for both widgets */
+export declare interface TokenFlightConfigBase {
+    /** HyperStream API endpoint */
+    apiEndpoint?: string;
+    /** Fiat on-ramp API endpoint (default: https://fiat-preview.hyperstream.dev) */
+    fiatApiEndpoint?: string;
+    /** Visual theme */
+    theme?: Theme;
+    /** Locale for i18n */
+    locale?: SupportedLocale;
+    /** Custom CSS color overrides */
+    customColors?: CustomColors;
+    /** Optional custom widget title text */
+    titleText?: string;
+    /** Optional custom widget title image URL */
+    titleImageUrl?: string;
+    /** Hide top title/header area */
+    hideTitle?: boolean;
+    /** Hide "Powered by TokenFlight" footer */
+    hidePoweredBy?: boolean;
+    /** Remove container background (transparent) */
+    noBackground?: boolean;
+    /** Remove container border and shadow */
+    noBorder?: boolean;
+}
+
+declare const TokenFlightDeposit: {
+    new (options: ImperativeWidgetOptions<TokenFlightDepositConfig>): {
+        #dispose: (() => void) | null;
+        #unwatchTheme: (() => void) | null;
+        #container: HTMLElement;
+        #shadowRoot: ShadowRoot | null;
+        #config: TokenFlightDepositConfig;
+        #walletAdapter?: IWalletAdapter;
+        #callbacks?: Callbacks;
+        initialize(): void;
+        destroy(): void;
+        setTheme(theme: Theme): void;
+        setCustomColors(colors: CustomColors): void;
+        #applyThemeStyles(style: HTMLStyleElement, theme: string): void;
+        #setupAutoThemeWatch(style: HTMLStyleElement): void;
+    };
+};
+export { TokenFlightDeposit }
+export { TokenFlightDeposit as TokenFlightFiat }
+export { TokenFlightDeposit as TokenFlightReceive }
+
+/** Attributes accepted by `<tokenflight-deposit>`. */
+export declare interface TokenFlightDepositAttributes {
+    "api-endpoint"?: string;
+    target?: string;
+    amount?: string;
+    "from-token"?: string;
+    recipient?: string;
+    methods?: string;
+    "target-icon"?: string;
+    "fiat-currency"?: string;
+    "fiat-payment-mode"?: string;
+    "title-text"?: string;
+    "title-image"?: string;
+    theme?: Theme;
+    locale?: SupportedLocale;
+    "csp-nonce"?: string;
+    "hide-title"?: BooleanAttribute;
+    "hide-powered-by"?: BooleanAttribute;
+    "no-background"?: BooleanAttribute;
+    "no-border"?: BooleanAttribute;
+}
+
+/** Configuration for `<tokenflight-deposit>` */
+export declare interface TokenFlightDepositConfig extends TokenFlightConfigBase {
+    /** Target token(s) to deposit into. When omitted, user selects via TokenSelector. */
+    target?: TokenIdentifier | TokenIdentifier[];
+    /** Optional: fixed amount for the target token */
+    amount?: string;
+    /** Optional: recipient address */
+    recipient?: string;
+    /** Payment methods to offer (default: ["wallet"]) */
+    methods?: DepositMethod[];
+    /** Optional source token to pay with */
+    fromToken?: TokenIdentifier;
+    /** Optional icon URL for the target token */
+    targetIcon?: string;
+    /** Fiat currency code for card payments (default: "USD") */
+    fiatCurrency?: string;
+    /** How to open the fiat payment provider (default: "overlay") */
+    fiatPaymentMode?: FiatPaymentMode;
+}
+
+export declare interface TokenFlightDepositOptions {
+    container: string | HTMLElement;
+    config: TokenFlightDepositConfig;
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+}
+
+export { TokenFlightError }
+
+/** Attributes accepted by `<tokenflight-fiat>`. */
+export declare interface TokenFlightFiatAttributes {
+    "api-endpoint"?: string;
+    target?: string;
+    recipient?: string;
+    "fiat-currency"?: string;
+    "title-text"?: string;
+    "title-image"?: string;
+    theme?: Theme;
+    locale?: SupportedLocale;
+    "csp-nonce"?: string;
+    icon?: string;
+    "hide-title"?: BooleanAttribute;
+    "hide-powered-by"?: BooleanAttribute;
+    "no-background"?: BooleanAttribute;
+    "no-border"?: BooleanAttribute;
+}
+
+/**
+ * @deprecated Use `TokenFlightDepositConfig` instead.
+ *
+ * Configuration for `<tokenflight-fiat>`
+ */
+export declare interface TokenFlightFiatConfig extends TokenFlightConfigBase {
+    /** Optional: target token to purchase (user can select via TokenSelector if omitted) */
+    target?: TokenIdentifier;
+    /** Optional recipient address (if not using connected wallet) */
+    recipient?: string;
+    /** Fiat currency code (default: "USD") */
+    fiatCurrency?: string;
+    /** Optional icon URL for the target token */
+    icon?: string;
+    /** How to open the payment provider: "overlay" (iframe modal, default) or "popup" (new window). */
+    paymentMode?: FiatPaymentMode;
+}
+
+export declare interface TokenFlightFiatOptions {
+    container: string | HTMLElement;
+    config: TokenFlightFiatConfig;
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+}
+
+/** Attributes accepted by `<tokenflight-receive>`. */
+export declare interface TokenFlightReceiveAttributes {
+    "api-endpoint"?: string;
+    target?: string;
+    amount?: string;
+    "from-token"?: string;
+    recipient?: string;
+    "title-text"?: string;
+    "title-image"?: string;
+    theme?: Theme;
+    locale?: SupportedLocale;
+    "csp-nonce"?: string;
+    icon?: string;
+    "hide-title"?: BooleanAttribute;
+    "hide-powered-by"?: BooleanAttribute;
+    "no-background"?: BooleanAttribute;
+    "no-border"?: BooleanAttribute;
+}
+
+/** Configuration for the Receive component (EXACT_OUTPUT UX) */
+export declare interface TokenFlightReceiveConfig extends TokenFlightConfigBase {
+    /** Target token to receive (optional — user can select via TokenSelector if omitted) */
+    target?: TokenIdentifier;
+    /** Amount to receive (optional when amountEditable is true) */
+    amount?: string;
+    /** Optional source token to pay with */
+    fromToken?: TokenIdentifier;
+    /** Optional recipient address (for cross-chain swaps to a different address) */
+    recipient?: string;
+    /** Optional icon URL for the target token */
+    icon?: string;
+    /** Payment methods to offer (default: ["crypto"]) */
+    methods?: ("crypto" | "card")[];
+    /** Fiat currency code for card payments (default: "USD") */
+    fiatCurrency?: string;
+    /** How to open the fiat payment provider (default: "overlay") */
+    fiatPaymentMode?: FiatPaymentMode;
+    /** Allow user to edit the receive amount */
+    amountEditable?: boolean;
+    /** Whitelist of allowed source tokens (CAIP-10) */
+    fromTokens?: TokenIdentifier[];
+    /** Whitelist of allowed destination tokens (CAIP-10) */
+    toTokens?: TokenIdentifier[];
+}
+
+export declare interface TokenFlightReceiveOptions {
+    container: string | HTMLElement;
+    config: TokenFlightReceiveConfig;
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+}
+
+export declare const TokenFlightSwap: {
+    new (options: ImperativeWidgetOptions<TokenFlightSwapConfig>): {
+        #dispose: (() => void) | null;
+        #unwatchTheme: (() => void) | null;
+        #container: HTMLElement;
+        #shadowRoot: ShadowRoot | null;
+        #config: TokenFlightSwapConfig;
+        #walletAdapter?: IWalletAdapter;
+        #callbacks?: Callbacks;
+        initialize(): void;
+        destroy(): void;
+        setTheme(theme: Theme): void;
+        setCustomColors(colors: CustomColors): void;
+        #applyThemeStyles(style: HTMLStyleElement, theme: string): void;
+        #setupAutoThemeWatch(style: HTMLStyleElement): void;
+    };
+};
+
+/** Attributes accepted by `<tokenflight-swap>`. */
+export declare interface TokenFlightSwapAttributes {
+    "api-endpoint"?: string;
+    "from-token"?: string;
+    "to-token"?: string;
+    recipient?: string;
+    "title-text"?: string;
+    "title-image"?: string;
+    theme?: Theme;
+    locale?: SupportedLocale;
+    "csp-nonce"?: string;
+    "hide-title"?: BooleanAttribute;
+    "hide-powered-by"?: BooleanAttribute;
+    "no-background"?: BooleanAttribute;
+    "no-border"?: BooleanAttribute;
+}
+
+/** Configuration for `<tokenflight-swap>` */
+export declare interface TokenFlightSwapConfig extends TokenFlightConfigBase {
+    /** Optional source token */
+    fromToken?: TokenIdentifier;
+    /** Optional destination token */
+    toToken?: TokenIdentifier;
+    /** Optional recipient address (for cross-chain swaps to a different address) */
+    recipient?: string;
+}
+
+export declare interface TokenFlightSwapOptions {
+    container: string | HTMLElement;
+    config: TokenFlightSwapConfig;
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+}
+
+export declare const TokenFlightWidget: {
+    new (options: ImperativeWidgetOptions<TokenFlightWidgetConfig>): {
+        #dispose: (() => void) | null;
+        #unwatchTheme: (() => void) | null;
+        #container: HTMLElement;
+        #shadowRoot: ShadowRoot | null;
+        #config: TokenFlightWidgetConfig;
+        #walletAdapter?: IWalletAdapter;
+        #callbacks?: Callbacks;
+        initialize(): void;
+        destroy(): void;
+        setTheme(theme: Theme): void;
+        setCustomColors(colors: CustomColors): void;
+        #applyThemeStyles(style: HTMLStyleElement, theme: string): void;
+        #setupAutoThemeWatch(style: HTMLStyleElement): void;
+    };
+};
+
+/** Attributes accepted by `<tokenflight-widget>`. */
+export declare interface TokenFlightWidgetAttributes {
+    "api-endpoint"?: string;
+    "fiat-api-endpoint"?: string;
+    "to-token"?: string;
+    "from-token"?: string;
+    "trade-type"?: string;
+    amount?: string;
+    recipient?: string;
+    icon?: string;
+    "lock-from-token"?: BooleanAttribute;
+    "lock-to-token"?: BooleanAttribute;
+    "fiat-currency"?: string;
+    "fiat-payment-mode"?: string;
+    methods?: string;
+    "default-pay-method"?: "crypto" | "card";
+    "from-tokens"?: string;
+    "to-tokens"?: string;
+    "title-text"?: string;
+    "title-image"?: string;
+    theme?: Theme;
+    locale?: SupportedLocale;
+    "csp-nonce"?: string;
+    "hide-title"?: BooleanAttribute;
+    "hide-powered-by"?: BooleanAttribute;
+    "no-background"?: BooleanAttribute;
+    "no-border"?: BooleanAttribute;
+}
+
+/** Configuration for Widget component (auto-selects SwapV2 or Deposit UX based on config) */
+export declare interface TokenFlightWidgetConfig extends TokenFlightConfigBase {
+    /** Optional source token (crypto tab) */
+    fromToken?: TokenIdentifier;
+    /** Destination token(s) — array for launchpad multi-select */
+    toToken?: TokenIdentifier | TokenIdentifier[];
+    /** Trade direction: "EXACT_INPUT" (default) or "EXACT_OUTPUT" */
+    tradeType?: "EXACT_INPUT" | "EXACT_OUTPUT";
+    /** Amount value — interpreted as input or output based on tradeType */
+    amount?: string;
+    /** Optional recipient address */
+    recipient?: string;
+    /** Fiat currency code for card payments (default: "USD") */
+    fiatCurrency?: string;
+    /** How to open the fiat payment provider (default: "overlay") */
+    fiatPaymentMode?: FiatPaymentMode;
+    /** Whitelist of allowed source tokens (CAIP-10) */
+    fromTokens?: TokenIdentifier[];
+    /** Whitelist of allowed destination tokens (CAIP-10) */
+    toTokens?: TokenIdentifier[];
+    /** Optional icon URL for target token */
+    icon?: string;
+    /** Lock the from-token selector (disable changing) */
+    lockFromToken?: boolean;
+    /** Lock the to-token selector (disable changing) */
+    lockToToken?: boolean;
+}
+
+export declare interface TokenFlightWidgetOptions {
+    container: string | HTMLElement;
+    config: TokenFlightWidgetConfig;
+    walletAdapter?: IWalletAdapter;
+    callbacks?: Callbacks;
+}
+
+/**
+ * Flexible token identifier supporting:
+ * - Direct object: { chainId: 1, address: "0x..." }
+ * - CAIP-10 string: "eip155:1:0x..."
+ * - JSON string: '{"chainId":1,"address":"0x..."}'
+ */
+export declare type TokenIdentifier = string | TokenTarget;
+
+export { TokenInfo }
+
+export { TokenListResponse }
+
+export { TokenMeta }
+
+export { TokenSearchResponse }
+
+/** Token target as chain + address pair */
+export declare interface TokenTarget {
+    chainId: number;
+    address: string;
+}
+
+export { TradeType }
+
+/** Union of all wallet action types */
+export declare type WalletAction = EvmWalletAction | SolanaSignTransactionAction | SolanaSignAndSendAction;
+
+/** Result of executing a wallet action */
+export declare interface WalletActionResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    txHash?: string;
+}
+
+/** Wallet action types */
+export declare type WalletActionType = "eip1193_request" | "solana_signTransaction" | "solana_signAndSendTransaction";
+
+/** Data emitted when wallet is connected */
+export declare interface WalletConnectedData {
+    address: string;
+    chainType: string;
+}
+
+/** Wallet event payload */
+export declare interface WalletEvent {
+    type: WalletEventType;
+    data?: unknown;
+}
+
+/** Wallet event types */
+export declare type WalletEventType = "connect" | "disconnect" | "chainChanged" | "accountsChanged";
+
+export { }