@nexus-cross/connect-kit-react 1.3.0-beta.1 → 1.3.1

package/dist/index.d.ts

@@ -1,28 +1,378 @@
-export { CrossConnectKitProvider } from './components/CrossConnectKitProvider.js';
-export type { CrossConnectKitProviderProps } from './components/CrossConnectKitProvider.js';
-export { ConnectButton } from './components/ConnectButton.js';
-export type { ConnectButtonProps, WalletUser, WalletProvider, } from './components/ConnectButton.js';
-export { OtherWalletsModal } from './components/OtherWalletsModal.js';
-export type { OtherWalletsModalProps } from './components/OtherWalletsModal.js';
-export { CrossConnectModal } from './components/CrossConnectModal.js';
-export type { CrossConnectModalProps } from './components/CrossConnectModal.js';
-export { useCrossConnectKit } from './context/CrossConnectKitContext.js';
-export type { CrossConnectKitContextValue } from './context/CrossConnectKitContext.js';
-export { useCrossConnectKitTheme, useOptionalCrossConnectKitTheme, } from './context/CrossConnectKitThemeContext.js';
-export type { CrossConnectKitThemeContextValue } from './context/CrossConnectKitThemeContext.js';
-export { useCrossxEmbeddedInfo } from './hooks/useCrossxEmbeddedInfo.js';
-export type { CrossxEmbeddedInfo } from './hooks/useCrossxEmbeddedInfo.js';
-export { useOnRamp, useOnRampEligibility, OnRampProvider, } from '@nexus-cross/onramp/react';
-export type { UseOnRampResult, UseOnRampOptions, UseOnRampEligibilityResult, UseOnRampEligibilityOptions, OnRampProviderProps, } from '@nexus-cross/onramp/react';
-export { WalletInfo, ConnectorId } from '@nexus-cross/dapp-ui';
-export type { WalletInfoProps, WalletInfoStyle, WalletInfoTriggerProps, WalletInfoContentProps, SendTransactionArgs, SendTransactionFn, } from '@nexus-cross/dapp-ui';
-export { AppLauncher, AppLauncherTrigger, AppLauncherContent, useGlobalMenu, } from '@nexus-cross/dapp-ui';
-export type { AppLauncherProps, AppLauncherTriggerProps, AppLauncherTriggerStyle, AppLauncherContentProps, GlobalMenu, GlobalMenuItem, GlobalMenuItemUrl, } from '@nexus-cross/dapp-ui';
-export { SkillsButton } from '@nexus-cross/dapp-ui';
-export type { SkillsButtonProps, SkillsButtonStyle, } from '@nexus-cross/dapp-ui';
-export type { ConnectButtonStyle } from '@nexus-cross/dapp-ui';
-export type { Account, WalletState, WalletId, WalletDescriptor, ChainBalance, ConnectorType, Theme, ThemeMode, ColorOverrides, ThemeTokens, ModalView, CrossConnectKitConfig, OnRampEligibility, OnRampDisallowReason, OnRampOpenParams, OnRampSession, OnRampStatus, OnRampStatusEvent, OnRampProviderId, OnRampErrorCode, } from '@nexus-cross/connect-kit-core';
-export { OnRampError } from '@nexus-cross/connect-kit-core';
-export type { ConnectorEntry, ConnectorRegistry, } from '@nexus-cross/connect-kit-wagmi';
-export { ConnectionStatus, formatBalance, formatWei } from '@nexus-cross/connect-kit-core';
-//# sourceMappingURL=index.d.ts.map
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { CrossxConfig, CrossConnectKitInitialState, ConnectorRegistry, ConnectorEntry } from '@nexus-cross/connect-kit-wagmi';
+export { ConnectorEntry, ConnectorRegistry } from '@nexus-cross/connect-kit-wagmi';
+import { WalletId, CrossConnectKitConfig, OAuthPort, ThemeMode, ThemeTokens } from '@nexus-cross/connect-kit-core';
+export { Account, ChainBalance, ColorOverrides, ConnectionStatus, ConnectorType, CrossConnectKitConfig, ModalView, OnRampDisallowReason, OnRampEligibility, OnRampError, OnRampErrorCode, OnRampOpenParams, OnRampProviderId, OnRampSession, OnRampStatus, OnRampStatusEvent, Theme, ThemeMode, ThemeTokens, WalletDescriptor, WalletId, WalletState, formatBalance, formatWei } from '@nexus-cross/connect-kit-core';
+import { WalletInfoProps, ConnectButtonStyle, WalletInfoStyle, Environment, BridgeToken, BridgeHistoryItem, BridgeGetApprovalFn, BridgeApproveFn, BridgeQuoteFn, BridgeGetToTokensFn, BridgeSubmitFn } from '@nexus-cross/dapp-ui';
+export { AppLauncher, AppLauncherContent, AppLauncherContentProps, AppLauncherProps, AppLauncherTrigger, AppLauncherTriggerProps, AppLauncherTriggerStyle, ConnectButtonStyle, ConnectorId, GlobalMenu, GlobalMenuItem, GlobalMenuItemUrl, SendTransactionArgs, SendTransactionFn, SkillsButton, SkillsButtonProps, SkillsButtonStyle, WalletInfo, WalletInfoContentProps, WalletInfoProps, WalletInfoStyle, WalletInfoTriggerProps, useGlobalMenu } from '@nexus-cross/dapp-ui';
+import { Connector } from 'wagmi';
+export { OnRampProvider, OnRampProviderProps, UseOnRampEligibilityOptions, UseOnRampEligibilityResult, UseOnRampOptions, UseOnRampResult, useOnRamp, useOnRampEligibility } from '@nexus-cross/onramp/react';
+
+interface CrossConnectKitProviderProps {
+    children: ReactNode;
+    config: CrossxConfig;
+    /**
+     * SSR hydration state for both sides of the dual wagmi config. Produce
+     * with `cookieToCrossConnectKitState(config, cookieHeader)` on the server.
+     * The provider passes the correct slice into whichever `<WagmiProvider>`
+     * is currently active.
+     */
+    initialState?: CrossConnectKitInitialState;
+    /**
+     * Extra wallet entries to render in the unified connect modal that do
+     * NOT have a wagmi connector behind them. Use this for "coming soon"
+     * placeholders or dapp-ui-only wallets like Verse8 / Tron — pass a
+     * click handler that opens an alert / external page.
+     *
+     * Keys must be walletIds known to dapp-ui's `WALLET_REGISTRY`
+     * (e.g. `'verse8'`, `'tron'`). Other keys are ignored.
+     */
+    extraWallets?: Partial<Record<WalletId, () => void | Promise<void>>>;
+    /**
+     * Whitelist controlling which wallet ids appear in the modal's
+     * "Other Wallets" list.
+     *
+     *   undefined  — show every registered wallet (default)
+     *   []         — show none (social-only modal)
+     *   [...ids]   — show only the listed ids (applies to extras too)
+     *
+     * Disable social separately by omitting `embeddedConnectorFactory`
+     * from `createCrossxConfig`.
+     */
+    walletAllowlist?: readonly WalletId[];
+}
+declare function CrossConnectKitProvider({ children, config, initialState, extraWallets, walletAllowlist, }: CrossConnectKitProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * ConnectButton이 사용하는 사용자 프로바이더 식별자.
+ * crossy-sdk의 OAuth 로그인(`google`/`apple`)과 실제 지갑 커넥터
+ * (`cross`/`metamask`/`binance`)를 하나의 enum처럼 통합 표기한 값.
+ */
+type WalletProvider = 'google' | 'apple' | 'cross' | 'metamask' | 'binance';
+/**
+ * 외부에서 `ConnectButton`에 전달할 수 있는 사용자 정보 객체.
+ * 지정 시 내부 자동 감지 로직(useAccount / crossy-sdk)보다 우선하여
+ * trigger pill / WalletInfo 헤더 표시에 사용된다.
+ */
+interface WalletUser {
+    /** `google` | `apple` | `cross` | `metamask` | `binance` */
+    provider: WalletProvider;
+    /** WalletInfo 헤더에 노출될 계정 라벨 (예: `"Account 1"`). */
+    name?: string;
+    /** 0x... 지갑 주소. */
+    address: string;
+}
+/**
+ * `ConnectButton`에 전달 가능한 prop 중 내부에서 자동 계산되는 항목.
+ * 명시적으로 지정되면 자동값을 덮어쓴다.
+ *
+ * - `walletAddress`: 항상 내부에서 관리(wagmi / `user.address`)하므로 제외.
+ * - `children`: 내부에서 Trigger/Content를 조립하므로 제외.
+ */
+type ForwardedWalletInfoProps = Omit<WalletInfoProps, 'children' | 'walletAddress' | 'style'>;
+interface ConnectButtonProps extends ForwardedWalletInfoProps {
+    /**
+     * Disconnected 상태에서 버튼에 표기될 라벨. 기본 `"Connect Wallet"`.
+     * `ReactNode`를 받아 아이콘-only / 커스텀 마크업 렌더가 가능하다
+     * (예: 모바일에서 텍스트 없이 지갑 아이콘만 노출).
+     */
+    label?: ReactNode;
+    /**
+     * 외부(호출부)에서 주입하는 className. disconnected / connecting /
+     * connected(트리거 pill)에 공통으로 추가된다 (기본 `cb-button` /
+     * `cb-pill` 클래스에 병합).
+     */
+    className?: string;
+    /**
+     * 버튼 자체(disconnected / connecting / connected pill)의 CSS 커스텀
+     * 변수 오버라이드. WalletInfo popover 스타일은 별도 `walletInfoStyle`
+     * 로 분리되어 있다.
+     */
+    style?: ConnectButtonStyle;
+    /**
+     * 트리거 pill 을 눌러 열리는 WalletInfo popover/drawer 의 CSS 커스텀
+     * 변수 오버라이드 (`WalletInfoStyle`).
+     */
+    walletInfoStyle?: WalletInfoStyle;
+    /**
+     * 사용자 정보 객체. 지정 시 `provider`/`name`/`address`가 자동 감지값보다
+     * 우선하여 trigger pill과 WalletInfo 헤더에 반영된다. 연결 상태 자체
+     * (`isConnected`/`isConnecting`)는 여전히 wagmi에서 가져온다.
+     */
+    user?: WalletUser;
+    /**
+     * @deprecated `showPortfolio`를 사용하라. 현재는 `showPortfolio`가 지정되지
+     * 않은 경우에만 fallback으로 쓰인다.
+     */
+    enablePortfolio?: boolean;
+    /**
+     * Convenience alias for `showPortfolio`. Prefer this in new code:
+     * `<ConnectButton portfolio />`.
+     */
+    portfolio?: boolean;
+    /**
+     * AlchemyPay 결제 위젯 종료 후 popup이 redirect될 URL. 지정 시 백엔드
+     * `/onramp/url` 호출 body의 `redirect_url`로 그대로 전달된다. 미지정 시
+     * 클라가 임의 default를 박지 않고 백엔드의 default 흐름을 따른다.
+     *
+     * DApp이 결제 완료를 자체 페이지에서 받고 싶을 때 사용 (예:
+     * `https://example.com/onramp/return`). 보통 그 페이지에서
+     * `window.opener.postMessage(...)` + `window.close()`로 메인 윈도우에 알림.
+     */
+    onRampRedirectUrl?: string;
+}
+/**
+ * `ConnectButton`은 내부에서 `WalletInfo`를 조립하지만, 호출측은 그 사실을
+ * 몰라도 되도록 `WalletInfoProps`를 전부 pass-through 한다
+ * (`walletAddress` / `children` 만 제외).
+ *
+ * 자동 계산 규칙 (명시적으로 주면 덮어쓰기):
+ *   - `walletAddress`       ← `user.address` ?? wagmi `address`
+ *   - `connectorId`         ← `user.provider` ?? `currentWallet` 매핑
+ *   - `accountName`         ← `user.name` ?? crossy-sdk getAddresses name
+ *   - `onDisconnect`        ← kit `disconnect()`
+ *   - `onSelectWallet`      ← OAuth embedded 세션일 때만 kit `selectWallet()`
+ *                             (외부 지갑은 기본 alert을 막기 위해 CSS로 숨김)
+ *   - `showPortfolio`       ← `portfolio` ?? `showPortfolio` ?? legacy `enablePortfolio`
+ *   - `theme`               ← kit provider의 `themeMode`
+ *   - `env`                 ← `NEXT_PUBLIC_CROSSX_ENVIRONMENT`, or `"production"`
+ *
+ * Trigger 버튼(주소 옆 pill)은 호출측이 건드릴 수 없다 — 플랫폼 아이콘 + 축약
+ * 주소의 통일된 UX를 강제한다.
+ */
+declare function ConnectButton({ label, className, style, walletInfoStyle, user, enablePortfolio, portfolio, theme: themeProp, accountName: accountNameProp, connectorId: connectorIdProp, showPortfolio: showPortfolioProp, sendAccounts: sendAccountsProp, getTransactionReceipt: getTransactionReceiptProp, sendTransaction: sendTransactionProp, estimateGas: estimateGasProp, onDisconnect: onDisconnectProp, onSelectWallet: onSelectWalletProp, onBuy: onBuyProp, onRampRedirectUrl, bridgeTokens: bridgeTokensProp, bridgeHistory: bridgeHistoryProp, getBridgeQuote: getBridgeQuoteProp, getBridgeToTokens: getBridgeToTokensProp, getBridgeApproval: getBridgeApprovalProp, approveBridge: approveBridgeProp, submitBridge: submitBridgeProp, showBalance, env, ...walletInfoRest }: ConnectButtonProps): react_jsx_runtime.JSX.Element;
+
+interface OtherWalletsModalProps {
+    open: boolean;
+    onClose: () => void;
+    onSelect: (walletId: WalletId) => Promise<void>;
+    /** Override the modal title. Default: "Connect Wallet". */
+    title?: string;
+    /** Override the modal description. */
+    description?: string;
+    /** Override the troubleshooting tip list entirely. */
+    troubleshootingTips?: readonly string[];
+}
+/**
+ * Wallet selector modal. Port of posa's `ConnectWalletModal` backed by
+ * `ConnectorRegistry` — wallet order, icons, and descriptive copy match
+ * posa; DApps can override via `walletGuides` passed to
+ * `createCrossxConfig` and via modal props.
+ */
+declare function OtherWalletsModal({ open, onClose, onSelect, title, description, troubleshootingTips, }: OtherWalletsModalProps): react_jsx_runtime.JSX.Element | null;
+
+interface CrossConnectModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+/**
+ * Kit's unified connect modal. Composes dapp-ui's `WalletConnectModal`
+ * with two handler sources:
+ *
+ *  - Social row → `oauth.signIn('google' | 'apple')` from the wagmi-side
+ *    OAuth adapter (no UI; the SDK opens the OAuth popup and resolves
+ *    addresses on its own).
+ *  - Wallet list → `connect(walletId)` from the kit context, which
+ *    drives the regular wagmi connect flow.
+ *
+ * The modal itself is a thin composition: it owns no connect logic,
+ * shows no progress / error state. Users that need a richer UX can copy
+ * this component as a starting point.
+ */
+declare function CrossConnectModal({ open, onOpenChange, }: CrossConnectModalProps): react_jsx_runtime.JSX.Element;
+
+interface CrossConnectKitContextValue {
+    kitConfig: CrossConnectKitConfig;
+    connectorRegistry: ConnectorRegistry;
+    /** Available wallets derived from the registry (excludes embedded) */
+    availableWallets: readonly ConnectorEntry[];
+    /** Connect by walletId — resolved through the registry */
+    connect: (walletId: WalletId) => Promise<void>;
+    /** Shortcut: trigger embedded wallet connect (SDK modal) */
+    connectWallet: () => Promise<void>;
+    /** Disconnect and clean up wagmi + SDK + cached session storage. */
+    disconnect: () => Promise<void>;
+    /** Open the SDK's wallet selector (embedded only) */
+    selectWallet: () => Promise<{
+        address: string;
+        index: number;
+    } | null>;
+    /** Currently active wallet type, resolved from registry */
+    currentWallet: WalletId | null;
+    /**
+     * The most recent wallet the user picked from the unified connect
+     * modal. Set by `runConnect` before the wagmi-side connect begins,
+     * cleared on dismissal/error so callers can detect that the user
+     * gave up on the wallet UI even when wagmi's `isConnecting` stays
+     * stuck on a pending connector promise (WalletConnect QR, OAuth
+     * popup). Reads of this should be paired with `isConnected` —
+     * `lastIntent && !isConnected` means "we asked for X but X hasn't
+     * succeeded yet", and a transition from non-null → null while
+     * disconnected is the kit's "user cancelled" signal.
+     */
+    lastIntent: WalletId | null;
+    /**
+     * Unified "a connect attempt is in flight" flag spanning EVERY
+     * connection path — so "Connecting…" UI behaves identically regardless
+     * of which wallet the user picked. Unlike wagmi's
+     * `useAccount().isConnecting`, this also covers:
+     *
+     *   - the reown direct-connect AppKit flow (`metamask` / `binance`),
+     *     which resolves outside wagmi's `connectAsync` and therefore never
+     *     flips wagmi's own `isConnecting`;
+     *   - the embedded OAuth popup (`google` / `apple`), wired through
+     *     `oauth.signIn` rather than the wagmi connect path.
+     *
+     * Set the instant the user picks a wallet in the modal; cleared on
+     * success (`isConnected`), cancel, or error. In-memory only — a stale
+     * persisted `lastIntent` from a previous page load never turns it on,
+     * and silent background reconnects (wagmi `isReconnecting`) don't either.
+     */
+    isConnecting: boolean;
+    /**
+     * The `walletId` of the in-flight connect attempt, or `null` when idle.
+     * Same lifecycle as {@link isConnecting} — use it to drive a per-wallet
+     * spinner inside a custom connect modal.
+     */
+    connectingWalletId: WalletId | null;
+    /** Open the "Other Wallets" modal */
+    openOtherWallets: () => void;
+    /** Close the "Other Wallets" modal */
+    closeOtherWallets: () => void;
+    /** Whether the "Other Wallets" modal is open */
+    otherWalletsOpen: boolean;
+    /**
+     * Headless OAuth entry point. Non-null only when the kit was created
+     * with an `embeddedConnectorFactory` (i.e. crossy-sdk is present).
+     * Used by `<CrossConnectModal>` to wire the Google/Apple buttons.
+     */
+    oauth: OAuthPort | null;
+    /**
+     * Extra wallet click-handlers the DApp wants to render in the connect
+     * modal that have NO wagmi connector behind them (e.g. coming-soon
+     * placeholders or dapp-ui-only wallets like Verse8 / Tron). Keys are
+     * walletIds known to dapp-ui's `WALLET_REGISTRY`; values are click
+     * handlers (typically opening an alert or external page).
+     */
+    extraWallets: Partial<Record<WalletId, () => void | Promise<void>>>;
+    /**
+     * Optional whitelist controlling which wallet ids appear in the
+     * connect modal's "Other Wallets" list.
+     *
+     * - `undefined` (default) — show every registered wallet
+     * - `[]` — show none (social row only)
+     * - `['cross_wallet', ...]` — show only the listed ids
+     *
+     * Applies to both wagmi-backed entries and `extraWallets`. The social
+     * row is independent of this — disable social by omitting
+     * `embeddedConnectorFactory` from `createCrossxConfig`.
+     */
+    walletAllowlist: readonly WalletId[] | null;
+    /**
+     * On-ramp 활성화 여부 (= `!!kitConfig.onRampId`). 실제 어댑터/훅은
+     * `@nexus-cross/onramp/react`의 OnRampProvider/useOnRamp를 통해 노출 —
+     * 이 값은 단순히 connect-kit 호출자가 onRampId 설정 여부를 빠르게
+     * 알아볼 수 있게 한다.
+     */
+    onRampEnabled: boolean;
+}
+declare function useCrossConnectKit(): CrossConnectKitContextValue;
+
+/**
+ * Resolved theme state exposed to consumers inside `<CrossConnectKitProvider>`.
+ * `mode` already accounts for `autoDetectTheme` and any runtime
+ * overrides via `setTheme`.
+ */
+interface CrossConnectKitThemeContextValue {
+    /** Active theme mode (respects `autoDetectTheme` + runtime overrides). */
+    mode: ThemeMode;
+    /** Resolved token set passed to crossy-sdk + published as `--cck-*`. */
+    tokens: ThemeTokens | undefined;
+    /**
+     * Override the theme mode at runtime. Mirrors crossy-sdk's
+     * `sdk.applyTheme(mode)`.
+     *
+     * Passing `null` reverts to whatever the original `CrossConnectKitConfig`
+     * declared (including `autoDetectTheme`).
+     */
+    setThemeMode: (mode: ThemeMode | null) => void;
+    /**
+     * Override color tokens at runtime. Passed straight through to
+     * crossy-sdk's `applyTheme(mode, themeTokens)` on the next render,
+     * and re-published as CSS variables so dapp-ui surfaces update too.
+     *
+     * Passing `null` reverts to `CrossConnectKitConfig.themeTokens`.
+     */
+    setThemeTokens: (tokens: ThemeTokens | null) => void;
+}
+/**
+ * Access the resolved theme and the runtime override setters. Must be
+ * called inside `<CrossConnectKitProvider>`.
+ */
+declare function useCrossConnectKitTheme(): CrossConnectKitThemeContextValue;
+/**
+ * Version that returns `null` when called outside the provider — handy
+ * for components (like `WalletInfo`) that want to opt into the kit's
+ * theme if mounted under the provider, but keep working standalone.
+ */
+declare function useOptionalCrossConnectKitTheme(): CrossConnectKitThemeContextValue | null;
+
+interface CrossxEmbeddedInfo {
+    /** crossy-sdk OAuth 로그인 타입. embedded가 아니면 `null`. */
+    loginType: 'google' | 'apple' | null;
+    /** SDK `getAddresses()`가 리턴한 현재 주소의 `name` 필드(계정 라벨). */
+    accountName: string | null;
+    /** SDK `getAddresses()`가 리턴한 전체 계정 목록. embedded가 아니면 빈 배열. */
+    accounts: Array<{
+        address: `0x${string}`;
+        index?: number;
+        name?: string;
+    }>;
+    /**
+     * SDK 조회가 완료됐는지 여부. embedded 세션에서 처음 마운트됐을 때
+     * `loginType`은 잠시 `null`이고 다음 틱에 `google`/`apple`로 바뀌는데,
+     * 이 플래그로 "아직 해석 중" vs "해석 완료(OAuth 아님)"을 구분한다.
+     * embedded가 아닌 wallet은 즉시 `true`.
+     */
+    isResolved: boolean;
+}
+/**
+ * crossy-sdk 2.0 세션 메타데이터(`getUserInfo().loginType`,
+ * `getAddresses()[].name`)를 비동기로 읽어오는 훅.
+ *
+ * - `walletId`가 `"cross_embedded"`가 아니면 항상
+ *   `{ loginType: null, accountName: null, accounts: [], isResolved: true }`.
+ * - 내부 호출은 연결된 Provider가 `sdk` 필드를 노출하는 crossy-sdk 스펙을
+ *   가정하며, 필드가 없거나 에러가 나면 조용히 nulls로 떨어진다.
+ * - RN native bridge가 walletChanged 이벤트로 보내주는 walletName(예: imported
+ *   wallet의 사용자 라벨)도 함께 구독해, SDK 서버 캐시 `name`보다 우선
+ *   accountName으로 사용한다.
+ *
+ * 인자 없이 호출하면 `useAccount()` / `useCrossConnectKit()`에서 값을 자동으로
+ * 받아오고, 명시적으로 제어하고 싶으면 오버라이드 값을 넘길 수 있다.
+ */
+declare function useCrossxEmbeddedInfo(args?: {
+    walletId?: string | null;
+    connector?: Connector;
+    address?: string;
+}): CrossxEmbeddedInfo;
+
+type CrossdBridgeAdapterOptions = {
+    env: Environment;
+    walletAddress?: string;
+    enabled?: boolean;
+};
+type CrossdBridgeAdapter = {
+    bridgeTokens: BridgeToken[];
+    bridgeHistory: BridgeHistoryItem[];
+    getBridgeApproval: BridgeGetApprovalFn;
+    approveBridge: BridgeApproveFn;
+    getBridgeQuote: BridgeQuoteFn;
+    getBridgeToTokens: BridgeGetToTokensFn;
+    submitBridge: BridgeSubmitFn;
+    isLoading: boolean;
+};
+declare function useCrossdBridgeAdapter({ env, walletAddress, enabled, }: CrossdBridgeAdapterOptions): CrossdBridgeAdapter;
+
+export { ConnectButton, type ConnectButtonProps, type CrossConnectKitContextValue, CrossConnectKitProvider, type CrossConnectKitProviderProps, type CrossConnectKitThemeContextValue, CrossConnectModal, type CrossConnectModalProps, type CrossxEmbeddedInfo, OtherWalletsModal, type OtherWalletsModalProps, type WalletProvider, type WalletUser, useCrossConnectKit, useCrossConnectKitTheme, useCrossdBridgeAdapter, useCrossxEmbeddedInfo, useOptionalCrossConnectKitTheme };

package/dist/index.js

@@ -1,19 +1 @@
-import { announceConnectKitUsage } from './runtime-log.js';
-announceConnectKitUsage();
-export { CrossConnectKitProvider } from './components/CrossConnectKitProvider.js';
-export { ConnectButton } from './components/ConnectButton.js';
-export { OtherWalletsModal } from './components/OtherWalletsModal.js';
-export { CrossConnectModal } from './components/CrossConnectModal.js';
-export { useCrossConnectKit } from './context/CrossConnectKitContext.js';
-export { useCrossConnectKitTheme, useOptionalCrossConnectKitTheme, } from './context/CrossConnectKitThemeContext.js';
-export { useCrossxEmbeddedInfo } from './hooks/useCrossxEmbeddedInfo.js';
-// On-ramp 훅은 `@nexus-cross/onramp/react`로 이동했다. 1.1.x에서
-// `@nexus-cross/connect-kit-react`로부터 직접 import한 사용자가 안 깨지도록
-// re-export만 유지. 신규 코드는 `@nexus-cross/onramp/react`를 직접 import 권장.
-export { useOnRamp, useOnRampEligibility, OnRampProvider, } from '@nexus-cross/onramp/react';
-export { WalletInfo, ConnectorId } from '@nexus-cross/dapp-ui';
-export { AppLauncher, AppLauncherTrigger, AppLauncherContent, useGlobalMenu, } from '@nexus-cross/dapp-ui';
-export { SkillsButton } from '@nexus-cross/dapp-ui';
-export { OnRampError } from '@nexus-cross/connect-kit-core';
-export { ConnectionStatus, formatBalance, formatWei } from '@nexus-cross/connect-kit-core';
-//# sourceMappingURL=index.js.map
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w}from"./chunk-ZL2BHNN6.js";export{o as AppLauncher,q as AppLauncherContent,p as AppLauncherTrigger,h as ConnectButton,u as ConnectionStatus,n as ConnectorId,e as CrossConnectKitProvider,d as CrossConnectModal,t as OnRampError,l as OnRampProvider,i as OtherWalletsModal,s as SkillsButton,m as WalletInfo,v as formatBalance,w as formatWei,a as useCrossConnectKit,b as useCrossConnectKitTheme,f as useCrossdBridgeAdapter,g as useCrossxEmbeddedInfo,r as useGlobalMenu,j as useOnRamp,k as useOnRampEligibility,c as useOptionalCrossConnectKitTheme};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexus-cross/connect-kit-react",
-  "version": "1.3.0-beta.1",
+  "version": "1.3.1",
   "description": "React components and hooks for @nexus-cross/connect-kit wallet connection",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,16 +18,17 @@
   "files": [
     "dist"
   ],
