@tokenflight/swap 0.2.3 → 0.3.0-rc.1

package/dist/tokenflight-swap.d.ts

@@ -1,11 +1,4 @@
-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';
@@ -18,30 +11,11 @@ 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 { HyperstreamApi } 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';
 import * as v from 'valibot';
 
 /**
@@ -68,9 +42,24 @@ declare type BooleanAttribute = boolean | "true" | "false" | "1" | "0" | "yes" |
  */
 export declare function buildOffersForRanking(routes: readonly QuoteRoute[], tradeType: TradeType | null): OfferForRanking[];
 
-/** Callback interfaces for widget events */
+/**
+ * Callback interfaces for widget events.
+ *
+ * **Crypto outcome routing** (mutually exclusive — pick the channel that matches
+ * the active flow):
+ * - `EXACT_INPUT` (`<tokenflight-widget trade-type="EXACT_INPUT">` / default,
+ *   "spend exactly N of X") → fires `onSwapSuccess` / `onSwapError`
+ * - `EXACT_OUTPUT` (`<tokenflight-widget trade-type="EXACT_OUTPUT">`,
+ *   "receive exactly N of Y") → fires `onDepositSuccess` / `onDepositError`
+ *
+ * **Fiat (card) outcomes** route through the same `onSwap*` / `onDeposit*`
+ * channels for errors (matched to the host flow) and through
+ * `onFiatOrderCreated` / `onFiatOrderCompleted` for fiat-specific lifecycle.
+ */
 export declare interface Callbacks {
+    /** EXACT_INPUT crypto success. */
     onSwapSuccess?(data: SwapSuccessData): void;
+    /** EXACT_INPUT errors (crypto execution + card flow when in EXACT_INPUT mode). */
     onSwapError?(data: SwapErrorData): void;
     onWalletConnected?(data: WalletConnectedData): void;
     onQuoteReceived?(data: QuoteResponse): void;
@@ -90,13 +79,13 @@ export declare interface Callbacks {
         status: string;
         txHash?: string;
     }): void;
-    /** Called when a deposit completes successfully */
+    /** EXACT_OUTPUT crypto success. */
     onDepositSuccess?(data: SwapSuccessData): void;
-    /** Called when a deposit fails */
+    /** EXACT_OUTPUT errors (crypto execution + card flow when in EXACT_OUTPUT mode). */
     onDepositError?(data: SwapErrorData): void;
 }
 
-export { ChainInfo }
+export declare type ChainInfo = HyperstreamApi.Chain;
 
 /** Chain type for multi-chain support */
 export declare type ChainType = "evm" | "solana";
@@ -110,7 +99,7 @@ export declare function clearTokenCache(): void;
  */
 export declare function computeExchangeRate(amountIn: string, decimalsIn: number, amountOut: string, decimalsOut: number): string;
 
-export { ContractCallDeposit }
+export declare type ContractCallDeposit = HyperstreamApi.ContractCallDeposit;
 
 /**
  * Custom color overrides — keys are CSS variable names.
@@ -129,32 +118,45 @@ export declare type CustomColors = Partial<Record<TfCssVar, string>> & Record<st
 
 export { DEFAULT_API_ENDPOINT }
 
-export { DepositApproval }
-
-export { DepositBuildResponse }
-
-/** Payment methods available in `<tokenflight-deposit>` */
-export declare type DepositMethod = "wallet" | "card";
+export declare type DepositApproval = HyperstreamApi.Approval;
 
