@funkit/connect 9.7.2-next.0 → 9.8.0

package/dist/components/Dropdown/BaseDropdown.utils.d.ts

@@ -0,0 +1,23 @@
+export declare const NO_SELECTION_VALUE = "";
+export declare const ADDITIONAL_GROUP_KEY = "__additional__";
+export interface BaseDropdownOption<T = string> {
+    label: string;
+    value: T;
+}
+export interface BaseDropdownGroup<T = string, G extends string = never> {
+    key: G;
+    label: string;
+    values: T[];
+}
+export interface OrganizedDropdownGroup<T, G extends string> {
+    key: G | typeof ADDITIONAL_GROUP_KEY | typeof NO_SELECTION_VALUE;
+    label: string | undefined;
+    options: BaseDropdownOption<T>[];
+}
+export interface OrganizeDropdownGroupsResult<T, G extends string> {
+    organizedGroups: OrganizedDropdownGroup<T, G>[];
+    organizedOptions: BaseDropdownOption<T>[];
+}
+export declare function buildAllOptions<T extends string>(options: BaseDropdownOption<T>[], allowUnselect: boolean, unselectLabel?: string): BaseDropdownOption<T>[];
+export declare function filterOptions<T extends string>(allOptions: BaseDropdownOption<T>[], searchInput: string): BaseDropdownOption<T>[];
+export declare function organizeDropdownGroups<T extends string, G extends string>(filteredOptions: BaseDropdownOption<T>[], groups: BaseDropdownGroup<T, G>[] | undefined, additionalGroup: 'all' | 'others', additionalGroupLabel: string | undefined): OrganizeDropdownGroupsResult<T, G>;

package/dist/components/Dropdown/ChainDropdown.d.ts

@@ -23,7 +23,8 @@ interface ChainDropdownProps {
     alwaysOpenToTop?: BaseDropdownProps['alwaysOpenToTop'];
     maxDropdownHeight?: BaseDropdownProps['maxDropdownHeight'];
     tagComponent?: (value: string) => React.ReactNode;
+    placeholder?: string;
     testId?: string;
 }
-export declare const ChainDropdown: ({ assets, chainIdSortOrder, selectedChainId: propSelectedChainId, selectedToken, allowUnselect, onChainSelected, activeItemProps, size, openDropdownBackgroundColor, openDropdownFullWidth, isLoading, alwaysOpenToTop, maxDropdownHeight, tagComponent, testId, }: ChainDropdownProps) => React.JSX.Element;
+export declare const ChainDropdown: ({ assets, chainIdSortOrder, selectedChainId: propSelectedChainId, selectedToken, allowUnselect, onChainSelected, activeItemProps, size, openDropdownBackgroundColor, openDropdownFullWidth, isLoading, alwaysOpenToTop, maxDropdownHeight, tagComponent, placeholder, testId, }: ChainDropdownProps) => React.JSX.Element;
 export {};

package/dist/components/Dropdown/TokenAndChainDropdown.d.ts