+  "sideEffects": false,
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
   "dependencies": {
-    "@nexus-cross/connect-kit-core": "1.3.0-beta.1",
-    "@nexus-cross/connect-kit-wagmi": "1.3.0-beta.1",
-    "@nexus-cross/crossx-design-system": "0.1.0",
-    "@nexus-cross/onramp": "0.1.0",
-    "@nexus-cross/dapp-ui": "1.3.0-beta.1"
+    "@nexus-cross/connect-kit-core": "1.3.1",
+    "@nexus-cross/connect-kit-wagmi": "1.3.1",
+    "@nexus-cross/crossx-design-system": "1.3.1",
+    "@nexus-cross/dapp-ui": "1.3.1",
+    "@nexus-cross/onramp": "1.3.1"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.60.0",
@@ -35,6 +36,8 @@
     "@types/react-dom": "^19.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
     "viem": "^2.21.0",
     "wagmi": "^3.6.0"
   },
@@ -46,8 +49,8 @@
   },
   "license": "MIT",
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "tsup",
+    "dev": "tsup --watch",
     "test": "echo 'no tests yet'",
     "typecheck": "tsc --noEmit"
   }

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,YAAY,EACV,0BAA0B,EAC1B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,oCAAoC,CAAC"}

package/dist/client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/components/ConnectButton.d.ts