-/** 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;
-}
+export declare type DepositBuildResponse = HyperstreamApi.Deposit;
 
-/** @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 declare type EIP1193RequestApproval = HyperstreamApi.EIP1193RequestApproval;
 
-export { EIP1193RequestApproval }
+/**
+ * Swap-side error codes for failures that originate inside the widget
+ * itself (config validation, wallet interaction, transaction signing).
+ * Merged with the API codes from `@tokenflight/api` into a unified
+ * `ErrorCode` constant so callers only see one enum.
+ */
+export declare const ErrorCode: {
+    readonly INVALID_CONFIG: "TF1001";
+    readonly INVALID_TOKEN_IDENTIFIER: "TF1002";
+    readonly INVALID_AMOUNT: "TF1003";
+    readonly WALLET_CONNECTION_FAILED: "TF2002";
+    readonly WALLET_ACTION_FAILED: "TF2003";
+    readonly TRANSACTION_FAILED: "TF4001";
+    readonly ELEMENT_NOT_FOUND: "TF5001";
+    readonly API_REQUEST_FAILED: "TF3001";
+    readonly API_TIMEOUT: "TF3002";
+    readonly API_INVALID_RESPONSE: "TF3003";
+    readonly QUOTE_FAILED: "TF3004";
+    readonly QUOTE_EXPIRED: "TF3005";
+    readonly DEPOSIT_BUILD_FAILED: "TF3006";
+    readonly DEPOSIT_SUBMIT_FAILED: "TF3007";
+    readonly ORDER_FAILED: "TF3008";
+    readonly API_ABORTED: "TF3009";
+    readonly FIAT_QUOTE_FAILED: "TF6001";
+    readonly FIAT_ORDER_FAILED: "TF6002";
+    readonly FIAT_STATUS_FAILED: "TF6003";
+    readonly FIAT_PROVIDER_ERROR: "TF6004";
+    readonly FIAT_AMOUNT_OUT_OF_RANGE: "TF6005";
+    readonly FIAT_POPUP_BLOCKED: "TF6006";
+    readonly FIAT_CHECKOUT_UNAVAILABLE: "TF6007";
+};
 
