@nexus-cross/dapp-ui 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/index.d.cts

@@ -109,6 +109,22 @@ interface TokenStatsResponse {
     data: TokenStats[];
 }
 
+/**
+ * 포트폴리오 내부에서 트랜잭션을 실제로 서명/브로드캐스트할 때 호출하는 콜백.
+ *
+ * 주입되는 지갑 스택(wagmi, viem, 자체 SDK 등)에 관계없이 동일한 계약으로
+ * 동작시키기 위한 최소 공통 시그니처다. wagmi의 `sendTransactionAsync`를
+ * 그대로 전달해도 호환된다.
+ */
+interface SendTransactionArgs {
+    to: `0x${string}`;
+    value?: bigint;
+    data?: `0x${string}`;
+    chainId?: number;
+    gas?: bigint;
+}
+type SendTransactionFn = (args: SendTransactionArgs) => Promise<`0x${string}`>;
+
 interface WalletInfoTriggerProps {
     asChild?: boolean;
     className?: string;
@@ -161,11 +177,19 @@ interface WalletInfoProps {
     onDisconnect?: () => void;
     /** 기본 Disconnect 버튼 라벨 (기본 "Disconnect"). */
     disconnectLabel?: string;
-    /** Footer 하단 Terms 링크 URL. 지정 시에만 노출. */
+    /**
+     * Footer 하단 Terms 링크 URL.
+     * 미지정 시 CROSS 에코시스템 기본 URL로 폴백되어 자동 노출된다.
+     * 숨기려면 빈 문자열(`""`)을 전달.
+     */
     termsUrl?: string;
     /** Terms 링크 라벨 (기본 "Terms of Service"). */
     termsLabel?: string;
-    /** Footer 하단 Privacy 링크 URL. 지정 시에만 노출. */
+    /**
+     * Footer 하단 Privacy 링크 URL.
+     * 미지정 시 CROSS 에코시스템 기본 URL로 폴백되어 자동 노출된다.
+     * 숨기려면 빈 문자열(`""`)을 전달.
+     */
     privacyUrl?: string;
     /** Privacy 링크 라벨 (기본 "Privacy Policy"). */
     privacyLabel?: string;
@@ -183,10 +207,17 @@ interface WalletInfoProps {
     showTotalAssets?: boolean;
     /** Total Assets 라벨 텍스트 (기본 "Total Assets USD"). */
     totalAssetsLabel?: string;
+    /**
+     * 외부(dApp)에서 주입하는 트랜잭션 전송 함수.
+     * `showPortfolio=true`일 때 내부 `WalletPortfolioBody`로 그대로 전달되어
+     * 포트폴리오 섹션에서 토큰 전송 액션을 실행할 때 호출된다.
+     * wagmi의 `sendTransactionAsync`를 그대로 전달해도 호환된다.
+     */
+    sendTransaction?: SendTransactionFn;
     style?: WalletInfoStyle;
     children: React.ReactNode;
 }
-declare function WalletInfoRoot({ env, theme, mobileBreakpoint, drawerDirection, modal, showBalance, showForgeToken, showGameToken, showQR, qrLogoSrc, walletAddress, accountName, profileImageUrl, connectorId, connectorName: connectorNameProp, connectorIconUrl: connectorIconUrlProp, preferredTokens, onSelectWallet, onCopyAddress, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, showTotalAssets, totalAssetsLabel, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
+declare function WalletInfoRoot({ env, theme, mobileBreakpoint, drawerDirection, modal, showBalance, showForgeToken, showGameToken, showQR, qrLogoSrc, walletAddress, accountName, profileImageUrl, connectorId, connectorName: connectorNameProp, connectorIconUrl: connectorIconUrlProp, preferredTokens, onSelectWallet, onCopyAddress, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, showTotalAssets, totalAssetsLabel, sendTransaction, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
 declare const WalletInfo: typeof WalletInfoRoot & {
     Trigger: typeof WalletInfoTrigger;
     Content: typeof WalletInfoContent;
@@ -383,9 +414,16 @@ interface WalletPortfolioProps {
     walletAddress: string;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * 외부(dApp)에서 주입하는 트랜잭션 전송 함수.
+     * 포트폴리오 내부에서 구성한 트랜잭션 페이로드를 실제 서명/브로드캐스트할 때
+     * 이 함수가 호출된다. 연결된 지갑 스택(wagmi, viem, 자체 SDK 등)에
+     * 종속되지 않도록 외부에서 주입한다.
+     */
+    sendTransaction?: SendTransactionFn;
     children: React.ReactNode;
 }
-declare function WalletPortfolioRoot({ env, theme, walletAddress, open: propOpen, onOpenChange, children, }: WalletPortfolioProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioRoot({ env, theme, walletAddress, open: propOpen, onOpenChange, sendTransaction, children, }: WalletPortfolioProps): react_jsx_runtime.JSX.Element;
 declare const WalletPortfolio: typeof WalletPortfolioRoot & {
     Trigger: typeof WalletPortfolioTrigger;
     Content: typeof WalletPortfolioContent;
@@ -407,8 +445,14 @@ interface WalletPortfolioBodyProps {
      */
     variant?: "fullscreen" | "embed" | "none";
     className?: string;
+    /**
+     * 외부(dApp)에서 주입하는 트랜잭션 전송 함수.
+     * `WalletPortfolio` 루트에서 사용할 때는 루트의 prop을 통해 자동으로 전달되며,
+     * `WalletPortfolioBody`를 단독 embed로 사용하는 경우 직접 전달해야 한다.
+     */
+    sendTransaction?: SendTransactionFn;
 }
-declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, sendTransaction, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
 
 declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
 declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
@@ -534,4 +578,105 @@ interface WalletDetectResult {
 }
 declare function useWalletDetect(): WalletDetectResult;
 
-export { AppLauncher, AppLauncherContent, type AppLauncherContentProps, type AppLauncherProps, AppLauncherTrigger, type AppLauncherTriggerProps, CONNECTOR_REGISTRY, type ChainId, ConnectorId, type ConnectorMeta, type DrawerDirection$1 as DrawerDirection, type Environment, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemUrl, type PreferredToken, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, USER_BALANCE_QUERY_KEY, WALLET_REGISTRY, type WalletConfig, WalletConnectModal, type WalletConnectModalContentProps, type WalletConnectModalProps, type WalletConnectModalStyle, type WalletConnectModalTriggerProps, type WalletHandlers, type WalletId, WalletInfo, type WalletInfoContentProps, type WalletInfoFooterProps, type WalletInfoNavProps, type WalletInfoProps, type WalletInfoStyle, type WalletInfoTriggerProps, WalletPortfolio, WalletPortfolioBody, type WalletPortfolioBodyProps, type WalletPortfolioContentProps, type WalletPortfolioProps, type WalletPortfolioTriggerProps, useGlobalMenu, useTokenBalance, useTokenStats, useWalletDetect };
+/**
+ * Resolved wallet provider — determines which icon + display name appears
+ * in the connected pill.
+ *
+ * - `google` / `apple`: crossy-sdk 2.0 OAuth login types (embedded wallet)
+ * - `cross`: generic CROSSx mark (covers CROSSx 1.0 extension/app + 2.0
+ *   embedded when no OAuth provider is attached)
+ * - `metamask` / `binance`: external wallets
+ */
+type WalletProvider = "google" | "apple" | "cross" | "metamask" | "binance";
+interface ConnectButtonProps {
+    /** 사용자가 Connect 버튼을 눌러 연결이 진행 중. 스피너 버튼으로 전환된다. */
+    isConnecting?: boolean;
+    /**
+     * 0x… 지갑 주소. 지정되면 connected pill로 렌더링된다. 없으면
+     * disconnected 버튼("Connect Wallet")으로 떨어진다.
+     */
+    address?: string;
+    /**
+     * 트리거 pill에 표시될 provider 아이콘 키.
+     *
+     * `address`가 있는데 `provider`가 `undefined`면 SDK 조회 중인 전이
+     * 상태로 취급해 placeholder 원을 띄운다(`pending` 플래시 방지).
+     */
+    provider?: WalletProvider;
+    /**
+     * 트리거 버튼 aria-label에 포함될 provider 표시 이름. 미지정 시
+     * `provider`로부터 기본값이 유추된다 (예: 'Google', 'CROSSx').
+     */
+    providerName?: string;
+    /** WalletInfo 헤더에 노출될 계정 라벨 (예: "Account 1", 사용자 지정 이름). */
+    accountName?: string;
+    /** disconnected 상태에서 버튼 클릭 핸들러. */
+    onConnect?: () => void;
+    /** connected 상태에서 WalletInfo 하단 Disconnect 클릭 핸들러. */
+    onDisconnect?: () => void;
+    /**
+     * 주소 복사 성공 콜백. WalletInfo의 `onCopyAddress(address, success)` 에서
+     * `success === true`일 때만 호출된다.
+     */
+    onCopy?: () => void;
+    /** 지갑 변경 chevron 클릭 핸들러. 지정하지 않으면 chevron이 숨김 처리된다. */
+    onSelectWallet?: () => void;
+    /** disconnected 버튼 라벨. 기본 'Connect Wallet'. */
+    label?: string;
+    /** isConnecting 상태 라벨. 기본 'Connecting...'. */
+    connectingLabel?: string;
+    /** WalletInfo 내장 Disconnect 버튼 라벨. 기본 'Disconnect'. */
+    disconnectLabel?: string;
+    /**
+     * 외부(호출부)에서 주입하는 className. disconnected / connecting /
+     * connected(트리거 pill)에 공통으로 적용된다. 지정하면 기본 inline
+     * 스타일이 비활성화되어 Tailwind 등 외부 스타일 시스템으로 완전히
+     * 오버라이드할 수 있다.
+     */
+    className?: string;
+    theme?: Theme;
+    env?: Environment;
+    showBalance?: boolean;
+    showPortfolio?: boolean;
+    drawerDirection?: DrawerDirection$1;
+    modal?: boolean;
+    connectorId?: ConnectorId;
+    style?: WalletInfoStyle;
+    sendTransaction?: SendTransactionFn;
+}
+
+/**
+ * 3-state wallet connect button. Caller drives the visual state:
+ *
+ *   - `isConnecting === true`        → 스피너 disabled 버튼
+ *   - `address` 있음                 → WalletInfo + connected pill
+ *   - `address`가 있는데 `provider` 없음 → SDK 조회 전이 상태, placeholder 원
+ *   - 둘 다 없음                     → "Connect Wallet" 버튼
+ *
+ * view-only: wagmi / connect-kit 같은 web3 의존성은 갖지 않으며 모든
+ * 상태/데이터/콜백은 props로 주입받는다. 실제 wagmi 연결 로직은
+ * `@nexus-cross/connect-kit-react`의 상위 래퍼에서 수행한다.
+ */
+declare function ConnectButton({ isConnecting, address, provider, providerName, accountName, onConnect, onDisconnect, onCopy, onSelectWallet, label, connectingLabel, disconnectLabel, className, theme, env, showBalance, showPortfolio, drawerDirection, modal, connectorId, style, sendTransaction, }: ConnectButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Wallet provider icons used by `ConnectButton`. Ported from
+ * `@nexus-cross/connect-kit-wagmi` so dapp-ui stays a self-contained,
+ * bundler-agnostic module (no SVG loader required) and doesn't pull in a
+ * web3 dependency for icon assets.
+ *
+ * Each icon is an inline `data:image/svg+xml` URI so it can be consumed
+ * directly by `<img src={...}>`.
+ *
+ * Source references mirror the ones in `connect-kit-wagmi/src/wallets/icons.ts`:
+ *   wallet-crossx.svg        → CROSSX_ICON        (cross / cross-extension / cross-embedded fallback)
+ *   wallet-metamask.svg      → METAMASK_ICON
+ *   wallet-binance.svg       → BINANCE_ICON
+ */
+declare const CROSSX_ICON: string;
+declare const METAMASK_ICON: string;
+declare const BINANCE_ICON: string;
+declare const GOOGLE_ICON: string;
+declare const APPLE_ICON: string;
+
+export { APPLE_ICON, AppLauncher, AppLauncherContent, type AppLauncherContentProps, type AppLauncherProps, AppLauncherTrigger, type AppLauncherTriggerProps, BINANCE_ICON, CONNECTOR_REGISTRY, CROSSX_ICON, type ChainId, ConnectButton, type ConnectButtonProps, ConnectorId, type ConnectorMeta, type DrawerDirection$1 as DrawerDirection, type Environment, GOOGLE_ICON, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemUrl, METAMASK_ICON, type PreferredToken, type SendTransactionArgs, type SendTransactionFn, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, USER_BALANCE_QUERY_KEY, WALLET_REGISTRY, type WalletConfig, WalletConnectModal, type WalletConnectModalContentProps, type WalletConnectModalProps, type WalletConnectModalStyle, type WalletConnectModalTriggerProps, type WalletHandlers, type WalletId, WalletInfo, type WalletInfoContentProps, type WalletInfoFooterProps, type WalletInfoNavProps, type WalletInfoProps, type WalletInfoStyle, type WalletInfoTriggerProps, WalletPortfolio, WalletPortfolioBody, type WalletPortfolioBodyProps, type WalletPortfolioContentProps, type WalletPortfolioProps, type WalletPortfolioTriggerProps, type WalletProvider, useGlobalMenu, useTokenBalance, useTokenStats, useWalletDetect };

package/dist/index.d.ts

@@ -109,6 +109,22 @@ interface TokenStatsResponse {
     data: TokenStats[];
 }
 
+/**
+ * 포트폴리오 내부에서 트랜잭션을 실제로 서명/브로드캐스트할 때 호출하는 콜백.
+ *
+ * 주입되는 지갑 스택(wagmi, viem, 자체 SDK 등)에 관계없이 동일한 계약으로
+ * 동작시키기 위한 최소 공통 시그니처다. wagmi의 `sendTransactionAsync`를
+ * 그대로 전달해도 호환된다.
+ */
+interface SendTransactionArgs {
+    to: `0x${string}`;
+    value?: bigint;
+    data?: `0x${string}`;
+    chainId?: number;
+    gas?: bigint;
+}
+type SendTransactionFn = (args: SendTransactionArgs) => Promise<`0x${string}`>;
+
 interface WalletInfoTriggerProps {
     asChild?: boolean;
     className?: string;
@@ -161,11 +177,19 @@ interface WalletInfoProps {
     onDisconnect?: () => void;
     /** 기본 Disconnect 버튼 라벨 (기본 "Disconnect"). */
     disconnectLabel?: string;
-    /** Footer 하단 Terms 링크 URL. 지정 시에만 노출. */
+    /**
+     * Footer 하단 Terms 링크 URL.
+     * 미지정 시 CROSS 에코시스템 기본 URL로 폴백되어 자동 노출된다.
+     * 숨기려면 빈 문자열(`""`)을 전달.
+     */
     termsUrl?: string;
     /** Terms 링크 라벨 (기본 "Terms of Service"). */
     termsLabel?: string;
-    /** Footer 하단 Privacy 링크 URL. 지정 시에만 노출. */
+    /**
+     * Footer 하단 Privacy 링크 URL.
+     * 미지정 시 CROSS 에코시스템 기본 URL로 폴백되어 자동 노출된다.
+     * 숨기려면 빈 문자열(`""`)을 전달.
+     */
     privacyUrl?: string;
     /** Privacy 링크 라벨 (기본 "Privacy Policy"). */
     privacyLabel?: string;
@@ -183,10 +207,17 @@ interface WalletInfoProps {
     showTotalAssets?: boolean;
     /** Total Assets 라벨 텍스트 (기본 "Total Assets USD"). */
     totalAssetsLabel?: string;
+    /**
+     * 외부(dApp)에서 주입하는 트랜잭션 전송 함수.
+     * `showPortfolio=true`일 때 내부 `WalletPortfolioBody`로 그대로 전달되어
+     * 포트폴리오 섹션에서 토큰 전송 액션을 실행할 때 호출된다.
+     * wagmi의 `sendTransactionAsync`를 그대로 전달해도 호환된다.
+     */
+    sendTransaction?: SendTransactionFn;
     style?: WalletInfoStyle;
     children: React.ReactNode;
 }
-declare function WalletInfoRoot({ env, theme, mobileBreakpoint, drawerDirection, modal, showBalance, showForgeToken, showGameToken, showQR, qrLogoSrc, walletAddress, accountName, profileImageUrl, connectorId, connectorName: connectorNameProp, connectorIconUrl: connectorIconUrlProp, preferredTokens, onSelectWallet, onCopyAddress, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, showTotalAssets, totalAssetsLabel, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
+declare function WalletInfoRoot({ env, theme, mobileBreakpoint, drawerDirection, modal, showBalance, showForgeToken, showGameToken, showQR, qrLogoSrc, walletAddress, accountName, profileImageUrl, connectorId, connectorName: connectorNameProp, connectorIconUrl: connectorIconUrlProp, preferredTokens, onSelectWallet, onCopyAddress, onDisconnect, disconnectLabel, termsUrl, termsLabel, privacyUrl, privacyLabel, open: propOpen, onOpenChange, showPortfolio, portfolioTitle, showTotalAssets, totalAssetsLabel, sendTransaction, style, children, }: WalletInfoProps): react_jsx_runtime.JSX.Element;
 declare const WalletInfo: typeof WalletInfoRoot & {
     Trigger: typeof WalletInfoTrigger;
     Content: typeof WalletInfoContent;
@@ -383,9 +414,16 @@ interface WalletPortfolioProps {
     walletAddress: string;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * 외부(dApp)에서 주입하는 트랜잭션 전송 함수.
+     * 포트폴리오 내부에서 구성한 트랜잭션 페이로드를 실제 서명/브로드캐스트할 때
+     * 이 함수가 호출된다. 연결된 지갑 스택(wagmi, viem, 자체 SDK 등)에
+     * 종속되지 않도록 외부에서 주입한다.
+     */
+    sendTransaction?: SendTransactionFn;
     children: React.ReactNode;
 }
-declare function WalletPortfolioRoot({ env, theme, walletAddress, open: propOpen, onOpenChange, children, }: WalletPortfolioProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioRoot({ env, theme, walletAddress, open: propOpen, onOpenChange, sendTransaction, children, }: WalletPortfolioProps): react_jsx_runtime.JSX.Element;
 declare const WalletPortfolio: typeof WalletPortfolioRoot & {
     Trigger: typeof WalletPortfolioTrigger;
     Content: typeof WalletPortfolioContent;
@@ -407,8 +445,14 @@ interface WalletPortfolioBodyProps {
      */
     variant?: "fullscreen" | "embed" | "none";
     className?: string;
+    /**
+     * 외부(dApp)에서 주입하는 트랜잭션 전송 함수.
+     * `WalletPortfolio` 루트에서 사용할 때는 루트의 prop을 통해 자동으로 전달되며,
+     * `WalletPortfolioBody`를 단독 embed로 사용하는 경우 직접 전달해야 한다.
+     */
+    sendTransaction?: SendTransactionFn;
 }
-declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
+declare function WalletPortfolioBody({ env, theme, walletAddress, onBack, showHeader, variant, className, sendTransaction, }: WalletPortfolioBodyProps): react_jsx_runtime.JSX.Element;
 
 declare function CROSSxIcon(): react_jsx_runtime.JSX.Element;
 declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
@@ -534,4 +578,105 @@ interface WalletDetectResult {
 }
 declare function useWalletDetect(): WalletDetectResult;
 
-export { AppLauncher, AppLauncherContent, type AppLauncherContentProps, type AppLauncherProps, AppLauncherTrigger, type AppLauncherTriggerProps, CONNECTOR_REGISTRY, type ChainId, ConnectorId, type ConnectorMeta, type DrawerDirection$1 as DrawerDirection, type Environment, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemUrl, type PreferredToken, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, USER_BALANCE_QUERY_KEY, WALLET_REGISTRY, type WalletConfig, WalletConnectModal, type WalletConnectModalContentProps, type WalletConnectModalProps, type WalletConnectModalStyle, type WalletConnectModalTriggerProps, type WalletHandlers, type WalletId, WalletInfo, type WalletInfoContentProps, type WalletInfoFooterProps, type WalletInfoNavProps, type WalletInfoProps, type WalletInfoStyle, type WalletInfoTriggerProps, WalletPortfolio, WalletPortfolioBody, type WalletPortfolioBodyProps, type WalletPortfolioContentProps, type WalletPortfolioProps, type WalletPortfolioTriggerProps, useGlobalMenu, useTokenBalance, useTokenStats, useWalletDetect };
+/**
+ * Resolved wallet provider — determines which icon + display name appears
+ * in the connected pill.
+ *
+ * - `google` / `apple`: crossy-sdk 2.0 OAuth login types (embedded wallet)
+ * - `cross`: generic CROSSx mark (covers CROSSx 1.0 extension/app + 2.0
+ *   embedded when no OAuth provider is attached)
+ * - `metamask` / `binance`: external wallets
+ */
+type WalletProvider = "google" | "apple" | "cross" | "metamask" | "binance";
+interface ConnectButtonProps {
+    /** 사용자가 Connect 버튼을 눌러 연결이 진행 중. 스피너 버튼으로 전환된다. */
+    isConnecting?: boolean;
+    /**
+     * 0x… 지갑 주소. 지정되면 connected pill로 렌더링된다. 없으면
+     * disconnected 버튼("Connect Wallet")으로 떨어진다.
+     */
+    address?: string;
+    /**
+     * 트리거 pill에 표시될 provider 아이콘 키.
+     *
+     * `address`가 있는데 `provider`가 `undefined`면 SDK 조회 중인 전이
+     * 상태로 취급해 placeholder 원을 띄운다(`pending` 플래시 방지).
+     */
+    provider?: WalletProvider;
+    /**
+     * 트리거 버튼 aria-label에 포함될 provider 표시 이름. 미지정 시
+     * `provider`로부터 기본값이 유추된다 (예: 'Google', 'CROSSx').
+     */
+    providerName?: string;
+    /** WalletInfo 헤더에 노출될 계정 라벨 (예: "Account 1", 사용자 지정 이름). */
+    accountName?: string;
+    /** disconnected 상태에서 버튼 클릭 핸들러. */
+    onConnect?: () => void;
+    /** connected 상태에서 WalletInfo 하단 Disconnect 클릭 핸들러. */
+    onDisconnect?: () => void;
+    /**
+     * 주소 복사 성공 콜백. WalletInfo의 `onCopyAddress(address, success)` 에서
+     * `success === true`일 때만 호출된다.
+     */
+    onCopy?: () => void;
+    /** 지갑 변경 chevron 클릭 핸들러. 지정하지 않으면 chevron이 숨김 처리된다. */
+    onSelectWallet?: () => void;
+    /** disconnected 버튼 라벨. 기본 'Connect Wallet'. */
+    label?: string;
+    /** isConnecting 상태 라벨. 기본 'Connecting...'. */
+    connectingLabel?: string;
+    /** WalletInfo 내장 Disconnect 버튼 라벨. 기본 'Disconnect'. */
+    disconnectLabel?: string;
+    /**
+     * 외부(호출부)에서 주입하는 className. disconnected / connecting /
+     * connected(트리거 pill)에 공통으로 적용된다. 지정하면 기본 inline
+     * 스타일이 비활성화되어 Tailwind 등 외부 스타일 시스템으로 완전히
+     * 오버라이드할 수 있다.
+     */
+    className?: string;
+    theme?: Theme;
+    env?: Environment;
+    showBalance?: boolean;
+    showPortfolio?: boolean;
+    drawerDirection?: DrawerDirection$1;
+    modal?: boolean;
+    connectorId?: ConnectorId;
+    style?: WalletInfoStyle;
+    sendTransaction?: SendTransactionFn;
+}
+
+/**
+ * 3-state wallet connect button. Caller drives the visual state:
+ *
+ *   - `isConnecting === true`        → 스피너 disabled 버튼
+ *   - `address` 있음                 → WalletInfo + connected pill
+ *   - `address`가 있는데 `provider` 없음 → SDK 조회 전이 상태, placeholder 원
+ *   - 둘 다 없음                     → "Connect Wallet" 버튼
+ *
+ * view-only: wagmi / connect-kit 같은 web3 의존성은 갖지 않으며 모든
+ * 상태/데이터/콜백은 props로 주입받는다. 실제 wagmi 연결 로직은
+ * `@nexus-cross/connect-kit-react`의 상위 래퍼에서 수행한다.
+ */
+declare function ConnectButton({ isConnecting, address, provider, providerName, accountName, onConnect, onDisconnect, onCopy, onSelectWallet, label, connectingLabel, disconnectLabel, className, theme, env, showBalance, showPortfolio, drawerDirection, modal, connectorId, style, sendTransaction, }: ConnectButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Wallet provider icons used by `ConnectButton`. Ported from
+ * `@nexus-cross/connect-kit-wagmi` so dapp-ui stays a self-contained,
+ * bundler-agnostic module (no SVG loader required) and doesn't pull in a
+ * web3 dependency for icon assets.
+ *
+ * Each icon is an inline `data:image/svg+xml` URI so it can be consumed
+ * directly by `<img src={...}>`.
+ *
+ * Source references mirror the ones in `connect-kit-wagmi/src/wallets/icons.ts`:
+ *   wallet-crossx.svg        → CROSSX_ICON        (cross / cross-extension / cross-embedded fallback)
+ *   wallet-metamask.svg      → METAMASK_ICON
+ *   wallet-binance.svg       → BINANCE_ICON
+ */
+declare const CROSSX_ICON: string;
+declare const METAMASK_ICON: string;
+declare const BINANCE_ICON: string;
+declare const GOOGLE_ICON: string;
+declare const APPLE_ICON: string;
+
+export { APPLE_ICON, AppLauncher, AppLauncherContent, type AppLauncherContentProps, type AppLauncherProps, AppLauncherTrigger, type AppLauncherTriggerProps, BINANCE_ICON, CONNECTOR_REGISTRY, CROSSX_ICON, type ChainId, ConnectButton, type ConnectButtonProps, ConnectorId, type ConnectorMeta, type DrawerDirection$1 as DrawerDirection, type Environment, GOOGLE_ICON, type GlobalMenu, type GlobalMenuItem, type GlobalMenuItemUrl, METAMASK_ICON, type PreferredToken, type SendTransactionArgs, type SendTransactionFn, TOKEN_STATS_QUERY_KEY, type Theme, type TokenBalance, type TokenBalanceResponse, type TokenStats, type TokenStatsResponse, USER_BALANCE_QUERY_KEY, WALLET_REGISTRY, type WalletConfig, WalletConnectModal, type WalletConnectModalContentProps, type WalletConnectModalProps, type WalletConnectModalStyle, type WalletConnectModalTriggerProps, type WalletHandlers, type WalletId, WalletInfo, type WalletInfoContentProps, type WalletInfoFooterProps, type WalletInfoNavProps, type WalletInfoProps, type WalletInfoStyle, type WalletInfoTriggerProps, WalletPortfolio, WalletPortfolioBody, type WalletPortfolioBodyProps, type WalletPortfolioContentProps, type WalletPortfolioProps, type WalletPortfolioTriggerProps, type WalletProvider, useGlobalMenu, useTokenBalance, useTokenStats, useWalletDetect };