@@ -1,102 +0,0 @@
-import type { ReactNode } from 'react';
-import type { ConnectButtonStyle, WalletInfoProps, WalletInfoStyle } from '@nexus-cross/dapp-ui';
-/**
- * ConnectButton이 사용하는 사용자 프로바이더 식별자.
- * crossy-sdk의 OAuth 로그인(`google`/`apple`)과 실제 지갑 커넥터
- * (`cross`/`metamask`/`binance`)를 하나의 enum처럼 통합 표기한 값.
- */
-export type WalletProvider = 'google' | 'apple' | 'cross' | 'metamask' | 'binance';
-/**
- * 외부에서 `ConnectButton`에 전달할 수 있는 사용자 정보 객체.
- * 지정 시 내부 자동 감지 로직(useAccount / crossy-sdk)보다 우선하여
- * trigger pill / WalletInfo 헤더 표시에 사용된다.
- */
-export interface WalletUser {
-    /** `google` | `apple` | `cross` | `metamask` | `binance` */
-    provider: WalletProvider;
-    /** WalletInfo 헤더에 노출될 계정 라벨 (예: `"Account 1"`). */
-    name?: string;
-    /** 0x... 지갑 주소. */
-    address: string;
-}
-/**
- * `ConnectButton`에 전달 가능한 prop 중 내부에서 자동 계산되는 항목.
- * 명시적으로 지정되면 자동값을 덮어쓴다.
- *
- * - `walletAddress`: 항상 내부에서 관리(wagmi / `user.address`)하므로 제외.
- * - `children`: 내부에서 Trigger/Content를 조립하므로 제외.
- */
-type ForwardedWalletInfoProps = Omit<WalletInfoProps, 'children' | 'walletAddress' | 'style'>;
-export interface ConnectButtonProps extends ForwardedWalletInfoProps {
-    /**
-     * Disconnected 상태에서 버튼에 표기될 라벨. 기본 `"Connect Wallet"`.
-     * `ReactNode`를 받아 아이콘-only / 커스텀 마크업 렌더가 가능하다
-     * (예: 모바일에서 텍스트 없이 지갑 아이콘만 노출).
-     */
-    label?: ReactNode;
-    /**
-     * 외부(호출부)에서 주입하는 className. disconnected / connecting /
-     * connected(트리거 pill)에 공통으로 추가된다 (기본 `cb-button` /
-     * `cb-pill` 클래스에 병합).
-     */
-    className?: string;
-    /**
-     * 버튼 자체(disconnected / connecting / connected pill)의 CSS 커스텀
-     * 변수 오버라이드. WalletInfo popover 스타일은 별도 `walletInfoStyle`
-     * 로 분리되어 있다.
-     */
-    style?: ConnectButtonStyle;
-    /**
-     * 트리거 pill 을 눌러 열리는 WalletInfo popover/drawer 의 CSS 커스텀
-     * 변수 오버라이드 (`WalletInfoStyle`).
-     */
-    walletInfoStyle?: WalletInfoStyle;
-    /**
-     * 사용자 정보 객체. 지정 시 `provider`/`name`/`address`가 자동 감지값보다
-     * 우선하여 trigger pill과 WalletInfo 헤더에 반영된다. 연결 상태 자체
-     * (`isConnected`/`isConnecting`)는 여전히 wagmi에서 가져온다.
-     */
-    user?: WalletUser;
-    /**
-     * @deprecated `showPortfolio`를 사용하라. 현재는 `showPortfolio`가 지정되지
-     * 않은 경우에만 fallback으로 쓰인다.
-     */
-    enablePortfolio?: boolean;
-    /**
-     * Convenience alias for `showPortfolio`. Prefer this in new code:
-     * `<ConnectButton portfolio />`.
-     */
-    portfolio?: boolean;
-    /**
-     * AlchemyPay 결제 위젯 종료 후 popup이 redirect될 URL. 지정 시 백엔드
-     * `/onramp/url` 호출 body의 `redirect_url`로 그대로 전달된다. 미지정 시
-     * 클라가 임의 default를 박지 않고 백엔드의 default 흐름을 따른다.
-     *
-     * DApp이 결제 완료를 자체 페이지에서 받고 싶을 때 사용 (예:
-     * `https://example.com/onramp/return`). 보통 그 페이지에서
-     * `window.opener.postMessage(...)` + `window.close()`로 메인 윈도우에 알림.
-     */
-    onRampRedirectUrl?: string;
-}
-/**
- * `ConnectButton`은 내부에서 `WalletInfo`를 조립하지만, 호출측은 그 사실을
- * 몰라도 되도록 `WalletInfoProps`를 전부 pass-through 한다
- * (`walletAddress` / `children` 만 제외).
- *
- * 자동 계산 규칙 (명시적으로 주면 덮어쓰기):
- *   - `walletAddress`       ← `user.address` ?? wagmi `address`
- *   - `connectorId`         ← `user.provider` ?? `currentWallet` 매핑
- *   - `accountName`         ← `user.name` ?? crossy-sdk getAddresses name
- *   - `onDisconnect`        ← kit `disconnect()`
- *   - `onSelectWallet`      ← OAuth embedded 세션일 때만 kit `selectWallet()`
- *                             (외부 지갑은 기본 alert을 막기 위해 CSS로 숨김)
- *   - `showPortfolio`       ← `portfolio` ?? `showPortfolio` ?? legacy `enablePortfolio`
- *   - `theme`               ← kit provider의 `themeMode`
- *   - `env`                 ← `NEXT_PUBLIC_CROSSX_ENVIRONMENT`, or `"production"`
- *
- * Trigger 버튼(주소 옆 pill)은 호출측이 건드릴 수 없다 — 플랫폼 아이콘 + 축약
- * 주소의 통일된 UX를 강제한다.
- */
-export declare function ConnectButton({ label, className, style, walletInfoStyle, user, enablePortfolio, portfolio, theme: themeProp, accountName: accountNameProp, connectorId: connectorIdProp, showPortfolio: showPortfolioProp, sendAccounts: sendAccountsProp, getTransactionReceipt: getTransactionReceiptProp, sendTransaction: sendTransactionProp, estimateGas: estimateGasProp, onDisconnect: onDisconnectProp, onSelectWallet: onSelectWalletProp, onBuy: onBuyProp, onRampRedirectUrl, showBalance, env, ...walletInfoRest }: ConnectButtonProps): import("react/jsx-runtime").JSX.Element;
-export {};
-//# sourceMappingURL=ConnectButton.d.ts.map