-export { ErrorCode }
+export declare type ErrorCode = typeof ErrorCode[keyof typeof ErrorCode];
 
 /** EVM wallet action via EIP-1193 */
 export declare interface EvmWalletAction {
@@ -164,7 +166,7 @@ export declare interface EvmWalletAction {
     params: unknown[];
 }
 
-export { ExactOutMethod }
+export declare type ExactOutMethod = HyperstreamApi.ExactOutMethod;
 
 /** Execution-only phases for the async build→wallet→submit→track→success flow */
 export declare type ExecPhase = "building" | "awaiting-wallet" | "submitting" | "tracking" | "success";
@@ -214,16 +216,6 @@ export declare function getBestOverallRouteId(routes: readonly QuoteRoute[], tra
 /** Get chain type from chainId */
 export declare function getChainType(chainId: number): "evm" | "solana";
 
-/**
- * Fetch and parse the shared `defaults.json` payload. Memoized — subsequent
- * calls return the same in-flight or resolved promise.
- *
- * Silently resolves to `null` on any failure (network error, non-2xx status,
- * parse error, schema mismatch, timeout). Host code is expected to fall back
- * to hardcoded defaults when `null` is returned.
- */
-export declare function getDefaults(): Promise<WidgetDefaults | null>;
-
 declare interface ImperativeWidgetOptions<TConfig> {
     container: string | HTMLElement;
     config: TConfig;
@@ -303,23 +295,26 @@ declare interface OfferForRanking {
     isOneClick: boolean;
 }
 
-export { OnChainTx }
+export declare type OnChainTx = HyperstreamApi.OnChainTx;
+
+export declare type OrderListResponse = HyperstreamApi.GetOrderResponse;
 
-export { OrderListResponse }
+export declare type OrderResponse = HyperstreamApi.Order;
 
-export { OrderResponse }
+export declare type OrderStatus = HyperstreamApi.OrderStatus;
 
-export { OrderStatus }
+export declare type OrderTimestamps = HyperstreamApi.OrderTimestamps;
 
-export { OrderTimestamps }
+export declare type OrderTransactions = HyperstreamApi.OrderTransactions;
 
-export { OrderTransactions }
+/** Quote detail card display mode. */
+export declare type QuoteCardVisibility = "hidden" | "visible";
 
-export { QuoteRequest }
+export declare type QuoteRequest = HyperstreamApi.QuoteRequest;
 
-export { QuoteResponse }
+export declare type QuoteResponse = HyperstreamApi.GetQuotesResponse;
 
-export { QuoteRoute }
+export declare type QuoteRoute = HyperstreamApi.Route;
 
 /**
  * Rank offers where lower input amount is better (EXACT_OUTPUT).
@@ -333,7 +328,8 @@ export declare function rankOffers(offers: readonly OfferForRanking[]): string[]
 export declare type ReceiveMode = "crypto" | "fiat" | "all";
 
 /**
- * Non-derivable state for `<tokenflight-receive>`.
+ * Non-derivable state for the Receive (EXACT_OUTPUT) flow inside
+ * `<tokenflight-widget>`.
  *
  * Derivable values (phase, selectedQuote, paymentTokens) are computed in
  * ReceiveComponent from payTokenQuotes + loadingQuotes + these signals.
@@ -353,8 +349,6 @@ export declare interface ReceiveState {
     errorCode: string | null;
 }
 
-export declare function registerDepositElement(options?: RegisterElementsOptions): void;
-
 export declare function registerElements(options?: RegisterElementsOptions): void;
 
 export declare interface RegisterElementsOptions {
@@ -395,15 +389,22 @@ export declare interface RegisterElementsOptions {
     referrerFeeBps?: number;
 }
 
-export declare function registerSwapElement(options?: RegisterElementsOptions): void;
-
 export declare function registerWidgetElement(options?: RegisterElementsOptions): void;
 
-export { ResolvedToken }
+/** Resolved token with full metadata for local display state */
+export declare interface ResolvedToken {
+    chainId: number;
+    address: string;
+    symbol?: string;
+    name?: string;
+    decimals?: number;
+    logoURI?: string;
+    priceUsd?: number;
+}
 
-export { RouteQuote }
+export declare type RouteQuote = HyperstreamApi.Quote;
 
-export { RouteTag }
+export declare type RouteTag = HyperstreamApi.RouteTag;
 
 /**
  * Imperatively set UI text overrides. Equivalent to
@@ -415,7 +416,7 @@ export declare function setTextOverrides(overrides: TextOverrides | undefined):
 /** Chain ID for Solana mainnet in the API */
 export declare const SOLANA_CHAIN_ID = 20011000000;
 
-export { SolanaApproval }
+export declare type SolanaApproval = HyperstreamApi.SolanaApproval;
 
 /** Solana sign and send transaction action */
 export declare interface SolanaSignAndSendAction {
@@ -429,7 +430,7 @@ export declare interface SolanaSignTransactionAction {
     transaction: string;
 }
 
-export { SubmitDepositResponse }
+export declare type SubmitDepositResponse = HyperstreamApi.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 & {});
@@ -459,9 +460,6 @@ export declare interface SwapSuccessData {
     txHash: string;
 }
 
-/** @deprecated Use `SwapPayMethod` instead. */
-declare type SwapV2PayMethod = SwapPayMethod;
-
 export { TERMINAL_FIAT_STATUSES }
 
 export { TERMINAL_ORDER_STATUSES }
@@ -516,7 +514,7 @@ export declare interface TextOverrides {
 }
 
 /** 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" | "--tf-font-size" | "--tf-line-height";
+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" | "--tf-font-size" | "--tf-line-height" | "--tf-font-sm" | "--tf-font-base" | "--tf-font-md" | "--tf-font-lg" | "--tf-font-xl" | "--tf-font-heading" | "--tf-font-amount" | "--tf-font-amount-lg" | "--tf-font-amount-sm";
 
 /** Visual theme mode. */
 export declare type Theme = "light" | "dark" | "auto";
@@ -535,13 +533,13 @@ export declare function toBaseUnits(displayAmount: string, decimals: number): st
  */
 export declare function toDisplayAmount(baseUnits: string, decimals: number): string;
 
-export { TokenExtensions }
+export declare type TokenExtensions = HyperstreamApi.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) */
+    /** Fiat on-ramp API endpoint (default: https://fiat.hyperstream.dev) */
     fiatApiEndpoint?: string;
     /** Visual theme */
     theme?: Theme;
@@ -559,6 +557,8 @@ export declare interface TokenFlightConfigBase {
     hidePoweredBy?: boolean;
     /** Hide the "via {provider}" badge on the order tracking page */
     hideProvider?: boolean;
+    /** Quote card display mode. EXACT_INPUT Swap defaults to "hidden". */
+    quoteCard?: QuoteCardVisibility;
     /** Remove container background (transparent) */
     noBackground?: boolean;
     /** Remove container border and shadow */
@@ -575,53 +575,6 @@ export declare interface TokenFlightConfigBase {
     referrerFeeBps?: number;
 }
 
-/** 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;
-    "title-text"?: string;
-    "title-image"?: string;
-    theme?: Theme;
-    locale?: SupportedLocale;
-    "csp-nonce"?: string;
-    "hide-title"?: BooleanAttribute;
-    "hide-powered-by"?: BooleanAttribute;
-    "hide-provider"?: 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;
-}
-
-export declare interface TokenFlightDepositOptions {
-    container: string | HTMLElement;
-    config: TokenFlightDepositConfig;
-    walletAdapter?: IWalletAdapter;
-    callbacks?: Callbacks;
-}
-
 export { TokenFlightError }
 
 /** Attributes accepted by `<tokenflight-fiat>`. */
@@ -643,165 +596,6 @@ export declare interface TokenFlightFiatAttributes {
     "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;
-}
-
-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;
-    "hide-provider"?: 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;
-    /**
-     * When true, the recipient badge stays editable even if `recipient` is preset.
-     * Default: false — presetting `recipient` locks the badge.
-     */
-    recipientEditable?: boolean;
-    /** Address the filler should refund to if the fill fails (sent as `refundTo` on quote requests). */
-    refundTo?: 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;
-    /** 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;
-    "hide-provider"?: BooleanAttribute;
-    "no-background"?: BooleanAttribute;
-    "no-border"?: BooleanAttribute;
-}
-
-/** Configuration for `<tokenflight-swap>` and `<tokenflight-widget>` swap mode */
-export declare interface TokenFlightSwapConfig extends TokenFlightConfigBase {
-    /** Optional source token (crypto tab) */
-    fromToken?: TokenIdentifier;
-    /** Optional destination token */
-    toToken?: TokenIdentifier;
-    /** Optional recipient address */
-    recipient?: string;
-    /**
-     * When true, the recipient badge stays editable even if `recipient` is preset.
-     * Default: false — presetting `recipient` locks the badge.
-     */
-    recipientEditable?: boolean;
-    /** Address the filler should refund to if the fill fails (sent as `refundTo` on quote requests). */
-    refundTo?: string;
-    /** Trade direction: "EXACT_INPUT" (default) = amount is input, "EXACT_OUTPUT" = amount is output */
-    tradeType?: "EXACT_INPUT" | "EXACT_OUTPUT";
-    /** Amount value — interpreted as input or output based on tradeType */
-    amount?: string;
-    /** Payment methods to offer (default: ["crypto"]) */
-    methods?: SwapPayMethod[];
-    /** Default active pay method tab (default: "crypto") */
-    defaultPayMethod?: SwapPayMethod;
-    /** Fiat currency code for card payments (default: "USD") */
-    fiatCurrency?: string;
-    /** Whitelist of allowed source tokens (CAIP-10) */
-    fromTokens?: TokenIdentifier[];
-    /** Whitelist of allowed destination tokens (CAIP-10) */
-    toTokens?: TokenIdentifier[];
-    /** Lock the from-token selector (disable changing) */
-    lockFromToken?: boolean;
-    /** Lock the to-token selector (disable changing) */
-    lockToToken?: boolean;
-}
-
-export declare interface TokenFlightSwapOptions {
-    container: string | HTMLElement;
-    config: TokenFlightSwapConfig;
-    walletAdapter?: IWalletAdapter;
-    callbacks?: Callbacks;
-}
-
 export declare const TokenFlightWidget: {
     new (options: ImperativeWidgetOptions<TokenFlightWidgetConfig>): {
         #dispose: (() => void) | null;
@@ -829,6 +623,8 @@ export declare interface TokenFlightWidgetAttributes {
     "trade-type"?: string;
     amount?: string;
     recipient?: string;
+    "recipient-editable"?: BooleanAttribute;
+    "refund-to"?: string;
     icon?: string;
     "lock-from-token"?: BooleanAttribute;
     "lock-to-token"?: BooleanAttribute;
@@ -837,6 +633,7 @@ export declare interface TokenFlightWidgetAttributes {
     "default-pay-method"?: "crypto" | "card";
     "from-tokens"?: string;
     "to-tokens"?: string;
+    "rpc-overrides"?: string;
     "title-text"?: string;
     "title-image"?: string;
     theme?: Theme;
@@ -845,6 +642,7 @@ export declare interface TokenFlightWidgetAttributes {
     "hide-title"?: BooleanAttribute;
     "hide-powered-by"?: BooleanAttribute;
     "hide-provider"?: BooleanAttribute;
+    "quote-card"?: "hidden" | "visible";
     "no-background"?: BooleanAttribute;
     "no-border"?: BooleanAttribute;
     "referrer"?: string;
@@ -871,9 +669,9 @@ export declare interface TokenFlightWidgetConfig extends TokenFlightConfigBase {
     /** Address the filler should refund to if the fill fails (sent as `refundTo` on quote requests). */
     refundTo?: string;
     /** Payment methods to offer (default: ["crypto"]) */
-    methods?: SwapV2PayMethod[];
+    methods?: SwapPayMethod[];
     /** Default active pay method tab (default: "crypto") */
-    defaultPayMethod?: SwapV2PayMethod;
+    defaultPayMethod?: SwapPayMethod;
     /** Fiat currency code for card payments (default: "USD") */
     fiatCurrency?: string;
     /** Whitelist of allowed source tokens (CAIP-10) */
@@ -903,13 +701,13 @@ export declare interface TokenFlightWidgetOptions {
  */
 export declare type TokenIdentifier = string | TokenTarget;
 
-export { TokenInfo }
+export declare type TokenInfo = HyperstreamApi.Token;
 
-export { TokenListResponse }
+export declare type TokenListResponse = HyperstreamApi.GetTokensResponse;
 
-export { TokenMeta }
+export declare type TokenMeta = HyperstreamApi.TokenMeta;
 
-export { TokenSearchResponse }
+export declare type TokenSearchResponse = HyperstreamApi.TokenSearchResponse;
 
 /** Token target as chain + address pair */
 export declare interface TokenTarget {
@@ -917,7 +715,7 @@ export declare interface TokenTarget {
     address: string;
 }
 
-export { TradeType }
+export declare type TradeType = HyperstreamApi.TradeType;
 
 /** Union of all wallet action types */
 export declare type WalletAction = EvmWalletAction | SolanaSignTransactionAction | SolanaSignAndSendAction;
@@ -1004,7 +802,7 @@ declare const WidgetDefaultsSchema: Omit<v.ObjectSchema<{
         hideProvider?: boolean | undefined;
         noBackground?: boolean | undefined;
         noBorder?: boolean | undefined;
-        methods?: ("card" | "crypto")[] | undefined;
+        methods?: ("crypto" | "card")[] | undefined;
         supportedChainIds?: number[] | undefined;
         rpcOverrides?: {
             [x: string]: string;
@@ -1023,7 +821,7 @@ declare const WidgetDefaultsSchema: Omit<v.ObjectSchema<{
         hideProvider?: boolean | undefined;
         noBackground?: boolean | undefined;
         noBorder?: boolean | undefined;
-        methods?: ("card" | "crypto")[] | undefined;
+        methods?: ("crypto" | "card")[] | undefined;
         supportedChainIds?: number[] | undefined;
         rpcOverrides?: {
             [x: string]: string;
@@ -1043,7 +841,7 @@ declare const WidgetDefaultsSchema: Omit<v.ObjectSchema<{
         hideProvider?: boolean | undefined;
         noBackground?: boolean | undefined;
         noBorder?: boolean | undefined;
-        methods?: ("card" | "crypto")[] | undefined;
+        methods?: ("crypto" | "card")[] | undefined;
         supportedChainIds?: number[] | undefined;
         rpcOverrides?: {
             [x: string]: string;
@@ -1064,7 +862,7 @@ declare const WidgetDefaultsSchema: Omit<v.ObjectSchema<{
             hideProvider?: boolean | undefined;
             noBackground?: boolean | undefined;
             noBorder?: boolean | undefined;
-            methods?: ("card" | "crypto")[] | undefined;
+            methods?: ("crypto" | "card")[] | undefined;
             supportedChainIds?: number[] | undefined;
             rpcOverrides?: {
                 [x: string]: string;
@@ -1084,7 +882,7 @@ declare const WidgetDefaultsSchema: Omit<v.ObjectSchema<{
             hideProvider?: boolean | undefined;
             noBackground?: boolean | undefined;
             noBorder?: boolean | undefined;
-            methods?: ("card" | "crypto")[] | undefined;
+            methods?: ("crypto" | "card")[] | undefined;
             supportedChainIds?: number[] | undefined;
             rpcOverrides?: {
                 [x: string]: string;