@@ -3,8 +3,8 @@ import type { TokenTransferSourceChainsAndAssets } from '../../modals/CheckoutMo
 import type { BaseDropdownProps } from './BaseDropdown';
 interface TokenAndChainDropdownProps {
     isLoading: boolean;
-    selectedToken: string;
-    selectedChainId: number;
+    selectedToken: string | undefined;
+    selectedChainId: number | undefined;
     assets: TokenTransferSourceChainsAndAssets;
     /**
      * Callback fired after token selection
@@ -16,6 +16,10 @@ interface TokenAndChainDropdownProps {
     onChainSelected: (chainId?: number, autoUpdate?: boolean) => void;
     tokenLabel?: string;
     chainLabel?: string;
+    /** Placeholder shown in the token dropdown when no token is selected */
+    tokenPlaceholder?: string;
+    /** Placeholder shown in the chain dropdown when no chain is selected */
+    chainPlaceholder?: string;
     chainLabelAddon?: ReactNode;
     alwaysOpenToTop?: boolean;
     maxTokenDropdownHeight?: BaseDropdownProps['maxDropdownHeight'];
@@ -26,11 +30,13 @@ interface TokenAndChainDropdownProps {
      * Override to hide the new token badge
      */
     hideNewTokenBadge?: boolean;
+    /** Token symbols to show in a separate "Popular" group */
+    popularTokenSymbols?: string[];
     /** Token symbols to prioritize at top of dropdown */
     priorityTokenSymbols?: string[];
     /** Determines the chain display order */
     chainIdSortOrder?: number[];
 }
 /** Combines together chain and token dropdowns */
-export declare const TokenAndChainDropdown: ({ isLoading, selectedToken, selectedChainId, assets, onTokenSelected, onChainSelected, tokenLabel, chainLabel, chainLabelAddon, alwaysOpenToTop, maxTokenDropdownHeight, maxChainDropdownHeight, openChainDropdownFullWidth, chainTagComponent, hideNewTokenBadge, priorityTokenSymbols, chainIdSortOrder, }: TokenAndChainDropdownProps) => React.JSX.Element;
+export declare const TokenAndChainDropdown: ({ isLoading, selectedToken, selectedChainId, assets, onTokenSelected, onChainSelected, tokenLabel, chainLabel, tokenPlaceholder, chainPlaceholder, chainLabelAddon, alwaysOpenToTop, maxTokenDropdownHeight, maxChainDropdownHeight, openChainDropdownFullWidth, chainTagComponent, hideNewTokenBadge, popularTokenSymbols, priorityTokenSymbols, chainIdSortOrder, }: TokenAndChainDropdownProps) => React.JSX.Element;
 export {};

package/dist/components/Dropdown/TokenDropdown.d.ts

@@ -2,14 +2,14 @@ import React from 'react';
 import type { TokenTransferSourceChainsAndAssets } from '../../modals/CheckoutModal/TransferToken/TransferToken';
 import { type BaseDropdownProps } from './BaseDropdown';
 interface TokenDropdownProps {
-    selectedChainId: number;
+    selectedChainId: number | undefined;
     assets: TokenTransferSourceChainsAndAssets;
     onTokenSelected: (token: string, chainId?: number, 
     /**
      * If true, it will trigger automatic updates for the matching chain in the parent component.
      */
     autoUpdate?: boolean) => void;
-    selectedToken?: string;
+    selectedToken: string | undefined;
     isLoading?: BaseDropdownProps['isLoading'];
     alwaysOpenToTop?: BaseDropdownProps['alwaysOpenToTop'];
     maxDropdownHeight?: BaseDropdownProps['maxDropdownHeight'];
@@ -17,12 +17,16 @@ interface TokenDropdownProps {
      * Override to hide the new token badge
      */
     hideNewTokenBadge?: boolean;
+    /** Token symbols to show in a separate "Popular" group */
+    popularTokenSymbols?: string[];
     /** Token symbols to prioritize at top of dropdown */
     priorityTokenSymbols?: string[];
+    /** Placeholder shown when no token is selected */
+    placeholder?: string;
     /**
      * Test ID for the token dropdown
      */
     testId?: string;
 }
-export declare const TokenDropdown: ({ assets, selectedChainId, selectedToken, onTokenSelected, isLoading, alwaysOpenToTop, maxDropdownHeight, hideNewTokenBadge, priorityTokenSymbols, testId, }: TokenDropdownProps) => React.JSX.Element;
+export declare const TokenDropdown: ({ assets, selectedChainId, selectedToken, onTokenSelected, isLoading, alwaysOpenToTop, maxDropdownHeight, hideNewTokenBadge, popularTokenSymbols, priorityTokenSymbols, placeholder, testId, }: TokenDropdownProps) => React.JSX.Element;
 export {};

package/dist/domains/asset.d.ts

@@ -8,7 +8,6 @@ import { PaymentMethod } from '../domains/paymentMethods';
  * Accounts for the customer's configured minimum deposit and a global floor.
  */
 export declare function getMinValueThreshold(config: FunkitCheckoutConfig | undefined, minUsdRequired?: number): number;
-export declare const isStablecoin: (symbol: string) => boolean;
 export declare function isPreferredChain(chainId: number, additionalChains?: number[]): boolean;
 export declare function isNativeTokenAddress(address: Address): boolean;
 export declare function isDefaultToken(asset: AssetHoldingsItem, checkoutConfig: FunkitCheckoutConfig): boolean;

package/dist/domains/quoteMode/exactOut.d.ts

@@ -1,2 +1,3 @@
+import type { IsStablecoinFn } from '../../hooks/useIsStablecoin';
 import { type QuoteBuilder } from './types';
-export declare function createExactOutBuilder(): QuoteBuilder;
+export declare function createExactOutBuilder(isStablecoin: IsStablecoinFn): QuoteBuilder;

package/dist/domains/quoteMode/resolveQuoteMode.d.ts

@@ -1,7 +1,9 @@
+import type { IsStablecoinFn } from '../../hooks/useIsStablecoin';
 import { type QuoteBuilder } from './types';
 export interface ResolveQuoteBuilderParams {
     hasPostAction: boolean | undefined;
     isExactInEnabled: boolean;
+    isStablecoin: IsStablecoinFn;
     providerSupportsExactInWithActions?: boolean;
 }
 /**
@@ -17,4 +19,4 @@ export interface ResolveQuoteBuilderParams {
  * Note: ONE_TO_ONE (subsidized routes) is not yet auto-detected.
  * It will be enabled in a future phase when subsidy detection is implemented.
  */
-export declare function resolveQuoteBuilder({ hasPostAction, isExactInEnabled, providerSupportsExactInWithActions, }: ResolveQuoteBuilderParams): QuoteBuilder;
+export declare function resolveQuoteBuilder({ hasPostAction, isExactInEnabled, isStablecoin, providerSupportsExactInWithActions, }: ResolveQuoteBuilderParams): QuoteBuilder;

package/dist/hooks/queries/useWithdrawalQuote.d.ts

@@ -1,9 +1,9 @@
 import { type FunkitWithdrawalConfig } from '../../providers/FunkitCheckoutContext';
 interface CheckoutQuoteParams {
     recipientAddress: string;
-    selectedChainId: string;
+    selectedChainId: string | undefined;
     selectedTokenAddress: string | null | undefined;
-    selectedTokenSymbol: string;
+    selectedTokenSymbol: string | undefined;
     config: FunkitWithdrawalConfig;
 }
 /**
@@ -11,7 +11,6 @@ interface CheckoutQuoteParams {
  */
 export declare function useWithdrawalQuote({ recipientAddress, selectedChainId, selectedTokenAddress, selectedTokenSymbol, config, }: CheckoutQuoteParams): {
     quoteEnabled: boolean;
-    isInstantQuoting: boolean;
     data: {
         baseQuote: import("@funkit/utils").CheckoutQuoteResponse;
         checkedAssetAmount: import("../../domains/quote").CheckedAssetAmount;
@@ -51,7 +50,6 @@ export declare function useWithdrawalQuote({ recipientAddress, selectedChainId,
     } | null>;
 } | {
     quoteEnabled: boolean;
-    isInstantQuoting: boolean;
     data: {
         baseQuote: import("@funkit/utils").CheckoutQuoteResponse;
         checkedAssetAmount: import("../../domains/quote").CheckedAssetAmount;
@@ -91,7 +89,6 @@ export declare function useWithdrawalQuote({ recipientAddress, selectedChainId,
     } | null>;
 } | {
     quoteEnabled: boolean;
-    isInstantQuoting: boolean;
     data: undefined;
     error: Error;
     isError: true;
@@ -127,7 +124,6 @@ export declare function useWithdrawalQuote({ recipientAddress, selectedChainId,
     } | null>;
 } | {
     quoteEnabled: boolean;
-    isInstantQuoting: boolean;
     data: undefined;
     error: null;
     isError: false;
@@ -163,7 +159,6 @@ export declare function useWithdrawalQuote({ recipientAddress, selectedChainId,
     } | null>;
 } | {
     quoteEnabled: boolean;
-    isInstantQuoting: boolean;
     data: undefined;
     error: null;
     isError: false;
@@ -199,7 +194,6 @@ export declare function useWithdrawalQuote({ recipientAddress, selectedChainId,
     } | null>;
 } | {
     quoteEnabled: boolean;
-    isInstantQuoting: boolean;
     data: {
         baseQuote: import("@funkit/utils").CheckoutQuoteResponse;
         checkedAssetAmount: import("../../domains/quote").CheckedAssetAmount;

package/dist/hooks/useCheckoutDirectExecution.d.ts

@@ -4,7 +4,7 @@ import type { CheckoutQuoteResponse } from '@funkit/utils';
 import type { Address, Hex } from 'viem';
 import type { FunkitCheckoutQuoteResult } from '../domains/quote';
 import type { FunkitActiveCheckoutItem, FunkitCheckoutActionParams } from '../providers/FunkitCheckoutContext';
-import type { WithdrawalClient } from '../wallets/Wallet';
+import { type WithdrawalClient } from '../wallets/Wallet';
 interface DirectExecutionQuoteRequestParamsBase {
     actionParams: FunkitCheckoutActionParams[];
     bridgeOverride?: 'across' | 'relay';

package/dist/hooks/useIsStablecoin.d.ts

@@ -0,0 +1,2 @@
+export type IsStablecoinFn = (symbol: string) => boolean;
+export declare const useIsStablecoin: () => IsStablecoinFn;

package/dist/hooks/useTokenAndChainDropdown.d.ts

@@ -6,21 +6,27 @@ export type TransferTokenDefault = {
 };
 interface UseTokenChainResult {
     assets: TokenTransferSourceChainsAndAssets;
-    selectedChainId: number;
+    selectedChainId: number | undefined;
     handleChainChange: (chainId?: number, autoUpdate?: boolean) => void;
-    selectedToken: string;
-    selectedChainName: string;
+    selectedToken: string | undefined;
+    selectedChainName: string | undefined;
     handleTokenChange: (token: string, chainId?: number, autoUpdate?: boolean) => void;
     isLoadingAssets: boolean;
     chainIdSortOrder: number[];
+    popularTokenSymbols: string[];
     priorityTokenSymbols: string[];
 }
+export interface UseTokenAndChainDropdownOptions {
+    transferInit?: CheckoutInitTokenTransferResponse;
+    defaultValues?: TransferTokenDefault;
+    /** When true, uses legacy withdrawal flags instead of Statsig config. Defaults to false. */
+    isWithdrawal?: boolean;
+    /** When true, starts with no chain/token pre-selected (user must pick both). Defaults to false. */
+    noDefaultSelection?: boolean;
+}
 /**
  * Semi reusable hook (tied into token transfer configuration)
  * ensures token&chain dropdown preselection logic is reusable
- * @param transferInit - deposit address availability (solana/btc/tron filtering)
- * @param defaultValues - caller-provided overrides (e.g. from UDA params or navigation state)
- * @param isWithdrawal - when true, uses legacy withdrawal flags instead of Statsig config
  */
-export declare const useTokenAndChainDropdown: (transferInit: CheckoutInitTokenTransferResponse | undefined, defaultValues?: TransferTokenDefault, isWithdrawal?: boolean) => UseTokenChainResult;
+export declare const useTokenAndChainDropdown: ({ defaultValues, isWithdrawal, noDefaultSelection, transferInit, }: UseTokenAndChainDropdownOptions) => UseTokenChainResult;
 export {};

package/dist/hooks/useTokenTransfer.d.ts

@@ -26,7 +26,7 @@ interface UseTokenTransferResult {
     qrCodeUri: QRCodeUri | undefined;
     blockchain: 'ethereum' | 'solana' | 'bitcoin' | 'tron';
 }
-export declare const useTokenTransfer: (selectedChainId: number, selectedToken: string, chainIds?: number[]) => UseTokenTransferResult;
+export declare const useTokenTransfer: (selectedChainId: number | undefined, selectedToken: string | undefined, chainIds?: number[]) => UseTokenTransferResult;
 export declare function getMinTransferValueForChain(chainId: number, limits: MinTransferConfig): number;
-export declare const useMinTransferValue: (selectedChainId: number) => number;
+export declare const useMinTransferValue: (selectedChainId: number | undefined) => number;
 export {};