package/dist/components/ConnectButton.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConnectButton.d.ts","sourceRoot":"","sources":["../../src/components/ConnectButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,OAAO,KAAK,EACV,kBAAkB,EAIlB,eAAe,EACf,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAiB9B;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,QAAQ,EAAE,cAAc,CAAC;IACzB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,KAAK,wBAAwB,GAAG,IAAI,CAClC,eAAe,EACf,UAAU,GAAG,eAAe,GAAG,OAAO,CACvC,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,wBAAwB;IAClE;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B;;;OAGG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAuGD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAwB,EACxB,SAAS,EACT,KAAK,EACL,eAAe,EACf,IAAI,EACJ,eAAe,EACf,SAAS,EAET,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,eAAe,EAC5B,WAAW,EAAE,eAAe,EAC5B,aAAa,EAAE,iBAAiB,EAChC,YAAY,EAAE,gBAAgB,EAC9B,qBAAqB,EAAE,yBAAyB,EAChD,eAAe,EAAE,mBAAmB,EACpC,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,gBAAgB,EAC9B,cAAc,EAAE,kBAAkB,EAClC,KAAK,EAAE,SAAS,EAChB,iBAAiB,EAEjB,WAAkB,EAClB,GAAG,EAEH,GAAG,cAAc,EAClB,EAAE,kBAAkB,2CA0bpB"}