@tuwaio/nova-connect 0.6.0 → 0.7.0

package/dist/useWalletNativeBalance-CPK-PoXG.d.ts

@@ -0,0 +1,918 @@
+import * as React$1 from 'react';
+import React__default, { ComponentPropsWithoutRef, ComponentType, ReactNode } from 'react';
+import { OrbitAdapter } from '@tuwaio/orbit-core';
+import { TransactionPool, Transaction, TxAdapter } from '@tuwaio/pulsar-core';
+import { N as NovaConnectLabels } from './types-CnOiSyvZ.js';
+import { SatelliteSiwxFieldOptions, UseSiwxSignInOptions } from '@tuwaio/siwx-react';
+import { Variants, Easing } from 'framer-motion';
+
+/**
+ * Chain configuration types of the networks the app imports. Importing `@tuwaio/nova-connect/evm` adds `appChains`
+ * (the viem chains of your wagmi config, `readonly [Chain, ...Chain[]]`); importing `@tuwaio/nova-connect/solana` adds
+ * `solanaRPCUrls` (`Partial<Record<SolanaClusterMoniker, string>>` from `@tuwaio/orbit-solana`). Read the resulting
+ * types through {@link NovaConnectAppChains} and {@link NovaConnectSolanaRPCUrls}.
+ */
+interface NovaConnectChainConfigTypes {
+}
+/**
+ * Type of `appChains`: the viem chains (`readonly [Chain, ...Chain[]]`) when `@tuwaio/nova-connect/evm` is imported,
+ * otherwise a list of objects with a numeric `id` (a list of viem chains fits too).
+ */
+type NovaConnectAppChains = NovaConnectChainConfigTypes extends {
+    appChains: infer T;
+} ? T : readonly {
+    readonly id: number;
+}[];
+/**
+ * Type of `solanaRPCUrls`: an RPC URL for each cluster moniker (`Partial<Record<SolanaClusterMoniker, string>>`) when
+ * `@tuwaio/nova-connect/solana` is imported, otherwise an RPC URL for each cluster name.
+ */
+type NovaConnectSolanaRPCUrls = NovaConnectChainConfigTypes extends {
+    solanaRPCUrls: infer T;
+} ? T : Readonly<Partial<Record<string, string>>>;
+/**
+ * Chain configuration of the app, passed to `NovaConnectProvider` as `appChains` and `solanaRPCUrls`. The provider
+ * renders the connect and connected modals only when at least one of them is set, and a wallet connects to the first
+ * EVM chain or the first Solana cluster of these lists.
+ */
+interface AllChainConfigs {
+    /** EVM chains of the app, the viem chains of your wagmi config. See {@link NovaConnectAppChains}. */
+    appChains?: NovaConnectAppChains;
+    /**
+     * Solana RPC URL for each cluster moniker, for example `{ devnet: 'https://api.devnet.solana.com' }`. See
+     * {@link NovaConnectSolanaRPCUrls}.
+     */
+    solanaRPCUrls?: NovaConnectSolanaRPCUrls;
+}
+/**
+ * Alias of {@link AllChainConfigs}.
+ */
+type InitialChains = AllChainConfigs;
+
+/**
+ * @file ConnectedModalTxHistory component with comprehensive customization options for transaction history display.
+ */
+
+/**
+ * Local mirror of TxInMemoryPagination from @tuwaio/pulsar-core.
+ * Defined inline because pulsar-core is an optional peer dependency in nova-connect.
+ */
+type LocalTxPagination = {
+    /** Indicates whether the store is currently loading transaction history. */
+    isLoading: boolean;
+    /** Indicates whether the last loading request ended with an error. */
+    isError: boolean;
+    /** Indicates whether more history pages are available. */
+    hasMore: boolean;
+    /** The current page number in the paginated history. */
+    currentPage: number;
+    /**
+     * Loads the next page of transaction history and appends it to the pool.
+     *
+     * @param walletAddress - The address whose history is loaded.
+     * @returns Resolves when the page is loaded.
+     */
+    fetchNextPage: (walletAddress: string) => Promise<void>;
+};
+/**
+ * Local customization options for TransactionsHistory component.
+ * This is a copy of the type from @tuwaio/nova-transactions to avoid
+ * breaking dynamic import logic.
+ */
+type LocalTransactionsHistoryCustomization = {
+    /** Custom title for the transactions history section */
+    title?: string;
+    /** Custom class name generators */
+    classNames?: {
+        /** Classes for the outer container */
+        container?: string;
+        /** Classes for the title element */
+        titleText?: string;
+        /** Classes for the list wrapper container */
+        listWrapper?: string;
+        /** Classes for the placeholder container */
+        placeholderContainer?: string;
+        /** Classes for the placeholder title */
+        placeholderTitle?: string;
+        /** Classes for the placeholder message */
+        placeholderMessage?: string;
+        /** Classes for the infinite scroll loader container */
+        loaderContainer?: string;
+        /** Classes for the infinite scroll loader icon (spinner) */
+        loaderIcon?: string;
+        /** Classes for the error indicator container */
+        errorContainer?: string;
+        /** Classes for the error indicator icon */
+        errorIcon?: string;
+        /** Classes for individual transaction item container */
+        itemContainer?: string;
+        /** Classes for the icon wrapper */
+        itemIconWrapper?: string;
+        /** Classes for the icon itself */
+        itemIcon?: string;
+        /** Classes for the content wrapper */
+        itemContentWrapper?: string;
+        /** Classes for the title text */
+        itemTitle?: string;
+        /** Classes for the timestamp text */
+        itemTimestamp?: string;
+        /** Classes for the description text */
+        itemDescription?: string;
+        /** Classes for the status badge container */
+        itemStatusBadge?: string;
+        /** Classes for the status badge icon */
+        itemStatusBadgeIcon?: string;
+        /** Classes for the status badge label */
+        itemStatusBadgeLabel?: string;
+        /** Classes for the transaction key container */
+        itemTxKeyContainer?: string;
+        /** Classes for the default hash link label */
+        itemHashLabel?: string;
+        /** Classes for the default hash link */
+        itemHashLink?: string;
+        /** Classes for the default hash copy button */
+        itemHashCopyButton?: string;
+        /** Classes for the original hash link label (replaced transactions) */
+        itemOriginalHashLabel?: string;
+        /** Classes for the original hash link (replaced transactions) */
+        itemOriginalHashLink?: string;
+        /** Classes for the original hash copy button (replaced transactions) */
+        itemOriginalHashCopyButton?: string;
+    };
+};
+/**
+ * Props for a custom loading state (shown while `@tuwaio/nova-transactions` loads).
+ */
+type ConnectedModalTxHistoryLoadingContainerProps = {
+    /** The Nova Connect labels */
+    labels: Record<string, string>;
+    /** Classes from `classNames.loadingContainer` */
+    className?: string;
+    /** Granular classNames for sub-elements */
+    classNames?: {
+        /** From `classNames.loadingSpinner` */
+        spinner?: string;
+        /** From `classNames.loadingText` */
+        text?: string;
+    };
+};
+/**
+ * Props for a custom error state (shown when `@tuwaio/nova-transactions` cannot be loaded or its component throws).
+ */
+type ConnectedModalTxHistoryErrorContainerProps = {
+    /** Classes from `classNames.errorContainer` */
+    className?: string;
+    /** Granular classNames for sub-elements */
+    classNames?: {
+        /** From `classNames.errorIconContainer` */
+        iconContainer?: string;
+        /** From `classNames.errorIcon` */
+        icon?: string;
+        /** From `classNames.errorContent` */
+        content?: string;
+        /** From `classNames.errorTitle` */
+        title?: string;
+        /** From `classNames.errorDescription` */
+        description?: string;
+    };
+};
+/**
+ * Props for a custom state without a connected wallet.
+ */
+type ConnectedModalTxHistoryNoWalletContainerProps = {
+    /** Classes from `classNames.noWalletContainer` */
+    className?: string;
+    /** Granular classNames for sub-elements */
+    classNames?: {
+        /** From `classNames.noWalletText` */
+        text?: string;
+    };
+};
+/**
+ * Props for a custom wrapper of the `TransactionsHistory` of `@tuwaio/nova-transactions`.
+ */
+type ConnectedModalTxHistoryTransactionsHistoryWrapperProps = {
+    /** The transaction history */
+    children: ReactNode;
+    /** The active address */
+    activeConnectionAddress: string;
+    /** The `transactionPool` prop */
+    transactionPool: NonNullable<NovaConnectProviderProps['transactionPool']>;
+    /** The `pulsarAdapter` prop */
+    pulsarAdapter: NonNullable<NovaConnectProviderProps['pulsarAdapter']>;
+    /** The Nova Connect labels */
+    labels: Record<string, string>;
+    /** Classes from `classNames.transactionsHistoryWrapper` */
+    className?: string;
+};
+/**
+ * Customization options of {@link ConnectedModalTxHistory}.
+ */
+type ConnectedModalTxHistoryCustomization = {
+    /** Props of the container (the component props, `className` and `aria-label` take precedence) */
+    containerProps?: Partial<Omit<ComponentPropsWithoutRef<'div'>, 'popover' | 'onDrag' | 'onDragEnd' | 'onDragExit' | 'onDragStart' | 'onDragStartCapture' | 'onAnimationStart' | 'onAnimationEnd' | 'onAnimationStartCapture' | 'onAnimationEndCapture' | 'onAnimationIteration' | 'onAnimationIterationCapture'>>;
+    /** Custom components */
+    components?: {
+        /** Custom loading container component */
+        LoadingContainer?: ComponentType<ConnectedModalTxHistoryLoadingContainerProps>;
+        /** Custom error container component */
+        ErrorContainer?: ComponentType<ConnectedModalTxHistoryErrorContainerProps>;
+        /** Custom no wallet container component */
+        NoWalletContainer?: ComponentType<ConnectedModalTxHistoryNoWalletContainerProps>;
+        /** Custom transactions history wrapper component */
+        TransactionsHistoryWrapper?: ComponentType<ConnectedModalTxHistoryTransactionsHistoryWrapperProps>;
+    };
+    /** Custom class name generators */
+    classNames?: {
+        /**
+         * Returns the classes of the container, instead of the default ones and the `className` prop.
+         *
+         * @param params - The state.
+         * @param params.hasActiveWallet - Whether a wallet is connected.
+         * @param params.hasValidAdapter - Whether `transactionPool` and `pulsarAdapter` are set.
+         * @returns The classes.
+         */
+        container?: (params: {
+            hasActiveWallet: boolean;
+            hasValidAdapter: boolean;
+        }) => string;
+        /**
+         * Returns classes of the loading state, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        loadingContainer?: () => string;
+        /**
+         * Returns classes of the loading spinner, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        loadingSpinner?: () => string;
+        /**
+         * Returns classes of the loading text, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        loadingText?: () => string;
+        /**
+         * Returns classes of the error state, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorContainer?: () => string;
+        /**
+         * Returns classes of the error icon container, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorIconContainer?: () => string;
+        /**
+         * Returns classes of the error icon, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorIcon?: () => string;
+        /**
+         * Returns classes of the error texts, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorContent?: () => string;
+        /**
+         * Returns classes of the error title, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorTitle?: () => string;
+        /**
+         * Returns classes of the error description, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        errorDescription?: () => string;
+        /**
+         * Returns classes of the state without a wallet, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        noWalletContainer?: () => string;
+        /**
+         * Returns classes of the text without a wallet, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        noWalletText?: () => string;
+        /**
+         * Returns classes of the "Pulsar adapter required" state, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredContainer?: () => string;
+        /**
+         * Returns classes of its icon container, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredIconContainer?: () => string;
+        /**
+         * Returns classes of its icon, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredIcon?: () => string;
+        /**
+         * Returns classes of its texts, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredContent?: () => string;
+        /**
+         * Returns classes of its title, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredTitle?: () => string;
+        /**
+         * Returns classes of its description, instead of the default ones.
+         *
+         * @returns The classes.
+         */
+        pulsarRequiredDescription?: () => string;
+        /**
+         * Returns classes of the transaction history wrapper, added to the default ones.
+         *
+         * @returns The classes.
+         */
+        transactionsHistoryWrapper?: () => string;
+    };
+    /** Custom animation variants */
+    variants?: {
+        /** Container animation variants (`initial`, `animate`, `exit`) */
+        container?: Variants;
+        /** Variants of the "Pulsar adapter required" state */
+        error?: Variants;
+    };
+    /** Custom animation configuration */
+    animation?: {
+        /** Container animation configuration */
+        container?: {
+            /** Animation duration in seconds */
+            duration?: number;
+            /** Animation easing curve */
+            ease?: Easing | Easing[];
+            /** Animation delay in seconds */
+            delay?: number;
+        };
+        /** Animation of the "Pulsar adapter required" state */
+        error?: {
+            /** Animation duration in seconds */
+            duration?: number;
+            /** Animation easing curve */
+            ease?: Easing | Easing[];
+            /** Animation delay in seconds */
+            delay?: number;
+        };
+    };
+    /** Custom event handlers */
+    handlers?: {
+        /**
+         * Called when `@tuwaio/nova-transactions` fails to load or its `TransactionsHistory` throws.
+         *
+         * @param packageName - `config.packageName`.
+         * @param error - The error.
+         */
+        onPackageLoadingFailure?: (packageName: string, error: Error) => void;
+    };
+    /** Configuration options */
+    config?: {
+        /** Renders without Framer Motion (default: `false`) */
+        disableAnimation?: boolean;
+        /** Same as `disableAnimation` (default: `false`) */
+        reduceMotion?: boolean;
+        /** Name passed to `handlers.onPackageLoadingFailure` (default: `@tuwaio/nova-transactions`) */
+        packageName?: string;
+        /** Custom aria labels for different states */
+        ariaLabels?: {
+            /** ARIA label of the container, after the `aria-label` prop (default: the `transactionsInApp` label) */
+            transactionsHistory?: string;
+        };
+    };
+    /**
+     * Customization for the TransactionsHistory component (from @tuwaio/nova-transactions).
+     * Passed through to the dynamically loaded component.
+     */
+    transactionsHistory?: LocalTransactionsHistoryCustomization;
+};
+/**
+ * Props for the {@link ConnectedModalTxHistory} component. Without `transactionPool` and `pulsarAdapter` (Pulsar)
+ * the "Pulsar adapter required" state is shown. Other props are passed to the container.
+ */
+interface ConnectedModalTxHistoryProps extends Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'> {
+    /** Classes added to the default container classes (ignored when `classNames.container` is set) */
+    className?: string;
+    /** ARIA label of the container (default: the `transactionsInApp` label) */
+    'aria-label'?: string;
+    /** Customization options */
+    customization?: ConnectedModalTxHistoryCustomization;
+    /** Pagination state for infinite scroll, forwarded to TransactionsHistory. */
+    pagination?: LocalTxPagination;
+}
+/**
+ * The transaction history screen of the connected modal: the `TransactionsHistory` of `@tuwaio/nova-transactions`
+ * for the active address (loaded with a dynamic import, without the details view). Shows a loading state while the
+ * package loads, an error state when it cannot be loaded, a "Pulsar adapter required" state without
+ * `transactionPool` and `pulsarAdapter`, and a message without a connected wallet.
+ *
+ * Props: {@link ConnectedModalTxHistoryProps}; the ref is forwarded to the container.
+ *
+ * @example
+ * ```tsx
+ * import { ConnectedModalTxHistory } from '@tuwaio/nova-connect/components';
+ * import type { NovaConnectProviderProps } from '@tuwaio/nova-connect/hooks';
+ *
+ * type HistoryProps = Pick<NovaConnectProviderProps, 'transactionPool' | 'pulsarAdapter'>;
+ *
+ * export function History({ transactionPool, pulsarAdapter }: HistoryProps) {
+ *   return (
+ *     <ConnectedModalTxHistory
+ *       transactionPool={transactionPool}
+ *       pulsarAdapter={pulsarAdapter}
+ *       customization={{
+ *         classNames: { loadingContainer: () => 'bg-blue-100' },
+ *         handlers: {
+ *           onPackageLoadingFailure: (packageName, error) => console.error(packageName, error),
+ *         },
+ *       }}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+declare const ConnectedModalTxHistory: React__default.ForwardRefExoticComponent<ConnectedModalTxHistoryProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * @file Headless SIWX auto-authentication watcher for NovaConnect.
+ * Monitors active wallet connections and automatically triggers SIWX signing prompts.
+ */
+
+/**
+ * Props of {@link NovaSiwxWatcher} (the `siwx` prop of `NovaConnectProvider`): the sign-in callbacks and the SIWX
+ * message fields of `getSatelliteSiwxFields` from `@tuwaio/siwx-react` (`domain`, `uri`, `statement`, and so on).
+ */
+interface NovaSiwxWatcherProps extends SatelliteSiwxFieldOptions {
+    /** Whether to ask connected wallets to sign in (default: `true`) */
+    enabled?: boolean;
+    /** Fetches the nonce of the SIWX message from your backend */
+    getNonce?: () => Promise<string>;
+    /** Verifies the signed message on your backend (required for the sign-in) */
+    verifier?: UseSiwxSignInOptions['verifier'];
+    /**
+     * Optional callback triggered when the wallet disconnects or when `signOut` is called.
+     * Useful for hitting a `/logout` endpoint to clear the backend cookie.
+     */
+    destroyer?: () => Promise<void>;
+    /** Optional callback triggered immediately after successful SIWX authentication */
+    onSuccess?: UseSiwxSignInOptions['onSuccess'];
+    /** Optional callback triggered if SIWX signing or verification fails */
+    onError?: UseSiwxSignInOptions['onError'];
+}
+/**
+ * Signs the connected wallet in with SIWX. `NovaConnectProvider` renders it with its `siwx` prop, so apps do not
+ * render it themselves. It renders nothing.
+ *
+ * - When a wallet connects (or the account changes), it asks the wallet to sign a SIWX message once per address
+ *   (`signIn` of `useSiwx` from `@tuwaio/siwx-react`: a wallet prompt, then `getNonce` and `verifier` requests to your
+ *   backend). A rejected or failed sign-in disconnects that wallet (if it is still the active one) and calls
+ *   `onError`. Without `verifier` it logs a warning and does not sign in.
+ * - When no wallet is connected, it clears the SIWX session and calls `destroyer`. After a page load it waits until
+ *   Satellite Connect has finished reconnecting (`isAutoConnectFinished`), so the session restored by
+ *   `@tuwaio/siwx-react` is kept.
+ *
+ * @param props - See {@link NovaSiwxWatcherProps}.
+ * @returns `null`.
+ */
+declare function NovaSiwxWatcher(props: NovaSiwxWatcherProps): null;
+
+/**
+ * Status of the latest transaction of the active wallet, shown by the connect button: `loading` while it is pending,
+ * then `succeed`, `failed` or `replaced`, and `idle` otherwise.
+ */
+type ButtonTxStatus = 'idle' | 'loading' | 'succeed' | 'failed' | 'replaced';
+/**
+ * Screen of the connect modal: `connectors` (wallet list), `network` (network choice of a multi-network wallet),
+ * `connecting`, `about` ("About wallets"), `getWallet` ("Get a wallet") or `impersonate` (impersonation form).
+ */
+type ConnectContentType = 'network' | 'connectors' | 'about' | 'getWallet' | 'connecting' | 'impersonate';
+/**
+ * Screen of the connected modal: `main`, `transactions` (history), `chains` (network switch) or `connections`
+ * (connected and recent wallets).
+ */
+type ConnectedContentType = 'main' | 'transactions' | 'chains' | 'connections';
+/** Legal configuration for Terms of Service and Privacy Policy links */
+interface LegalConfig {
+    /** URL of the terms of service */
+    termsUrl?: string;
+    /** URL of the privacy policy */
+    privacyUrl?: string;
+}
+/**
+ * Props of `NovaConnectProvider`. `appChains` and `solanaRPCUrls` give the chains of the app; without both, the
+ * modals are not rendered.
+ */
+interface NovaConnectProviderProps extends InitialChains {
+    /** Transaction pool of Pulsar: the connect button shows the status of the latest transaction of the wallet */
+    transactionPool?: TransactionPool<Transaction>;
+    /** Pulsar adapter(s); with `transactionPool`, the connected modal shows the transaction history */
+    pulsarAdapter?: TxAdapter<Transaction> | TxAdapter<Transaction>[];
+    /** Whether the connect button shows the native balance */
+    withBalance?: boolean;
+    /** Whether the connect button shows a chain selector */
+    withChain?: boolean;
+    /** Whether the wallet list offers the impersonated wallet (a read-only address, for development) */
+    withImpersonated?: boolean;
+    /** Wallet names of the "Popular" group, in order (default: WalletConnect, Porto, Coinbase, Gemini) */
+    popularConnectors?: string[];
+    /** Extra wallet groups of the wallet list: group title → wallet names, in order */
+    customConnectorGroups?: Record<string, string[]>;
+    /** Legal configuration for Terms of Service and Privacy Policy links */
+    legal?: LegalConfig;
+    /**
+     * SIWX sign-in of the connected wallet (see `NovaSiwxWatcher`). Without it, Nova Connect does not sign in and does
+     * not touch the SIWX session.
+     */
+    siwx?: NovaSiwxWatcherProps;
+    /**
+     * Pagination state for infinite scroll, forwarded to ConnectedModalTxHistory and TransactionsHistory.
+     * Mirrors TxInMemoryPagination from @tuwaio/pulsar-core (optional peer dependency).
+     */
+    pagination?: LocalTxPagination;
+    /** The app */
+    children: React.ReactNode;
+    /** Texts to override, merged over the English defaults */
+    labels?: Partial<NovaConnectLabels>;
+}
+/**
+ * A native balance.
+ */
+interface WalletBalance {
+    /** Formatted amount */
+    value: string;
+    /** Currency symbol */
+    symbol: string;
+}
+/**
+ * State of `NovaConnectProvider`, returned by {@link useNovaConnect}: the provider props (without `siwx` and
+ * `pagination`, which are not set) and the UI state of the modals, kept in React state of the provider.
+ */
+interface NovaConnectProviderType extends Omit<NovaConnectProviderProps, 'pulsarAdapter' | 'children' | 'labels' | 'transactionPool'> {
+    /** Whether the connect modal is open */
+    isConnectModalOpen: boolean;
+    /**
+     * Opens or closes the connect modal (opening resets it to the wallet list).
+     *
+     * @param value - Whether the modal is open.
+     */
+    setIsConnectModalOpen: (value: boolean) => void;
+    /** Whether the connected modal is open */
+    isConnectedModalOpen: boolean;
+    /**
+     * Opens or closes the connected modal (opening shows the main screen).
+     *
+     * @param value - Whether the modal is open.
+     */
+    setIsConnectedModalOpen: (value: boolean) => void;
+    /** Whether the chain list of `ChainSelector` is open (desktop) */
+    isChainsListOpen: boolean;
+    /**
+     * Opens or closes the chain list of `ChainSelector` (desktop).
+     *
+     * @param value - Whether the list is open.
+     */
+    setIsChainsListOpen: (value: boolean) => void;
+    /** Whether the chain dialog of `ChainSelector` is open (mobile) */
+    isChainsListOpenMobile: boolean;
+    /**
+     * Opens or closes the chain dialog of `ChainSelector` (mobile).
+     *
+     * @param value - Whether the dialog is open.
+     */
+    setIsChainsListOpenMobile: (value: boolean) => void;
+    /** Status of the latest transaction shown by the connect button */
+    connectedButtonStatus: ButtonTxStatus;
+    /**
+     * Sets the transaction status of the connect button.
+     *
+     * @param value - The status.
+     */
+    setConnectedButtonStatus: (value: ButtonTxStatus) => void;
+    /** Whether a wallet has just connected in the connect modal (`true` for 500 ms before the modal closes) */
+    isConnected: boolean;
+    /**
+     * Sets the "just connected" state of the connect modal.
+     *
+     * @param value - The state.
+     */
+    setIsConnected: (value: boolean) => void;
+    /** Screen of the connected modal */
+    connectedModalContentType: ConnectedContentType;
+    /**
+     * Shows a screen of the connected modal.
+     *
+     * @param value - The screen.
+     */
+    setConnectedModalContentType: (value: ConnectedContentType) => void;
+    /** Screen of the connect modal */
+    connectModalContentType: ConnectContentType;
+    /**
+     * Shows a screen of the connect modal.
+     *
+     * @param value - The screen.
+     */
+    setConnectModalContentType: (value: ConnectContentType) => void;
+    /** Network selected in the connect modal (`undefined` for all networks) */
+    selectedAdapter: OrbitAdapter | undefined;
+    /**
+     * Selects a network in the connect modal.
+     *
+     * @param value - The network, or `undefined` for all networks.
+     */
+    setSelectedAdapter: (value: OrbitAdapter | undefined) => void;
+    /** Wallet selected in the connect modal, as `formatConnectorName` of `@tuwaio/orbit-core` returns it */
+    activeConnector: string | undefined;
+    /**
+     * Selects a wallet in the connect modal.
+     *
+     * @param value - The formatted wallet name.
+     */
+    setActiveConnector: (value: string | undefined) => void;
+    /** Address entered in the impersonation form */
+    impersonatedAddress: string;
+    /**
+     * Sets the impersonated address of the connect modal (it is saved to `localStorage` only on connect).
+     *
+     * @param value - The address.
+     */
+    setImpersonatedAddress: (value: string) => void;
+    /** The `legal` prop */
+    legal?: LegalConfig;
+}
+/**
+ * Thrown by {@link useNovaConnect} outside `NovaConnectProvider`.
+ */
+declare class NovaConnectProviderError extends Error {
+    /**
+     * @param message - The error message (default: `useNovaConnect must be used within NovaConnectProvider`).
+     */
+    constructor(message?: string);
+}
+/**
+ * React context of `NovaConnectProvider` (`undefined` outside the provider). Read it with {@link useNovaConnect}.
+ */
+declare const NovaConnectProviderContext: React$1.Context<NovaConnectProviderType | undefined>;
+/**
+ * Returns the state of `NovaConnectProvider`: the modal states and their setters, the selected network and wallet,
+ * and the provider options.
+ *
+ * @returns The provider state.
+ * @throws {@link NovaConnectProviderError} When used outside `NovaConnectProvider`.
+ *
+ * @example
+ * ```tsx
+ * import { useNovaConnect } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function OpenWalletButton() {
+ *   const { setIsConnectModalOpen } = useNovaConnect();
+ *
+ *   return <button onClick={() => setIsConnectModalOpen(true)}>Connect Wallet</button>;
+ * }
+ * ```
+ */
+declare const useNovaConnect: () => NovaConnectProviderType;
+/**
+ * Checks whether the component is inside `NovaConnectProvider`.
+ *
+ * @returns `true` inside the provider.
+ *
+ * @example
+ * ```tsx
+ * import { useHasNovaConnectContext } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function ProviderCheck() {
+ *   const hasContext = useHasNovaConnectContext();
+ *
+ *   return <p>{hasContext ? 'Nova Connect is ready' : 'NovaConnectProvider not found'}</p>;
+ * }
+ * ```
+ */
+declare const useHasNovaConnectContext: () => boolean;
+/**
+ * Like {@link useNovaConnect}, but returns `null` outside `NovaConnectProvider` instead of throwing.
+ *
+ * @returns The provider state, or `null`.
+ *
+ * @example
+ * ```tsx
+ * import { useNovaConnectOptional } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function OptionalOpenButton() {
+ *   const context = useNovaConnectOptional();
+ *
+ *   if (!context) return null;
+ *   return <button onClick={() => context.setIsConnectModalOpen(true)}>Connect Wallet</button>;
+ * }
+ * ```
+ */
+declare const useNovaConnectOptional: () => NovaConnectProviderType | null;
+
+/**
+ * React context of the Nova Connect labels. Its default value is the English `defaultLabels`, so components work
+ * without a labels provider. `NovaConnectProvider` provides the merged labels.
+ */
+declare const NovaConnectLabelsContext: React$1.Context<NovaConnectLabels>;
+/**
+ * Returns the Nova Connect labels: the ones of the nearest labels provider (`NovaConnectProvider` provides the
+ * `labels` prop merged into the defaults), or the English defaults.
+ *
+ * @returns All labels.
+ *
+ * @example
+ * ```tsx
+ * import { useNovaConnectLabels } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function Title() {
+ *   const labels = useNovaConnectLabels();
+ *
+ *   return <h2>{labels.connectWallet}</h2>;
+ * }
+ * ```
+ */
+declare const useNovaConnectLabels: () => NovaConnectLabels;
+/**
+ * Returns one label.
+ *
+ * @param key - The label key.
+ * @returns The label text.
+ *
+ * @example
+ * ```tsx
+ * import { useNovaConnectLabel } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function ConnectText() {
+ *   return <span>{useNovaConnectLabel('connectWallet')}</span>;
+ * }
+ * ```
+ */
+declare const useNovaConnectLabel: <K extends keyof NovaConnectLabels>(key: K) => NovaConnectLabels[K];
+/**
+ * Returns the given labels. It reads all labels, so it re-renders like {@link useNovaConnectLabels}.
+ *
+ * @param keys - The label keys.
+ * @returns An object with the requested labels.
+ *
+ * @example
+ * ```tsx
+ * import { useNovaConnectLabelsSubset } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function Actions() {
+ *   const { connect, disconnect } = useNovaConnectLabelsSubset(['connect', 'disconnect']);
+ *
+ *   return (
+ *     <p>
+ *       {connect} / {disconnect}
+ *     </p>
+ *   );
+ * }
+ * ```
+ */
+declare const useNovaConnectLabelsSubset: <K extends keyof NovaConnectLabels>(keys: K[]) => Pick<NovaConnectLabels, K>;
+/**
+ * Checks whether a label is set and not blank.
+ *
+ * @param labels - The labels.
+ * @param key - The label key.
+ * @returns `true` when the trimmed label is not empty.
+ */
+declare const hasLabel: (labels: NovaConnectLabels, key: keyof NovaConnectLabels) => boolean;
+/**
+ * Label keys by category, used by {@link useLabelsByCategory}.
+ */
+type LabelCategory = {
+    /** Action texts such as `connectWallet` and `disconnect` */
+    actions: Extract<keyof NovaConnectLabels, 'connectWallet' | 'disconnect' | 'connecting' | 'connected' | 'tryAgain' | 'back' | 'connect'>;
+    /** State texts such as `success` and `loading` */
+    states: Extract<keyof NovaConnectLabels, 'success' | 'error' | 'replaced' | 'loading'>;
+    /** ARIA labels such as `closeModal` */
+    accessibility: Extract<keyof NovaConnectLabels, 'chainSelector' | 'closeModal' | 'selectChain' | 'walletControls' | 'openWalletModal'>;
+    /** Transaction status texts */
+    transactions: Extract<keyof NovaConnectLabels, 'transactionLoading' | 'transactionSuccess' | 'transactionError' | 'transactionReplaced' | 'recent'>;
+};
+/**
+ * Returns the labels of a category of {@link LabelCategory}.
+ *
+ * @param category - The category.
+ * @returns An object with the labels of the category.
+ *
+ * @example
+ * ```tsx
+ * import { useLabelsByCategory } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function StateText() {
+ *   const { loading } = useLabelsByCategory('states');
+ *
+ *   return <span>{loading}</span>;
+ * }
+ * ```
+ */
+declare const useLabelsByCategory: <T extends keyof LabelCategory>(category: T) => Pick<NovaConnectLabels, LabelCategory[T]>;
+/**
+ * Checks whether an object is the `defaultLabels` object itself (a copy with the same texts returns `false`).
+ *
+ * @param labels - The labels.
+ * @returns `true` for the `defaultLabels` object.
+ */
+declare const isDefaultLabels: (labels: NovaConnectLabels) => boolean;
+/**
+ * Returns a label, or a fallback when it is blank: the `fallback` argument, the English default, then the key.
+ *
+ * @param labels - The labels.
+ * @param key - The label key.
+ * @param fallback - Text used when the label is blank.
+ * @returns The text.
+ *
+ * @example
+ * ```ts
+ * import { defaultLabels } from '@tuwaio/nova-connect/i18n';
+ * import { getLabelWithFallback } from '@tuwaio/nova-connect/hooks';
+ *
+ * getLabelWithFallback({ ...defaultLabels, connectWallet: '' }, 'connectWallet', 'Connect'); // 'Connect'
+ * ```
+ */
+declare const getLabelWithFallback: (labels: NovaConnectLabels, key: keyof NovaConnectLabels, fallback?: string) => string;
+/**
+ * Returns the given labels of a labels object (usable outside React components).
+ *
+ * @param labels - The labels.
+ * @param keys - The label keys.
+ * @returns An object with the requested labels.
+ *
+ * @example
+ * ```ts
+ * import { defaultLabels } from '@tuwaio/nova-connect/i18n';
+ * import { createLabelsSubset } from '@tuwaio/nova-connect/hooks';
+ *
+ * const actionLabels = createLabelsSubset(defaultLabels, ['connect', 'disconnect', 'tryAgain']);
+ * ```
+ */
+declare const createLabelsSubset: <K extends keyof NovaConnectLabels>(labels: NovaConnectLabels, keys: K[]) => Pick<NovaConnectLabels, K>;
+
+/**
+ * A native balance returned by `getBalance` of a Satellite adapter.
+ */
+interface NativeBalanceResult {
+    /** The balance formatted with the decimals of the token (for example `1.5`) */
+    value: string;
+    /** The token symbol (for example `ETH`) */
+    symbol: string;
+}
+/**
+ * The balance of {@link useWalletNativeBalance}, or `null` when it is not known.
+ */
+type UseWalletNativeBalanceState = NativeBalanceResult | null;
+/**
+ * Result of {@link useWalletNativeBalance}.
+ */
+interface UseWalletNativeBalanceData {
+    /** The balance, or `null` without a wallet, without `getBalance` or before it resolves */
+    balance: UseWalletNativeBalanceState;
+    /** Whether the balance is being requested */
+    isLoading: boolean;
+    /** Requests the balance again (a failed refresh clears the kept balance) */
+    refetch: () => void;
+}
+/**
+ * Returns the native balance of the active wallet on its chain, from `getBalance` of its Satellite adapter (an RPC
+ * request). Each balance is kept in memory for the address and chain while the component is mounted, so switching
+ * back does not request it again; `refetch` requests it again.
+ *
+ * @returns See {@link UseWalletNativeBalanceData}.
+ *
+ * @example
+ * ```tsx
+ * import { useWalletNativeBalance } from '@tuwaio/nova-connect/hooks';
+ *
+ * export function NativeBalance() {
+ *   const { balance, isLoading, refetch } = useWalletNativeBalance();
+ *
+ *   if (isLoading) return <p>Loading balance...</p>;
+ *
+ *   return (
+ *     <p>
+ *       {balance ? `${balance.value} ${balance.symbol}` : 'n/a'} <button onClick={refetch}>Refresh</button>
+ *     </p>
+ *   );
+ * }
+ * ```
+ */
+declare function useWalletNativeBalance(): UseWalletNativeBalanceData;
+
+export { type AllChainConfigs as A, type ButtonTxStatus as B, type ConnectContentType as C, ConnectedModalTxHistory as D, type ConnectedModalTxHistoryErrorContainerProps as E, type ConnectedModalTxHistoryLoadingContainerProps as F, type ConnectedModalTxHistoryNoWalletContainerProps as G, type ConnectedModalTxHistoryProps as H, type InitialChains as I, type ConnectedModalTxHistoryTransactionsHistoryWrapperProps as J, type LocalTransactionsHistoryCustomization as K, type LabelCategory as L, type LocalTxPagination as M, type NovaConnectProviderProps as N, type UseWalletNativeBalanceData as U, type WalletBalance as W, type ConnectedContentType as a, type NovaConnectProviderType as b, type LegalConfig as c, type NativeBalanceResult as d, type NovaConnectAppChains as e, type NovaConnectChainConfigTypes as f, NovaConnectLabelsContext as g, NovaConnectProviderContext as h, NovaConnectProviderError as i, type NovaConnectSolanaRPCUrls as j, NovaSiwxWatcher as k, type NovaSiwxWatcherProps as l, type UseWalletNativeBalanceState as m, createLabelsSubset as n, getLabelWithFallback as o, hasLabel as p, isDefaultLabels as q, useLabelsByCategory as r, useNovaConnect as s, useNovaConnectLabel as t, useHasNovaConnectContext as u, useNovaConnectLabels as v, useNovaConnectLabelsSubset as w, useNovaConnectOptional as x, useWalletNativeBalance as y, type ConnectedModalTxHistoryCustomization as z };